CGdiPlus

GDI+ is the successor to GDI, the graphics device interface included with earlier versions of Windows. Windows XP or Windows .NET Server supports GDI for compatibility with existing applications, but programmers of new applications should use GDI+ for all their graphics needs because GDI+ optimizes many of the capabilities of GDI and also provides additional features.

A graphics device interface, such as GDI+, allows application programmers to display information on a screen or printer without having to be concerned about the details of a particular display device. The application programmer makes calls to the provided functions and those functions in turn make the appropriate calls to specific device drivers. GDI+ insulates the application from the graphics hardware, and it is this insulation that allows developers to create device-independent applications.

Include file: CGdiPlus.inc.

CGpBase class

Initializes the GDI+ library and keeps a reference count of it. The destructor shutdowns the library. All the other GDI+ classes inherit frrom CGpBase.

GetLastStatus method

Returns a value that indicates the nature of this object's most recent method failure.

FUNCTION GetLastStatus () AS GpStatus

Return value

Returns an element of the Status enumeration.

If no methods invoked on this object have failed since the previous call to GetLastStatus, then GetLastStatus returns Ok (0). If at least one method has failed since the previous call to GetLastStatus, then GetLastStatus returns a value that indicates the nature of the most recent failure.

For a detailed list of status codes see the Status enumeration.

Structures

Enumerations

Constants

BitmapData Structure

A BitmapData structure stores attributes of a bitmap. Used by the GdipBitmapLockBits and GdipBitmapUnlockBits functions.

TYPE BitmapData
   Width AS UINT
   Height AS UINT
   Stride AS INT_
   PixelFormat AS PixelFormat
   Scan0 AS ANY PTR
   Reserved AS UINT_PTR
END TYPE

CharacterRange Structure

A CharacterRange structure specifies a range of character positions within a string.

TYPE CharacterRange
   First AS INT_
   Length AS INT_
END TYPE

Remarks

A character range is a range of character positions within a string of text. The area of the display that is occupied by a group of characters that are specified by the character range is the bounding region. A character range is set by GdipSetStringFormatMeasurableCharacterRanges. The number of ranges that are currently set can be determined by calling GdipGetStringFormatMeasurableCharacterRangeCount. This number is also the number of regions expected to be obtained by the GdipMeasureCharacterRanges function.

ColorMap Structure

The ColorMap structure contains two COLORREF values. Several of the ImageAttributes functions adjust image colors by using a color remap table, which is an array of ColorMap structures.

TYPE ColorMap
   oldColor AS Color
   newColor AS Color
END TYPE

Remarks

Because the FreeBasic 32-bit headers don't define the GDI+ ColorMap structure ad use the GDI ColorMap one, that has different member names, there is a conflict. To solve it, I have defined an union that can be used to replace ColorMap in both 32 and 64-bit.

UNION GDIP_COLORMAP
   ' // For compatibility with GDI+
   TYPE
      oldColor AS COLORREF
      newColor AS COLORREF
   END TYPE
   ' // For compatibility with GDI
   TYPE
      from AS COLORREF
      to AS COLORREF
   END TYPE
END UNION

ColorMatrix Structure

The ColorMap structure contains two COLORREF values. Several of the ImageAttributes functions adjust image colors by using a color remap table, which is an array of ColorMap structures.

TYPE ColorMatrix
   m(0 to 5-1, 0 to 5-1) AS REAL
END TYPE

Remarks

A 5x5 color matrix is a homogeneous matrix for a 4-space transformation. The element in the fifth row and fifth column of a 5x5 homogeneous matrix must be 1, and all of the other elements in the fifth column must be 0. Color matrices are used to transform color vectors. The first four components of a color vector hold the red, green, blue, and alpha components (in that order) of a color. The fifth component of a color vector is always 1.

ColorPalette Structure

The ColorPalette structure defines an array of colors that make up a color palette. The colors are 32-bit ARGB colors.

TYPE ColorPalette
   Flags AS UINT
   Count AS UINT
   Entries(0) AS ARGB
END TYPE

EncoderParameter Structure

An EncoderParameter structure holds a parameter that can be passed to an image encoder. An EncoderParameter structure can also be used to receive a list of possible values supported by a particular parameter of a particular image encoder.

TYPE EncoderParameter
   Guid AS GUID
   NumberOfValues AS ULONG
   Type AS ULONG
   Value AS ANY PTR
END TYPE

EncoderParameters Structure

An EncoderParameters structure is an array of EncoderParameter structures along with a data member that specifies the number of EncoderParameter structures in the array.

TYPE EncoderParameters
   Count AS UINT
   Parameter(0) AS EncoderParameter
END TYPE

Remarks

When you create an EncoderParameters structure, you must allocate enough memory to hold all of the EncoderParameter structures that will eventually be placed in the array.

ENHMETAHEADER3 Structure

The ENHMETAHEADER3 structure contains enhanced-metafile data including the dimensions of the metafile image, the number of records in the metafile, and the resolution of the device on which the metafile was created.

TYPE ENHMETAHEADER3
   itype AS DWORD
   nSize AS DWORD
   rclBounds AS RECTL
   rclFrame AS RECTL
   dSignature AS DWORD
   nVersion AS DWORD
   nBytes AS DWORD
   nRecords AS DWORD
   nHandles AS WORD
   sReserved AS WORD
   nDescription AS DWORD
   offDescription AS DWORD
   nPalEntries AS DWORD
   szlDevice AS SIZEL
   szlMillimeters AS SIZEL
END TYPE

GdiplusStartupInput Structure

The GdiplusStartupInput structure holds a block of arguments that are required by the GdiplusStartup function.

TYPE GdiplusStartupInput
   GdiplusVersion AS UINT32
   DebugEventCallback AS DebugEventProc
   SuppressBackgroundThread AS BOOL
   SuppressExternalCodecs AS BOOL
END TYPE

Remarks

The GdiplusStartupInput structure provides a constructor that sets the GdiplusVersion member to 1 and allows you to specify values for the other three members. All of the constructor parameters are optional, so you can declare a variable of type GdiplusStartupInput without passing any arguments to the constructor, and all of the members will be initialized with appropriate default values.

If you set the SuppressBackgroundThread member of the GdiplusStartupinput parameter to TRUE, you must call the hook and unhook functions returned in the output parameter. Call those functions before and after the application's main message loop; that is, a message loop that is active for the lifetime of GDI+. Call the hook function before the loop starts, and call the unhook function after the loop ends.

GdiplusStartupOutput Structure

The GdiplusStartup function uses the GdiplusStartupOutput structure to return (in its output parameter) a pointer to a hook function and a pointer to an unhook function. If you set the SuppressBackgroundThread member of the input parameter to TRUE, then you are responsible for calling those functions to replace the Microsoft Windows GDI+ background thread.

