PDF de programación - MANUAL ALLEGRO

MANUAL ALLEGRO




Pag.






ÍNDICE

USANDO ALLEGRO ……………………………………………………………………………………
RUTINAS UNICODE …………………………………………………………………..……………..
RUTINAS DE CONFIGURACIÓN ……………………………………………………………….
RUTINAS DE RATÓN …………………………………………………………………………………
RUTINAS DE TEMPORIZACIÓN ………………………………………………………………..
RUTINAS DE TECLADO ……………………………………………………………………………..
RUTINAS DE JOYSTICK …………………………………………………………………………….
MODOS GRÁFICOS ……………………………………………………………………………………
OBJETOS BITMAP ……………………………………………………………………………………..
CARGANDO IMÁGENES .………………………………………….……………………………….
RUTINAS DE PALETA ………………………………………………………………………………..
FORMATOS DE PIXEL TRUECOLOR ………………………………………………………….
PRIMITIVAS DE DIBUJO …………………………………………………………………………..
BLITS Y SPRITES ………………………………………………………………………………………
SPRITES RLE ……………………………………………………………………………………………..
SPRITES COMPILADOS …………………………………………………………………………….
SALIDA DE TEXTO …………………………………………………………………………………….
RENDERIZACIÓN DE POLÍGONOS …………………………………………………………..
TRANSPARENCIAS Y DIBUJO CON PATRÓN ……………………………………………
CONVERSIONES DE FORMATOS DE COLOR …………………………………………….
ACCESO DIRECTO A LA MEMORIA DE VÍDEO ………………………………………….
RUTINAS FLIC ……………………………………………………………………………………………
RUTINAS DE INICIALIZAIÓN DE SONIDO ……………………………………………….
RUTINAS DE SAMPLES DIGITALES ………………………………………………………….
RUTINAS DE MÚSICA MIDI ………………………………………………………………………
RUTINAS DE FLUJO DE SONIDO ………………………………………………………………
RUTINAS DE GRABACIÓN DE SONIDO …………………………………………………….
RUTINAS DE FICHEROS Y COMPRESIÓN …………………………………………………
RUTINAS DE FICHEROS DE DATOS ………………………………………………………….
RUTINAS MATEMÁTICAS DE PUNTO FIJO ……………………………………………….
RUTINAS MATEMÁTICAS 3D …………………………………………………………………….
RUTINAS MATEMÁTICAS PARA USAR CUATERNIONES …………………………..
RUTINAS GUI …………………………………………………………………………………………….
DETALLES ESPECÍFICOS DE UNIX …………………………………………………………..
REDUCIENDO EL TAMAÑO DE SU EJECUTABLE ………………………………………
DEPURANDO ………………………………………………………………………………………………
COMANDOS MAKEFILE ………………………………………………………………………………



2




USANDO ALLEGRO


•

install_allegro

int install_allegro(int system_id, int *errno_ptr, int (*atexit_ptr)());

Inicializa Allegro. Debe llamar a esta función o a allegro_init() antes de hacer
otra cosa. Los identificadores de sistema disponibles (system_id) variarán
dependiendo de la plataforma utilizada, pero casi siempre querrá usar
SYSTEM_AUTODETECT. Alternativamente, SYSTEM_NONE
instalará una
versión reducida de Allegro que no intentará realizar accesos directos al
hardware ni operaciones que sean particulares a una plataforma específica:
esto puede resultar útil para situaciones en las que solamente quiera
manipular bitmaps de memoria, como en una utilidad que maneje ficheros de
datos o las funciones de interfaz con el GDI de Windows. Los parámetros
errno_ptr y atexit_ptr deben apuntar a la variable errno y la función atexit()
de su librería C respectivamente. Estos parámetros son requeridos ya que
cuando Allegro es enlazado como una DLL no tiene acceso directo a los datos
locales de su librería C. Por ahora esta función siempre devuelve cero. Si no se
puede usar ningún driver de sistema, el programa será abortado.


• allegro_init

int allegro_init();

Inicializa Allegro.
install_allegro(SYSTEM_AUTODETECT, &errno, atexit).


función

Esta

es

equivalente

a

la

llamada

• allegro_exit
void allegro_exit();

Cierra el sistema Allegro. Esto incluye devolver el sistema al modo texto y
desinstalar todas las rutinas de ratón, teclado o temporización que estuviesen
instaladas. Normalmente no tiene que molestarse en hacer una llamada
explícita a esta función, ya que allegro_init() la instala como una función
atexit(), por lo que será llamada automáticamente cuando su programa
finalice.


• allegro_id

extern char allegro_id[];




3

Cadena de texto que contiene la fecha y número de versión de Allegro, en
caso de que quiera enseñar estos datos en alguna parte.


• allegro_error

extern char allegro_error[ALLEGRO_ERROR_SIZE];

Cadena de texto usada por set_gfx_mode() e install_sound() para indicar
mensajes de error. Si éstas funciones fallan y quiere decirle al usuario porqué,
éste es el lugar en el que se encuentra una descripción del problema.


• os_type

extern int os_type;

Variable ajustada por allegro_init() a uno de los siguientes valores:


OSTYPE_UNKNOWN
OSTYPE_WIN3

