1#
2#  Configuration file for the Allegro library.
3#
4#  If you leave a parameter blank, Allegro will autodetect (ie. guess :-)
5#
6#  This file should be kept either in the same directory as your program,
7#  or in a location pointed to by the "ALLEGRO" environment variable.
8#
9#  On Unix, this file may also be stored as ~/.allegrorc or /etc/allegrorc.
10
11
12
13
14[system]
15
16# Unix system drivers:
17#
18#  XWIN     - XWindows
19#  LNXC     - Linux console
20
21system =
22
23
24
25# Keyboard mapping file (this can be a .cfg file on disk, or an object from
26# keyboard.dat). Currently available layouts are:
27#
28#  BE       - Belgium
29#  BR       - Brazil
30#  CF       - Canada (French)
31#  CH       - Switzerland
32#  CZ       - Czech Republic
33#  DE       - Germany
34#  DK       - Denmark
35#  DVORAK   - Dvorak
36#  ES       - Spain
37#  FI       - Finland
38#  FR       - France
39#  IT       - Italy
40#  NO       - Norway
41#  PL       - Poland
42#  PT       - Portugal
43#  RU       - Russia
44#  SE       - Sweden
45#  SK       - Slovakia
46#  UK       - United Kingdom
47#  US       - United States
48
49keyboard =
50
51
52
53# Language translation file (this can be a .cfg file on disk, or an
54# object from language.dat). Currently available translations are:
55#
56#  CA       - Catalan
57#  CZ       - Czech
58#  DE       - German
59#  DK       - Danish
60#  EN       - English
61#  ES       - Spanish
62#  FI       - Finnish
63#  FR       - French
64#  IT       - Italian
65#  NL       - Dutch
66#  NO       - Norwegian
67#  PL       - Polish
68#  PT       - Portuguese
69#  RU       - Russian
70#  SE       - Swedish
71#  SK       - Slovak
72
73language =
74
75
76
77# whether to disable the screensaver (0:never 1:fullscreen 2:always, default 1)
78disable_screensaver =
79
80
81
82# how long to take for menus to auto-open (time in msecs or -1 to disable)
83menu_opening_delay =
84
85
86
87# use XInitThreads (default = 1) in the X11 port
88XInitThreads =
89
90
91
92[graphics]
93
94# DOS graphics drivers:
95#
96#  VGA      - Standard VGA
97#  MODX     - Mode-X
98#  VBE1     - VESA 1.x
99#  VB2B     - VBE 2.0 (banked)
100#  VB2L     - VBE 2.0 (linear)
101#  VBE3     - VBE 3.0
102#  VBAF     - VBE/AF
103#  XTND     - Xtended mode
104#
105# Windows graphics drivers:
106#
107#  DXAC     - DirectX with hardware acceleration
108#  DXSO     - DirectX without hardware acceleration
109#  DXSA     - DirectX in safe-mode, with all the fancy features disabled
110#  DXWN     - DirectX in windowed mode
111#  DXOV     - DirectX overlay (fast windowed mode, only works on some cards)
112#  GDIB     - GDI mode (slow windowed mode, works on all cards)
113#
114# Linux console graphics drivers:
115#
116#  FB       - fbcon device
117#  VBAF     - VBE/AF
118#  SVGA     - SVGAlib
119#  VGA      - Standard VGA
120#  MODX     - Mode-X
121#
122# X graphics drivers:
123#
124#  XWIN     - standard X Windows
125#  XWFS     - Fullscreen X Windows
126#  DGA2     - DGA 2.0 mode
127#  DGAS     - DGA 2.0 software only mode
128#
129# BeOS graphics drivers:
130#
131#  BWSA     - Fullscreen BWindowScreen with hardware acceleration
132#  BWS      - Fullscreen BWindowScreen
133#  BDWN     - Fast windowed mode via BDirectWindow
134#  BWN      - Normal windowed mode via BWindow
135#  BOVL     - Fullscreen overlay (only works on some cards)
136#
137# QNX graphics drivers:
138#
139#  QPAC     - Photon with hardware acceleration
140#  QPSO     - Photon without hardware acceleration
141#  QPSA     - Photon in safe-mode, with all the fancy features disabled
142#  QPWN     - Photon in windowed mode
143#
144# MacOS X graphics drivers:
145#
146#  QZWN     - Quartz windowed mode
147#  QZFL     - Quartz fullscreen mode via CGDirectDisplay interface
148#
149# You can also specify different drivers for a particular mode or color
150# depth, eg. "gfx_card_640x480x16 = VBE3", "gfx_card_24bpp = VBE1", or
151# you can provide a number of alternative drivers, for example
152# "gfx_card1 = VGA", "gfx_card2 = MODX", etc.
153
154gfx_card =
155
156
157
158# driver to use when autodetecting windowed modes
159gfx_cardw =
160
161
162
163# whether to disable synchronization with the vertical blank when
164# page-flipping (yes or no)
165disable_vsync =
166
167
168
169# DOS and Linux: where to look for the VBE/AF driver
170vbeaf_driver =
171
172
173
174# Linux only: fbcon device file (see below for fbcon timing data)
175framebuffer =
176
177
178
179# Unix/X11 only: whether to force window centering in fullscreen mode
180#                for the XWFS driver (yes or no)
181force_centering =
182
183
184
185# Windows only: whether to disable direct updating in color conversion
186#               mode for the DXWN driver (yes or no)
187disable_direct_updating =
188
189
190
191
192# Linux/fbcon mode timings. Duplicate then fill in `X', `Y' and
193# the timings themselves. You can copy them from fb.modes directly -- the
194# first two figures on the geometry line are X and Y here, and the figures
195# on the timings line are the first fields here (up to `vsync_len')
196
197[fb_mode_XxY]
198pixclock =
199left_margin =
200right_margin =
201upper_margin =
202lower_margin =
203hsync_len =
204vsync_len =
205vmode =
206sync =
207
208
209
210# You can customize the mapping of X11 key codes to Allegro keycodes here. For
211# example, if you want to swap Y and Z on a German keyboard as can be useful in
212# some games who assume Z and X are next to each other, you will see lines like
213# this in allegro.log if you run an Allegro program in debug mode:
214# al-xkey INFO: key [29: z Z] assigned to 26.
215# al-xkey INFO: key [52: y Y] assigned to 25.
216# 29 and 52 are the X11 codes, 26 is KEY_Z, 25 is KEY_Y. Using the two commented
217# out lines below, you would therefore swap both keys.
218
219[xkeymap]
220#keycode29 = 25
221#keycode52 = 26
222
223
224[mouse]
225
226# DOS mouse drivers:
227#
228#  0        - none
229#  MICK     - mickey mode driver (normally the best)
230#  I33      - int 0x33 callback driver
231#  POLL     - timer polling
232#  WNT      - Windows NT 3.5x/4.0 specific driver
233#  W2K      - Windows 2000 specific driver
234#
235# Linux console mouse drivers:
236#
237#  0        - none
238#  LPS2     - PS2 mouse
239#  LIPS     - PS2 mouse with Intellimouse extension
240#  MS       - Microsoft serial mouse
241#  IMS      - Microsoft serial mouse with Intellimouse extension
242#  GPMD     - GPM repeater data (Mouse Systems protocol)
243#  EV       - Event interfaces (EVDEV) - set mouse_device = /dev/input/eventN
244
245mouse =
246
247
248
249# number of buttons (specifying this overrides autodetection)
250num_buttons =
251
252
253
254# whether to emulate the third mouse button (yes or no)
255emulate_three =
256
257
258
259# Linux only: name of the mouse device file (eg. /dev/mouse)
260mouse_device =
261
262
263
264# Linux only: default EV input mode (0=relative, 1=absolute)
265ev_absolute =
266
267
268
269# Linux only: for absolute EV inputs, minimum and maximum values
270#             (specifying this overrides autodetection)
271ev_min_x =
272ev_max_x =
273ev_min_y =
274ev_max_y =
275ev_min_z =
276ev_max_z =
277
278
279
280# Linux only: scaling factor for tablet mouse (1 by default).  Good values are
281#             usually between 1 and 40, higher numbers for bigger tablets
282ev_abs_to_rel_x =
283ev_abs_to_rel_y =
284ev_abs_to_rel_z =
285
286
287
288# Windows only: mouse acceleration factor (1 by default, 0 to disable)
289mouse_accel_factor =
290
291
292
293
294[sound]
295
296# DOS digital sound drivers:
297#
298#  0        - none
299#  SB       - Sound Blaster (autodetect breed)
300#  SB10     - Sound Blaster 1.0
301#  SB15     - Sound Blaster 1.5
302#  SB20     - Sound Blaster 2.0
303#  SBP      - Sound Blaster Pro
304#  SB16     - Sound Blaster 16
305#  ESS      - ESS AudioDrive
306#  ESC      - Ensoniq Soundscape
307#  WSS      - Windows Sound System
308#
309# Windows digital sound drivers:
310#
311#  0        - none
312#  DXA      - first DirectSound device
313#  DXB      - second DirectSound device
314#  ...      - etc
315#  AXA      - first DirectSound device using Allegro mixer
316#  AXB      - second DirectSound device using Allegro mixer
317#  ...      - etc
318#  WOA      - high quality WaveOut device
319#  WOB      - low quality WaveOut device
320#
321# Unix digital sound drivers:
322#
323#  0        - none
324#  OSSD     - Open Sound System
325#  ESDD     - Enlightened Sound Daemon
326#  ARTS     - aRts (Analog Real-Time Synthesizer)
327#  ALSA     - ALSA Sound System
328#  JACK     - JACK Audio Server
329#  SIOD     - sndio Audio API
330#
331# BeOS digital sound drivers:
332#
333#  0        - none
334#  BDIG     - BeOS digital sound system
335#
336# MacOS X digital sound drivers:
337#
338#  0        - none
339#  DCA      - CoreAudio digital output
340#  SNDM     - Carbon Sound Manager
341#
342
343digi_card =
344
345
346
347# DOS music drivers:
348#
349#  0        - none
350#  OPL      - Adlib (autodetect OPL version)
351#  OPL2     - OPL2 FM synth
352#  OPLX     - Dual OPL2 (SB Pro-1)
353#  OPL3     - OPL3 FM synth
354#  SB       - raw SB MIDI interface
355#  MPU      - MPU-401 MIDI interface
356#  DIGI     - DIGMID software wavetable
357#  AWE      - AWE32
358#
359# Windows music drivers:
360#
361#  0        - none
362#  W32M     - win32 MIDI mapper
363#  W32A     - first win32 MIDI device
364#  W32B     - second win32 MIDI device
365#  ...      - etc
366#  DIGI     - DIGMID software wavetable
367#
368# Linux music drivers:
369#
370#  0        - none
371#  OSSM     - Open Sound System
372#  DIGI     - DIGMID software wavetable
373#  AMID     - ALSA Sound System
374#
375# BeOS music drivers:
376#
377#  0        - none
378#  BMID     - BeOS MIDI synthesizer
379#  DIGI     - DIGMID software wavetable
380#
381# MacOS X music drivers:
382#
383#  0        - none
384#  MCA      - CoreAudio MIDI software synthesizer
385#  QTM      - QuickTime Music via Note Allocator
386#  DIGI     - DIGMID software wavetable
387#
388
389midi_card =
390
391
392
393# sound input drivers (same format as above, can usually be left blank)
394digi_input_card =
395midi_input_card =
396
397
398
399# how many voices to reserve for each driver
400digi_voices =
401midi_voices =
402
403
404
405# how loud? (range 0-255)
406digi_volume =
407midi_volume =
408
409
410
411# sample mixing quality (0=fastest, 1=full 16 bit precision, 2=interpolation)
412quality =
413
414
415
416# toggling this between 0 and 1 reverses the left/right panning of samples
417flip_pan =
418
419
420
421# DOS, Unix and BeOS: sample output frequency (eg. 44100)
422sound_freq =
423
424
425
426# Unix and BeOS: preferred number of bits (8 or 16)
427sound_bits =
428
429
430
431# Unix and BeOS: stereo output (1 or 0)
432sound_stereo =
433
434
435
436# DOS only: soundcard port address (usually 220)
437sound_port =
438
439
440
441# DOS only: soundcard DMA channel (usually 1)
442sound_dma =
443
444
445
446# DOS only: soundcard IRQ number (usually 7)
447sound_irq =
448
449
450
451# DOS only: FM synth port address (usually 388)
452fm_port =
453
454
455
456# DOS only: MPU-401 port address (usually 330)
457mpu_port =
458
459
460
461# DOS only: MPU-401 IRQ number (usually the same as sound_irq)
462mpu_irq =
463
464
465
466# DOS only: instrument definitions for the Adlib driver
467ibk_file =
468ibk_drum_file =
469
470
471
472# Unix only: OSS device driver name (usually /dev/dsp or /dev/audio)
473oss_driver =
474
475
476
477# Unix only: number of OSS driver fragments (buffers) and size of each buffer
478oss_numfrags =
479oss_fragsize =
480
481
482
483# Unix only: OSS MIDI device name (usually /dev/sequencer)
484oss_midi_driver =
485
486
487
488# Unix only: OSS mixer device name (usually /dev/mixer)
489oss_mixer_driver =
490
491
492
493# Unix only: name of the Enlightened Sound Daemon server
494esd_server =
495
496
497
498# Unix only: card number and PCM device for the ALSA 0.5 sound driver
499alsa_card =
500alsa_pcmdevice =
501
502
503
504# Unix only: device name for the ALSA 0.9 sound driver
505#            format: <driver>[:<card>,<device>] (e.g.: hw:0,1)
506alsa_device =
507
508
509
510# Unix only: mixer device name for the ALSA 0.9 driver (default: default)
511alsa_mixer_device =
512
513
514
515# Unix only: mixer element name for the ALSA 0.9 driver (default: PCM)
516alsa_mixer_elem =
517
518
519
520# Unix only: number of ALSA driver fragments (buffers)
521alsa_numfrags =
522
523
524
525# Unix only: size of each ALSA fragment, in samples
526alsa_fragsize =
527
528
529
530# Unix only: card number for the ALSA 0.5 midi driver
531alsa_rawmidi_card =
532
533
534
535# Unix only: device for the ALSA 0.5 midi driver
536#            device name for the ALSA 0.9 midi driver (see alsa_device)
537alsa_rawmidi_device =
538
539
540
541# Unix only: name for the JACK client (default: allegro)
542jack_client_name =
543
544
545
546# BeOS only: MIDI synthesizer instruments quality (0=low, 1=high)
547be_midi_quality =
548
549
550
551# BeOS only: MIDI sample mixing frequency in Hz (11025, 22050 or 44100)
552be_midi_freq =
553
554
555
556# BeOS only: MIDI interpolation (0=none, 1=fast linear, 2=linear)
557be_midi_interpolation =
558
559
560
561# BeOS only: MIDI reverberation intensity (0 to 5)
562be_midi_reverb =
563
564
565
566# MacOS X only: CoreAudio MIDI rendering quality (0 to 127)
567ca_midi_quality =
568
569
570
571# MacOS X only: CoreAudio MIDI reverberation intensity (0 to 5)
572ca_midi_reverb =
573
574
575
576# patch set for the DIGMID software wavetable driver
577patches =
578
579
580
581
582[joystick]
583
584# DOS joystick drivers :
585#
586#  0        - none
587#  STD      - standard 2-button
588#  2PAD     - dual standard 2-button
589#  4BUT     - standard 4-button
590#  6BUT     - standard 6-button
591#  8BUT     - standard 8-button
592#  FPRO     - CH Flightstick Pro
593#  WING     - Logitech Wingman Extreme
594#  SW       - Microsoft Sidewinder digital pad
595#  SWAG     - Microsoft Sidewinder digital pad (aggressive)
596#  SWPP     - Microsoft Sidewinder 3D/Precision/Force Feedback Pro
597#  GPRO     - Gravis GamePad Pro
598#  GRIP     - Gravis GrIP
599#  GRI4     - Gravis GrIP (4-axis only)
600#  SNE1     - SNES joypads connected to LPT1
601#  SNE2     - SNES joypads connected to LPT2
602#  SNE3     - SNES joypads connected to LPT3
603#  PSX1     - PSX joypads connected to LPT1
604#  PSX2     - PSX joypads connected to LPT2
605#  PSX3     - PSX joypads connected to LPT3
606#  N641     - N64 joypads connected to LPT1
607#  N642     - N64 joypads connected to LPT2
608#  N643     - N64 joypads connected to LPT3
609#  DB91     - Pair of 2-button joysticks connected to LPT1
610#  DB92     - Pair of 2-button joysticks connected to LPT2
611#  DB93     - Pair of 2-button joysticks connected to LPT3
612#  TGX1     - TurboGraFX joysticks connected to LPT1
613#  TGX2     - TurboGraFX joysticks connected to LPT2
614#  TGX3     - TurboGraFX joysticks connected to LPT3
615#  SEGI     - IF-SEGA joystick interface card (ISA bus)
616#  SEGP     - IF-SEGA joystick interface card (PCI bus)
617#  SGPF     - IF-SEGA joystick interface card (fast PCI bus)
618#  WWAR     - Wingman Warrior
619#
620# Windows joystick drivers :
621#
622#  0        - none
623#  DX       - DirectInput joystick
624#  W32      - Win32 joystick
625
626joytype =
627
628
629
630# BeoS and Linux only: name of the joystick device
631joystick_device =
632
633
634
635# alternatively you can specify it for each joystick:
636# joystick_device_0 =
637# joystick_device_1 =
638# ...
639
640
641
642# Linux only: axis number the throttle is located at
643throttle_axis =
644
645# alternatively you can specify it for each joystick:
646#
647# throttle_axis_0 =
648# throttle_axis_1 =
649# ...
650
651
652
653
654[grabber]
655
656# stored grabber variables (editor state information)
657xgrid = 16
658ygrid = 16
659backups = n
660index = n
661sort = n
662relative = n
663dither = n
664transparency = n
665griddle_xgrid =
666griddle_ygrid =
667griddle_mode =
668griddle_empties =
669griddle_autocrop =
670griddle_type =
671griddle_depth =
672
673
674
675# edit these shell commands to whatever helper programs you want to use...
676data = start /w notepad
677bmp = start /w "c:\program files\accessories\mspaint.exe"
678rle = start /w "c:\program files\accessories\mspaint.exe"
679cmp = start /w "c:\program files\accessories\mspaint.exe"
680xcmp = start /w "c:\program files\accessories\mspaint.exe"
681pal = start /w "c:\program files\accessories\mspaint.exe"
682font = start /w "c:\program files\accessories\mspaint.exe"
683samp = start /w "c:\program files\cooledit\cool.exe"
684midi = start /w "c:\program files\cakewalk\wincake.exe"
685
686# or if you are using Linux you might prefer something more like:
687#
688# data = xterm -e fed -b
689# bmp = gimp
690# rle = gimp
691# cmp = gimp
692# xcmp = gimp
693# pal = gimp
694# font = gimp
695