Método ID2D1DeviceContext2::CreateImageSourceFromWic(IWICBitmapSource*,D2D1_IMAGE_SOURCE_LOADING_OPTIONS,D2D1_ALPHA_MODE,ID2D1ImageSourceFromWic**) (d2d1_3.h)

Crea un objeto de origen de imagen a partir de un origen de mapa de bits WIC, mientras rellena toda la memoria de píxeles dentro del origen de la imagen.
La imagen se carga y almacena mientras se usa una cantidad mínima de memoria.

Sintaxis

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

Parámetros

[in] wicBitmapSource

Tipo: IWICBitmapSource*

Origen del mapa de bits de WIC desde el que se va a crear el origen de la imagen.

loadingOptions

Tipo: D2D1_IMAGE_SOURCE_LOADING_OPTIONS

Opciones para crear el origen de la imagen. Las opciones predeterminadas se usan si NULL.

alphaMode

Tipo: D2D1_ALPHA_MODE

Modo alfa de la imagen; esto se determina automáticamente a partir del formato de píxel del origen si se pasa D2D1_ALPHA_MODE_UNKNOWN.

[out] imageSource

Tipo: ID2D1ImageSourceFromWic**

Recibe la nueva instancia de origen de imagen.

Valor devuelto

Tipo: HRESULT

S_OK si se ejecuta correctamente; de lo contrario, un valor HRESULT de error.

Comentarios

Este método crea un origen de imagen que se puede usar para dibujar la imagen.

Este método admite imágenes que superan el tamaño máximo de textura. Las imágenes grandes se almacenan internamente dentro de una caché dispersa de iconos.

Esta API admite el mismo conjunto de formatos de píxeles y modos alfa admitidos por CreateBitmapFromWicBitmap.
Si la GPU no admite un formato de píxel determinado, este método devolverá D2DERR_UNSUPPORTED_PIXEL_FORMAT. Este método no aplica ajustes como gamma o alfa premultiplicación que afectan a la apariencia de la imagen.

El parámetro alphaMode no debe establecerse en D2D1_ALPHA_MODE_STRAIGHT. Este método produce un error si el origen WIC usa un formato de píxel con alfa recto, a menos que el modo alfa se invalide estableciendo el parámetro alphaMode en D2D1_ALPHA_MODE_PREMULTIPLIED o D2D1_ALPHA_MODE_IGNORE.

Si el formato del origen tiene un canal alfa, se debe pasar D2D1_ALPHA_MODE_IGNORE.
Si se pasa D2D1_ALPHA_MODE_IGNORE y el formato del origen tiene un canal alfa, se omitirá el canal alfa.

Este método selecciona automáticamente un formato de almacenamiento adecuado para minimizar el uso de memoria de GPU, como el uso de texturas de luminancia y cromoinancia independientes para imágenes JPEG.

Si el argumento loadingOptions es NULL, D2D usa D2D1_IMAGE_SOURCE_LOADING_OPTIONS_NONE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2016 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	d2d1_3.h
Archivo DLL	D2d1.dll

Consulte también

ID2D1DeviceContext2