int load_fpg( char * nombre_archivo)

Retorna:

 Retorna el código del fichero cargado, o (0) si no se pudo cargar.

Descripción:

Carga un archivo con un fichero (*.FPG) del disco. Se entiende por un fichero, una librería (o colección) de gráficos.

Un archivo FPG con una librería de gráficos puede contener desde ningún gráfico hasta 1000 gráficos. Cada uno ellos incluidos en la librería tendrá un código numérico, el código de gráfico, que es un número entre 1 y 999 que se utiliza para identificar el gráfico dentro del fichero.

Es posible cargar tantos ficheros de gráficos como sea necesario, siempre que quede memoria disponible (para cargar varios ficheros se debe llamar varias veces a esta función).

La función devuelve el código de fichero, que puede ser utilizado por múltiples funciones que requieren un gráfico, para lo cual se les debe indicar el código de fichero en el que está el gráfico y el código de gráfico dentro del fichero, en caso de no poder cargar dicho fichero devolverá 0.

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

MAIN_PROGRAM_CDIV

PRIVATE
 int fichero1;

BEGIN_PROGRAM

 set_gfx(GFX_AUTODETECT_WINDOWED);

 set_mode(m320x200);

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

 put_screen(fichero1, 1);
 write (0, 0, 0, 0, "Fichero de graficos cargado con exito.");

 LOOP
  FRAME;

END_PROGRAM

En el ejemplo, se carga el fichero de gráficos que se va usar en el programa con la función load_fpg() y, después, se utiliza el gráfico número 1 del mismo para ponerlo como fondo en la pantalla (con la función put_screen()).

La función unload_fpg() permite liberar la memoria del ordenador utilizada por el fichero de gráficos cuando ya no se va a utilizar más, y para ello requiere también el código de fichero para saber qué fichero es el que se quiere descargar de memoria.

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

Ver: unload_fpg() - load_map/pcx/bmp/tga/lbm/image() - load_pal() - file