Call the hook and unhook functions before and after the application's main message loop; that is, a message loop that is active for the lifetime of GDI+. Call the hook function before the loop starts, and call the unhook function after the loop ends. The token parameter of the hook function receives an identifier that you should later pass to the unhook function. If you do not pass the proper identifier (the one returned by the hook function) to the unhook function, there will be resource leaks that won't be cleaned up until the process exits.

If you do not want to be responsible for calling the hook and unhook functions, set the SuppressBackgroundThread member of the input parameter (passed to GdiplusStartup) to FALSE.

TYPE GdiplusStartupOutput
   NotificationHook AS NotificationHookProc
   NotificationUnhook AS NotificationUnhookProc
END TYPE

GpPathData Structure

The GpPathData structure is used by the GdipGetPathData function. It has an array of points and an array of types. Each element in the array of types is a byte that specifies the point type and a set of flags for the corresponding element in the array of points. You can use a GpathData structure to get or set the data points (and their types) of a path.

TYPE GpPathData
   Count AS INT_
   Points AS GpPointF PTR
   Types AS BYTE PTR
END TYPE

-also-

type GpPathData as any

Remarks

Because of another mess in the FreeBASIC Gdi+ headers, this structure can't be used with 32 and 64-bit at the same time. Therefore, I have declared a replacement in AfxGdiPlus.inc.

TYPE GDIP_PATHDATA
   Count AS LONG
   Points AS GpPointF PTR
   Types AS UBYTE PTR
END TYPE

GpPoint Structure

Defines the x- and y-coordinates of a point.

TYPE GpPoint
   x AS INT_
   y AS INT_
END TYPE

GpPointF Structure

Defines the x- and y-coordinates of a point.

TYPE GpPoint
   x AS FLOAT
   y AS FLOAT
END TYPE

GpRect Structure

Defines the upper-left corner, width, and height of a rectangle.

TYPE GpRect
   x AS INT_
   y AS INT_
   width AS INT_
   height AS INT_
END TYPE

GpRectF Structure

Defines the upper-left corner, width, and height of a rectangle.

TYPE GpRect
   x AS REAL
   y AS REAL
   width AS REAL
   height AS REAL
END TYPE

GpSize Structure

Encapsulates a Width and Height dimension in a 2-D coordinate system.

TYPE GpSize
   Width AS INT_
   Height AS INT_
END TYPE

GpSizeF Structure

Encapsulates a Width and Height dimension in a 2-D coordinate system.

TYPE GpSizeF
   Width AS REAL
   Height AS REAL
END TYPE

ImageCodecInfo Structure

An ImageCodecInfo structure stores information about an image codec (encoder/decoder). GDI+ provides several built-in image codecs. You can obtain information about those codecs by calling the GetImageEncoders function and the GetImageDecoders function. Each of those functions returns an array of ImageCodecInfo structures, one for each available encoder or decoder.

TYPE ImageCodecInfo
   Clsid AS CLSID
   FormatID AS GUID
   CodecName AS WCHAR PTR
   DllName AS WCHAR PTR
   FormatDescription AS WCHAR PTR
   FilenameExtension AS WCHAR PTR
   MimeType AS WCHAR PTR
   Flags AS DWORD
   Version AS DWORD
   SigCount AS DWORD
   SigSize AS DWORD
   SigPattern AS UBYTE PTR
   SigMask AS UBYTE PTR
END TYPE

LOGFONTA Structure

Defines the attributes of a font.

TYPE LOGFONTA
   lfHeight AS LONG
   lfWidth AS LONG
   lfEscapement AS LONG
   lfOrientation AS LONG
   lfWeight AS LONG
   lfItalic AS UBYTE
   lfUnderline AS UBYTE
   lfStrikeOut AS UBYTE
   lfCharSet AS UBYTE
   lfOutPrecision AS UBYTE
   lfClipPrecision AS UBYTE
   lfQuality AS UBYTE
   lfPitchAndFamily AS UBYTE
   lfFaceName AS ZSTRING * 32   ' LF_FACESIZE
END TYPE

LOGFONTW Structure

Defines the attributes of a font.

TYPE LOGFONTW
   lfHeight AS LONG
   lfWidth AS LONG
   lfEscapement AS LONG
   lfOrientation AS LONG
   lfWeight AS LONG
   lfItalic AS UBYTE
   lfUnderline AS UBYTE
   lfStrikeOut AS UBYTE
   lfCharSet AS UBYTE
   lfOutPrecision AS UBYTE
   lfClipPrecision AS UBYTE
   lfQuality AS UBYTE
   lfPitchAndFamily AS UBYTE
   lfFaceName AS WSTRING * 32   ' LF_FACESIZE
END TYPE

MetafileHeader Structure

A MetafileHeader structure stores properties of an associated metafile.

UNION MetafileHeader_UNION
   WmfHeader AS METAHEADER
   EmfHeader AS ENHMETAHEADER3
END UNION

TYPE MetafileHeader
   Type_ AS MetafileType     ' // The type of the associated metafile
   Size AS UINT              ' // Size of the metafile (in bytes)
   Version AS UINT           ' // EMF+, EMF, or WMF version
   EmfPlusFlags AS UINT
   DpiX AS REAL
   DpiY AS REAL
   X AS INT_                 ' // Bounds in device units
   Y AS INT_
   Width AS INT_
   Height AS INT_
   union
      WmfHeader as METAHEADER
      EmfHeader as ENHMETAHEADER3
   end union
   EmfPlusHeaderSize AS INT_ ' // size of the EMF+ header in file
   LogicalDpiX AS INT_       ' // Logical Dpi of reference Hdc
   LogicalDpiY AS INT_       ' // usually valid only for EMF+
END TYPE

Remarks

Metafiles provide a device-independent and application-independent way to share pictures. They contain records that describe a sequence of graphics application programming interfaces (APIs) to invoke in a particular order with their associated graphics data. Metafiles can be recorded by an application and later played back by that application or by another one to reproduce a particular picture. They can also be used to send content to a print spooler. Enhanced metafiles support the ability to provide both Microsoft Windows GDI+ and Windows Graphics Device Interface (GDI) descriptions of the same picture so that both GDI+ and down-level GDI applications can render it.

PropertyItem Structure

A PropertyItem structure holds one piece of image metadata.

TYPE PropertyItem
   id AS PROPID
   length AS ULONG
   wtype AS WORD
   value AS ANY PTR
END TYPE

PWMFRect16 Structure

The PWMFRect16 structure defines a rectangle that bounds a placeable metafile. The rectangle defines the size and position of the metafile.

TYPE PWMFRect16
   Left AS INT16
   Top AS INT16
   Right AS INT16
   Bottom AS INT16
END TYPE

