Méthode IWICBitmapFrameEncode::WriteSource (wincodec.h)

Article
08/27/2023

Encode une source bitmap.

Syntaxe

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

Paramètres

[in] pIBitmapSource

Type : IWICBitmapSource*

Source bitmap à encoder.

[in] prc

Type : WICRect*

Rectangle de taille de la source bitmap.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si SetSize n’est pas appelé avant l’appel de WriteSource, la taille indiquée dans prc est utilisée si elle n’est pas NULL. Sinon, la taille de IWICBitmapSource donnée dans pIBitmapSource est utilisée.

Si SetPixelFormat n’est pas appelé avant d’appeler WriteSource, le format de pixel de IWICBitmapSource indiqué dans pIBitmapSource est utilisé.

Si SetResolution n’est pas appelé avant d’appeler WriteSource, le format de pixel de pIBitmapSource est utilisé.

Si SetPalette n’est pas appelé avant d’appeler WriteSource, le format de pixel cible est indexé et le format de pixel de pIBitmapSource correspond au format de pixel du cadre de l’encodeur, le format de pixel pIBitmapSource est utilisé.

Lors de l’encodage d’une image GIF, si la palette globale est définie et que la palette au niveau de l’image n’est pas définie directement par l’utilisateur ou par un codec GIF ISV (éditeur de logiciels indépendant) personnalisé, WriteSource utilise la palette globale pour encoder l’image même lorsque pIBitmapSource a une palette de niveau frame.

À compter de Windows Vista, des appels WriteSource répétés peuvent être effectués tant que la hauteur totale de rect de la source cumulée est la même que celle définie via SetSize.

À compter de Windows 8.1, le rect source doit être au moins les dimensions définies via SetSize. Si la largeur rect source dépasse la largeur SetSize , les pixels supplémentaires sur le côté droit sont ignorés. Si la hauteur de rect source dépasse la hauteur restante non remplie, les lignes de balayage supplémentaires situées en bas sont ignorées.

Configuration requise


Client minimal pris en charge	Windows XP avec SP2, Windows Vista [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	wincodec.h
Bibliothèque	Windowscodecs.lib
DLL	Windowscodecs.dll

Voir aussi

Conceptuel

Comment écrire un codec WIC-Enabled

IWICBitmapFrameEncode

Vue d’ensemble du composant d’acquisition d’images Windows

Partager via