CImage::CreateEx

Crea un mapa de bits de CImage y lo asocia al objeto previamente construido de CImage .

BOOL CreateEx(
   int nWidth,
   int nHeight,
   int nBPP,
   DWORD eCompression,
   const DWORD* pdwBitmasks = NULL,
   DWORD dwFlags = 0 
) throw( );

Parámetros

nWidth
El ancho del mapa de bits de CImage , en píxeles.
nHeight
El alto del mapa de bits de CImage , en píxeles.Si nHeight es positivo, el mapa de bits es DIB ascendente y el origen es la esquina inferior izquierda.Si nHeight es negativo, el mapa de bits es DIB descendente y el origen es la esquina superior izquierda.
nBPP
los números de bits por píxel en el mapa de bits.Normalmente 4, 8, 16, 24, 32.Puede ser 1 para los mapas de bits monocromos o máscaras.
eCompression
Especifica el tipo de compresión de un mapa de bits ascendente cifrado (DIB descendente no puede ser cifrado).Puede presentar uno de los siguientes valores:
- El formato deBI_RGB No está sin comprimir.Especificar este valor al llamar a CImage::CreateEx equivale a llamar a CImage::Create.
- El formato deBI_BITFIELDS No se descomprime y la paleta de colores consta de tres máscaras de color de DWORD que especifican los componentes rojo, verde, y azul, respectivamente, de cada píxel.Esto es válido cuando se utiliza con 16 32 de bpp mapas de bits - y.
pdwBitfields
Sólo se utiliza si eCompression se establece en BI_BITFIELDS, si no debe ser NULL.Puntero a una matriz de tres máscaras de bits de DWORD , especificando qué bits de cada píxel se utilizan para los componentes rojo, verde, y azul del color, respectivamente.Para obtener información sobre las restricciones para los campos de bits, vea BITMAPINFOHEADER en Windows SDK.
dwFlags
Especifica si el objeto bitmap tiene un canal alfa.Puede ser una combinación de cero o más de los siguientes valores:
- Se utilizacreateAlphaChannel Poder sólo si nBPP es 32, y eCompression es BI_RGB.Si se especifica, la imagen creada tiene un valor alfa (de transparencia) para cada píxel, almacenado en el 4to byte de cada píxel (no utilizado en una imagen de 32 bits de la no-alfa).Este canal alfa se usa automáticamente al llamar a CImage:: AlphaBlend.
  
  [!NOTA]
  
  En las llamadas a CImage:: Tablas, imágenes con un canal alfa son automáticamente alfa mixto al destino.

Valor devuelto

TRUE si correctamente.si no FALSO.

Ejemplo

El ejemplo siguiente se crea un mapa de bits de píxel 100x100, con 16 bits para codificar cada píxel.En un píxel de 16 bits especificado, cifrado de bits 0-3 el componente rojo, el cifrado de los bits 4-7 verde, y el azul de cifrado de bits 8-11.Restantes los 4 bits son no usados.

DWORD adwBitmasks[3] = { 0x0000000f, 0x000000f0, 0x00000f00 };
m_myImage.CreateEx(100, 100, 16, BI_BITFIELDS, adwBitmasks, 0);

Requisitos

encabezado: atlimage.h

Vea también

Referencia

Last updated on 2013-02-19