Click to Rate and Give Feedback
MSDN
MSDN Library
.NET Development
.NET Framework 3.5
 PixelFormat Enumeration

  Switch on low bandwidth view
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
PixelFormat Enumeration

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

Namespace:  System.Drawing.Imaging
Assembly:  System.Drawing (in System.Drawing.dll)
Visual Basic (Declaration)
Public Enumeration PixelFormat
Visual Basic (Usage)
Dim instance As PixelFormat
C#
public enum PixelFormat
Visual C++
public enum class PixelFormat
JScript
public enum PixelFormat
Member nameDescription
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.
Gdi The pixel data contains GDI colors.
Alpha The pixel data contains alpha values that are not premultiplied.
PAlpha The pixel format contains premultiplied alpha values.
Extended Reserved.
Canonical The default pixel format of 32 bits per pixel. The format specifies 24-bit color depth and an 8-bit alpha channel.
Undefined The pixel format is undefined.
DontCare No pixel format is specified.
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.
Format4bppIndexed Specifies that the format is 4 bits per pixel, indexed.
Format8bppIndexed Specifies that the format is 8 bits per pixel, indexed. The color table therefore has 256 colors in it.
Format16bppGrayScale The pixel format is 16 bits per pixel. The color information specifies 65536 shades of gray.
Supported by the .NET Compact FrameworkFormat16bppRgb555 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.
Supported by the .NET Compact FrameworkFormat16bppRgb565 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.
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.
Supported by the .NET Compact FrameworkFormat24bppRgb Specifies that the format is 24 bits per pixel; 8 bits each are used for the red, green, and blue components.
Supported by the .NET Compact FrameworkFormat32bppRgb 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.
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.
Format48bppRgb Specifies that the format is 48 bits per pixel; 16 bits each are used for the red, green, and blue components.
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.
Max The maximum value for this enumeration.

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.

Windows 7, Windows Vista, Windows XP SP2, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP Starter Edition, Windows Server 2008 R2, Windows Server 2008, Windows Server 2003, Windows Server 2000 SP4, Windows Millennium Edition, Windows 98, Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

.NET Framework

Supported in: 3.5, 3.0, 2.0, 1.1, 1.0

.NET Compact Framework

Supported in: 3.5, 2.0
Tags What's this?: Add a tag
Community Content   What is Community Content?
Add new content RSS  Annotations
Processing
© 2009 Microsoft Corporation. All rights reserved. Terms of Use  |  Trademarks  |  Privacy Statement
Page view tracker