int load_map( char * nombre_archivo )
int load_pcx( char * nombre_archivo )
int load_bmp( char * nombre_archivo )
int load_tga( char * nombre_archivo )
int load_lbm( char * nombre_archivo )
int load_image( char * nombre_archivo )

Retorna:

El código del gráfico cargado o (0) si no pudo cargarlo.

Descripción:

Carga un archivo MAP o PCX o BMP con un gráfico en la memoria del ordenador. Se requiere el nombre del archivo como parámetro, entre comillas.

Se devuelve como valor de retorno el código del gráfico, que es un valor numérico que debe especificarse para utilizar el gráfico, en la variable graph o, en general, en todas las funciones que requieran un código de gráfico entre sus parámetros.

Es posible cargar tantos gráficos como sea necesario; cada vez que se cargue uno la función devolverá el código que le corresponde (el primer gráfico cargado tendrá el código 1000, el siguiente el 1001, etc.)

Cuando en 8 bits se han cargado diferentes gráficos se debe tener en cuenta que si éstos tienen paletas diferentes, se debe activar cada una de ellas previamente con la función load_pal(), indicando el nombre del fichero como parámetro, antes de utilizar el gráfico.

No se pueden utilizar simultáneamente gráficos creados con distintas paletas en 8 bits de profundidad.

MAIN_PROGRAM_CDIV

PRIVATE
 int mapa1;

BEGIN_PROGRAM

 set_gfx(GFX_AUTODETECT_WINDOWED);

 set_mode(m320x200);

 mapa1 = load_map("../help.map");

 put_screen(1, mapa1);

 write (0, 0, 0, 0, "Fichero MAP cargado con exito.");

 LOOP
  FRAME;

END_PROGRAM

En el ejemplo se carga un mapa gráfico con la función load_map() guardando el código del gráfico que retorna en la variable privada mapa1.

Este código se usa posteriormente como parámetro de la función put_screen() para poner el gráfico en el fondo de pantalla.

Las funciones unload_map(), unload_pcx(), unload_bmp(), unload_tga(), unload_lbm() y unload_image() permiten liberar la memoria del ordenador utilizada por el gráfico cuando ya no se va a utilizar más durante un tiempo, y para ello requieren también el codigo del gráfico, para saber qué gráfico es el que se quiere descargar de memoria.

No es necesario descargar el gráfico de memoria antes de finalizar el programa, ya que el sistema lo hará de forma automática.

Para cargar varios gráficos de golpe en un programa, éstos deben estar incluidos dentro de un fichero de gráficos (FPG) y cargarse con la función load_fpg().

La función new_map() permite crear en memoria un mapa gráfico de cualquier tamaño y color, sin cargarlo de un archivo en disco.

Ver: new_map() - unload_map/pcx/bmp/tga/lbm/image() - load_fpg() - load_pal() - graph