load_map(<nombre de archivo>)
load_pcx(<nombre de archivo>)
Retorna:
El código del gráfico cargado.
Descripción:
Carga un archivo MAP o PCX 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.)
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 (\MAP o \PCX) no será necesario.
Importante:
Cuando se requiera dentro de una función el código de fichero al que pertenece dicho gráfico, se debe indicar el código 0 (que es el código del primer fichero FPG que se cargue en el programa).
Cuando 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.
PROGRAM ejemplo_load_map; PRIVATE mapa1; BEGIN mapa1 = load_map("help\help.map"); // Se carga un fichero de mapa gráfico. put_screen(0, mapa1); LOOP FRAME; END END
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() y unload_pcx() 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.