Método IWICImagingFactory::CreateBitmapFromSourceRect (wincodec.h)

Crea un IWICBitmap a partir de un rectángulo especificado de un IWICBitmapSource.

Sintaxis

HRESULT CreateBitmapFromSourceRect(
  [in]  IWICBitmapSource *pIBitmapSource,
  [in]  UINT             x,
  [in]  UINT             y,
  [in]  UINT             width,
  [in]  UINT             height,
  [out] IWICBitmap       **ppIBitmap
);

Parámetros

[in] pIBitmapSource

Tipo: IWICBitmapSource*

IWICBitmapSource desde el que se va a crear el mapa de bits.

[in] x

Tipo: UINT

Coordenada horizontal de la esquina superior izquierda del rectángulo.

[in] y

Tipo: UINT

Coordenada vertical de la esquina superior izquierda del rectángulo.

[in] width

Tipo: UINT

Ancho del rectángulo y del nuevo mapa de bits.

[in] height

Tipo: UINT

Alto del rectángulo y del nuevo mapa de bits.

[out] ppIBitmap

Tipo: IWICBitmap**

Puntero que recibe un puntero al nuevo mapa de bits.

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

Si se proporciona un rectángulo mayor que el origen, se producirán resultados no definidos.

Este método siempre crea una copia independiente de la imagen de origen, similar a la opción de caché WICBitmapCacheOnLoad.

Requisitos

Cliente mínimo compatible	Windows XP con SP2, Windows Vista [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	wincodec.h
Library	Windowscodecs.lib
Archivo DLL	Windowscodecs.dll