Las siguientes rutinas pueden ser empleadas para crear nuevas imágenes de fondo y para eliminarlas.
background_duplicate(ind)
Crea un duplicado
del fondo con el índice ind. Devuelve el índice del nuevo fondo. Cuando se
presenta algún error se devuelve -1.
background_assign(ind,back)
Asigna el fondo back
al fondo ind. Esto es, crea una copia del fondo.
background_add(fname,transparent,smooth,preload)
Agrega la imagen
almacenada en el archivo fname al juego de recursos background. Solo se pueden
manejar imágenes bmp y jpg.
transparent
indica si la imagen
es parcialmente transparente.
smooth
indica si se alisarán los
bordes.
preload
indica si se
precargará la imagen en la memoria de texturas. La función devuelve el índice
del nuevo fondo, el cual se puede usar para dibujarlo o para asignarlo a la
variable background_index[0] para hacerlo visible en la habitación actual.
Devuelve -1 cuando ocurre algún error.
background_replace(ind,fname,transparent,smooth,preload)
Lo mismo que la
anterior pero en este caso el fondo con índice ind es reemplazado. La función
devuelve un valor indicando si tuvo éxito la operación. Cuando el fondo
reemplazado es visible en la habitación será reemplazado.
background_create_color(w,h,col,preload)
Crea un nuevo fondo
del tamaño dado (w=ancho, h=alto) con el color col. Devuelve el índice del nuevo
fondo, -1 si ocurre algún error.
background_create_gradient(w,h,col1,col2,kind,preload)
Crea un fondo del
tamaño indicado (w=ancho, h=alto) coloreado con un gradiente. col1 y col2
indican los dos colores. kind es un número entre 0 y 5 que indica el tipo de
gradiente: 0=horizontal, 1=vertical, 2=rectángulo, 3=elipse, 4=doble horizontal,
5=doble vertical. Esta función devuelve el índice del nuevo fondo, ó -1 si ocurre
algún error.
background_create_from_screen(x,y,w,h,transparent,smooth,preload)
Crea un fondo
copiando un área indicada de la pantalla (x, y=coordenadas esquina superior
izquierda, w=ancho, h=alto). Esta función permite crear cualquier fondo que se
desee. Se dibuja la imagen en pantalla usando las funciones de dibujo y a
continuación se crea un nuevo fondo de ella. (Si no se hace esto en el evento drawing incluso se puede lograr que no sea visible en pantalla si no se
refresca). Los otros parámetros son similares a los de las anteriores funciones.
La función devuelve el índice del nuevo fondo. Se requiere algo de cuidado aquí.
Aunque se habla de la pantalla, lo que importa es la región en la que se dibuja.
No importa el hecho de que haya una ventana en pantalla y que la imagen en ella
pudiera estar escalada.
background_delete(ind)
Elimina el fondo,
liberando la memoria utilizada.
La siguiente rutina permite cambiar la apariencia de un fondo.
background_set_alpha_from_background(ind,back) Cambia los valores alfa (transparencia) del fondo con índice ind usando los valores hue del fondo back. Esta acción no puede deshacerse.