unload_fpg()

unload_fpg(<código del fichero>)

Descripción:

Descarga de memoria el fichero de gráficos cuyo código se pasa como parámetro. Este <código de fichero> es el valor que retorna la función load_fpg() cuando se carga un nuevo fichero de gráficos en la memoria.

Tras descargarse un fichero de gráficos se deben extremar las precauciones para no continuar utilizando en el programa ningún gráfico que estuviera en dicho fichero. En cuyo caso el programa correría el riesgo de bloquearse.

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

Por lo tanto, un fichero se debe descargar de memoria únicamente cuando ya no se vaya a utilizar durante un tiempo determinado y se quiera liberar el espacio ocupado en la memoria del ordenador para cargar otros recursos (otros ficheros de gráficos, sonidos, fuentes, etc.).

PROGRAM ejemplo_unload_fpg;

PRIVATE
    fichero1;

BEGIN
    fichero1=load_fpg("help\help.fpg");
    put_screen(fichero1, 1);
    write(0, 160, 0, 1, "Pulse [ENTER] para descargar el fichero y terminar");
    REPEAT
        FRAME;
    UNTIL (key(_enter));

    unload_fpg(fichero1); // Se descarga el fichero.

END

El ejemplo carga el fichero de gráficos contenido en el archivo help.fpg con la función load_fpg(), guardando el código del fichero en la variable privada fichero1.

El programa permanecerá en un bucle hasta que se pulse la tecla ENTER, momento en el cual se descargará el fichero de memoria con unload_fpg() y terminará el programa.

Los gráficos cargardos individualmente con las funciones load_map() o load_pcx() (o creados con new_map()) no se descargarán cuando se descargue el fichero número 0 (con código 0), aunque éstos se utilicen como si pertenecieran al mismo, sino que se deberán descargar utilizando las funciones unload_map() o unload_pcx().