PixelFormat PixelFormat PixelFormat PixelFormat Struct

定義

定義影像的像素格式和以像素為基礎的表面。Defines a pixel format for images and pixel-based surfaces.

public value class PixelFormat : IEquatable<System::Windows::Media::PixelFormat>
[System.ComponentModel.TypeConverter(typeof(System.Windows.Media.PixelFormatConverter))]
[System.Serializable]
public struct PixelFormat : IEquatable<System.Windows.Media.PixelFormat>
type PixelFormat = struct
Public Structure PixelFormat
Implements IEquatable(Of PixelFormat)
繼承
PixelFormatPixelFormatPixelFormatPixelFormat
屬性
實作

範例

下列範例顯示如何建立PixelFormat並尋找其屬性的值。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;
}
        Public Function createPixelFormat() As PixelFormat
            ' Create a PixelFormat object.
            Dim myPixelFormat As 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.
            Dim bpp As Integer = myPixelFormat.BitsPerPixel

            ' Get the collection of masks associated with this format.
            Dim myChannelMaskCollection As IList(Of PixelFormatChannelMask) = (myPixelFormat.Masks)

            ' Capture the mask info in a string.
            Dim stringOfValues As String = " "
            Dim myMask As PixelFormatChannelMask
            For Each myMask In myChannelMaskCollection
                Dim myBytesCollection As IList(Of Byte) = myMask.Mask
                Dim myByte As Byte
                For Each myByte In myBytesCollection
                    stringOfValues = stringOfValues + myByte.ToString()
                Next myByte
            Next myMask

            ' 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

        End Function 'createPixelFormat
    End Class 'PixelFormatsExample 
End Namespace 'ImagingSnippetGallery

備註

XAML Attribute UsageXAML Attribute Usage

<object property="pixelFormat"/>  

XAML 值XAML Values

pixelFormatpixelFormat
PixelFormats類別所定義的其中一個預先定義像素格式。One of the predefined pixel formats defined by the PixelFormats class.

屬性

BitsPerPixel BitsPerPixel BitsPerPixel BitsPerPixel

取得這個 PixelFormat 的每一像素位元數 (bpp) 數目。Gets the number of bits-per-pixel (bpp) for this PixelFormat.

Masks Masks Masks Masks

取得與 PixelFormat 相關聯的位元遮罩集合。Gets a collection of bit masks associated with the PixelFormat.

方法

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

判斷指定的物件是否等於目前的物件。Determines whether the specified object is equal to the current object.

Equals(PixelFormat) Equals(PixelFormat) Equals(PixelFormat) Equals(PixelFormat)

判斷像素格式是否等於指定的 PixelFormatDetermines whether the pixel format equals the given PixelFormat.

Equals(PixelFormat, PixelFormat) Equals(PixelFormat, PixelFormat) Equals(PixelFormat, PixelFormat) Equals(PixelFormat, PixelFormat)

判斷指定的 PixelFormat 執行個體是否視為相等。Determines whether the specified PixelFormat instances are considered equal.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

從這個像素格式的 Masks 值建立雜湊程式碼。Creates a hash code from this pixel format's Masks value.

ToString() ToString() ToString() ToString()

建立這個 PixelFormat 的字串表示。Creates a string representation of this PixelFormat.

運算子

Equality(PixelFormat, PixelFormat) Equality(PixelFormat, PixelFormat) Equality(PixelFormat, PixelFormat) Equality(PixelFormat, PixelFormat)

比較兩個 PixelFormat 執行個體是否相等。Compares two PixelFormat instances for equality.

Inequality(PixelFormat, PixelFormat) Inequality(PixelFormat, PixelFormat) Inequality(PixelFormat, PixelFormat) Inequality(PixelFormat, PixelFormat)

比較兩個 PixelFormat 執行個體是否不相等。Compares two PixelFormat instances for inequality.

適用於

另請參閱