Metodo ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,ID2D1ImageSourceFromWic**) (d2d1_3.h)

Articolo
02/26/2024

Crea un oggetto origine immagine da un'origine bitmap WIC, popolando tutta la memoria pixel all'interno dell'origine dell'immagine.
L'immagine viene caricata e archiviata durante l'uso di una quantità minima di memoria.

Sintassi

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

Parametri

[in] wicBitmapSource

Tipo: IWICBitmapSource*

Origine bitmap WIC da cui creare l'origine dell'immagine.

loadingOptions

Tipo: D2D1_IMAGE_SOURCE_LOADING_OPTIONS

Opzioni per la creazione dell'origine immagine. Le opzioni predefinite vengono usate se NULL.

[out] imageSource

Tipo: ID2D1ImageSourceFromWic**

Riceve la nuova istanza di origine dell'immagine.

Valore restituito

Tipo: HRESULT

S_OK in caso di esito positivo; in caso contrario, HRESULT non riuscito.

Commenti

Questo metodo crea un'origine immagine che può essere usata per disegnare l'immagine.

Questo metodo supporta immagini che superano le dimensioni massime della trama. Le immagini di grandi dimensioni vengono archiviate internamente all'interno di una cache di riquadri sparse.

Questa API supporta lo stesso set di formati pixel e le modalità alfa supportate da CreateBitmapFromWicBitmap.
Se la GPU non supporta un formato pixel specifico, questo metodo restituirà D2DERR_UNSUPPORTED_PIXEL_FORMAT. Questo metodo non applica regolazioni, ad esempio la premoltiplicazione gamma o alfa, che influiscono sull'aspetto dell'immagine.

Questo metodo seleziona automaticamente un formato di archiviazione appropriato per ridurre al minimo l'utilizzo della memoria GPU, ad esempio usando la dominanza separata e le trame di dominanza per le immagini JPEG.

Se l'argomento loadingOptions è NULL, D2D usa D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 10 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2016 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	d2d1_3.h
DLL	D2d1.dll

Vedi anche

ID2D1DeviceContext2

Condividi tramite