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