new_map()

new_map(<ancho>, <alto>, <centro x>, <centro y>, <color>)

Retorna:

El código del gráfico creado.

Descripción:

Crea un nuevo mapa en memoria (sin cargarlo de un archivo del disco).

Para ello, la función requiere el <ancho> y <alto> (en puntos) del mapa que se debe crear, su punto central (dentro del mismo) en <centro x> y <centro y>, y el color con el que se debe rellenar inicialmente el mapa (el número de color dentro de la paleta activa, de 0 a 255).

Esta función se comporta practicaménte igual que load_map(), salvo que no se lee un archivo en disco con el gráfico, sino que se crea como un gráfico sólido de un sólo color.

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.

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

PROGRAM ejemplo_new_map;

BEGIN

    // Se crea un mapa de 16x32 puntos
    // con su centro en el punto (0,0)
    // y con el color 15 de la paleta

    mouse.graph = new_map(16,32,0,0,15); // Se asigna como puntero del ratón

    REPEAT
        FRAME;
    UNTIL (key(_esc));

    unload_map(mouse.graph); // Y finalmente se libera o descarga el gráfico
END

En el ejemplo se crea un mapa con la función new_map() guardando el código del gráfico que retorna en la variable mouse.graph, de forma que aparezca como puntero del ratón.

Pulsando la tecla ESC se saldrá del bucle de visualización del programa y se descargará el gráfico con la función unload_map() (exactamente igual que si se hubiera cargado de un archivo del disco).

La función unload_map() permite 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 requiere 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.