Metodo IDWriteFontFace::GetRecommendedRenderingMode (dwrite.h)

Articolo
03/13/2024

Determina la modalità di rendering consigliata per il tipo di carattere usando i parametri di dimensione e rendering specificati.

Sintassi

HRESULT GetRecommendedRenderingMode(
        FLOAT                  emSize,
        FLOAT                  pixelsPerDip,
        DWRITE_MEASURING_MODE  measuringMode,
        IDWriteRenderingParams *renderingParams,
  [out] DWRITE_RENDERING_MODE  *renderingMode
);

Parametri

emSize

Tipo: FLOAT

Dimensioni logiche del tipo di carattere nelle unità DIP. Un DIP ("pixel indipendente dal dispositivo") è uguale a 1/96 pollici.

pixelsPerDip

Tipo: FLOAT

Numero di pixel fisici per DIP. Ad esempio, se la DPI della superficie di rendering è 96, questo valore è 1,0f. Se il valore DPI è 120, questo valore è 120,0f/96.

measuringMode

Tipo: DWRITE_MEASURING_MODE

Metodo di misurazione che verrà usato per glifi nel tipo di carattere. Le implementazioni del renderer possono scegliere diverse modalità di rendering per diversi metodi di misurazione, ad esempio:

DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL per DWRITE_MEASURING_MODE_NATURAL
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC per DWRITE_MEASURING_MODE_GDI_CLASSIC
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL per DWRITE_MEASURING_MODE_GDI_NATURAL

renderingParams

Tipo: IDWriteRenderingParams*

Puntatore a un oggetto che contiene impostazioni di rendering, ad esempio livello gamma, contrasto avanzato e livello ClearType. Questo parametro è necessario nel caso in cui l'oggetto parametri di rendering esegue l'override della modalità di rendering.

[out] renderingMode

Tipo: DWRITE_RENDERING_MODE*

Quando questo metodo restituisce, contiene un valore che indica la modalità di rendering consigliata da usare.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7, Windows Vista con SP2 e Aggiornamento della piattaforma per Windows Vista [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2, Windows Server 2008 con SP2 e Platform Update per Windows Server 2008 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dwrite.h
Libreria	Dwrite.lib
DLL	Dwrite.dll

Vedi anche

IDWriteFontFace

Condividi tramite