int save_map( int fpg, gráfico, char * nombre )
int save_pcx( int fpg, gráfico, char * nombre )
int save_bmp( int fpg, gráfico, char * nombre )
int save_tga( int fpg, gráfico, char * nombre )
int save_lbm( int fpg, gráfico, char * nombre )
int save_image( int fpg, gráfico, char * nombre )

Retorna:

1 // Si el archivo se grabó con éxito.
0 // Se produjo un error al guardar el archivo.

Descripción:

Crea un archivo MAP o PCX o BMP o TGA o LBM a partir de un gráfico cargado en memoria.

La función requiere los códigos de fpg y gráfico que identifican al gráfico, y el nombre del archivo MAP o PCX que debe crearse en el disco conteniendo dicha imagen. El nombre de archivo se debe especificar como un literal (un texto entre comillas, como "imagen.pcx").

La función save_map() siempre creará archivos MAP, así como save_pcx() creará sólo archivos PCX y asi con todos los tipos de ficheros, independientemente de la extensión indicada en el nombre de archivo.  Si no se produce ningún error, la función creará el archivo con la imagen y retornará 1.

Estos mapas podrán después cargarse dentro del entorno gráfico de CDIV.

MAIN_PROGRAM_CDIV
BEGIN_PROGRAM

 set_gfx(GFX_AUTODETECT_WINDOWED);

 set_mode(m320x200);

 load_fpg("../help.fpg");

 save_pcx(1, 1,"../help.pcx"); // Crea un archivo PCX

 FRAME;

END_PROGRAM

En este ejemplo utiliza la función save_pcx() para crear un archivo PCX conteniendo una imagen previamente cargada dentro del fichero help.fpg con la función load_fpg().

Se puede crear un gráfico con la función new_map(), y para modificar un gráfico se deben utilizar las siguientes funciones:

 map_block_copy() // Transfiere un bloque de un gráfico a otro.
 map_get_pixel()  // Obtiene el color de un punto de un gráfico.
 map_put()        // Pone un gráfico en otro.
 map_put_pixel()  // Fija el color de un punto en un gráfico.
 map_xput()       // Pone un gráfico en otro, con efectos.

Nota: La función write_map() permite escribir un texto en un gráfico creado en memoria (en lugar de escribir en la pantalla).

Ver: load_map/pcx/bmp/tga/lbm/image() - unload_map/pcx/bmp/tga/lbm/image()