OSTYPE_WIN95
OSTYPE_WIN98
OSTYPE_WINME
OSTYPE_WINNT
OSTYPE_WIN2000
OSTYPE_WINXP
OSTYPE_OS2

OSTYPE_WARP
OSTYPE_DOSEMU
OSTYPE_OPENDOS
OSTYPE_LINUX
OSTYPE_FREEBSD
OSTYPE_UNIX

OSTYPE_BEOS

OSTYPE_QNX

OSTYPE_MACOS




















- desconocido, o MSDOS normal
- Windows 3.1 o versiones anteriores
- Windows 95
- Windows 98
- Windows ME
- Windows NT
- Windows 2000
- Windows XP
- OS/2
- OS/2 Warp 3
- Linux DOSEMU
- Caldera OpenDOS
- Linux
- FreeBSD
- variante Unix desconocida
- BeOS
– QNX
- MacOS



• os_version

extern int os_version;
extern int os_revision;

La versión mayor y menor del Sistema Operativo usado. Ajustado por
allegro_init(). Si Allegro por alguna razón no es capaz de obtener la versión de
su Sistema Operativo, os_version y os_revision valdrán -1. Por ejemplo: bajo
Win98 SE (v4.10.2222) os_version valdrá 4 y os_revision valdrá 10.


• os_multitasking



4

extern int os_multitasking;

Ajustado por allegro_init() a TRUE o FALSE dependiendo de si su Sistema
Operativo es multitarea o nó.


• allegro_message

void allegro_message(char *msg, ...);

Muestra un mensaje usando una cadena con formato printf(). Esta función sólo
debe ser utilizada cuando no esté en un modo gráfico, es decir, antes de
llamar a set_gfx_mode() o después de llamar a set_gfx_mode(GFX_TEXT). En
plataformas que tengan una consola en modo texto (DOS, Unix y BeOS),
mostrará la cadena en la consola reduciendo los carácteres acentuados a
aproximaciones en 7 bits de códigos ASCII, evitando en lo posible los
problemas con las diferentes páginas de códigos. Bajo Windows, el mensaje
aparecerá en un ventana de mensajes.


• set_window_title

void set_window_title(const char *name);

En las plataformas que sean capaces de ello, esta rutina cambia el título de la
ventana utilizada para su programa. Tenga en cuenta que Allegro no es capaz
de modificar el título de la ventana cuando ejecute una ventana DOS en
Windows.


• set_window_close_button

int set_window_close_button(int enable);

En las plataformas que sean capaces de ello, esta rutina activa o desactiva el
botón de cerrar ventana de su programa Allegro. Si lo desea, puede llamar
esta rutina antes de que la ventana sea creada. Si el botón de cerrar ventana
es desactivado con éxito, esta función devolverá cero.

En plataformas en las que el botón de cerrado no existe o no puede ser
desactivado, la función devolverá -1. Si esto ocurre, quizás le interese usar
set_window_close_hook() para manejar manualmente el evento de cierre de la
ventana.

Cuando active el botón de cierre, la función devolverá el mismo valor que
devolvió su plataforma al desactivarlo. Esto significa que devolverá distinto de
cero si el botón no se puede desacivar, a pesar de que no esté intentando
desactivarlo.




5

Tenga en cuenta que Allegro no puede manipular el botón de cerrado de una
ventana DOS bajo Windows.


• set_window_close_hook

void set_window_close_hook(void (*proc)());

En las plataformas que tengan botón de cierre, esta rutina instala una función
de enganche en el evento de cierre. En otras palabras, cuando el usuario
pinche en el botón que cerraría la ventana de su programa, se llamará a la
función que especifique aquí. Puede usar esta función para mostrar un diálogo
ofreciendo salvar los datos o verificar que el usuario realmente desea salir, o
puede usarla para salvar los datos, liberar memoria y salir.

Esta función generalmente no debería intentar salir del programa o salvar
datos por sí misma. Esta función podría ser llamada en cualquier momento, y
hay peligro de que los datos que intente salvar sean inválidos en ese
momento. Por eso, debería activar una variable durante esta función, y
verificar esta variable regularmente en su programa principal.

Pase NULL a esta función para recuperar la funcionalidad por defecto del botón
de cierre. En Windows y BeOS, el siguiente mensaje aparecerá:

Aviso: forzar la finalización del programa puede ocasionar pérdidas de datos y
resultados inesperados. Es preferible que use el comando de salir dentro de la
ventana.

¿Desea continuar de todas maneras?
[Si] [No]

Este mensaje será traducido al lenguaje seleccionado si hay una traducción
dispobible en language.dat (vea get_config_text()).

Si el usuario selecciona [Si], el programa finalizará inmediatamente en el
mismo
(vea
three_finger_flag).

En otros sistemas operativos, el programa saldrá inmediatamente sin
preguntar nada al usuario.

Tenga en cuenta que Allegro no puede interceptar el botón de cierre de una
ventana DOS bajo Windows.


el usuario pulsa Ctrl+Alt+End

estilo que

cuando

• desktop_color_depth

int desktop_color_depth();



6


En plataformas que pueden ejecutar programas de Allegro en una ventana de
un escritorio existente, devuelve la profundidad de color usada por el escritorio
en ese momento (su programa posiblemente correrá más si usa la misma
profundidad de color. En plataformas donde esta información no es disponible
o no tiene sentido, devuelve cero.


•