WmfPlaceableFileHeader Structure

The WmfPlaceableFileHeader structure defines the fields of a placeable metafile header. Placeable metafiles were created as a way of specifying how a metafile is mapped and scaled on a display device.

TYPE WmfPlaceableFileHeader
   Key AS UINT32
   Hmf AS INT16
   BoundingBox AS PWMFRect16
   Inch AS INT16
   Reserved AS UINT32
   Checksum AS INT16
END TYPE

Remarks

Although placeable metafiles are quite common, they are not directly supported by the Microsoft Windows application programming interface (API). To display a placeable metafile using the Windows API, you must first strip the placeable metafile header from the file. This is typically performed by copying the metafile to a temporary file starting at file offset 22 (0x16). This is because each placeable metafile begins with a 22-byte header that is followed by a standard metafile.

BrushType Enumeration

The BrushType enumeration indicates the type of brush. There are five types of brushes.

BrushTypeSolidColor = 0
BrushTypeHatchFill = 1
BrushTypeTextureFill = 2
BrushTypePathGradient = 3
BrushTypeLinearGradient = 4

Color Enumeration

AliceBlue = &hFFF0F8FF
AntiqueWhite = &hFFFAEBD7
Aqua = &hFF00FFFF
Aquamarine = &hFF7FFFD4
Azure = &hFFF0FFFF
Beige = &hFFF5F5DC
Bisque = &hFFFFE4C4
Black = &hFF000000
BlanchedAlmond = &hFFFFEBCD
Blue = &hFF0000FF
BlueViolet = &hFF8A2BE2
Brown = &hFFA52A2A
BurlyWood = &hFFDEB887
CadetBlue = &hFF5F9EA0
Chartreuse = &hFF7FFF00
Chocolate = &hFFD2691E
Coral = &hFFFF7F50
CornflowerBlue = &hFF6495ED
Cornsilk = &hFFFFF8DC
Crimson = &hFFDC143C
Cyan = &hFF00FFFF
DarkBlue = &hFF00008B
DarkCyan = &hFF008B8B
DarkGoldenrod = &hFFB8860B
DarkGray = &hFFA9A9A9
DarkGreen = &hFF006400
DarkKhaki = &hFFBDB76B
DarkMagenta = &hFF8B008B
DarkOliveGreen = &hFF556B2F
DarkOrange = &hFFFF8C00
DarkOrchid = &hFF9932CC
DarkRed = &hFF8B0000
DarkSalmon = &hFFE9967A
DarkSeaGreen = &hFF8FBC8B
DarkSlateBlue = &hFF483D8B
DarkSlateGray = &hFF2F4F4F
DarkTurquoise = &hFF00CED1
DarkViolet = &hFF9400D3
DeepPink = &hFFFF1493
DeepSkyBlue = &hFF00BFFF
DimGray = &hFF696969
DodgerBlue = &hFF1E90FF
Firebrick = &hFFB22222
FloralWhite = &hFFFFFAF0
ForestGreen = &hFF228B22
Fuchsia = &hFFFF00FF
Gainsboro = &hFFDCDCDC
GhostWhite = &hFFF8F8FF
Gold = &hFFFFD700
Goldenrod = &hFFDAA520
Gray = &hFF808080
Green = &hFF008000
GreenYellow = &hFFADFF2F
Honeydew = &hFFF0FFF0
HotPink = &hFFFF69B4
IndianRed = &hFFCD5C5C
Indigo = &hFF4B0082
Ivory = &hFFFFFFF0
Khaki = &hFFF0E68C
Lavender = &hFFE6E6FA
LavenderBlush = &hFFFFF0F5
LawnGreen = &hFF7CFC00
LemonChiffon = &hFFFFFACD
LightBlue = &hFFADD8E6
LightCoral = &hFFF08080
LightCyan = &hFFE0FFFF
LightGoldenrodYellow = &hFFFAFAD2
LightGray = &hFFD3D3D3
LightGreen = &hFF90EE90
LightPink = &hFFFFB6C1
LightSalmon = &hFFFFA07A
LightSeaGreen = &hFF20B2AA
LightSkyBlue = &hFF87CEFA
LightSlateGray = &hFF778899
LightSteelBlue = &hFFB0C4DE
LightYellow = &hFFFFFFE0
Lime = &hFF00FF00
LimeGreen = &hFF32CD32
Linen = &hFFFAF0E6
Magenta = &hFFFF00FF
Maroon = &hFF800000
MediumAquamarine = &hFF66CDAA
MediumBlue = &hFF0000CD
MediumOrchid = &hFFBA55D3
MediumPurple = &hFF9370DB
MediumSeaGreen = &hFF3CB371
MediumSlateBlue = &hFF7B68EE
MediumSpringGreen = &hFF00FA9A
MediumTurquoise = &hFF48D1CC
MediumVioletRed = &hFFC71585
MidnightBlue = &hFF191970
MintCream = &hFFF5FFFA
MistyRose = &hFFFFE4E1
Moccasin = &hFFFFE4B5
NavajoWhite = &hFFFFDEAD
Navy = &hFF000080
OldLace = &hFFFDF5E6
Olive = &hFF808000
OliveDrab = &hFF6B8E23
Orange = &hFFFFA500
OrangeRed = &hFFFF4500
Orchid = &hFFDA70D6
PaleGoldenrod = &hFFEEE8AA
PaleGreen = &hFF98FB98
PaleTurquoise = &hFFAFEEEE
PaleVioletRed = &hFFDB7093
PapayaWhip = &hFFFFEFD5
PeachPuff = &hFFFFDAB9
Peru = &hFFCD853F
Pink = &hFFFFC0CB
Plum = &hFFDDA0DD
PowderBlue = &hFFB0E0E6
Purple = &hFF800080
Red = &hFFFF0000
RosyBrown = &hFFBC8F8F
RoyalBlue = &hFF4169E1
SaddleBrown = &hFF8B4513
Salmon = &hFFFA8072
SandyBrown = &hFFF4A460
SeaGreen = &hFF2E8B57
SeaShell = &hFFFFF5EE
Sienna = &hFFA0522D
Silver = &hFFC0C0C0
SkyBlue = &hFF87CEEB
SlateBlue = &hFF6A5ACD
SlateGray = &hFF708090
Snow = &hFFFFFAFA
SpringGreen = &hFF00FF7F
SteelBlue = &hFF4682B4
Tan = &hFFD2B48C
Teal = &hFF008080
Thistle = &hFFD8BFD8
Tomato = &hFFFF6347
Transparent = &hFFFFFF
Turquoise = &hFF40E0D0
Violet = &hFFEE82EE
Wheat = &hFFF5DEB3
White = &hFFFFFFFF
WhiteSmoke = &hFFF5F5F5
Yellow = &hFFFFFF00
YellowGreen = &hFF9ACD32

