ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,ID2D1ImageSourceFromWic**)-Methode (d2d1_3.h)
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 eine minimale Menge an Arbeitsspeicher verwendet wird.
Syntax
HRESULT CreateImageSourceFromWic(
[in] IWICBitmapSource *wicBitmapSource,
D2D1_IMAGE_SOURCE_LOADING_OPTIONS loadingOptions,
[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 ist.
[out] imageSource
Typ: ID2D1ImageSourceFromWic**
Empfängt die neue Imagequelle instance.
Rückgabewert
Typ: HRESULT
S_OK, wenn erfolgreich, andernfalls ein HRESULT-Fehler.
Hinweise
Mit dieser Methode wird eine Bildquelle erstellt, 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 Sparsekachelcache gespeichert.
Diese API unterstützt die gleichen Pixelformate und Alphamodi, die von CreateBitmapFromWicBitmap unterstützt werden.
Wenn die GPU kein bestimmtes Pixelformat 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.
Diese Methode wählt automatisch ein geeignetes Speicherformat aus, um die GPU-Speicherauslastung zu minimieren, z. B. die Verwendung separater Luminanz- 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 |