Condividi tramite

Panoramica dell'API WIC

  • Articolo

Windows Imaging Component (WIC) fornisce un'API basata su Component Object Model (COM) per l'uso in C e C++. L'API WIC espone un'ampia gamma di funzionalità correlate all'immagine, tra cui:

  • Codec predefiniti per i formati di immagine Web standard.
  • Supporto predefinito per i formati di metadati standard.
  • Ampia gamma di supporto del formato pixel.
  • Supporto ad alto colore; incluso l'intervallo esteso a 30 bit, la precisione elevata a 30 bit e i formati di pixel a 48 bit.
  • Framework estendibile per codec immagine, formati pixel e formati di metadati.

Questo argomento contiene gli argomenti seguenti.

File di intestazione WIC

Le API WIC sono definite nei file 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 di metadati WIC.
wincodec_proxy.h Definisce le esportazioni del proxy WIC.

 

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 collegare le API WIC, l'applicazione deve includere windowscodec.lib come dipendenza del linker aggiuntivo.

Class Factory

Nella tabella seguente vengono descritte le due class factory COM fornite dalle API WIC per la creazione di componenti WIC.

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

 

Per creare una classe factory, usare la funzione COM CoCreateInstance . 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 di creazione di immagini

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 in memoria scrivibile di un oggetto IWICBitmapSource.
Decoder 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 in un flusso.
Stream Usato per leggere e scrivere dati da un file, una risorsa di rete, un blocco di memoria e così via.
Convertitore di formati Usato per convertire 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.
Writer di query dei metadati Usato per scrivere metadati in un'immagine o in un frame di immagine.

 

Vedere anche

Riferimenti

Esempi e esempi di codice