AlphaShift = 24
RedShift = 16
GreenShift = 8
BlueShift = 0

AlphaMask = &hFF000000
RedMask = &h00FF0000
GreenMask = &h0000FF00
BlueMask = &hh000000FF

ColorAdjustType Enumeration

The ColorAdjustType enumeration specifies which GDI+ objects use color-adjustment information. You can adjust the colors in a rendered image using the ImageAttributes functions. There are five adjustment categories: default, bitmap, brush, pen, and text.

ColorAdjustTypeDefault = 0
ColorAdjustTypeBitmap  = 1
ColorAdjustTypeBrush   = 2
ColorAdjustTypePen     = 3
ColorAdjustTypeText    = 4
ColorAdjustTypeCount   = 5
ColorAdjustTypeAny     = 6

ColorChannelFlags Enumeration

The ColorChannelFlags enumeration specifies individual channels in the CMYK (cyan, magenta, yellow, black) color space. This enumeration is used by the GdipSetImageAttributesOutputChannel function.

ColorChannelFlagsC    = 0
ColorChannelFlagsM    = 1
ColorChannelFlagsY    = 2
ColorChannelFlagsK    = 3
ColorChannelFlagsLast = 4

ColorMatrixFlags Enumeration

The ColorMatrixFlags enumeration specifies the types of images and colors that will be affected by the color and grayscale adjustment settings. It is used by the GdipSetImageAttributesColorMatrix function.

ColorMatrixFlagsDefault = 0
ColorMatrixFlagsSkipGrays = 1
ColorMatrixFlagsAltGray = 2

ColorMode Enumeration

ColorModeARGB32 = 0
ColorModeARGB64 = 1

CombineMode Enumeration

The CombineMode enumeration specifies how a new region is combined with an existing region.

CombineModeReplace      = 0
CombineModeIntersect    = 1
CombineModeUnion        = 2
CombineModeXor          = 3
CombineModeExclude      = 4
CombineModeComplement   = 5

CompositingMode Enumeration

The CompositingMode enumeration specifies how rendered colors are combined with background colors. This enumeration is used by the GdipGetCompositingMode and GdipSetCompositingMode functions.

CompositingModeSourceOver = 0
CompositingModeSourceCopy = 1

CompositingQuality Enumeration

The CompositingQuality enumeration specifies whether gamma correction is applied when colors are blended with background colors. This enumeration is used by the GdipGetCompositingQuality and GdipSetCompositingQuality functions.

CompositingQualityInvalid        = QualityModeInvalid
CompositingQualityDefault        = QualityModeDefault
CompositingQualityHighSpeed      = QualityModeLow
CompositingQualityHighQuality    = QualityModeHigh
CompositingQualityGammaCorrected = 3
CompositingQualityAssumeLinear   = 4

Remarks

When you specify that gamma correction should not be applied, the image data to be rendered (blended with the background) is assumed to be in a linear color space with a gamma value of 1.0. As a result, no gamma adjustment is applied to the image data before or after blending the image with the background.

When you specify that gamma correction should be applied, the image data to be rendered (blended with the background) is assumed to be in the sRGB color space with a gamma value of 2.2. To ensure accurate blending, the input image data is transformed into a linear (gamma = 1.0) space before the colors are blended and transformed back into sRGB (gamma = 2.2) space afterward. This mode results in a more accurate blend at the expense of additional processing time.

CoordinateSpace Enumeration

The CoordinateSpace enumeration specifies coordinate spaces. This enumeration is used by the GdipTransformPoints and GdipTransformPointsI functions, which converts points from one coordinate space to another.

CoordinateSpaceWorld  = 0
CoordinateSpacePage   = 1
CoordinateSpaceDevice = 2

CustomLineCapType Enumeration

CustomLineCapTypeDefault = 0
CustomLineCapTypeAdjustableArrow = 1

DashCap Enumeration

The DashCap enumeration specifies the type of graphic shape to use on both ends of each dash in a dashed line.

DashCapFlat = 0
DashCapRound = 2
DashCapTriangle = 3

Remarks

If you set the alignment of a Pen to PenAlignmentInset, you cannot use that pen to draw triangular dash caps.

DashStyle Enumeration

The DashStyle enumeration specifies the line style of a line drawn with a Microsoft Windows GDI+ pen. The line can be drawn by using one of several predefined styles or a custom style.

DashStyleSolid      = 0
DashStyleDash       = 1
DashStyleDot        = 2
DashStyleDashDot    = 3
DashStyleDashDotDot = 4
DashStyleCustom     = 5

DriverStringOptions Enumeration

The DriverStringOptions enumeration specifies the spacing, orientation, and quality of the rendering for driver strings.

DriverStringOptionsCmapLookup      = 1
DriverStringOptionsVertical        = 2
DriverStringOptionsRealizedAdvance = 4
DriverStringOptionsLimitSubpixel   = 8

EmfToWmfBitsFlags Enumeration

Specifies options for the GdipEmfToWmfBits method, which converts an Enhanced Metafile (EMF) metafile to a Microsoft Windows Metafile Format (WMF) metafile.

EmfToWmfBitsFlagsDefault          = &H00000000
EmfToWmfBitsFlagsEmbedEmf         = &H00000001
EmfToWmfBitsFlagsIncludePlaceable = &H00000002
EmfToWmfBitsFlagsNoXORClip        = &H00000004

EmfType Enumeration

The EmfType enumeration specifies the nature of the records that are placed in an Enhanced Metafile (EMF) file.

EmfTypeEmfOnly = MetafileTypeEmf
EmfTypeEmfPlusOnly = MetafileTypeEmfPlusOnly
EmfTypeEmfPlusDual = MetafileTypeEmfPlusDual

EncoderParameterValueType Enumeration

The EncoderParameterValueType enumeration specifies data types for image codec (encoder/decoder) parameters. An element of this enumeration is assigned to the Type data member of an EncoderParameter structure.

EncoderParameterValueTypeByte = 1
EncoderParameterValueTypeASCII = 2
EncoderParameterValueTypeShort = 3
EncoderParameterValueTypeLong = 4
EncoderParameterValueTypeRational = 5
EncoderParameterValueTypeLongRange = 6
EncoderParameterValueTypeUndefined = 7
EncoderParameterValueTypeRationalRange = 8
EncoderParameterValueTypePointer = 9

EncoderValue Enumeration

The EncoderValue enumeration specifies values that can be passed as arguments to image encoders.

