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.

Weitere Informationen

Referenzen

Beispiele und Code Beispiele