BitmapEncoder.SetPixelData 方法

定义

命名空间:

Windows.Graphics.Imaging

设置帧上的像素数据。

public:
 virtual void SetPixelData(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, unsigned int width, unsigned int height, double dpiX, double dpiY, Platform::Array <byte> ^ pixels) = SetPixelData;

void SetPixelData(BitmapPixelFormat const& pixelFormat, BitmapAlphaMode const& alphaMode, uint32_t const& width, uint32_t const& height, double const& dpiX, double const& dpiY, winrt::array_view <byte> const& pixels);

public void SetPixelData(BitmapPixelFormat pixelFormat, BitmapAlphaMode alphaMode, uint width, uint height, double dpiX, double dpiY, byte[] pixels);

function setPixelData(pixelFormat, alphaMode, width, height, dpiX, dpiY, pixels)

Public Sub SetPixelData (pixelFormat As BitmapPixelFormat, alphaMode As BitmapAlphaMode, width As UInteger, height As UInteger, dpiX As Double, dpiY As Double, pixels As Byte())

参数

pixelFormat

BitmapPixelFormat

像素数据的像素格式。

alphaMode

BitmapAlphaMode

像素数据的 alpha 模式。

width

UInt32

unsigned int

uint32_t

像素数据的宽度（以像素为单位）。

height

UInt32

unsigned int

uint32_t

像素数据的高度（以像素为单位）。

dpiX

Double

double

像素数据的水平分辨率（以每英寸点为单位）。

dpiY

Double

double

像素数据的垂直分辨率（以点/英寸为单位）。

pixels

Byte[]

byte[]

像素数据。

注解

此方法是同步的，因为直到调用 FlushAsync、 GoToNextFrameAsync 或 GoToNextFrameAsync (IIterable (IKeyValuePair) ) 之后才会提交数据。

将像素格式设置为 “未知 ”将导致失败。

此方法将所有像素数据视为在 sRGB 颜色空间中。 调用此方法时，它会自动清除帧中的任何现有颜色空间信息，包括嵌入的颜色配置文件。

对新图像进行编码时，在调用 FlushAsync 之前，必须至少使用此方法设置像素数据。