Edit

Share via

PixelOffsetMode enumeration (gdiplusenums.h)

  • Article

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

Requirement Value
Minimum supported client Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header gdiplusenums.h (include Gdiplus.h)

See also

Graphics::GetPixelOffsetMode

Graphics::SetPixelOffsetMode