Panoramica dell'API WIC

Windows Imaging Component (WIC) fornisce un'API basata su Component Object Model (COM) da usare in C e C++. L'API WIC espone un'ampia gamma di funzionalità correlate alle immagini, tra cui:

• Codec predefiniti per i formati di immagine Web standard.
• Supporto predefinito per i formati di metadati standard.
• Ampia gamma di supporto per il formato pixel.
• Supporto per colori ad alta fedeltà; inclusi l'intervallo esteso a 30 bit, la precisione elevata a 30 bit e i formati di pixel a 48 bit ad alta precisione e ampio gamut.
• Framework estensibile per codec immagine, formati di pixel e formati di metadati.

Questo argomento contiene gli argomenti seguenti.

• file di intestazione WIC
• file di libreria
• fabbriche di classi
• componenti per imaging
• vedere anche

File di intestazione WIC

Le API WIC sono definite nei file di intestazione e IDL (Interface Definition Language) seguenti:

File	Descrizione
wincodec.h	Definisce le versioni C e C++ delle API WIC primarie.
wincodec.idl	Definisce le interfacce WIC primarie.
wincodecsdk.h	Definisce le versioni C e C++ delle API WIC dei metadati.
wincodecsdk.idl	Definisce le interfacce dei metadati WIC.
wincodec_proxy.h	Definisce le esportazioni del WIC proxy.

 

Per usare WIC, le applicazioni devono includere wincodec.h e/o wincodecsdk.h, a seconda delle esigenze dell'API.

File di libreria

File di libreria WIC:

File	Descrizione
windowscodecs.lib	Libreria di importazione fornita da Windows Software Development Kit (SDK).
windowscodecs.dll	Libreria di implementazione stock fornita dal sistema operativo.

 

Per collegarsi alle API WIC, l'applicazione deve includere windowscodec.lib come dipendenza del linker aggiuntiva.

Classi Factory

La tabella seguente descrive le due class factory COM fornite dalle API WIC per la creazione di componenti WIC.

Interfaccia Fabbrica	Descrizione
IWICImagingFactory	Factory di classi primaria per lo sviluppo di applicazioni con componenti WIC. Questa factory crea componenti come decodificatori di immagini, codificatori e flussi.
IWICComponentFactory	Class factory destinata agli sviluppatori di componenti WIC. I componenti creati da questa factory vengono usati principalmente nello sviluppo di codec e gestori di metadati.

 

Per creare una delle classi factory, usare la funzione CoCreateInstance COM. Nell'esempio seguente viene illustrata la creazione della fabbrica di immagini 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)
);

Componenti per la creazione dell'immagine

Le API WIC forniscono diversi tipi di componenti di imaging. La tabella seguente descrive alcuni dei componenti wic comuni. Per un elenco completo dei componenti disponibili, vedere interfacce WIC.

Tipo di componente	Descrizione
bitmap	Rappresenta una rappresentazione scrivibile in memoria di un IWICBitmapSource.
Decodificatore	Usato per decodificare i dati dell'immagine da un flusso in un formato utile per l'elaborazione delle immagini.
encoder	Scrive i dati dell'immagine su un flusso.
Stream	Usato per leggere e scrivere dati da un file, una risorsa di rete, un blocco di memoria e così via.
Format Converter	Utilizzato per eseguire la conversione da un formato pixel a un altro.
Lettore di query sui metadati	Usato per leggere i metadati di un'immagine o di un frame di immagine.
scrittore di query di metadati	Usato per scrivere metadati in un'immagine o in un frame di immagine.

 

Vedere anche

riferimenti

esempi di codice ed esempi di codice