Snes9x memory watcher / Manual

About The Tool

This is a tool to watch RAM (variables) in Snes9x (default:1.51).

Open the setting file (s9xwcnf1.txt, or s9xwcnf0.txt) (press Enter key in watch window)
Edit the setting file (see Syntax)
Reload settings (press F5 key in watch window)

Key	Function
ESC	Close watcher
Enter	Edit settings (open s9xwcnf1.txt with associated application)
Space	Edit settings (open s9xwcnf0.txt with associated application)
F1	Open manual
F5	Reload watch settings
S	SRAM snapshot (experimental)
C	Clear SRAM snapshot (experimental)

This section describes the syntax of the setting file (s9xwconf.txt).

; ASM style comment
/*
C style
comment
*/
// C++ style comment

[ROM Name / ROM Id]

Address1,Type1,Name1
Address2,Type2,Name2
----
Address3,Type3,Name3

ROM Name / ROM Id: String for identifying ROM, which written in ROM header (example: "KIRBY SUPER DELUXE" or "AKFE")
Address: Memory address of a variable (example: "7E149F", "7008EF", or "ARAM:0051")
Type: Size and type of a variable, "[1-4][s|u|x|b](*)" (example: "1u", "2s*", or "4x") (* specifies that the variable is big-endian)
Name: Name of a variable (up to 15 chars) (example: "X Velocity" or "Y Position")
----: Separator

:Key:Value1:Value2:...

Key	Value	Description
watchmax	decimal	Maximum count of the variables to display
procmax	decimal	Maximum count of the processes to display
autosize	[true\|false]	Auto resize the window
graph	[true\|false]	Use graph feature
interval	decimal (milliseconds)	Interval to update values
singlerun	[true\|false]	Disable the second run
alwaystop	[true\|false]	Display watch window always on top
fastwait	[true\|false]	Use precise timer (default:false)
priority-proc	[idle\|below-normal\|normal\|above-normal\|high\|realtime]	Priority of s9xwatch process (default:normal)
priority-thread	[idle\|even-lower\|lower\|normal\|higher\|even-higher\|realtime]	Priority of watch thread (default:idle)
priority	[idle\|even-lower\|lower\|normal\|higher\|even-higher\|realtime]	Same as priority-thread

Key	Value	Description
colbg	hex (rrggbb)	Background color
colplain	hex (rrggbb)	Text color
coladdr	hex (rrggbb)	Text color for variable address
colformat	hex (rrggbb)	Text color for variable type
colvalue	hex (rrggbb)	Text color for variable value
coldesc	hex (rrggbb)	Text color for variable description
colgraph	hex (rrggbb)	Graph color
colgraphbg	hex (rrggbb)	Graph background color
colrominfo	hex (rrggbb)	ROM info text color
fontsize	decimal (pt)	Font size
fontfamily	string	Font family (must be monospace font)

Key	Value	Description
target	string (filename), hex (Memory address), hex (RAM offset from Memory), hex (SRAM offset from Memory), hex (FillRAM offset from Memory), hex (ROMName offset), hex (ROMId offset), hex (IAPU.RAM address)	Define new Snes9x (advanced)

See you next mission!

rev.13 (2007-08-16)
- Fixed to truncate header name to 21 bytes
- Packed default settings to exe
- Added auto-size feature
rev.12 (2007-07-01)
- Snes9x 1.51 compatible SRAM/FillRAM/ARAM watch (s9xwcnf0.txt has changed)
- Uses cool Mario icon, presented by ZaKaR on deviantART
rev.11 (2007-05-31)
- Divided setting file into two files
- Changed default emulator to Snes9x 1.51
- Prepare for Super FX RAM watch (I cannot implement the watch, since I don't know its memory mapping. I need a help)
rev.10 (2007-05-02)
- Added big-endian support
- Some minor changes
rev.9 (2007-02-24)
- Some minor changes
rev.8 (2007-01-03)
- Added watches-per-game feature
- Added graph feature
- Some minor changes
rev.7 (2007-01-01)
- Some minor changes
rev.6 (2006-12-10)
- Added font family setting
- Added shiftoffset option
- Added separator support (----)
- Added SRAM support (for Ganbare Goemon 3)
- Added SRAM snapshot function (experimental)
rev.5 (2006-10-28)
- Added ARAM watching function
- Added font size setting
- Changed default color settings
rev.4 (2006-10-07)
- Added settings (fastwait/priority)
rev.3 (2006-10-05)
- Added more settings
rev.2 (2006-09-29)
- Fixed unsigned 4bytes value display
- Added watch interval setting
rev.1 (2006-09-28)
- First release