Introducción a la API de WIC

  • Artículo

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

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

Referencias

Ejemplos y ejemplos de código