Panoramica dell'API WIC
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
- File di libreria
- Class Factory
- Componenti di creazione di immagini
- Vedere anche
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