WIC-API-Übersicht
Die Windows Imaging Component (WIC) stellt eine Component Object Model (com)-basierte API für die Verwendung in C und C++ bereit. Die WIC-API bietet eine Vielzahl von Bild bezogenen Funktionen, einschließlich:
- Integrierte Codecs für die Standardweb Bildformate.
- Integrierte Unterstützung für standardmetadatenformate.
- Unterstützung für eine breite Palette an Pixel Formaten.
- Unterstützung für hohe Farben; Dazu zählen der erweiterte 30-Bit-Bereich, die 30-Bit-Genauigkeit mit hoher Genauigkeit und 48-Bit-Pixel Formate mit hoher Genauigkeit und Breite.
- Erweiterbares Framework für Bild Codecs, Pixel Formate und Metadatenformate.
Dieses Thema enthält die folgenden Themen:
WIC-Header Dateien
Die WIC-APIs werden in den folgenden Header-und IDL-Dateien (Interface Definition Language) definiert:
| Datei | BESCHREIBUNG |
|---|---|
| wincodec. h | Definiert die C-und C++-Versionen der primären WIC-APIs. |
| wincodec. idl | Definiert die primären WIC-Schnittstellen. |
| wincodecsdk. h | Definiert die C-und C++-Versionen der Metadaten-WIC-APIs. |
| wincodecsdk. idl | Definiert die WIC-Metadatenschnittstellen. |
| wincodec- _ Proxy. h | Definiert die WIC-Proxy Exporte. |
Um WIC verwenden zu können, müssen Ihre Anwendungen abhängig von der API, die Ihre Anwendung benötigt, wincodec. h und/oder wincodecsdk. h einschließen.
Bibliotheksdateien
Die WIC-Bibliotheksdateien:
| Datei | BESCHREIBUNG |
|---|---|
| windowscodebug. lib | Import Bibliothek, die vom Windows Software Development Kit (SDK) bereitgestellt wird. |
| windowscodecs.dll | Vom Betriebssystem bereitgestellte Bestands Implementierungs Bibliothek. |
Um einen Link zu WIC-APIs zu erhalten, muss Ihre Anwendung windowscodec. lib als zusätzliche Linker-Abhängigkeit einschließen.
Klassenfactory
In der folgenden Tabelle werden die beiden com-Klassenfactorys beschrieben, die die WIC-APIs zum Erstellen von WIC-
| Factory-Schnittstelle | BESCHREIBUNG |
|---|---|
| IWICImagingFactory | Primäre Klassenfactory für die Anwendungsentwicklung mit WIC-Komponenten. Diese Factory erstellt Komponenten, z. b. Image-Decoders, Encoder und Streams. |
| IWICComponentFactory | Klassenfactory, die für WIC-Komponenten Entwickler konzipiert ist. Komponenten, die aus dieser Factory erstellt werden, werden primär in der Codec-und metadatenhandlerentwicklung verwendet |
Verwenden Sie die cokreateinstance -com-Funktion, um entweder eine Klassenfactory zu erstellen. Im folgenden Beispiel wird die Erstellung der WIC Imaging Factory veranschaulicht.
// 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)
);
Bildverarbeitungskomponenten
Die WIC-APIs stellen verschiedene Arten von Abbild Erstellungs Komponenten bereit. In der folgenden Tabelle werden einige der gängigen WIC-Komponenten beschrieben. Eine vollständige Liste der verfügbaren Komponenten finden Sie unter WIC-Schnittstellen.
| Komponententyp | BESCHREIBUNG |
|---|---|
| Bitmap | Stellt eine beschreibbare Darstellung im Arbeitsspeicher einer IWICBitmapSourcedar. |
| Decoder | Wird zum Decodieren von Bilddaten aus einem Stream in ein Format verwendet, das für die Bildverarbeitung nützlich ist. |
| ASA | Schreibt Bilddaten in einen Stream. |
| Datenstrom | Wird verwendet, um Daten aus einer Datei, einer Netzwerkressource, einem Speicherblock usw. zu lesen und zu schreiben. |
| Format Konverter | Wird verwendet, um ein Pixel Format in ein anderes zu konvertieren. |
| Metadatenabfrage-Reader | Wird zum Lesen von Metadaten eines Bilds oder Bilds verwendet. |
| Metadatenabfrage-Writer | Wird verwendet, um Metadaten in einen Bild-oder Bild Rahmen zu schreiben. |