(dcommon.h) D2D1_PIXEL_FORMAT 结构

包含位图或呈现目标的数据格式和 alpha 模式。

语法

typedef struct D2D1_PIXEL_FORMAT {
  DXGI_FORMAT     format;
  D2D1_ALPHA_MODE alphaMode;
} D2D1_PIXEL_FORMAT;

成员

format

类型： DXGI_FORMAT

一个 值，该值指定每个像素中通道的大小和排列方式。

alphaMode

类型： D2D1_ALPHA_MODE

一个 值，该值指定 alpha 通道是否使用预乘 alpha、直 alpha、是否应忽略并视为不透明，或者是否未知。

注解

有关每个呈现目标支持的像素格式和 alpha 模式的详细信息，请参阅 支持的像素格式和 Alpha 模式。

示例

以下示例创建 一个 D2D1_PIXEL_FORMAT 结构，并使用它来指定 ID2D1HwndRenderTarget 的像素格式和 alpha 模式。

RECT rc;
GetClientRect(m_hwnd, &rc);

D2D1_SIZE_U size = D2D1::SizeU(
    rc.right - rc.left,
    rc.bottom - rc.top
    );

// Create a pixel format and initial its format
// and alphaMode fields.
D2D1_PIXEL_FORMAT pixelFormat = D2D1::PixelFormat(
    DXGI_FORMAT_B8G8R8A8_UNORM,
    D2D1_ALPHA_MODE_IGNORE
    );

D2D1_RENDER_TARGET_PROPERTIES props = D2D1::RenderTargetProperties();
props.pixelFormat = pixelFormat;

// Create a Direct2D render target.
hr = m_pD2DFactory->CreateHwndRenderTarget(
    props,
    D2D1::HwndRenderTargetProperties(m_hwnd, size),
    &m_pRT
    );

要求

要求	值
最低受支持的客户端	Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
标头	dcommon.h (包括 D2d1.h)

另请参阅

D2D1：:P ixelFormat

ID2D1RenderTarget

支持的像素格式和 Alpha 模式