ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,D2D1_ALPHA_MODE,ID2D1ImageSourceFromWic**)-Methode (d2d1_3.h)

  • Artikel

Erstellt ein Bildquellobjekt aus einer WIC-Bitmapquelle, während der gesamte Pixelspeicher innerhalb der Bildquelle aufgefüllt wird.
Das Bild wird geladen und gespeichert, während nur wenig Arbeitsspeicher verwendet wird.

Syntax

HRESULT CreateImageSourceFromWic(
  [in]  IWICBitmapSource                  *wicBitmapSource,
        D2D1_IMAGE_SOURCE_LOADING_OPTIONS loadingOptions,
        D2D1_ALPHA_MODE                   alphaMode,
  [out] ID2D1ImageSourceFromWic           **imageSource
);

Parameter

[in] wicBitmapSource

Typ: IWICBitmapSource*

Die WIC-Bitmapquelle, aus der die Bildquelle erstellt werden soll.

loadingOptions

Typ: D2D1_IMAGE_SOURCE_LOADING_OPTIONS

Optionen zum Erstellen der Bildquelle. Standardoptionen werden verwendet, wenn NULL.

alphaMode

Typ: D2D1_ALPHA_MODE

Der Alphamodus des Bilds; dies wird automatisch aus dem Pixelformat der Quelle ermittelt, wenn D2D1_ALPHA_MODE_UNKNOWN übergeben wird.

[out] imageSource

Typ: ID2D1ImageSourceFromWic**

Empfängt die neue Bildquelle instance.

Rückgabewert

Typ: HRESULT

S_OK bei erfolgreicher Ausführung, andernfalls ein Fehler HRESULT.

Hinweise

Diese Methode erstellt eine Bildquelle, die zum Zeichnen des Bilds verwendet werden kann.

Diese Methode unterstützt Bilder, die die maximale Texturgröße überschreiten. Große Bilder werden intern in einem Sparse-Kachelcache gespeichert.

Diese API unterstützt dieselben Pixelformate und Alphamodi, die von CreateBitmapFromWicBitmap unterstützt werden.
Wenn die GPU ein bestimmtes Pixelformat nicht unterstützt, gibt diese Methode D2DERR_UNSUPPORTED_PIXEL_FORMAT zurück. Diese Methode wendet keine Anpassungen wie Gamma- oder Alpha-Prämultiplizierung an, die sich auf die Darstellung des Bilds auswirken.

Der alphaMode-Parameter darf nicht auf D2D1_ALPHA_MODE_STRAIGHT festgelegt werden. Diese Methode schlägt fehl, wenn die WIC-Quelle ein Pixelformat mit geradem Alpha verwendet, es sei denn, der Alphamodus wird überschrieben, indem der alphaMode-Parameter auf D2D1_ALPHA_MODE_PREMULTIPLIED oder D2D1_ALPHA_MODE_IGNORE festgelegt wird.

Wenn das Format der Quelle über einen Alphakanal verfügt, muss D2D1_ALPHA_MODE_IGNORE übergeben werden.
Wenn D2D1_ALPHA_MODE_IGNORE übergeben wird und das Format der Quelle über einen Alphakanal verfügt, wird der Alphakanal ignoriert.

Diese Methode wählt automatisch ein geeignetes Speicherformat aus, um die GPU-Speicherauslastung zu minimieren, z. B. die Verwendung separater Luminance- und Chrominanztexturen für JPEG-Bilder.

Wenn das argument loadingOptions NULL ist, verwendet D2D D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 10 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2016 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile d2d1_3.h
DLL D2d1.dll

Weitere Informationen

ID2D1DeviceContext2