1 #LyX 2.0 created this file. For more info see http://www.lyx.org/
6 \use_default_options true
7 \maintain_unincluded_children false
9 \language_package default
14 \font_typewriter default
15 \font_default_family default
16 \use_non_tex_fonts false
23 \default_output_format default
25 \bibtex_command default
26 \index_command default
27 \paperfontsize default
38 \paperorientation portrait
47 \paragraph_separation indent
48 \paragraph_indentation default
49 \quotes_language english
52 \paperpagestyle default
53 \tracking_changes false
66 \begin_layout Standard
67 lsnes is SNES rerecording emulator based on bsnes core.
74 \begin_layout Enumerate
75 bsnes libsnes (for bsnes SNES core)
79 \begin_layout Enumerate
80 v084-v087 (v084 or v085 for delayreset support)
83 \begin_layout Enumerate
84 accuracy or compatiblity core with debugger enabled.
87 \begin_layout Enumerate
88 Patched version (using included 7 patches)
92 \begin_layout Enumerate
93 gambatte (for gambatte core)
97 \begin_layout Enumerate
98 SVN r320, r358 or r364
101 \begin_layout Enumerate
102 Patched with included patches
106 \begin_layout Enumerate
110 \begin_layout Enumerate
114 \begin_layout Enumerate
118 \begin_layout Enumerate
119 boost_thread (if native std::thread is not available)
122 \begin_layout Enumerate
126 \begin_layout Enumerate
127 sdlmain (SDL only, part of SDL)
130 \begin_layout Enumerate
131 boost_conversion (this is header-only library)
134 \begin_layout Enumerate
135 libswscale (wxwidgets graphics only)
138 \begin_layout Enumerate
139 Portaudio (portaudio sound only)
142 \begin_layout Enumerate
143 libao (libao sound only)
146 \begin_layout Enumerate
147 Lua version 5.1.X or 5.2.X
150 \begin_layout Enumerate
154 \begin_layout Enumerate
155 libopus (optional, for commentary track tool)
158 \begin_layout Section
162 \begin_layout Itemize
163 Copy bsnes sources (the bsnes subdirectory) to subdirectory 'bsnes' (for
167 \begin_layout Itemize
168 Copy gambatte sources to subdirectory 'gambatte' (for gambatte core).
171 \begin_layout Itemize
172 Patch the bsnes sources with included patches (directory 'bsnes-patches/<version
176 \begin_layout Itemize
177 Patch the gambatte sources with included patches (directory 'gambatte-patches/<v
178 ersion>', gambatte core)
181 \begin_layout Itemize
182 Edit options.build (or copy of that file)
185 \begin_layout Itemize
186 Run make (passing 'OPTIONS=<filename>' if using something else than options.build
190 \begin_layout Section
194 \begin_layout Subsection
198 \begin_layout Subsubsection
202 \begin_layout Standard
206 \begin_layout Subsubsection
210 \begin_layout Standard
214 \begin_layout Subsubsection
218 \begin_layout Standard
219 Load <file> as movie or savestate file on startup.
222 \begin_layout Subsubsection
226 \begin_layout Standard
227 Instead of starting the emulator, only display the settings.
230 \begin_layout Subsubsection
234 \begin_layout Standard
235 Run this Lua file on startup
238 \begin_layout Subsection
239 dump options (lsnes-dumpavi only)
242 \begin_layout Subsubsection
246 \begin_layout Standard
251 \begin_layout Subsubsection
255 \begin_layout Standard
256 Load <filename> as movie or savestate file on startup.
260 \begin_layout Subsubsection
264 \begin_layout Standard
265 Set the dumper to use (required).
266 Use 'list' for listing of known dumpers.
269 \begin_layout Subsubsection
270 --firmware-path=<path>
273 \begin_layout Standard
274 Set path to look for firmware.
277 \begin_layout Subsubsection
281 \begin_layout Standard
282 Set the mode to use (required for dumpers with multiple modes, forbidden
284 Use 'list' for known modes.
287 \begin_layout Subsubsection
291 \begin_layout Standard
294 \begin_inset Quotes eld
298 \begin_inset Quotes erd
304 \begin_layout Subsubsection
305 --option=<name>=<value>
308 \begin_layout Standard
309 Set option <name> to value <value>.
312 \begin_layout Subsubsection
316 \begin_layout Standard
317 Set number of frames to dump.
321 \begin_layout Subsubsection
325 \begin_layout Standard
326 Run specified lua script (lsnes-dumpavi does not have initialization files).
329 \begin_layout Subsubsection
330 --load-library=<library>
333 \begin_layout Standard
334 Load the specified shared object / dynamic library / dynamic link library.
337 \begin_layout Subsection
338 lsnes settings directory
341 \begin_layout Standard
342 The lsnes settings directory is (in order of decreasing perference):
345 \begin_layout Itemize
348 lsnes (if %APPDATA% exists)
351 \begin_layout Itemize
352 Unix: $XDG_CONFIG_HOME/lsnes (if $XDG_CONFIG_HOME exists)
355 \begin_layout Itemize
356 Unix: $HOME/.config/lsnes (if $HOME exists)
359 \begin_layout Itemize
364 \begin_layout Standard
365 If leading directories do not exist, attempt to create them is made.
368 \begin_layout Section
372 \begin_layout Itemize
373 Commands beginning with '*' invoke the corresponding command without alias
377 \begin_layout Itemize
378 If command starts with '+' (after possible '*'), the command is executed
379 as-is when button is pressed, and when button is released, it is executed
380 with '+' replaced by '-'.
383 \begin_layout Itemize
384 Commands without '+' execute only on negative edge (release).
387 \begin_layout Subsection
391 \begin_layout Standard
392 Run <script> as if commands were entered on the command line.
395 \begin_layout Subsection
399 \begin_layout Standard
400 <address> may be decimal or hexadecimal (prefixed with '0x').
401 <value> can be hexadecimal (prefixed with '0x'), unsigned or signed (prefixed
405 \begin_layout Standard
406 The available element <sizes> are:
409 \begin_layout Itemize
413 \begin_layout Itemize
417 \begin_layout Itemize
421 \begin_layout Itemize
425 \begin_layout Standard
426 When reading RAM and ROM, multi-byte reads/writes are big-endian.
427 When dealing with DSP memory, multi-byte reads/writes are native-endian
428 (do not use operand sizes exceeding DSP bitness, except dword is OK for
432 \begin_layout Subsubsection
433 read-<size> <address>
436 \begin_layout Standard
437 Read the value of byte in <address>.
440 \begin_layout Subsubsection
441 read-s<size> <address>
444 \begin_layout Standard
445 Read the value of signed byte in <address>.
448 \begin_layout Subsubsection
449 write-<size> <address> <value>
452 \begin_layout Standard
453 Write <value> to byte in address <address>.
456 \begin_layout Subsection
460 \begin_layout Standard
461 These commands are not available in lsnesrc, but are available after ROM
465 \begin_layout Subsubsection
469 \begin_layout Standard
473 \begin_layout Subsubsection
477 \begin_layout Standard
478 Toggle paused/unpaused
481 \begin_layout Subsubsection
485 \begin_layout Standard
487 If the button is still held after configurable timeout expires, game unpauses
488 for the duration frame advance is held.
491 \begin_layout Subsubsection
495 \begin_layout Standard
497 If the button is still held after configurable timeout expires, game unpauses
498 for the duration frame advance is held.
501 \begin_layout Subsubsection
505 \begin_layout Standard
506 Skip to first poll in frame after current.
509 \begin_layout Subsubsection
513 \begin_layout Standard
514 Reset the SNES after this frame.
517 \begin_layout Subsubsection
521 \begin_layout Standard
522 Load savestate <filename> in current mode.
525 \begin_layout Subsubsection
526 load-state <filename>
529 \begin_layout Standard
530 Load savestate <filename> in readwrite mode.
533 \begin_layout Subsubsection
534 load-readonly <filename>
537 \begin_layout Standard
538 Load savestate <filename> in readonly mode.
541 \begin_layout Subsubsection
542 load-preserve <filename>
545 \begin_layout Standard
546 Load savestate <filename> in readonly mode, preserving current events.
549 \begin_layout Subsubsection
550 load-movie <filename>
553 \begin_layout Standard
554 Load savestate <filename>, ignoring save part in readonly mode.
557 \begin_layout Subsubsection
558 save-state <filename>
561 \begin_layout Standard
562 Save system state to <filename> as soon as possible.
565 \begin_layout Subsubsection
566 save-movie <filename>
569 \begin_layout Standard
570 Save movie to <filename>.
573 \begin_layout Subsubsection
577 \begin_layout Standard
581 \begin_layout Subsubsection
585 \begin_layout Standard
589 \begin_layout Subsubsection
593 \begin_layout Standard
594 Toggle between read-only and read-write modes.
597 \begin_layout Subsubsection
598 test-1, test-2, test-3
601 \begin_layout Standard
602 Internal test commands.
606 \begin_layout Subsubsection
607 take-screenshot <filename>
610 \begin_layout Standard
611 Save screenshot to <filename>.
614 \begin_layout Subsubsection
615 +controller <class>-<#>-<button>
618 \begin_layout Standard
619 Press button <button> on controller <num> of class <class>.
622 \begin_layout Itemize
623 Class 'gamepad': A, B, X, Y, L, R, select, start, up, down, left, right,
624 ext0, ext1, ext2, ext3
627 \begin_layout Itemize
631 \begin_layout Itemize
632 Class 'superscope': trigger, cursor, turbo, pause
635 \begin_layout Itemize
636 Class 'justifier': trigger, start
639 \begin_layout Itemize
640 Class 'gb': A, B, select, start, up, down, left, right
643 \begin_layout Subsubsection
644 hold-controller <class>-<#>-<button>
647 \begin_layout Standard
648 Hold/unhold button <button> on controller <num> of class <class>.
651 \begin_layout Subsubsection
652 type-controller <class>-<#>-<button>
655 \begin_layout Standard
656 Hold/unhold button <button> on controller <num> of class <class> for the
658 See +controller for button names.
661 \begin_layout Standard
662 Cauntion: Does not work properly if outside frame advance.
665 \begin_layout Subsubsection
666 designate-position <class>-<#>-analog<n>
669 \begin_layout Standard
670 Designate position for analog pair.
671 <n> is only there if there are multiple axis pairs.
674 \begin_layout Subsubsection
675 autofire (<pattern>|-)...
678 \begin_layout Standard
679 Set autofire pattern.
680 Each parameter is comma-separated list of button names to hold on that
682 After reaching the end of pattern, the pattern restarts from the beginning.
685 \begin_layout Subsubsection
689 \begin_layout Standard
693 \begin_layout Subsubsection
697 \begin_layout Standard
698 Toggle pause on end flag.
701 \begin_layout Subsubsection
705 \begin_layout Standard
706 Set pause on end flag.
709 \begin_layout Subsubsection
713 \begin_layout Standard
714 Clear pause on end flag.
717 \begin_layout Subsection
721 \begin_layout Subsubsection
722 cycle-jukebox-backward
725 \begin_layout Standard
726 Cycle save jukebox backwards.
729 \begin_layout Subsubsection
730 cycle-jukebox-forward
733 \begin_layout Standard
734 Cycle save jukebox forwards
737 \begin_layout Subsubsection
741 \begin_layout Standard
742 Do load from jukebox (current mode).
745 \begin_layout Subsubsection
749 \begin_layout Standard
750 Do state save to jukebox.
753 \begin_layout Subsection
757 \begin_layout Standard
758 Only available if lua support is compiled in.
761 \begin_layout Subsubsection
762 evaluate-lua <luacode>
765 \begin_layout Standard
766 Run Lua code <luacode> using built-in Lua interpretter.
769 \begin_layout Subsubsection
773 \begin_layout Standard
774 Run specified lua file using built-in Lua interpretter.
777 \begin_layout Subsubsection
781 \begin_layout Standard
782 Clear the Lua VM state and restore to factory defaults.
785 \begin_layout Subsection
789 \begin_layout Subsubsection
790 add-watch <name> <expression>
793 \begin_layout Standard
794 Adds new watch (or modifies old one).
797 \begin_layout Subsubsection
801 \begin_layout Standard
805 \begin_layout Subsection
809 \begin_layout Subsubsection
810 enable-sound <on/off>
813 \begin_layout Standard
814 Enable/Disable sound.
817 \begin_layout Subsection
821 \begin_layout Subsubsection
825 \begin_layout Standard
826 Reloads the main ROM image from <file>.
829 \begin_layout Subsubsection
833 \begin_layout Standard
834 Tangent for recording voice for commentary track.
835 While pressed, record a stream.
838 \begin_layout Section
842 \begin_layout Subsection
846 \begin_layout Subsection
850 \begin_layout Subsubsection
854 \begin_layout Standard
855 AVI dumper: Always dump at 512x448 or 512x478 regardless of what the console
859 \begin_layout Subsubsection
863 \begin_layout Standard
864 AVI dumper: Set the default left border thickness (unless lua overrides)
870 \begin_layout Subsubsection
874 \begin_layout Standard
875 AVI dumper: Set the default right border thickness (unless lua overrides)
881 \begin_layout Subsubsection
885 \begin_layout Standard
886 AVI dumper: Set the default top border thickness (unless lua overrides)
892 \begin_layout Subsubsection
896 \begin_layout Standard
897 AVI dumper: Set the default bottom border thickness (unless lua overrides)
903 \begin_layout Subsubsection
907 \begin_layout Standard
908 AVI dumper: Maximum number of frames per dump segment (0 => unlimited).
913 \begin_layout Subsubsection
917 \begin_layout Standard
918 AVI dumper: Compression level (0-18).
921 \begin_layout Itemize
922 Compression levels 10 and above are not compatible with stock CSCD codec.
925 \begin_layout Itemize
926 Recomended level is 7.
929 \begin_layout Subsubsection
933 \begin_layout Standard
934 AVI dumper: Set method of determining the sound rate.
937 \begin_layout Itemize
938 0: Pick nearest of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, 48, 64, 88.2, 96,
939 128, 176.4 and 192 kHz.
942 \begin_layout Itemize
943 1: Round down to nearest integer.
946 \begin_layout Itemize
947 2: Round up to nearest ingeter.
950 \begin_layout Itemize
951 3: Multiply by denominator.
954 \begin_layout Itemize
955 4: High quality 44.1kHz (SRC needed).
958 \begin_layout Itemize
959 5: High quality 48kHz (SRC needed).
962 \begin_layout Subsection
966 \begin_layout Subsubsection
970 \begin_layout Standard
971 JMD dumper: Compression level (0-9).
974 \begin_layout Section
978 \begin_layout Subsection
982 \begin_layout Subsubsection
986 \begin_layout Standard
987 Print line to message console.
990 \begin_layout Subsubsection
994 \begin_layout Standard
995 Run command as it was entered on the command line
998 \begin_layout Subsubsection
1002 \begin_layout Standard
1004 First is time since some epoch in seconds, the second is microseconds mod
1005 10^6 since that epoch.
1008 \begin_layout Subsubsection
1012 \begin_layout Standard
1013 Returns true if emulator has finished booting, false if not (on_startup()
1014 will be issued later).
1017 \begin_layout Subsubsection
1018 set_idle_timeout(number timeout)
1021 \begin_layout Standard
1022 Set number of microseconds to block idle for.
1023 After this timeout has expired, on_idle() will be called once.
1026 \begin_layout Subsubsection
1027 set_timer_timeout(number timeout)
1030 \begin_layout Standard
1031 Set number of microseconds to block timer for.
1032 After this timeout has expired, on_timer() will be called once.
1035 \begin_layout Subsubsection
1036 bus_address(number snesaddr)
1039 \begin_layout Standard
1040 Returns virtual address corresponding to specified address on SNES bus.
1043 \begin_layout Subsubsection
1044 loopwrapper(function fun, ...)
1047 \begin_layout Standard
1048 Calls function fun with function and specified arguments.
1049 The function passed suspends execution until the function returned is called.
1050 Handy for linear flow control among multiple invocations of a hook.
1054 \begin_layout LyX-Code
1055 on_paint = loopwrapper(function(wait)
1059 \begin_layout LyX-Code
1064 \begin_layout LyX-Code
1066 \begin_inset Quotes eld
1070 \begin_inset Quotes erd
1076 \begin_layout LyX-Code
1081 \begin_layout LyX-Code
1086 \begin_layout LyX-Code
1090 \begin_layout Subsubsection
1091 list_bindings([string cmd])
1094 \begin_layout Standard
1095 Get table of all keybindings, indexed by keyspec (modifiers|mask/key).
1096 If command is specified, the table is limited to that command.
1097 Also searches for controller keys.
1100 \begin_layout Subsubsection
1101 get_alias(string aname)
1104 \begin_layout Standard
1105 Get expansion of given alias.
1108 \begin_layout Subsubsection
1109 set_alias(string aname, string value)
1112 \begin_layout Standard
1113 Set expansion of given alias.
1116 \begin_layout Subsubsection
1117 create_ibind(string name, string cmd)
1120 \begin_layout Standard
1121 Return object representing inverse binding with specified name and specified
1125 \begin_layout Itemize
1126 To create press/release commands, use aliases +foo and -foo .
1129 \begin_layout Itemize
1130 Keep the returned object around.
1133 \begin_layout Subsection
1137 \begin_layout Standard
1138 Bitwise logical functions and related.
1141 \begin_layout Subsubsection
1142 bit.none(number...) / bit.bnot(number...)
1145 \begin_layout Standard
1146 48-bit bitwise NOT / NONE function (set bits that are set in none of the
1150 \begin_layout Subsubsection
1151 bit.any(number...) / bit.bor(number...)
1154 \begin_layout Standard
1155 48-bit bitwise OR / ANY function (set bits that are set in any of the arguments).
1158 \begin_layout Subsubsection
1159 bit.all(number...) / bit.band(number...)
1162 \begin_layout Standard
1163 48-bit bitwise AND / ALL function (set bits that are set in all of the arguments
1167 \begin_layout Subsubsection
1168 bit.parity(number...) / bit.bxor(number...)
1171 \begin_layout Standard
1172 48-bit bitwise XOR / PARITY function (set bits that are set in odd number
1176 \begin_layout Subsubsection
1177 bit.lrotate(number base[, number amount[, number bits]])
1180 \begin_layout Standard
1181 Rotate bits-bit (max 48, default 48) number left by amount (default 1) places.
1184 \begin_layout Subsubsection
1185 bit.rrotate(number base[, number amount[, number bits]])
1188 \begin_layout Standard
1189 Rotate bits-bit (max 48, default 48) number right by amount (default 1)
1193 \begin_layout Subsubsection
1194 bit.lshift(number base[, number amount[, number bits]])
1197 \begin_layout Standard
1198 Shift bits-bit (max 48, default 48) number left by amount (default 1) places.
1199 The new bits are filled with zeroes.
1202 \begin_layout Subsubsection
1203 bit.lrshift(number base[, number amount[, number bits]])
1206 \begin_layout Standard
1207 Shift bits-bit (max 48, default 48) number logically right by amount (default
1209 The new bits are filled with zeroes.
1212 \begin_layout Subsubsection
1213 bit.arshift(number base[, number amount[, number bits]])
1216 \begin_layout Standard
1217 Shift bits-bit (max 48, default 48) number arithmetically right by amount
1219 The new bits are shifted in with copy of the high bit.
1222 \begin_layout Subsubsection
1223 bit.extract(number base[, number bit0[, number bit1,...]])
1226 \begin_layout Standard
1227 Returns number that has bit0-th bit as bit 0, bit1-th bit as 1 and so on.
1230 \begin_layout Standard
1234 \begin_layout Itemize
1235 Bit numbers up to 51 should work reliably (then things start falling apart
1236 due to double precision issues).
1239 \begin_layout Itemize
1240 There are two special bit positions, true and false, standing for always
1241 set bit and always clear bit.
1244 \begin_layout Subsubsection
1245 bit.value([number bit1[, number bit2,...]])
1248 \begin_layout Standard
1249 Returns bitwise OR of 1 left shifted by bit1 places, 1 left shifted by bit2
1251 As special value, nil argument is no-op.
1254 \begin_layout Subsubsection
1255 bit.test_any(number a, number b)
1258 \begin_layout Standard
1259 Returns true if bitwise and of a and b is nonzero, otherwise false.
1262 \begin_layout Subsubsection
1263 bit.test_all(number a, number b)
1266 \begin_layout Standard
1267 Returns true if bitwise and of a and b is equals b, otherwise false.
1270 \begin_layout Subsubsection
1271 bit.popcount(number a)
1274 \begin_layout Standard
1275 Returns number of set bits in a.
1278 \begin_layout Subsubsection
1279 bit.clshift(number a, number b, [number amount,[number bits]])
1282 \begin_layout Standard
1283 Does chained left shift on a, b by amount positions, assuming numbers to
1284 be of specified number of bits.
1287 \begin_layout Subsubsection
1288 bit.crshift(number a, number b, [number amount,[number bits]])
1291 \begin_layout Standard
1292 Does chained right shift on a, b by amount positions, assuming numbers to
1293 be of specified number of bits.
1296 \begin_layout Subsubsection
1297 bit.flagdecode(number a, number bits, [string on, [string off]])
1300 \begin_layout Standard
1301 Return string of length bits where ith character is ith character of on
1302 if bit i is on, otherwise ith character of off.
1303 Out of range reads give last character, or '*'/'-' if empty.
1306 \begin_layout Subsubsection
1307 bit.rflagdecode(number a, number bits, [string on, [string off]])
1310 \begin_layout Standard
1311 Like bit.flagdecode, but outputs the string in the opposite order (most significa
1315 \begin_layout Subsection
1319 \begin_layout Standard
1320 Most of these functions can only be called in on_paint and on_video callbacks.
1321 Exceptions are noted.
1324 \begin_layout Standard
1326 Bits 0-7 are the blue component, bits 8-15 are the green component, bits
1327 16-23 are the red component, bits 24-31 are alpha component (0 is fully
1328 opaque, 255 is almost transparent).
1329 -1 is the fully transparent color.
1330 Alpha values greater than 127 do work.
1333 \begin_layout Standard
1334 Origin of coordinates is at top left corner of game display area.
1335 Left and top gaps correspond to negative coordinates.
1338 \begin_layout Subsubsection
1342 \begin_layout Standard
1343 Returns 2-tuple (hresolution, vresolution).
1346 \begin_layout Subsubsection
1347 gui.<class>_gap(number gap)
1350 \begin_layout Standard
1351 Set the <class> (left, right, top, bottom) gap to specified value (max gap
1355 \begin_layout Subsubsection
1356 gui.text(number x, number y, string text[, number fgc[, number bgc]])
1359 \begin_layout Standard
1360 Draw specified text on the GUI (each character cell is 8 or 16 wide and
1365 \begin_layout Itemize
1366 x: X-coordinate to start the drawing from (and x-coordinate at begining
1370 \begin_layout Itemize
1371 y: Y-coordinate to start the drawing from.
1374 \begin_layout Itemize
1375 text: The text to draw.
1378 \begin_layout Itemize
1379 fgc: Text color (default is 0xFFFFFF (white))
1382 \begin_layout Itemize
1383 bgc: Background color (default is -1 (transparent))
1386 \begin_layout Subsubsection
1387 gui.textH(number x, number y, string text[, number fgc[, number bgc]])
1390 \begin_layout Standard
1391 Like gui.text, but draw using double-width.
1394 \begin_layout Subsubsection
1395 gui.textV(number x, number y, string text[, number fgc[, number bgc]])
1398 \begin_layout Standard
1399 Like gui.text, but draw using double-height.
1402 \begin_layout Subsubsection
1403 gui.textHV(number x, number y, string text[, number fgc[, number bgc]])
1406 \begin_layout Standard
1407 Like gui.text, but draw using double-width/double-height.
1410 \begin_layout Subsubsection
1411 gui.rectangle(number x, number y, number width, number height[, number thickness[
1412 , number outline[, number fill]]])
1415 \begin_layout Standard
1416 Draw rectangle on the GUI.
1420 \begin_layout Itemize
1421 x: X-coordinate of left edge.
1424 \begin_layout Itemize
1425 y: Y-coordinate of upper edge.
1428 \begin_layout Itemize
1429 width: Width of rectangle.
1432 \begin_layout Itemize
1433 height: Height of rectangle.
1436 \begin_layout Itemize
1437 thickness: Thickness of outline (default is 1).
1440 \begin_layout Itemize
1441 outline: Color of outline (default is 0xFFFFFF (white))
1444 \begin_layout Itemize
1445 fill: Color of fill (default is -1 (transparent))
1448 \begin_layout Subsubsection
1449 gui.box(number x, number y, number width, number height[, number thickness[,
1450 number outline1[,number outline2[, number fill]]]])
1453 \begin_layout Standard
1454 Draw rectangle with 3D effect on the GUI.
1458 \begin_layout Itemize
1459 x: X-coordinate of left edge.
1462 \begin_layout Itemize
1463 y: Y-coordinate of upper edge.
1466 \begin_layout Itemize
1467 width: Width of rectangle.
1470 \begin_layout Itemize
1471 height: Height of rectangle.
1474 \begin_layout Itemize
1475 thickness: Thickness of outline (default is 1).
1478 \begin_layout Itemize
1479 outline1: First color of outline (default is 0xFFFFFF (white))
1482 \begin_layout Itemize
1483 outline2: First color of outline (default is 0x808080 (dark gray))
1486 \begin_layout Itemize
1487 fill: Color of fill (default is 0xC0C0C0 (light grayy))
1490 \begin_layout Subsubsection
1491 gui.pixel(number x, number y[, number color])
1494 \begin_layout Standard
1495 Draw one pixel on the GUI.
1499 \begin_layout Itemize
1500 x: X-coordinate of the pixel
1503 \begin_layout Itemize
1504 y: Y-coordinate of the pixel
1507 \begin_layout Itemize
1508 color: Color of the pixel (default is 0xFFFFFF (white))
1511 \begin_layout Subsubsection
1512 gui.crosshair(number x, number y[, number length[, number color]])
1515 \begin_layout Standard
1520 \begin_layout Itemize
1521 x: X-coordinate of the crosshair
1524 \begin_layout Itemize
1525 y: Y-coordinate of the crosshair
1528 \begin_layout Itemize
1529 length: Length of the crosshair lines (default 10).
1532 \begin_layout Itemize
1533 color: Color of the crosshair (default is 0xFFFFFF (white))
1536 \begin_layout Subsubsection
1537 gui.line(number x1, number y1, number x2, number y2[, number color])
1540 \begin_layout Standard
1545 \begin_layout Itemize
1546 x1: X-coordinate of one end.
1549 \begin_layout Itemize
1550 y1: Y-coordinate of one end.
1553 \begin_layout Itemize
1554 x2: X-coordinate of the other end.
1557 \begin_layout Itemize
1558 y2: Y-coordinate of the other end.
1561 \begin_layout Itemize
1562 color: Color of the line (default is 0xFFFFFF (white)).
1565 \begin_layout Subsubsection
1566 gui.circle(number x, number y, number r[, number thick[, number border[,
1570 \begin_layout Standard
1575 \begin_layout Itemize
1576 x: X-coordinate of the center
1579 \begin_layout Itemize
1580 y: Y-coordinate of the center
1583 \begin_layout Itemize
1584 r: The radius of the circle
1587 \begin_layout Itemize
1588 thick: Border thickness
1591 \begin_layout Itemize
1592 border: Border color (default is 0xFFFFFF (white))
1595 \begin_layout Itemize
1596 fill: Fill color (default is -1 (transparent)).
1599 \begin_layout Subsubsection
1600 gui.bitmap_draw(number x, number y, bitmap bitmap, palette palette)
1603 \begin_layout Standard
1604 Draw a bitmap on screen with specified palette.
1608 \begin_layout Itemize
1609 x: X-coordinate of left edge.
1612 \begin_layout Itemize
1613 y: Y-coordinate of top edge.
1616 \begin_layout Itemize
1617 bitmap: The bitmap to draw
1620 \begin_layout Itemize
1621 palette: The palette to draw the bitmap using.
1624 \begin_layout Subsubsection
1625 gui.bitmap_draw(number x, number y, dbitmap bitmap)
1628 \begin_layout Standard
1629 Draw a bitmap on screen.
1633 \begin_layout Itemize
1634 x: X-coordinate of left edge.
1637 \begin_layout Itemize
1638 y: Y-coordinate of top edge.
1641 \begin_layout Itemize
1642 bitmap: The bitmap to draw
1645 \begin_layout Subsubsection
1649 \begin_layout Standard
1650 Returns a new palette (initially all transparent).
1651 Can be used anywhere.
1654 \begin_layout Subsubsection
1655 gui.bitmap_new(number w, number h, boolean direct[, bool icolor])
1658 \begin_layout Standard
1659 Returns a new bitmap/dbitmap.
1660 Can be used anywhere.
1664 \begin_layout Itemize
1665 w: The width of new bitmap
1668 \begin_layout Itemize
1669 h: The height of new bitmap
1672 \begin_layout Itemize
1673 direct: If true, the returned bitmap is dbitmap, otherwise bitmap.
1676 \begin_layout Itemize
1677 icolor: Initital fill color (defaults to 0 on BITMAP, -1 on DBITMAP)
1680 \begin_layout Subsubsection
1681 gui.bitmap_load(string file)
1684 \begin_layout Standard
1685 Returns loaded bitmap/dbitmap (if bitmap, the second return value is palette
1687 Can be used anywhere.
1691 \begin_layout Itemize
1692 file: The name of file to load.
1695 \begin_layout Subsubsection
1696 gui.palette_set(palette palette, number index, number color)
1699 \begin_layout Standard
1700 Sets color in palette.
1701 Can be used anywhere.
1705 \begin_layout Itemize
1706 palette: The palette to manipulate
1709 \begin_layout Itemize
1710 index: Index of color (0-65535).
1713 \begin_layout Itemize
1714 color: The color value.
1717 \begin_layout Subsubsection
1718 gui.bitmap_pset(bitmap/dbitmap bitmap, number x, number y, number color)
1721 \begin_layout Standard
1722 Sets specified pixel in bitmap.
1723 Can be used anywhere.
1727 \begin_layout Itemize
1728 bitmap: The bitmap to manipulate
1731 \begin_layout Itemize
1732 x: The x-coordinate of the pixel.
1735 \begin_layout Itemize
1736 y: The y-coordinate of the pixel.
1739 \begin_layout Itemize
1740 color: If bitmap is a bitmap, color index (0-65535).
1741 Otherwise color value.
1744 \begin_layout Subsubsection
1745 gui.bitmap_size(bitmap/dbitmap bitmap)
1748 \begin_layout Standard
1750 Can be used anywhere.
1754 \begin_layout Itemize
1755 bitmap: The bitmap to query.
1758 \begin_layout Standard
1759 The first return is the width, the second is the height.
1762 \begin_layout Subsubsection
1763 gui.bitmap_blit(bitmap/dbitmap dest, number dx, number dy, bitmap/dbitmap
1764 src, number sx, number sy, number w, number h[, number ck])
1767 \begin_layout Standard
1768 Blit a part of bitmap to another.
1769 Can be used anywhere.
1773 \begin_layout Itemize
1774 dest: Destination to blit to.
1777 \begin_layout Itemize
1778 dx: left edge of target
1781 \begin_layout Itemize
1782 dy: Top edge of target
1785 \begin_layout Itemize
1786 src: The source to blit from.
1787 Must be of the same type as destination.
1790 \begin_layout Itemize
1791 sx: left edge of source
1794 \begin_layout Itemize
1795 sy: Top edge of source
1798 \begin_layout Itemize
1802 \begin_layout Itemize
1803 h: Height of region.
1806 \begin_layout Itemize
1808 Pixels of this color are not blitted.
1812 \begin_layout Itemize
1813 If bitmaps are bitmaps, this is color index of colorkey.
1814 Values outside range 0-65535 cause no key to be used as colorkey.
1817 \begin_layout Itemize
1818 If bitmaps are dbitmaps, this color value of colorkey.
1821 \begin_layout Itemize
1822 May be absent or nil for no colorkey blit.
1826 \begin_layout Subsubsection
1830 \begin_layout Standard
1831 Request on_repaint() to happen as soon as possible.
1832 Can be used anywhere.
1835 \begin_layout Subsubsection
1836 gui.subframe_update(boolean on)
1839 \begin_layout Standard
1840 Request subframe updates (calling on_paint() on subframes) to happen (on=true)
1841 or not happen (on=false).
1842 Can be used anywhere.
1845 \begin_layout Subsubsection
1846 gui.screenshot(string filename)
1849 \begin_layout Standard
1850 Write PNG screenshot of the current frame (no drawings) to specified file.
1851 Can be used anywhere.
1854 \begin_layout Subsubsection
1855 gui.color(number r, number g, number b[, number a])
1858 \begin_layout Standard
1859 Returns color (in notation Lua scripts use) corresponding to color (r,g,b),
1860 each component in scale 0-255.
1861 If a is specified, that is alpha (0 is fully transparent, 256(sic) is fully
1863 The default alpha is 256.
1866 \begin_layout Subsubsection
1867 gui.status(string name, string value)
1870 \begin_layout Standard
1872 \begin_inset Quotes eld
1876 \begin_inset Quotes erd
1879 to <value> in status area.
1880 Can be used anywhere.
1883 \begin_layout Subsubsection
1884 gui.rainbow(number step, number steps[, number color])
1887 \begin_layout Standard
1888 Perform hue rotation of color <color> (default bright red), by <step> steps.
1889 The number of steps per full rotation is given by absolute value of <steps>.
1892 \begin_layout Standard
1893 If <steps> is negative, the rotation will be counterclockwise.
1896 \begin_layout Subsubsection
1897 gui.screenshot(string filename)
1900 \begin_layout Standard
1901 Saves a screenshot into specified file.
1904 \begin_layout Subsubsection
1905 gui.renderq_new(number width, number height)
1908 \begin_layout Standard
1909 Create render queue with specified reported size and return it.
1912 \begin_layout Subsubsection
1913 gui.renderq_clear(RENDERQUEUE queue)
1916 \begin_layout Standard
1917 Clear specified render queue.
1920 \begin_layout Subsubsection
1921 gui.renderq_set(RENDERQUEUE queue)
1924 \begin_layout Standard
1925 Switch to specified render queue.
1926 Use nil as queue to switch to default queue.
1929 \begin_layout Itemize
1930 When switched to another queue, all drawing functions work and draw there,
1931 even outside on_video/on_paint.
1934 \begin_layout Subsubsection
1935 gui.renderq_run(RENDERQUEUE queue)
1938 \begin_layout Standard
1939 Run specified render queue, copying the objects to current render queue.
1943 \begin_layout Itemize
1944 Warning: Don't try to run the current render queue.
1947 \begin_layout Subsubsection
1948 gui.loadfont(string filename)
1951 \begin_layout Standard
1952 Loads font from specified file (CUSTOMFONT object).
1955 \begin_layout Subsubsection
1956 CUSTOMFONT(number x, number y, string text[, number fgc[, number bgc]])
1959 \begin_layout Standard
1960 Draw string with custom font to screen.
1961 The parameters are the same as in gui.text.
1964 \begin_layout Subsection
1968 \begin_layout Standard
1970 Only available in on_input callback.
1973 \begin_layout Subsubsection
1974 input.get(number controller, number index)
1977 \begin_layout Standard
1978 Read the specified index (0-11) from specified controller (0-7).
1982 \begin_layout Itemize
1983 Uses physical controller numbering.
1984 Gamepad in port 2 is controller 4, not 1!
1987 \begin_layout Subsubsection
1988 input.set(number controller, number index, number value)
1991 \begin_layout Standard
1992 Write the specified index (0-11) from specified controller (0-7), storing
1997 \begin_layout Itemize
1998 Uses physical controller numbering.
1999 Gamepad in port 2 is controller 4, not 1!
2002 \begin_layout Subsubsection
2003 input.get2(number port, number controller, number index)
2006 \begin_layout Standard
2007 Read the specified input tuple.
2010 \begin_layout Itemize
2011 Port 0 is system port.
2014 \begin_layout Subsubsection
2015 input.set2(number port, number controller, number index, number value)
2018 \begin_layout Standard
2019 Write the specified input tuple.
2022 \begin_layout Itemize
2023 Port 0 is system port.
2026 \begin_layout Subsubsection
2027 input.lcid_to_pcid2(number lcid)
2030 \begin_layout Standard
2031 Look up physical pcid pair (port, controller) corresponding to specified
2032 logical controller (1-based).
2033 Returns nothing if controller does not exist.
2036 \begin_layout Subsubsection
2037 input.port_type(number port)
2040 \begin_layout Standard
2041 Return type of specified port.
2044 \begin_layout Subsubsection
2045 input.controller_info(number port, number controller)
2048 \begin_layout Standard
2049 Get controller info for specified controller.
2050 If controller does not exist, returns nil.
2051 Otherwise returns a table with following fields:
2054 \begin_layout Itemize
2055 type (string): Type of the controller.
2058 \begin_layout Itemize
2059 class (string): Class of the controller.
2062 \begin_layout Itemize
2063 classnum (number): Number of the controller within its class (1-based)
2066 \begin_layout Itemize
2067 lcid (number): Logical controller number of the controller.
2070 \begin_layout Itemize
2071 button_count (number): Number of buttons on controller
2074 \begin_layout Itemize
2075 buttons (array): Array of following info about each button:
2079 \begin_layout Itemize
2080 type (string): Type of button.
2082 \begin_inset Quotes eld
2086 \begin_inset Quotes erd
2090 \begin_inset Quotes eld
2094 \begin_inset Quotes erd
2098 \begin_inset Quotes eld
2102 \begin_inset Quotes erd
2106 \begin_inset Quotes eld
2110 \begin_inset Quotes erd
2116 \begin_layout Itemize
2117 name (string): Name of button.
2120 \begin_layout Itemize
2121 symbol (string): Symbol of button.
2122 Only present for type
2123 \begin_inset Quotes eld
2127 \begin_inset Quotes erd
2133 \begin_layout Itemize
2134 hidden (boolean): True if hidden button.
2139 \begin_layout Subsubsection
2143 \begin_layout Standard
2144 Signals that the button event should be vetoed.
2145 Only valid in on_button callback.
2148 \begin_layout Subsubsection
2149 input.geta(number controller)
2152 \begin_layout Standard
2153 Get input state for entiere controller.
2154 Returns 13 return values.
2157 \begin_layout Itemize
2158 1st return value: Bitmask: bit i is set if i:th index is nonzero
2161 \begin_layout Itemize
2162 2nd-13th return value: value of i:th index.
2165 \begin_layout Subsubsection
2166 input.seta(number controller, number bitmask, number args...)
2169 \begin_layout Standard
2170 Set state for entiere controller.
2171 args is up to 12 values for indices (overriding values in bitmask if specified).
2174 \begin_layout Subsubsection
2175 input.controllertype(number controller)
2178 \begin_layout Standard
2179 Get the type of controller as string.
2183 \begin_layout Itemize
2187 \begin_layout Itemize
2191 \begin_layout Itemize
2195 \begin_layout Itemize
2199 \begin_layout Subsubsection
2200 input.reset([number cycles])
2203 \begin_layout Standard
2205 If cycles is greater than zero, do delayed reset.
2206 0 (or no value) causes immediate reset.
2209 \begin_layout Itemize
2210 Only available with subframe flag false.
2213 \begin_layout Subsubsection
2217 \begin_layout Standard
2218 Returns table of tables of all available keys and axes.
2219 The first table is indexed by key name (platform-dependent!), and the inner
2220 table has the following fields:
2223 \begin_layout Itemize
2224 value: Last reported value for control
2228 \begin_layout Itemize
2229 For keys: 1 for pressed, 0 for released.
2232 \begin_layout Itemize
2233 For axes: -32767...32767.
2236 \begin_layout Itemize
2237 For presure-sensitive buttons: 0...32767.
2240 \begin_layout Itemize
2241 For hats: Bitmask: 1=>Up, 2=>Right, 4=>Down, 8=>Left.
2244 \begin_layout Itemize
2245 For mouse: Coordinates relative to game area.
2249 \begin_layout Itemize
2250 ktype: Type of key (disabled, key, mouse, axis, axis-inverse, hat, pressure-m0,
2251 pressure-mp, pressure-0m, pressure-0p, pressure-pm, pressure-p0).
2254 \begin_layout Subsubsection
2255 input.keyhook(string key, boolean state)
2258 \begin_layout Standard
2259 Requests that keyhook events to be sent for key (state=true) or not sent
2263 \begin_layout Subsubsection
2264 input.joyget(number controller)
2267 \begin_layout Standard
2268 Returns table for current controls for specified controller.
2269 The names of fields vary by controller type.
2272 \begin_layout Itemize
2273 The buttons have the same name as those are referred to in other contexts
2277 \begin_layout Itemize
2279 \begin_inset Quotes eld
2283 \begin_inset Quotes erd
2287 \begin_inset Quotes eld
2291 \begin_inset Quotes erd
2297 \begin_layout Subsubsection
2298 input.joyset(number controller, table controls)
2301 \begin_layout Standard
2302 Set the the state of specified controller to values specified in specified
2306 \begin_layout Subsubsection
2307 input.lcid_to_pcid(number controller)
2310 \begin_layout Standard
2311 Return the physical index, physical port and controller number in port for
2312 specified (1-based) logical controller.
2315 \begin_layout Subsection
2319 \begin_layout Standard
2320 Various keybinding-related functions
2323 \begin_layout Subsubsection
2324 keyboard.bind(string mod, string mask, string key, string cmd)
2327 \begin_layout Standard
2328 Bind specified key with specified modifers to specified command.
2331 \begin_layout Subsubsection
2332 keyboard.unbind(string mod, string mask, string key)
2335 \begin_layout Standard
2336 Unbind specified key with specified modifers.
2339 \begin_layout Subsubsection
2340 keyboard.alias(string alias, string expansion)
2343 \begin_layout Standard
2344 Set expansion of given command.
2347 \begin_layout Subsection
2351 \begin_layout Standard
2355 \begin_layout Subsubsection
2356 subtitle.byindex(number i)
2359 \begin_layout Standard
2360 Read the frame and length of ith subtitle.
2361 Returns nothing if not present.
2364 \begin_layout Subsubsection
2365 subtitle.set(number f, number l, string txt)
2368 \begin_layout Standard
2369 Set the text of subtitle.
2372 \begin_layout Subsubsection
2373 subtitle.get(number f, number l)
2376 \begin_layout Standard
2377 Get the text of subtitle.
2380 \begin_layout Subsubsection
2381 subtitle.delete(number f, number l)
2384 \begin_layout Standard
2385 Delete specified subtitle.
2388 \begin_layout Subsection
2392 \begin_layout Standard
2393 Host memory handling (extra memory saved to savestates).
2394 Host memory starts empty.
2397 \begin_layout Subsubsection
2398 hostmemory.read(number address)
2401 \begin_layout Standard
2402 Reads hostmemory slot address.
2403 Slot numbers out of range return false instead of numeric.
2406 \begin_layout Subsubsection
2407 hostmemory.write(number address, number value)
2410 \begin_layout Standard
2411 Writes hostmemory slot with 0-255.
2412 Slot numbers out of range cause extension of host memory slot space.
2415 \begin_layout Subsubsection
2416 hostmemory.readbyte(number address)
2419 \begin_layout Standard
2420 Read unsigned byte (1 element) from given address.
2421 Slots out of range return false.
2424 \begin_layout Subsubsection
2425 hostmemory.writebyte(number address, number value)
2428 \begin_layout Standard
2429 Write unsigned byte (1 element) to given slot.
2430 Slot numbers out of range cause extension.
2433 \begin_layout Subsubsection
2434 hostmemory.readsbyte(number address)
2437 \begin_layout Standard
2438 Read signed byte (1 element) from given address.
2439 Slots out of range return false.
2442 \begin_layout Subsubsection
2443 hostmemory.writesbyte(number address, number value)
2446 \begin_layout Standard
2447 Write signed byte (1 element) to given slot.
2448 Slot numbers out of range cause extension.
2451 \begin_layout Subsubsection
2452 hostmemory.readword(number address)
2455 \begin_layout Standard
2456 Read unsigned word (2 elements) from given address.
2457 Slots out of range return false.
2460 \begin_layout Subsubsection
2461 hostmemory.writeword(number address, number value)
2464 \begin_layout Standard
2465 Write unsigned word (2 elements) to given slot.
2466 Slot numbers out of range cause extension.
2469 \begin_layout Subsubsection
2470 hostmemory.readsword(number address)
2473 \begin_layout Standard
2474 Read signed word (2 elements) from given address.
2475 Slots out of range return false.
2478 \begin_layout Subsubsection
2479 hostmemory.writesword(number address, number value)
2482 \begin_layout Standard
2483 Write signed word (2 elements) to given slot.
2484 Slot numbers out of range cause extension.
2487 \begin_layout Subsubsection
2488 hostmemory.readdword(number address)
2491 \begin_layout Standard
2492 Read unsigned doubleword (4 elements) from given address.
2493 Slots out of range return false.
2496 \begin_layout Subsubsection
2497 hostmemory.writedword(number address, number value)
2500 \begin_layout Standard
2501 Write unsigned doubleword (4 elements) to given slot.
2502 Slot numbers out of range cause extension.
2505 \begin_layout Subsubsection
2506 hostmemory.readsdword(number address)
2509 \begin_layout Standard
2510 Read signed doubleword (4 elements) from given address.
2511 Slots out of range return false.
2514 \begin_layout Subsubsection
2515 hostmemory.writesdword(number address, number value)
2518 \begin_layout Standard
2519 Write signed doubleword (4 elements) to given slot.
2520 Slot numbers out of range cause extension.
2523 \begin_layout Subsubsection
2524 hostmemory.readqword(number address)
2527 \begin_layout Standard
2528 Read unsigned quadword (8 elements) from given address.
2529 Slots out of range return false.
2532 \begin_layout Subsubsection
2533 hostmemory.writeqword(number address, number value)
2536 \begin_layout Standard
2537 Write unsigned quadword (4 elements) to given slot.
2538 Slot numbers out of range cause extension.
2541 \begin_layout Subsubsection
2542 hostmemory.readsqword(number address)
2545 \begin_layout Standard
2546 Read signed quadword (8 elements) from given address.
2547 Slots out of range return false.
2550 \begin_layout Subsubsection
2551 hostmemory.writesqword(number address, number value)
2554 \begin_layout Standard
2555 Write signed quadword (8 elements) to given slot.
2556 Slot numbers out of range cause extension.
2559 \begin_layout Subsection
2563 \begin_layout Standard
2567 \begin_layout Subsubsection
2568 movie.currentframe()
2571 \begin_layout Standard
2572 Return number of current frame.
2575 \begin_layout Subsubsection
2579 \begin_layout Standard
2580 Return number of frames in movie.
2583 \begin_layout Subsubsection
2587 \begin_layout Standard
2588 Return true if in readonly mode, false if in readwrite.
2591 \begin_layout Subsubsection
2595 \begin_layout Standard
2596 Returns the current value of rerecord count.
2599 \begin_layout Subsubsection
2600 movie.set_readwrite()
2603 \begin_layout Standard
2604 Set readwrite mode (does not cause on_readwrite callback).
2607 \begin_layout Subsubsection
2608 movie.frame_subframes(number frame)
2611 \begin_layout Standard
2612 Count number of subframes in specified frame (frame numbers are 1-based)
2616 \begin_layout Subsubsection
2617 movie.read_subframe(number frame, number subframe)
2620 \begin_layout Standard
2621 Read specifed subframe in specified frame and return data as array (100
2622 elements, numbered 0-99 currently).
2625 \begin_layout Subsubsection
2629 \begin_layout Standard
2630 Returns the current value of the RTC as a pair (second, subsecond).
2633 \begin_layout Subsubsection
2634 movie.unsafe_rewind([UNSAFEREWIND state])
2637 \begin_layout Standard
2638 Start setting point for unsafe rewind or jump to point of unsafe rewind.
2641 \begin_layout Itemize
2642 If called without argument, causes emulator to start process of setting
2643 unsafe rewind point.
2644 When this has finished, callback on_set_rewind occurs, passing the rewind
2645 state to lua script.
2648 \begin_layout Itemize
2649 If called with argument, causes emulator rewind to passed rewind point as
2651 Readwrite mode is implicitly activated.
2654 \begin_layout Standard
2655 The following warnings apply to unsafe rewinding:
2658 \begin_layout Itemize
2659 There are no safety checks against misuse (that's what
2660 \begin_inset Quotes eld
2664 \begin_inset Quotes erd
2670 \begin_layout Itemize
2671 Only call rewind from timeline rewind point was set from.
2674 \begin_layout Itemize
2675 Only call rewind from after the rewind point was set.
2678 \begin_layout Subsection
2682 \begin_layout Standard
2683 Routines for settings manipulation
2686 \begin_layout Subsubsection
2687 settings.get(string name)
2690 \begin_layout Standard
2691 Get value of setting.
2692 If setting is blank, returns false.
2693 If setting value can't be obtained, returns (nil, error message).
2696 \begin_layout Subsubsection
2697 settings.set(string name, string value)
2700 \begin_layout Standard
2701 Set value of setting.
2702 If setting can't be set, returns (nil, error message).
2705 \begin_layout Subsubsection
2706 settings.is_set(string name)
2709 \begin_layout Standard
2710 Returns if setting is set.
2711 If setting does not exist, returns (nil, error message).
2714 \begin_layout Subsubsection
2715 settings.blank(string name)
2718 \begin_layout Standard
2719 Blanks a setting and returns true.
2720 If setting can't be blanked, returns (nil, error message).
2723 \begin_layout Subsection
2727 \begin_layout Standard
2728 Contains various functions for managing memory
2731 \begin_layout Subsubsection
2735 \begin_layout Standard
2736 Returns the number of VMAs
2739 \begin_layout Subsubsection
2740 memory.read_vma(number index)
2743 \begin_layout Standard
2744 Reads the specified VMA (indices start from zero).
2745 Trying to read invalid VMA gives nil.
2746 The read VMA is table with the following fields:
2749 \begin_layout Itemize
2750 region_name (string): The readable name of the VMA
2753 \begin_layout Itemize
2754 baseaddr (number): Base address of the VMA
2757 \begin_layout Itemize
2758 lastaddr (number): Last address in the VMA.
2761 \begin_layout Itemize
2762 size (number): The size of VMA in bytes.
2765 \begin_layout Itemize
2766 readonly (boolean): True of the VMA corresponds to ROM.
2769 \begin_layout Itemize
2770 iospace (boolean): True if the VMA is I/O space.
2773 \begin_layout Itemize
2774 native_endian (boolean): True if the VMA has native endian as opposed to
2778 \begin_layout Subsubsection
2779 memory.find_vma(number address)
2782 \begin_layout Standard
2783 Finds the VMA containing specified address.
2784 Returns table in the same format as read_vma or nil if not found.
2787 \begin_layout Subsubsection
2788 memory.readbyte(number address)
2791 \begin_layout Standard
2792 Reads the specified address as unsigned byte and returns the result.
2795 \begin_layout Subsubsection
2796 memory.readsbyte(number address)
2799 \begin_layout Standard
2800 Reads the specified address as signed byte and returns the result.
2803 \begin_layout Subsubsection
2804 memory.writebyte(number address, number value)
2807 \begin_layout Standard
2808 Writes the specified value (negative values undergo 2's complement) to specified
2809 address (as a byte).
2812 \begin_layout Subsubsection
2813 memory.readword(number address)
2816 \begin_layout Standard
2817 Reads the specified address as unsigned word and returns the result.
2820 \begin_layout Subsubsection
2821 memory.readsword(number address)
2824 \begin_layout Standard
2825 Reads the specified address as signed word and returns the result.
2828 \begin_layout Subsubsection
2829 memory.writeword(number address, number value)
2832 \begin_layout Standard
2833 Writes the specified value (negative values undergo 2's complement) to specified
2834 address (as a word).
2837 \begin_layout Subsubsection
2838 memory.readdword(number address)
2841 \begin_layout Standard
2842 Reads the specified address as unsigned doubleword and returns the result.
2845 \begin_layout Subsubsection
2846 memory.readsdword(number address)
2849 \begin_layout Standard
2850 Reads the specified address as signed doubleword and returns the result.
2853 \begin_layout Subsubsection
2854 memory.writedword(number address, number value)
2857 \begin_layout Standard
2858 Writes the specified value (negative values undergo 2's complement) to specified
2859 address (as a doubleword).
2862 \begin_layout Subsubsection
2863 memory.readqword(number address)
2866 \begin_layout Standard
2867 Reads the specified address as unsigned quadword and returns the result.
2870 \begin_layout Subsubsection
2871 memory.readsqword(number address)
2874 \begin_layout Standard
2875 Reads the specified address as signed quadword and returns the result.
2878 \begin_layout Subsubsection
2879 memory.writeqword(number address, number value)
2882 \begin_layout Standard
2883 Writes the specified value (negative values undergo 2's complement) to specified
2884 address (as a quadword).
2887 \begin_layout Subsubsection
2888 memory.hash_region(number base, number size)
2891 \begin_layout Standard
2892 Hash specified number of bytes starting from specified address and return
2896 \begin_layout Subsubsection
2900 \begin_layout Standard
2901 Hash the current system state.
2902 Mainly useful for debugging savestates.
2905 \begin_layout Subsubsection
2906 memory.readregion(number base, number size)
2909 \begin_layout Standard
2910 Read a region of memory.
2913 \begin_layout Itemize
2914 Warning: If the region crosses VMA boundary, the results are undefined.
2917 \begin_layout Subsubsection
2918 memory.map<type>([number base, number size])
2921 \begin_layout Standard
2922 Returns a table mapping specified memory aperture for read/write.
2923 If parameters are omitted, entiere map space is the aperture.
2926 \begin_layout Itemize
2927 Type may be one of: byte, sbyte, word, sword, dword, sdword, qword or sqword.
2930 \begin_layout Subsubsection
2931 memory.writeregion(number base, number size, table data)
2934 \begin_layout Standard
2935 Write a region of memory.
2938 \begin_layout Itemize
2939 Warning: If the region crosses VMA boundary, the results are undefined.
2942 \begin_layout Subsubsection
2943 memory.map_structure()
2946 \begin_layout Standard
2947 Returns a new mapping structure (MMAP_STRUCT)
2950 \begin_layout Subsubsection
2951 MMAP_STRUCT(string key, number address, string type)
2954 \begin_layout Standard
2955 Bind key in mmap structure to specified address with specified type.
2958 \begin_layout Itemize
2959 Type may be one of: byte, sbyte, word, sword, dword, sdword, qword or sqword.
2962 \begin_layout Subsubsection
2963 memory.read_expr(string expr)
2966 \begin_layout Standard
2967 Evaluate specified watch expression and return result
2970 \begin_layout Subsection
2974 \begin_layout Standard
2975 Contains functions for manipulating subtitles.
2978 \begin_layout Subsubsection
2979 subtitle.byindex(number index)
2982 \begin_layout Standard
2983 Get (basetime, length) pair of specified subtitle index or nothing if index
2987 \begin_layout Subsubsection
2988 subtitle.get(number basetime, number length)
2991 \begin_layout Standard
2992 Read the specified subtitle.
2994 \begin_inset Quotes eld
2998 \begin_inset Quotes erd
3001 if the subtitle does not exist.
3004 \begin_layout Subsubsection
3005 subtitle.set(number basetime, number length, string content)
3008 \begin_layout Standard
3009 Set the specified subtitle.
3012 \begin_layout Subsubsection
3013 subtitle.deltete(number basetime, number length)
3016 \begin_layout Standard
3017 Delete the specified subtitle.
3020 \begin_layout Subsection
3024 \begin_layout Standard
3025 Contains copy of global variables from time of Lua initialization.
3029 \begin_layout Subsection
3033 \begin_layout Standard
3034 Various callbacks to Lua that can occur.
3037 \begin_layout Subsubsection
3038 Callback: on_paint(bool not_synth)
3041 \begin_layout Standard
3042 Called when screen is being painted.
3043 Any gui.* calls requiring graphic context draw on the screen.
3046 \begin_layout Standard
3047 not_synth is true if this hook is being called in response to received frame,
3051 \begin_layout Subsubsection
3052 Callback: on_video()
3055 \begin_layout Standard
3056 Called when video dump frame is being painted.
3057 Any gui.* calls requiring graphic context draw on the video.
3060 \begin_layout Subsubsection
3061 Callback: on_frame_emulated()
3064 \begin_layout Standard
3065 Called when emulating frame has completed and on_paint()/on_video() calls
3066 are about to be issued.
3069 \begin_layout Subsubsection
3070 Callback: on_frame()
3073 \begin_layout Standard
3074 Called on each starting whole frame.
3077 \begin_layout Subsubsection
3078 Callback: on_startup()
3081 \begin_layout Standard
3082 Called when the emulator is starting (lsnes.rc and --run files has been run).
3085 \begin_layout Subsubsection
3086 Callback: on_rewind()
3089 \begin_layout Standard
3090 Called when rewind movie to beginning has completed.
3093 \begin_layout Subsubsection
3094 Callback: on_pre_load(string name)
3097 \begin_layout Standard
3098 Called just before savestate/movie load occurs (note: loads are always delayed,
3099 so this occurs even when load was initiated by lua).
3102 \begin_layout Subsubsection
3103 Callback: on_err_load(string name)
3106 \begin_layout Standard
3107 Called if loadstate goes wrong.
3110 \begin_layout Subsubsection
3111 Callback: on_post_load(string name, boolean was_savestate)
3114 \begin_layout Standard
3115 Called on successful loadstate.
3116 was_savestate gives if this was a savestate or a movie.
3119 \begin_layout Subsubsection
3120 Callback: on_pre_save(string name, boolean is_savestate)
3123 \begin_layout Standard
3124 Called just before savestate save occurs (note: movie saves are synchronous
3125 and won't trigger these callbacks if called from Lua).
3128 \begin_layout Subsubsection
3129 Callback: on_err_save(string name)
3132 \begin_layout Standard
3133 Called if savestate goes wrong.
3136 \begin_layout Subsubsection
3137 Callback: on_post_save(string name, boolean is_savestate)
3140 \begin_layout Standard
3141 Called on successful savaestate.
3142 is_savestate gives if this was a savestate or a movie.
3145 \begin_layout Subsubsection
3149 \begin_layout Standard
3150 Called when emulator is shutting down.
3153 \begin_layout Subsubsection
3154 Callback: on_input(boolean subframe)
3157 \begin_layout Standard
3158 Called when emulator is just sending input to bsnes core.
3159 Warning: This is called even in readonly mode, but the results are ignored.
3162 \begin_layout Subsubsection
3163 Callback: on_reset()
3166 \begin_layout Standard
3167 Called when SNES is reset.
3170 \begin_layout Subsubsection
3171 Callback: on_readwrite()
3174 \begin_layout Standard
3175 Called when moving into readwrite mode as result of
3176 \begin_inset Quotes eld
3180 \begin_inset Quotes erd
3183 command (note: moving to rwmode by Lua won't trigger this, as per recursive
3187 \begin_layout Subsubsection
3188 Callback: on_snoop(number port, number controller, number index, number
3192 \begin_layout Standard
3193 Called each time bsnes asks for input.
3194 The value is the final value to be sent to bsnes core (readonly mode, autohold
3195 and autofire have been taken into account).
3196 Might be useful when translating movies to format suitable for console
3198 Note: There is no way to modify the value to be sent.
3201 \begin_layout Itemize
3202 Not called if callback on_snoop2 is defined.
3205 \begin_layout Subsubsection
3206 Callback: on_snoop2(number port, number controller, number index, number
3210 \begin_layout Standard
3211 Like on_snoop, but reserves port 0 for system, having first user port be
3215 \begin_layout Subsubsection
3216 Callback: on_keyhook(string keyname, table state)
3219 \begin_layout Standard
3220 Sent when key that has keyhook events requested changes state.
3221 Keyname is name of the key (group) and state is the state (same kind as
3222 table values in input.raw).
3225 \begin_layout Subsubsection
3229 \begin_layout Standard
3230 Called when requested by set_idle_timeout(), the timeout has expired and
3231 emulator is waiting.
3234 \begin_layout Subsubsection
3235 Callback: on_timer()
3238 \begin_layout Standard
3239 Called when requested by set_idle_timeout() and the timeout has expired
3240 (regardless if emulator is waiting).
3243 \begin_layout Subsubsection
3244 Callback: on_set_rewind(UNSAFEREWIND r)
3247 \begin_layout Standard
3248 Called when unsafe rewind object has been constructed.
3251 \begin_layout Subsubsection
3252 Callback: on_pre_rewind()
3255 \begin_layout Standard
3256 Called just before unsafe rewind is about to occur.
3259 \begin_layout Subsubsection
3260 Callback: on_post_rewind()
3263 \begin_layout Standard
3264 Called just after unsafe rewind has occured.
3267 \begin_layout Subsubsection
3268 Callback: on_button(number port, number controller, number index, string
3272 \begin_layout Standard
3273 Called on controller button press, with following parameters:
3276 \begin_layout Itemize
3277 port: Port number (0 is system)
3280 \begin_layout Itemize
3281 controller: Controller within port
3284 \begin_layout Itemize
3285 index: Index of button.
3288 \begin_layout Itemize
3289 type: Type of event, one of:
3293 \begin_layout Itemize
3294 \begin_inset Quotes eld
3298 \begin_inset Quotes erd
3301 : Button was pressed.
3304 \begin_layout Itemize
3305 \begin_inset Quotes eld
3309 \begin_inset Quotes erd
3312 : Button was released.
3315 \begin_layout Itemize
3316 \begin_inset Quotes eld
3320 \begin_inset Quotes erd
3326 \begin_layout Itemize
3327 \begin_inset Quotes eld
3331 \begin_inset Quotes erd
3334 : Released from hold.
3337 \begin_layout Itemize
3338 \begin_inset Quotes eld
3342 \begin_inset Quotes erd
3345 : Typing input on button.
3348 \begin_layout Itemize
3349 \begin_inset Quotes eld
3353 \begin_inset Quotes erd
3356 : Typing input undone.
3359 \begin_layout Itemize
3360 \begin_inset Quotes eld
3364 \begin_inset Quotes erd
3367 : Analog action on axis.
3371 \begin_layout Section
3375 \begin_layout Itemize
3376 The editor edits in-memory movie.
3379 \begin_layout Itemize
3380 Because past can't be edited and readwrite mode doesn't allow future, editing
3388 \begin_layout Itemize
3389 Keyboard triggers the normal hotkeys and bindings.
3392 \begin_layout Subsection
3396 \begin_layout Itemize
3397 Clicking on cell in future (indicated by lack of redish background) toggles
3398 it (if it is a button) or prompts for a value (if it is an axis)
3401 \begin_layout Itemize
3402 Dragging vertically toggles sequence of buttons or changes a sequence of
3406 \begin_layout Subsection
3407 Right button actions
3410 \begin_layout Standard
3411 The right mouse button pops up a context-sensitive menu:
3414 \begin_layout Itemize
3415 Toggle <something>: Toggle this button
3418 \begin_layout Itemize
3419 Change <something>: Change this axis value
3422 \begin_layout Itemize
3423 Insert frame after: Insert a frame after this frame
3426 \begin_layout Itemize
3427 Append frame: Append a frame to movie
3430 \begin_layout Itemize
3431 Append frames: Append specified number of frames to movie
3434 \begin_layout Itemize
3435 Delete frame: Delete this frame
3438 \begin_layout Itemize
3439 Delete subframe: Delete this subframe
3442 \begin_layout Itemize
3443 Truncate movie: Delete this subframe and everything after it.
3446 \begin_layout Itemize
3447 Scroll to frame: Prompt for a frame and scroll the display to that frame.
3450 \begin_layout Itemize
3451 Scroll to current frame: Scroll the display to current position
3454 \begin_layout Itemize
3455 Run to frame: Prompts for frame and runs the emulation to that frame.
3458 \begin_layout Itemize
3459 Change number of lines visible: Change the height of the movie display (1
3463 \begin_layout Itemize
3464 Lock scroll to playback: While playing back or rewinding movies, the display
3465 will follow if enabled.
3468 \begin_layout Section
3469 Memory watch expression syntax
3472 \begin_layout Standard
3473 Memory watch expressions are in RPN (Reverse Polish Notation).
3474 At the end of expression, the top entry on stack is taken as the final
3478 \begin_layout Standard
3482 \begin_layout Itemize
3483 Evaluation order is strictly left to right.
3486 \begin_layout Itemize
3487 a is the entry on top of stack
3490 \begin_layout Itemize
3491 b is the entry immediately below top of stack
3494 \begin_layout Itemize
3495 ; separates values to be pushed (no intermediate pop).
3498 \begin_layout Itemize
3499 After end of element, all used stack slots are popped and all results are
3503 \begin_layout Itemize
3504 When pushing multiple values, the pushes occur in order shown.
3507 \begin_layout Standard
3508 The following operators are available:
3511 \begin_layout Itemize
3515 \begin_layout Itemize
3519 \begin_layout Itemize
3523 \begin_layout Itemize
3527 \begin_layout Itemize
3531 \begin_layout Itemize
3535 \begin_layout Itemize
3536 b : read_signed_byte(a)
3539 \begin_layout Itemize
3543 \begin_layout Itemize
3544 d : read_signed_dword(a)
3547 \begin_layout Itemize
3551 \begin_layout Itemize
3553 \begin_inset Formula $\pi$
3559 \begin_layout Itemize
3560 q : read_signed_qword(a)
3563 \begin_layout Itemize
3567 \begin_layout Itemize
3571 \begin_layout Itemize
3575 \begin_layout Itemize
3579 \begin_layout Itemize
3580 w : read_signed_word(a)
3583 \begin_layout Itemize
3587 \begin_layout Itemize
3588 B : read_unsigned_byte(a)
3591 \begin_layout Itemize
3592 C<number>z : Push number <number> to stack.
3595 \begin_layout Itemize
3596 D : read_unsigned_dword(a)
3599 \begin_layout Itemize
3600 C0x<number>z : Push number <number> (hexadecimal) to stack.
3603 \begin_layout Itemize
3604 H<digit> : Set hexadecimal mode with specified number of digits (use A-G
3608 \begin_layout Itemize
3609 Q : read_unsigned_qword(a)
3612 \begin_layout Itemize
3613 R<digit> : round a to <digit> digits.
3616 \begin_layout Itemize
3617 W : read_unsigned_word(a)
3620 \begin_layout Subsection
3624 \begin_layout Standard
3625 C0x007e0878zWC0x007e002czW-
3628 \begin_layout Enumerate
3629 Push value 0x7e0878 on top of stack (C0x007e0878z).
3632 \begin_layout Enumerate
3633 Pop the value on top of stack (0x7e0878), read word value at that address
3634 and push the result,call it x1 (W).
3637 \begin_layout Enumerate
3638 Push value 0x7e002c on top of stack (C0x007e002cz).
3641 \begin_layout Enumerate
3642 Pop the value on top of stack (0x7e002c), read word value at that address
3643 and push the result,call it x2 (W).
3646 \begin_layout Enumerate
3647 Pop the two top numbers on stack, x1 and x2, substract x1 from x2 and push
3651 \begin_layout Enumerate
3652 Since the expression ends, the final memory watch result is the top one
3653 on stack, which is x2 - x1.
3656 \begin_layout Section
3657 Modifier and key names:
3660 \begin_layout Subsection
3664 \begin_layout Subsubsection
3668 \begin_layout Standard
3669 Following modifier names are known:
3672 \begin_layout Itemize
3676 \begin_layout Itemize
3680 \begin_layout Itemize
3684 \begin_layout Itemize
3688 \begin_layout Itemize
3692 \begin_layout Subsubsection
3696 \begin_layout Standard
3697 Following key names are known:
3700 \begin_layout Itemize
3701 back, tab, return, escape, space, exclaim, quotedbl, hash, dollar, percent,
3702 ampersand, quote, leftparen, rightparen, asterisk, plus, comma, minus,
3703 period, slash, 0, 1, 2, 3, 4, 5, 6, 7, 8, 9, colon, semicolon, less, equals,
3704 greater, question, at, a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p,
3705 q, r, s, t, u, v, w, x, y, z, leftbracket, backslash, rightbracket, caret,
3706 underscore, backquote, a, b, c, d, e, f, g, h, i, j, k, l, m, n, o, p,
3707 q, r, s, t, u, v, w, x, y, z, leftcurly, pipe, rightcurly, tilde, delete,
3708 start, lbutton, rbutton, cancel, mbutton, clear, shift, alt, control, menu,
3709 pause, capital, end, home, lefT, up, right, down, select, print, execute,
3710 snapshot, insert, help, numpad0, numpad1, numpad2, numpad3, numpad4, numpad5,
3711 numpad6, numpad7, numpad8, numpad9, multiply, add, separator, subtract,
3712 decimal, divide, f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, f11, f12, f13,
3713 f14, f15, f16, f17, f18, f19, f20, f21, f22, f23, f24, numlock, scroll,
3714 pageup, pagedown, numpad_space, numpad_tab, numpad_enter, numpad_f1, numpad_f2,
3715 numpad_f3, numpad_f4, numpad_home, numpad_left, numpad_up, numpad_right,
3716 numpad_down, numpad_pageup, numpad_pagedown, numpad_end, numpad_begin,
3717 numpad_insert, numpad_delete, numpad_equal, numpad_multiply, numpad_add,
3718 numpad_separator, numpad_subtract, numpad_decimal, numpad_divide, windows_left,
3719 windows_right, windows_menu, command, special1, special2, special3, special4,
3720 special5, special6, special7, special8, special9, special10, special11,
3721 special12, special13, special14, special15, special16, special17, special18,
3722 special19, special20
3725 \begin_layout Section
3729 \begin_layout Standard
3730 Movie file is .zip archive in itself, normal ZIP archive tools work on it
3731 (note: If you recompress it, do not use compression methods other than
3732 store and deflate and especially do not use encryption of any kind).
3735 \begin_layout Subsection
3736 Detecting clean start/SRAM/Savestate
3739 \begin_layout Itemize
3741 \begin_inset Quotes eld
3745 \begin_inset Quotes erd
3748 it is savestate, otherwise:
3751 \begin_layout Itemize
3752 If file has members with names starting
3753 \begin_inset Quotes eld
3757 \begin_inset Quotes erd
3760 it is movie starting from SRAM, otherwise:
3763 \begin_layout Itemize
3764 It is movie starting from clear state.
3767 \begin_layout Subsection
3771 \begin_layout Standard
3772 Type of game ROM and region (as one line).
3776 \begin_layout Standard
3777 \begin_inset Tabular
3778 <lyxtabular version="3" rows="8" columns="3">
3779 <features tabularvalignment="middle">
3780 <column alignment="center" valignment="top" width="0">
3781 <column alignment="center" valignment="top" width="0">
3782 <column alignment="center" valignment="top" width="0">
3784 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
3787 \begin_layout Plain Layout
3793 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
3796 \begin_layout Plain Layout
3802 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
3805 \begin_layout Plain Layout
3813 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3816 \begin_layout Plain Layout
3822 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3825 \begin_layout Plain Layout
3831 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
3834 \begin_layout Plain Layout
3842 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3845 \begin_layout Plain Layout
3851 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3854 \begin_layout Plain Layout
3860 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
3863 \begin_layout Plain Layout
3871 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3874 \begin_layout Plain Layout
3880 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3883 \begin_layout Plain Layout
3889 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
3892 \begin_layout Plain Layout
3900 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3903 \begin_layout Plain Layout
3909 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3912 \begin_layout Plain Layout
3918 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
3921 \begin_layout Plain Layout
3929 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3932 \begin_layout Plain Layout
3938 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3941 \begin_layout Plain Layout
3947 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
3950 \begin_layout Plain Layout
3958 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3961 \begin_layout Plain Layout
3967 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
3970 \begin_layout Plain Layout
3976 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
3979 \begin_layout Plain Layout
3987 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
3990 \begin_layout Plain Layout
3996 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
3999 \begin_layout Plain Layout
4005 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
4008 \begin_layout Plain Layout
4022 \begin_layout Standard
4026 \begin_layout Standard
4027 \begin_inset Tabular
4028 <lyxtabular version="3" rows="3" columns="2">
4029 <features tabularvalignment="middle">
4030 <column alignment="center" valignment="top" width="0">
4031 <column alignment="center" valignment="top" width="0">
4033 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
4036 \begin_layout Plain Layout
4042 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
4045 \begin_layout Plain Layout
4053 <cell alignment="center" valignment="top" topline="true" leftline="true" usebox="none">
4056 \begin_layout Plain Layout
4062 <cell alignment="center" valignment="top" topline="true" leftline="true" rightline="true" usebox="none">
4065 \begin_layout Plain Layout
4073 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" usebox="none">
4076 \begin_layout Plain Layout
4082 <cell alignment="center" valignment="top" topline="true" bottomline="true" leftline="true" rightline="true" usebox="none">
4085 \begin_layout Plain Layout
4099 \begin_layout Subsection
4103 \begin_layout Standard
4104 Contains type of port #1 (as one line).
4105 Valid values are 'none', 'gamepad', 'multitap' and 'mouse'.
4106 If not present, defaults to 'gamepad'.
4109 \begin_layout Subsection
4113 \begin_layout Standard
4114 Contains type of port #2 (as one line).
4115 Valid values are 'none', 'gamepad', 'multitap', 'mouse', 'superscope',
4116 'justifier' and 'justifiers'.
4117 If not present, defaults to 'none'.
4120 \begin_layout Subsection
4124 \begin_layout Standard
4125 Contains name of the game (as one line).
4128 \begin_layout Subsection
4132 \begin_layout Standard
4133 Contains authors, one per line.
4134 Part before '|' is the full name, part after is the nickname.
4137 \begin_layout Subsection
4141 \begin_layout Standard
4143 \begin_inset Quotes eld
4147 \begin_inset Quotes erd
4151 Used to reject other saves.
4154 \begin_layout Subsection
4155 Member: controlsversion
4158 \begin_layout Standard
4160 \begin_inset Quotes eld
4164 \begin_inset Quotes erd
4168 Used to identify what controls are there.
4171 \begin_layout Subsection
4173 \begin_inset Quotes eld
4177 \begin_inset Quotes erd
4183 \begin_layout Standard
4184 Contains bsnes core version number (as one line).
4187 \begin_layout Subsection
4191 \begin_layout Standard
4192 Contains project ID (as one line).
4193 Used to identify if two movies are part of the same project.
4196 \begin_layout Subsection
4197 Member: {rom,slota,slotb}{,xml}.sha256
4200 \begin_layout Standard
4201 Contains SHA-256 of said ROM or ROM mapping file (as one line).
4202 Absent if corresponding file is absent.
4205 \begin_layout Subsection
4206 Member: moviesram.<name>
4209 \begin_layout Standard
4210 Raw binary startup SRAM of kind <name>.
4211 Only present in savestates and movies starting from SRAM.
4214 \begin_layout Subsection
4218 \begin_layout Standard
4219 Contains frame number (as one line) of frame movie was saved on.
4220 Only present in savestates.
4223 \begin_layout Subsection
4227 \begin_layout Standard
4228 Current value of lag counter (as one line).
4229 Only present in savestates.
4232 \begin_layout Subsection
4233 Member: pollcounters
4236 \begin_layout Standard
4237 Contains poll counters (currently 100 of them), one per line.
4238 Each line is raw poll count if DRDY is set for it.
4239 Otherwise it is negative poll count minus one.
4240 Only present in savestates.
4243 \begin_layout Subsection
4247 \begin_layout Standard
4248 Raw binary dump of host memory.
4249 Only present in savestates.
4252 \begin_layout Subsection
4256 \begin_layout Standard
4257 The raw binary savestate itself.
4258 Savestate detection uses this file, only present in savestates.
4261 \begin_layout Subsection
4265 \begin_layout Standard
4266 Screenshot of current frame.
4267 Only present in savestates.
4268 First 2 bytes are big-endian width of image, rest are 24-bit RGB image
4270 Height of image is inferred from the width and size of data.
4273 \begin_layout Subsection
4277 \begin_layout Standard
4278 Raw binary SRAM of kind <name> at time of savestate.
4279 Only present in savestates.
4282 \begin_layout Subsection
4286 \begin_layout Standard
4287 The actual input track, one line per subframe (blank lines are skipped).
4290 \begin_layout Itemize
4291 If the first byte of each line is '.', ' ', <tab> or '|', then the line is
4292 part of same frame as previous, otherwise it starts a new frame.
4295 \begin_layout Itemize
4296 First subframe must start a new frame.
4299 \begin_layout Standard
4300 Length of movie in frames is number of lines in input file that start a
4304 \begin_layout Subsection
4308 \begin_layout Standard
4313 \begin_layout Itemize
4314 Each line is in form <firstframe> <numframes> <text>.
4317 \begin_layout Itemize
4318 Linefeed is encoded as
4320 n, backslash is encoded as
4327 \begin_layout Subsection
4331 \begin_layout Standard
4332 Contains textual base-10 rerecord count (as one line; emulator just writes
4333 this, it doesn't read it) + 1.
4336 \begin_layout Subsection
4340 \begin_layout Standard
4341 This member stores set of load IDs.
4342 There is one load ID per rerecord (plus one corresponding to start of project).
4345 \begin_layout Itemize
4346 This member constists of concatenation of records
4349 \begin_layout Itemize
4350 Each record is 2-36 bytes long and can represent 1-16,843,009 consequtive
4354 \begin_layout Itemize
4355 IDs are interpretted as 256-bit big-endian integers with warparound.
4358 \begin_layout Itemize
4359 Initial predicted ID is all zeroes.
4362 \begin_layout Standard
4363 Format of each record is:
4366 \begin_layout Itemize
4367 1 byte: Opcode byte.
4368 Bits 0-4 are prefix length (prefixlen), bits 5-6 are count length (countlen).
4372 \begin_layout Itemize
4373 32-prefixlen bytes of ID.
4376 \begin_layout Itemize
4377 countlen bytes of big-endian count (count).
4380 \begin_layout Standard
4381 Records are processed as follows:
4384 \begin_layout Itemize
4385 To form the first ID encoded by record, take the first prefixlen bytes predicted
4386 ID and append the read ID value to it.
4387 The result is the first ID encoded.
4390 \begin_layout Itemize
4391 If countlen is 0, record encodes 1 ID.
4394 \begin_layout Itemize
4395 If countlen is 1, record encodes 2+count IDs.
4398 \begin_layout Itemize
4399 If countlen is 2, record encodes 258+count IDs.
4402 \begin_layout Itemize
4403 If countlen is 3, record encodes 65794+count IDs.
4406 \begin_layout Itemize
4407 The new predicted ID is the next ID after last one encoded by the record.
4410 \begin_layout Standard
4411 The number of rerecords + 1 is equal to the sum of number of IDs encoded
4415 \begin_layout Subsection
4416 Member: starttime.second
4419 \begin_layout Standard
4420 Movie starting time, second part.
4421 Epoch is Unix epoch.
4422 Default is 1,000,000,000.
4425 \begin_layout Subsection
4426 Member: starttime.subsecond
4429 \begin_layout Standard
4430 Movie starting time, subsecond part.
4435 \begin_layout Subsection
4436 Member: savetime.second
4439 \begin_layout Standard
4440 Movie saving time, second part.
4441 Default is starttime.second.
4442 Only present in savestates.
4445 \begin_layout Subsection
4446 Member: savetime.subsecond
4449 \begin_layout Standard
4450 Movie saving time, subsecond part.
4451 Default is starttime.subsecond.
4452 Only present in savestates.
4455 \begin_layout Section
4456 lsvs file format (commentary tracks)
4459 \begin_layout Subsection
4463 \begin_layout Itemize
4464 Each cluster is 8kB (8192 bytes) in size.
4467 \begin_layout Itemize
4468 Cluster n starts at offset 8192*n in file.
4471 \begin_layout Itemize
4472 The following clusters are system special:
4476 \begin_layout Itemize
4477 Cluster 0 and all clusters with number multiple of 2048 (cluster tables)
4480 \begin_layout Itemize
4481 Cluster 1 (superblock)
4485 \begin_layout Subsection
4489 \begin_layout Itemize
4490 The cluster table describing cluster n is stored in cluster n & ~0x7FF (zero
4494 \begin_layout Itemize
4495 This cluster table consists of 2048 4-byte big-endian integers.
4498 \begin_layout Itemize
4499 Each entry describes a cluster in 16MB supercluster, in order.
4502 \begin_layout Itemize
4503 The valid values for entries are:
4507 \begin_layout Itemize
4508 0x00000000: Free cluster
4511 \begin_layout Itemize
4512 0x00000001: Last cluster in chain.
4515 \begin_layout Itemize
4516 0xFFFFFFFF: System cluster (cluster tables and superblock)
4519 \begin_layout Itemize
4520 (anything else): Number of next cluster in chain.
4521 Must not be multiple of 2048.
4525 \begin_layout Itemize
4526 Due to limitations of the format, there can be at most 2097052 superclusters,
4527 giving maximum file size of 16TB.
4530 \begin_layout Subsection
4534 \begin_layout Itemize
4535 The stream table chain always starts in cluster 2.
4538 \begin_layout Itemize
4539 Otherwise, it follows normal chaining.
4542 \begin_layout Itemize
4543 The stream table consists of 16-byte entries:
4547 \begin_layout Itemize
4548 The first 8 bytes of entry give big-endian beginning position of stream
4549 in units of 1/48000 s.
4552 \begin_layout Itemize
4553 The next 4 bytes of entry give big-endian beginning cluster for control
4555 0 here marks the entry as not present.
4558 \begin_layout Itemize
4559 The last 4 bytes of entry give big-endian beginning cluster for codec data.
4563 \begin_layout Itemize
4564 Stream table clusters are normal clusters, following normal chaining.
4567 \begin_layout Itemize
4568 The stream begnning position is not guarenteed unique.
4569 There can be multiple streams with the same starting position in the file.
4572 \begin_layout Subsection
4576 \begin_layout Itemize
4577 The stream control data consists of entries 4 bytes each:
4581 \begin_layout Itemize
4582 The first 2 bytes of entry gives big-endian length of packet
4585 \begin_layout Itemize
4586 The next byte of entry gives audio length of packet in units of 1/400 s.
4589 \begin_layout Itemize
4590 The last byte is control byte.
4594 \begin_layout Itemize
4595 0 means this entry is not present and the control data ends.
4598 \begin_layout Itemize
4599 1 is valid control entry.
4604 \begin_layout Itemize
4605 The stream control data can also end by running into end of the readable
4610 \begin_layout Itemize
4611 This happens if there happens to be exact multiple of 2048 packets in stream
4612 and number of packets is nonzero.
4616 \begin_layout Itemize
4617 These clusters follow normal chaining.
4620 \begin_layout Subsection
4624 \begin_layout Itemize
4625 Stream codec data consists of raw Opus data packets packed back to back
4626 with nothing in between.
4629 \begin_layout Itemize
4630 Warning: Due to internal limitations, this data must reside in the first
4631 65536 superclusters (that is, the first 1TB of the file).
4634 \begin_layout Subsection
4638 \begin_layout Itemize
4639 The superblock is stored in cluster 1.
4643 \begin_layout Itemize
4644 The first 11 bytes are
4645 \begin_inset Quotes eld
4649 \begin_inset Quotes erd
4655 \begin_layout Itemize
4656 The rest are unused.
4659 \begin_layout Itemize
4660 This cluster 1 is marked as system special.
4663 \begin_layout Section
4664 Known ROM extensions
4667 \begin_layout Itemize
4668 SNES cartridge ROMs: sfc, smc, swc, fig, ufo, sf2, gd3, gd7, dx2, mgd, mgh.
4671 \begin_layout Itemize
4672 DMG cartridge ROMs: dmg, gb.
4675 \begin_layout Itemize
4676 GBC cartridge ROMs: cgb, gbc.
4679 \begin_layout Section
4683 \begin_layout Itemize
4684 The first line must be:
4685 \begin_inset Quotes eld
4689 \begin_inset Quotes erd
4695 \begin_layout Itemize
4696 There is one needed line:
4697 \begin_inset Quotes eld
4701 \begin_inset Quotes erd
4705 This sets system type to <systype>.
4706 The following system types are valid:
4710 \begin_layout Itemize
4714 \begin_layout Itemize
4715 bsx (BS-X non-slotted)
4718 \begin_layout Itemize
4719 bsxslotted (BS-X slotted)
4722 \begin_layout Itemize
4723 sufamiturbo (Sufami Turbo)
4726 \begin_layout Itemize
4727 sgb (Super Game Boy)
4730 \begin_layout Itemize
4734 \begin_layout Itemize
4735 gbc (Game Boy Color)
4738 \begin_layout Itemize
4739 gbc_gba (Game Boy Color with GBA initial register values)
4743 \begin_layout Itemize
4744 Optionally a region can be specified:
4745 \begin_inset Quotes eld
4749 \begin_inset Quotes erd
4753 The following values are valid:
4757 \begin_layout Itemize
4758 autodetect (Autodetect region: snes and sgb only)
4761 \begin_layout Itemize
4762 ntsc (NTSC: snes, bsx, bsxslotted, sufamiturbo, sgb)
4765 \begin_layout Itemize
4766 pal (PAL: snes, sgb)
4769 \begin_layout Itemize
4770 world (World: dmg, gbc, gbc_gba)
4774 \begin_layout Itemize
4775 ROM images are loaded as:
4776 \begin_inset Quotes eld
4780 \begin_inset Quotes erd
4784 The following types are valid:
4788 \begin_layout Itemize
4789 rom (Cartridge ROM in snes, dmg, gbc, gbc_gba.
4790 BIOS in bsx, bsxslotted, sufamiturbo)
4793 \begin_layout Itemize
4794 bsx (Cartridge ROM in bsx, bsxslotted)
4797 \begin_layout Itemize
4798 slot-a (Cartridge ROM in sufamiturbo)
4801 \begin_layout Itemize
4802 slot-b (Cartridge ROM in sufamiturbo)
4806 \begin_layout Itemize
4807 ROM markup can be loaded as:
4808 \begin_inset Quotes eld
4812 \begin_inset Quotes erd
4816 The types valid are the same as for ROMs.
4819 \begin_layout Itemize
4820 Patches can be loaded as
4821 \begin_inset Quotes eld
4824 patch[<offset>] <type> <file>
4825 \begin_inset Quotes erd
4829 The types are the same as for ROMs.
4833 \begin_layout Itemize
4834 Offset is given in form [+-]<number>.
4835 Usually offset is either +0 or -512.
4838 \begin_layout Itemize
4839 Default offset is +0.
4843 \begin_layout Subsection
4847 \begin_layout LyX-Code
4851 \begin_layout LyX-Code
4855 \begin_layout LyX-Code
4856 rom rom speedygonzales.sfc
4859 \begin_layout LyX-Code
4860 patch-512 rom sonicthehedgehog.ips
4863 \begin_layout Subsection
4867 \begin_layout LyX-Code
4871 \begin_layout LyX-Code
4875 \begin_layout LyX-Code
4876 rom rom supergameboy.sfc
4879 \begin_layout LyX-Code
4880 rom dmg megamanV.dmg
4883 \begin_layout Section
4884 Quick'n'dirty encode guide
4887 \begin_layout Enumerate
4888 Start the emulator and load the ROM and movie file.
4891 \begin_layout Enumerate
4892 Set large AVI option 'set-setting avi-large on'
4895 \begin_layout Enumerate
4896 Enable dumping 'dump-avi tmpdump'
4899 \begin_layout Enumerate
4900 Unpause and let it run until you want to end dumping.
4903 \begin_layout Enumerate
4904 Close the emulator (closing the window is the easiest way).
4908 \begin_layout Enumerate
4909 For each tmpdump*.avi file created, on command prompt, do 'x264 --crf 10
4910 -o tmpdump_<numbers>.mkv tmpdump_<numbers>.avi'.
4913 \begin_layout Enumerate
4914 Do 'sox tmpdump.sox tmpdump.ogg rate -v 32000'
4917 \begin_layout Enumerate
4918 Do 'mkvmerge -o tmpdump_video.mkv tmpdump_0000000.mkv + tmpdump_0000001.mkv
4919 + tmpdump_0000002.mkv' (list every tmpdump_<numbers>.mkv, with + in between).
4922 \begin_layout Enumerate
4923 Do 'mkvmerge -o final.mkv tmpdump_video.mkv tmpdump.ogg'.
4924 Now final.mkv contains quick'n'dirty encode.
4927 \begin_layout Section
4928 Axis configurations for some gamepad types:
4931 \begin_layout Subsection
4935 \begin_layout Standard
4936 Axes 2 and 5 (joystick<n>axis2 and joystick<n>axis5) should be set to pressure-+.
4939 \begin_layout LyX-Code
4940 set-axis joystick0axis2 pressure-+
4943 \begin_layout LyX-Code
4944 set-axis joystick0axis5 pressure-+
4947 \begin_layout Itemize
4948 This is needed for SDL only.
4949 EVDEV sets those types correctly.
4952 \begin_layout Subsection
4954 \begin_inset Quotes eld
4958 \begin_inset Quotes erd
4964 \begin_layout Standard
4965 Axes 8-19 should be disabled.
4968 \begin_layout LyX-Code
4969 set-axis joystick0axis8 disabled
4972 \begin_layout LyX-Code
4973 set-axis joystick0axis9 disabled
4976 \begin_layout LyX-Code
4977 set-axis joystick0axis10 disabled
4980 \begin_layout LyX-Code
4981 set-axis joystick0axis11 disabled
4984 \begin_layout LyX-Code
4985 set-axis joystick0axis12 disabled
4988 \begin_layout LyX-Code
4989 set-axis joystick0axis13 disabled
4992 \begin_layout LyX-Code
4993 set-axis joystick0axis14 disabled
4996 \begin_layout LyX-Code
4997 set-axis joystick0axis15 disabled
5000 \begin_layout LyX-Code
5001 set-axis joystick0axis16 disabled
5004 \begin_layout LyX-Code
5005 set-axis joystick0axis17 disabled
5008 \begin_layout LyX-Code
5009 set-axis joystick0axis18 disabled
5012 \begin_layout LyX-Code
5013 set-axis joystick0axis19 disabled
5016 \begin_layout Section
5020 \begin_layout Subsection
5021 Problems from BSNES core:
5024 \begin_layout Itemize
5025 The whole pending save stuff.
5028 \begin_layout Itemize
5029 Lack of layer hiding.
5032 \begin_layout Itemize
5033 It is slow (especially accuracy).
5036 \begin_layout Itemize
5037 Firmwares can't be loaded from ZIP archives.
5040 \begin_layout Subsection
5044 \begin_layout Itemize
5045 Modifiers don't work with pseudo-keys (SDL, EVDEV).
5048 \begin_layout Itemize
5049 Audio for last dumped frame is not itself dumped.
5052 \begin_layout Itemize
5053 Audio in UI is pretty bad in quality if game doesn't run at full speed.
5056 \begin_layout Itemize
5057 No menus, command based interface (SDL).
5060 \begin_layout Itemize
5061 Long commands don't scroll.
5064 \begin_layout Section
5068 \begin_layout Subsection
5072 \begin_layout Itemize
5076 \begin_layout Itemize
5077 Fix dumper video corruption with levels 10-18.
5080 \begin_layout Subsection
5084 \begin_layout Itemize
5088 \begin_layout Itemize
5089 Lots of code cleanups
5092 \begin_layout Itemize
5093 Lua interface to settings
5096 \begin_layout Itemize
5097 Allow specifying AVI borders without Lua
5100 \begin_layout Itemize
5101 Fix scaling if vscale > 1 and originx > 0 (left border exists)
5104 \begin_layout Itemize
5105 on_snoop lua callback
5108 \begin_layout Itemize
5109 Faster movie loading and saving.
5112 \begin_layout Subsection
5116 \begin_layout Itemize
5120 \begin_layout Subsection
5124 \begin_layout Itemize
5128 \begin_layout Itemize
5129 Save jukebox functionality.
5132 \begin_layout Subsection
5136 \begin_layout Itemize
5137 Try to fix some nasty failing movie load edge cases
5140 \begin_layout Itemize
5141 Allow specifying scripts to run on command line.
5144 \begin_layout Subsection
5148 \begin_layout Itemize
5149 Major source code reorganization.
5152 \begin_layout Itemize
5153 Backup savestates before overwriting.
5156 \begin_layout Itemize
5157 Don't crash if loading initial state fails.
5160 \begin_layout Subsection
5164 \begin_layout Itemize
5168 \begin_layout Itemize
5169 Fix author name parsing
5172 \begin_layout Itemize
5173 Fix rerecord counting
5176 \begin_layout Itemize
5177 (SDL) Print messages to console if SDL is uninitialized
5180 \begin_layout Itemize
5181 Add movieinfo program
5184 \begin_layout Itemize
5185 Fix loading movies starting from SRAM.
5188 \begin_layout Subsection
5192 \begin_layout Itemize
5193 Add support for unattended dumping
5196 \begin_layout Itemize
5197 Fix compiling for Win32
5200 \begin_layout Itemize
5201 Don't lock up if sound can't be initialized
5204 \begin_layout Itemize
5205 Strip trailing CR from commands
5208 \begin_layout Itemize
5209 Don't try to do dubious things in global ctors (fix crash on startup)
5212 \begin_layout Subsection
5216 \begin_layout Itemize
5217 Small documentation tweaking
5220 \begin_layout Itemize
5224 \begin_layout Itemize
5225 Fix major bug in modifier matching
5228 \begin_layout Subsection
5232 \begin_layout Itemize
5233 Lots of documentation fixes
5236 \begin_layout Itemize
5237 Use dedicated callbacks for event backcomm., not commands.
5240 \begin_layout Itemize
5241 Ensure that the watchdog is not hit when executing delayed reset.
5244 \begin_layout Itemize
5245 Remove errant tab from joystick message.
5248 \begin_layout Subsection
5252 \begin_layout Itemize
5253 Make autofire operate in absolute time, not linear time
5256 \begin_layout Itemize
5257 Reinitialize controls when resuming from loadstate
5260 \begin_layout Itemize
5261 Some more code cleanups
5264 \begin_layout Itemize
5265 If Lua allocator fails, call OOM_panic()
5268 \begin_layout Itemize
5269 Byte/word/dword/qword sized host memory write/read functions.
5272 \begin_layout Itemize
5273 Dump at correct framerate if dumping interlaced NTSC (height=448).
5276 \begin_layout Subsection
5280 \begin_layout Itemize
5281 Actually include the complete source code
5284 \begin_layout Itemize
5288 \begin_layout Subsection
5292 \begin_layout Itemize
5293 Document {save,start}time.{,sub}second.
5296 \begin_layout Itemize
5297 Intercept time() from bsnes core.
5300 \begin_layout Subsection
5304 \begin_layout Itemize
5305 Allow disabling time() interception (allow build on Mac OS X)
5308 \begin_layout Itemize
5309 Use SDLMain on Mac OS X (make SDL not crash)
5312 \begin_layout Itemize
5313 Disable delayed resets (just plain too buggy for now).
5316 \begin_layout Itemize
5320 \begin_layout Itemize
5321 Use 16-bit for graphics/video instead of 32-bit.
5324 \begin_layout Itemize
5325 gui.rectangle/gui.pixel
5328 \begin_layout Itemize
5332 \begin_layout Itemize
5333 New CSCD writer implementation.
5336 \begin_layout Subsection
5340 \begin_layout Itemize
5341 Fix interaction of * and +.
5344 \begin_layout Itemize
5348 \begin_layout Itemize
5349 Use gettimeofday()/usleep(), these seem portable enough.
5352 \begin_layout Itemize
5353 Move joystick axis manipulation to keymapper code.
5356 \begin_layout Itemize
5357 Changes to how read-only works.
5360 \begin_layout Itemize
5361 Refactor controller input code.
5364 \begin_layout Subsection
5368 \begin_layout Itemize
5369 Fix mouseclick scale compensation.
5372 \begin_layout Itemize
5373 Draw area boundaries correctly in SDL code.
5376 \begin_layout Itemize
5380 \begin_layout Itemize
5381 Fix CSCD output (buffer overrun and race condition).
5384 \begin_layout Subsection
5388 \begin_layout Itemize
5389 JMD dumping support.
5392 \begin_layout Itemize
5393 Allow unattended dumping to JMD.
5396 \begin_layout Itemize
5400 \begin_layout Itemize
5401 Switch back to 32-bit colors.
5404 \begin_layout Itemize
5405 Add Lua function gui.color.
5408 \begin_layout Itemize
5409 Use some new C++11 features in GCC 4.6.
5412 \begin_layout Itemize
5413 Be prepared for core frequency changes.
5416 \begin_layout Itemize
5417 Pass colors in one chunk from Lua.
5420 \begin_layout Subsection
5424 \begin_layout Itemize
5425 New lua functions gui.line(), gui.status() and gui.circle(), memory.vma_count(),
5426 memory.read_vma() and memory.find_vma().
5429 \begin_layout Itemize
5430 Numerious documentation fixups
5433 \begin_layout Itemize
5434 RTC time format changed
5437 \begin_layout Itemize
5438 Reformat flags display
5441 \begin_layout Itemize
5442 Allow lua package name to be overridden
5445 \begin_layout Itemize
5446 SDUMP (high-quality dumping).
5449 \begin_layout Itemize
5450 Split platform support to plugins.
5453 \begin_layout Itemize
5454 Make all sound plugins support basic sound commands
5457 \begin_layout Itemize
5458 Support portaudio for sound.
5461 \begin_layout Itemize
5462 Allow disable Lua/SDL searching.
5465 \begin_layout Itemize
5466 Upconvert colors when copying lcscreen to screen.
5469 \begin_layout Itemize
5470 Reorganize source tree.
5473 \begin_layout Itemize
5474 Evdev joystick support.
5477 \begin_layout Itemize
5478 Refactor more code into generic window code.
5481 \begin_layout Subsection
5485 \begin_layout Itemize
5486 Refactor message handling.
5489 \begin_layout Itemize
5493 \begin_layout Itemize
5497 \begin_layout Itemize
5498 Finish pending saves before load/quit.
5501 \begin_layout Itemize
5502 Wxwidgets graphics plugin.
5505 \begin_layout Subsection
5509 \begin_layout Itemize
5510 Get rid of win32-crap.[ch]pp.
5513 \begin_layout Itemize
5514 Move files around a lot.
5517 \begin_layout Itemize
5518 Get rid of need for host C++ compiler.
5521 \begin_layout Itemize
5525 \begin_layout Itemize
5526 Refactor inter-component communication.
5529 \begin_layout Itemize
5533 \begin_layout Itemize
5534 Fix crash on multiline aliases.
5537 \begin_layout Itemize
5538 Load/Save settings in wxwidgets gui.
5541 \begin_layout Subsection
5545 \begin_layout Itemize
5546 Patch problems in bsnes core
5549 \begin_layout Itemize
5550 SNES is little-endian, not big-endian!
5553 \begin_layout Itemize
5554 Fix memory corruption in lcscreen::load()
5557 \begin_layout Subsection
5561 \begin_layout Itemize
5562 Fix interpretting repeat counts in rrdata loading.
5565 \begin_layout Itemize
5566 New lua callback: on_frame()
5569 \begin_layout Itemize
5570 Remove calls to runtosave() that aren't supposed to be there
5573 \begin_layout Itemize
5574 Lua function: movie.read_rtc()
5577 \begin_layout Itemize
5578 Ignore src/fonts/font.cpp
5581 \begin_layout Itemize
5582 Fix more bsnes core problems
5585 \begin_layout Itemize
5586 Control bsnes random seeding
5589 \begin_layout Itemize
5593 \begin_layout Itemize
5594 Some bsnes core debugging features (state dump and state hash)
5597 \begin_layout Itemize
5598 Fix titlebar version number (no, the last version wasn't 'lsnes-0-beta21',
5599 it was 'lsnes rr0-beta21').
5602 \begin_layout Subsection
5606 \begin_layout Itemize
5607 Fix memory corruption due to macro/field mixup
5610 \begin_layout Itemize
5611 search-memory update
5614 \begin_layout Itemize
5615 Allow direct-mapped framebuffer
5618 \begin_layout Itemize
5619 SDL: Use SDL_ANYFORMAT if possible
5622 \begin_layout Itemize
5623 SDMP2SOX: 2s delay modes.
5626 \begin_layout Itemize
5630 \begin_layout Itemize
5631 Use sed -E, not sed -r.
5632 Fixes building on Mac OS X.
5635 \begin_layout Itemize
5636 Wxwidgets: Save jukebox on exit
5639 \begin_layout Itemize
5640 Fix RTC if using load-movie on savestate.
5643 \begin_layout Itemize
5644 Fix crash related to full console mode.
5647 \begin_layout Subsection
5651 \begin_layout Itemize
5652 Wxwidgets: Allow bringing application to foreground on Mac OS X.
5655 \begin_layout Itemize
5656 Wxwidgets: Allow compiling on Mac OS X.
5659 \begin_layout Itemize
5660 Use movie compare instead of movie hashing (faster save/load).
5663 \begin_layout Itemize
5667 \begin_layout Subsection
5671 \begin_layout Itemize
5672 sdmp2sox: Pad soundtrack if using -l or -L.
5675 \begin_layout Itemize
5676 sdmp2sox: Fix NTSC overscan.
5679 \begin_layout Itemize
5680 sdmp2sox: Add AR correction mode.
5683 \begin_layout Itemize
5684 call lua_close() when exiting.
5687 \begin_layout Itemize
5688 Fix zip_writer bug causing warnings from info-zip and error from advzip.
5691 \begin_layout Subsection
5695 \begin_layout Itemize
5696 Fix IPS patching code (use bsnes core IPS patcher).
5699 \begin_layout Itemize
5700 Implement BPS patching (using bsnes core IPS patcher).
5703 \begin_layout Itemize
5704 Add feature to load headered ROMs.
5707 \begin_layout Subsection
5711 \begin_layout Itemize
5712 Show command names when showing keybindings
5715 \begin_layout Subsection
5719 \begin_layout Itemize
5720 Fix pause-on-end to be actually controllable
5723 \begin_layout Itemize
5724 SDL: Poll all events in queue, not just first one (fixes slowness in command
5728 \begin_layout Itemize
5729 Wxwidgets: Fix ROM loading.
5732 \begin_layout Subsection
5736 \begin_layout Itemize
5737 Lua: Add gui.textH, gui.textV, gui.textHV
5740 \begin_layout Itemize
5741 Fix text colors on SDL on Mac OS X
5744 \begin_layout Itemize
5745 Mode 'F' for finished in readonly mode.
5748 \begin_layout Itemize
5752 \begin_layout Itemize
5753 Reliably pause after skip poll
5756 \begin_layout Itemize
5757 Split UI and core into their own threads
5760 \begin_layout Subsection
5764 \begin_layout Itemize
5765 Remove leftover dummy SRAM slot
5768 \begin_layout Itemize
5769 Fix controller numbers.
5772 \begin_layout Subsection
5776 \begin_layout Itemize
5777 Fix lsnes-dumpavi after interface change.
5780 \begin_layout Itemize
5781 Also give BSNES patches for v085.
5784 \begin_layout Itemize
5785 Pack movie data in memory.
5788 \begin_layout Subsection
5792 \begin_layout Itemize
5793 Fix framecount/length given when loading movies.
5796 \begin_layout Itemize
5797 Controller command memory leak fixes.
5800 \begin_layout Itemize
5801 Don't leak palette if freeing screen object.
5804 \begin_layout Subsection
5808 \begin_layout Itemize
5812 \begin_layout Itemize
5813 Wxwidgets: Allow controlling dumper from the menu.
5816 \begin_layout Subsection
5820 \begin_layout Itemize
5821 Rewrite parts of manual
5824 \begin_layout Itemize
5825 Lua: Make it work with Lua 5.2.
5828 \begin_layout Subsection
5832 \begin_layout Itemize
5833 Win32: Fix compile errors.
5836 \begin_layout Subsection
5840 \begin_layout Itemize
5841 Refactor controller input code.
5844 \begin_layout Itemize
5845 Fix crash when using command line on SDL / Mac OS X.
5848 \begin_layout Subsection
5852 \begin_layout Itemize
5853 Delete core/coroutine (obsolete)
5856 \begin_layout Itemize
5857 Lag input display by one frame.
5860 \begin_layout Itemize
5861 Rewind movie to beginning function.
5864 \begin_layout Itemize
5865 Fix wrong frame number reported to Lua when repainting after loadstate
5868 \begin_layout Itemize
5869 Support UI editing of jukebox
5872 \begin_layout Itemize
5873 Wxwidgets: Save settings on exit.
5876 \begin_layout Itemize
5877 Support ${project} for filenames
5880 \begin_layout Itemize
5881 SDL: Fix command history
5884 \begin_layout Subsection
5888 \begin_layout Itemize
5889 Fix some order-of-global-ctor bugs.
5892 \begin_layout Subsection
5896 \begin_layout Itemize
5897 Fix crashes when quitting on Win32.
5900 \begin_layout Subsection
5904 \begin_layout Itemize
5905 EVDEV: Queue keypresses from joystick, don't send directly
5908 \begin_layout Itemize
5909 Wxwidgets: Load-Preserve that actually works.
5912 \begin_layout Subsection
5916 \begin_layout Itemize
5917 Wxwidgets: GUI for memory search.
5920 \begin_layout Itemize
5921 Warn about using synchronous queue in UI callback.
5924 \begin_layout Subsection
5928 \begin_layout Itemize
5929 Remember last saved file for each ROM
5932 \begin_layout Itemize
5933 Support MT dumping via boost.
5936 \begin_layout Itemize
5940 \begin_layout Itemize
5944 \begin_layout Itemize
5945 Make mouse be ordinary input instead of special-casing
5948 \begin_layout Itemize
5949 SDL: Don't screw up commands with NUL codepoints.
5952 \begin_layout Subsection
5956 \begin_layout Itemize
5957 Merge status panel and main window
5960 \begin_layout Itemize
5961 True movie slot support (the rest of it)
5964 \begin_layout Itemize
5965 SDL: Fix compilation error
5968 \begin_layout Itemize
5969 Elminate cross calls in dump menu code.
5972 \begin_layout Subsection
5976 \begin_layout Itemize
5977 Cancel pending saves command
5980 \begin_layout Itemize
5981 Wxwidgets: Code refactoring
5984 \begin_layout Itemize
5985 Wxwidgets: Fix system -> reset
5988 \begin_layout Itemize
5989 Wxwidgets: Read watch expressions in the right thread
5992 \begin_layout Subsection
5996 \begin_layout Itemize
5997 Wxwidgets: Don't prompt for member when running Lua script (Lua doesn't
6001 \begin_layout Itemize
6002 Wxwidgets: 128 -> 1024 Autohold slots (in case more are needed).
6005 \begin_layout Itemize
6006 Don't append trailing '-' to prefix when saving movie.
6009 \begin_layout Itemize
6010 Fix ROM/savestate handling (don't let user mismatch ROM and savestates).
6013 \begin_layout Subsection
6017 \begin_layout Itemize
6018 Document memory watch syntax.
6021 \begin_layout Subsection
6025 \begin_layout Itemize
6026 Fix unattended dumping (lsnes-dumpavi)
6029 \begin_layout Itemize
6033 \begin_layout Itemize
6034 Use adv_dumper instead of the old interface in lsnes-dumpavi (changes syntax)
6037 \begin_layout Itemize
6038 Add option to control sample rate preturbation in AVI dumper
6041 \begin_layout Subsection
6045 \begin_layout Itemize
6046 Wxwidgets: Fix dumper submodes
6049 \begin_layout Itemize
6050 Set core controller types before loadstate
6053 \begin_layout Subsection
6057 \begin_layout Itemize
6058 Fix compiling with bsnes v086.
6061 \begin_layout Subsection
6065 \begin_layout Itemize
6066 Don't prompt before quitting
6069 \begin_layout Itemize
6070 Start unpaused, preserve pause/unpause over load.
6073 \begin_layout Itemize
6074 Try to autodetect if ROM is headered.
6077 \begin_layout Itemize
6078 Wxwidgets: Only bring up ROM patching screen if specifically requested.
6081 \begin_layout Itemize
6082 Allow configuring some hotkeys.
6085 \begin_layout Subsection
6089 \begin_layout Itemize
6090 Lots of code cleanups
6093 \begin_layout Itemize
6094 Fix JMD compression (JMD dumping was broken)
6097 \begin_layout Itemize
6098 Don't crash if Lua C function throws an exception.
6101 \begin_layout Itemize
6102 Support bitmap drawing in Lua.
6105 \begin_layout Itemize
6106 Fix bsnes v085/v086 patches.
6109 \begin_layout Itemize
6110 Improve stability on win32.
6113 \begin_layout Subsection
6117 \begin_layout Itemize
6118 Don't corrupt movie if movie length is integer multiple of frames per page.
6121 \begin_layout Subsection
6125 \begin_layout Itemize
6126 New Lua hooks: on_rewind, on_frame_emulated, on_idle, on_timer
6129 \begin_layout Itemize
6130 New Lua functions: emulator_ready(), utime(), set_idle_timeout(), set_timer_time
6131 out(), bit.extract(), bit.value(), input.geta(), input.seta() and input.controllertyp
6135 \begin_layout Itemize
6136 Wxwidgets: Fix internal focus lost (hotkeys stop working)
6139 \begin_layout Itemize
6140 Wxwidgets: Fix broken modifiers
6143 \begin_layout Itemize
6144 on_paint has parameter now.
6147 \begin_layout Itemize
6148 Optional initital fill for bitmaps
6151 \begin_layout Itemize
6152 Fix palette changing.
6155 \begin_layout Itemize
6156 Optimize rendering a bit.
6159 \begin_layout Itemize
6163 \begin_layout Subsection
6167 \begin_layout Itemize
6168 Movieinfo: Fix display of port #2 type.
6171 \begin_layout Itemize
6172 Call on_input() after loadstate.
6175 \begin_layout Subsection
6179 \begin_layout Itemize
6180 Fix writing port2 data to movie.
6183 \begin_layout Itemize
6184 Fix SRAM handling with Bsnes v087.
6187 \begin_layout Subsection
6191 \begin_layout Itemize
6192 Library loading support
6195 \begin_layout Itemize
6196 Built-in TSCC encoder
6199 \begin_layout Itemize
6200 Hi-color (256T colors) dumping.
6203 \begin_layout Itemize
6204 Dump over TCP/IP(v6)
6207 \begin_layout Itemize
6208 Hidable status panel
6211 \begin_layout Itemize
6215 \begin_layout Itemize
6216 Adjustable sound volume
6219 \begin_layout Itemize
6223 \begin_layout Itemize
6224 Allow DnD into filename boxes
6227 \begin_layout Itemize
6231 \begin_layout Itemize
6232 Portaudio: Fix speaker popping at start
6235 \begin_layout Itemize
6239 \begin_layout Itemize
6240 Speed adjustment menu
6243 \begin_layout Itemize
6244 Win32 joystick support
6247 \begin_layout Itemize
6248 Lua: gui.rainbow and gui.box
6251 \begin_layout Itemize
6252 Split key lists into classes (the key list was large!)
6255 \begin_layout Itemize
6256 More save slots support
6259 \begin_layout Itemize
6260 Wxwidgets (wxJoystick) joystick support
6263 \begin_layout Subsection
6267 \begin_layout Itemize
6268 Lots of internal joystick refactoring
6271 \begin_layout Itemize
6272 Evdev: Add mapping for BTN_TOOL_QUINTTAP
6275 \begin_layout Itemize
6276 Wxwidgets: Settings mode (open settings without ROM)
6279 \begin_layout Itemize
6280 Wxwidgets: Prompt key to use option
6283 \begin_layout Itemize
6284 Wxwidgets: Fix crash if key goes away underneath
6287 \begin_layout Itemize
6288 Wxwidgets: Fix mouse position in presence of scaling
6291 \begin_layout Itemize
6292 AVI dumper: Mode 4 (high-quality resampling to common rate using SRC)
6295 \begin_layout Itemize
6296 Wxwidgets: Redesign hotkeys dialog to avoid tree control (tree control doesn't
6297 seem to work well on WinXP)
6300 \begin_layout Itemize
6301 Start paused option.
6304 \begin_layout Subsection
6308 \begin_layout Itemize
6312 \begin_layout Itemize
6313 lsnes-dumpavi: Start Lua before starting dumper
6316 \begin_layout Itemize
6317 AVI: Fix secondary audio in mode 4.
6320 \begin_layout Subsection
6324 \begin_layout Itemize
6325 AVI: Refactor ZMBV a bit.
6328 \begin_layout Itemize
6329 Fix error reading analog values from movie file
6332 \begin_layout Subsection
6336 \begin_layout Itemize
6337 Delayed reset support
6340 \begin_layout Itemize
6341 Lua: memory.hash_region
6344 \begin_layout Subsection
6348 \begin_layout Itemize
6349 Rework the build system
6352 \begin_layout Itemize
6353 Typing input support
6356 \begin_layout Itemize
6357 Fix building with bsnes v086 and v087.
6360 \begin_layout Itemize
6361 SDL: Save settings on exit
6364 \begin_layout Itemize
6365 SDL: Command to enter command line mode with given command.
6368 \begin_layout Itemize
6369 SDL: More advanced command editing.
6372 \begin_layout Subsection
6376 \begin_layout Itemize
6378 \begin_inset Quotes eld
6381 arrow keys and enter don't work
6382 \begin_inset Quotes erd
6388 \begin_layout Itemize
6392 \begin_layout Itemize
6393 Show mode changes due to rewinding.
6396 \begin_layout Itemize
6397 Unsafe rewind support
6400 \begin_layout Itemize
6401 Fix directory transversal.
6404 \begin_layout Subsection
6408 \begin_layout Itemize
6409 AVI: Sound mode 5 (48kHz high-quality)
6412 \begin_layout Itemize
6416 \begin_layout Itemize
6417 Map the SNES bus into address space
6420 \begin_layout Itemize
6421 Fix loading memory watch files with CRLF line endings
6424 \begin_layout Subsection
6428 \begin_layout Itemize
6429 Map bsnes internal state into memory space
6432 \begin_layout Itemize
6434 \begin_inset Quotes eld
6437 click on panel wedges the emulator
6438 \begin_inset Quotes erd
6444 \begin_layout Itemize
6445 DnD movies/saves on the main window.
6448 \begin_layout Subsection
6452 \begin_layout Itemize
6453 Split core bindings into own module.
6456 \begin_layout Itemize
6457 Remember invalid settings
6460 \begin_layout Itemize
6461 Support for modified Gambatte core for GB/GBC emulation.
6464 \begin_layout Itemize
6465 Reload/swap ROM function
6468 \begin_layout Subsection
6472 \begin_layout Itemize
6473 Fix step poll function
6476 \begin_layout Subsection
6480 \begin_layout Itemize
6481 Non-insane savestate anchoring
6484 \begin_layout Subsection
6488 \begin_layout Itemize
6489 More Memory search methods
6492 \begin_layout Itemize
6493 Preserve movie if loading in RO mode.
6496 \begin_layout Itemize
6497 Fix a obscure case in timeline check
6500 \begin_layout Itemize
6501 Revamp the entiere ROM loading code
6504 \begin_layout Itemize
6508 \begin_layout Itemize
6512 \begin_layout Itemize
6513 Standalone hotkey config dialog
6516 \begin_layout Itemize
6517 Show bindings in more user-friendly format
6520 \begin_layout Subsection
6524 \begin_layout Itemize
6528 \begin_layout Itemize
6529 Fix uninitialized variables in bsnes v085
6532 \begin_layout Subsection
6536 \begin_layout Itemize
6537 Merge gambatte core into mainline (from its own branch)
6540 \begin_layout Itemize
6541 Wxwidgets: Show expected dump file formats
6544 \begin_layout Itemize
6545 Memory watch: Data typing
6548 \begin_layout Itemize
6549 lsnes internal MMIO area.
6552 \begin_layout Itemize
6553 Wxwidgets: New memory watch editor
6556 \begin_layout Itemize
6557 Hexadecimal memory watches
6560 \begin_layout Itemize
6561 Wxwidgets: Monospaced panel
6564 \begin_layout Itemize
6565 Wxwidgets: Split memory watches in panel
6568 \begin_layout Itemize
6569 Wxwidgets: Disable VMAs in memory search
6572 \begin_layout Itemize
6573 lsnes-dumpavi: Fix speed bug
6576 \begin_layout Itemize
6577 Movie subtitle support
6580 \begin_layout Itemize
6581 Fix rerecord count reporting
6584 \begin_layout Itemize
6585 Don't trash movie when loading in readonly mode.
6588 \begin_layout Subsection
6592 \begin_layout Itemize
6593 Wxwidgets: Fix crashes on closing settings dialogs on Mac OS X.
6596 \begin_layout Itemize
6597 Fix build on Mac OS X.
6600 \begin_layout Itemize
6604 \begin_layout Itemize
6605 Wxwidgets: Hidable messages window
6608 \begin_layout Itemize
6612 \begin_layout Itemize
6613 Bsnes: Support inconsistent saves
6616 \begin_layout Itemize
6617 Bsnes: Allow simulating saving every frame
6620 \begin_layout Itemize
6621 Fix desync if savestate is loaded in readonly mode in certain conditions.
6624 \begin_layout Itemize
6625 Wxwidgets: Fix save dialogs on Mac OS X.
6628 \begin_layout Itemize
6629 Wxwidgets: Fix insane status width on Win32.
6632 \begin_layout Itemize
6633 Wxwidgets: Fix autohold processing to be faster.
6636 \begin_layout Itemize
6637 Wxwidgets: Allow loading ROMs and movies from commandline.
6640 \begin_layout Subsection
6644 \begin_layout Itemize
6645 Be a bit smarter with --load
6648 \begin_layout Itemize
6649 Rewrote higher-level parts of audio system
6652 \begin_layout Itemize
6653 Tool to build commentary tracks
6656 \begin_layout Itemize
6660 \begin_layout Itemize
6661 Gambatte: Add support for SVN358
6664 \begin_layout Itemize
6665 Use builtin font when rendering status panel.
6668 \begin_layout Itemize
6669 Option to detach memory watch to its own window.
6672 \begin_layout Itemize
6673 Recent ROMs/Movies menu
6676 \begin_layout Itemize
6680 \begin_layout Itemize
6681 Useful lag counter for SNES games that autopoll
6684 \begin_layout Itemize
6685 Fix buffer overflow in gambatte sound output
6688 \begin_layout Subsection
6692 \begin_layout Itemize
6693 Don't blow up on wxGTK if the window is hidden somehow
6696 \begin_layout Itemize
6697 Support simultaneous drop of ROM and movie.
6700 \begin_layout Itemize
6701 Gambatte: Don't save spurious SRAMs.
6704 \begin_layout Itemize
6705 Make SGB ROMs actually usable.
6708 \begin_layout Itemize
6709 Fix so that saved movies appear in recent movies.
6712 \begin_layout Itemize
6713 Don't open multiple commentary editors at once.
6716 \begin_layout Subsection
6720 \begin_layout Itemize
6721 Lua: memory.readregion/memory.writeregion
6724 \begin_layout Itemize
6725 Lua: memory.map{,s}{byte,word,dword,qword}
6728 \begin_layout Itemize
6729 Lua: memory.map_structure
6732 \begin_layout Itemize
6733 Lua: Fix bus_address for gambatte
6736 \begin_layout Itemize
6737 Fix features dependent of bsnes debugger
6740 \begin_layout Itemize
6741 Cleanup bsnes debugger logic
6744 \begin_layout Itemize
6745 Fix resets in presence of save every frame
6748 \begin_layout Subsection
6752 \begin_layout Itemize
6753 Lua: input.lcid_to_pcid
6756 \begin_layout Itemize
6757 Fix off-by-one bug with slot hashes
6760 \begin_layout Itemize
6761 Fix crashes on certain memory watch expressions
6764 \begin_layout Itemize
6765 Lua: memory.read_expr
6768 \begin_layout Itemize
6769 Lua: Fix memory.read_expr on nil argument
6772 \begin_layout Itemize
6773 Fix the code to compile on G++ 4.7
6776 \begin_layout Itemize
6777 Change button_id to be a function pointer field, not a virtual method
6780 \begin_layout Itemize
6781 Add bsnes patches to fix libsnes to compile on GCC 4.7
6784 \begin_layout Itemize
6785 Gambatte: Always use legacy lag counting
6788 \begin_layout Itemize
6789 Memory commands: Memory addresses are up to 16 hex digits, not up to 8
6792 \begin_layout Itemize
6793 Fix analog controllers
6796 \begin_layout Itemize
6800 \begin_layout Itemize
6801 Fix button symbols in input display
6804 \begin_layout Itemize
6805 Compensate for nuts bsnes superscope/justifier handling
6808 \begin_layout Itemize
6809 Lua: Fix bit.extract boolean handling
6812 \begin_layout Subsection
6816 \begin_layout Itemize
6817 Split emulation cores more from the rest
6820 \begin_layout Itemize
6821 Support having multiple emulation cores compiled at once
6824 \begin_layout Itemize
6825 Support arbitrary number of ports (well, up to 31 anyway).
6828 \begin_layout Itemize
6829 SNES debugger support
6832 \begin_layout Itemize
6833 Support 16-button controllers
6836 \begin_layout Itemize
6837 Remove old SDL front end
6840 \begin_layout Itemize
6841 Data-driven controller buttons
6844 \begin_layout Itemize
6845 Generate the port code from defines
6848 \begin_layout Subsection
6852 \begin_layout Itemize
6853 Update libgambatte to SVN364
6856 \begin_layout Itemize
6857 Get rid of partial linking (building with MXE works)
6860 \begin_layout Itemize
6861 Load XML even without gamepack files
6864 \begin_layout Itemize
6865 Support screen rotate & flip
6868 \begin_layout Itemize
6869 Fix bug when changing controller key to another subkey of the same key
6872 \begin_layout Subsection
6876 \begin_layout Itemize
6877 Stop at movie end: Don't off-by-one
6880 \begin_layout Itemize
6881 Fix crash closing lsnes with voice playback active.
6884 \begin_layout Itemize
6885 Import/Export OggOpus for commentary tracks
6888 \begin_layout Itemize
6889 16-button controllers.
6892 \begin_layout Itemize
6893 Don't show nonexistent controllers in input display
6896 \begin_layout Itemize
6897 Set voice record/playback volume from UI
6900 \begin_layout Itemize
6901 Patches for gambatte SVN364.
6904 \begin_layout Itemize
6905 Load markup (if exists) even without gamepack file.
6908 \begin_layout Itemize
6909 Screen rotation & flipping
6912 \begin_layout Itemize
6913 Lua: Some new bit functions
6916 \begin_layout Itemize
6917 Auto-refresh voice streams on change.
6920 \begin_layout Itemize
6921 Auto-refresh subtitles on change & new subtitle editor.
6924 \begin_layout Itemize
6925 Fix music volume adjustment.
6928 \begin_layout Subsection
6932 \begin_layout Itemize
6933 Use system threads instead of platform threads
6936 \begin_layout Itemize
6937 Cleanup build by allowing dummy and real drivers to link together.
6940 \begin_layout Itemize
6941 Split duplex support
6944 \begin_layout Subsection
6948 \begin_layout Itemize
6949 Wxwidgets: Fix memory watch rendering.
6952 \begin_layout Itemize
6953 Wxwidgets: Allow setting voice stream gain.
6956 \begin_layout Itemize
6957 Wxwidgets: VU meters and volume adjustment.
6960 \begin_layout Itemize
6961 Lua: Custom fonts support.
6964 \begin_layout Itemize
6965 Lua: Fix methods stopping working when resetting Lua.
6968 \begin_layout Itemize
6969 Fix loading standard-format movies in preserve (readonly) mode.
6972 \begin_layout Subsection
6976 \begin_layout Itemize
6977 Primitive movie editor
6980 \begin_layout Itemize
6981 Fix VU meter with no sound device.
6984 \begin_layout Itemize
6985 Fix various undefined return values.
6988 \begin_layout Itemize
6989 Show rates in VU meter window.
6992 \begin_layout Subsection
6996 \begin_layout Itemize
6997 Lua: Render queues as objects
7000 \begin_layout Itemize
7001 Bsnes: support hard resets
7004 \begin_layout Itemize
7005 Dedicated sound devices dialog
7008 \begin_layout Itemize
7009 Change the default AVI sound mode to 2 or 5.
7012 \begin_layout Itemize
7013 Fix totally borked movie saving.
7016 \begin_layout Itemize
7017 Portaudio: Use split duplex with different devices.
7020 \begin_layout Itemize
7021 Fix controls with gambatte core.
7024 \begin_layout Itemize
7025 Modify save slot set handling.
7028 \begin_layout Itemize
7029 lsnes-dumpavi: --firmware-path.
7032 \begin_layout Itemize
7033 Fix lots of compiler warnings.
7036 \begin_layout Subsection
7040 \begin_layout Itemize
7041 Commentary tool: Set nominal bit rate and limit max bit rate.
7044 \begin_layout Itemize
7045 Lua: Unconditionally reload host memory on loadstate
7048 \begin_layout Itemize
7049 Lua: Query bindings, manipulate aliases, create inverse bindings
7052 \begin_layout Itemize
7053 Lua: Fix crashes with resetting VM while some types of paint requests are
7057 \begin_layout Itemize
7058 Lua: gui.text: Clip the text properly instead of corrupting memory in some
7062 \begin_layout Itemize
7063 Save screenshot header reliably
7066 \begin_layout Itemize
7067 Lua: Backport input.get2 and input.set2
7070 \begin_layout Itemize
7071 Lua: New controller info functions.
7074 \begin_layout Itemize
7075 Movie editor: Fix reset delay counters to be the right way around.
7078 \begin_layout Itemize
7082 \begin_layout Itemize
7083 Lua: on_button and input.veto_button.
7086 \begin_layout Subsection
7090 \begin_layout Itemize
7091 Revert memory leak fix breaking input
7094 \begin_layout Itemize
7095 Refactor Opus handling
7098 \begin_layout Itemize
7099 Restrict member picking only to .zip files
7102 \begin_layout Itemize
7103 Fix reading of host-endian VMAs.
7106 \begin_layout Itemize
7107 Fix rlow and rhigh to be the right way around.
7110 \begin_layout Itemize
7111 Lua: Don't wedge VM if callback fails with an exception
7114 \begin_layout Itemize
7115 Refactor Ogg handling.