Metodo ITranscodeImage::TranscodeImage (imagetranscode.h)

Articolo
08/24/2023

Converte un'immagine in formato immagine JPEG o bitmap (BMP).

Sintassi

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

Parametri

[in] pShellItem

Tipo: IShellItem*

Elemento shell per l'immagine da convertire.

uiMaxWidth

Tipo: UINT

Altezza richiesta in pixel. Deve essere minore o uguale all'altezza effettiva dell'immagine originale. Vedere la sezione Osservazioni.

uiMaxHeight

Tipo: UINT

Larghezza richiesta in pixel. Deve essere minore o uguale alla larghezza effettiva dell'immagine originale. Vedere la sezione Osservazioni.

flags

Tipo: TI_FLAGS

Uno dei flag seguenti.

TI_BITMAP

Convertire l'immagine in formato BMP.

TI_JPEG

Convertire l'immagine in formato JPEG.

pvImage

Tipo: IStream*

Flusso per ricevere l'immagine convertita. Il flusso deve essere creato dal codice chiamante prima di chiamare TranscodeImage.

[out, optional] puiWidth

Tipo: UINT*

Larghezza effettiva dell'immagine convertita.

[out, optional] puiHeight

Tipo: UINT*

Altezza effettiva dell'immagine convertita.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Le proporzioni dell'immagine originale vengono mantenute. La nuova immagine viene ridimensionata in modo che si adatta a una casella di larghezza uiMaxWidth e height uiMaxHeight.

Le dimensioni dell'immagine non verranno modificate se l'immagine originale si adatta già a questo rettangolo di selezione.

Se sia uiMaxWidth che uiMaxHeight sono zero, l'immagine restituita sarà la stessa dimensione dell'originale.

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	imagetranscode.h

Condividi tramite