EncoderValueColorTypeCMYK             = 0
EncoderValueColorTypeYCCK             = 1
EncoderValueCompressionLZW            = 2
EncoderValueCompressionCCITT3         = 3
EncoderValueCompressionCCITT4         = 4
EncoderValueCompressionRle            = 5
EncoderValueCompressionNone           = 6
EncoderValueScanMethodInterlaced      = 7
EncoderValueScanMethodNonInterlaced   = 8
EncoderValueVersionGif87              = 9
EncoderValueVersionGif89              = 10
EncoderValueRenderProgressive         = 11
EncoderValueRenderNonProgressive      = 12
EncoderValueTransformRotate90         = 13
EncoderValueTransformRotate180        = 14
EncoderValueTransformRotate270        = 15
EncoderValueTransformFlipHorizontal   = 16
EncoderValueTransformFlipVertical     = 17
EncoderValueMultiFrame                = 18
EncoderValueLastFrame                 = 19
EncoderValueFlush                     = 20
EncoderValueFrameDimensionTime        = 21
EncoderValueFrameDimensionResolution  = 22
EncoderValueFrameDimensionPage        = 23
EncoderValueColorTypeGray             = 24
EncoderValueColorTypeRGB              = 25

FillMode Enumeration

The FillMode enumeration specifies how to fill areas that are formed when a path or curve intersects itself.

FillModeAlternate = 0
FillModeWinding   = 1

FlushIntention Enumeration

The FlushIntention enumeration specifies when to flush the queue of graphics operations.

FlushIntentionFlush = 0
FlushIntentionSync = 1

FontStyle Enumeration

The FontStyle enumeration specifies the style of the typeface of a font. Styles can be combined.

FontStyleRegular = 0
FontStyleBold = 1
FontStyleItalic = 2
FontStyleBoldItalic = 3
FontStyleUnderline = 4
FontStyleStrikeout = 8

GenericFontFamily Enumeration

GenericFontFamilySerif = 0
GenericFontFamilySansSerif = 1
GenericFontFamilyMonospace = 2

HatchStyle Enumeration

The HatchStyle enumeration specifies the hatch pattern used by a brush of type HatchBrush. The hatch pattern consists of a solid background color and lines drawn over the background.

HatchStyleHorizontal                   = 0
HatchStyleVertical                     = 1
HatchStyleForwardDiagonal              = 2
HatchStyleBackwardDiagonal             = 3
HatchStyleCross                        = 4
HatchStyleDiagonalCross                = 5
HatchStyle05Percent                    = 6
HatchStyle10Percent                    = 7
HatchStyle20Percent                    = 8
HatchStyle25Percent                    = 9
HatchStyle30Percent                    = 10
HatchStyle40Percent                    = 11
HatchStyle50Percent                    = 12
HatchStyle60Percent                    = 13
HatchStyle70Percent                    = 14
HatchStyle75Percent                    = 15
HatchStyle80Percent                    = 16
HatchStyle90Percent                    = 17
HatchStyleLightDownwardDiagonal        = 18
HatchStyleLightUpwardDiagonal          = 19
HatchStyleDarkDownwardDiagonal         = 20
HatchStyleDarkUpwardDiagonal           = 21
HatchStyleWideDownwardDiagonal         = 22
HatchStyleWideUpwardDiagonal           = 23
HatchStyleLightVertical                = 24
HatchStyleLightHorizontal              = 25
HatchStyleNarrowVertical               = 26
HatchStyleNarrowHorizontal             = 27
HatchStyleDarkVertical                 = 28
HatchStyleDarkHorizontal               = 29
HatchStyleDashedDownwardDiagonal       = 30
HatchStyleDashedUpwardDiagonal         = 31
HatchStyleDashedHorizontal             = 32
HatchStyleDashedVertical               = 33
HatchStyleSmallConfetti                = 34
HatchStyleLargeConfetti                = 35
HatchStyleZigZag                       = 36
HatchStyleWave                         = 37
HatchStyleDiagonalBrick                = 38
HatchStyleHorizontalBrick              = 39
HatchStyleWeave                        = 40
HatchStylePlaid                        = 41
HatchStyleDivot                        = 42
HatchStyleDottedGrid                   = 43
HatchStyleDottedDiamond                = 44
HatchStyleShingle                      = 45
HatchStyleTrellis                      = 46
HatchStyleSphere                       = 47
HatchStyleSmallGrid                    = 48
HatchStyleSmallCheckerBoard            = 49
HatchStyleLargeCheckerBoard            = 50
HatchStyleOutlinedDiamond              = 51
HatchStyleSolidDiamond                 = 52
HatchStyleTotal     = 53
HatchStyleLargeGrid = HatchStyleCross
HatchStyleMin       = HatchStyleHorizontal
HatchStyleMax       = HatchStyleTotal - 1

HistogramFormat Enumeration

The HistogramFormat enumeration specifies the number and type of histograms that represent the color channels of a bitmap. This enumeration is used with the GdipBitmapGetHistogram function.

HistogramFormatARGB  = 0
HistogramFormatPARGB = 1
HistogramFormatRGB   = 2
HistogramFormatGray  = 3
HistogramFormatB     = 4
HistogramFormatG     = 5
HistogramFormatR     = 6
HistogramFormatA     = 7

HotkeyPrefix Enumeration

The HotkeyPrefix enumeration specifies how to display hot keys. There are three options: do nothing, display hot keys underlined, and hide the hot key underlines.

HotkeyPrefixNone = 0
HotkeyPrefixShow = 1
HotkeyPrefixHide = 2

Remarks

Hot keys are keys that are programmed to provide keyboard shortcuts to functionality and are activated by pressing the ALT key. The keys are application dependent and are identified by an underscored letter, typically in a menu. An example would be the File menu with the letter F underscored. This makes the F key a hot key to launch the File menu.

ImageFlags Enumeration

The ImageFlags enumeration specifies the attributes of the pixel data contained in an image. The GdipGetImageFlags function returns an element of this enumeration.

ImageFlagsNone                = 0
'// Low-word: shared with SINKFLAG_x
ImageFlagsScalable            = &H00000001
ImageFlagsHasAlpha            = &H00000002
ImageFlagsHasTranslucent      = &H00000004
ImageFlagsPartiallyScalable   = &H00000008
'// Low-word: color space definition
ImageFlagsColorSpaceRGB       = &H00000010
ImageFlagsColorSpaceCMYK      = &H00000020
ImageFlagsColorSpaceGRAY      = &H00000040
ImageFlagsColorSpaceYCBCR     = &H00000080
ImageFlagsColorSpaceYCCK      = &H00000100
'// Low-word: image size info
ImageFlagsHasRealDPI          = &H00001000
ImageFlagsHasRealPixelSize    = &H00002000
'// High-word
ImageFlagsReadOnly            = &H00010000
ImageFlagsCaching             = &H00020000

ImageLockMode Enumeration

The ImageLockMode enumeration specifies flags that are passed to the flags parameter of the GdipBitmapLockBits function. The GdipBitmapLockBits function locks a portion of an image so that you can read or write the pixel data.

