Método IDWriteFontFace1::GetRecommendedRenderingMode (dwrite_1.h)
Determina el modo de representación recomendado para la fuente, utilizando los parámetros de representación y tamaño especificados.
Sintaxis
HRESULT GetRecommendedRenderingMode(
FLOAT fontEmSize,
FLOAT dpiX,
FLOAT dpiY,
[in, optional] DWRITE_MATRIX const *transform,
BOOL isSideways,
DWRITE_OUTLINE_THRESHOLD outlineThreshold,
DWRITE_MEASURING_MODE measuringMode,
[out] DWRITE_RENDERING_MODE *renderingMode
);
Parámetros
fontEmSize
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.
dpiX
Tipo: FLOAT
Número de píxeles físicos por DIP en una posición horizontal. 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.
dpiY
Tipo: FLOAT
Número de píxeles físicos por DIP en una posición vertical. 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.
[in, optional] transform
Tipo: const DWRITE_MATRIX*
Especifica la transformación del mundo.
isSideways
Tipo: BOOL
Si los glifos de la carrera están lateralmente o no.
outlineThreshold
Tipo: DWRITE_OUTLINE_THRESHOLD
Un valor de tipo DWRITE_OUTLINE_THRESHOLD que especifica la calidad de la representación de esquemas del sistema de gráficos, afecta al umbral de tamaño por encima del cual se usa la representación de esquema.
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
[out] renderingMode
Tipo: DWRITE_RENDERING_MODE*
Cuando este método devuelve , 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.
Comentarios
Este método se debe usar para determinar el modo de representación real en los casos en los que el modo de representación del objeto de representación se DWRITE_RENDERING_MODE_DEFAULT.
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_1.h |
Library | Dwrite_1.lib |
Archivo DLL | Dwrite_1.dll |