Condividi tramite


Metodo IDWriteFontFace1::GetRecommendedRenderingMode (dwrite_1.h)

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

Sintassi

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
);

Parametri

fontEmSize

Tipo: FLOAT

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

dpiX

Tipo: FLOAT

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

dpiY

Tipo: FLOAT

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

[in, optional] transform

Tipo: const DWRITE_MATRIX*

Specifica la trasformazione mondiale.

isSideways

Tipo: BOOL

Indipendentemente dal fatto che i glifi nella corsa siano affiancati o meno.

outlineThreshold

Tipo: DWRITE_OUTLINE_THRESHOLD

Valore DWRITE_OUTLINE_THRESHOLD tipizzato che specifica la qualità del rendering della struttura del sistema grafico, influisce sulla soglia di dimensione superiore alla quale viene usato il rendering della struttura.

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:

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

Commenti

Questo metodo deve essere usato per determinare la modalità di rendering effettiva nei casi in cui la modalità di rendering dell'oggetto params di rendering è DWRITE_RENDERING_MODE_DEFAULT.

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_1.h
Libreria Dwrite_1.lib
DLL Dwrite_1.dll

Vedi anche

IDWriteFontFace1