Introducción a la API de WIC
El componente de creación de imágenes de Windows (WIC) proporciona una API basada en el modelo de objetos componentes (COM) para su uso en C y C++. La API de WIC expone una variedad de funcionalidades relacionadas con la imagen, entre las que se incluyen:
- Códecs integrados para los formatos de imagen web estándar.
- Compatibilidad integrada con formatos de metadatos estándar.
- Amplia gama de compatibilidad con formato de píxeles.
- Compatibilidad con colores altos; incluyendo intervalo extendido de 30 bits, alta precisión de 30 bits y formatos de píxeles de gama ancha y de alta precisión de 48 bits.
- Marco extensible para códecs de imagen, formatos de píxeles y formatos de metadatos.
Este tema contiene los temas siguientes.
- Archivos de encabezado WIC
- Archivos de biblioteca
- Generadores de clases
- Componentes de creación de imágenes
- Vea también
Archivos de encabezado WIC
Las API de WIC se definen en los siguientes archivos de encabezado e Lenguaje de definición de interfaz (IDL):
| Archivo | Descripción |
|---|---|
| wincodec.h | Define las versiones de C y C++ de las API de WIC principales. |
| wincodec.idl | Define las interfaces WIC principales. |
| wincodecsdk.h | Define las versiones de C y C++ de las API de WIC de metadatos. |
| wincodecsdk.idl | Define las interfaces de metadatos de WIC. |
| wincodec_proxy.h | Define las exportaciones de proxy WIC. |
Para usar WIC, las aplicaciones deben incluir wincodec.h o wincodecsdk.h, en función de la API que necesite la aplicación.
Archivos de biblioteca
Los archivos de la biblioteca WIC:
| Archivo | Descripción |
|---|---|
| windowscodecs.lib | Importar biblioteca proporcionada por el Kit de desarrollo de software (SDK) de Windows. |
| windowscodecs.dll | Biblioteca de implementación de stock proporcionada por el sistema operativo. |
Para vincular a las API de WIC, la aplicación debe incluir windowscodec.lib como una dependencia adicional del vinculador.
Generadores de clases
En la tabla siguiente se describen las dos factorías de clase COM que proporcionan las API de WIC para crear componentes WIC.
| Interfaz de fábrica | Descripción |
|---|---|
| IWICImagingFactory | Generador de clases principal para el desarrollo de aplicaciones mediante componentes WIC. Esta fábrica crea componentes como descodificadores de imágenes, codificadores y secuencias. |
| IWICComponentFactory | Generador de clases destinado a desarrolladores de componentes wic. Los componentes creados a partir de esta fábrica se usan principalmente en el desarrollo del controlador de metadatos y códecs. |
Para crear cualquier generador de clases, use la función COM CoCreateInstance . En el ejemplo siguiente se muestra la creación de la factoría de creación de imágenes de WIC.
// Initialize COM
CoInitialize(NULL);
// The factory pointer
IWICImagingFactory *pFactory = NULL;
// Create the COM imaging factory
HRESULT hr = CoCreateInstance(
CLSID_WICImagingFactory,
NULL,
CLSCTX_INPROC_SERVER,
IID_PPV_ARGS(&pFactory)
);
Componentes de creación de imágenes
Las API de WIC proporcionan varios tipos de componentes de creación de imágenes. En la tabla siguiente se describen algunos de los componentes comunes de WIC. Para obtener una lista completa de los componentes disponibles, consulte Interfaces WIC.
| Tipo de componente | Descripción |
|---|---|
| Bitmap | Representa una representación en memoria grabable de un IWICBitmapSource. |
| Decodificador | Se usa para descodificar los datos de imagen de una secuencia en un formato que resulta útil para el procesamiento de imágenes. |
| Codificador | Escribe datos de imagen en una secuencia. |
| Corriente | Se usa para leer y escribir datos de un archivo, un recurso de red, un bloque de memoria, etc. |
| Convertidor de formatos | Se usa para convertir de un formato de píxel a otro. |
| Lector de consultas de metadatos | Se usa para leer metadatos de una imagen o marco de imagen. |
| Escritor de consultas de metadatos | Se usa para escribir metadatos en una imagen o marco de imagen. |
Consulte también