Metodo IWICBitmapFrameEncode::WriteSource (wincodec.h)

Codifica un'origine bitmap.

Sintassi

HRESULT WriteSource(
  [in] IWICBitmapSource *pIBitmapSource,
  [in] WICRect          *prc
);

Parametri

[in] pIBitmapSource

Tipo: IWICBitmapSource*

Origine bitmap da codificare.

[in] prc

Tipo: WICRect*

Rettangolo delle dimensioni dell'origine bitmap.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Se SetSize non viene chiamato prima di chiamare WriteSource, le dimensioni specificate in prc vengono usate se non NULL. In caso contrario, viene usata la dimensione di IWICBitmapSource specificata in pIBitmapSource .

Se SetPixelFormat non viene chiamato prima di chiamare WriteSource, viene usato il formato pixel di IWICBitmapSource specificato in pIBitmapSource .

Se SetResolution non viene chiamato prima di chiamare WriteSource, viene usato il formato pixel di pIBitmapSource .

Se SetPalette non viene chiamato prima di chiamare WriteSource, il formato pixel di destinazione viene indicizzato e il formato pixel di pIBitmapSource corrisponde al formato pixel del frame del codificatore, viene usato il formato pixel pIBitmapSource .

Quando si codifica un'immagine GIF, se la tavolozza globale è impostata e la tavolozza a livello di fotogramma non viene impostata direttamente dall'utente o da un codec GIF del fornitore di software indipendente (ISV), WriteSource userà la tavolozza globale per codificare il frame anche quando pIBitmapSource ha una tavolozza a livello di frame.

A partire da Windows Vista, è possibile effettuare chiamate WriteSource ripetute, purché l'altezza totale dei rect di origine accumulata sia la stessa impostata tramite SetSize.

A partire da Windows 8.1, il rect di origine deve essere almeno le dimensioni impostate tramite SetSize. Se la larghezza del rect di origine supera la larghezza setSize , i pixel aggiuntivi sul lato destro vengono ignorati. Se l'altezza del rect di origine supera l'altezza rimanente non riempita, le righe di analisi aggiuntive nella parte inferiore vengono ignorate.

Requisiti

Client minimo supportato	Windows XP con SP2, Windows Vista [app desktop | App UWP]
Server minimo supportato	Windows Server 2008 [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	wincodec.h
Libreria	Windowscodecs.lib
DLL	Windowscodecs.dll

Vedi anche

Informazioni concettuali

Come scrivere un codec WIC-Enabled

IWICBitmapFrameEncode

Panoramica del componente Windows Imaging