IDWriteFactory3::CreateCustomRenderingParams-Methode (dwrite_3.h)

Erstellt ein Renderingparameterobjekt mit den angegebenen Eigenschaften.

Syntax

HRESULT CreateCustomRenderingParams(
        FLOAT                   gamma,
        FLOAT                   enhancedContrast,
        FLOAT                   grayscaleEnhancedContrast,
        FLOAT                   clearTypeLevel,
        DWRITE_PIXEL_GEOMETRY   pixelGeometry,
        DWRITE_RENDERING_MODE1  renderingMode,
        DWRITE_GRID_FIT_MODE    gridFitMode,
  [out] IDWriteRenderingParams3 **renderingParams
);

Parameter

gamma

Typ: FLOAT

Der für die Gammakorrektur verwendete Gammawert, der größer als 0 sein muss und 256 nicht überschreiten darf.

enhancedContrast

Typ: FLOAT

Die Menge der Kontrastverbesserung, null oder höher.

grayscaleEnhancedContrast

Typ: FLOAT

Die Menge der Kontrastverbesserung, die für die Graustufen-Antialiasing verwendet werden soll, 0 oder höher.

clearTypeLevel

Typ: FLOAT

Der Grad der ClearType-Ebene, von 0.0f (kein ClearType) bis 1,0f (vollständiger ClearType).

pixelGeometry

Typ: DWRITE_PIXEL_GEOMETRY

Ein DWRITE_PIXEL_GEOMETRY typisierter Wert, der die interne Struktur eines Gerätepixels angibt (d. h. die physische Anordnung roter, grüner und blauer Farbkomponenten), die zum Rendern von Text angenommen wird.

renderingMode

Typ: DWRITE_RENDERING_MODE1

Ein DWRITE_RENDERING_MODE1 typisierter Wert, der die Methode (z. B. clearType natural quality) zum Rendern von Glyphen angibt. Geben Sie in den meisten Fällen DWRITE_RENDERING_MODE1_DEFAULT an, um automatisch einen geeigneten Modus zu verwenden.

gridFitMode

Typ: DWRITE_GRID_FIT_MODE

Ein DWRITE_GRID_FIT_MODE typisierter Wert, der angibt, wie Glyphenumrisse ins Raster passen. Geben Sie in den meisten Fällen DWRITE_GRID_FIT_DEFAULT an, um automatisch einen geeigneten Modus auszuwählen.

[out] renderingParams

Typ: IDWriteRenderingParams3**

Ein Zeiger auf einen Speicherblock, der einen Zeiger auf eine IDWriteRenderingParams3-Schnittstelle für das neu erstellte Renderingparameterobjekt empfängt, oder NULL im Falle eines Fehlers.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2016 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dwrite_3.h
Bibliothek	Dwrite.lib
DLL	Dwrite.dll

Weitere Informationen

IDWriteFactory3