METODE IDWriteFontFace::GetRecommendedRenderingMode (dwrite.h)

Artikel
02/26/2024

Menentukan mode penyajian yang direkomendasikan untuk font, menggunakan ukuran dan parameter penyajian yang ditentukan.

Sintaks

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

Parameter

emSize

Jenis: FLOAT

Ukuran logis font dalam unit DIP. DIP ("piksel independen perangkat") sama dengan 1/96 inci.

pixelsPerDip

Jenis: FLOAT

Jumlah piksel fisik per DIP. Misalnya, jika DPI permukaan penyajian adalah 96, nilai ini adalah 1,0f. Jika DPI adalah 120, nilai ini adalah 120,0f/96.

measuringMode

Jenis: DWRITE_MEASURING_MODE

Metode ukur yang akan digunakan untuk glyph dalam font. Implementasi perender dapat memilih mode penyajian yang berbeda untuk metode pengukur yang berbeda, misalnya:

DWRITE_RENDERING_MODE_CLEARTYPE_NATURAL untuk DWRITE_MEASURING_MODE_NATURAL
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_CLASSIC untuk DWRITE_MEASURING_MODE_GDI_CLASSIC
DWRITE_RENDERING_MODE_CLEARTYPE_GDI_NATURAL untuk DWRITE_MEASURING_MODE_GDI_NATURAL

renderingParams

Jenis: IDWriteRenderingParams*

Penunjuk ke objek yang berisi pengaturan penyajian seperti tingkat gamma, kontras yang ditingkatkan, dan tingkat ClearType. Parameter ini diperlukan jika objek parameter penyajian mengambil alih mode penyajian.

[out] renderingMode

Jenis: DWRITE_RENDERING_MODE*

Ketika metode ini kembali, berisi nilai yang menunjukkan mode penyajian yang direkomendasikan untuk digunakan.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista dengan SP2 dan Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2, Windows Server 2008 dengan SP2 dan Pembaruan Platform untuk Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	dwrite.h
Pustaka	Dwrite.lib
DLL	Dwrite.dll

Lihat juga

IDWriteFontFace

Bagikan melalui