ImageLockModeRead         = &H0001
ImageLockModeWrite        = &H0002
ImageLockModeUserInputBuf = &H0004

ImageType Enumeration

The ImageType enumeration indicates whether an image is a bitmap or a metafile. The GdipGetImageType function returns an element of this enumeration.

ImageTypeUnknown   = 0
ImageTypeBitmap    = 1
ImageTypeMetafile  = 2

InterpolationMode Enumeration

The InterpolationMode enumeration specifies the algorithm that is used when images are scaled or rotated. This enumeration is used by the GdipGetInterpolationMode and GdipSetInterpolationMode functions of the Graphics functions.

InterpolationModeInvalid = QualityModeInvalid
InterpolationModeDefault = QualityModeDefault
InterpolationModeLowQuality = QualityModeLow
InterpolationModeHighQuality = QualityModeHigh
InterpolationModeBilinear = 3
InterpolationModeBicubic = 4
InterpolationModeNearestNeighbor = 5
InterpolationModeHighQualityBilinear = 6
InterpolationModeHighQualityBicubic = 7

ItemDataPosition Enumeration

The ItemDataPosition enumeration is used to specify the location of custom metadata in an image file.

ItemDataPositionAfterHeader = 0
ItemDataPositionAfterPalette = 1
ItemDataPositionAfterBits = 2

Remarks

GDI+ supports custom metadata for JPEG, PNG, and GIF image files.

LinearGradientMode Enumeration

The LinearGradientMode enumeration specifies the direction in which the change of color occurs for a linear gradient brush.

LinearGradientModeHorizontal         = 0
LinearGradientModeVertical           = 1
LinearGradientModeForwardDiagonal    = 2
LinearGradientModeBackwardDiagonal   = 3

LineCap Enumeration

The LineCap enumeration specifies the type of graphic shape to use on the end of a line drawn with a Microsoft Windows GDI+ pen. The cap can be a square, circle, triangle, arrowhead, custom, or masked (hidden). End caps can also "anchor" the line by centering the cap at the end of the line.

LineCapFlat = 0
LineCapSquare = 1
LineCapRound = 2
LineCapTriangle = 3
LineCapNoAnchor = &H10
LineCapSquareAnchor = &H11
LineCapRoundAnchor = &H12
LineCapDiamondAnchor = &H13
LineCapArrowAnchor = &H14
LineCapCustom = &HFF
LineCapAnchorMask = &HF0

LineJoin Enumeration

The LineJoin enumeration specifies how to join two lines that are drawn by the same pen and whose ends meet. At the intersection of the two line ends, a line join makes the join look more continuous.

LineJoinMiter = 0
LineJoinBevel = 1
LineJoinRound = 2
LineJoinMiterClipped = 3

Remarks

The miter length is the distance from the intersection of the line walls on the inside of the join to the intersection of the line walls outside of the join. The miter length can be large when the angle between two lines is small. The miter limit is the maximum allowed ratio of miter length to stroke width. The default value is 10.0f.

When using LineJoinMiter and the actual ratio exceeds the miter limit, the corner is clipped perpendicular to the miter at a distance from the inner corner that is the product of the miter limit and the pen width.

When using LineJoinMiterClipped and the miter limit is exceeded, the join is drawn as if its type were LineJoinBevel; that is, when the line walls on the inside of the join meet, then a joining line is drawn between the line walls on the outside of the join.

MatrixOrder Enumeration

The MatrixOrder enumeration specifies the order of multiplication when a new matrix is multiplied by an existing matrix.

MatrixOrderPrepend = 0
MatrixOrderAppend = 1

MetafileFrameUnit Enumeration

The MetafileFrameUnit enumeration specifies the unit of measure for a metafile frame rectangle.

MetafileFrameUnitPixel      = UnitPixel
MetafileFrameUnitPoint      = UnitPoint
MetafileFrameUnitInch       = UnitInch
MetafileFrameUnitDocument   = UnitDocument
MetafileFrameUnitMillimeter = UnitMillimeter
MetafileFrameUnitGdi        = 7 

MetafileType Enumeration

The MetafileType enumeration specifies types of metafiles.

MetafileTypeInvalid           = 0
MetafileTypeWmf               = 1
MetafileTypeWmfPlaceable      = 2
MetafileTypeEmf               = 3
MetafileTypeEmfPlusOnly       = 4
MetafileTypeEmfPlusDual       = 5

ObjectType Enumeration

The ObjectType enumeration indicates the object type value of an EMF+ record.

ObjectTypeInvalid          = 0
ObjectTypeBrush            = 1
ObjectTypePen              = 2
ObjectTypePath             = 3
ObjectTypeRegion           = 4
ObjectTypeImage            = 5
ObjectTypeFont             = 6
ObjectTypeStringFormat     = 7
ObjectTypeImageAttributes  = 8
ObjectTypeCustomLineCap    = 9
ObjectTypeMax = ObjectTypeCustomLineCap
ObjectTypeMin = ObjectTypeBrush

Remarks

To determine whether the object type value of an EMF+ record is valid, call ObjectTypeIsValid.

PaletteFlags Enumeration

The PaletteFlags enumeration indicates attributes of the color data in a palette.

PaletteFlagsHasAlpha    = &H0001
PaletteFlagsGrayScale   = &H0002
PaletteFlagsHalftone    = &H0004

PaletteType Enumeration

The PaletteType enumeration is used by the GdipInitializePalette and GdipBitmapConvertFormat functions. The members of the enumeration identify several standard color palette formats.

PaletteTypeCustom = 0
PaletteTypeOptimal = 1
PaletteTypeFixedBW = 2
PaletteTypeFixedHalftone8 = 3
PaletteTypeFixedHalftone27 = 4
PaletteTypeFixedHalftone64 = 5
PaletteTypeFixedHalftone125 = 6
PaletteTypeFixedHalftone216 = 7
PaletteTypeFixedHalftone252 = 8
PaletteTypeFixedHalftone256 = 9

PathPointType Enumeration

The PathPointType enumeration indicates point types and flags for the data points in a path. Bits 0 through 2 indicate the type of a point, and bits 3 through 7 hold a set of flags that specify attributes of a point.

PathPointTypeStart           = 0
PathPointTypeLine            = 1
PathPointTypeBezier          = 3
PathPointTypePathTypeMask    = &H07
PathPointTypeDashMode        = &H10
PathPointTypePathMarker      = &H20
PathPointTypeCloseSubpath    = &H80
PathPointTypeBezier3         = 3

PenAlignment Enumeration

The PenAlignment enumeration specifies the alignment of a pen relative to the stroke that is being drawn.

PenAlignmentCenter = 0
PenAlignmentInset = 1

Remarks

