void unload_fpg( int id_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.).

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, 160, 0, 1, "[ENTER] descarga el fichero y terminar");

 do{
    FRAME;
 }while(!key(_enter));

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

END_PROGRAM

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 cargados individualmente con las funciones load_map() o load_pcx() (o creados con new_map()) se deberán descargar utilizando las funciones unload_map() o unload_pcx() o unload_bmp() o unload_tga() o unload_lbm() o unload_image().

Ver: load_fpg() - load_map/pcx/bmp/tga/lbm/image() - unload_map/pcx/bmp/tga/lbm/image()