load_fpg()

load_fpg(<nombre de archivo>)

Retorna:

Retorna el código del fichero cargado.

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 999 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.

Se puede especificar la ruta de acceso al archivo con el fichero de gráficos, no obstante, si el fichero está en el directorio por defecto (\FPG) no será necesario.

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.

PROGRAM ejemplo_load_fpg;

PRIVATE
    fichero1;

BEGIN

    fichero1 = load_fpg("help\help.fpg"); // Se  carga el fichero de gráficos

    put_screen(fichero1, 1); // Utilizamos el gráfico 1 del fichero
    write(0, 160, 0, 1, "Fichero de gráficos cargado con éxito");
    LOOP
        FRAME;
    END
END

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 codigo 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.