If you set the alignment of a Pen object to PenAlignmentInset, you cannot use that pen to draw compound lines or triangular dash caps.

PenType Enumeration

The PenType enumeration indicates the type of pattern, texture, or gradient that a pen draws.

PenTypeSolidColor = BrushTypeSolidColor
PenTypeHatchFill = BrushTypeHatchFill
PenTypeTextureFill = BrushTypeTextureFill
PenTypePathGradient = BrushTypePathGradient
PenTypeLinearGradient = BrushTypeLinearGradient
PenTypeUnknown = -1

PixelOffsetMode Enumeration

The PixelOffsetMode enumeration specifies the pixel offset mode. This enumeration is used by the GdipGetPixelOffsetMode and GdipSetPixelOffsetMode methods of the Graphics class.

PixelOffsetModeInvalid = QualityModeInvalid
PixelOffsetModeDefault = QualityModeDefault
PixelOffsetModeHighSpeed = QualityModeLow
PixelOffsetModeHighQuality = QualityModeHigh
PixelOffsetModeNone = 3
PixelOffsetModeHalf = 4 

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).

QualityMode Enumeration

The QualityMode enumeration specifies the quality mode.

QualityModeInvalid = -1
QualityModeDefault = 0
QualityModeLow     = 1
QualityModeHigh    = 2

RotateFlipType Enumeration

The RotateFlipType enumeration specifies the direction of an image's rotation and the axis used to flip the image.

RotateNoneFlipNone = 0
Rotate90FlipNone   = 1
Rotate180FlipNone  = 2
Rotate270FlipNone  = 3
RotateNoneFlipX    = 4
Rotate90FlipX      = 5
Rotate180FlipX     = 6
Rotate270FlipX     = 7
RotateNoneFlipY    = Rotate180FlipX
Rotate90FlipY      = Rotate270FlipX
Rotate180FlipY     = RotateNoneFlipX
Rotate270FlipY     = Rotate90FlipX
RotateNoneFlipXY   = Rotate180FlipNone
Rotate90FlipXY     = Rotate270FlipNone
Rotate180FlipXY    = RotateNoneFlipNone
Rotate270FlipXY    = Rotate90FlipNone

SmoothingMode Enumeration

The SmoothingMode enumeration specifies the type of smoothing (antialiasing) that is applied to lines and curves. This enumeration is used by the GdipGetSmoothingMode and GdipSetSmoothingMode functions.

SmoothingModeInvalid = QualityModeInvalid
SmoothingModeDefault = QualityModeDefault
SmoothingModeHighSpeed = QualityModeLow
SmoothingModeHighQuality = QualityModeHigh
SmoothingModeNone = 3
SmoothingModeAntiAlias = 4

Remarks

Smoothing performed by an 8 X 4 box filter gives better results for nearly vertical lines than it does for nearly horizontal lines. Smoothing performed by an 8 X 8 box filter gives equally good results for nearly vertical and nearly horizontal lines. The 8x8 algorithm produces higher quality smoothing but is slower than the 8 X 4 algorithm.

Status Enumeration

The Status enumeration indicates the result of a Microsoft Windows GDI+ function call.

Ok = 0
GenericError = 1
InvalidParameter = 2
OutOfMemory = 3
ObjectBusy = 4
InsufficientBuffer = 5
NotImplemented = 6
Win32Error = 7
WrongState = 8
Aborted = 9
FileNotFound = 10
ValueOverflow = 11
AccessDenied = 12
UnknownImageFormat = 13
FontFamilyNotFound = 14
FontStyleNotFound = 15
NotTrueTypeFont = 16
UnsupportedGdiplusVersion = 17
GdiplusNotInitialized = 18
PropertyNotFound = 19
PropertyNotSupported = 20
ProfileNotFound = 21

StringAlignment Enumeration

The StringAlignment enumeration specifies how a string is aligned in reference to the bounding rectangle. A bounding rectangle is used to define the area in which the text displays.

StringAlignmentNear = 0
StringAlignmentCenter = 1
StringAlignmentFar = 2

StringDigitSubstitute Enumeration

The StringDigitSubstitute enumeration specifies how to substitute digits in a string according to a user's locale or language.

StringDigitSubstituteUser = 0
StringDigitSubstituteNone = 1
StringDigitSubstituteNational = 2
StringDigitSubstituteTraditional = 3

StringFormatFlags Enumeration

The StringFormatFlags enumeration specifies text layout information (such as orientation and clipping) and display manipulations (such as ellipsis insertion, digit substitution, and representation of characters that are not supported by a font).

StringFormatFlagsDirectionRightToLeft  = &h00000001
StringFormatFlagsDirectionVertical     = &h00000002
StringFormatFlagsNoFitBlackBox         = &h00000004
StringFormatFlagsDisplayFormatControl  = &h00000020
StringFormatFlagsNoFontFallback        = &h00000400
StringFormatFlagsMeasureTrailingSpaces = &h00000800
StringFormatFlagsNoWrap                = &h00001000
StringFormatFlagsLineLimit             = &h00002000
StringFormatFlagsNoClip                = &h00004000

Remarks

Multiple flags set can produce combined effects:

When both StringFormatFlagsDirectionVertical and StringFormatFlagsDirectionRightToLeft are set, individual lines of text are drawn vertically. The first line starts at the right edge of the layout rectangle; the second line of text is to the left of the first line, and so on.

When StringFormatFlagsDirectionVertical is set and StringFormatFlagsDirectionRightToLeft is not set, individual lines of text are drawn vertically. The first line starts at the left edge of the layout rectangle; the second line of text is to the right of the first line.

When StringFormatFlagsDirectionRightToLeft is set and StringFormatFlagsDirectionVertical is not set, the individual lines of text are horizontal and the reading order is from right to left. This setting does not change the order in which characters are displayed, it simply specifies the order in which characters can be read.

The StringFormatFlagsDirectionVertical and StringFormatFlagsDirectionRightToLeft flags can affect string alignment.

The StringTrimming enumeration specifies how to trim characters from a string so that the string fits into a layout rectangle. The layout rectangle is used to position and size the display string.

StringTrimming Enumeration

StringTrimmingNone = 0
StringTrimmingCharacter = 1
StringTrimmingWord = 2
StringTrimmingEllipsisCharacter = 3
StringTrimmingEllipsisWord = 4
StringTrimmingEllipsisPath = 5

Remarks

Trimming affects only the last visible or partly visible (due to clipping) line of text.

TestControl Enumeration

TestControlForceBilinear = 0
TestControlNoICM = 1
TestControlGetBuildNumber = 2

TextRenderingHint Enumeration

The enumeration specifies the process used to render text. The process affects the quality of the text.

