Méthode IWICBitmapFrameEncode ::SetThumbnail (wincodec.h)
Définit la miniature du cadre si elle est prise en charge par le codec.
Syntaxe
HRESULT SetThumbnail(
[in] IWICBitmapSource *pIThumbnail
);
Paramètres
[in] pIThumbnail
Type : IWICBitmapSource*
Source bitmap à utiliser comme miniature.
Valeur retournée
Type : HRESULT
Retourne S_OK en cas de réussite, ou une valeur d’erreur dans le cas contraire.
Retourne WINCODEC_ERR_UNSUPPORTEDOPERATION si la fonctionnalité n’est pas prise en charge par l’encodeur.
Remarques
Nous vous recommandons d’appeler SetThumbnail avant d’appeler WritePixels ou WriteSource. La miniature n’est pas ajoutée au fichier encodé si SetThumbnail est appelé après un appel à WritePixels ou WriteSource.
- BMP, PNGLa définition de miniatures n’est pas prise en charge. Cette fonction retourne WINCODEC_ERR_UNSUPPORTEDOPERATION.
- JPEGLa définition de la miniature est prise en charge. L’image source est réencodée au format JPEG 8bpp ou 24bpp et est écrite dans le bloc de métadonnées APP1 du JPEG.
- TIFF La définition de la miniature est prise en charge. L’image source sera réencodée en tant que TIFF et écrite dans le bloc SubIFD de la trame.
- JPEG-XRLa définition de la miniature est prise en charge. L’image source est réencodée en tant que frame supplémentaire de 8 ou 24 bpp.
Configuration requise
| Condition requise | Valeur |
|---|---|
| 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