int new_map( int ancho, alto, centro_x, centro_y, color )

Retorna:

 El código del gráfico creado, y (0) si no pudo crearse.

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 prácticamente 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).

MAIN_PROGRAM_CDIV

BEGIN_PROGRAM

 set_gfx(GFX_AUTODETECT_FULLSCREEN);
 set_mode(m320x200);

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

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

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

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

END_PROGRAM

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 código 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.

Ver: load_map/pcx() - unload_map/pcx() - graph