Compartir a través de

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

  • Artículo

Convierte una imagen en formato de imagen JPEG o de mapa de bits (BMP).

Sintaxis

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

Parámetros

[in] pShellItem

Tipo: IShellItem*

Elemento de shell de la imagen que se va a convertir.

uiMaxWidth

Tipo: UINT

Alto solicitado en píxeles. Debe ser menor o igual que el alto real de la imagen original. Vea la sección Comentarios.

uiMaxHeight

Tipo: UINT

Ancho solicitado en píxeles. Debe ser menor o igual que el ancho real de la imagen original. Vea la sección Comentarios.

flags

Tipo: TI_FLAGS

Una de las siguientes marcas.

TI_BITMAP

Convierta la imagen en formato BMP.

TI_JPEG

Convierta la imagen en formato JPEG.

pvImage

Tipo: IStream*

Secuencia para recibir la imagen convertida. El código de llamada debe crear la secuencia antes de llamar a TranscodeImage.

[out, optional] puiWidth

Tipo: UINT*

Ancho real de la imagen convertida.

[out, optional] puiHeight

Tipo: UINT*

Alto real de la imagen convertida.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Se conserva la relación de aspecto de la imagen original. Se cambia el tamaño de la nueva imagen para que se ajuste a un cuadro de ancho uiMaxWidth y alto uiMaxHeight.

El tamaño de la imagen no se cambiará si la imagen original ya cabe en este rectángulo de selección.

Si uiMaxWidth y uiMaxHeight son cero, la imagen devuelta será el mismo tamaño que el original.

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado imagetranscode.h