System.Drawing.Imaging.PixelFormat Enumeration

Specifies the format of the color data for each pixel in the image.

Syntax

public enum PixelFormat

Remarks

The pixel format defines the number of bits of memory associated with one pixel of data. The format also defines the order of the color components within a single pixel of data.

PixelFormat48bppRGB, PixelFormat64bppARGB, and PixelFormat64bppPARGB use 16 bits per color component (channel). GDI+ version 1.0 and 1.1 can read 16-bits-per-channel images, but such images are converted to an 8-bits-per-channel format for processing, displaying, and saving. Each 16-bit color channel can hold a value in the range 0 through 2^13.

Some of the pixel formats contain premultiplied color values. Premultiplied means that the color values have already been multiplied by an alpha value.

Members

Member NameDescription
Alpha

The pixel data contains alpha values that are not premultiplied.

Canonical

The default pixel format of 32 bits per pixel. The format specifies 24-bit color depth and an 8-bit alpha channel.

DontCare

No pixel format is specified.

Extended

Reserved.

Format16bppArgb1555

The pixel format is 16 bits per pixel. The color information specifies 32,768 shades of color, of which 5 bits are red, 5 bits are green, 5 bits are blue, and 1 bit is alpha.

Format16bppGrayScale

The pixel format is 16 bits per pixel. The color information specifies 65536 shades of gray.

Format16bppRgb555

Specifies that the format is 16 bits per pixel; 5 bits each are used for the red, green, and blue components. The remaining bit is not used.

Format16bppRgb565

Specifies that the format is 16 bits per pixel; 5 bits are used for the red component, 6 bits are used for the green component, and 5 bits are used for the blue component.

Format1bppIndexed

Specifies that the pixel format is 1 bit per pixel and that it uses indexed color. The color table therefore has two colors in it.

Format24bppRgb

Specifies that the format is 24 bits per pixel; 8 bits each are used for the red, green, and blue components.

Format32bppArgb

Specifies that the format is 32 bits per pixel; 8 bits each are used for the alpha, red, green, and blue components.

Format32bppPArgb

Specifies that the format is 32 bits per pixel; 8 bits each are used for the alpha, red, green, and blue components. The red, green, and blue components are premultiplied, according to the alpha component.

Format32bppRgb

Specifies that the format is 32 bits per pixel; 8 bits each are used for the red, green, and blue components. The remaining 8 bits are not used.

Format48bppRgb

Specifies that the format is 48 bits per pixel; 16 bits each are used for the red, green, and blue components.

Format4bppIndexed

Specifies that the format is 4 bits per pixel, indexed.

Format64bppArgb

Specifies that the format is 64 bits per pixel; 16 bits each are used for the alpha, red, green, and blue components.

Format64bppPArgb

Specifies that the format is 64 bits per pixel; 16 bits each are used for the alpha, red, green, and blue components. The red, green, and blue components are premultiplied according to the alpha component.

Format8bppIndexed

Specifies that the format is 8 bits per pixel, indexed. The color table therefore has 256 colors in it.

Gdi

The pixel data contains GDI colors.

Indexed

The pixel data contains color-indexed values, which means the values are an index to colors in the system color table, as opposed to individual color values.

Max

The maximum value for this enumeration.

PAlpha

The pixel format contains premultiplied alpha values.

Undefined

The pixel format is undefined.

Requirements

Namespace: System.Drawing.Imaging
Assembly: System.Drawing (in System.Drawing.dll)
Assembly Versions: 1.0.3300.0, 1.0.5000.0, 2.0.0.0