Información general sobre la API 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.
  • Gran variedad de compatibilidad con el formato de píxeles.
  • Compatibilidad de alto color; incluye formatos de intervalo extendido de 30 bits, alta precisión de 30 bits y alta precisión de 48 bits y de gama ancha.
  • 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 y de 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 de 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 del proxy WIC.

Para usar WIC, las aplicaciones deben incluir wincodec. h y/o wincodecsdk. h, en función de la API que necesite la aplicación.

Archivos de biblioteca

Archivos de la biblioteca WIC:

Archivo Descripción
WindowsCodecs. lib Biblioteca de importación proporcionada por el kit de desarrollo de software (SDK) de Windows.
windowscodecs.dll Biblioteca de implementación de acciones proporcionada por el sistema operativo.

Para vincular a las API de WIC, la aplicación debe incluir windowscodec. lib como una dependencia del enlazador adicional.

Generadores de clases

En la tabla siguiente se describen los dos generadores de clases COM que las API de WIC proporcionan para crear componentes de WIC.

Interfaz de fábrica Descripción
IWICImagingFactory Generador de clases principal para el desarrollo de aplicaciones mediante componentes de WIC. Este generador crea componentes como descodificadores de imágenes, codificadores y secuencias.
IWICComponentFactory Generador de clases destinado a desarrolladores de componentes de WIC. Los componentes creados a partir de este generador se utilizan principalmente en el desarrollo de códecs y controladores de metadatos.

Para crear un generador de clases, utilice la función com CoCreateInstance . En el ejemplo siguiente se muestra la creación de la factoría de imágenes 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 de WIC comunes. Para obtener una lista completa de los componentes disponibles, consulte interfaces de WIC.

Tipo de componente Descripción
Bitmap Representa una representación en memoria grabable de un IWICBitmapSource.
Descodificador Se usa para descodificar los datos de imagen de una secuencia en un formato útil para el procesamiento de imágenes.
Codificador Escribe datos de imagen en una secuencia.
Stream Se usa para leer y escribir datos de un archivo, un recurso de red, un bloque de memoria, etc.
Convertidor de formato Se utiliza para convertir de un formato de píxel a otro.
Lector de consultas de metadatos Se usa para leer los metadatos de un marco de imagen o imagen.
Escritor de consultas de metadatos Se usa para escribir metadatos en un marco de imagen o imagen.

Consulte también

Referencias

Ejemplos y ejemplos de código