Delen via

Overzicht van WIC-API

  • Artikel

Het Windows Imaging Component (WIC) biedt een COM-API (Component Object Model) voor gebruik in C en C++. De WIC-API biedt verschillende functionaliteit voor afbeeldingen, waaronder:

  • Ingebouwde codecs voor de standaardformaten van webafbeeldingen.
  • Ingebouwde ondersteuning voor standaardmetagegevensindelingen.
  • Breed scala aan ondersteuning voor pixelformaten.
  • Ondersteuning voor hoge kleuren; inclusief 30-bits uitgebreid bereik, 30-bits hoge precisie en 48-bits hoge precisie en brede kleurruimte pixelindelingen.
  • Uitbreidbaar framework voor afbeeldingscodecs, pixelindelingen en metagegevensindelingen.

Dit onderwerp bevat de volgende onderwerpen.

WIC-header bestanden

De WIC-API's worden gedefinieerd in de volgende header- en Interface Definition Language-bestanden (IDL):

Bestand Beschrijving
wincodec.h Definieert C- en C++-versies van de primaire WIC-API's.
wincodec.idl Definieert de primaire WIC-interfaces.
wincodecsdk.h Definieert C- en C++-versies van de WIC-API's voor metagegevens.
wincodecsdk.idl Definieert de WIC-metagegevensinterfaces.
wincodec_proxy.h Definieert de WIC-proxy-exports.

 

Als u WIC wilt gebruiken, moeten uw toepassingen wincodec.h en/of wincodecsdk.h bevatten, afhankelijk van de API die uw toepassing nodig heeft.

Bibliotheekbestanden

De WIC-bibliotheekbestanden:

Bestand Beschrijving
windowscodecs.lib Importeerbibliotheek geleverd door de Windows Software Development Kit (SDK).
windowscodecs.dll Bibliotheek voor stock-implementatie die wordt geleverd door het besturingssysteem.

 

Als u een koppeling wilt maken naar WIC-API's, moet uw toepassing windowscodec.lib opnemen als een extra afhankelijkheid voor koppelingen.

Klassefabrieken

In de volgende tabel worden de twee COM-klassefabrieken beschreven die de WIC-API's bieden voor het maken van WIC-onderdelen.

Fabriekinterface Beschrijving
IWICImagingFactory- Primaire klassefabriek voor de ontwikkeling van toepassingen gebruik makend van WIC-onderdelen. Deze fabriek maakt onderdelen zoals decoders, coderingsprogramma's en streams voor afbeeldingen.
IWICComponentFactory Class Factory gericht op ONTWIKKELAARS van WIC-onderdelen. Onderdelen die zijn gemaakt op basis van deze factory, worden voornamelijk gebruikt in codec- en metagegevenshandlerontwikkeling.

 

Als u een van beide klassenfactory's wilt maken, gebruikt u de functie CoCreateInstance COM. In het volgende voorbeeld ziet u hoe de WIC Imaging Factory wordt gemaakt.

// 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)
);

Beeldcomponenten

De WIC-API's bieden verschillende typen imaging-onderdelen. In de volgende tabel worden enkele van de algemene WIC-onderdelen beschreven. Zie WIC-interfacesvoor een volledige lijst met beschikbare onderdelen.

Onderdeeltype Beschrijving
Bitmap Vertegenwoordigt een beschrijfbare in-memory weergave van een IWICBitmapSource.
Decoder Wordt gebruikt om afbeeldingsgegevens van een stroom te decoderen in een indeling die nuttig is voor de verwerking van afbeeldingen.
Encoder Schrijft afbeeldingsgegevens naar een stream.
Stream Wordt gebruikt voor het lezen en schrijven van gegevens uit een bestand, netwerkresource, een blok geheugen, enzovoort.
Format Converter Wordt gebruikt om van de ene pixelindeling naar de andere te converteren.
Metagegevensquerylezer Wordt gebruikt voor het lezen van metagegevens van een afbeelding of afbeeldingskader.
Schrijver voor metagegevensquery's Wordt gebruikt om metagegevens naar een afbeelding of afbeeldingsframe te schrijven.

 

Zie ook

Verwijzingen

voorbeelden en codevoorbeelden