Updated manual for gambatte version
This commit is contained in:
Ilari Liusvaara
parent
47b4a649e7
commit
1712d3f221
2 changed files with 31 additions and 213 deletions
149
manual.lyx
149
manual.lyx
|
|
@ -72,20 +72,16 @@ Dependencies
|
|||
\end_layout
|
||||
|
||||
\begin_layout Enumerate
|
||||
bsnes libsnes
|
||||
gambatte
|
||||
\end_layout
|
||||
|
||||
\begin_deeper
|
||||
\begin_layout Enumerate
|
||||
v084-v087 (v084 or v085 for delayreset support)
|
||||
SVN r320
|
||||
\end_layout
|
||||
|
||||
\begin_layout Enumerate
|
||||
accuracy or compatiblity core with debugger enabled.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Enumerate
|
||||
Patched version (using included 7 patches)
|
||||
Patched version (using included patch)
|
||||
\end_layout
|
||||
|
||||
\end_deeper
|
||||
|
|
@ -136,7 +132,7 @@ Version 5.1.X or 5.2X.
|
|||
|
||||
\end_deeper
|
||||
\begin_layout Enumerate
|
||||
G++ 4.6 (bsnes doesn't seem to like 4.7).
|
||||
G++ 4.6 (4.7 might also work).
|
||||
\end_layout
|
||||
|
||||
\begin_layout Section
|
||||
|
|
@ -144,12 +140,12 @@ Building
|
|||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
Copy bsnes sources (the bsnes subdirectory) to subdirectory 'bsnes'.
|
||||
Copy gambatte sources to subdirectory 'gambatte'.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
Patch the bsnes sources with included patches (directory 'bsnes-patches/<version
|
||||
>')
|
||||
Patch the bsnes sources with included patches (directory 'gambatte-patches/<vers
|
||||
ion>')
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
|
|
@ -174,28 +170,15 @@ ROM options
|
|||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
rom: Cartridge ROM (BIOS for special carts).
|
||||
This is required.
|
||||
gbrom: Game Boy ROM.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
bsx: BS-X (non-slotted) Game flash ROM.
|
||||
gbcrom: Game Boy Color ROM.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
bsxslotted: BS-X (slotted) Game flash ROM.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
dmg: DMG game ROM
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
slot-a: Sufami Turbo Slot A ROM
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
slot-b: Sufami Turbo Slot B ROM
|
||||
gbcarom: Game Boy Color ROM (to be run with GBA initial register values).
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsubsection
|
||||
|
|
@ -203,7 +186,7 @@ slot-b: Sufami Turbo Slot B ROM
|
|||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
Load <file> as specified ROM (SFC/BS/DMG/ST file format).
|
||||
Load <file> as specified ROM (GB/GBC file format).
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsubsection
|
||||
|
|
@ -211,8 +194,8 @@ Load <file> as specified ROM (SFC/BS/DMG/ST file format).
|
|||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
Override hardware detection for ROM, reading the values from <file> (BSNES
|
||||
XML format).
|
||||
Override hardware detection for ROM, reading the values from <file> (contains
|
||||
extra gambatte flags).
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsubsection
|
||||
|
|
@ -244,34 +227,6 @@ Set offset to apply to IPS patches.
|
|||
The offset must be 0 for BPS patches.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsubsection
|
||||
--pal
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
Force ROM to be considered PAL-only.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
Only works on SNES and SGB ROMs (not BS-X or Sufami Turbo).
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
Attempting to load NTSC movie file will error out.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsubsection
|
||||
--ntsc
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
Force ROM to be considered NTSC-only.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
Attempting to load PAL movie file will error out.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsection
|
||||
Session options
|
||||
\end_layout
|
||||
|
|
@ -293,68 +248,6 @@ Load <filename> as movie or savestate file.
|
|||
All other session options are ignored.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsubsection
|
||||
--port1=<device> (lsnes/SDL)
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
Set type of port1.
|
||||
Valid values are:
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
none: No device connected
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
gamepad: One gamepad (the default)
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
multitap: Four gamepads (warning: makes most games refuse to start)
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
mouse: Mouse.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsubsection
|
||||
--port2=<type> (lsnes/SDL)
|
||||
\end_layout
|
||||
|
||||
\begin_layout Standard
|
||||
Set type of port2.
|
||||
Valid values are:
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
none: No device connected (the default)
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
gamepad: One gamepad
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
multitap: Four gamepads.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
mouse: Mouse
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
superscope: Super Scope
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
justifier: One justifier
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
justifiers: Two justifiers
|
||||
\end_layout
|
||||
|
||||
\begin_layout Subsubsection
|
||||
--gamename=<name> (lsnes/SDL)
|
||||
\end_layout
|
||||
|
|
@ -850,22 +743,6 @@ Video framerate is usually 322445/6448 fps for PAL and 10738636/178683 fps
|
|||
for NTSC.
|
||||
\end_layout
|
||||
|
||||
\end_deeper
|
||||
\begin_layout Itemize
|
||||
INTERNAL-SDMP: Internal SDMP dumper.
|
||||
\end_layout
|
||||
|
||||
\begin_deeper
|
||||
\begin_layout Itemize
|
||||
Mode 'ms': Multi-segment.
|
||||
Takes prefix.
|
||||
\end_layout
|
||||
|
||||
\begin_layout Itemize
|
||||
Mode 'ss': Single-segment.
|
||||
Takes filename.
|
||||
\end_layout
|
||||
|
||||
\end_deeper
|
||||
\begin_layout Subsubsection
|
||||
end-dump <dumper>
|
||||
|
|
|
|||
95
manual.txt
95
manual.txt
|
|
@ -4,13 +4,11 @@ lsnes is SNES rerecording emulator based on bsnes core.
|
|||
|
||||
2 Dependencies
|
||||
|
||||
1. bsnes libsnes
|
||||
1. gambatte
|
||||
|
||||
(a) v084-v087 (v084 or v085 for delayreset support)
|
||||
(a) SVN r320
|
||||
|
||||
(b) accuracy or compatiblity core with debugger enabled.
|
||||
|
||||
(c) Patched version (using included 7 patches)
|
||||
(b) Patched version (using included patch)
|
||||
|
||||
2. Zlib
|
||||
|
||||
|
|
@ -34,15 +32,14 @@ lsnes is SNES rerecording emulator based on bsnes core.
|
|||
|
||||
• Version 5.1.X or 5.2X.
|
||||
|
||||
12. G++ 4.6 (bsnes doesn't seem to like 4.7).
|
||||
12. G++ 4.6 (4.7 might also work).
|
||||
|
||||
3 Building
|
||||
|
||||
• Copy bsnes sources (the bsnes subdirectory) to subdirectory
|
||||
'bsnes'.
|
||||
• Copy gambatte sources to subdirectory 'gambatte'.
|
||||
|
||||
• Patch the bsnes sources with included patches (directory
|
||||
'bsnes-patches/<version>')
|
||||
'gambatte-patches/<version>')
|
||||
|
||||
• Edit options.build (or copy of that file)
|
||||
|
||||
|
|
@ -55,26 +52,21 @@ lsnes is SNES rerecording emulator based on bsnes core.
|
|||
|
||||
<kind> in the following can be one of:
|
||||
|
||||
• rom: Cartridge ROM (BIOS for special carts). This is required.
|
||||
• gbrom: Game Boy ROM.
|
||||
|
||||
• bsx: BS-X (non-slotted) Game flash ROM.
|
||||
• gbcrom: Game Boy Color ROM.
|
||||
|
||||
• bsxslotted: BS-X (slotted) Game flash ROM.
|
||||
|
||||
• dmg: DMG game ROM
|
||||
|
||||
• slot-a: Sufami Turbo Slot A ROM
|
||||
|
||||
• slot-b: Sufami Turbo Slot B ROM
|
||||
• gbcarom: Game Boy Color ROM (to be run with GBA initial
|
||||
register values).
|
||||
|
||||
4.1.1 --<kind>=<file> (lsnes/SDL, lsnes-avidump)
|
||||
|
||||
Load <file> as specified ROM (SFC/BS/DMG/ST file format).
|
||||
Load <file> as specified ROM (GB/GBC file format).
|
||||
|
||||
4.1.2 --<kind>-xml=<file> (lsnes/SDL, lsnes-avidump)
|
||||
|
||||
Override hardware detection for ROM, reading the values from
|
||||
<file> (BSNES XML format).
|
||||
<file> (contains extra gambatte flags).
|
||||
|
||||
4.1.3 --ips-<kind>=<file> (lsnes/SDL, lsnes-avidump)
|
||||
|
||||
|
|
@ -92,20 +84,6 @@ Set offset to apply to IPS patches. May be negative. Handy for
|
|||
applying headered IPS patches (use offset of -512 for this). The
|
||||
offset must be 0 for BPS patches.
|
||||
|
||||
4.1.6 --pal
|
||||
|
||||
Force ROM to be considered PAL-only.
|
||||
|
||||
• Only works on SNES and SGB ROMs (not BS-X or Sufami Turbo).
|
||||
|
||||
• Attempting to load NTSC movie file will error out.
|
||||
|
||||
4.1.7 --ntsc
|
||||
|
||||
Force ROM to be considered NTSC-only.
|
||||
|
||||
• Attempting to load PAL movie file will error out.
|
||||
|
||||
4.2 Session options
|
||||
|
||||
4.2.1 --pause
|
||||
|
|
@ -117,60 +95,29 @@ Start paused
|
|||
Load <filename> as movie or savestate file. All other session
|
||||
options are ignored.
|
||||
|
||||
4.2.3 --port1=<device> (lsnes/SDL)
|
||||
|
||||
Set type of port1. Valid values are:
|
||||
|
||||
• none: No device connected
|
||||
|
||||
• gamepad: One gamepad (the default)
|
||||
|
||||
• multitap: Four gamepads (warning: makes most games refuse to
|
||||
start)
|
||||
|
||||
• mouse: Mouse.
|
||||
|
||||
4.2.4 --port2=<type> (lsnes/SDL)
|
||||
|
||||
Set type of port2. Valid values are:
|
||||
|
||||
• none: No device connected (the default)
|
||||
|
||||
• gamepad: One gamepad
|
||||
|
||||
• multitap: Four gamepads.
|
||||
|
||||
• mouse: Mouse
|
||||
|
||||
• superscope: Super Scope
|
||||
|
||||
• justifier: One justifier
|
||||
|
||||
• justifiers: Two justifiers
|
||||
|
||||
4.2.5 --gamename=<name> (lsnes/SDL)
|
||||
4.2.3 --gamename=<name> (lsnes/SDL)
|
||||
|
||||
Set the name of game to <name>. Default is blank.
|
||||
|
||||
4.2.6 --author=<name> (lsnes/SDL)
|
||||
4.2.4 --author=<name> (lsnes/SDL)
|
||||
|
||||
Add author with full name of <name> (no nickname).
|
||||
|
||||
4.2.7 --author=|<name> (lsnes/SDL)
|
||||
4.2.5 --author=|<name> (lsnes/SDL)
|
||||
|
||||
Add author with nickname of <name> (no full name).
|
||||
|
||||
4.2.8 --author=<fullname>|<nickname> (lsnes/SDL)
|
||||
4.2.6 --author=<fullname>|<nickname> (lsnes/SDL)
|
||||
|
||||
Add author with full name of <fullname> and nickname of
|
||||
<nickname>.
|
||||
|
||||
4.2.9 --rtc-second=<value> (lsnes/SDL)
|
||||
4.2.7 --rtc-second=<value> (lsnes/SDL)
|
||||
|
||||
Set RTC second (0 is 1st January 1970 00:00:00Z). Default is
|
||||
1,000,000,000.
|
||||
|
||||
4.2.10 --rtc-subsecond=<value> (lsnes/SDL)
|
||||
4.2.8 --rtc-subsecond=<value> (lsnes/SDL)
|
||||
|
||||
Set RTC subsecond. Range is 0-. Unit is CPU cycle. Default is 0.
|
||||
|
||||
|
|
@ -398,12 +345,6 @@ The following dumpers are available:
|
|||
– Video framerate is usually 322445/6448 fps for PAL and
|
||||
10738636/178683 fps for NTSC.
|
||||
|
||||
• INTERNAL-SDMP: Internal SDMP dumper.
|
||||
|
||||
– Mode 'ms': Multi-segment. Takes prefix.
|
||||
|
||||
– Mode 'ss': Single-segment. Takes filename.
|
||||
|
||||
6.5.2 end-dump <dumper>
|
||||
|
||||
End dumping using <dumper>
|
||||
|
|
|
|||
Loading…
Add table
Reference in a new issue