PixelFormat Structure
.NET Framework 4.5
Defines a pixel format for images and pixel-based surfaces.
Namespace: System.Windows.Media
Assembly: PresentationCore (in PresentationCore.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
The PixelFormat type exposes the following members.
| Name | Description | |
|---|---|---|
![]() | BitsPerPixel | Gets the number of bits-per-pixel (bpp) for this PixelFormat. |
![]() | Masks | Gets a collection of bit masks associated with the PixelFormat. |
| Name | Description | |
|---|---|---|
![]() | Equals(Object) | Determines whether the specified object is equal to the current object. (Overrides ValueType.Equals(Object).) |
![]() | Equals(PixelFormat) | Determines whether the pixel format equals the given PixelFormat. |
![]() ![]() | Equals(PixelFormat, PixelFormat) | Determines whether the specified PixelFormat instances are considered equal. |
![]() | GetHashCode | Creates a hash code from this pixel format's Masks value. (Overrides ValueType.GetHashCode().) |
![]() | GetType | Gets the Type of the current instance. (Inherited from Object.) |
![]() | ToString | Creates a string representation of this PixelFormat. (Overrides ValueType.ToString().) |
| Name | Description | |
|---|---|---|
![]() ![]() | Equality | Compares two PixelFormat instances for equality. |
![]() ![]() | Inequality | Compares two PixelFormat instances for inequality. |
The following example shows how to create a PixelFormat and find the value of its properties.
public PixelFormat createPixelFormat() { // Create a PixelFormat object. PixelFormat myPixelFormat = new PixelFormat(); // Make this PixelFormat a Gray32Float pixel format. myPixelFormat = PixelFormats.Gray32Float; // Get the number of bits-per-pixel for this format. Because // the format is "Gray32Float", the float value returned will be 32. int bpp = myPixelFormat.BitsPerPixel; // Get the collection of masks associated with this format. IList<PixelFormatChannelMask> myChannelMaskCollection = myPixelFormat.Masks; // Capture the mask info in a string. String stringOfValues = " "; foreach (PixelFormatChannelMask myMask in myChannelMaskCollection) { IList<byte> myBytesCollection = myMask.Mask; foreach (byte myByte in myBytesCollection) { stringOfValues = stringOfValues + myByte.ToString(); } } // Return the PixelFormat which, for example, could be // used to set the pixel format of a bitmap by using it to set // the DestinationFormat of a FormatConvertedBitmap. return myPixelFormat; }
More Code
| How to: Convert an Image to Greyscale | This example shows how to convert an image to grayscale using FormatConvertedBitmap. |
Windows 8, Windows Server 2012, Windows 7, Windows Vista SP2, Windows Server 2008 (Server Core Role not supported), Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)
The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
