PixelFormat 结构

定义

为图像和基于像素的图面定义像素格式。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))]
public struct 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)
继承
PixelFormat
属性
实现

示例

下面的示例演示如何创建 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
End Namespace 'ImagingSnippetGallery

注解

XAML 特性用法XAML Attribute Usage

<object property="pixelFormat"/>  

XAML 值XAML Values

pixelFormatpixelFormat
PixelFormats 类定义的预定义像素格式之一。One of the predefined pixel formats defined by the PixelFormats class.

属性

BitsPerPixel

获取此 PixelFormat 的每像素位数 (bpp)。Gets the number of bits-per-pixel (bpp) for this PixelFormat.

Masks

获取与 PixelFormat 关联的位掩码的集合。Gets a collection of bit masks associated with the PixelFormat.

方法

Equals(Object)

确定指定对象是否等于当前对象。Determines whether the specified object is equal to the current object.

Equals(PixelFormat)

确定像素格式是否与给定的 PixelFormat 相等。Determines whether the pixel format equals the given PixelFormat.

Equals(PixelFormat, PixelFormat)

确定指定的 PixelFormat 实例是否可视为相等的实例。Determines whether the specified PixelFormat instances are considered equal.

GetHashCode()

根据此像素格式的 Masks 值创建哈希代码。Creates a hash code from this pixel format's Masks value.

ToString()

创建此 PixelFormat 的字符串表示形式。Creates a string representation of this PixelFormat.

运算符

Equality(PixelFormat, PixelFormat)

比较两个 PixelFormat 实例是否相等。Compares two PixelFormat instances for equality.

Inequality(PixelFormat, PixelFormat)

比较两个 PixelFormat 实例是否不相等。Compares two PixelFormat instances for inequality.

适用于

另请参阅