BitmapEncoder.SetPixelData 方法
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
设置帧上的像素数据。
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 之前，必须至少使用此方法设置像素数据。