1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957
958
959
960
961
962
963
964
965
966
967
968
969
970
971
972
973
974
975
976
977
978
979
980
981
982
983
984
985
986
987
988
989
990
991
992
993
994
995
996
997
998
999
1000
1001
1002
1003
1004
1005
1006
1007
1008
1009
1010
1011
1012
1013
1014
1015
1016
1017
1018
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029
1030
1031
1032
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043
1044
1045
1046
1047
1048
1049
1050
1051
1052
1053
1054
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079
1080
1081
1082
1083
1084
1085
1086
1087
1088
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100
1101
1102
1103
1104
1105
1106
1107
1108
1109
1110
1111
1112
1113
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128
1129
1130
1131
1132
1133
1134
1135
1136
1137
1138
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156
1157
1158
1159
1160
1161
1162
1163
1164
1165
1166
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207
1208
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228
1229
1230
1231
1232
1233
1234
1235
1236
1237
1238
1239
1240
1241
1242
1243
1244
1245
1246
1247
1248
1249
1250
1251
1252
1253
1254
1255
1256
1257
1258
1259
1260
1261
1262
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273
1274
1275
1276
1277
1278
1279
1280
1281
1282
1283
1284
1285
1286
1287
1288
1289
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318
1319
1320
1321
1322
1323
1324
1325
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345
1346
1347
1348
1349
1350
1351
1352
1353
1354
1355
1356
1357
1358
1359
1360
1361
1362
1363
1364
1365
1366
1367
1368
1369
1370
1371
1372
1373
1374
1375
1376
1377
1378
1379
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390
1391
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402
1403
1404
1405
1406
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418
1419
1420
1421
1422
1423
1424
1425
1426
1427
1428
1429
1430
1431
1432
1433
1434
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446
1447
1448
1449
1450
1451
1452
1453
1454
1455
1456
1457
1458
1459
1460
1461
1462
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474
1475
1476
1477
1478
1479
1480
1481
1482
1483
1484
1485
1486
1487
1488
1489
1490
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501
1502
1503
1504
1505
1506
1507
1508
1509
1510
1511
1512
1513
1514
1515
1516
1517
1518
1519
1520
1521
1522
1523
1524
1525
1526
1527
1528
1529
1530
1531
1532
1533
1534
1535
1536
1537
1538
1539
1540
1541
1542
1543
1544
1545
1546
1547
1548
1549
1550
1551
1552
1553
1554
1555
1556
1557
1558
1559
1560
1561
1562
1563
1564
1565
1566
1567
1568
1569
1570
1571
1572
1573
1574
1575
1576
1577
1578
1579
1580
1581
1582
1583
1584
1585
1586
1587
1588
1589
1590
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601
1602
1603
1604
1605
1606
1607
1608
1609
1610
1611
1612
1613
1614
1615
1616
1617
1618
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629
1630
1631
1632
1633
1634
1635
1636
1637
1638
1639
1640
1641
1642
1643
1644
1645
1646
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657
1658
1659
1660
1661
1662
1663
1664
1665
1666
1667
1668
1669
1670
1671
1672
1673
1674
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685
1686
1687
1688
1689
1690
1691
1692
1693
1694
1695
1696
1697
1698
1699
1700
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1713
1714
1715
1716
1717
1718
1719
1720
1721
1722
1723
1724
1725
1726
1727
1728
1729
1730
1731
1732
1733
1734
1735
1736
1737
1738
1739
1740
1741
1742
1743
1744
1745
1746
1747
1748
1749
1750
1751
1752
1753
1754
1755
1756
1757
1758
1759
1760
1761
1762
1763
1764
1765
1766
1767
1768
1769
1770
1771
1772
1773
1774
1775
1776
1777
1778
1779
1780
1781
1782
1783
1784
1785
1786
1787
1788
1789
1790
1791
1792
1793
1794
1795
1796
1797
1798
1799
1800
1801
1802
1803
1804
1805
1806
1807
1808
1809
1810
1811
1812
1813
1814
1815
1816
1817
1818
1819
1820
1821
1822
1823
1824
1825
1826
1827
1828
1829
1830
1831
1832
1833
1834
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848
1849
1850
1851
1852
1853
1854
1855
1856
1857
1858
1859
1860
1861
1862
1863
1864
1865
1866
1867
1868
1869
1870
1871
1872
1873
1874
1875
1876
1877
1878
1879
1880
1881
1882
1883
1884
1885
1886
1887
1888
1889
1890
1891
1892
1893
1894
1895
1896
1897
1898
1899
1900
1901
1902
1903
1904
1905
1906
1907
1908
1909
1910
1911
1912
1913
1914
1915
1916
1917
1918
1919
1920
1921
1922
1923
1924
1925
1926
1927
1928
1929
1930
1931
1932
1933
1934
1935
1936
1937
1938
1939
1940
1941
1942
1943
1944
1945
1946
1947
1948
1949
1950
1951
1952
1953
1954
1955
1956
1957
1958
1959
1960
1961
1962
1963
1964
1965
1966
1967
1968
1969
1970
1971
1972
1973
1974
1975
1976
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002
2003
2004
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
2027
2028
2029
2030
2031
2032
2033
2034
2035
2036
2037
2038
2039
2040
2041
2042
2043
2044
2045
2046
2047
2048
2049
2050
2051
|
<html lang="en">
<head>
<title>Heroes Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name=description content="Heroes Manual">
<meta name=generator content="makeinfo 4.1">
<link href="http://texinfo.org/" rel=generator-home>
</head>
<body>
<h1>Heroes Manual</h1>
<p><hr>
Node:<a name="Top">Top</a>,
Next:<a rel=next href="#Copying">Copying</a>,
Previous:<a rel=previous href="#dir">(dir)</a>,
Up:<a rel=up href="#dir">(dir)</a>
<br>
<h2>Heroes</h2>
<ul>
<li><a href="#Copying">Copying</a>: Your rights.
<li><a href="#Overview">Overview</a>: Heroes in brief and contact information.
<li><a href="#Installation">Installation</a>: Installing Heroes.
<li><a href="#Running">Running</a>: Running Heroes.
<li><a href="#heroeslvl">heroeslvl</a>: Inspect Heroes levels.
<li><a href="#Index">Index</a>: A menu covering many topics.
<p>--- The Detailed Node Listing ---
<p>Overview of Heroes
</p><li><a href="#Getting%20Heroes">Getting Heroes</a>: Where to download Heroes from.
<li><a href="#Mailing%20lists">Mailing lists</a>: Where to talk about Heroes..
<li><a href="#Bug%20Reporting">Bug Reporting</a>: Sending bugs, suggestions, contributions.
<li><a href="#People">People</a>: Contributors
<li><a href="#History">History</a>: History of the DOS version.
<p>Installation of Heroes
</p><li><a href="#Libraries">Libraries</a>: Libraries Heroes can link with.
<li><a href="#configure">configure</a>: Generic configure instructions.
<li><a href="#configure%20options">configure options</a>: Configure options specific to heroes.
<li><a href="#Relocatable%20package">Relocatable package</a>: Building a relocatable package.
<li><a href="#Machines">Machines</a>: Architectures where Heroes is known to work.
<p>Running Heroes
</p><li><a href="#Invoking%20heroes">Invoking heroes</a>: Heroes launch-time options.
<li><a href="#Environment">Environment</a>: Environment variables used by Heroes.
<li><a href="#heroesrc">heroesrc</a>: Heroes configuration file.
<li><a href="#Global%20score%20file">Global score file</a>: Sharing a global score file.
<li><a href="#Game">Game</a>: Game rules.
<li><a href="#Level%20editor">Level editor</a>: How to create new levels.
<li><a href="#Troubleshooting">Troubleshooting</a>: Common problems.
<p>Level editor
</p><li><a href="#editor-keys">editor-keys</a>: Key used in the level editor.
<li><a href="#editor-clicks">editor-clicks</a>: How mouse is used in the editor.
<li><a href="#tunnels">tunnels</a>: How to setup a tunnel.
<li><a href="#sprites">sprites</a>: How to setup a sprite.
<li><a href="#animations">animations</a>: How to setup animations.
<li><a href="#departures">departures</a>: How to setup departures.
<p><code>heroeslvl</code>
<p>
</p><li><a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>: heroeslvl launch-time options
</ul>
<p><hr>
Node:<a name="Copying">Copying</a>,
Next:<a rel=next href="#Overview">Overview</a>,
Previous:<a rel=previous href="#Top">Top</a>,
Up:<a rel=up href="#Top">Top</a>
<br>
<h2>Heroes Copying Conditions</h2>
<p>Heroes is "free"; this means that everyone is free to use it and free
to redistribute it on a free basis. Heroes is not in the public domain;
it is copyrighted and there are restrictions on its distribution, but
these restrictions are designed to permit everything that a good
cooperating citizen would want to do. What is not allowed is to try to
prevent others from further sharing any version of Heroes that they
might get from you.
<p>Specifically, we want to make sure that you have the right to give
away copies of Heroes, that you receive source code or else can get it
if you want it, that you can change Heroes or use pieces of it in new
free programs<a rel=footnote href="#fn-1"><sup>1</sup></a>, and that you know you can do these
things.
<p>To make sure that everyone has such rights, we have to forbid you to
deprive anyone else of these rights. For example, if you distribute
copies of Heroes, you must give the recipients all the rights that you
have. You must make sure that they, too, receive or can get the source
code. And you must tell them their rights.
<p>Also, for our own protection, we must make certain that everyone finds
out that there is no warranty for Heroes. If these programs are
modified by someone else and passed on, we want their recipients to know
that what they have is not what we distributed, so that any problems
introduced by others will not reflect on our reputation.
<p>The precise conditions of the license for Heroes are found in the
GNU General Public License that accompanies it.
<p><hr>
Node:<a name="Overview">Overview</a>,
Next:<a rel=next href="#Installation">Installation</a>,
Previous:<a rel=previous href="#Copying">Copying</a>,
Up:<a rel=up href="#Top">Top</a>
<br>
<h2>Overview of Heroes</h2>
<p>Heroes is similar to the "Tron" and "Nibbles" games of yore, but
includes many graphical improvements and new game features.
<p>In it, you must maneuver a small vehicle around a world and
collect powerups while avoiding obstacles, your opponents' trails, and even
your own trail.
<p>There are five game modes available. Quest is the classical Nibbles, in
Death Match you start with very long tails a must kill your opponents,
in Kill'em All you must run over lemmings moving on the ground, in
Time Cash or Color modes you must collect money or pyramids of color.
Heroes features 12 original sound tracks, 94 levels (in 10 different
tile sets) plus a level editor.
<p>Heroes source code originates from an original MS-DOS game but has been
heavily modified to enhance the portability and some new features have
been added. MS-DOS support has been lost by the meantime. The original
MS-DOS version can still be found on the Internet but is unmaintained and
should be considered obsolete.
<p>The current development focus on cleaning the code and port the game to
available operating systems. Our objective is to release the version
1.0 as a clean and portable base that would allow further important works
such as network support or programmable vehicles.
<ul>
<li><a href="#Getting%20Heroes">Getting Heroes</a>: Where to download Heroes from.
<li><a href="#Mailing%20lists">Mailing lists</a>: Where to talk about Heroes..
<li><a href="#Bug%20Reporting">Bug Reporting</a>: Sending bugs, suggestions, contributions.
<li><a href="#People">People</a>: Contributors
<li><a href="#History">History</a>: History of the DOS version.
</ul>
<p><hr>
Node:<a name="Getting%20Heroes">Getting Heroes</a>,
Next:<a rel=next href="#Mailing%20lists">Mailing lists</a>,
Previous:<a rel=previous href="#Overview">Overview</a>,
Up:<a rel=up href="#Overview">Overview</a>
<br>
<h3>Getting Heroes</h3>
<h4>Where to fetch new releases?</h4>
<p>Heroes development is powered by the free services offered by
SourceForge to the Open-Source community. The web page of Heroes is
<a href="http://heroes.sourceforge.net/">http://heroes.sourceforge.net/</a>.
<p>The latest releases of Heroes is always uploaded to SourceForge and
available from <a href="http://sourceforge.net/projects/heroes/">http://sourceforge.net/projects/heroes/</a>. Announces
are sent to the <code>heroes-announce</code> mailing list (see <a href="#Mailing%20lists">Mailing lists</a>).
<p>Source code releases are also uploaded to Ibiblio (formerly MetaLab, and
Sunsite)) in <code>/pub/linux/games</code>; see
<a href="http://ibiblio.org/pub/linux/MIRRORS.html">the Ibiblio mirror list</a>
to find your nearest mirror. You will have to wait three or four days
to have the files available on Ibiblio after a release.
<p>A public CVS server is also accessible. See<br>
<a href="http://sourceforge.net/cvs/?group_id=7982">http://sourceforge.net/cvs/?group_id=7982</a> for details.
<h4>What to download?</h4>
<p>Heroes is distributed as five packages with independent version
numbering and release schedule.
<dl>
<dt><code>heroes</code>
<dd>The source code, info file, and man page.
<br><dt><code>heroes-data</code>
<dd>The level data (level maps, sprites, etc.)
<br><dt><code>heroes-sound-tracks</code>
<dd>Sound tracks for the game (.xm files).
<br><dt><code>heroes-sound-effects</code>
<dd>The sound effects for the game (.wav files).
<br><dt><code>heroes-hq-sound-tracks</code>
<dd>High quality sound tracks (.xm files), they will replace some
sound-tracks from <code>heroes-sound-track</code>.
</dl>
<p>The two first packages are required, the others are optional.
<p>The game has been so split because the data and sound files are big
and don't evolve as often as the code does. It would therefore be unfair
to bloat the bandwidth by requiring the mirrors and users to download
everything on each release.
<p><hr>
Node:<a name="Mailing%20lists">Mailing lists</a>,
Next:<a rel=next href="#Bug%20Reporting">Bug Reporting</a>,
Previous:<a rel=previous href="#Getting%20Heroes">Getting Heroes</a>,
Up:<a rel=up href="#Overview">Overview</a>
<br>
<h3>Mailing lists.</h3>
<p>Three mailing lists are available for you to report bugs, discuss about
the game or get announcements of new releases.
<dl>
<dt><code>heroes-bugs@lists.sourceforge.net</code>
<dd>
<p>A public mailing list for bug reports.
<a href="http://lists.sourceforge.net/mailman/listinfo/heroes-bugs">subscription page</a>.
<br><dt><code>heroes-discuss@lists.sourceforge.net</code>
<dd>
<p>A public mailing list for discussion (questions, criticism,
suggestions, contributions, ...) on the game.
<a href="http://lists.sourceforge.net/mailman/listinfo/heroes-discuss">subscription page</a>.
<br><dt><code>heroes-announce@lists.sourceforge.net</code>
<dd>
<p>A read-only and low traffic list for announcements of Heroes releases.
Mails posted to this list are also forwarded to <code>heroes-discuss</code>
so you don't need to subscribe to both lists.
<a href="http://lists.sourceforge.net/mailman/listinfo/heroes-announce">subscription page</a>.
</dl>
<p><hr>
Node:<a name="Bug%20Reporting">Bug Reporting</a>,
Next:<a rel=next href="#People">People</a>,
Previous:<a rel=previous href="#Mailing%20lists">Mailing lists</a>,
Up:<a rel=up href="#Overview">Overview</a>
<br>
<h3>Reporting bugs, sending suggestions or contribution</h3>
<p>We welcome bug reports or suggestions for Heroes (either program,
documentation, or data files). This program will get better only if you
report the problems you encounter. Please email them to
<a href="mailto:heroes-bugs@lists.sourceforge.net">heroes-bugs@lists.sourceforge.net</a> or
<a href="mailto:heroes-discuss@lists.sourceforge.net">heroes-discuss@lists.sourceforge.net</a>. For bug reports, please
include enough information to reproduce the problem, if possible.
Useful information include:
<ul>
<li>the version number of Heroes.
<li>hardware, operating system (and OS distribution), and compiler versions.
<li>any unusual options you gave to `configure'.
<li>the actions necessary to reproduce the bug.
<li>a description of the problem (sometimes, a snapshot may be a
good description) and of the behavior you are expecting (this
is not always obvious for everyone)
<li>a trace of the game, as given by running Heroes with the
<code>HEROES_DEBUG</code> environment variable set (to <code>all</code>, for
instance).
<li>a stack trace of the crash, if you compiled the game with debugging
options (see below).
<li>anything else that you think would be helpful.
</ul>
<p>When in doubt whether something is needed or not, include it. It's
better to include too much than to leave out something important.
<p>To get useful core dumps, <code>./configure</code> with <code>--enable-debug</code>
and <code>--disable-sound</code>.
<p>Patches are most welcome; if possible, please make them with
<code>diff -u</code> (see <a href="diff.info.html#Unified%20Format">Unified Format</a>) or <code>diff -c</code> (see <a href="diff.info.html#Context%20Format">Context Format</a>) and include <code>ChangeLog</code> entries
(see <a href="emacs-e20.html#Change%20Log">Change Log</a>).
<p>When sending email, please do not encode or split the messages in any
way if possible; it's much easier to deal with one plain text message,
however large, than many small ones.
<p>Do not hesitate to contribute. This is YOUR game and the GPL allows
you to apply any modifications you want to the game (provided that you
keep those modifications under the GPL). There are numerous places
where you can contribute: you can hack the code (the TODO file can give
you ideas but should not be seen as a limit), design new levels, create
new drawings (e.g. new sets of tiles), track some new music or add your
personal touch here and there.
<p><hr>
Node:<a name="People">People</a>,
Next:<a rel=next href="#History">History</a>,
Previous:<a rel=previous href="#Bug%20Reporting">Bug Reporting</a>,
Up:<a rel=up href="#Overview">Overview</a>
<br>
<h3>People</h3>
<p>Heroes would not be what it is presently without the following people.
<h4>Authors</h4>
<ul>
<li><a href="mailto:duret_g@epita.fr">Alexandre Duret-Lutz</a>
<p>Wrote the original source code, ported it to GNU/Linux
and created a few levels.
</p><li><a href="mailto:rgenevois@besancon.net">Romual Genevois</a>
<p>Had the idea of that game, designed most of it,
drew the graphics, created most of the levels.
</p><li><a href="mailto:alex.livernaux@wanadoo.fr">Alexandre Liverneaux</a>
<p>Composed the soundtracks.
</p><li><a href="mailto:philmeis@mail.dotcom.fr">Philippe Meisburger</a>
<p>Composed the soundtracks and created some levels.
</ul>
<h4>Contributors</h4>
<ul>
<li><a href="mailto:octplane@via.ecp.fr">Pierre Baillet</a>
<p>Support for non-8bits depth video mode with LibGGI.
</p><li><a href="mailto:uh1763@bingo-ev.de">Uwe Hermann</a>
<p>Clean-ups and portability fixes.
</p><li><a href="mailto:inguin@gmx.de">Ingo van Lil</a>
<p>Latin-1 characters in fonts.
</ul>
<h4>Translators</h4>
<ul>
<li><a href="mailto:beckers@st-oneline.de">Hermann J. Beackers</a> (German)
<li><a href="mailto:joshb@xs4all.nl">Jos Boersema</a> (Dutch)
<li><a href="mailto:luza.solucao@uol.com.br">Luzemario Dantas Rocha</a> (Brazilian Portuguese)
<li><a href="mailto:alessandro.dotti@libero.it">Alessandro Dotti</a> (Italian)
<li><a href="mailto:duret_g@epita.fr">Alexandre Duret-Lutz</a> (French)
<li><a href="mailto:inguin@gmx.de">Ingo van Lil</a> (German)
</ul>
<h4>Packagers</h4>
<ul>
<li><a href="mailto:Daniel_Burrows@brown.edu">Daniel Burrows</a> (Debian GNU/Linux)
<li><a href="mailto:delvare@ensicaen.ismra.fr">Jean Delvare</a> (RPM & Slackware Linux)
<li><a href="mailto:eloli@hotmail.com">Eugenia Loli-Queru</a> (BeOS)
<li><a href="mailto:pixel@mandrakesoft.com">Pascal Rigaux</a> (Linux-Mandrake)
<li><a href="mailto:sobomax@FreeBSD.org">Maxim Sobolev</a> (FreeBSD)
</ul>
<h4>Porters</h4>
<ul>
<li><a href="mailto:S.Denis@darkworks.com">Stéphane Denis</a> (Win/Visual C)
<li><a href="mailto:f91-men@nada.kth.se">Mattias Engdegård</a> (Solaris)
<li><a href="mailto:sobomax@FreeBSD.org">Maxim Sobolev</a> (FreeBSD)
</ul>
<p>More people are listed in the file <code>THANKS</code> at the top level
of the Heroes tarball.
<p><hr>
Node:<a name="History">History</a>,
Previous:<a rel=previous href="#People">People</a>,
Up:<a rel=up href="#Overview">Overview</a>
<br>
<h3>History of the DOS version</h3>
<p>The next paragraphs are extracted from the DOS version of Heroes.
<p>We started this game in summer 96. The idea came form Guen. At this
moment, we were only three: Guen, Toalnkor (now known as Tnk) and me
(Pollux); Alexel joined us one year later. The development was going
quite slow (it took us two years actually) mainly because of our studies.
Maybe the fact that Guen and me communicated by (snail-)mail was another
slowing down factor. I sent more than 60 letters to Guen during this two
years ! During the first year, we decided to sell the game. We made a
demo version (with only 10 levels, no editor, and an order form), and a
CD version (with songs remixed on audio track, but not used in the game).
Our main issue was the price of Midas' license (the sound engine used);
we were also hesitating on the way we should distribute Heroes (shall we
do it shareware or commercial ?). Finally, after a couple of wasted months
we decided to spread it freeware (Enjoy !), because we thought that no
one would really like to buy such a game today; today where 3D rules.
<p>Now let's talk about the content of the game. At first, Tnk decided to
make some four channels songs in the old original mod format. As there
were only two scores done and we were waiting for the next tunes, we used
some songs from Clawz just to vary. These were 'overtaking' and
'hibakusha2' and gave a better taste to the game. So we removed old
Tnk's songs and he was asked to make some more Clawz-like musics. By the
time, Alexel joined and came with 10 channels XM, thus all tunes are now
8 or 10 channels XM... There were 13 tunes in the game (for a total of
2.88Mb unpacked), these are the intro tune, the menu tune, the 10 levels,
and the end tune (you can't hear the later without finishing the quest
game); most of them have been done by Alexel.
<p>All sprites and pictures were drawn by Guen. He first made some
level-tiles and a set of hand-done previews of the game before any other
work get started (I guess he has a few other projects at this state of
development at home). These screens and tiles were used to make the level
editor. Actually I learned C while making this editor so there is some
piece of code I am not proud of into (and also in the game). When it was
nearly done, I started to code the game. The first thing done was the
introduction, and then came the multi-directional scroller. I remember
that the first level which was loaded was sized 4x4 and wrapped in all
directions; this was very small but at this time there were no tails and
the vehicles were crossing the walls...
<p>Most of the levels were done by Guen. But Tnk and I also did some.
Guen made a cleanup of all the levels we made: some were relegated in
the EXTRALVL directory, other were simply erased. We aimed to spread
the game with 100 of them, but as it is going late and that we are not
going to sell the game anymore I don't know how many levels there will be.
<p><hr>
Node:<a name="Installation">Installation</a>,
Next:<a rel=next href="#Running">Running</a>,
Previous:<a rel=previous href="#Overview">Overview</a>,
Up:<a rel=up href="#Top">Top</a>
<br>
<h2>Installation of Heroes</h2>
<ul>
<li><a href="#Libraries">Libraries</a>: Libraries Heroes can link with.
<li><a href="#configure">configure</a>: Generic configure instructions.
<li><a href="#configure%20options">configure options</a>: Configure options specific to heroes.
<li><a href="#Relocatable%20package">Relocatable package</a>: Building a relocatable package.
<li><a href="#Machines">Machines</a>: Architectures where Heroes is known to work.
</ul>
<p><hr>
Node:<a name="Libraries">Libraries</a>,
Next:<a rel=next href="#configure">configure</a>,
Previous:<a rel=previous href="#Installation">Installation</a>,
Up:<a rel=up href="#Installation">Installation</a>
<br>
<h3>Needed Libraries</h3>
<p>Heroes can be configured to use several libraries to handle display,
sound output and joystick support. Following is a list of supported
libraries (hopefully you won't have to install all of them but just a
subset).
<ul>
<li>LibGGI (General Graphic Interface) can be used as a display and keyboard
driver. Get it from <a href="http://www.ggi-project.org/">http://www.ggi-project.org/</a>.
<li>LibGII (General Input Interface) will provide joystick support (the game
can be compiled without). Get it from
<a href="http://www.ggi-project.org/">http://www.ggi-project.org/</a>. It is needed by LibGGI, by the way.
<li>SDL can be used as a display and keyboard driver. Recent revisions will
also provide support for joysticks. Get it from
<a href="http://www.libsdl.org/">http://www.libsdl.org/</a>.
<li>Allegro, a game programming library, can be used as a display, keyboard,
and joystick driver. <a href="http://alleg.sourceforge.net/">http://alleg.sourceforge.net/</a>.
<li>LibMikMod is a sound library. You don't need it if you want to compile
Heroes without sound support. Get it from <a href="http://www.mikmod.org/">http://www.mikmod.org/</a>
or from <a href="ftp://ftp.ibiblio.org/pub/linux/apps/sound/libs/">ftp://ftp.ibiblio.org/pub/linux/apps/sound/libs/</a>. If you
install LibMikMod from sources you may want to compile LibMikMod without
Alsa support (see <a href="#Troubleshooting">Troubleshooting</a>).
<li>SDL_Mixer is an alternative sound engine that can be used only if you
use SDL as display driver. You don't need it if you want to compile
Heroes without sound support. Get it from
<a href="http://www.devolution.com/~slouken/SDL/projects/SDL_mixer/">http://www.devolution.com/~slouken/SDL/projects/SDL_mixer/</a>.
</ul>
<p>To summarize, install at least LibGGI, SDL, or Allegro to get video
output and keyboard handling. Install LibGII to get joystick support,
unless you use a recent SDL or Allegro. And install LibMikMod (or
SDL_mixer if you have SDL) if you want sound output.
<p>My personal preference goes to LibGGI/LibGII and LibMikMod which give
you more control over the drivers used. On the other hand, SDL seems
better at doing full screen display and is maintained actively. Allegro
is quite new on Unix.
<p>Heroes also supports memory debugging libraries, such as <code>dmalloc</code> or
<code>efence</code>. See the <code>--enable-mem-debug</code> option in section
<a href="#configure%20options">configure options</a>.
<p><hr>
Node:<a name="configure">configure</a>,
Next:<a rel=next href="#configure%20options">configure options</a>,
Previous:<a rel=previous href="#Libraries">Libraries</a>,
Up:<a rel=up href="#Installation">Installation</a>
<br>
<h3>configure generic instructions</h3>
<p>To be filled.
<p><hr>
Node:<a name="configure%20options">configure options</a>,
Next:<a rel=next href="#Relocatable%20package">Relocatable package</a>,
Previous:<a rel=previous href="#configure">configure</a>,
Up:<a rel=up href="#Installation">Installation</a>
<br>
<h3>configure options for Heroes</h3>
<p><code>configure</code> will do its best to find the libraries and functions
needed by the game. Still, you may give several options to
<code>configure</code> to help it, or to fine tune special features of Heroes.
<dl>
<dt><code>--enable-html-doc[=DIR]</code>
<dd>Build and install html documentation in directory <code>DIR</code>.
If <code>DIR</code> is not given, install in <code>$datadir/heroes/doc</code>.
<br><dt><code>--disable-sound</code>
<dd>Turn off sound support. Sound is enabled by default,
unless no sound engine is found).
<br><dt><code>--disable-joystick</code>
<dd>Do not include joystick support in the game. Joystick support is enabled
by default, unless you don't have GII or joystick support in SDL.
<br><dt><code>--with-sdl[=DIR]</code>
<dd>Specify that you want to link with SDL. This is the default if LibGGI is
not installed. If you installed SDL in some non-standard place, you can
specify the installation path as an argument. For example:
<br><pre>./configure --with-sdl=/home/adl/usr
</pre>
<code>configure</code> will then look for <code>/home/adl/usr/bin/sdl-config</code>
and configure Heroes accordingly.
<br><dt><code>--with-ggi[=DIR]</code>
<dd>Link with LibGGI. This is the default if LibGGI is installed.
If you installed LibGGI in some non-standard place, you can
specify the installation path as an argument
<br><dt><code>--with-allegro[=DIR]</code>
<dd>Link with Allegro. This is the default is neither LibGGI not SDL can be
used. If you installed Allegro in some non-standard place, you can
specify the installation path as an argument
<br><dt><code>--with-mikmod[=DIR]</code>
<dd>Use LibMikMod four sound output. This is the default if LibMikMod is
installed and LibGGI have been selected. You may specify where
LibMikMod is installed using the optional argument.
<br><dt><code>--with-sdl-mixer[=DIR]</code>
<dd>Use SDL_mixer for sound output. This is the default if SDL_mixer is
installed and SDL has been selected. You may specify where SDL_mixer is
installed using the optional argument. Using this option implies
<code>--with-sdl</code>.
<br><dt><code>--disable-heroes-debug</code>
<dd>Turn off tracing support. See the description of the <code>HEROES_DEBUG</code>
variable (see <a href="#Environment">Environment</a>). This is enabled by default to facilitate
bug reporting. Using this options should reduce the size of the
resulting binary, and speed up the game by an indiscernible amount.
</dl>
<p>The following options are for developing purpose. The default
configuration should be suitable for end users (i.e. players) but people
attempting to hack the code may want debugging symbols or compiler
warnings.
<dl>
<dt><code>--enable-debug</code>
<dt><code>--disable-debug</code>
<dd>This is a three state option. The default is to compile with debugging
symbols: this produce bigger binaries but allow to get helpfull
coredumps, without slowing down the game. You may want to use
<code>--enable-debug</code> to include more debugging data and turn on some
debugging code. Use <code>--disable-debug</code> to turn this off.
Translators: you <em>do want</em> to turn this option on, really! Because
the debugging code includes some checks on the translated messages.
<br><dt><code>--disable-optimizations</code>
<dd>Turn off compiler optimizations options. This can ease debugging.
If you want to supply your own optimizations options, use
something like <code>--enable-optimizations='-O3 -march=pentium'</code>.
<br><dt><code>--enable-warnings</code>
<dd>Try to turn on a large bunch of compiler warnings.
<br><dt><code>--enable-assert</code>
<dd>Turn on some assertions squattered over the source code.
This can slow down things a bit.
<br><dt><code>--enable-devel</code>
<dd>Is a shorthand for <code>--enable-debug --disable-optimizations --enable-warnings --enable-assert</code>.
<br><dt><code>--with-mpatrol</code>
<dd>Link with MPatrol, a <code>malloc()</code> debugger.
<br><dt><code>--with-mtrace</code>
<dd>Use GNU libc's <code>mtrace()</code> facility to check <code>malloc()</code> usage.
<br><dt><code>--with-dmalloc</code>
<dd>Link with Dmalloc, a <code>malloc()</code> debugger.
<br><dt><code>--with-efence</code>
<dd>Link with Electric Fence, a <code>malloc()</code> debugger.
<br><dt><code>--enable-mem-debug</code>
<dd>Check for <code>mtrace()</code>, Dmalloc, or Electric Fence. Use the first found.
<br><dt><code>--enable-gprof</code>
<dd>Enable profiling support with <code>gcc</code>, you need <code>gprof</code> to
inspect the file resulting from a run of Heroes.
<br><dt><code>--disable-display</code>
<dd>This disable all screen output, making the game rather unplayable.
This suppress decencies over third party libraries like GGI or SDL,
therefore you may find it useful with some debugging tools like
checkergcc.
</dl>
<p><hr>
Node:<a name="Relocatable%20package">Relocatable package</a>,
Next:<a rel=next href="#Machines">Machines</a>,
Previous:<a rel=previous href="#configure%20options">configure options</a>,
Up:<a rel=up href="#Installation">Installation</a>
<br>
<h3>Building a relocatable package</h3>
<p><dfn>Relocation</dfn> refers to the ability to install or move the
game in a directory which is different from the one it has been configured
for. This usually happens if you create a binary package for Heroes and
don't know in advance where the user will unpack it. This section
describe how Heroes find for his files, in order to allow relocatable
packages. Most people don't need to read this section, only packagers
might be interested.
<p>The values of the <code>./configure</code> options you used to specify
directories (such as <code>--prefix</code>, <code>--bindir</code>, or
<code>--datadir</code>) are all transformed into paths relative to
<var>prefix</var> and then hardcoded into the Heroes binary. Because
Heroes uses only paths relative to <var>prefix</var>, the relocation
process is just a matter of guessing the correct value of <var>prefix</var>
at runtime. This guess is done using various informations
available: first the original value of <var>prefix</var> is tried, then
<var>prefix</var> is computed from the path to the current binary
(<code>argv[0]</code>) when available, then the content of the environment
variable <code>PATH</code> is used to find the binary and derive <var>prefix</var>,
finally Heroes assumes it is running from the <var>bindir</var> directory.
The whole process is not garanteed to succeed, but you can also
override those paths with some enivronment variables (see <a href="#Environment">Environment</a>).
<p><hr>
Node:<a name="Machines">Machines</a>,
Previous:<a rel=previous href="#Relocatable%20package">Relocatable package</a>,
Up:<a rel=up href="#Installation">Installation</a>
<br>
<h3>Machines</h3>
<p>Heroes has been reported to compile and run on the following
architectures. Since Heroes can use SDL, GGI, or Allegro as display
driver, the following list shows the driver which was used.
<dl>
<dt>Linux/i386 (GGI, SDL, or Allegro)
<dd>Should build out of the box. Packages for some Linux distributions
are available from the web pages.
<p>Suse 7.1 users, the libc shipped with your distribution (glibc-2.2-7)
will crash every time Heroes calls the <code>ngettext()</code> function. The
workaround is to configure Heroes with <code>configure
--with-included-gettext</code> so that it uses its own version of
<code>ngettext()</code>.
<p>Red Hat 7.0 users, the compiler shipped with your distribution (packaged
as <code>gcc-2.96-54.i386.rpm</code>) is an experimental version which is
still <em>bugged</em> despite the pile of fixes applied. It actually
produces unfaithful code for Heroes, so please use another compiler.
Either upgrade to a newer version (<code>gcc-2.96-64.i386.rpm</code> is known
to work) or use the one provided by the <code>kgcc</code> package.
<br><dt>Linux/m68k (SDL)
<dd>Is reported to work when the sound (<code>SDL_mixer</code>) is disabled
(<code>configure --disable-sound</code> or <code>heroes -S</code>). Any feedback on
this issue is welcome. See also the <code>BUGS</code> file.
<br><dt>FreeBSD (SDL)
<dd>Should build out of the box.
Packages are available from the web pages.
<br><dt>Solaris (SDL)
<dd>Should build out of the box.
<br><dt>Win32/MinGW32 (SDL)
<dd>Can be cross-compiled (native compilation untested). The script used to
cross build the Heroes package available on the web page is in the
subdirectory <code>arch/mingw32</code>.
<br><dt>Win32/VisualC (SDL)
<dd>See the files in the <code>arch/VisualC</code> subdirectory of the Heroes CVS
tree. We used to distribute these files along with the rest of the
sources, but stopped because they are now completely out-of-date (they
have not been updated since version 0.7). However you can use them as a
start point if you think about compiling Heroes with MSVC.
<br><dt>Digital Unix (GGI)
<dd>Should build out of the box.
<br><dt>NetBSD (SDL)
<dd>I had to tweak SDL 1.1.6 to get it working, and also force Heroes'
configure to use the result of <code>sdl-config --static-libs</code> instead
of <code>sdl-config --libs</code>. Both issues should be fixed today (FIXME:
need to check).
<br><dt>OpenBSD 2.9 (GGI & SDL)
<dd>It looks like some configure hints need to be given when using either libs.
<p>A build of Heroes configured with GGI will apperently complete
successfully, however the resulting binary fails to load, with the
dynamic loader complaining about a missing symbol from libpthread. So
you'd rather configure Heroes with
<br><pre>./configure --with-ggi=/usr/local LDFLAGS=-pthread
</pre>
Then Heroes appears to work fine.
<p>If you prefer to use SDL, things are different. I had to configure Heroes with
<br><pre>./configure --with-sdl=/usr/local LDFLAGS=-L/usr/X11R6/lib X11BASE=/usr/X11R6
</pre>
Unfortunately, the resulting binary froze when initializing SDL (in
<code>SDL_init()</code>). Please send us a note if you are luckier.
FIXME: Look how other packages using SDL are built, I'm probably missing
something.
<br><dt>IRIX 6.5 (SDL)
<dd>Heroes 0.7 has been reported to compile and run with SDL 1.1.3 and
<code>gcc</code> + libraries from <code>freeware.sgi.com</code> on IRIX 6.5.
<br><dt>BeOS (SDL)
<dd>Heroes 0.9 has been reported to compile and run out of the box.
</dl>
<p>If you got Heroes working on a platform which is not listed here, please
send a notice to <a href="mailto:heroes-discuss@lists.sourceforge.net">heroes-discuss@lists.sourceforge.net</a>.
<p><hr>
Node:<a name="Running">Running</a>,
Next:<a rel=next href="#heroeslvl">heroeslvl</a>,
Previous:<a rel=previous href="#Installation">Installation</a>,
Up:<a rel=up href="#Top">Top</a>
<br>
<h2>Running Heroes</h2>
<ul>
<li><a href="#Invoking%20heroes">Invoking heroes</a>: Heroes launch-time options.
<li><a href="#Environment">Environment</a>: Environment variables used by Heroes.
<li><a href="#heroesrc">heroesrc</a>: Heroes configuration file.
<li><a href="#Global%20score%20file">Global score file</a>: Sharing a global score file.
<li><a href="#Game">Game</a>: Game rules.
<li><a href="#Level%20editor">Level editor</a>: How to create new levels.
<li><a href="#Troubleshooting">Troubleshooting</a>: Common problems.
</ul>
<p><hr>
Node:<a name="Invoking%20heroes">Invoking heroes</a>,
Next:<a rel=next href="#Environment">Environment</a>,
Previous:<a rel=previous href="#Running">Running</a>,
Up:<a rel=up href="#Running">Running</a>
<br>
<h3><code>heroes</code> options</h3>
<p>Heroes call be launched with various options.
<dl>
<dt><code>-v</code>
<dt><code>--version</code>
<dd>Display Heroes version number and copyright informations.
<br><dt><code>-h</code>
<dt><code>--help</code>
<dd>Print a help message about these run-time options.
<br><dt><code>-q</code>
<dt><code>--quiet</code>
<dd>Disable warning messages. This can be useful on platform
such as Windows were such messages will pop up a text window.
<br><dt><code>-Q</code>
<dt><code>--really-quiet</code>
<dd>Same as <code>-q</code>, but disable error messages too.
<br><dt><code>-vOPTIONS</code>
<dt><code>--verbose=CHANNELS</code>
<dd>Enable debugging output. <code>CHANNELS</code> can take the same
values as <code>HEROES_DEBUG</code> (see <a href="#Environment">Environment</a>).
<br><dt><code>-lWORD</code>
<dt><code>--list=WORD</code>
<dd>
<p>Show various internal information. <code>WORD</code> can be <code>debug</code>,
<code>levels</code>, <code>preferences</code>, <code>resources</code>,
<code>sound-drivers</code>, or <code>sound-tracks</code>.
<p><code>--list=debug</code> will list the available debugging channel, to be used
with <code>--verbose</code> or <code>HEROES_DEBUG</code> (see <a href="#Environment">Environment</a>).
<p><code>--list=levels</code> displays the list of installed levels (only the
game levels, not the extra levels).
<p><code>--list=sound-drivers</code> is used to print LibMikMod's drivers list.
The expected output is something like this:
<br><pre>% heroes --list=sound-drivers
LibMikMod version 3.1.7
Available drivers:
1 Enlightened sound daemon (EsounD) driver v0.2.12
2 Advanced Linux Sound Architecture (ALSA) driver v0.3.2
3 Open Sound System driver v1.5
4 Raw disk writer (music.raw) v1.1
5 Wav disk writer (music.wav) v1.2
6 Piped Output driver v0.1
7 Standard output driver v1.1
8 Nosound Driver v3.0
</pre>
<p><code>--list=resources</code> will dump the list of file resources. File
resources are kinds of aliases used internally to name files and
directories. They can be overwritten in you configuration file using
the <code>setrsc:</code> command. This command will also list the original
(default) value of the resource if it has been overwritten.
<p><code>--list=sound-tracks</code> will print the list of sound-tracks used
in the game in a format compatible with the <code>soundconf:</code> command
(see <a href="#heroesrc">heroesrc</a>).
<p><code>--list=preferences</code> will print the preferences and their values,
as they would be saved in <code>~/.heroes/preferences</code>.
<br><dt><code>-d N[,OPTIONS]</code>
<dt><code>--driver=N[,OPTIONS]</code>
<dd>With LibMikMod, specify the driver to use. <code>N</code> is the number of the
driver taken from the output of <code>heroes --list=sound-drivers</code>. Use
<code>0</code> for auto-detection. Additional options can be given to the
driver, see LibMikMod's <code>README</code> file.
<p>With SDL_mixer, override some audio parameters. <code>freq</code> and
<code>buffers</code> are the two recognized parameters. Example
<br><pre>heroes -d freq=11050:buffers=512
</pre>
<br><dt><code>-S</code>
<dt><code>--no-sound</code>
<dd>Disable sound output completely (both sound tracks and sound effects).
<br><dt><code>-X</code>
<dt><code>--no-sfx</code>
<dd>Disable sound effects only.
<br><dt><code>-m</code>
<dt><code>--mono</code>
<dd>Output sound in one single channel. This has no effect if the game is
compiled without sound support, of course.
<br><dt><code>-8</code>
<dt><code>--8bits</code>
<dd>Output sound in 8bits, rather than 16. You will need this option if you
have an old sound card that can't play 16bits samples.
<br><dt><code>-i</code>
<dt><code>--high-quality</code>
<dd>When compiled with MikMod, use the high quality software mixer. This
mixer is somewhat more expensive, but you can expect a better sound
quality. When compiled with SDL_mixer, output sound in 44kHz instead
of 22kHz.
<br><dt><code>-G OPTIONS</code>
<dt><code>--gfx-options=OPTIONS</code>
<dd>Give additional options to the display driver.
<p>With GGI applications, the usual way to force the selection of a driver
is to define the <code>GGI_DISPLAY</code> environment variable. The usage and
possible values of this variable are documented in the file
<code>target.txt</code> which comes with LibGGI. If Heroes has been compiled
with GGI, the option <code>-G</code> will bypass the setting of
<code>GGI_DISPLAY</code>, as if the variable was overwritten. For instance
<br><pre>% heroes -G 'tile:0,0,160,200,(x):160,0,160,200,(x)'
</pre>
is equivalant to
<br><pre>% export GGI_DISPLAY='tile:0,0,160,200,(x):160,0,160,200,(x)'
% heroes
</pre>
except that the former does not modify <code>GGI_DISPLAY</code>. (BTW, the
above setting uses GGI's tile driver to display Heroes in two
half-windows... this maybe quite fun to try in two player mode.)
<p>It is also possible to prevent Heroes' GGI driver to request a 8 bit
mode with <code>-G not8</code>. This is necessary on some uncommon X setup
to workaround a bug in GGI (see <a href="#Troubleshooting">Troubleshooting</a>). Other legitimate
GGI settings maybe supplied after a colon, as in <code>-G not8:x</code>.
<p>As SDL applications are concerned, selection of the video driver is
achieved through the <code>SDL_VIDEODRIVER</code> environment variable. At
the time of writting this is not documented in SDL, so you will have to
either RTFS or guess the possible values. If Heroes has been compiled
with SDL, the option <code>-G</code> with override the setting of
<code>SDL_VIDEODRIVER</code>. For instance you could force SDL to use
the X11 driver with
<br><pre>% heroes -G x11
</pre>
or
<br><pre>% export SDL_VIDEODRIVER=x11
% heroes
</pre>
<br><dt><code>-F</code>
<dt><code>--full-screen</code>
<dd>If Heroes is compiled with SDL, this option will turn on full screen mode.
<p>Otherwise, if Heroes is compiled with GGI, this option will allow Heroes
to use a video mode with any size; i.e., the video surface is not
constrained to 320x200 and Heroes will just center its 320x200 output.
The rational is that GGI's DGA driver doesn't switch video modes. So
unless your X server run in 320x200 it would be hard to use the DGA
driver otherwise. Here is the typical settings for "full-screen" DGA
output:
<br><pre>% heroes -G dga -F
</pre>
Admittedly the name of <code>--full-screen</code> is quite misleading here
since this option can provide you with a 320x200 stamp centered on your
1600x1200 display...
<br><dt><code>-2</code>
<dt><code>--double</code>
<dd>Stretch the game twofold before blitting to screen. This is slow.
<br><dt><code>-3</code>
<dt><code>--triple</code>
<dd>Stretch the game threefold before blitting to screen. This is even slower.
<br><dt><code>-4</code>
<dt><code>--quadruple</code>
<dd>Stretch the game fourfold before blitting to screen. This has been
requested by people which can run <code>heroes -3</code> smoothly.
<br><dt><code>-e</code>
<dt><code>--even-lines</code>
<dd>Display only even lines, leaving blank scan lines
as on real arcade monitors. This will contribute to make
options <code>-2</code>, <code>-3</code> and <code>-4</code> faster.
<br><dt><code>--cpu-off</code>
<dd>Disable computer opponents driving. The opponents are still there
(there will always be four players) but they are no more driven: they
turn when they hit wall. You won't want to use this options, it is here
for historical reason: when the game was started in 1996 this used to
suppress some overhead on slow machines.
<br><dt><code>--default-scores</code>
<dt><code>--default-options</code>
<dt><code>--default-saves</code>
<dd>Don't read the corresponding file, but use default value instead.
The files will be saved at the end of the game anyway, so you can
use these options to revert the default value of the given file.
Another way to do this is simply to delete the file, it will be
created the next time Heroes run.
<br><dt><code>-s</code>
<dt><code>--swap-sides</code>
<dd>Swap sides when playing in two player mode. The default is to have
player one on the right and player two on the left, because the default
key bindings use the arrows for player one and left letters keys for
player two.
<br><dt><code>--no-double-fx</code>
<dd>Disable superposition of rotozoom and waves. This is also a prehistoric
option. These two visual effects lead to a small overhead that one may
not want to combine on a slow host.
<br><dt><code>-g</code>
<dt><code>--go</code>
<dd>Skip the game introduction, start right on the main menu.
<br><dt><code>-J</code>
<dt><code>--no-joystick</code>
<dd>Disable joystick handling. Most of the time you will use this because
you don't have a joystick and are annoyed by the warning message output
when heroes start.
</dl>
<p><hr>
Node:<a name="Environment">Environment</a>,
Next:<a rel=next href="#heroesrc">heroesrc</a>,
Previous:<a rel=previous href="#Invoking%20heroes">Invoking heroes</a>,
Up:<a rel=up href="#Running">Running</a>
<br>
<h3>Environment variables</h3>
<h4><code>HEROES_DEBUG</code></h4>
<p>The very first action of Heroes when it starts is to look the
environment for a <code>HEROES_DATA_DIR</code> variable. If Heroes has been
compiled with the <code>--enable-heroes-debug</code> configure option (which
is the default), this variable specify the kind of debug messages that
should be printed out. Possible values are the following (they can
be printed using the <code>--list=debug</code> option).
<dl>
<dt><code>SECTION</code>
<dd>The different parts of the game (introduction,
demonstration, menus, ...).
<br><dt><code>SYSTEM</code>
<dd>Handling of environment variables, creation of
directories, initialization of libraries.
<br><dt><code>RESOURCE</code>
<dd>Filename Resources Handling.
<br><dt><code>FILE</code>
<dd>Files And Directories Handling.
<br><dt><code>LEVEL</code>
<dd>Levels Handling.
<br><dt><code>SOUND_TRACK</code>
<dd>Sound Track Events.
<br><dt><code>SOUND_EFFECT</code>
<dd>Sound Effects Events.
<br><dt><code>VIDEO</code>
<dd>Events related to the display interface.
<br><dt><code>JOYSTICK</code>
<dd>Joystick Initialization And Events.
<br><dt><code>TIMER</code>
<dd>Timer Handling.
<br><dt><code>MISC</code>
<dd>Miscellaneous Events.
<br><dt><code>FADER</code>
<dd>Palette Fade Events.
<br><dt><code>BONUS</code>
<dd>Bonus handling.
<br><dt><code>ALL</code>
<dd>All of the above.
</dl>
<p>Multiple values can be separated by <code>:</code>, and a value is negated if
prefixed by <code>-</code>. For example the following command line sets
<code>HEROES_DEBUG</code> so that all messages get printed except those
related to timer handling.
<br><pre>export HEROES_DEBUG=all:-timer
</pre>
<h4><code>HEROES_PREFIX</code></h4>
<p>The <code>HEROES_PREFIX</code> indicate the base directory where
Heroes was installed. It is equivalant to the <code>--prefix</code>
option of <code>configure</code>. This variable is not found the default prefix
(configured at build time) will be used, usually this is something
like <code>/usr/local</code> or <code>/usr</code>.
Type <code>heroes --list=resources | grep prefix</code> to
see the value actually used by Heroes.
<p>Most people don't need to set this variable. This is only useful if
you got Heroes as a binary distribution and want to move files around.
<h4><code>HEROES_DATA_DIR</code></h4>
<p>The <code>HEROES_DATA_DIR</code> variable may specify the path were the data
files are located. It thus allows you to relocate the data file. If
this variable is not found the default path (configured at build time)
will be used. Run <code>heroes --list=resources | grep data-dir</code> to
see the value actually used by Heroes.
<p>The path to datafiles is adjusted automatically if you set
<code>HEROES_PREFIX</code> (because it is a subdirectory of
<code>HEROES_PREFIX</code>), so most people don't need to set
<code>HEROES_DATA_DIR</code>.
<h4><code>HEROES_LOCALE_DIR</code></h4>
<p>The <code>HEROES_LOCALE_DIR</code> variable override the path were the message
catalogs are looked for. The default value is hardcoded into the
Heroes binary, and you can see it if you run
<code>heroes --list=resources | grep locale-dir</code>.
<p>As for <code>HEROES_DATA_DIR</code>, changing <code>HEROES_PREFIX</code>
is usually enough because <code>HEROES_LOCALE_DIR</code> is a subdirectory
of <code>HEROES_PREFIX</code>.
<h4><code>HOME</code></h4>
<p>The <code>HOME</code> variable is used to locate your home directory.
You can also use <code>HEROES_HOME</code>.
<p><hr>
Node:<a name="heroesrc">heroesrc</a>,
Next:<a rel=next href="#Global%20score%20file">Global score file</a>,
Previous:<a rel=previous href="#Environment">Environment</a>,
Up:<a rel=up href="#Running">Running</a>
<br>
<h3><code>~/.heroes/heroesrc</code></h3>
<p>Each time you start heroes, it tries to read the system-wide
configuration file <code>heroesrc</code> (in the <code>$datadir/heroes/etc/</code>
directory) and from the <code>~/.heroes/heroesrc</code> in your home
directory.
<h4><code>option:</code></h4>
<p>You can specify options in that file, they will be processed before any
options given on the command line. Put the word <code>Options:</code> in
front of a line, and write the options after (separated by spaces, as on
the command line, except that there is no quoting or variable
substitution). For example, if you want that Heroes always skip the
introduction, and swap the player sides, add the following line to your
<code>~/.heroes/heroesrc</code>:
<br><pre>Options: -g -s
</pre>
<p>Multiple <code>Options:</code> lines can be given, they are processed in order.
<h4><code>setenv:</code></h4>
<p>You can also have line starting with <code>setenv:</code>, followed by a
variable name and a value (the rest of the line, after the variable name
is taken as the value). This will setup the corresponding environment
variable. This provide a way to configure the used libraries. For example, to
instruct SDL to use its DGA driver, use the following line:
<br><pre>setenv: SDL_VIDEODRIVER dga
</pre>
<p>This may seam redundant with <code>--gfx-options</code> and <code>--driver</code> but
can be used to configure other libraries. For example, setup GGI or SDL to
use AAlib (the ASCII art rendering library) and configure AAlib via its
<code>AAOPTS</code> variable.
<h4><code>extradir:</code></h4>
<p>Lines starting with <code>extradir:</code> are used to specify
additional extra levels directories.
<h4><code>soundconf:</code></h4>
<p>The <code>soundconf:</code> lines are used to introduce configuration files
defining the sound tracks played by the game. The format of such files
is as follow:
<br><pre>ALIAS:FILENAME:TITLE:AUTHOR
...
</pre>
Where <code>ALIAS</code> is the name of the sound track used internally by
Heroes, <code>FILENAME</code> is the filename of the sound track
you want to be loaded, <code>TITLE</code> is the title of the sound track, and
<code>AUTHOR</code> is the person who tracked that music.
<p>You may give several definitions for the same alias, in which case only
the latest will be used (and of course your configuration file is read
after heroes has setup its default aliases so you can overwrite them).
<p>Presently the set of used aliases include
<code>INTRO</code>,<code>MENU</code>,<code>HEROES01</code>,<code>HEROES02</code>,...,<code>HEROES10</code>,
and <code>ENDSCROLL</code>. You can overwrite them, but you can also define
your own aliases: they will be available in the jukebox menu.
<p>To give one full example, imagine you want to hear
<code>/music/2nd-reality.s3m</code> when you are playing Heroes in
the second world (desert and pyramids). What you do is this
<br><pre>% cd ~/.heroes
% echo "HEROES02:/music/2nd-reality.s3m:\
Second Reality:Purple Motion" > mymod
% echo "soundconf: /home/adl/.heroes/mymod" >> heroesrc
</pre>
<p>In this example, the configuration file has been put in the <code>~/.heroes</code>
directory but you can put it anywhere provided the filename given after
<code>soundconf:</code> points to it.
<p>All that sound configuration stuff should allow you to make drop-in
replacement for heroes modules. You just make a set of modules
available with a configuration file that any user can get read from its
<code>~/.heroes/heroesrc</code>.
<p>You can run <code>heroes --list=sound-tracks</code> to print the list of
sound-tracks used by heroes, and hence verify the correctness of your
configuration.
<h4><code>setrsc:</code></h4>
<p>This follow the same format as <code>setenv</code> but is used to overwrite
some filenames used by the game. Heroes internally handles file or
directory names using name aliases called file resources whose values (actual
filenames) can be overwritten by <code>setrsc</code> and are subject to variable
expansion.
<p>The command <code>heroes --list=resources</code> will list all the resources
used by the game. <code>data-dir</code> is a special resource which content
is setup from the <code>HEROES_DATA_DIR</code> environment variable, or from
the path used to install the files when the game was
built. <code>home-dir</code> is initialized from the <code>HOME</code> environment
variable.
<p>An example of <code>setrsc:</code> usage is to run the game with an alternate
picture file. Say you are working on a modified version of the main font
used in the game, you can override the installed picture by yours with
the following line.
<br><pre>setrsc: main-font /home/adl/heroes-dev/tmp/fontem.pcx
</pre>
<h4><code>keepsgid:</code> and <code>keepsuid:</code></h4>
<p>By default, if Heroes has a sgid-bit or suid-bit, it will drop
all privileges once the score and saved games are open. This
happens before the user configuration is read, and therefore before
the display and sound are initialized.
<p>Sometime you do not want these privileges to be dropped because
your setup requires them. For instance your display driver might
require read/write access to /dev/mem, or a similar requirement may
exist for the sound library).
<p><code>keepsgid: yes</code> and <code>keepsuid: yes</code> can be used to instruct
Heroes to keep the s-bit privileges for its whole life. These commands
can only be used in the system-wide configuration file.
<p><hr>
Node:<a name="Global%20score%20file">Global score file</a>,
Next:<a rel=next href="#Game">Game</a>,
Previous:<a rel=previous href="#heroesrc">heroesrc</a>,
Up:<a rel=up href="#Running">Running</a>
<br>
<h3>Sharing a global score file</h3>
<p>In its default configuration, Heroes will create a score file in each
user's directory. However you may want to share a global score file for
many users. This can easily be done by redefining the filename used by
Heroes to read and write the score file. This filename is a resource,
so it can be overwritten in an <code>heroesrc</code> configuration file.
<p>If you are the installer of Heroes, you can do this from the
system wide <code>heroesrc</code> with a line like the following
<br><pre>setrsc: score-file $(sys-dir)/scores
</pre>
<p>The same considerations apply to saved games (<code>saved-games-file</code>).
<p><code>$(sys-dir)</code> is another resource the value of which defaults
to <code>/var/games/heroes</code>. According to the Filesystem Hierarchy
Standard this is the place where you should store modifiable game files.
If you need to change this, simply add another <code>setrsc:</code> line:
<br><pre>setrsc: sys-dir /site/var/games/heroes
</pre>
By the way, you will have to create the <code>$(sys-dir)</code> directory
yourself, because Heroes is not smart enough (and probably doesn't have
the right to create that directory anyway).
<p>Now you have to make several choices regarding the policy for granting
access to that file. This is a global score files, so you need to devise
a setup which allows Heroes to write that file whoever run the game.
The most straightforward way to allow this is to create the <code>scores</code> file
with <code>666</code> permission... you probably don't want to do this because
everybody would be allowed to damage the file.
<p>A cleaner idea is to create a special user or group to own that file,
and grant <code>heroes</code> the appropriate rights (set-user-id or
set-group-id). Setting <code>heroes</code> as a set-user-id program is
a security problem, because if someone manage to get <code>heroes</code> to execute
arbitrary code, he can have the game overwriting itself. So the correct
solution is to set <code>heroes</code> as a set-group-id program, and make the
score file writable only by that group. At worse, if someone manage
to break into <code>heroes</code>, s/he will only be able to damage the
score file.
<p>Here is a sample setup where <code>heroes</code> is configured as a
set-group-id program for a group called `<code>games</code>':
<br><pre>% cd /usr/games && ls -l heroes
-r-xr-sr-x 1 root games 2074633 Mar 25 22:29 heroes
% cd /var/games/heroes && ls -la
drwxr-xr-x 2 root games 4096 Mar 25 22:35 ./
drwxr-xr-x 4 root root 4096 Mar 25 19:59 ../
-rw-rw-r-- 1 root games 2291 Mar 25 22:35 scores
</pre>
Note that <code>/var/games/heroes</code> is not writable by group <code>games</code>,
so you have to create the file <code>scores</code> before Heroes can use it.
<p>When <code>heroes</code> is run as a set-group-id or set-user-id program, it
executes some code to drop this privilege whenever possible. Basically,
it will revert its effective-group-id and effective-user-id to the
player's group-id and user-id on startup and only switch back to it's
file-group-id and file-user-id when it needs to write to a file in the
<code>$(sys-dir)</code> directory. This is what the <code>$(sys-dir)</code>
resource is for: a file which is beyond that directory is opened with
the file-group&user-id (i.e. group `games' in the above example), any
other file is opened using the player's group(s) and user-id. The
visible consequence is that files created in the <code>~/.heroes</code>
directory won't be owned by group <code>games</code> (or whatever you chose).
<p>Finally, note that Heroes does keep track of how a resource has been
setup, and wont switch persona when <code>$(sys-dir)</code> or
<code>$(score-file)</code> has been setup in a non-trusted way. Roughly,
all hard-coded and system-wide settings are trusted, while the user's
personal settings are untrusted.
<p><hr>
Node:<a name="Game">Game</a>,
Next:<a rel=next href="#Level%20editor">Level editor</a>,
Previous:<a rel=previous href="#Global%20score%20file">Global score file</a>,
Up:<a rel=up href="#Running">Running</a>
<br>
<h3>Game</h3>
<p>Heroes has an `INFO' menu, that should describe the different game modes
and options, with pictures and colors. Please refer to it until this
section is written.
<p><hr>
Node:<a name="Level%20editor">Level editor</a>,
Next:<a rel=next href="#Troubleshooting">Troubleshooting</a>,
Previous:<a rel=previous href="#Game">Game</a>,
Up:<a rel=up href="#Running">Running</a>
<br>
<h3>Level editor</h3>
<p>The level editor is available from the `editor' entry in the main menu.
Created levels will be stored in your <code>~/.heroes/levels</code> directory.
<p>This editor is a cut down version of the one that served us to build all
100 levels of this game. This one will allow you to construct your own
levels in a quite simplified manner.
<p>On the left side of the screen, you can see a part of your level. You
can move with keyboard or mouse (read the two next sections). In the
middle of the screen you can see the set of all the available tiles.
You will pick tiles here to build you level. And on the right there is
some informations about the level and the selected (orange box) tile.
<ul>
<li><a href="#editor-keys">editor-keys</a>: Key used in the level editor.
<li><a href="#editor-clicks">editor-clicks</a>: How mouse is used in the editor.
<li><a href="#tunnels">tunnels</a>: How to setup a tunnel.
<li><a href="#sprites">sprites</a>: How to setup a sprite.
<li><a href="#animations">animations</a>: How to setup animations.
<li><a href="#departures">departures</a>: How to setup departures.
</ul>
<p><hr>
Node:<a name="editor-keys">editor-keys</a>,
Next:<a rel=next href="#editor-clicks">editor-clicks</a>,
Previous:<a rel=previous href="#Level%20editor">Level editor</a>,
Up:<a rel=up href="#Level%20editor">Level editor</a>
<br>
<h4>Editor keys</h4>
<p>Here is the list of keys used in the level-editor. You will have to
learn most of them because most of these actions are available only as
key-bindings.
<dl>
<dt><kbd><F3></kbd>
<dd>Toggle sprite and vehicle display.
<br><dt><kbd><F5></kbd>
<dd>Toggle collide tests display.
<br><dt><kbd><ESC></kbd>
<dd>Quit and save.
<br><dt><kbd><Ctrl>-<Left></kbd>
<dt><kbd><Ctrl>-<Right></kbd>
<dt><kbd><Ctrl>-<Up></kbd>
<dt><kbd><Ctrl>-<Down></kbd>
<dt><kbd><Ctrl>-<PageUp></kbd>
<dt><kbd><Ctrl>-<PageDown></kbd>
<dt><kbd><Ctrl>-<Home></kbd>
<dt><kbd><Ctrl>-<End></kbd>
<dd>Move the cursor in the tiles side.
<br><dt><kbd><Left></kbd>
<dt><kbd><Right></kbd>
<dt><kbd><Up></kbd>
<dt><kbd><Down></kbd>
<dd>Move the cursor in the level side.
<br><dt><kbd><SPC></kbd>
<dd>Copy a tile.
<br><dt><kbd><d></kbd>
<dd>Setup starting positions on the selected tile.
<br><dt><kbd><Ctrl>-<f></kbd>
<dd>Fill the whole level with the selected tile.
<br><dt><kbd><Meta>-<f></kbd>
<dt><kbd><Alt>-<f></kbd>
<dd>Fill the whole level with the two first tiles (for the 10th set of tiles).
<br><dt><kbd><p></kbd>
<dd>Output the level map as a big <code>pcx</code> file. The file is saved in the
current directory, and the file name is made by appending <code>.pcx</code> to
the level name.
<br><dt><kbd><s></kbd>
<dd>Copy a sprite, or remove a sprite.
<br><dt><kbd><t></kbd>
<dd>Select the tile for tunnel destination.
<br><dt><kbd><RET></kbd>
<dd>View the level map in full screen.
<br><dt><kbd><Ctrl>-<RET></kbd>
<dd>Play animations.
</dl>
<p><hr>
Node:<a name="editor-clicks">editor-clicks</a>,
Next:<a rel=next href="#tunnels">tunnels</a>,
Previous:<a rel=previous href="#editor-keys">editor-keys</a>,
Up:<a rel=up href="#Level%20editor">Level editor</a>
<br>
<h4>Editor clicks</h4>
<p>You can select a tiles by clicking on it with the left mouse button.
Keeping this button pulled down will allow you to move the map without using
the keyboard.
<p>The middle button (if you have one) used in the left side will
temporally select a tile, as if you were using the <kbd>t</kbd> key.
<p>The right button, used in the left side, will copy a tile to the pointed
tile, in a way it behaves like the space key.
<p><hr>
Node:<a name="tunnels">tunnels</a>,
Next:<a rel=next href="#sprites">sprites</a>,
Previous:<a rel=previous href="#editor-clicks">editor-clicks</a>,
Up:<a rel=up href="#Level%20editor">Level editor</a>
<br>
<h4>Tunnels</h4>
<p>Copy your two tiles that are the entrances of your tunnel. Move the
box-pointer on one, and select it if the <kbd><t></kbd> key (or click on
it with the middle button). Once you will move the pointer, this tile
will appear in a dashed box. Move on the second tunnel and click on the
<code>[GO TO]</code> box that is on the right of your screen. Now you have
set up the first way: for now if your were playing on this level you
could go from this place to the dashed one, but from the dashed to this
one. So you also have to set up the tunnel in the other way: select the
current tiles with <kbd><t></kbd>, move on the former and click on
<code>[GO TO]</code>. That's all.
<p>Notice that with this technique you can also typeset some kind of
triangular tunnel. Let <code>A</code>, <code>B</code>, <code>C</code> be the entrances,
you could setup the way like that <code>A->B</code>, <code>B->C</code>, and
<code>C->A</code>.
<p>The coordinate <code>0x0</code> if used for the destination denotes a non-setup
way. That's why you can't put a tunnel on the <code>0x0</code> position.
<p><hr>
Node:<a name="sprites">sprites</a>,
Next:<a rel=next href="#animations">animations</a>,
Previous:<a rel=previous href="#tunnels">tunnels</a>,
Up:<a rel=up href="#Level%20editor">Level editor</a>
<br>
<h4>Sprites</h4>
<p>With some set of tiles (like the Egyptian one), there are tiles (like
palm trees) designed to be used as `sprites', i.e. put over others with
transparency. You have to use the <kbd><s></kbd> key for this:
<ul>
<li>copy the ground tile with <kbd><SPC></kbd> or the first button
<li>copy the sprite tile with <kbd><s></kbd> (and if you don't see any sprite on
the level, press <kbd><F3></kbd>).
</ul>
<p><hr>
Node:<a name="animations">animations</a>,
Next:<a rel=next href="#departures">departures</a>,
Previous:<a rel=previous href="#sprites">sprites</a>,
Up:<a rel=up href="#Level%20editor">Level editor</a>
<br>
<h4>Animations</h4>
<p>You may have noticed that during the game, some tiles are animated:
color cycle (like the speed arrows) or moving objects (ventilators).
Each frame of an animation is actually a separate tile. The different
tiles of an animations are drawn horizontally in the sets. To setup an
animation, you just have to select the first one and copy it into your
level. Optionally, press <kbd><Ctrl>-<RET></kbd> to see the animation.
When the orange box is on an animated tile, you should find a button on
the right to modify the speed: the greater the number is, the slower the
animation goes.
<p><hr>
Node:<a name="departures">departures</a>,
Previous:<a rel=previous href="#animations">animations</a>,
Up:<a rel=up href="#Level%20editor">Level editor</a>
<br>
<h4>Departures</h4>
<p>Select a tile and press the <kbd><d></kbd> key. Then look at the right
side, select a color and click on the arrow you want (if you don't see
any vehicle on the level, press <kbd><F3></kbd>).
<p><hr>
Node:<a name="Troubleshooting">Troubleshooting</a>,
Previous:<a rel=previous href="#Level%20editor">Level editor</a>,
Up:<a rel=up href="#Running">Running</a>
<br>
<h3>Troubleshooting</h3>
<h4>Video mode</h4>
<p>This game was primary made for MS-DOS, with VGA 320x200x8bits display.
If GGI is used to manage the video modes and you run into trouble with
video modes, I suggest you play with a environment variable called
<code>GGI_DISPLAY</code> used to select the display used. LibGGI come with a file
<code>env.txt</code> that describes this variable. As an alternative you may
use heroes' <code>--gfx-options</code> option instead of the above variable. If
you want to force X display, you can add a line
<br><pre>Options: --gfx-options=X
</pre>
in your <code>~/.heroes/heroesrc</code> file.
Note: <code>--gfx-options</code> has no effect if you are using SDL.
<p>We suggest you to run the game under X because in console modes (libvga,
frame buffers, ...) it's easy to get stuck if the game freeze.
<p>People using an X server that supports 8bit visuals although the default
visual is not 8bit (run <code>xdpyinfo</code> to see a list of visuals that
your X server supports) are subject to what is probably a GGI bug.
Basically GGI's X driver fails to allocate the 8bit mode correctly.
The symptom is
<br><pre>X Error of failed request: BadMatch (invalid parameter attributes)
Major opcode of failed request: 1 (X_CreateWindow)
Serial number of failed request: 24
Current serial number in output stream: 31
</pre>
One workaround is to prevent Heroes from negociating a 8bit video mode.
Specify <code>--gfx-options not8</code> to that effect. The default visual
depth for your server will then be selected by GGI. (Of course this is
slower because Heroes internally works in 8bit mode; use of another
display depth involves a conversion.)
<h4>Keyboard</h4>
<p>There is a menu `KEYS' in the submenu `OPTIONS' that lets you change the
key bindings used during the game. Please set the keys here before
playing since key codes can vary from place to place (hmm... is that
right?).
<h4>Sound effects</h4>
<p>You may find that there is some delay between an action and the
associated sound effect. This is because libmikmod is polling in a
buffer and is thus always one buffer ahead in the playback. It is
possible to reduce the size of that buffer using some driver parameters,
please see the section `DRIVER PARAMETERS' of libmikmod's <code>README</code>. For
instance I'm using the OSS driver and I reduce the size of libmikmod's
buffer by running heroes with the line
<br><pre>Options: -d3,buffer=11,count=4
</pre>
in my <code>~/.heroes/heroesrc</code> file. If you can find correct values for
other drivers, please send them to <a href="mailto:duret_g@epita.fr">me</a>!
<h4>Sound errors</h4>
<p>If Heroes try to tell you that:
<br><pre>Could not initialize sound, reason: Could not set sample size
</pre>
That means that MikMod couldn't setup the 16bits output, may be because
your sound card doesn't support that. Use the <code>-8</code> option to
have the game running with 8bits sound output.
<p>If you get:
<br><pre>Could not initialize sound, reason: Could not set mono/stereo setting
</pre>
You will have to run the game with <code>-m</code>, because stereo is not
available.
<p>Remember that you can always put these options in your
<code>~/.heroes/heroes</code> file (see <a href="#heroesrc">heroesrc</a>) so that you don't need
to type them every time you run the game.
<h4>SegFault when using Alsa drivers with and LibMikMod</h4>
<p>If you are using Alsa 0.5.x drivers<a rel=footnote href="#fn-2"><sup>2</sup></a> Heroes
is likely to crash during it's startup. This is because the current
version of LibMikMod (3.1.9 at the time of writing) lacks support for
Alsa 0.5.
<p>A solution is to run Alsa in OSS-emulation mode: simply run <code>heroes
-d x</code> (where x is the OSS driver number printed by <code>heroes -n</code>) to
force LibMikMod using its OSS<a rel=footnote href="#fn-3"><sup>3</sup></a>
interface.
<p>As a more general solution, you may want to compile LibMikMod without Alsa
support (<code>./configure --disable-alsa</code>) so that it never crash
for any application.
<p><hr>
Node:<a name="heroeslvl">heroeslvl</a>,
Next:<a rel=next href="#Index">Index</a>,
Previous:<a rel=previous href="#Running">Running</a>,
Up:<a rel=up href="#Top">Top</a>
<br>
<h2><code>heroeslvl</code></h2>
<p><code>heroeslvl</code> is a tool that can be used to inspect the content of
Heroes level files. This is of almost no interest to the usual Heroes
player, but can sometime be helpful to find bugs in levels.
<ul>
<li><a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>: heroeslvl launch-time options
</ul>
<p><hr>
Node:<a name="Invoking%20heroeslvl">Invoking heroeslvl</a>,
Previous:<a rel=previous href="#heroeslvl">heroeslvl</a>,
Up:<a rel=up href="#heroeslvl">heroeslvl</a>
<br>
<h3><code>heroeslvl</code> options</h3>
<p><code>heroeslvl</code> takes a list of levels to inspect in argument, and
support the following options.
<p>When no options are given, <code>heroeslvl</code> defaults to <code>-ipfh</code>.
<dl>
<dt><code>-v</code>
<dt><code>--version</code>
<dd>Display <code>heroeslvl</code> version number and copyright informations.
<br><dt><code>-h</code>
<dt><code>--help</code>
<dd>Print a help message about these run-time options.
<br><dt><code>-p WHAT</code>
<dt><code>--print=WHAT</code>
<dd>Select what information <code>heroeslvl</code> should display. <code>WHAT</code> can
be one or more of the following characters.
<dl>
<dt><code>d</code>
<dd>Print square directions. Square directions are used on tunnel to indicate
the entrance direction, and on speed tiles to indicate the direction of
the acceleration.
<br><dt><code>f</code>
<dd>Print the filename of each processed file.
<br><dt><code>h</code>
<dd>Print header information. This include level size, soundtrack and
tilesets to use, starting positions...
<br><dt><code>i</code>
<dd>Print tile details. This will display a list of all tiles, along with
some of their attributes (type of the tile, adress of its sprite,
animation information).
<br><dt><code>t</code>
<dd>Print square type map. Display a map of the level, rendering
each square with a character indicating the square type.
<br><dt><code>T</code>
<dd>Display the character used as type keys in the <code>-pt</code> output.
<br><dt><code>w</code>
<dd>Print wall map. Display a map of the level, rendering each square with
a character indicating the number of neighboring walls. (Walls are
just bits indicating the directions that can be used to exit from a
square; they not always map to something visible on the level.)
<br><dt><code>@</code>
<dd>Print the list of tunnels, with position, direction, and destination.
</dl>
<br><dt><code>-i</code>
<dt><code>--indent</code>
<dd>Indent everything but the filenames of each level processed.
Note that filenames are only displayed if requested by <code>-pf</code>.
</dl>
<p><hr>
Node:<a name="Index">Index</a>,
Previous:<a rel=previous href="#heroeslvl">heroeslvl</a>,
Up:<a rel=up href="#Top">Top</a>
<br>
<h2>Index</h2>
<ul compact>
<li>-2: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-3: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-4: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-8: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-8bits: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-cpu-off: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-d N[,OPTIONS]: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-default-options: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-default-saves: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-default-scores: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-disable-debug: <a href="#configure%20options">configure options</a>
<li>-disable-display: <a href="#configure%20options">configure options</a>
<li>-disable-heroes-debug: <a href="#configure%20options">configure options</a>
<li>-disable-joystick: <a href="#configure%20options">configure options</a>
<li>-disable-optimizations: <a href="#configure%20options">configure options</a>
<li>-disable-sound: <a href="#configure%20options">configure options</a>
<li>-double: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-driver=N[,OPTIONS]: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-e: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-enable-assert: <a href="#configure%20options">configure options</a>
<li>-enable-debug: <a href="#configure%20options">configure options</a>
<li>-enable-devel: <a href="#configure%20options">configure options</a>
<li>-enable-gprof: <a href="#configure%20options">configure options</a>
<li>-enable-html-doc[=DIR]: <a href="#configure%20options">configure options</a>
<li>-enable-mem-debug: <a href="#configure%20options">configure options</a>
<li>-enable-warnings: <a href="#configure%20options">configure options</a>
<li>-even-lines: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-F: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-full-screen: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-g: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-G OPTIONS: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-gfx-options: <a href="#Troubleshooting">Troubleshooting</a>
<li>-gfx-options=OPTIONS: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-go: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-h: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>, <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-help: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>, <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-high-quality: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-i: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>, <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-indent: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-J: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-list=WORD: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-lWORD: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-m: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-mono: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-no-double-fx: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-no-joystick: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-p: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-p@: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-pd: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-pf: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-ph: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-pi: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-print: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-pT: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-pt: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-pw: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>-Q: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-q: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-quadruple: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-quiet: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-really-quiet: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-s: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-swap-sides: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-triple: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-v: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>, <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-verbose=CHANNELS: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-version: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>, <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-vOPTIONS: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>-with-allegro: <a href="#configure%20options">configure options</a>
<li>-with-dmalloc: <a href="#configure%20options">configure options</a>
<li>-with-efence: <a href="#configure%20options">configure options</a>
<li>-with-ggi: <a href="#configure%20options">configure options</a>
<li>-with-mikmod: <a href="#configure%20options">configure options</a>
<li>-with-mpatrol: <a href="#configure%20options">configure options</a>
<li>-with-mtrace: <a href="#configure%20options">configure options</a>
<li>-with-sdl: <a href="#configure%20options">configure options</a>
<li>-with-sdl-mixer[=DIR]: <a href="#configure%20options">configure options</a>
<li>allegro: <a href="#Libraries">Libraries</a>
<li>Alsa: <a href="#Troubleshooting">Troubleshooting</a>
<li>animations: <a href="#animations">animations</a>
<li>architecture: <a href="#Machines">Machines</a>
<li>authors: <a href="#People">People</a>
<li>bug: <a href="#Bug%20Reporting">Bug Reporting</a>
<li>bug report: <a href="#Bug%20Reporting">Bug Reporting</a>
<li>configure generic instructions: <a href="#configure">configure</a>
<li>configure options for Heroes: <a href="#configure%20options">configure options</a>
<li>contributing: <a href="#Bug%20Reporting">Bug Reporting</a>
<li>contributors: <a href="#People">People</a>
<li>copying: <a href="#Copying">Copying</a>
<li>core dump: <a href="#Bug%20Reporting">Bug Reporting</a>
<li>delay: <a href="#Troubleshooting">Troubleshooting</a>
<li>departures: <a href="#departures">departures</a>
<li>diff: <a href="#Bug%20Reporting">Bug Reporting</a>
<li>display driver: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>distribution: <a href="#Copying">Copying</a>
<li>dmalloc: <a href="#configure%20options">configure options</a>
<li>download: <a href="#Getting%20Heroes">Getting Heroes</a>
<li>editor: <a href="#Level%20editor">Level editor</a>
<li>editor clicks: <a href="#editor-clicks">editor-clicks</a>
<li>editor keys: <a href="#editor-keys">editor-keys</a>
<li>efence: <a href="#configure%20options">configure options</a>
<li>environment: <a href="#Environment">Environment</a>
<li>environment variable: <a href="#heroesrc">heroesrc</a>
<li>errors: <a href="#Troubleshooting">Troubleshooting</a>
<li>extra levels directory: <a href="#heroesrc">heroesrc</a>
<li>extradir: <a href="#heroesrc">heroesrc</a>
<li>file resources: <a href="#heroesrc">heroesrc</a>
<li>free: <a href="#Copying">Copying</a>
<li>full screen: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>game: <a href="#Game">Game</a>
<li>getting heroes: <a href="#Getting%20Heroes">Getting Heroes</a>
<li>ggi: <a href="#Libraries">Libraries</a>
<li><code>GGI_DISPLAY</code>: <a href="#Troubleshooting">Troubleshooting</a>, <a href="#Invoking%20heroes">Invoking heroes</a>
<li>gii: <a href="#Libraries">Libraries</a>
<li>gprof: <a href="#configure%20options">configure options</a>
<li>heroes-announce: <a href="#Mailing%20lists">Mailing lists</a>
<li>heroes-bugs: <a href="#Mailing%20lists">Mailing lists</a>
<li>heroes-discuss: <a href="#Mailing%20lists">Mailing lists</a>
<li><code>HEROES_DATA_DIR</code>: <a href="#Environment">Environment</a>
<li><code>HEROES_DEBUG</code>: <a href="#Environment">Environment</a>
<li>HEROES_DEBUG: <a href="#configure%20options">configure options</a>
<li><code>HEROES_LOCALE_DIR</code>: <a href="#Environment">Environment</a>
<li><code>HEROES_PREFIX</code>: <a href="#Environment">Environment</a>
<li>heroeslvl: <a href="#heroeslvl">heroeslvl</a>
<li>heroesrc: <a href="#heroesrc">heroesrc</a>
<li>history: <a href="#History">History</a>
<li><code>HOME</code>: <a href="#Environment">Environment</a>
<li>ibiblio: <a href="#Getting%20Heroes">Getting Heroes</a>
<li>index: <a href="#Index">Index</a>
<li>installation: <a href="#Installation">Installation</a>
<li>Invoking heroeslvl: <a href="#Invoking%20heroeslvl">Invoking heroeslvl</a>
<li>keepsgid: <a href="#heroesrc">heroesrc</a>
<li>keepsuid: <a href="#heroesrc">heroesrc</a>
<li>key codes: <a href="#Troubleshooting">Troubleshooting</a>
<li>keyboard: <a href="#Troubleshooting">Troubleshooting</a>
<li>keys: <a href="#Troubleshooting">Troubleshooting</a>
<li>keys, in editor: <a href="#editor-keys">editor-keys</a>
<li>level editor: <a href="#Level%20editor">Level editor</a>
<li>libggi: <a href="#Libraries">Libraries</a>
<li>libgii: <a href="#Libraries">Libraries</a>
<li>libmikmod: <a href="#Libraries">Libraries</a>
<li>LibMikMod and Alsa: <a href="#Troubleshooting">Troubleshooting</a>
<li>libraries: <a href="#Libraries">Libraries</a>
<li>libsdl: <a href="#Libraries">Libraries</a>
<li>machines: <a href="#Machines">Machines</a>
<li>metalab: <a href="#Getting%20Heroes">Getting Heroes</a>
<li>mikmod: <a href="#Libraries">Libraries</a>
<li>mouse, in editor: <a href="#editor-clicks">editor-clicks</a>
<li>mpatrol: <a href="#configure%20options">configure options</a>
<li>mtrace: <a href="#configure%20options">configure options</a>
<li>Nibbles: <a href="#Overview">Overview</a>
<li>options: <a href="#heroesrc">heroesrc</a>, <a href="#Invoking%20heroes">Invoking heroes</a>
<li>overview: <a href="#Overview">Overview</a>
<li>packagers: <a href="#People">People</a>
<li>patch: <a href="#Bug%20Reporting">Bug Reporting</a>
<li>relocation: <a href="#Relocatable%20package">Relocatable package</a>
<li>rights: <a href="#Copying">Copying</a>
<li>running: <a href="#Running">Running</a>
<li>runtime options: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>sdl: <a href="#Libraries">Libraries</a>
<li><code>SDL_VIDEODRIVER</code>: <a href="#heroesrc">heroesrc</a>, <a href="#Invoking%20heroes">Invoking heroes</a>
<li>setenv: <a href="#heroesrc">heroesrc</a>
<li>setrsc: <a href="#heroesrc">heroesrc</a>
<li>sfx: <a href="#Troubleshooting">Troubleshooting</a>
<li>sgid: <a href="#Global%20score%20file">Global score file</a>, <a href="#heroesrc">heroesrc</a>
<li>Simple DirectMedia Layer: <a href="#Libraries">Libraries</a>
<li>sound driver: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>sound effects: <a href="#Troubleshooting">Troubleshooting</a>
<li>sound errors: <a href="#Troubleshooting">Troubleshooting</a>
<li>soundconf: <a href="#heroesrc">heroesrc</a>
<li>sprites: <a href="#sprites">sprites</a>
<li>stretching: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>suggestions: <a href="#Bug%20Reporting">Bug Reporting</a>
<li>suid: <a href="#Global%20score%20file">Global score file</a>, <a href="#heroesrc">heroesrc</a>
<li>sunsite: <a href="#Getting%20Heroes">Getting Heroes</a>
<li>target.txt: <a href="#Invoking%20heroes">Invoking heroes</a>
<li>TODO: <a href="#Bug%20Reporting">Bug Reporting</a>
<li>translators: <a href="#People">People</a>
<li>Tron: <a href="#Overview">Overview</a>
<li>troubleshooting: <a href="#Troubleshooting">Troubleshooting</a>
<li>tunnels: <a href="#tunnels">tunnels</a>
<li>variable: <a href="#heroesrc">heroesrc</a>
<li>video mode: <a href="#Troubleshooting">Troubleshooting</a>
<li>X: <a href="#Troubleshooting">Troubleshooting</a>
</ul>
<h2>Table of Contents</h2>
<ul>
<li><a name="toc_Top"></a>
<a href="#Top">Heroes</a>
<li><a name="toc_Copying"></a>
<a href="#Copying">Heroes Copying Conditions</a>
<li><a name="toc_Overview"></a>
<a href="#Overview">Overview of Heroes</a>
<ul>
<li><a href="#Getting%20Heroes">Getting Heroes</a>
<ul>
<li><a href="#Getting%20Heroes">Where to fetch new releases?</a>
<li><a href="#Getting%20Heroes">What to download?</a>
</ul>
<li><a href="#Mailing%20lists">Mailing lists.</a>
<li><a href="#Bug%20Reporting">Reporting bugs, sending suggestions or contribution</a>
<li><a href="#People">People</a>
<ul>
<li><a href="#People">Authors</a>
<li><a href="#People">Contributors</a>
<li><a href="#People">Translators</a>
<li><a href="#People">Packagers</a>
<li><a href="#People">Porters</a>
</ul>
<li><a href="#History">History of the DOS version</a>
</ul>
<li><a name="toc_Installation"></a>
<a href="#Installation">Installation of Heroes</a>
<ul>
<li><a href="#Libraries">Needed Libraries</a>
<li><a href="#configure">configure generic instructions</a>
<li><a href="#configure%20options">configure options for Heroes</a>
<li><a href="#Relocatable%20package">Building a relocatable package</a>
<li><a href="#Machines">Machines</a>
</ul>
<li><a name="toc_Running"></a>
<a href="#Running">Running Heroes</a>
<ul>
<li><a href="#Invoking%20heroes"><code>heroes</code> options</a>
<li><a href="#Environment">Environment variables</a>
<ul>
<li><a href="#Environment"><code>HEROES_DEBUG</code></a>
<li><a href="#Environment"><code>HEROES_PREFIX</code></a>
<li><a href="#Environment"><code>HEROES_DATA_DIR</code></a>
<li><a href="#Environment"><code>HEROES_LOCALE_DIR</code></a>
<li><a href="#Environment"><code>HOME</code></a>
</ul>
<li><a href="#heroesrc"><code>~/.heroes/heroesrc</code></a>
<ul>
<li><a href="#heroesrc"><code>option:</code></a>
<li><a href="#heroesrc"><code>setenv:</code></a>
<li><a href="#heroesrc"><code>extradir:</code></a>
<li><a href="#heroesrc"><code>soundconf:</code></a>
<li><a href="#heroesrc"><code>setrsc:</code></a>
<li><a href="#heroesrc"><code>keepsgid:</code> and <code>keepsuid:</code></a>
</ul>
<li><a href="#Global%20score%20file">Sharing a global score file</a>
<li><a href="#Game">Game</a>
<li><a href="#Level%20editor">Level editor</a>
<ul>
<li><a href="#editor-keys">Editor keys</a>
<li><a href="#editor-clicks">Editor clicks</a>
<li><a href="#tunnels">Tunnels</a>
<li><a href="#sprites">Sprites</a>
<li><a href="#animations">Animations</a>
<li><a href="#departures">Departures</a>
</ul>
<li><a href="#Troubleshooting">Troubleshooting</a>
<ul>
<li><a href="#Troubleshooting">Video mode</a>
<li><a href="#Troubleshooting">Keyboard</a>
<li><a href="#Troubleshooting">Sound effects</a>
<li><a href="#Troubleshooting">Sound errors</a>
<li><a href="#Troubleshooting">SegFault when using Alsa drivers with and LibMikMod</a>
</ul>
</ul>
<li><a name="toc_heroeslvl"></a>
<a href="#heroeslvl"><code>heroeslvl</code></a>
<ul>
<li><a href="#Invoking%20heroeslvl"><code>heroeslvl</code> options</a>
</ul>
<li><a name="toc_Index"></a>
<a href="#Index">Index</a>
</ul>
<hr><h4>Footnotes</h4>
<ol type="1">
<li><a name="fn-1"></a>
<p>For instance, this section was stolen from the
documentation of GNU Texinfo.</p>
<li><a name="fn-2"></a>
<p>Alsa is a project to
improve the Linux sound subsystem<br>
(See <a href="http://www.alsa-project.org/">the Alsa page</a> for details).</p>
<li><a name="fn-3"></a>
<p>Open Sound System is a set of
device drivers that provide a uniform API across all the major UNIX
architectures. The Linux kernel contain free code from the commercial
OSS (See <a href="http://www.linux.org.uk/OSS/">this page</a> for details).</p>
</ol><hr>
</body></html>
|