TextRenderingHintSystemDefault            = 0
TextRenderingHintSingleBitPerPixelGridFit = 1
TextRenderingHintSingleBitPerPixel        = 2
TextRenderingHintAntiAliasGridFit         = 3
TextRenderingHintAntiAlias                = 4
TextRenderingHintClearTypeGridFit         = 5

Remarks

The quality associated with each process varies according to the circumstances. TextRenderingHintClearTypeGridFit provides the best quality for most LCD monitors and relatively small font sizes. TextRenderingHintAntiAlias provides the best quality for rotated text. Generally, a process that produces higher quality text is slower than a process that produces lower quality text.

Unit Enumeration

The Unit enumeration specifies the unit of measure for a given data type.

UnitWorld      = 0
UnitDisplay    = 1
UnitPixel      = 2
UnitPoint      = 3
UnitInch       = 4
UnitDocument   = 5
UnitMillimeter = 6

WarpMode Enumeration

The WarpMode enumeration specifies warp modes that can be used to transform images.

WarpModePerspective = 0
WarpModeBilinear    = 1

WrapMode Enumeration

The WrapMode enumeration specifies how repeated copies of an image are used to tile an area.

WrapModeTile         = 0
WrapModeTileFlipX    = 1
WrapModeTileFlipY    = 2
WrapModeTileFlipXY   = 3
WrapModeClamp        = 4

Image Encoder Cnstants

The GdipSaveImageToFile, GdipSaveImageToStream, GdipSaveAdd and GdipSaveAddImage functions receive an EncoderParameters structure that contains an array of EncoderParameter objects. Each EncoderParameter object has a globally unique identifier (GUID) data member that specifies the parameter category. The following constants represent GUIDs that specify the various parameter categories.

EncoderCompression      = "{E09D739D-CCD4-44EE-8EBA-3FBF8BE4FC58}"
EncoderColorDepth       = "{66087055-AD66-4C7C-9A18-38A2310B8337}"
EncoderScanMethod       = "{3A4E2661-3109-4E56-8536-42C156E7DCFA}"
EncoderVersion          = "{24D18C76-814A-41A4-BF53-1C219CCCF797}"
EncoderRenderMethod     = "{6D42C53A-229A-4825-8BB7-5C99E2B9A8B8}"
EncoderQuality          = "{1D5BE4B5-FA4A-452D-9CDD-5DB35105E7EB}"
EncoderTransformation   = "{8D0EB2D1-A58E-4EA8-AA14-108074B7B6F9}"
EncoderLuminanceTable   = "{EDB33BCE-0266-4A77-B904-27216099E717}"
EncoderChrominanceTable = "{F2E455DC-09B3-4316-8260-676ADA32481C}"
EncoderSaveFlag         = "{292266FC-AC40-47BF-8CFC-A85B89A655DE}"

Image File Format Constants

The GdipGetImageRawFormat function returns a globally unique identifier (GUID) that indicates the file format of an image. The following constants represent the GUIDs that identify those file formats.

ImageFormatUndefined = "{B96B3CA9-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatMemoryBMP = "{B96B3CAA-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatBMP       = "{B96B3CAB-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatEMF       = "{B96B3CAC-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatWMF       = "{B96B3CAD-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatJPEG      = "{B96B3CAE-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatPNG       = "{B96B3CAF-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatGIF       = "{B96B3CB0-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatTIFF      = "{B96B3CB1-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatEXIF      = "{B96B3CB2-0728-11D3-9D7B-0000F81EF32E}"
ImageFormatIcon      = "{B96B3CB5-0728-11D3-9D7B-0000F81EF32E}"

Image Frame Dimension Constants

The Graphics Interchange Format (GIF) and Tagged Image File Format (TIFF) image file formats enable you to store multiple frames in a single image file. Multiple frames in a GIF file are used for animation, so the frames are said to be in the time dimension. Multiple frames in a TIFF file are typically used as separate pages, so the frames are said to be in the page dimension.

The following constants represent globally unique identifiers (GUIDs) that identify the page and time dimensions.

FrameDimensionTime       = "{6AEDBD6D-3FB5-418A-83A6-7F45229DC872}"
FrameDimensionResolution = "{84236F7B-3BD3-428F-8DAB-4EA1439CA315}"
FrameDimensionPage       = "{7462DC86-6180-4C7E-8E3F-EE7333A7A483}"

Image Pixel Format Constants

The following constants specify various pixel formats used in bitmaps.

PixelFormat1bppIndexed    = 196865
PixelFormat4bppIndexed    = 197634
PixelFormat8bppIndexed    = 198659
PixelFormat16bppGrayScale = 1052676
PixelFormat16bppRGB555    = 135173
PixelFormat16bppRGB565    = 135174
PixelFormat16bppARGB1555  = 397319
PixelFormat24bppRGB       = 137224
PixelFormat32bppRGB       = 139273
PixelFormat32bppARGB      = 2498570
PixelFormat32bppPARGB     = 925707
PixelFormat48bppRGB       = 1060876
PixelFormat64bppARGB      = 3424269
PixelFormat64bppPARGB     = 29622286
PixelFormatMax            = 15

Remarks

PixelFormat48bppRGB, PixelFormat64bppARGB, and PixelFormat64bppPARGB use 16 bits per color component (channel). Microsoft Windows GDI+ version 1.0 can read 16-bits-per-channel images, but such images are converted to an 8-bits-per-channel format for processing, displaying, and saving.

Image Property Tag Type Constants

You can store and retrieve image metadata with the help of a PropertyItem structure. The type data member of a PropertyItem structure specifies the data type of the values stored in the value data member of that same PropertyItem structure.

The following constants can be assigned to the type data member of a PropertyItem structure.

PropertyTagTypeByte       = 1
PropertyTagTypeASCII      = 2
PropertyTagTypeShort      = 3
PropertyTagTypeLong       = 4
PropertyTagTypeRational   = 5
PropertyTagTypeUndefined  = 7
PropertyTagTypeSLONG      = 9
PropertyTagTypeSRational  = 10

Image Property Tag Constants

Several image file formats enable you to store metadata along with an image. Metadata is information about an image, for example, title, width, camera model, and artist. Microsoft Windows GDI+ provides a uniform way of storing and retrieving metadata from image files in the Tagged Image File Format (TIFF), JPEG, Portable Network Graphics (PNG), and Exchangeable Image File (EXIF) formats.

In GDI+, a piece of metadata is called a property item, and an individual property item is identified by a numerical constant called a property tag. You can store and retrieve metadata by calling the GdipSetPropertyItem and GdipGetPropertyItem functions, and you don't have to be concerned with the details of how a particular file format stores that metadata.

The following table lists the Microsoft Windows GDI+ image property tags in numerical order.

See also:

Property Tags in Alphabetical Order

Property Item Descriptions

Image File Format Specification