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

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

Sintassi

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

Parametri

[in] wicBitmapSource

Tipo: IWICBitmapSource*

Origine bitmap WIC da cui creare l'origine immagine.

loadingOptions

Tipo: D2D1_IMAGE_SOURCE_LOADING_OPTIONS

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

alphaMode

Tipo: D2D1_ALPHA_MODE

Modalità alfa dell'immagine; ciò viene determinato automaticamente dal formato pixel dell'origine se D2D1_ALPHA_MODE_UNKNOWN viene passato.

[out] imageSource

Tipo: ID2D1ImageSourceFromWic**

Riceve la nuova istanza dell'origine immagine.

Valore restituito

Tipo: HRESULT

S_OK se ha esito positivo, in caso contrario, un errore HRESULT.

Commenti

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

Questo metodo supporta le 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 modalità alfa supportate da CreateBitmapFromWicBitmap.
Se la GPU non supporta un determinato formato pixel, questo metodo restituirà D2DERR_UNSUPPORTED_PIXEL_FORMAT. Questo metodo non applica modifiche, ad esempio gamma o premultiplicazione alfa, che influiscono sull'aspetto dell'immagine.

Il parametro alphaMode non deve essere impostato su D2D1_ALPHA_MODE_STRAIGHT. Questo metodo ha esito negativo se l'origine WIC usa un formato pixel con alfa dritto, a meno che la modalità alfa non venga sostituita impostando il parametro alfaMode su D2D1_ALPHA_MODE_PREMULTIPLIED o D2D1_ALPHA_MODE_IGNORE.

Se il formato dell'origine ha un canale alfa, D2D1_ALPHA_MODE_IGNORE deve essere passato.
Se D2D1_ALPHA_MODE_IGNORE viene passato e il formato dell'origine ha un canale alfa, il canale alfa verrà ignorato.

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

Se l'argomento loadOptions è 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