freeimage.h

FreeImage_OpenMultiBitmap

DLL_API FIMULTIBITMAP * DLL_CALLCONV FreeImage_OpenMultiBitmap(FREE_IMAGE_FORMAT fif,
const char *filename, BOOL create_new, BOOL read_only, BOOL keep_cache_in_memory
FI_DEFAULT(FALSE), int flags FI_DEFAULT(0));

Abre un mapa de bits multipágina.

El primer parámetro indica a FreeImage el tipo de mapa de bits a abrir. Actualmente están soportados los tipos FIF_TIFF, FIF_ICO y FIF_GIF. El segundo parámetro especifica el nombre del mapa de bits. Cuando el tercer parámetro es TRUE, significa que el nuevo mapa de bits será creado en lugar de abrir uno existente. Cuando el cuarto parámetro es TRUE el mapa de bits es abierto en modo de sólo lectura. El parámetro keep_cache_in_memory afecta sólo al rendimiento. Cuando sea TRUE, todos los datos recopilados por el proceso de manipulación de páginas se mantendrán en memoria, en caso contrario serán guardados lentamente a un fichero temporal en el disco duro en bloques de 64 Kb.

Hay que tener en cuenta que dependiendo de la cantidad de manipulación que se realice y de la tamaño del mapa de bits, los datos temporales pueden llagar a ser bastante grandes. Se recomienda la descarga a disco. El último parámetro se usa para modificar el comportamiento o activar una característica del plugin en el mapa de bits. Cada plugin tiene su propio conjunto de parámetros.