IDWriteFactory3::CreateCustomRenderingParams 方法 (dwrite_3.h)

创建具有指定属性的呈现参数对象。

语法

HRESULT CreateCustomRenderingParams(
        FLOAT                   gamma,
        FLOAT                   enhancedContrast,
        FLOAT                   grayscaleEnhancedContrast,
        FLOAT                   clearTypeLevel,
        DWRITE_PIXEL_GEOMETRY   pixelGeometry,
        DWRITE_RENDERING_MODE1  renderingMode,
        DWRITE_GRID_FIT_MODE    gridFitMode,
  [out] IDWriteRenderingParams3 **renderingParams
);

参数

gamma

类型: FLOAT

用于伽玛修正的伽玛值,该值必须大于零,且不能超过 256。

enhancedContrast

类型: FLOAT

对比度增强量,零或更大。

grayscaleEnhancedContrast

类型: FLOAT

用于灰度抗锯齿的对比度增强量,零或更大。

clearTypeLevel

类型: FLOAT

ClearType 级别,从 0.0f (没有 ClearType) 到 1.0f, (完整的 ClearType) 。

pixelGeometry

类型: DWRITE_PIXEL_GEOMETRY

一个DWRITE_PIXEL_GEOMETRY类型的值,指定设备像素 (的内部结构,即为呈现文本而假定的红色、绿色和蓝色分量) 的物理排列。

renderingMode

类型: DWRITE_RENDERING_MODE1

一个DWRITE_RENDERING_MODE1类型的值,指定方法 (例如,用于呈现字形的 ClearType 自然质量) 。 在大多数情况下,请指定 DWRITE_RENDERING_MODE1_DEFAULT 以自动使用适当的模式。

gridFitMode

类型: DWRITE_GRID_FIT_MODE

一个DWRITE_GRID_FIT_MODE类型的值,该值指定如何调整网格字形轮廓。 在大多数情况下,请指定 DWRITE_GRID_FIT_DEFAULT 以自动选择适当的模式。

[out] renderingParams

类型: IDWriteRenderingParams3**

指向内存块的指针,该内存块接收指向新创建的呈现参数对象的 IDWriteRenderingParams3 接口的指针;如果发生故障,则为 NULL

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

要求

要求
最低受支持的客户端 Windows 10 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 dwrite_3.h
Library Dwrite.lib
DLL Dwrite.dll

另请参阅

IDWriteFactory3