Método IDWriteFontFace::GetRecommendedRenderingMode (dwrite.h)
Determina el modo de representación recomendado para la fuente, utilizando el tamaño y los parámetros de representación especificados.
Sintaxis
HRESULT GetRecommendedRenderingMode(
FLOAT emSize,
FLOAT pixelsPerDip,
DWRITE_MEASURING_MODE measuringMode,
IDWriteRenderingParams *renderingParams,
[out] DWRITE_RENDERING_MODE *renderingMode
);
Parámetros
emSize
Tipo: FLOAT
Tamaño lógico de la fuente en unidades DIP. Un DIP ("píxel independiente del dispositivo") es igual a 1/96 pulgadas.
pixelsPerDip
Tipo: FLOAT
Número de píxeles físicos por DIP. Por ejemplo, si el valor de PPP de la superficie de representación es 96, este valor es 1,0f. Si el valor de PPP es 120, este valor es 120.0f/96.
measuringMode
Tipo: DWRITE_MEASURING_MODE
Método de medición que se usará para glifos en la fuente. Las implementaciones del representador pueden elegir diferentes modos de representación para diferentes métodos de medición, por ejemplo:
- DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL para DWRITE_MEASURING_MODE_NATURAL
- DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC para DWRITE_MEASURING_MODE_GDI_CLASSIC
- DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL para DWRITE_MEASURING_MODE_GDI_NATURAL
renderingParams
Tipo: IDWriteRenderingParams*
Puntero a un objeto que contiene valores de representación como el nivel gamma, el contraste mejorado y el nivel ClearType. Este parámetro es necesario en caso de que el objeto de parámetros de representación invalide el modo de representación.
[out] renderingMode
Tipo: DWRITE_RENDERING_MODE*
Cuando este método vuelve, contiene un valor que indica el modo de representación recomendado que se va a usar.
Valor devuelto
Tipo: HRESULT
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 7, Windows Vista con SP2 y Platform Update para Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2008 R2, Windows Server 2008 con SP2 y Actualización de plataforma para Windows Server 2008 [aplicaciones de escritorio | Aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | dwrite.h |
Library | Dwrite.lib |
Archivo DLL | Dwrite.dll |