System.Drawing.Imaging Namespace ()

Switch on low bandwidth view

Collapse All

Language Filter

This page is specific to

Microsoft Visual Studio 2008/.NET Framework 3.5

Other versions are also available for the following:

.NET Framework Class Library

System.Drawing.Imaging Namespace

The System.Drawing.Imaging namespace provides advanced GDI+ imaging functionality. Basic graphics functionality is provided by the System.Drawing namespace.

The Metafile class provides methods for recording and saving metafiles. The Encoder class enables users to extend GDI+ to support any image format. The PropertyItem class provides methods for storing and retrieving metadata in image files.

Caution:
Classes within the System.Drawing.Imaging namespace are not supported for use within a Windows or ASP.NET service. Attempting to use these classes from within one of these application types may produce unexpected problems, such as diminished service performance and run-time exceptions.

Classes

	Class	Description
	BitmapData	Specifies the attributes of a bitmap image. The BitmapData class is used by the LockBits and UnlockBits methods of the Bitmap class. Not inheritable.
	ColorMap	Defines a map for converting colors. Several methods of the ImageAttributes class adjust image colors by using a color-remap table, which is an array of ColorMap structures. Not inheritable.
	ColorMatrix	Defines a 5 x 5 matrix that contains the coordinates for the RGBA space. Several methods of the ImageAttributes class adjust image colors by using a color matrix. This class cannot be inherited.
	ColorPalette	Defines an array of colors that make up a color palette. The colors are 32-bit ARGB colors. Not inheritable.
	Encoder	An Encoder object encapsulates a globally unique identifier (GUID) that identifies the category of an image encoder parameter.
	EncoderParameter	Used to pass a value, or an array of values, to an image encoder.
	EncoderParameters	Encapsulates an array of EncoderParameter objects.
	FrameDimension	Provides properties that get the frame dimensions of an image. Not inheritable.
	ImageAttributes	An ImageAttributes object contains information about how bitmap and metafile colors are manipulated during rendering. An ImageAttributes object maintains several color-adjustment settings, including color-adjustment matrices, grayscale-adjustment matrices, gamma-correction values, color-map tables, and color-threshold values. During rendering, colors can be corrected, darkened, lightened, and removed. To apply such manipulations, initialize an ImageAttributes object and pass the path of that ImageAttributes object (along with the path of an Image) to the DrawImage method.
	ImageCodecInfo	The ImageCodecInfo class provides the necessary storage members and methods to retrieve all pertinent information about the installed image encoders and decoders (called codecs). Not inheritable.
	ImageFormat	Specifies the file format of the image. Not inheritable.
	Metafile	Defines a graphic metafile. A metafile contains records that describe a sequence of graphics operations that can be recorded (constructed) and played back (displayed). This class is not inheritable.
	MetafileHeader	Contains attributes of an associated Metafile. Not inheritable.
	MetaHeader	Contains information about a windows-format (WMF) metafile.
	PropertyItem	Encapsulates a metadata property to be included in an image file. Not inheritable.
	WmfPlaceableFileHeader	Defines a placeable metafile. Not inheritable.

Delegates

	Delegate	Description
	PlayRecordCallback	This delegate is not used. For an example of enumerating the records of a metafile, see EnumerateMetafile.

Enumerations

	Enumeration	Description
	ColorAdjustType	Specifies which GDI+ objects use color adjustment information.
	ColorChannelFlag	Specifies individual channels in the CMYK (cyan, magenta, yellow, black) color space. This enumeration is used by the SetOutputChannel methods.
	ColorMapType	Specifies the types of color maps.
	ColorMatrixFlag	Specifies the types of images and colors that will be affected by the color and grayscale adjustment settings of an ImageAttributes.
	ColorMode	Specifies two modes for color component values.
	EmfPlusRecordType	Specifies the methods available for use with a metafile to read and write graphic commands.
	EmfType	Specifies the nature of the records that are placed in an Enhanced Metafile (EMF) file. This enumeration is used by several constructors in the Metafile class.
	EncoderParameterValueType	Used to specify the data type of the EncoderParameter used with the Save or SaveAdd method of an image.
	EncoderValue	Used to specify the parameter value passed to a JPEG or TIFF image encoder when using the Image..::.Save or Image..::.SaveAdd methods.
	ImageCodecFlags	Provides attributes of an image encoder/decoder (codec).
	ImageFlags	Specifies the attributes of the pixel data contained in an Image object. The Flags property returns a member of this enumeration.
	ImageLockMode	Specifies flags that are passed to the flags parameter of the LockBits method. The LockBits method locks a portion of an image so that you can read or write the pixel data.
	MetafileFrameUnit	Specifies the unit of measurement for the rectangle used to size and position a metafile. This is specified during the creation of the Metafile object.
	MetafileType	Specifies types of metafiles. The MetafileHeader..::.Type property returns a member of this enumeration.
	PaletteFlags	Specifies the type of color data in the system palette. The data can be color data with alpha, grayscale data only, or halftone data.
	PixelFormat	Specifies the format of the color data for each pixel in the image.

Reference

Other Resources

Graphics and Drawing in Windows Forms

Images, Bitmaps, and Metafiles

Working with Images, Bitmaps, Icons, and Metafiles

Using Image Encoders and Decoders in Managed GDI+

Recoloring Images