Méthode ITranscodeImage::TranscodeImage (imagetranscode.h)

Article
08/24/2023

Convertit une image au format JPEG ou bitmap (BMP).

Syntaxe

HRESULT TranscodeImage(
  [in]            IShellItem *pShellItem,
                  UINT       uiMaxWidth,
                  UINT       uiMaxHeight,
                  DWORD      flags,
                  IStream    *pvImage,
  [out, optional] UINT       *puiWidth,
  [out, optional] UINT       *puiHeight
);

Paramètres

[in] pShellItem

Type : IShellItem*

Élément shell pour l’image à convertir.

uiMaxWidth

Type : UINT

Hauteur demandée en pixels. Doit être inférieur ou égal à la hauteur réelle de l’image d’origine. Consultez la section Notes.

uiMaxHeight

Type : UINT

Largeur demandée en pixels. Doit être inférieur ou égal à la largeur réelle de l’image d’origine. Consultez la section Notes.

flags

Type : TI_FLAGS

L’un des indicateurs suivants.

TI_BITMAP

Convertissez l’image au format BMP.

TI_JPEG

Convertissez l’image au format JPEG.

pvImage

Type : IStream*

Flux pour recevoir l’image convertie. Le flux doit être créé par le code appelant avant d’appeler TranscodeImage.

[out, optional] puiWidth

Type : UINT*

Largeur réelle de l’image convertie.

[out, optional] puiHeight

Type : UINT*

Hauteur réelle de l’image convertie.

Valeur retournée

Type : HRESULT

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

Notes

Les proportions de l’image d’origine sont conservées. La nouvelle image est redimensionnée afin qu’elle s’ajuste dans une zone de largeur uiMaxWidth et de hauteur uiMaxHeight.

La taille de l’image ne sera pas modifiée si l’image d’origine tient déjà dans ce cadre englobant.

Si uiMaxWidth et uiMaxHeight sont tous deux zéro, l’image retournée aura la même taille que l’image d’origine.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	imagetranscode.h

Partager via