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