save_map(<fichero>, <gráfico>, <nombre del archivo>)
save_pcx(<fichero>, <gráfico>, <nombre del archivo>)
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 a partir de un gráfico cargado en memoria.
La función requiere los códigos de <fichero> 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").
Los gráficos cargados con las funciones load_map() o load_pcx() (o creados con new_map()) se utilizarán como si pertenecieran al primer fichero (el fichero con el código 0).
La función save_map() siempre creará archivos MAP, así como save_pcx() creará sólo archivos PCX, 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 DIV Games Studio o en los programas, utilizando las funciones load_map() o load_pcx().
PROGRAM ejemplo_save_map; BEGIN load_fpg("help\help.fpg"); save_pcx(0,1,"help\help.pcx"); // Crea un archivo PCX END
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).