freeimage.h

FreeImage_Paste

DLL_API BOOL DLL_CALLCONV FreeImage_Paste(FIBITMAP *dst, FIBITMAP *src, int left, int
top, int alpha);

Realiza una mezcla alfa o combina una subimagen con la imagen dib actual.

Sólo para imágenes de tipo FITBITMAP: Al profundidad de bits del mapa de bits dst debe ser mayor o igual que la profundidad de bits de src. La promoción hacia arriba de src se hace internamente, sin modificar src. Están soportadas profundidades de bits iaguales a 1, 4, 8, 16, 24 o 32.

Para cualquier otro tipo de imágenes: El tipo de imágen del mapa de bits dst debe ser igual al del tipo de src. El parámetro alpha es ignorado siempre y la imagen de origen se combina con la de destino.

Parámetros

  • dst: imagen de destino.
  • src: subimagen de origen.
  • left: especifica la posición izquierda de la subimagen.
  • top: especifica la posición superior de la subimagen.
  • alpha: factor de mezcla alfa. Las imágenes de origen y destino se mezclan usando transparencia si alpha=0..255. Si alpha > 255, entonces la imagen de origen se combina con la de destino.

La función retorna TRUE si tiene éxito, FALSE en caso contrario.

No se pueden realizar operaciones de pegado entre imágenes con paleta, a no ser que tanto src como dst sean imágenes que usen la misma paleta. Para profundidades de bits menores o iguales a 8-bit, las operaciones de pegado normalmente sólo funcionan con imágenes en escala de grises.

Las coordenadas de sistema definidas por los parámetros (left, top) usan las convenciones gráficas normales. Esto se hace para facilitar las interacciones con el ratón.