1This file contains a few notes about the DarcNES Multi-System emulator.
2
3DarcNES is Copyright 1998, 1999, 2000, 2001 by Alastair Bridgewater.
4
5Commercial use prohibited without express written permission from
6the author. Everyone else can do whatever they want, provided that
7I am credited in the documentation (and, if released, the source code).
8
9People wishing to maintain a port for another system should contact me
10beforehand in order to learn the ground rules (and to make sure that no
11one else is already maintaining a port for that system).
12
13
14Disclaimer:
15
16This software is provided AS IS, etc. No warranty, etc, etc. You know
17the drill.
18
19
20Usage notes:
21
22 DOS users: edit the Makefile, the required changes should be fairly
23obvious. keys are 'A', 'S', '[', ']', arrows, and escape.
24
25 Linux/BSD users (both SVGALib and XWindows): If you are on an a.out
26system (as opposed to an ELF system), you may need to add "-DASM_UNDERBARS"
27to SFLAGS in the Makefile.
28
29 SVGALib users: edit the Makefile, the required change should be
30fairly obvious. keys are the same as the dos version + ctrl, alt, tab, and
31enter.
32
33 XWindows users: keys are the same as the dos version. you have to use
34file->exit to save the battery file (if any). if you don't specify a file
35on the command line, "cart.nes" will be used.
36
37 All other users: Good luck. Keys tend to be the same as for the DOS
38version, and the interface is usually fairly obvious.
39
40
41CD support notes:
42
43 To use the CD support, just load one of the syscard images as a ROM.
44Having a game CD in the drive at the time helps.
45
46 DOS users: No such luck. I believe CD support to be disabled for allegro
47builds.
48
49 Linux/BSD users: CD support should build automatically and correctly. The
50only thing you might want to check is the definition of CDROM_DEVICE in the
51appropriate section of cd_unix.c.
52
53 People who want to use ISO/FCD/HCD files: Go away. I have less than no
54interest in adding support for file formats used primarily for piracy when it
55is still possible to acquire legit CDs which will work in all modern computers.
56
57
58BIOS files:
59
60 ColecoVision emulation requires a file called "coleco.rom".
61 FDS emulation requires a file called "disksys.rom".
62 MSX emulation requires a file called "msx.rom".
63 Apple ][ emulation requires the following: "applecg.bin", "disk_ii.rom",
64"fpbasic_d0.rom", "fpbasic_d8.rom", "fpbasic_e0.rom", "fpbasic_e8.rom",
65"fpbasic_f0.rom", and "autostart_f8.rom".
66
67 With a recompile, the Apple ][ emulator can be convinced to use the integer
68basic ROM set ("programmers_aide_d0.rom", "intbasic_e0.rom", "intbasic_e8.rom",
69and "intbasic_f0.rom") instead of the "fpbasic_*.rom" set used for Applesoft
70BASIC. You can also substitute "monitor_f8.rom" for the autostart ROM, but I
71have been unable to find an uncorrupt copy of the monitor ROM.
72
73 All this should eventually be user-configurable.
74
75
76How to compile for non-x86 systems:
77
78 In the Makefile, uncomment the line about "C_ONLY" and select the
79BYTE_ORDER to be appropriate for your CPU. Also comment out the definition of
80MACH_TYPES (or write your own types_whatever.h, and set MACH_TYPES to it).
81 If you are using a compiler other than gcc, you will likely need to edit
82types.h to work with your compiler.
83 Build as per normal.
84
85
86Things that need work:
87
88 CAL. (has to be gotten rid of)
89 GUI. (Linux/XWin one is junk, DOS one doesn't exist)
90 Video. (XWin needs to support SHM/DGA, DOS needs to support 16bpp, all
91need to support 24bpp)
92 Documentation. (If you haven't noticed by now, I don't like writing
93it. I also don't comment my code very much either, prefering to spend
94my time making it obvious enough to not need comments)
95
96
97Other things that should be listed in this file:
98
99 Homepage location:
100
101 http://www.netway.com/~nyef/
102
103 This emulator was written by the following:
104
105 Nyef (Alastair Bridgewater) (nyef@softhome.net)
106
107 The following people (among others) provided documentation/inspiration/code:
108
109 Marat Fayzullin (nes.doc, m6502)
110 Jeremy Chadwick (nestech)
111 FireBug (mappers.doc)
112 Matt Conte (sound ideas)
113 Kritz (opinions, documentation, code)
114 Fx3 (opinions, documentation)
115 Toby Deshane (SVGALib support code)
116 Rafael Rigues (DOS testing, inspiration)
117 Magnus Oman (new nes palette)
118 Michael Vance (code)
119 Jussi Lindgren (testing, inspiration)
120 Charles Mac Donald (documentation)
121 Joshua Moore (inspiration)
122 Matan Ziv-Av (documentation, inspiration)
123 AmiDog (inspiration, code)
124 Zeograd (documentation, inspiration, code)
125 BERO (some m6280 code)
126 Maximiliano Di Dio (some NES bugfixes)
127 Thomas Klausner (inspiration, NetBSD code)
128 Jerome BENOIST (inspiration, some code fixes)
129 Nori (FDS documentation)
130 Richard Hunt (testing)
131 Johan Dahlin (testing, inspiration)
132 _Bnu (inspiration)
133 Marc Le Douarain (documentation, inspiration, code)
134
135/* EOF */
136