Compartir a través de

Método IDWriteFontFace3::GetRecommendedRenderingMode (dwrite_3.h)

  • Artículo

Determina la representación de texto recomendada y el modo de ajuste de cuadrícula que se usará en función de la fuente, el tamaño, la transformación del mundo y el modo de medición.

Sintaxis

HRESULT GetRecommendedRenderingMode(
  [in]           FLOAT                    fontEmSize,
  [in]           FLOAT                    dpiX,
  [in]           FLOAT                    dpiY,
  [in, optional] DWRITE_MATRIX const      *transform,
  [in]           BOOL                     isSideways,
  [in]           DWRITE_OUTLINE_THRESHOLD outlineThreshold,
  [in]           DWRITE_MEASURING_MODE    measuringMode,
  [in, optional] IDWriteRenderingParams   *renderingParams,
  [out]          DWRITE_RENDERING_MODE1   *renderingMode,
  [out]          DWRITE_GRID_FIT_MODE     *gridFitMode
);

Parámetros

[in] fontEmSize

Tipo: FLOAT

Tamaño de fuente lógico en DIP.

[in] dpiX

Tipo: FLOAT

Número de píxeles por pulgada lógica en la dirección horizontal.

[in] dpiY

Tipo: FLOAT

Número de píxeles por pulgada lógica en la dirección vertical.

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Estructura DWRITE_MATRIX que describe la transformación del mundo.

[in] isSideways

Tipo: BOOL

Especifica si la fuente está lateralmente. TRUE si la fuente está lateralmente; de lo contrario, FALSE.

[in] 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.

[in] measuringMode

Tipo: DWRITE_MEASURING_MODE

Valor DWRITE_MEASURING_MODE con tipo que especifica el método utilizado para medir durante el diseño de texto. Para el espaciado de glifo adecuado, este método devuelve un modo de representación que es compatible con el modo de medición especificado.

[in, optional] renderingParams

Tipo: IDWriteRenderingParams*

Puntero a una interfaz IDWriteRenderingParams para el objeto de parámetros de representación. 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_MODE1*

Puntero a una variable que recibe un valor de tipo DWRITE_RENDERING_MODE1 para el modo de representación recomendado.

[out] gridFitMode

Tipo: DWRITE_GRID_FIT_MODE*

Puntero a una variable que recibe un valor de tipo DWRITE_GRID_FIT_MODE para el modo de ajuste de cuadrícula recomendado.

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

   
Cliente mínimo compatible Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dwrite_3.h
Library Dwrite.lib
Archivo DLL Dwrite.dll

Consulte también

IDWriteFontFace3