PixelOffsetMode Enumeration

The PixelOffsetMode enumeration specifies the pixel offset mode of a Graphics object. This enumeration is used by the Graphics::GetPixelOffsetMode and Graphics::SetPixelOffsetMode methods of the Graphics class.

Syntax

typedef enum PixelOffsetMode {
  PixelOffsetModeInvalid      ,
  PixelOffsetModeDefault      ,
  PixelOffsetModeHighSpeed    ,
  PixelOffsetModeHighQuality  ,
  PixelOffsetModeNone         ,
  PixelOffsetModeHalf
} ;

Constants

PixelOffsetModeInvalid Used internally.
PixelOffsetModeDefault Equivalent to PixelOffsetModeNone.
PixelOffsetModeHighSpeed Equivalent to PixelOffsetModeNone.
PixelOffsetModeHighQuality Equivalent to PixelOffsetModeHalf.
PixelOffsetModeNone Indicates that pixel centers have integer coordinates.
PixelOffsetModeHalf Indicates that pixel centers have coordinates that are half way between integer values.

Remarks

Consider the pixel in the upper-left corner of an image with address (0, 0). With PixelOffsetModeNone, the pixel covers the area between –0.5 and 0.5 in both the x and y directions; that is, the pixel center is at (0, 0). With PixelOffsetModeHalf, the pixel covers the area between 0 and 1 in both the x and y directions; that is, the pixel center is at (0.5, 0.5).

Requirements

   
Windows version Windows XP, Windows 2000 Professional [desktop apps only] Windows 2000 Server [desktop apps only]
Header gdiplusenums.h (include Gdiplus.h)

See Also

Graphics::GetPixelOffsetMode

Graphics::SetPixelOffsetMode