Méthode IWICBitmapFrameEncode::WriteSource (wincodec.h)
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