Condividi tramite


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

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