3 lsnes is SNES rerecording emulator based on bsnes core.
7 1. bsnes libsnes (for bsnes SNES core)
9 (a) v084-v087 (v084 or v085 for delayreset support)
11 (b) accuracy or compatiblity core with debugger enabled.
13 (c) Patched version (using included 7 patches)
15 2. gambatte (for gambatte core)
19 (b) Patched with included patches
27 6. boost_thread (if native std::thread is not available)
31 8. sdlmain (SDL only, part of SDL)
33 9. boost_conversion (this is header-only library)
35 10. libswscale (wxwidgets graphics only)
37 11. Portaudio (portaudio sound only)
39 12. libao (libao sound only)
41 13. Lua (if Lua support is needed).
43 • Version 5.1.X or 5.2X.
45 14. G++ 4.6 (bsnes doesn't seem to like 4.7, status for gambatte
50 • Copy bsnes sources (the bsnes subdirectory) to subdirectory
51 'bsnes' (for bsnes core).
53 • Copy gambatte sources to subdirectory 'gambatte' (for gambatte
56 • Patch the bsnes sources with included patches (directory
57 'bsnes-patches/<version>', bsnes core)
59 • Patch the gambatte sources with included patches (directory
60 'gambatte-patches/<version>', gambatte core)
62 • Edit options.build (or copy of that file)
64 • Run make (passing 'OPTIONS=<filename>' if using something else
67 4 Command line options
71 4.1.1 --rom=<file> (lsnes/SDL, lsnes/wxwidgets, lsnes-avidump)
81 4.2.2 <filename> (lsnes/SDL, lsnes-avidump, movieinfo)
83 Load <filename> as movie or savestate file. All other session
86 4.2.3 --port1=<device> (lsnes/SDL, bsnes core only)
88 Set type of port1. Valid values are:
90 • none: No device connected
92 • gamepad: One gamepad (the default)
94 • multitap: Four gamepads (warning: makes most games refuse to
99 4.2.4 --port2=<type> (lsnes/SDL, bsnes core only)
101 Set type of port2. Valid values are:
103 • none: No device connected (the default)
105 • gamepad: One gamepad
107 • multitap: Four gamepads.
111 • superscope: Super Scope
113 • justifier: One justifier
115 • justifiers: Two justifiers
117 4.2.5 --gamename=<name> (lsnes/SDL)
119 Set the name of game to <name>. Default is blank.
121 4.2.6 --author=<name> (lsnes/SDL)
123 Add author with full name of <name> (no nickname).
125 4.2.7 --author=|<name> (lsnes/SDL)
127 Add author with nickname of <name> (no full name).
129 4.2.8 --author=<fullname>|<nickname> (lsnes/SDL)
131 Add author with full name of <fullname> and nickname of
134 4.2.9 --rtc-second=<value> (lsnes/SDL)
136 Set RTC second (0 is 1st January 1970 00:00:00Z). Default is
139 4.2.10 --rtc-subsecond=<value> (lsnes/SDL)
141 Set RTC subsecond. Range is 0-. Unit is CPU cycle. Default is 0.
143 4.2.11 --anchor-savestate=<file> (lsnes/SDL)
145 Set the anchor savestate file.
147 4.2.12 --load=<file> (lsnes/wxwidgets)
149 After loading the ROM, load <file> as savestate/movie.
153 4.3.1 --run=<file> (lsnes/SDL)
155 After running main RC file, run this file. If multiple are
156 specified, these execute in order specified.
158 4.4 dump options (lsnes-dumpavi only)
160 4.4.1 --dumper=<dumper>
162 Set the dumper to use (required). Use 'list' for listing of known
167 Set the mode to use (required for dumpers with multiple modes,
168 forbidden otherwise). Use 'list' for known modes.
170 4.4.3 --prefix=<prefix>
172 Set dump prefix. Default is “avidump”.
174 4.4.4 --option=<name>=<value>
176 Set option <name> to value <value>.
178 4.4.5 --length=<length>
180 Set number of frames to dump. Mandatory.
184 Run specified lua script (lsnes-dumpavi does not have
185 initialization files).
187 4.4.7 --load-library=<library>
189 Load the specified shared object / dynamic library / dynamic link
192 5 Startup file lsnes.rc
194 Upon startup, lsnes (lsnes/SDL only) executes file lsnes.rc as
195 commands. This file is located in:
197 • Windows: %APPDATA%\lsnes\lsnes.rc (if %APPDATA% exists)
199 • Unix: $XDG_CONFIG_HOME/lsnes/lsnes.rc (if $XDG_CONFIG_HOME
202 • Unix: $HOME/.config/lsnes/lsnes.rc (if $HOME exists)
204 • All: ./lsnes.rc (fallback default).
206 If leading directories do not exist, attempt to create them is
211 • Commands beginning with '*' invoke the corresponding command
212 without alias expansion.
214 • If command starts with '+' (after possible '*'), the command is
215 executed as-is when button is pressed, and when button is
216 released, it is executed with '+' replaced by '-'.
218 • Commands without '+' execute only on negative edge (release).
220 6.1 run-script <script>
222 Run <script> as if commands were entered on the command line.
224 6.2 Memory manipulation
226 <address> may be decimal or hexadecimal (prefixed with '0x').
227 <value> can be hexadecimal (prefixed with '0x'), unsigned or
228 signed (prefixed with '-') decimal.
230 The available element <sizes> are:
240 When reading RAM and ROM, multi-byte reads/writes are big-endian.
241 When dealing with DSP memory, multi-byte reads/writes are
242 native-endian (do not use operand sizes exceeding DSP bitness,
243 except dword is OK for 24-bit memory).
245 6.2.1 read-<size> <address>
247 Read the value of byte in <address>.
249 6.2.2 read-s<size> <address>
251 Read the value of signed byte in <address>.
253 6.2.3 write-<size> <address> <value>
255 Write <value> to byte in address <address>.
259 These commands are not available in lsnesrc, but are available
260 after ROM has been loaded.
262 6.3.1 quit-emulator [/y]
264 Quits the emulator (asking for confirmation). If /y is given, no
265 confirmation is asked.
269 Toggle paused/unpaused
273 Advance frame. If the button is still held after configurable
274 timeout expires, game unpauses for the duration frame advance is
279 Advance subframe. If the button is still held after configurable
280 timeout expires, game unpauses for the duration frame advance is
283 6.3.5 advance-skiplag
285 Skip to first poll in frame after current.
289 Reset the SNES after this frame.
291 6.3.7 load <filename>
293 Load savestate <filename> in current mode.
295 6.3.8 load-state <filename>
297 Load savestate <filename> in readwrite mode.
299 6.3.9 load-readonly <filename>
301 Load savestate <filename> in readonly mode.
303 6.3.10 load-preserve <filename>
305 Load savestate <filename> in readonly mode, preserving current
308 6.3.11 load-movie <filename>
310 Load savestate <filename>, ignoring save part in readonly mode.
312 6.3.12 save-state <filename>
314 Save system state to <filename> as soon as possible.
316 6.3.13 save-movie <filename>
318 Save movie to <filename>.
330 Toggle between read-only and read-write modes.
332 6.3.17 test-1, test-2, test-3
334 Internal test commands. Don't use.
336 6.3.18 take-screenshot <filename>
338 Save screenshot to <filename>.
340 6.3.19 +controller <class>-<#>-<button>
342 Press button <button> on controller <num> of class <class>.
344 • Class 'gamepad': A, B, X, Y, L, R, select, start, up, down,
345 left, right, ext0, ext1, ext2, ext3
347 • Class 'mouse': L, R
349 • Class 'superscope': trigger, cursor, turbo, pause
351 • Class 'justifier': trigger, start
353 • Class 'gb': A, B, select, start, up, down, left, right
355 6.3.20 hold-controller <class>-<#>-<button>
357 Hold/unhold button <button> on controller <num> of class <class>.
359 6.3.21 type-controller <class>-<#>-<button>
361 Hold/unhold button <button> on controller <num> of class <class>
362 for the next frame. See +controller for button names.
364 Cauntion: Does not work properly if outside frame advance.
366 6.3.22 designate-position <class>-<#>-analog<n>
368 Designate position for analog pair. <n> is only there if there
369 are multiple axis pairs.
371 6.3.23 autofire (<pattern>|-)...
373 Set autofire pattern. Each parameter is comma-separated list of
374 button names to hold on that frame. After reaching the end of
375 pattern, the pattern restarts from the beginning.
383 6.4.1 cycle-jukebox-backward
385 Cycle save jukebox backwards.
387 6.4.2 cycle-jukebox-forward
389 Cycle save jukebox forwards
393 Do load from jukebox (current mode).
397 Do state save to jukebox.
401 Only available if lua support is compiled in.
403 6.5.1 evaluate-lua <luacode>
405 Run Lua code <luacode> using built-in Lua interpretter.
407 6.5.2 run-lua <script>
409 Run specified lua file using built-in Lua interpretter.
413 Clear the Lua VM state and restore to factory defaults.
417 6.6.1 add-watch <name> <expression>
419 Adds new watch (or modifies old one).
421 6.6.2 remove-watch <name>
427 6.7.1 enable-sound <on/off>
429 Enable/Disable sound.
431 6.7.2 set-volume <multiplier>
433 Set the volume multiplier to <multiplier>. 1 is normal volume,
434 and higher numbers are louder.
436 6.7.3 set-volume <multiplier>%
438 Set the volume multiplier to <multiplier> percent. 100 is normal
439 volume, and higher numbers are louder.
441 6.7.4 set-volume <multiplier>dB
443 Set the volume multiplier to <multiplier> dB. 0 is normal volume,
444 and higher numbers are louder. The value may be negative.
448 6.8.1 reload-rom [<file>]
450 Reloads the main ROM image from <file>.
454 Tangent for recording voice for commentary track. While pressed,
463 Set where bsnes looks for firmware files. Default is “.”.
467 Set the target . Numeric, range is 0.001 to “infinite”. Default
470 7.1.3 savecompression
472 Set save compression level (integer 0-9). Default is 7 (0 is no
475 7.1.4 advance-timeout
477 Set the frame advance timeout in milliseconds. Numeric integer,
478 range is 0-999999999. Default is 500.
480 7.1.5 allow-inconsistent-saves (bsnes only)
482 If true, save without synchronization. Makes games seriously
485 7.1.6 save-every-frame (bsnes only)
487 If true, simulate saving on each frame. Trades off emulation
488 accuracy for sync stability. Also needed if the movie assumes
489 saving on each frame for rewind.
491 7.2 AVI dumper settings
495 AVI dumper: Always dump at 512x448 or 512x478 regardless of what
498 7.2.2 avi-left-border
500 AVI dumper: Set the default left border thickness (unless lua
501 overrides) for dumps. Range 0-8191. Default is 0.
503 7.2.3 avi-right-border
505 AVI dumper: Set the default right border thickness (unless lua
506 overrides) for dumps. Range 0-8191. Default is 0.
510 AVI dumper: Set the default top border thickness (unless lua
511 overrides) for dumps. Range 0-8191. Default is 0.
513 7.2.5 avi-bottom-border
515 AVI dumper: Set the default bottom border thickness (unless lua
516 overrides) for dumps. Range 0-8191. Default is 0.
520 AVI dumper: Maximum number of frames per dump segment (0 =>
521 unlimited). Range 0-999999999. Default is 0.
523 7.2.7 avi-compresison
525 AVI dumper: Compression level (0-18).
527 • Compression levels 10 and above are not compatible with stock
530 • Recomended level is 7.
534 AVI dumper: Set method of determining the sound rate.
536 • 0: Pick nearest of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, 48,
537 64, 88.2, 96, 128, 176.4 and 192 kHz.
539 • 1: Round down to nearest integer.
541 • 2: Round up to nearest ingeter.
547 JMD dumper: Compression level (0-9).
549 7.4 SDL platform settings
551 7.4.1 autorepeat-first-delay
553 Sets the delay for first character in typematic autorepeat.
555 7.4.2 autorepeat-subsequent-delay
557 Sets the delay for subsequent characters in typematic autorepeat.
561 8.1 Core (in main table)
565 Print line to message console.
567 8.1.2 exec(string command)
569 Run command as it was entered on the command line
573 Returns two values. First is time since some epoch in seconds,
574 the second is microseconds mod 10^6 since that epoch.
576 8.1.4 emulator_ready()
578 Returns true if emulator has finished booting, false if not
579 (on_startup() will be issued later).
581 8.1.5 set_idle_timeout(number timeout)
583 Set number of microseconds to block idle for. After this timeout
584 has expired, on_idle() will be called once.
586 8.1.6 set_timer_timeout(number timeout)
588 Set number of microseconds to block timer for. After this timeout
589 has expired, on_timer() will be called once.
591 8.1.7 bus_address(number snesaddr)
593 Returns virtual address corresponding to specified address on
596 8.1.8 loopwrapper(function fun, ...)
598 Calls function fun with function and specified arguments. The
599 function passed suspends execution until the function returned is
600 called. Handy for linear flow control among multiple invocations
601 of a hook. Example code:
603 on_paint = loopwrapper(function(wait)
607 gui.text(0, 0, “Test!”);
617 Bitwise logical functions and related.
619 8.2.1 bit.none(number...) / bit.bnot(number...)
621 48-bit bitwise NOT / NONE function (set bits that are set in none
624 8.2.2 bit.any(number...) / bit.bor(number...)
626 48-bit bitwise OR / ANY function (set bits that are set in any of
629 8.2.3 bit.all(number...) / bit.band(number...)
631 48-bit bitwise AND / ALL function (set bits that are set in all
634 8.2.4 bit.parity(number...) / bit.bxor(number...)
636 48-bit bitwise XOR / PARITY function (set bits that are set in
637 odd number of the arguments).
639 8.2.5 bit.lrotate(number base[, number amount[, number bits]])
641 Rotate bits-bit (max 48, default 48) number left by amount
644 8.2.6 bit.rrotate(number base[, number amount[, number bits]])
646 Rotate bits-bit (max 48, default 48) number right by amount
649 8.2.7 bit.lshift(number base[, number amount[, number bits]])
651 Shift bits-bit (max 48, default 48) number left by amount
652 (default 1) places. The new bits are filled with zeroes.
654 8.2.8 bit.lrshift(number base[, number amount[, number bits]])
656 Shift bits-bit (max 48, default 48) number logically right by
657 amount (default 1) places. The new bits are filled with zeroes.
659 8.2.9 bit.arshift(number base[, number amount[, number bits]])
661 Shift bits-bit (max 48, default 48) number arithmetically right
662 by amount (default 1) places. The new bits are shifted in with
663 copy of the high bit.
665 8.2.10 bit.extract(number base[, number bit0[, number bit1,...]])
667 Returns number that has bit0-th bit as bit 0, bit1-th bit as 1
672 • Bit numbers up to 51 should work reliably (then things start
673 falling apart due to double precision issues).
675 • There are two special bit positions, true and false, standing
676 for always set bit and always clear bit.
678 8.2.11 bit.value([number bit1[, number bit2,...]])
680 Returns bitwise OR of 1 left shifted by bit1 places, 1 left
681 shifted by bit2 places and so on. As special value, nil argument
686 Most of these functions can only be called in on_paint and
687 on_video callbacks. Exceptions are noted.
689 Colors are 32-bit. Bits 0-7 are the blue component, bits 8-15 are
690 the green component, bits 16-23 are the red component, bits 24-31
691 are alpha component (0 is fully opaque, 255 is almost
692 transparent). -1 is the fully transparent color. Alpha values
693 greater than 127 do work.
695 Origin of coordinates is at top left corner of game display area.
696 Left and top gaps correspond to negative coordinates.
698 8.3.1 gui.resolution()
700 Returns 2-tuple (hresolution, vresolution).
702 8.3.2 gui.<class>_gap(number gap)
704 Set the <class> (left, right, top, bottom) gap to specified value
707 8.3.3 gui.text(number x, number y, string text[, number fgc[,
710 Draw specified text on the GUI (each character cell is 8 or 16
711 wide and 16 high). Parameters:
713 • x: X-coordinate to start the drawing from (and x-coordinate at
714 begining of the lines).
716 • y: Y-coordinate to start the drawing from.
718 • text: The text to draw.
720 • fgc: Text color (default is 0xFFFFFF (white))
722 • bgc: Background color (default is -1 (transparent))
724 8.3.4 gui.textH(number x, number y, string text[, number fgc[,
727 Like gui.text, but draw using double-width.
729 8.3.5 gui.textV(number x, number y, string text[, number fgc[,
732 Like gui.text, but draw using double-height.
734 8.3.6 gui.textHV(number x, number y, string text[, number fgc[,
737 Like gui.text, but draw using double-width/double-height.
739 8.3.7 gui.rectangle(number x, number y, number width, number
740 height[, number thickness[, number outline[, number fill]]])
742 Draw rectangle on the GUI. Parameters:
744 • x: X-coordinate of left edge.
746 • y: Y-coordinate of upper edge.
748 • width: Width of rectangle.
750 • height: Height of rectangle.
752 • thickness: Thickness of outline (default is 1).
754 • outline: Color of outline (default is 0xFFFFFF (white))
756 • fill: Color of fill (default is -1 (transparent))
758 8.3.8 gui.box(number x, number y, number width, number height[,
759 number thickness[, number outline1[,number outline2[, number
762 Draw rectangle with 3D effect on the GUI. Parameters:
764 • x: X-coordinate of left edge.
766 • y: Y-coordinate of upper edge.
768 • width: Width of rectangle.
770 • height: Height of rectangle.
772 • thickness: Thickness of outline (default is 1).
774 • outline1: First color of outline (default is 0xFFFFFF (white))
776 • outline2: First color of outline (default is 0x808080 (dark
779 • fill: Color of fill (default is 0xC0C0C0 (light grayy))
781 8.3.9 gui.pixel(number x, number y[, number color])
783 Draw one pixel on the GUI. Parameters:
785 • x: X-coordinate of the pixel
787 • y: Y-coordinate of the pixel
789 • color: Color of the pixel (default is 0xFFFFFF (white))
791 8.3.10 gui.crosshair(number x, number y[, number length[, number
794 Draw a crosshair. Parameters:
796 • x: X-coordinate of the crosshair
798 • y: Y-coordinate of the crosshair
800 • length: Length of the crosshair lines (default 10).
802 • color: Color of the crosshair (default is 0xFFFFFF (white))
804 8.3.11 gui.line(number x1, number y1, number x2, number y2[,
807 Draw a thin line. Parameters:
809 • x1: X-coordinate of one end.
811 • y1: Y-coordinate of one end.
813 • x2: X-coordinate of the other end.
815 • y2: Y-coordinate of the other end.
817 • color: Color of the line (default is 0xFFFFFF (white)).
819 8.3.12 gui.circle(number x, number y, number r[, number thick[,
820 number border[, number fil]]])
822 Draw a circle. Parameters.
824 • x: X-coordinate of the center
826 • y: Y-coordinate of the center
828 • r: The radius of the circle
830 • thick: Border thickness
832 • border: Border color (default is 0xFFFFFF (white))
834 • fill: Fill color (default is -1 (transparent)).
836 8.3.13 gui.bitmap_draw(number x, number y, bitmap bitmap, palette
839 Draw a bitmap on screen with specified palette. Parameters:
841 • x: X-coordinate of left edge.
843 • y: Y-coordinate of top edge.
845 • bitmap: The bitmap to draw
847 • palette: The palette to draw the bitmap using.
849 8.3.14 gui.bitmap_draw(number x, number y, dbitmap bitmap)
851 Draw a bitmap on screen. Parameters:
853 • x: X-coordinate of left edge.
855 • y: Y-coordinate of top edge.
857 • bitmap: The bitmap to draw
859 8.3.15 gui.palette_new()
861 Returns a new palette (initially all transparent). Can be used
864 8.3.16 gui.bitmap_new(number w, number h, boolean direct[, bool
867 Returns a new bitmap/dbitmap. Can be used anywhere. Parameters:
869 • w: The width of new bitmap
871 • h: The height of new bitmap
873 • direct: If true, the returned bitmap is dbitmap, otherwise
876 • icolor: Initital fill color (defaults to 0 on BITMAP, -1 on
879 8.3.17 gui.bitmap_load(string file)
881 Returns loaded bitmap/dbitmap (if bitmap, the second return value
882 is palette for bitmap). Can be used anywhere. Parameters:
884 • file: The name of file to load.
886 8.3.18 gui.palette_set(palette palette, number index, number
889 Sets color in palette. Can be used anywhere. Parameters:
891 • palette: The palette to manipulate
893 • index: Index of color (0-65535).
895 • color: The color value.
897 8.3.19 gui.bitmap_pset(bitmap/dbitmap bitmap, number x, number y,
900 Sets specified pixel in bitmap. Can be used anywhere. Parameters:
902 • bitmap: The bitmap to manipulate
904 • x: The x-coordinate of the pixel.
906 • y: The y-coordinate of the pixel.
908 • color: If bitmap is a bitmap, color index (0-65535). Otherwise
911 8.3.20 gui.bitmap_size(bitmap/dbitmap bitmap)
913 Get size of bitmap. Can be used anywhere. Parameters:
915 • bitmap: The bitmap to query.
917 The first return is the width, the second is the height.
919 8.3.21 gui.bitmap_blit(bitmap/dbitmap dest, number dx, number dy,
920 bitmap/dbitmap src, number sx, number sy, number w, number h[,
923 Blit a part of bitmap to another. Can be used anywhere.
926 • dest: Destination to blit to.
928 • dx: left edge of target
930 • dy: Top edge of target
932 • src: The source to blit from. Must be of the same type as
935 • sx: left edge of source
937 • sy: Top edge of source
941 • h: Height of region.
943 • ck: Color key. Pixels of this color are not blitted.
945 – If bitmaps are bitmaps, this is color index of colorkey.
946 Values outside range 0-65535 cause no key to be used as
949 – If bitmaps are dbitmaps, this color value of colorkey.
951 – May be absent or nil for no colorkey blit.
955 Request on_repaint() to happen as soon as possible. Can be used
958 8.3.23 gui.subframe_update(boolean on)
960 Request subframe updates (calling on_paint() on subframes) to
961 happen (on=true) or not happen (on=false). Can be used anywhere.
963 8.3.24 gui.screenshot(string filename)
965 Write PNG screenshot of the current frame (no drawings) to
966 specified file. Can be used anywhere.
968 8.3.25 gui.color(number r, number g, number b[, number a])
970 Returns color (in notation Lua scripts use) corresponding to
971 color (r,g,b), each component in scale 0-255. If a is specified,
972 that is alpha (0 is fully transparent, 256(sic) is fully opaque).
973 The default alpha is 256.
975 8.3.26 gui.status(string name, string value)
977 Set status field “L[<name>]” to <value> in status area. Can be
980 8.3.27 gui.rainbow(number step, number steps[, number color])
982 Perform hue rotation of color <color> (default bright red), by
983 <step> steps. The number of steps per full rotation is given by
984 absolute value of <steps>.
986 If <steps> is negative, the rotation will be counterclockwise.
988 8.3.28 gui.screenshot(string filename)
990 Saves a screenshot into specified file.
994 Input handling. Only available in on_input callback.
996 8.4.1 input.get(number controller, number index)
998 Read the specified index (0-11) from specified controller (0-7).
1001 • Uses physical controller numbering. Gamepad in port 2 is
1002 controller 4, not 1!
1004 8.4.2 input.set(number controller, number index, number value)
1006 Write the specified index (0-11) from specified controller (0-7),
1007 storing value. Notes:
1009 • Uses physical controller numbering. Gamepad in port 2 is
1010 controller 4, not 1!
1012 8.4.3 input.geta(number controller)
1014 Get input state for entiere controller. Returns 13 return values.
1016 • 1st return value: Bitmask: bit i is set if i:th index is
1019 • 2nd-13th return value: value of i:th index.
1021 8.4.4 input.seta(number controller, number bitmask, number
1024 Set state for entiere controller. args is up to 12 values for
1025 indices (overriding values in bitmask if specified).
1027 8.4.5 input.controllertype(number controller)
1029 Get the type of controller as string. Valid values are:
1039 8.4.6 input.reset([number cycles])
1041 Execute reset. If cycles is greater than zero, do delayed reset.
1042 0 (or no value) causes immediate reset.
1044 • Only available with subframe flag false.
1048 Returns table of tables of all available keys and axes. The first
1049 table is indexed by key name (platform-dependent!), and the inner
1050 table has the following fields:
1052 • value: Last reported value for control
1054 – For keys: 1 for pressed, 0 for released.
1056 – For axes: -32767...32767.
1058 – For presure-sensitive buttons: 0...32767.
1060 – For hats: Bitmask: 1=>Up, 2=>Right, 4=>Down, 8=>Left.
1062 – For mouse: Coordinates relative to game area.
1064 • ktype: Type of key (disabled, key, mouse, axis, axis-inverse,
1065 hat, pressure-m0, pressure-mp, pressure-0m, pressure-0p,
1066 pressure-pm, pressure-p0).
1068 8.4.8 input.keyhook(string key, boolean state)
1070 Requests that keyhook events to be sent for key (state=true) or
1071 not sent (state=false).
1073 8.4.9 input.joyget(number controller)
1075 Returns table for current controls for specified controller. The
1076 names of fields vary by controller type.
1078 • The buttons have the same name as those are referred to in
1079 other contexts in the emulator
1081 • The analog axes are “xaxis” and “yaxis”.
1083 8.4.10 input.joyset(number controller, table controls)
1085 Set the the state of specified controller to values specified in
1088 8.4.11 input.lcid_to_pcid(number controller)
1090 Return the physical index, physical port and controller number in
1091 port for specified (1-based) logical controller.
1095 Various keybinding-related functions
1097 8.5.1 keyboard.bind(string mod, string mask, string key, string
1100 Bind specified key with specified modifers to specified command.
1102 8.5.2 keyboard.unbind(string mod, string mask, string key)
1104 Unbind specified key with specified modifers.
1106 8.5.3 keyboard.alias(string alias, string expansion)
1108 Set expansion of given command.
1114 8.6.1 subtitle.byindex(number i)
1116 Read the frame and length of ith subtitle. Returns nothing if not
1119 8.6.2 subtitle.set(number f, number l, string txt)
1121 Set the text of subtitle.
1123 8.6.3 subtitle.get(number f, number l)
1125 Get the text of subtitle.
1127 8.6.4 subtitle.delete(number f, number l)
1129 Delete specified subtitle.
1131 8.7 Table hostmemory
1133 Host memory handling (extra memory saved to savestates). Host
1134 memory starts empty.
1136 8.7.1 hostmemory.read(number address)
1138 Reads hostmemory slot address. Slot numbers out of range return
1139 false instead of numeric.
1141 8.7.2 hostmemory.write(number address, number value)
1143 Writes hostmemory slot with 0-255. Slot numbers out of range
1144 cause extension of host memory slot space.
1146 8.7.3 hostmemory.readbyte(number address)
1148 Read unsigned byte (1 element) from given address. Slots out of
1151 8.7.4 hostmemory.writebyte(number address, number value)
1153 Write unsigned byte (1 element) to given slot. Slot numbers out
1154 of range cause extension.
1156 8.7.5 hostmemory.readsbyte(number address)
1158 Read signed byte (1 element) from given address. Slots out of
1161 8.7.6 hostmemory.writesbyte(number address, number value)
1163 Write signed byte (1 element) to given slot. Slot numbers out of
1164 range cause extension.
1166 8.7.7 hostmemory.readword(number address)
1168 Read unsigned word (2 elements) from given address. Slots out of
1171 8.7.8 hostmemory.writeword(number address, number value)
1173 Write unsigned word (2 elements) to given slot. Slot numbers out
1174 of range cause extension.
1176 8.7.9 hostmemory.readsword(number address)
1178 Read signed word (2 elements) from given address. Slots out of
1181 8.7.10 hostmemory.writesword(number address, number value)
1183 Write signed word (2 elements) to given slot. Slot numbers out of
1184 range cause extension.
1186 8.7.11 hostmemory.readdword(number address)
1188 Read unsigned doubleword (4 elements) from given address. Slots
1189 out of range return false.
1191 8.7.12 hostmemory.writedword(number address, number value)
1193 Write unsigned doubleword (4 elements) to given slot. Slot
1194 numbers out of range cause extension.
1196 8.7.13 hostmemory.readsdword(number address)
1198 Read signed doubleword (4 elements) from given address. Slots out
1199 of range return false.
1201 8.7.14 hostmemory.writesdword(number address, number value)
1203 Write signed doubleword (4 elements) to given slot. Slot numbers
1204 out of range cause extension.
1206 8.7.15 hostmemory.readqword(number address)
1208 Read unsigned quadword (8 elements) from given address. Slots out
1209 of range return false.
1211 8.7.16 hostmemory.writeqword(number address, number value)
1213 Write unsigned quadword (4 elements) to given slot. Slot numbers
1214 out of range cause extension.
1216 8.7.17 hostmemory.readsqword(number address)
1218 Read signed quadword (8 elements) from given address. Slots out
1219 of range return false.
1221 8.7.18 hostmemory.writesqword(number address, number value)
1223 Write signed quadword (8 elements) to given slot. Slot numbers
1224 out of range cause extension.
1230 8.8.1 movie.currentframe()
1232 Return number of current frame.
1234 8.8.2 movie.framecount()
1236 Return number of frames in movie.
1238 8.8.3 movie.readonly()
1240 Return true if in readonly mode, false if in readwrite.
1242 8.8.4 movie.rerecords()
1244 Returns the current value of rerecord count.
1246 8.8.5 movie.set_readwrite()
1248 Set readwrite mode (does not cause on_readwrite callback).
1250 8.8.6 movie.frame_subframes(number frame)
1252 Count number of subframes in specified frame (frame numbers are
1253 1-based) and return that.
1255 8.8.7 movie.read_subframe(number frame, number subframe)
1257 Read specifed subframe in specified frame and return data as
1258 array (100 elements, numbered 0-99 currently).
1260 8.8.8 movie.read_rtc()
1262 Returns the current value of the RTC as a pair (second,
1265 8.8.9 movie.unsafe_rewind([UNSAFEREWIND state])
1267 Start setting point for unsafe rewind or jump to point of unsafe
1270 • If called without argument, causes emulator to start process of
1271 setting unsafe rewind point. When this has finished, callback
1272 on_set_rewind occurs, passing the rewind state to lua script.
1274 • If called with argument, causes emulator rewind to passed
1275 rewind point as soon as possible. Readwrite mode is implicitly
1278 The following warnings apply to unsafe rewinding:
1280 • There are no safety checks against misuse (that's what “unsafe”
1283 • Only call rewind from timeline rewind point was set from.
1285 • Only call rewind from after the rewind point was set.
1289 Routines for settings manipulation
1291 8.9.1 settings.get(string name)
1293 Get value of setting. If setting is blank, returns false. If
1294 setting value can't be obtained, returns (nil, error message).
1296 8.9.2 settings.set(string name, string value)
1298 Set value of setting. If setting can't be set, returns (nil,
1301 8.9.3 settings.is_set(string name)
1303 Returns if setting is set. If setting does not exist, returns
1304 (nil, error message).
1306 8.9.4 settings.blank(string name)
1308 Blanks a setting and returns true. If setting can't be blanked,
1309 returns (nil, error message).
1313 Contains various functions for managing memory
1315 8.10.1 memory.vma_count()
1317 Returns the number of VMAs
1319 8.10.2 memory.read_vma(number index)
1321 Reads the specified VMA (indices start from zero). Trying to read
1322 invalid VMA gives nil. The read VMA is table with the following
1325 • region_name (string): The readable name of the VMA
1327 • baseaddr (number): Base address of the VMA
1329 • lastaddr (number): Last address in the VMA.
1331 • size (number): The size of VMA in bytes.
1333 • readonly (boolean): True of the VMA corresponds to ROM.
1335 • iospace (boolean): True if the VMA is I/O space.
1337 • native_endian (boolean): True if the VMA has native endian as
1338 opposed to little endian.
1340 8.10.3 memory.find_vma(number address)
1342 Finds the VMA containing specified address. Returns table in the
1343 same format as read_vma or nil if not found.
1345 8.10.4 memory.readbyte(number address)
1347 Reads the specified address as unsigned byte and returns the
1350 8.10.5 memory.readsbyte(number address)
1352 Reads the specified address as signed byte and returns the
1355 8.10.6 memory.writebyte(number address, number value)
1357 Writes the specified value (negative values undergo 2's
1358 complement) to specified address (as a byte).
1360 8.10.7 memory.readword(number address)
1362 Reads the specified address as unsigned word and returns the
1365 8.10.8 memory.readsword(number address)
1367 Reads the specified address as signed word and returns the
1370 8.10.9 memory.writeword(number address, number value)
1372 Writes the specified value (negative values undergo 2's
1373 complement) to specified address (as a word).
1375 8.10.10 memory.readdword(number address)
1377 Reads the specified address as unsigned doubleword and returns
1380 8.10.11 memory.readsdword(number address)
1382 Reads the specified address as signed doubleword and returns the
1385 8.10.12 memory.writedword(number address, number value)
1387 Writes the specified value (negative values undergo 2's
1388 complement) to specified address (as a doubleword).
1390 8.10.13 memory.readqword(number address)
1392 Reads the specified address as unsigned quadword and returns the
1395 8.10.14 memory.readsqword(number address)
1397 Reads the specified address as signed quadword and returns the
1400 8.10.15 memory.writeqword(number address, number value)
1402 Writes the specified value (negative values undergo 2's
1403 complement) to specified address (as a quadword).
1405 8.10.16 memory.hash_region(number base, number size)
1407 Hash specified number of bytes starting from specified address
1408 and return the SHA-256.
1410 8.10.17 memory.hash_state()
1412 Hash the current system state. Mainly useful for debugging
1415 8.10.18 memory.readregion(number base, number size)
1417 Read a region of memory.
1419 • Warning: If the region crosses VMA boundary, the results are
1422 8.10.19 memory.map<type>([number base, number size])
1424 Returns a table mapping specified memory aperture for read/write.
1425 If parameters are omitted, entiere map space is the aperture.
1427 • Type may be one of: byte, sbyte, word, sword, dword, sdword,
1430 8.10.20 memory.writeregion(number base, number size, table data)
1432 Write a region of memory.
1434 • Warning: If the region crosses VMA boundary, the results are
1437 8.10.21 memory.map_struct()
1439 Returns a new mapping structure (MMAP_STRUCT)
1441 8.10.22 MMAP_STRUCT(string key, number address, string type)
1443 Bind key in mmap structure to specified address with specified
1446 • Type may be one of: byte, sbyte, word, sword, dword, sdword,
1449 8.10.23 memory.read_expr(string expr)
1451 Evaluate specified watch expression and return result
1455 Contains functions for manipulating subtitles.
1457 8.11.1 subtitle.byindex(number index)
1459 Get (basetime, length) pair of specified subtitle index or
1460 nothing if index isn't valid.
1462 8.11.2 subtitle.get(number basetime, number length)
1464 Read the specified subtitle. Returns “” if the subtitle does not
1467 8.11.3 subtitle.set(number basetime, number length, string
1470 Set the specified subtitle.
1472 8.11.4 subtitle.deltete(number basetime, number length)
1474 Delete the specified subtitle.
1478 Contains copy of global variables from time of Lua
1479 initialization. Non-writeable.
1483 Various callbacks to Lua that can occur.
1485 8.13.1 Callback: on_paint(bool not_synth)
1487 Called when screen is being painted. Any gui.* calls requiring
1488 graphic context draw on the screen.
1490 not_synth is true if this hook is being called in response to
1491 received frame, false otherwise.
1493 8.13.2 Callback: on_video()
1495 Called when video dump frame is being painted. Any gui.* calls
1496 requiring graphic context draw on the video.
1498 8.13.3 Callback: on_frame_emulated()
1500 Called when emulating frame has completed and
1501 on_paint()/on_video() calls are about to be issued.
1503 8.13.4 Callback: on_frame()
1505 Called on each starting whole frame.
1507 8.13.5 Callback: on_startup()
1509 Called when the emulator is starting (lsnes.rc and --run files
1512 8.13.6 Callback: on_rewind()
1514 Called when rewind movie to beginning has completed.
1516 8.13.7 Callback: on_pre_load(string name)
1518 Called just before savestate/movie load occurs (note: loads are
1519 always delayed, so this occurs even when load was initiated by
1522 8.13.8 Callback: on_err_load(string name)
1524 Called if loadstate goes wrong.
1526 8.13.9 Callback: on_post_load(string name, boolean was_savestate)
1528 Called on successful loadstate. was_savestate gives if this was a
1529 savestate or a movie.
1531 8.13.10 Callback: on_pre_save(string name, boolean is_savestate)
1533 Called just before savestate save occurs (note: movie saves are
1534 synchronous and won't trigger these callbacks if called from
1537 8.13.11 Callback: on_err_save(string name)
1539 Called if savestate goes wrong.
1541 8.13.12 Callback: on_post_save(string name, boolean is_savestate)
1543 Called on successful savaestate. is_savestate gives if this was a
1544 savestate or a movie.
1546 8.13.13 Callback: on_quit()
1548 Called when emulator is shutting down.
1550 8.13.14 Callback: on_input(boolean subframe)
1552 Called when emulator is just sending input to bsnes core.
1553 Warning: This is called even in readonly mode, but the results
1556 8.13.15 Callback: on_reset()
1558 Called when SNES is reset.
1560 8.13.16 Callback: on_readwrite()
1562 Called when moving into readwrite mode as result of “set-rwmode”
1563 command (note: moving to rwmode by Lua won't trigger this, as per
1564 recursive entry protection).
1566 8.13.17 Callback: on_snoop(number port, number controller, number
1567 index, number value)
1569 Called each time bsnes asks for input. The value is the final
1570 value to be sent to bsnes core (readonly mode, autohold and
1571 autofire have been taken into account). Might be useful when
1572 translating movies to format suitable for console verification.
1573 Note: There is no way to modify the value to be sent.
1575 8.13.18 Callback: on_keyhook(string keyname, table state)
1577 Sent when key that has keyhook events requested changes state.
1578 Keyname is name of the key (group) and state is the state (same
1579 kind as table values in input.raw).
1581 8.13.19 Callback: on_idle()
1583 Called when requested by set_idle_timeout(), the timeout has
1584 expired and emulator is waiting.
1586 8.13.20 Callback: on_timer()
1588 Called when requested by set_idle_timeout() and the timeout has
1589 expired (regardless if emulator is waiting).
1591 8.13.21 Callback: on_set_rewind(UNSAFEREWIND r)
1593 Called when unsafe rewind object has been constructed.
1595 8.13.22 Callback: on_pre_rewind()
1597 Called just before unsafe rewind is about to occur.
1599 8.13.23 Callback: on_post_rewind()
1601 Called just after unsafe rewind has occured.
1603 9 Memory watch expression syntax
1605 Memory watch expressions are in RPN (Reverse Polish Notation). At
1606 the end of expression, the top entry on stack is taken as the
1611 • Evaluation order is strictly left to right.
1613 • a is the entry on top of stack
1615 • b is the entry immediately below top of stack
1617 • ; separates values to be pushed (no intermediate pop).
1619 • After end of element, all used stack slots are popped and all
1622 • When pushing multiple values, the pushes occur in order shown.
1624 The following operators are available:
1638 • b : read_signed_byte(a)
1642 • d : read_signed_dword(a)
1644 • i : quotent(a / b)
1649 • q : read_signed_qword(a)
1659 • w : read_signed_word(a)
1663 • B : read_unsigned_byte(a)
1665 • C<number>z : Push number <number> to stack.
1667 • D : read_unsigned_dword(a)
1669 • C0x<number>z : Push number <number> (hexadecimal) to stack.
1671 • Q : read_unsigned_qword(a)
1673 • R<digit> : round a to <digit> digits.
1675 • W : read_unsigned_word(a)
1679 C0x007e0878zWC0x007e002czW-
1681 1. Push value 0x7e0878 on top of stack (C0x007e0878z).
1683 2. Pop the value on top of stack (0x7e0878), read word value at
1684 that address and push the result,call it x1 (W).
1686 3. Push value 0x7e002c on top of stack (C0x007e002cz).
1688 4. Pop the value on top of stack (0x7e002c), read word value at
1689 that address and push the result,call it x2 (W).
1691 5. Pop the two top numbers on stack, x1 and x2, substract x1 from
1692 x2 and push x2 - x1 (-).
1694 6. Since the expression ends, the final memory watch result is
1695 the top one on stack, which is x2 - x1.
1697 10 Modifier and key names:
1701 10.1.1 Modifier names
1703 Following modifier names are known:
1705 • ctrl, lctrl, rctrl: Control keys
1707 • alt, lalt, ralt: ALT keys.
1709 • shift, lshift, rshift: Shift keys.
1711 • meta, lmeta, rmeta: Meta keys.
1713 • num, caps: Numlock/Capslock (these are sticky!)
1715 • mode: Mode select.
1719 Following key names are known:
1721 • backspace, tab, clear, return, pause, escape, space, exclaim,
1722 quotedbl, hash, dollar, ampersand, quote, leftparen,
1723 rightparen, asterisk, plus, comma, minus, period, slash, 0, 1,
1724 2, 3, 4, 5, 6, 7, 8, 9, colon, semicolon, less, equals,
1725 greater, question, at, leftbracket, backslash, rightbracket,
1726 caret, underscore, backquote, a, b, c, d, e, f, g, h, i, j, k,
1727 l, m, n, o, p, q, r, s, t, u, v, w, x, y, z, delete, world_0,
1728 world_1, world_2, world_3, world_4, world_5, world_6, world_7,
1729 world_8, world_9, world_10, world_11, world_12, world_13,
1730 world_14, world_15, world_16, world_17, world_18, world_19,
1731 world_20, world_21, world_22, world_23, world_24, world_25,
1732 world_26, world_27, world_28, world_29, world_30, world_31,
1733 world_32, world_33, world_34, world_35, world_36, world_37,
1734 world_38, world_39, world_40, world_41, world_42, world_43,
1735 world_44, world_45, world_46, world_47, world_48, world_49,
1736 world_50, world_51, world_52, world_53, world_54, world_55,
1737 world_56, world_57, world_58, world_59, world_60, world_61,
1738 world_62, world_63, world_64, world_65, world_66, world_67,
1739 world_68, world_69, world_70, world_71, world_72, world_73,
1740 world_74, world_75, world_76, world_77, world_78, world_79,
1741 world_80, world_81, world_82, world_83, world_84, world_85,
1742 world_86, world_87, world_88, world_89, world_90, world_91,
1743 world_92, world_93, world_94, world_95, kp0, kp1, kp2, kp3,
1744 kp4, kp5, kp6, kp7, kp8, kp9, kp_period, kp_divide,
1745 kp_multiply, kp_minus, kp_plus, kp_enter, kp_equals, up, down,
1746 right, left, insert, home, end, pageup, pagedown, f1, f2, f3,
1747 f4, f5, f6, f7, f8, f9, f10, f11, f12, f13, f14, f15, numlock,
1748 capslock, scrollock, rshift, lshift, rctrl, lctrl, ralt, lalt,
1749 rmeta, lmeta, lsuper, rsuper, mode, compose, help, print,
1750 sysreq, break, menu, power, euro, undo
1752 • Names of form 'key<n>' where <n> is 0-255 are interpretted as
1753 key having hardware-dependent scan code of <n> (useful to bind
1754 those keys that don't have symbolic names).
1756 10.1.3 Joystick pseudo-keys:
1758 • joystick<num>button<button>: Joystick <num> (0-based) button
1761 • joystick<num>hat<hat>n: Joystick <num> (0-based) hat <hat>
1764 • joystick<num>hat<hat>w: Joystick <num> (0-based) hat <hat>
1767 • joystick<num>hat<hat>s: Joystick <num> (0-based) hat <hat>
1770 • joystick<num>hat<hat>e: Joystick <num> (0-based) hat <hat>
1773 • joystick<num>axis<axis>-: Joystick <num> (0-based) axis <axis>
1774 negative position (axis modes axis and axis_inverse).
1776 • joystick<num>axis<axis>+: Joystick <num> (0-based) axis <axis>
1777 positive position (axis modes axis and axis_inverse).
1779 • joystick<num>axis<axis>: Joystick <num> (0-based) axis <axis>
1780 pressure (axis modes pressure_*).
1782 10.1.4 Special buttons:
1784 • Escape: Enter/Exit Command mode, cancel modal dialogs.
1786 • Return (also KPEnter): Execute command, ok modal dialog.
1788 • Pgup/Up (also KP8/9 if no num lock, CTRL+P; command mode):
1789 Previous command in command history
1791 • Pgdn/Down(also KP2/3 if no num lock, CTRL+N; command mode):
1792 Next command in command history
1794 • Home (also KP7 if no num lock, CTRL+A; command mode): Beginning
1797 • End (also KP1 if no num lock, CTRL+E; command mode): End of
1800 • Left (also KP4 if no num lock, CTRL+B; command mode): Move
1803 • Right (also KP6 if no num lock, CTRL+F; command mode): Move
1806 • Delete (also KP. if no num lock; command mode): Delete
1807 character to right of cursor.
1809 • Insert (also KP0 if no num lock; command mode): Toggle between
1810 insert / overwrite modes.
1812 • Backspace (command mode): Delete character to left of cursor.
1814 • CTRL+LEFT (also ALT+B; command mode): Previous word.
1816 • CTRL+RIGHT (also ALT+F; command mode): Next word.
1818 • ALT+D (also CTRL+W; command mode): Delete word.
1820 • LCTRL+LALT+ESCAPE: Ungraceful shutdown (leaves dump
1823 10.2 wxWidgets platform
1825 10.2.1 Modifier names:
1827 Following modifier names are known:
1837 • cmd (Mac OS X only)
1841 Following key names are known:
1843 • back, tab, return, escape, space, exclaim, quotedbl, hash,
1844 dollar, percent, ampersand, quote, leftparen, rightparen,
1845 asterisk, plus, comma, minus, period, slash, 0, 1, 2, 3, 4, 5,
1846 6, 7, 8, 9, colon, semicolon, less, equals, greater, question,
1847 at, a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p, q, r, s, t,
1848 u, v, w, x, y, z, leftbracket, backslash, rightbracket, caret,
1849 underscore, backquote, a, b, c, d, e, f, g, h, i, j, k, l, m,
1850 n, o, p, q, r, s, t, u, v, w, x, y, z, leftcurly, pipe,
1851 rightcurly, tilde, delete, start, lbutton, rbutton, cancel,
1852 mbutton, clear, shift, alt, control, menu, pause, capital, end,
1853 home, lefT, up, right, down, select, print, execute, snapshot,
1854 insert, help, numpad0, numpad1, numpad2, numpad3, numpad4,
1855 numpad5, numpad6, numpad7, numpad8, numpad9, multiply, add,
1856 separator, subtract, decimal, divide, f1, f2, f3, f4, f5, f6,
1857 f7, f8, f9, f10, f11, f12, f13, f14, f15, f16, f17, f18, f19,
1858 f20, f21, f22, f23, f24, numlock, scroll, pageup, pagedown,
1859 numpad_space, numpad_tab, numpad_enter, numpad_f1, numpad_f2,
1860 numpad_f3, numpad_f4, numpad_home, numpad_left, numpad_up,
1861 numpad_right, numpad_down, numpad_pageup, numpad_pagedown,
1862 numpad_end, numpad_begin, numpad_insert, numpad_delete,
1863 numpad_equal, numpad_multiply, numpad_add, numpad_separator,
1864 numpad_subtract, numpad_decimal, numpad_divide, windows_left,
1865 windows_right, windows_menu, command, special1, special2,
1866 special3, special4, special5, special6, special7, special8,
1867 special9, special10, special11, special12, special13,
1868 special14, special15, special16, special17, special18,
1869 special19, special20
1871 11 Movie file format
1873 Movie file is .zip archive in itself, normal ZIP archive tools
1874 work on it (note: If you recompress it, do not use compression
1875 methods other than store and deflate and especially do not use
1876 encryption of any kind).
1878 11.1 Detecting clean start/SRAM/Savestate
1880 • If file has member “savestate” it is savestate, otherwise:
1882 • If file has members with names starting “moviesram.” it is
1883 movie starting from SRAM, otherwise:
1885 • It is movie starting from clear state.
1887 11.2 Member: gametype
1889 Type of game ROM and region (as one line). Valid values are:
1892 +--------------+---------------------+--------+
1893 | Value | System | Region |
1894 +--------------+---------------------+--------+
1895 +--------------+---------------------+--------+
1896 | snes_pal | Super NES | PAL |
1897 +--------------+---------------------+--------+
1898 | sgb_pal | Super Game Boy | PAL |
1899 +--------------+---------------------+--------+
1900 | snes_ntsc | Super NES | NTSC |
1901 +--------------+---------------------+--------+
1902 | sgb_ntsc | Super Game Boy | NTSC |
1903 +--------------+---------------------+--------+
1904 | bsx | BS-X (non-slotted) | NTSC |
1905 +--------------+---------------------+--------+
1906 | bsxslotted | BS-X (slotted) | NTSC |
1907 +--------------+---------------------+--------+
1908 | sufamiturbo | Sufami Turbo | NTSC |
1909 +--------------+---------------------+--------+
1915 +---------+-----------------+
1916 | Region | Framerate (fps) |
1917 +---------+-----------------+
1918 +---------+-----------------+
1919 | PAL | 322445/6448 |
1920 +---------+-----------------+
1921 | NTSC | 10738636/178683 |
1922 +---------+-----------------+
1927 Contains type of port #1 (as one line). Valid values are 'none',
1928 'gamepad', 'multitap' and 'mouse'. If not present, defaults to
1933 Contains type of port #2 (as one line). Valid values are 'none',
1934 'gamepad', 'multitap', 'mouse', 'superscope', 'justifier' and
1935 'justifiers'. If not present, defaults to 'none'.
1937 11.5 Member: gamename
1939 Contains name of the game (as one line).
1941 11.6 Member: authors
1943 Contains authors, one per line. Part before '|' is the full name,
1944 part after is the nickname.
1946 11.7 Member: systemid
1948 Always “lsnes-rr1” (one line). Used to reject other saves.
1950 11.8 Member: controlsversion
1952 Always “0” (one line). Used to identify what controls are there.
1954 11.9 Member: “coreversion”
1956 Contains bsnes core version number (as one line).
1958 11.10 Member: projectid
1960 Contains project ID (as one line). Used to identify if two movies
1961 are part of the same project.
1963 11.11 Member: {rom,slota,slotb}{,xml}.sha256
1965 Contains SHA-256 of said ROM or ROM mapping file (as one line).
1966 Absent if corresponding file is absent.
1968 11.12 Member: moviesram.<name>
1970 Raw binary startup SRAM of kind <name>. Only present in
1971 savestates and movies starting from SRAM.
1973 11.13 Member: saveframe
1975 Contains frame number (as one line) of frame movie was saved on.
1976 Only present in savestates.
1978 11.14 Member: lagcounter
1980 Current value of lag counter (as one line). Only present in
1983 11.15 Member: pollcounters
1985 Contains poll counters (currently 100 of them), one per line.
1986 Each line is raw poll count if DRDY is set for it. Otherwise it
1987 is negative poll count minus one. Only present in savestates.
1989 11.16 Member: hostmemory
1991 Raw binary dump of host memory. Only present in savestates.
1993 11.17 Member: savestate
1995 The raw binary savestate itself. Savestate detection uses this
1996 file, only present in savestates.
1998 11.18 Member: screenshot
2000 Screenshot of current frame. Only present in savestates. First 2
2001 bytes are big-endian width of image, rest are 24-bit RGB image
2002 data. Height of image is inferred from the width and size of
2005 11.19 Member: sram.<name>
2007 Raw binary SRAM of kind <name> at time of savestate. Only present
2012 The actual input track, one line per subframe (blank lines are
2015 • If the first byte of each line is '.', ' ', <tab> or '|', then
2016 the line is part of same frame as previous, otherwise it starts
2019 • First subframe must start a new frame.
2021 Length of movie in frames is number of lines in input file that
2024 11.21 Member: subtitles
2026 Subtitle track. Optional.
2028 • Each line is in form <firstframe> <numframes> <text>.
2030 • Linefeed is encoded as \n, backslash is encoded as \\.
2032 11.22 Member: rerecords
2034 Contains textual base-10 rerecord count (as one line; emulator
2035 just writes this, it doesn't read it) + 1.
2037 11.23 Member: rrdata
2039 This member stores set of load IDs. There is one load ID per
2040 rerecord (plus one corresponding to start of project).
2042 • This member constists of concatenation of records
2044 • Each record is 2-36 bytes long and can represent 1-16,843,009
2047 • IDs are interpretted as 256-bit big-endian integers with
2050 • Initial predicted ID is all zeroes.
2052 Format of each record is:
2054 • 1 byte: Opcode byte. Bits 0-4 are prefix length (prefixlen),
2055 bits 5-6 are count length (countlen). Bit 7 is unused.
2057 • 32-prefixlen bytes of ID.
2059 • countlen bytes of big-endian count (count).
2061 Records are processed as follows:
2063 • To form the first ID encoded by record, take the first
2064 prefixlen bytes predicted ID and append the read ID value to
2065 it. The result is the first ID encoded.
2067 • If countlen is 0, record encodes 1 ID.
2069 • If countlen is 1, record encodes 2+count IDs.
2071 • If countlen is 2, record encodes 258+count IDs.
2073 • If countlen is 3, record encodes 65794+count IDs.
2075 • The new predicted ID is the next ID after last one encoded by
2078 The number of rerecords + 1 is equal to the sum of number of IDs
2079 encoded by all records.
2081 11.24 Member: starttime.second
2083 Movie starting time, second part. Epoch is Unix epoch. Default is
2086 11.25 Member: starttime.subsecond
2088 Movie starting time, subsecond part. Unit is CPU clocks. Default
2091 11.26 Member: savetime.second
2093 Movie saving time, second part. Default is starttime.second. Only
2094 present in savestates.
2096 11.27 Member: savetime.subsecond
2098 Movie saving time, subsecond part. Default is
2099 starttime.subsecond. Only present in savestates.
2101 12 lsvs file format (commentary tracks)
2105 • Each cluster is 8kB (8192 bytes) in size.
2107 • Cluster n starts at offset 8192*n in file.
2109 • The following clusters are system special:
2111 – Cluster 0 and all clusters with number multiple of 2048
2114 – Cluster 1 (superblock)
2118 • The cluster table describing cluster n is stored in cluster n &
2119 ~0x7FF (zero last 11 bits of n).
2121 • This cluster table consists of 2048 4-byte big-endian integers.
2123 • Each entry describes a cluster in 16MB supercluster, in order.
2125 • The valid values for entries are:
2127 – 0x00000000: Free cluster
2129 – 0x00000001: Last cluster in chain.
2131 – 0xFFFFFFFF: System cluster (cluster tables and superblock)
2133 – (anything else): Number of next cluster in chain. Must not be
2136 • Due to limitations of the format, there can be at most 2097052
2137 superclusters, giving maximum file size of 16TB.
2141 • The stream table chain always starts in cluster 2.
2143 • Otherwise, it follows normal chaining.
2145 • The stream table consists of 16-byte entries:
2147 – The first 8 bytes of entry give big-endian beginning position
2148 of stream in units of 1/48000 s.
2150 – The next 4 bytes of entry give big-endian beginning cluster
2151 for control data. 0 here marks the entry as not present.
2153 – The last 4 bytes of entry give big-endian beginning cluster
2156 • Stream table clusters are normal clusters, following normal
2159 • The stream begnning position is not guarenteed unique. There
2160 can be multiple streams with the same starting position in the
2163 12.4 Stream control data
2165 • The stream control data consists of entries 4 bytes each:
2167 – The first 2 bytes of entry gives big-endian length of packet
2169 – The next byte of entry gives audio length of packet in units
2172 – The last byte is control byte.
2174 ∗ 0 means this entry is not present and the control data
2177 ∗ 1 is valid control entry.
2179 • The stream control data can also end by running into end of the
2182 – This happens if there happens to be exact multiple of 2048
2183 packets in stream and number of packets is nonzero.
2185 • These clusters follow normal chaining.
2187 12.5 Stream codec data
2189 • Stream codec data consists of raw Opus data packets packed back
2190 to back with nothing in between.
2192 • Warning: Due to internal limitations, this data must reside in
2193 the first 65536 superclusters (that is, the first 1TB of the
2198 • The superblock is stored in cluster 1.
2200 • The first 11 bytes are “sefs-magic”<NUL>.
2202 • The rest are unused.
2204 • This cluster 1 is marked as system special.
2206 13 Known ROM extensions
2208 • SNES cartridge ROMs: sfc, smc, swc, fig, ufo, sf2, gd3, gd7,
2211 • DMG cartridge ROMs: dmg, gb.
2213 • GBC cartridge ROMs: cgb, gbc.
2217 • The first line must be: “[GAMEPACK FILE]”.
2219 • There is one needed line: “type <systype>”. This sets system
2220 type to <systype>. The following system types are valid:
2224 – bsx (BS-X non-slotted)
2226 – bsxslotted (BS-X slotted)
2228 – sufamiturbo (Sufami Turbo)
2230 – sgb (Super Game Boy)
2234 – gbc (Game Boy Color)
2236 – gbc_gba (Game Boy Color with GBA initial register values)
2238 • Optionally a region can be specified: “region <region>”. The
2239 following values are valid:
2241 – autodetect (Autodetect region: snes and sgb only)
2243 – ntsc (NTSC: snes, bsx, bsxslotted, sufamiturbo, sgb)
2245 – pal (PAL: snes, sgb)
2247 – world (World: dmg, gbc, gbc_gba)
2249 • ROM images are loaded as: “rom <type> <file>”. The following
2252 – rom (Cartridge ROM in snes, dmg, gbc, gbc_gba. BIOS in bsx,
2253 bsxslotted, sufamiturbo)
2255 – bsx (Cartridge ROM in bsx, bsxslotted)
2257 – slot-a (Cartridge ROM in sufamiturbo)
2259 – slot-b (Cartridge ROM in sufamiturbo)
2261 • ROM markup can be loaded as: “xml <type> <file>”. The types
2262 valid are the same as for ROMs.
2264 • Patches can be loaded as “patch[<offset>] <type> <file>”. The
2265 types are the same as for ROMs.
2267 – Offset is given in form [+-]<number>. Usually offset is
2270 – Default offset is +0.
2278 rom rom speedygonzales.sfc
2280 patch-512 rom sonicthehedgehog.ips
2288 rom rom supergameboy.sfc
2290 rom dmg megamanV.dmg
2292 15 Quick'n'dirty encode guide
2294 1. Start the emulator and load the ROM and movie file.
2296 2. Set large AVI option 'set-setting avi-large on'
2298 3. Enable dumping 'dump-avi tmpdump'
2300 4. Unpause and let it run until you want to end dumping.
2302 5. Close the emulator (closing the window is the easiest way). Or
2305 6. For each tmpdump*.avi file created, on command prompt, do
2306 'x264 --crf 10 -o tmpdump_<numbers>.mkv tmpdump_<numbers>.avi'.
2308 7. Do 'sox tmpdump.sox tmpdump.ogg rate -v 32000'
2310 8. Do 'mkvmerge -o tmpdump_video.mkv tmpdump_0000000.mkv +
2311 tmpdump_0000001.mkv + tmpdump_0000002.mkv' (list every
2312 tmpdump_<numbers>.mkv, with + in between).
2314 9. Do 'mkvmerge -o final.mkv tmpdump_video.mkv tmpdump.ogg'. Now
2315 final.mkv contains quick'n'dirty encode.
2317 16 Axis configurations for some gamepad types:
2319 16.1 XBox360 controller:
2321 Axes 2 and 5 (joystick<n>axis2 and joystick<n>axis5) should be
2324 set-axis joystick0axis2 pressure-+
2326 set-axis joystick0axis5 pressure-+
2328 • This is needed for SDL only. EVDEV sets those types correctly.
2330 16.2 PS3 “sixaxis” controller:
2332 Axes 8-19 should be disabled.
2334 set-axis joystick0axis8 disabled
2336 set-axis joystick0axis9 disabled
2338 set-axis joystick0axis10 disabled
2340 set-axis joystick0axis11 disabled
2342 set-axis joystick0axis12 disabled
2344 set-axis joystick0axis13 disabled
2346 set-axis joystick0axis14 disabled
2348 set-axis joystick0axis15 disabled
2350 set-axis joystick0axis16 disabled
2352 set-axis joystick0axis17 disabled
2354 set-axis joystick0axis18 disabled
2356 set-axis joystick0axis19 disabled
2360 17.1 Problems from BSNES core:
2362 • The whole pending save stuff.
2364 • Lack of layer hiding.
2366 • It is slow (especially accuracy).
2368 • Firmwares can't be loaded from ZIP archives.
2370 17.2 Other problems:
2372 • Modifiers don't work with pseudo-keys (SDL, EVDEV).
2374 • Audio for last dumped frame is not itself dumped.
2376 • Audio in UI is pretty bad in quality if game doesn't run at
2379 • No menus, command based interface (SDL).
2381 • Long commands don't scroll.
2387 • Fix -Wall warnings
2389 • Fix dumper video corruption with levels 10-18.
2395 • Lots of code cleanups
2397 • Lua interface to settings
2399 • Allow specifying AVI borders without Lua
2401 • Fix scaling if vscale > 1 and originx > 0 (left border exists)
2403 • on_snoop lua callback
2405 • Faster movie loading and saving.
2415 • Save jukebox functionality.
2419 • Try to fix some nasty failing movie load edge cases
2421 • Allow specifying scripts to run on command line.
2425 • Major source code reorganization.
2427 • Backup savestates before overwriting.
2429 • Don't crash if loading initial state fails.
2433 • Fix firmware lookup
2435 • Fix author name parsing
2437 • Fix rerecord counting
2439 • (SDL) Print messages to console if SDL is uninitialized
2441 • Add movieinfo program
2443 • Fix loading movies starting from SRAM.
2447 • Add support for unattended dumping
2449 • Fix compiling for Win32
2451 • Don't lock up if sound can't be initialized
2453 • Strip trailing CR from commands
2455 • Don't try to do dubious things in global ctors (fix crash on
2460 • Small documentation tweaking
2464 • Fix major bug in modifier matching
2468 • Lots of documentation fixes
2470 • Use dedicated callbacks for event backcomm., not commands.
2472 • Ensure that the watchdog is not hit when executing delayed
2475 • Remove errant tab from joystick message.
2479 • Make autofire operate in absolute time, not linear time
2481 • Reinitialize controls when resuming from loadstate
2483 • Some more code cleanups
2485 • If Lua allocator fails, call OOM_panic()
2487 • Byte/word/dword/qword sized host memory write/read functions.
2489 • Dump at correct framerate if dumping interlaced NTSC
2494 • Actually include the complete source code
2500 • Document {save,start}time.{,sub}second.
2502 • Intercept time() from bsnes core.
2506 • Allow disabling time() interception (allow build on Mac OS X)
2508 • Use SDLMain on Mac OS X (make SDL not crash)
2510 • Disable delayed resets (just plain too buggy for now).
2514 • Use 16-bit for graphics/video instead of 32-bit.
2516 • gui.rectangle/gui.pixel
2520 • New CSCD writer implementation.
2524 • Fix interaction of * and +.
2526 • Manual improvements
2528 • Use gettimeofday()/usleep(), these seem portable enough.
2530 • Move joystick axis manipulation to keymapper code.
2532 • Changes to how read-only works.
2534 • Refactor controller input code.
2538 • Fix mouseclick scale compensation.
2540 • Draw area boundaries correctly in SDL code.
2544 • Fix CSCD output (buffer overrun and race condition).
2548 • JMD dumping support.
2550 • Allow unattended dumping to JMD.
2552 • Move to BSNES v083.
2554 • Switch back to 32-bit colors.
2556 • Add Lua function gui.color.
2558 • Use some new C++11 features in GCC 4.6.
2560 • Be prepared for core frequency changes.
2562 • Pass colors in one chunk from Lua.
2566 • New lua functions gui.line(), gui.status() and gui.circle(),
2567 memory.vma_count(), memory.read_vma() and memory.find_vma().
2569 • Numerious documentation fixups
2571 • RTC time format changed
2573 • Reformat flags display
2575 • Allow lua package name to be overridden
2577 • SDUMP (high-quality dumping).
2579 • Split platform support to plugins.
2581 • Make all sound plugins support basic sound commands
2583 • Support portaudio for sound.
2585 • Allow disable Lua/SDL searching.
2587 • Upconvert colors when copying lcscreen to screen.
2589 • Reorganize source tree.
2591 • Evdev joystick support.
2593 • Refactor more code into generic window code.
2597 • Refactor message handling.
2601 • Documentation fixes
2603 • Finish pending saves before load/quit.
2605 • Wxwidgets graphics plugin.
2609 • Get rid of win32-crap.[ch]pp.
2611 • Move files around a lot.
2613 • Get rid of need for host C++ compiler.
2617 • Refactor inter-component communication.
2621 • Fix crash on multiline aliases.
2623 • Load/Save settings in wxwidgets gui.
2627 • Patch problems in bsnes core
2629 • SNES is little-endian, not big-endian!
2631 • Fix memory corruption in lcscreen::load()
2635 • Fix interpretting repeat counts in rrdata loading.
2637 • New lua callback: on_frame()
2639 • Remove calls to runtosave() that aren't supposed to be there
2641 • Lua function: movie.read_rtc()
2643 • Ignore src/fonts/font.cpp
2645 • Fix more bsnes core problems
2647 • Control bsnes random seeding
2651 • Some bsnes core debugging features (state dump and state hash)
2653 • Fix titlebar version number (no, the last version wasn't
2654 'lsnes-0-beta21', it was 'lsnes rr0-beta21').
2658 • Fix memory corruption due to macro/field mixup
2660 • search-memory update
2662 • Allow direct-mapped framebuffer
2664 • SDL: Use SDL_ANYFORMAT if possible
2666 • SDMP2SOX: 2s delay modes.
2668 • Wxwidgets: Cleanups
2670 • Use sed -E, not sed -r. Fixes building on Mac OS X.
2672 • Wxwidgets: Save jukebox on exit
2674 • Fix RTC if using load-movie on savestate.
2676 • Fix crash related to full console mode.
2680 • Wxwidgets: Allow bringing application to foreground on Mac OS
2683 • Wxwidgets: Allow compiling on Mac OS X.
2685 • Use movie compare instead of movie hashing (faster save/load).
2687 • Lua: _SYSTEM table.
2691 • sdmp2sox: Pad soundtrack if using -l or -L.
2693 • sdmp2sox: Fix NTSC overscan.
2695 • sdmp2sox: Add AR correction mode.
2697 • call lua_close() when exiting.
2699 • Fix zip_writer bug causing warnings from info-zip and error
2704 • Fix IPS patching code (use bsnes core IPS patcher).
2706 • Implement BPS patching (using bsnes core IPS patcher).
2708 • Add feature to load headered ROMs.
2712 • Show command names when showing keybindings
2716 • Fix pause-on-end to be actually controllable
2718 • SDL: Poll all events in queue, not just first one (fixes
2719 slowness in command typing)
2721 • Wxwidgets: Fix ROM loading.
2725 • Lua: Add gui.textH, gui.textV, gui.textHV
2727 • Fix text colors on SDL on Mac OS X
2729 • Mode 'F' for finished in readonly mode.
2731 • Fix some WS errors.
2733 • Reliably pause after skip poll
2735 • Split UI and core into their own threads
2739 • Remove leftover dummy SRAM slot
2741 • Fix controller numbers.
2745 • Fix lsnes-dumpavi after interface change.
2747 • Also give BSNES patches for v085.
2749 • Pack movie data in memory.
2753 • Fix framecount/length given when loading movies.
2755 • Controller command memory leak fixes.
2757 • Don't leak palette if freeing screen object.
2763 • Wxwidgets: Allow controlling dumper from the menu.
2767 • Rewrite parts of manual
2769 • Lua: Make it work with Lua 5.2.
2773 • Win32: Fix compile errors.
2777 • Refactor controller input code.
2779 • Fix crash when using command line on SDL / Mac OS X.
2783 • Delete core/coroutine (obsolete)
2785 • Lag input display by one frame.
2787 • Rewind movie to beginning function.
2789 • Fix wrong frame number reported to Lua when repainting after
2792 • Support UI editing of jukebox
2794 • Wxwidgets: Save settings on exit.
2796 • Support ${project} for filenames
2798 • SDL: Fix command history
2802 • Fix some order-of-global-ctor bugs.
2806 • Fix crashes when quitting on Win32.
2810 • EVDEV: Queue keypresses from joystick, don't send directly
2812 • Wxwidgets: Load-Preserve that actually works.
2816 • Wxwidgets: GUI for memory search.
2818 • Warn about using synchronous queue in UI callback.
2822 • Remember last saved file for each ROM
2824 • Support MT dumping via boost.
2828 • Lua: input.keyhook
2830 • Make mouse be ordinary input instead of special-casing
2832 • SDL: Don't screw up commands with NUL codepoints.
2836 • Merge status panel and main window
2838 • True movie slot support (the rest of it)
2840 • SDL: Fix compilation error
2842 • Elminate cross calls in dump menu code.
2846 • Cancel pending saves command
2848 • Wxwidgets: Code refactoring
2850 • Wxwidgets: Fix system -> reset
2852 • Wxwidgets: Read watch expressions in the right thread
2856 • Wxwidgets: Don't prompt for member when running Lua script (Lua
2857 doesn't support that).
2859 • Wxwidgets: 128 -> 1024 Autohold slots (in case more are
2862 • Don't append trailing '-' to prefix when saving movie.
2864 • Fix ROM/savestate handling (don't let user mismatch ROM and
2869 • Document memory watch syntax.
2873 • Fix unattended dumping (lsnes-dumpavi)
2875 • Support RAW dumping
2877 • Use adv_dumper instead of the old interface in lsnes-dumpavi
2880 • Add option to control sample rate preturbation in AVI dumper
2884 • Wxwidgets: Fix dumper submodes
2886 • Set core controller types before loadstate
2888 18.49 rr1-delta2epsilon1
2890 • Fix compiling with bsnes v086.
2894 • Don't prompt before quitting
2896 • Start unpaused, preserve pause/unpause over load.
2898 • Try to autodetect if ROM is headered.
2900 • Wxwidgets: Only bring up ROM patching screen if specifically
2903 • Allow configuring some hotkeys.
2907 • Lots of code cleanups
2909 • Fix JMD compression (JMD dumping was broken)
2911 • Don't crash if Lua C function throws an exception.
2913 • Support bitmap drawing in Lua.
2915 • Fix bsnes v085/v086 patches.
2917 • Improve stability on win32.
2919 18.52 rr1-delta4epsilon1
2921 • Don't corrupt movie if movie length is integer multiple of
2926 • New Lua hooks: on_rewind, on_frame_emulated, on_idle, on_timer
2928 • New Lua functions: emulator_ready(), utime(),
2929 set_idle_timeout(), set_timer_timeout(), bit.extract(),
2930 bit.value(), input.geta(), input.seta() and
2931 input.controllertype()
2933 • Wxwidgets: Fix internal focus lost (hotkeys stop working)
2935 • Wxwidgets: Fix broken modifiers
2937 • on_paint has parameter now.
2939 • Optional initital fill for bitmaps
2941 • Fix palette changing.
2943 • Optimize rendering a bit.
2945 • Bsnes v087 support.
2947 18.54 rr1-delta5epsilon1
2949 • Movieinfo: Fix display of port #2 type.
2951 • Call on_input() after loadstate.
2953 18.55 rr1-delta5epsilon2
2955 • Fix writing port2 data to movie.
2957 • Fix SRAM handling with Bsnes v087.
2961 • Library loading support
2963 • Built-in TSCC encoder
2965 • Hi-color (256T colors) dumping.
2967 • Dump over TCP/IP(v6)
2969 • Hidable status panel
2973 • Adjustable sound volume
2977 • Allow DnD into filename boxes
2979 • Configurable paths
2981 • Portaudio: Fix speaker popping at start
2983 • Lots of UI changes
2985 • Speed adjustment menu
2987 • Win32 joystick support
2989 • Lua: gui.rainbow and gui.box
2991 • Split key lists into classes (the key list was large!)
2993 • More save slots support
2995 • Wxwidgets (wxJoystick) joystick support
2999 • Lots of internal joystick refactoring
3001 • Evdev: Add mapping for BTN_TOOL_QUINTTAP
3003 • Wxwidgets: Settings mode (open settings without ROM)
3005 • Wxwidgets: Prompt key to use option
3007 • Wxwidgets: Fix crash if key goes away underneath
3009 • Wxwidgets: Fix mouse position in presence of scaling
3011 • AVI dumper: Mode 4 (high-quality resampling to common rate
3014 • Wxwidgets: Redesign hotkeys dialog to avoid tree control (tree
3015 control doesn't seem to work well on WinXP)
3017 • Start paused option.
3019 18.58 rr1-delta7epsilon1
3023 • lsnes-dumpavi: Start Lua before starting dumper
3025 • AVI: Fix secondary audio in mode 4.
3027 18.59 rr1-delta7epsilon2
3029 • AVI: Refactor ZMBV a bit.
3031 • Fix error reading analog values from movie file
3035 • Delayed reset support
3037 • Lua: memory.hash_region
3039 18.61 rr1-delta8epsilon1
3041 • Rework the build system
3043 • Typing input support
3045 • Fix building with bsnes v086 and v087.
3047 • SDL: Save settings on exit
3049 • SDL: Command to enter command line mode with given command.
3051 • SDL: More advanced command editing.
3055 • wxMSW: Fix the “arrow keys and enter don't work” problem
3059 • Show mode changes due to rewinding.
3061 • Unsafe rewind support
3063 • Fix directory transversal.
3067 • AVI: Sound mode 5 (48kHz high-quality)
3071 • Map the SNES bus into address space
3073 • Fix loading memory watch files with CRLF line endings
3075 18.64 rr1-delta10epsilon1
3077 • Map bsnes internal state into memory space
3079 • Fix the “click on panel wedges the emulator” for real.
3081 • DnD movies/saves on the main window.
3085 • Split core bindings into own module.
3087 • Remember invalid settings
3089 • Support for modified Gambatte core for GB/GBC emulation.
3091 • Reload/swap ROM function
3093 18.66 rr1-delta11epsilon1
3095 • Fix step poll function
3099 • Non-insane savestate anchoring
3103 • More Memory search methods
3105 • Preserve movie if loading in RO mode.
3107 • Fix a obscure case in timeline check
3109 • Revamp the entiere ROM loading code
3111 • Support DnD on ROMs
3113 • Revamp menu layout
3115 • Standalone hotkey config dialog
3117 • Show bindings in more user-friendly format
3119 18.69 rr1-delta13epsilon1
3123 • Fix uninitialized variables in bsnes v085
3127 • Merge gambatte core into mainline (from its own branch)
3129 • Wxwidgets: Show expected dump file formats
3131 • Memory watch: Data typing
3133 • lsnes internal MMIO area.
3135 • Wxwidgets: New memory watch editor
3137 • Hexadecimal memory watches
3139 • Wxwidgets: Monospaced panel
3141 • Wxwidgets: Split memory watches in panel
3143 • Wxwidgets: Disable VMAs in memory search
3145 • lsnes-dumpavi: Fix speed bug
3147 • Movie subtitle support
3149 • Fix rerecord count reporting
3151 • Don't trash movie when loading in readonly mode.
3153 18.71 rr1-delta14epsilon1
3155 • Wxwidgets: Fix crashes on closing settings dialogs on Mac OS X.
3157 • Fix build on Mac OS X.
3161 • Wxwidgets: Hidable messages window
3165 • Bsnes: Support inconsistent saves
3167 • Bsnes: Allow simulating saving every frame
3169 • Fix desync if savestate is loaded in readonly mode in certain
3172 • Wxwidgets: Fix save dialogs on Mac OS X.
3174 • Wxwidgets: Fix insane status width on Win32.
3176 • Wxwidgets: Fix autohold processing to be faster.
3178 • Wxwidgets: Allow loading ROMs and movies from commandline.
3182 • Be a bit smarter with --load
3184 • Rewrote higher-level parts of audio system
3186 • Tool to build commentary tracks
3190 • Gambatte: Add support for SVN358
3192 • Use builtin font when rendering status panel.
3194 • Option to detach memory watch to its own window.
3196 • Recent ROMs/Movies menu
3200 • Useful lag counter for SNES games that autopoll
3202 • Fix buffer overflow in gambatte sound output
3204 18.73 rr1-delta15epsilon1
3206 • Don't blow up on wxGTK if the window is hidden somehow
3208 • Support simultaneous drop of ROM and movie.
3210 • Gambatte: Don't save spurious SRAMs.
3212 • Make SGB ROMs actually usable.
3214 • Fix so that saved movies appear in recent movies.
3216 • Don't open multiple commentary editors at once.
3218 18.74 rr1-delta15epsilon2
3220 • Lua: memory.readregion/memory.writeregion
3222 • Lua: memory.map{,s}{byte,word,dword,qword}
3224 • Lua: memory.map_structure
3226 • Lua: Fix bus_address for gambatte
3228 • Fix features dependent of bsnes debugger
3230 • Cleanup bsnes debugger logic
3232 • Fix resets in presence of save every frame
3234 18.75 rr1-delta15epsilon3
3236 • Lua: input.lcid_to_pcid
3238 • Fix off-by-one bug with slot hashes
3240 • Fix crashes on certain memory watch expressions
3242 • Lua: memory.read_expr
3244 • Lua: Fix memory.read_expr on nil argument
3246 • Fix the code to compile on G++ 4.7
3248 • Change button_id to be a function pointer field, not a virtual
3251 • Add bsnes patches to fix libsnes to compile on GCC 4.7
3253 • Gambatte: Always use legacy lag counting
3255 • Memory commands: Memory addresses are up to 16 hex digits, not
3258 • Fix analog controllers
3260 • Fix autohold menus
3262 • Fix button symbols in input display
3264 • Compensate for nuts bsnes superscope/justifier handling
3266 • Lua: Fix bit.extract boolean handling