PixelFormat Struct

Definition

Defines a pixel format for images and pixel-based surfaces.

[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.PixelFormatConverter))]
[System.Serializable]
public struct PixelFormat : IEquatable<System.Windows.Media.PixelFormat>
[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.PixelFormatConverter))]
public struct PixelFormat : IEquatable<System.Windows.Media.PixelFormat>
Inheritance
PixelFormat
Attributes
Implements

Examples

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;
}

Remarks

XAML Attribute Usage

<object property="pixelFormat"/>  

XAML Values

pixelFormat
One of the predefined pixel formats defined by the PixelFormats class.

Properties

BitsPerPixel

Gets the number of bits-per-pixel (bpp) for this PixelFormat.

Masks

Gets a collection of bit masks associated with the PixelFormat.

Methods

Equals(Object)

Determines whether the specified object is equal to the current object.

Equals(PixelFormat, PixelFormat)

Determines whether the specified PixelFormat instances are considered equal.

Equals(PixelFormat)

Determines whether the pixel format equals the given PixelFormat.

GetHashCode()

Creates a hash code from this pixel format's Masks value.

ToString()

Creates a string representation of this PixelFormat.

Operators

Equality(PixelFormat, PixelFormat)

Compares two PixelFormat instances for equality.

Inequality(PixelFormat, PixelFormat)

Compares two PixelFormat instances for inequality.

Applies to

Product Versions
.NET Framework 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

See also