+
+ 6. Advanced Features
+ + +
+ 
+
+ 
+
+ 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Advanced Features
+3. Effective usage of Markers.
+ +1. How to share projects.
+A Taseditor project is saved to disk as an .fm3 file. All essential aspects of the work process are saved into this file, making it possible to restore the postponed work in its exact state. The size of such "instant snapshot" may be pretty huge (depending on the Greenzone size, it may take hundreds of megabytes).
+When you want to publish your project in the Internet (for example, as a TASVideos submission), it's better to share only the most important information, but not the whole snapshot of your working process. To do that, choose File -> Save Compact in Taseditor's main menu. The "Save Compact" window will appear, prompting you to select which aspects you want to save to the new FM3 file.
+
Binary format of Input – save movie Input in binary form. This option is related to fm2 format, which is the base of the fm3 format. If you uncheck it, Input will be saved to the fm3 file in text format, which will increase file size but leave the possibility to edit it in any text editor. However, Taseditor is much better suited for editing movies, so it's recommended to keep that checkbox set, and avoid changing FM3 projects outside Taseditor. Anyway, in non-compact fm3 projects (saved regular way) Input is always stored in binary.
+Markers – save Markers to the file. The movie Input is always saved to fm3 file, because without it emulator won't be able to open fm3 files. But without Markers the movie replay is still possible, so you can uncheck the checkbox if you don't want to share them. Although this way your fm3 won't differ much from an fm2 movie, so it's recommended to leave that checkbox checked, to share all current Markers and their Notes in the compact project. The file size will increase insignificantly.
+Bookmarks – save all Bookmarks and their branches data to the file. It's recommended to leave this option checked. The file size will increase insignificantly.
+Greenzone – save Greenzone to the file, including all savestates and the Lag Log. The file size will increase dramatically! Greenzone is the main factor causing huge project file size. It's recommended to keep this option unchecked. If during the compact saving the Playback cursor is at the very first frame of the movie, there will be no single Greenzone savestate in the fm3 project. But if the cursor was left at some frame in the middle of the movie, the compact fm3 will contain one Greenzone savestate, allowing to restore the emulator state on the Playback cursor frame when you open the project. Since one savestate uses very little disk space, the file is still compact.
+History – save History Log to the file. The file size will increase by several megabytes. Usually there's no need to publish the data. So it's recommended to uncheck this option. When you open an fm3 project with no History Log, Taseditor creates a new History automatically.
+Piano Roll – save current position of vertical scrolling of the Piano Roll, in order to see the exact segment of the movie after loading the compact fm3 file. The file size will increase insignificantly, so you may keep that option checked.
+Selection – save all Selection data to the file. Both current Selection and whole Selection History is saved. The file size will increase insignificantly, but usually there's no need to publish the data. So it's recommended to uncheck this option.
+Using compact saving you can get an fm3 project being less than 500KB in size, while still sharing all essential data the recipient may need. For example, if you are working in co-authorship with another TASer(s), you will need to share not only Input, but also Markers and Bookmarks. As for the Greenzone, the recipient can recreate it by replaying the project movie in Taseditor.
+On compact saving, your project name receives the "-compact" suffix. Compact saving doesn't replace normal project saving, so if you have any unsaved changes in the project, the asterisk in the window caption will not disappear after Save Compact.
+
Besides saving a compact fm3 you can also export movie data to fm2 format, accepted at TASVideos before Taseditor even existed. But in such files you will share only Input. To do that, choose File -> Export to FM2 in Taseditor's main menu. The "Export to FM2" window will appear, prompting you to choose target movie type (1P, 2P, Fourscore).
+Since FM2 format also supports text subtitles, you can use existing Marker Notes as a source for generating movie subtitles. For that, enable the "Convert Marker Notes to Movie Subtitles" checkbox. Then while watching the fm2 file the viewers will see text messages appearing when passing certain frames (the frames where your project had Markers at). If necessary, you can then convert those fm2 subtitles into the commonly used .srt format to post the TAS on Youtube. To do that, right-click the FCEUX window while replaying the subtitled movie and choose "Dump Subtitles to SRT file" command.
+FM2 files can be opened in Taseditor similarly to loading fm3 projects. In the "Open TAS Editor Project" window (File -> Open) switch to the filter "All Files (*.*)" and then choose your fm2 movie file. Taseditor will bring the message box saying that this is not a project file, and will ask confirmation. After you click "Yes" it will create new project using Input and settings from the fm2 file.
+Also, you can import Input from any fm2 or fm3 file using File -> Import Input. This time no new project will be created, but Input of current project will be replaced with Input from the file. This operation is very similar to pasting Input from the Clipboard, it is registered in History Log and can be undone by Ctrl + Z.
+2. Patterns usage.
+When editing Input, TASer actually creates a unique sequence of presses and releases for every button of joypad. But, despite the uniqueness, this large sequence still contains many typical segments, which are are short sequences of presses and releases that repeat many times in succession, or appear many times in different places of the movie.
+To speed up the work, you can remember the most typical or frequent sequences as patterns, to be able to put them with a couple of clicks, not drawing every single buttonpress manually each time.
+Patterns are useful in several cases:
+Some of the most obvious patterns are already added by author. To add your own pattern you need to edit the taseditor_patterns.txt file in any text editor (like Notepad), this file is stored in /tools subfolder of FCEUX main folder. Every second line in this file constitutes an encoded sequence of button states. The code is straightforward: "button pressed" is encoded by 1, "button released" – by 0.
+Every pattern is looped, which means, when a long sequence of Input is created using a short pattern, the pattern is repeated the necessary amount of times to fill the whole given interval.
+
After adding or editing the patterns file, restart Taseditor to reread the file changes. The list of all available patterns is always in the upper right corner of the TAS Editor window. To change the current pattern, enter that menu and click the needed pattern name. For easy orientation in patterns it's recommended to call each pattern by a distinct name that reflects its in-game meaning.
+To apply current pattern, Taseditor needs to know the beginning and the end of the interval where the chosen button is going to be pressed and released according to the rule. There are 3 different ways to apply a pattern:
+Example 1. Point and click the start frame (click in any Piano Roll column except the icons column), thus selecting that frame. Then hold the Alt key and left-click the end frame in the column of the button you are editing. In the interval between those two frames you will get the needed sequence of the chosen button presses. This method is rather handy when the start frame is already selected by previous clicks in Piano Roll, and you only need to to hold down Alt and click the end frame.
+Example 2. Left-click the start frame in the column of the button you are editing, and hold the mouse button to start drawing. Hold Alt and move the mouse cursor up or down. This way you will be drawing the pattern sequence of buttonpresses.
+Example 3. Select a range of frames, then hold Alt and left-click on the edited button symbol in the Piano Roll Header. The pattern will be applied to the selected area.
+When using traditional method of TASing you are also able to apply patterns to recorded sequences, although in a less convenient manner. To do that you should set the "Use pattern" checkbox on Recorder panel. Before that you may want to record the buttons you don't need to alternate (record them without using patterns), and then record the needed button(s) with pattern, using the "Superimpose" function for the segment.
+For example, you need to record a burst of fire while jumping over the pit. At first, record that jump without shooting, then return the Playback cursor to the beginning of the segment (by jumping to the Bookmark left here), check "Superimpose" and "Use pattern", hold the B button and unpause the emulation. You'll see how the shooting Input superimposes over jump Input.
+Before Taseditor there was the "Autofire" concept similar to patterns. But due to inconveniences of the Recording method that feature was rarely used, because when you are typing Input it's usually easier to press and release the needed buttons manually. So if you stick to traditional method of TASing, you won't likely use patterns. But in the non-linear or semi-automatic TASing, patterns are drawn as quickly as regular buttonpresses, so that's where they can really speed up the work.
+Patterns are used when creating sequences for a single button. But when you want to use a typical macro involving several buttons, use Copy/Paste.
+3. Effective usage of Markers.
+Markers exist to simplify complicated situations by structurizing the problem. When the game requires you to perform (or think over) several complex actions, you should break the large segment into separate intervals, in order to understand clearly where one action stops and another one starts. Even if the initial subdividing appears to be wrong, it still helps you to get thoughts in order.
+Obviously, you are not expected to set Markers on commonplace segments, most of which aren't even polished (e.g. where it's enough to hold R to win). But key moments and memorable situations of the movie should be marked and commented with Notes. It will help you to keep the whole picture of the project in mind and navigate the movie by text.
+No need to write works of literature inside the Notes. You may just confine yourself with simple label words, numbers, tags. Invent the words on the fly, but try to keep systematic approach. As in, if at the beginning of the first level (on the transition screen) you've set a Marker with the Note "level 1 start", you should also write "level 2 start" at the beginning of the second level, and not "act II begin" or something. During the creation of TAS you naturally form a unique glossary in your mind using various terms that are topical for that specific game. And the more systematic approach you apply to writing the Notes, the easier it will be to describe another (similar) segment and understand its task. The easier it'll be to find similar Input segments, recalling only their vague in-game appearance.
+The tasks you meet in video games are often repeatable. Details and environment may be different, but player actions remain more or less the same. In some cases you can just copy the Input (solution of the similar task) from the previous level, and it will successfully sync with the new in-game situation (probably after a little adjustment). Though, after the copy/paste it's recommended to diversify the Input to prevent the TAS viewers from noticing the repetition and getting bored.
+For example, at the beginning of many levels in Super Mario Bros you need to use the same button sequence to accelerate to maximum speed optimally. Let's imagine, you are honestly commenting Input during TASing. Then in World 1-1 in the acceleration section you probably left a Note with words like "acceleration" or similar. Now, when you start creating Input for a segment with that task again, in a new level you put a Marker at the beginning of the segment and write a Note, describing your current task. Obviously enough, you are going to use the word "acceleration" there as well, because you need to accelerate.
+
And that's where you can use Taseditor's function of automatic searching for similar Notes. Leave the Playback cursor inside the current segment and press the "Similar" button at the bottom of the Toolbox. The Selection cursor will instantly jump to the Marker that contains the most resembling Note, in Taseditor's opinion. Most likely, it will be the Marker left at the beginning of the acceleration segment in the World 1-1. Therefore you can instantly select all Input in that segment by pressing Ctrl + A, then copy the Input to the Clipboard (Ctrl + C), return to the current segment (press Shift twice) and paste from the Clipboard (Ctrl + V).
+If the first search result doesn't bring you to the intended segment, you can press the "More" button to try next result of the search. Usually the right segment is among the first offered finds, granted that you marked the segment with a sensible Note.
+Interesting fact: while writing the Note for the second appearance of the acceleration segment, you use the word "acceleration" without an intent to correlate to previous cases, but only according to the in-game situation. So you are not expected to actually remember the text of old Notes. The right words will come to your mind in the right time.
+This way, right during the TASing process you form a library of useful Input combinations, not unlike the pattern list described above, except that you don't have to purposely prepare the button sequences – they appear natural way during the segments shaping and optimization, and they are stored inside the movie, not in an external file. And when you improve a combination for some segment (e.g. find a faster way to accelerate), you can easily find and fix all related segments with similar button sequence. Also, here you don't have to remember the exact description or the name of the needed sequence, because, if you use systematic approach to describe tasks, the words will partially match (and a perfect match is not required, since the searching algorithm is rather smart).
+The auto-search is also useful when you need to jump between two (or more) related segments, located far from each other in the movie. Scrolling the Piano Roll with the mouse wheel or jumping through dozens of Markers from one segment to another is not as handy as clicking the "Similar" or "More" button. To let the algorithm instantly find the twin segment (or the source segment and the destination segment), consider using some unique word in their Notes, one that isn't used in other places of the movie.
+For example, in the "Megaman" game each robot master must be beaten twice (second time it's in the end of the game). It's logical to suppose that both battles will be entitled by Marker Notes containing the name of the robot and the word "boss" or "fight", or something like that. As a result, when the Playback cursor is in one of those 2 places, pressing the "Similar" button will get you to another one.
+In this example the proper words for the Notes text are no-brainer, yet they are unique enough not to repeat in other places (at least not in that combination), so the auto-search will work perfectly. In a different case you may have to invent a unique label, but usually the first description you think of is enough.
+
You can also use standard search for Note text. For example, it's common to leave a Note beginning with the "TODO" word at some places where you are not sure the best solution is found (the segment Input is optimal). So, when you have mood to make fixes, you could skim through all Markers with that tag by bringing the "Find Note" window (Ctrl + F) and typing the word "TODO" to search for.
+If you don't like all these big ideas with Markers, you can TAS without them. After all, many games provide rather simple tasks for a TASer, they don't require a highly organized approach to the solving process. If the problem can be solved on impulse, don't spend time on preparation and fortification. Markers provide advantages only in long-term goals.
+So, just like in programming, in most cases you can successfully write the so-called "dirty code" (here it would be a project without Markers and Notes) that is fast to create, but hard to maintain and extend. Or you can make a lovingly formatted project which is nice to watch and modify. Since TASers have to modify their movies very often (in order to beat previous records), the today's time costs for the project formatting are likely to be repaid by the fact that the looks of the project motivate to continue the work on it.
+4. Lua usage.
+With the Lua language you can write scripts that can be executed by FCEUX along with game emulation. Writing scripts requires minimal programming skill, while the range of possibilities is pretty huge. You can create your own TAS tools, modify the game at the time of execution, have access to images and sound on the fly, send data via network or record it to disk, etc. And you can make custom extensions for TAS Editor.
+To master the Lua language completely you would need to read its documentation and gain actual experience, but for making simple scripts it should be enough to read this Manual and the Lua chapter in FCEUX docs. At first, try to run scripts created for FCEUX by various people. They are stored in the /luaScripts subfolder. Each script is a text file with .lua extension, such file may be created and modified in any text editor. Before running scripts you need to open some game ROM in FCEUX. To run a script, open the Lua console (File -> Lua -> New Lua Script Window), in this window press the "Browse" button and load the script file, then press "Run". If emulator is paused, either unpause it or advance a frame to activate the script. As for the Lua console, the window may be hidden or minimized.
+Program code in Lua scripts for FCEUX usually consists of 2 parts: the first part is executed once the script is activated, another part runs on certain emulation events, such as the end of a frame emulation, loading a savestate and so on.
+The first part, which runs on script activation, is usually executed only once (unless you made an infinite loop in it). The code is executed line by line, from top to down. Usually the task of that part is to initialize global variables and register functions to be launched by FCEUX when certain events occur.
+In most of cases the main code of the script is contained in the single function that is automatically executed at the end of every frame. For example, this is how Mario hitbox drawing code for SMB may look:
+marioWidth = 16 +marioHeight = 32 +function everyframe() +marioX = memory.readbyte(0x3AD) +marioY = memory.readbyte(0xCE) +gui.drawbox(marioX, marioY, marioX + marioWidth, marioY + marioHeight) +end +emu.registerafter(everyframe) + |
+
When activating this script, FCEUX creates and initializes two variables ("marioWidth" and "marioHeight"), then registers the function called everyframe() to the "frame end" event (registerafter). After that the text ends and the script finishes its execution, but the registered function remains in emulator memory, and if you unpause it or press Frame Advance, after every frame it will run the code stored within the everyframe() function. That code consists of 3 lines. The first two create variables for the hitbox position and initialize them with current values from RAM of the emulated console. The third line draws graphics over the game picture output.
+Actual RAM addresses can be found in public resources (like http://tasvideos.org/GameResources/NES/SuperMarioBros.html) or found on your own using the Cheat Search tool or the RAM Search tool built in FCEUX. In this case we know that Mario's X position is stored in memory address 0x3AD, and his Y position is in 0xCE. So, the script just takes their current values and draws the rectangle in the corresponding screen position. Sometimes there's need to recalculate the values to translate the in-game world coordinates into on-screen coordinates, but in this case they match.
+The standard functions readbyte(), drawbox() and other useful functions are described in the FCEUX documentation. It also describes how to use mathematical expressions and make loops and conditions.
+The standard functions available only when Taseditor is engaged are listed in the Reference. Using all this knowledge you can not only draw and write messages over the emulator screen, but also control Playback and Selection, and most importantly, modify the movie Input and Markers.
+For example, this code copies one joypad Input to the second one's place:
+function doCopy() +selection_table = taseditor.getselection() +if (selection_table ~= nil) then +for i = 1, #selection_table do +selected_frame = selection_table[i] +joypad1data = taseditor.getinput(selected_frame, 1) +taseditor.submitinputchange(selected_frame, 2, joypad1data) +end +taseditor.applyinputchanges("Copy 1P->2P") +end +end +taseditor.registermanual(doCopy, "Copy 1P to 2P") + |
+
When launching this script, FCEUX registers the doCopy() function to the event of pressing the "Run function" button (registermanual). Now any click on the button will run the code of that function, consisting of 9 lines. At first, the function gets information about Selection from Taseditor, and if it's not blank (i.e. at least one frame is selected in the Piano Roll) it runs the FOR loop, going through all the selected frames from the first to the last. For each selected frame the function requests the Input of the first player from Taseditor (and stores this data to the "joypad1data" variable), then it submits the claim to change the second player Input for that frame. All these submissions are accumulated in Taseditor memory until the FOR loop ends, after that they all are applied by calling the applyinputchanges(). As a result, the second joypad in the selected range of frames contains the same Input as the first joypad.
+
This simple script is already a useful mini-tool that may be needed when making a TAS for 2 or more players. Launch it, and while TASing you will be able to select a range of frames in the Piano Roll and click the "Copy 1P to 2P" button (or press the "Run Manual Lua function" hotkey) to synchronize both players. Every time the script work results in an Input change, the Greenzone is automatically truncated, and a new item is added to the History Log, allowing you to undo the changes done by the script. This way you've got a feature completely integrated into Taseditor, and you've programmed the behavior of the feature yourself.
+Even though you can successfully TAS without Lua knowledge, its support can save you much time and even hint on a less obvious solutions during the Input optimization (or more exactly, during the game Output analysis).
+Videogames often hide important details of the situation, and TASer has to watch memory state directly in order to know for sure what's going on and to precisely perceive the optimality factors while polishing segments.
+For example, many games don't show boss HP on screen. So, to know exactly the damage you inflict, you need to watch the numeric value of the corresponding RAM address in the Memory Watch window. And when there is a plenty of hidden factors (for example, several timers of invulnerability and boss attack, and some special counters of the player character), TASer needs to watch and analyze many memory addresses as they change according to different rules. In this case an on-screen visualization of some data would be huge helper. For example, boss HP can be displayed as a bar or a number above his head, and a red color can indicate the damage frames or other events. As a result, your mind is relieved by moving from deciphering an abstract data format to the format that instantly delivers the main idea (e.g. "the boss was damaged", "good/bad").
+So it's recommended to learn Lua at least to the level of being able to sensibly modify others' scripts. For the long time FCEUX existed, people wrote and published a lot of scripts serving for various purposes, and you'll probably only need to change some RAM addresses to adjust a script to your game. Oftentimes it also makes sense to ask for help at TASVideos forums.
+The Taseditor guide is over. If you were reading carefully, you should now know everything necessary to make a TAS up to the high standards of TASVideos. The only thing left is to gain an experience in real work, master some actions to automatism in order to feel no trace of routine and have fun from the process of armed playthrough and investigation of games.
+Created with the Personal Edition of HelpNDoc: Single source CHM, PDF, DOC and HTML Help creation
+
+
+
+
+ Beginner's Guide
+This part of the documentation is presented in the form of a textbook on TASing.
+It explains the practice of using Taseditor and describes the mechanism of conventional TASing methods.
+The course will be useful both to people who wish to learn TASing and to already experienced TASers who are open to new trends and wish to improve their knowledge.
+General overview of TAS Editor's goals and features
+Learning the fundamentals of the program usage
+ + +The author's vision of the competent working process
+ + +Dissection of the Input improvement methods
+ + +Detailed review of all settings
+Describing the additional possibilities
+Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator
+
+
+
+
+
+
+ Controls
+Taseditor is controlled by mouse and keyboard.
+Every operation can be done in several alternative ways (via menu, hotkey or GUI element).
+Any action can be done using mouse, but some are faster to do with keyboard. The Manual assumes that one hand of user is holding the mouse and other hand is placed on a side of the keyboard, occasionally holding Shift/Ctrl/Alt or pressing a key combination.
+Some actions (e.g. switching "Follow cursor") can be done by mouse only.
+Mouse controls
+Pointing with mouse
+A. Displaying Bookmarks screenshots and descriptions
+Hover mouse cursor over the right half of Bookmarks List to see the game screenshot of the bookmarked frame in the movie branch you're pointing at. Optionally there can be a description of the branch under the screenshot.
+B. Displaying information of the Bookmark
+Hover mouse cursor over an icon of any Bookmark in the Branches Tree to see the information about the Bookmark (real time of creation, bookmarked frame, full timeline, screenshot and description). When you point at a Bookmark that doesn't belong to the timeline of current movie branch, mouse cursor changes to arrow with question mark.
+C. Illuminating button symbols in the Piano Roll Header
+Hover mouse cursor over a button symbol in the Piano Roll Header to see if you can change the movie by clicking this symbol. When some rows of Piano Roll are selected, symbols in the Header will illuminate on mouse hover.
+Left mouse button
+The main button.
+A. Standard Windows actions
+Most of GUI elements of TAS Editor window are controlled the same way as in other Windows applications.
+B. Moving Playback cursor
+Click on any row in the "Icons" column of Piano Roll to send Playback cursor to the frame pointed. If you hold the left mouse button, you can drag the Playback cursor up and down. This way you can even move Playback cursor into frames outside currently visible area of the movie. Just try dragging the cursor below or above Piano Roll – the farther you lead the mouse, the faster will be scrolling and Playback rewinding.
+C. Selecting rows in Piano Roll
+Click on a frame number in the "Frame#" column of Piano Roll to select this frame and remove selection from other frames (if there was any selection before). If you hold the left mouse button, you can stretch the selection by moving mouse up or down.
+If you need to append new selection to an already existing selection, hold Ctrl while clicking on a frame number. This way you can select several non-overlapping segments. Also this way you can remove some parts of existing Selection, just hold Ctrl while clicking on a selected frame.
+If you hold Shift instead of Ctrl, the click will select a region of frames starting from the beginning of previous Selection.
+If you hold Alt, the click will select rows using current Pattern.
+D. Setting/unsetting Input in Piano Roll
+Point mouse cursor at needed cell of Input (find crossing point of needed frame row and needed button column) and press left mouse button. The Input in this cell changes at the moment you press the button. Empty cell will become occupied and vice versa.
+The row containing this cell will become selected, and other Piano Roll rows will become unselected. This feature ensures that Selection cursor always appears in the context of Input editing.
+If you hold the left mouse button, you can draw or erase Input in other cells of Piano Roll by moving mouse cursor over them. Drawing starts when you click on an empty cell, erasing starts by clicking on an occupied cell.
+If you hold Shift while clicking on a cell, the Input change will apply to all frames from Selection cursor to the row containing the cell. Selection cursor won't move this time.
+If you hold Alt instead of Shift. the click will set Input (from Selection cursor to the row containing the cell) as on current Pattern. Selection cursor won't move this time.
+E. Setting/unsetting Input using the Header of Piano Roll
+Click on a button symbol in the Piano Roll Header to change the Input of this button in selected frames. If no frames are selected, nothing will happen. If in some of the selected frames the button in not set, the click will set the button in all selected frames. If the button is set in all selected frames, the click will unset the button in all selected frames.
+If you hold Alt while clicking on a button symbol, the click will the button Input in selected frames as on current Pattern.
+If you click on the "Frame#" label, the click will apply to Markers instead of Input.
+F. Creating and moving Markers
+Double-click on a frame number in Piano Roll to set Marker to this frame. If you hold the left mouse button, you can drag the Marker freely. Release the button to leave the Marker at the frame number it was held over. This way you can move Markers from place to place. If you release the Marker over Input columns, the dragging will be cancelled, and the Marker will return to the frame it was picked from. If you release the Marker over another Marker, those two Markers will switch places.
+If you release the Marker outside Piano Roll, this Marker will be dumped. Thus, to remove a Marker, double-click on it and drag it somewhere outside TAS Editor window.
+G. Entering/exiting Note editing mode
+Click on the upper or the lower edit field to start editing Note text displayed in this field at the moment.
+To finish editing (and save changes) click on anything outside the edit field.
+H. Controlling the Bookmarks List
+Click on a frame number in Bookmarks List (on the left side of the list) to send Playback cursor to the frame.
+Click on a time indicator in Bookmarks List (on the right side of the list) to restore movie state saved into the Bookmark and send Playback cursor to the bookmarked frame.
+Those operations fire on the left button release.
+I. Controlling the Branches Tree
+Click on icon of a Bookmark to send Playback cursor to the bookmarked frame.
+Double-click on icon of a Bookmark to restore movie state saved into the Bookmark and send Playback cursor to the bookmarked frame.
+Those operations fire on the left button press.
+J. Controlling the History Log
+Click on any row of the History Log to restore movie state to the point of time when the Log record was created.
+Right mouse button
+A. Moving Playback cursor with mouse wheel
+Hold right button and roll the mouse wheel up or down to move Playback cursor respectively.
+Mouse cursor can be anywhere over the TAS Editor window or emulator main window.
+B. Scrolling the Piano Roll
+Place mouse cursor over the Piano Roll, hold right button and move mouse cursor anywhere outside the Piano Roll to scroll visible area to the side. This is especially useful for horizontal scrolling, because using scrollbar would be too slow.
+C. Setting a Bookmark
+Right-click on a row of the Bookmarks List to set the Bookmark to the frame where Playback cursor currently is.
+Alternatively, right-click on icon of a Bookmark in the Branches Tree to set the Bookmark to the frame where Playback cursor currently is.
+Those operations fire on the right button release.
+D. Context menu
+Right-click on a frame number of any selected frame in the Piano Roll to bring the context menu containing the following items:
+Scrollbars and Note editing fields also have their own context menus.
+Middle mouse button
+The middle mouse button serves one major role – to pause and unpause emulator, no matter where mouse cursor is The button fires on button press.
+When emulator is paused, pressing the middle mouse button will unpause it (same as pressing Pause hotkey). Moreover, if there is the green arrow outside Greenzone in Piano Roll, the middle-click will launch seeking to the frame with the green arrow (same as pressing Restore Playback hotkey).
+If you hold Shift while mid-clicking, this will launch seeking to the nearest Marker.
+If you hold Ctrl while mid-clicking, this will either launch seeking to Selection cursor (if it's below Playback cursor) or re-watch the movie segment starting from Selection cursor (if it's above Playback cursor).
+When emulator is unpaused, pressing the middle mouse button will pause it (same as pressing Pause hotkey).
+Usually the middle mouse button is the mouse wheel.
+Mouse wheel
+The wheel can be rolled up and down with different speed. When you need precision, roll the wheel slowly. When you need speed, roll the wheel quickly.
+A. Scrolling the Piano Roll or History Log
+When mouse cursor is over the History Log, roll the mouse wheel to scroll visible area of the History Log.
+When mouse cursor is anywhere else, roll the mouse wheel to scroll visible area of the Piano Roll.
+B. Moving Playback cursor
+Hold right mouse button and roll the mouse wheel up or down to move Playback cursor respectively.
+If you want to always see the Playback cursor position in Piano Roll, check the "Follow cursor" checkbox in the Playback section of TAS Editor window.
+C. Jumping on Markers
+This is similar to pressing << and >> buttons or using Ctrl/Shift + Page Up/Page Down hotkeys.
+Hold the Shift key and roll the wheel to make jumps with Playback cursor. The Piano Roll will follow it if the "Follow cursor" checkbox is checked.
+Hold the Ctrl key and roll the wheel to make jumps with Selection cursor. The Piano Roll will follow it automatically.
+D. Crossing gaps
+Point mouse cursor to any member of a long column of buttonpresses or to an empty cell among other empty cells in its neighborhood, then hold the Alt key and roll the wheel up or down to scroll the Piano Roll in such a manner that mouse cursor immediately appears before the upper end or after the lower end of the column / emptiness.
+This allows you to quickly navigate among long sequences of Input.
+The same approach can be used to find previous/next Markers (when mouse cursor is over the column with frame numbers) and Bookmarks (when it's over the icons column).
+Keyboard controls
+
Modifiers (Shift, Ctrl, Alt)
+When you hold one of these keys the functions of left mouse button and mouse wheel change.
+If you tap the Shift key twice in a row, the Piano Roll will automatically scroll to Playback cursor.
+If you tap the Ctrl key twice in a row, the Piano Roll will automatically scroll to Selection cursor.
+When you're drawing/erasing Input, hold Shift key to remove the "single-column" confinement.
+Accelerator hotkeys
+These are key combinations typical for many Windows applications. You cannot redefine those combinations. In this documentation they are highlighted with red color.
+
Ctrl + S = save project to disk
+Ctrl + Z = undo (step back in History Log)
+Ctrl + Y = redo (step forward in History Log)
+Ctrl + Q = restore previous Selection (Selection undo)
+Ctrl + W = restore next Selection (Selection redo)
+Ctrl + A = select all frames between two Markers surrounding Selection cursor
+Ctrl + B = reselect frames that contain Input that was copied to the Clipboard
+Ctrl + C = copy selected Input to the Clipboard (Copy)
+Ctrl + X = copy selected Input to the Clipboard and then clear selected frames (Cut)
+Ctrl + V = paste Input from the Clipboard to Selection cursor (Paste)
+Ctrl + Shift + V = insert Input from the Clipboard to Selection cursor (PasteInsert)
+Delete = clear selected frames
+Ctrl + Delete = remove selected frames from the movie
+Insert = insert given number of blank frames before Selection cursor
+Ctrl + Insert = clone selected frames
+Ctrl + Shift + Insert = insert blank frames before selected frames
+Ctrl + F = bring Find Note dialog
+Ctrl + PageUp / Ctrl + PageDown = jump on Markers with Selection cursor
+Ctrl + Home / Ctrl + End = move Selection to the beginning / to the end of the movie
+Ctrl + Up / Ctrl + Down = transpose Selection 1 frame up / down
+Ctrl + Right / Ctrl + Left = scroll Piano Roll right / left
+Shift + PageUp / Shift + PageDown = jump on Markers with Playback cursor
+Shift + Home / Shift + End = send Playback cursor to the beginning / to the end of the movie
+Shift + Up / Shift + Down = move Playback cursor 1 frame up / down
+Shift + Right / Shift + Left = scroll Piano Roll right / left
+PageUp / PageDown = scroll Piano Roll up / down
+Home / End = scroll Piano Roll to the beginning / to the end of the movie
+FCEUX hotkeys
+Emulator allows to map keyboard keys to different functions, see the Program Customization chapter. Keys that are already mapped by default are highlighted by light-blue color in this documentation.
+
Ctrl + F1 = reload last project
+Pause = pause/unpause emulator
+Esc = cancel seeking
+Spacebar = restore Playback cursor position (launch seeking to the green arrow)
+Ctrl + Spacebar = toggle "Auto-restore last position" checkbox
+\ (backslash) = Frame Advance (emulate 1 frame)
+Backspace = Frame Rewind (move Playback cursor 1 frame up)
+Shift + R = play movie from the beginning
+- (white "minus") = decrease emulation speed
+= (white "plus") = increase emulation speed
+Tab = Turbo speed (applies as long as the key is being held)
+F1-F10 = load movie branch from respective Bookmark slot (1-10)
+1-0 = jump to the frame of the Bookmark (1-10)
+Shift + F1-F10 = set Bookmark (1-10)
+I = set currently selected Bookmark (deprecated)
+P = load movie branch from currently selected Bookmark (deprecated)
+M = show/hide rerecord counter
+, (comma) = switch Input display
+. (dot) = show/hide frame counter
+/ (slash) = show/hide lag counter
+Shift + L = reload current Lua script
+Q = toggle Recording mode
+W = switch current multitracking mode
+Ctrl + R = invoke Reset command
+Full list of FCEUX hotkeys that can be used when Taseditor is engaged:
+Other FCEUX hotkeys will not work when Taseditor is running, for more details see Mistake-proofing.
+Virtual gamepad
+Emulator also allows to map keyboard keys to buttons of emulated console. You can use these keys for Input Recording and for changing Input in Selection, see the Program Customization chapter.
+By default these keys are mapped to Player 1 buttons:
+D – B
+F – A
+Enter – Start
+S – Select
+Keypad up – Up
+Keypad left – Left
+Keypad down – Down
+Keypad right – Right
+When you need to input hardware commands, use FCEUX menu or hotkeys:
+These commands work only when Recording mode is on. And after invoking a command you need to advance at least 1 frame to actually activate the command and insert it into the movie.
+Since in TAS Editor 1.0 Piano Roll doesn't have columns for displaying hardware commands (they are rarely used), it's recommended to set Markers to frames where a command was inserted.
+Controls in Note editing mode
+When you enter Note editing mode, the keyboard is used for typing the text.
+1. The following accelerator hotkeys change their meaning:
+Ctrl + A – select all text of the Note
+Ctrl + Z – undo/redo the last change in the text
+Ctrl + X, Ctrl + C, Ctrl + V – text copy/cut/paste
+Delete – delete one symbol or all selected symbols
+Home/End – move typing position to the beginning/to the end of the text
+2. FCEUX hotkeys do not work.
+Backspace – delete previous symbol
+Esc – exit Note editing mode without saving any changes
+Tab – toggle between upper and lower Note editing field
+3. Virtual gamepad keys do not work. Note: they will work if you check the Config -> Enable -> Background Input in FCEUX menu, so it's not recommended to enable the feature.
+4. Mouse controls are the same as usual. Any click outside the text edit field (except for mid-clicks) will exit Note editing mode and save text changes. Also, if the Playback cursor or Selection cursor move away from the Marker while you're editing its Note, the text changes will be saved and you'll begin editing another Marker's Note.
+Created with the Personal Edition of HelpNDoc: Full-featured Kindle eBooks generator
+
+
+
+
+
+
+ FAQ
+If after reading the Manual you still have any questions on the topic, feel free to ask them at TASVideos forum.
+I think I've found a bug in the program, what should I do?
+Post a message in the FCEUX subforum of TASVideos. Try to explain the issue precisely, to help author reproduce the situation. Attach a screenshot if you think it reflects the essence of the problem.
+Is it possible to use Taseditor with other emulators?
+No. Even though the program code of Taseditor is isolated from the emulator code, it is by no means a plug-in. So it's necessary to manually port its source code and modify it according to specifications of target platform.
+How can I TAS the traditional way, yet with Taseditor interface?
+Basically, you can start traditional TASing right away, no additional settings are required. But if you must keep some old habits intact, you can fine-tune the program. Try the following options:
+Also, it's recommended to switch the Bookmarks List to the "Branches Tree" view.
+Why the right-click on the FCEUX window doesn't prompt the usual context menu?
+It's done to facilitate the Playback cursor navigation with mouse wheel.
+Usually users move the mouse cursor in such a manner that it's in sight. Thus when TASer is watching the game events the cursor will often be inside the FCEUX window. Context menus would obstruct the view when you want to rewind the Playback by holding right mouse button and rolling the mouse wheel. Since there's no important items in the menu while TAS Editor is engaged, the menu was removed.
+Why the right-click on the Piano Roll sometimes prompts a context menu and sometimes doesn't?
+Taseditor's context menu only appears when you right-click on the number of a selected frame. If you right-click on a frame that is not selected, or you right-click on the Input of a selected frame, the menu won't appear.
+It's done to facilitate the Piano Roll scrolling by right-clicking and dragging.
+Generally, it's recommended to use keyboard shortcuts and other means of accessing Taseditor features instead of using context menu.
+How do I insert a Reset command into the movie?
+You should use Input Recording here. Place the Playback cursor to the target frame, switch on Recording, then choose NES -> Reset in FCEUX main menu and press Frame Advance. Also, it's recommended to set a Marker to this frame, since there's no other way to mark a Reset/Power switch in the Piano Roll (there's no columns for commands, only for joypad buttons).
+Then you can switch Recording off and continue usual movie editing. The frame with the Reset command can be transposed up or down by inserting or deleting frames above it.
+Other hardware commands are invoked the same way, see Controls.
+How do I change the order of columns in the Piano Roll?
+Unfortunately, this feature is not supported in TAS Editor 1.0. This will be fixed in next versions.
+How do I change the number of players (joypads) in my movie?
+You should create a new project, copying the Input and Markers from current one.
+Choose File -> New in TAS Editor main menu. In the "Create New Project" window: choose the needed Input type, check "Copy current Input" and "Copy current Markers" checkboxes and click "OK".
+Old project's Bookmarks won't be copied to the new project this way. You can recreate them using export/import Input features.
+How can I quickly compare two movies?
+The import operation will truncate the Greenzone after the frame where the first difference between Input of the two movies was found. Other places of discrepancy can be detected by observing the Input in the Piano Roll:
+For extra convenience it's recommended to name both Bookmarks, e.g. copy/paste the filename of the imported movie into the upper Marker Note just before creating a Bookmark.
+Why are those fm3 files so large?
+An FM3 file usually contains full snapshot of the working process, including the Greenzone data (which takes the most part of the file). See Advanced Features for details.
+Why is the Manual so long?
+Because besides the program specifications the Manual contains comprehensive tutorial (the Beginner's Guide) which systematizes known principles of effective TASing. Since there was no similar endeavours before, the author decided that lengthy explanations are the lesser evil than possible inexactitude.
+Created with the Personal Edition of HelpNDoc: Full-featured Help generator
+
+
+
+
+ FM3 format
+The FM3 format is a simple extension of the FM2 format. FM2 files contain data which is needed for replaying the movie, and FM3 just adds Taseditor's working data to the end of FM2 file.
+You can read full specifications of FM2 format in the FCEUX Help and on official site.
+Every FM3 consists of 3 parts:
+Header
+The Header is always in ASCII plain text format.
+It consists of several key-value pairs (lines of text where all symbols before the first space separator are considered to be the keyword and all symbols after this separator are considered to be the text representation of the value).
+Newlines may be \r\n or \n.
+If a line starts from "|" (pipe), it means the end of Header and the beginning of Input Log.
+The key-value pairs may be in any order, except that the first key must be version.
+Value text is always terminated by a newline, which the value text does not include.
+The value text is parsed differently depending on the keyword, it can be either integer or string.
+Keys with integer value:
+(also used for booleans, with a 1 for true and 0 for false)
+(the value can be stored as int32)
+Keys with string value:
+(their values cannot contain newlines)
+romFilename (required) – the name of the file used to record the movie
+romChecksum (required) – the base64 of the hexified MD5 hash of the ROM which was used to record the movie
+comment (optional) – simply a memo. By convention, the author of the movie should be stored in a comment with the subject "author". Example: "comment author AnS"
+subtitle (optional) – a message that will be displayed on screen when movie is played back (unless Subtitles are turned off). Right after the word "subtitle" and following space separator there must be an integer value indicating the frame that the subtitle will be displayed. Any remaining text after the integer and following space separator is considered to be the string displayed. Example: "subtitle 100 Level Two" – at frame 100 the words "Level Two" will be displayed on the screen
+guid (required) – a unique identifier for a movie, generated when the movie is created. Meaningless in FM3, because all there's no external savestates associated with the project file.
+Input Log
+The Input Log section consists of movie records either in the form of text lines or in the form of binary data.
+Text format:
+Every frame of the movie is represented by line of text beginning and ending with a "|" (pipe).
+If fourscore is not used, the fields in the line are as follows:
+|commands|port0|port1|port2|
+Field commands is a variable length decimal integer which is interpreted as a bit field corresponding to miscellaneous input states which are valid at the start of the frame. Current values for this are:
+The format of port0, port1, port2 depends on which types of devices were attached.
+If fourscore is used, then port0 and port1 are irrelevant and ignored. The input types must all be gamepads, and each input log record must be in the following format:
+|commands|RLDUTSBA|RLDUTSBA|RLDUTSBA|RLDUTSBA|port2|
+(commands, player 1, player 2, player 3, player 4, port2)
+Binary format:
+Input Log section starts with a | (pipe).
+Every frame of the movie is represented by a record of a fixed length. The length can be determined by the devices on port0 and port1.
+The first byte of each record stores "commands" bit field:
+If fourscore is not used, the remaining bytes in the record depend on which types of devices are attached to port0 and port1:
+If fourscore is used, then port0 and port1 are irrelevant and ignored. 4 bytes are added to the size of record. The bits of the 1st byte represent the state of buttons of the 1st joypad (bit0 = A, bit1 = B, bit2 = Select, bit3 = Start, bit4 = Up, bit5 = Down, bit6 = Left, bit7 = Right); bits of the 2nd byte represent the state of buttons of the 2nd joypad, and so on.
+Taseditor Data
+4 bytes + |
+unsigned int32 + |
+FM3 version + |
+
4 bytes + |
+unsigned int32 + |
+Saved modules + |
+
4 bytes + |
+unsigned int32 + |
+Number of offsets (N = 6) + |
+
4 * 6 bytes + |
+pointers + |
+Offsets + |
+
??? + |
+stream + |
+MARKERS DATA + |
+
??? + |
+stream + |
+BOOKMARKS DATA + |
+
??? + |
+stream + |
+GREENZONE DATA + |
+
??? + |
+stream + |
+HISTORY DATA + |
+
??? + |
+stream + |
+PIANO ROLL DATA + |
+
??? + |
+stream + |
+SELECTION DATA + |
+
The data starts right after the last record of the Input Log. If there's EOF after the last record, TAS Editor will interpret the file as an FM2 file.
+First 4 bytes of Taseditor Data contain the version of the project file format. The first release version of TAS Editor 1.0 saves projects with version = 3.
+Next 4 bytes contain bit field that can be used for determining which modules of Taseditor were saved to the FM3 file:
+Next 4 bytes contain the total number of modules, in the version 3 this number must be 6.
+Then there are six offsets (4 bytes each) pointing at the data of each module. The offsets are counted from the beginning of the file.
+When Taseditor saves the project, it calls all 6 modules that need saving. Each of them saves current writing offset and then serializes its own data into the file stream and moves current write position forward. The order of calling modules is always the same (Markers, Bookmarks, Greenzone, History, Piano Roll, Selection). When loading a project Taseditor calls those modules in the same order and they seek to the given offset and load / deserialize the data from the file.
+To check the integrity of the data loaded, every module writes its own ID (string) into the file stream before writing the data. When loading the data it expects the ID to match, if it doesn't match then the module refuses to load following data, creates default state and reports "loading error" to Taseditor.
+When using Save Compact settings, modules either save all their data as usual or write dummy ID which indicates that this module didn't save its data into the file. When loading the file a module that detects dummy ID refuses to load following data, creates default state but then reports "loading success" to Taseditor.
+Module + |
+ID when saved + |
+ID when not saved + |
+
Markers + |
+MARKERS + |
+MARKERX + |
+
Bookmarks + |
+BOOKMARKS + |
+BOOKMARKX + |
+
Greenzone + |
+GREENZONE + |
+GREENZONX + |
+
History + |
+HISTORY + |
+HISTORX + |
+
Piano Roll + |
+PIANO_ROLL + |
+PIANO_ROLX + |
+
Selection + |
+SELECTION + |
+SELECTIOX + |
+
Created with the Personal Edition of HelpNDoc: Single source CHM, PDF, DOC and HTML Help creation
+
+
+
+
+
+
+ Glossary
+Here you can find definitions for many terms that are used throughout this Manual. Most of them were used in the context of TASing before TAS Editor was created. Some of those terms are described more thoroughly in the Beginner's Guide.
+It's recommended to read the Glossary at once, because many terms are interconnected.
+
Input
+Data about player's actions, that can be received by a game.
+TASing became feasible because of general assumption that behavior of a game is always determined by its initial state and player's input, and nothing else (see Determinism).
+Examples of Input: pressing a button on a gamepad, pushing analog stick, touching by stylus, shouting into a microphone, etc.
+Taseditor works with Input in the form of "sequence of buttons states".
+Note: the fact of player not pressing any button is also considered an Input.
+ +Output
+Data sent from a game as a result of processing player's Input.
+The process of playing a game can be depicted as a loop of interaction between a subject (player) and an object (game).
+Examples of Output: displaying an image, producing a sound, vibrating gamepad, changing the value of an observed RAM address, providing an information about lag, etc.
+Playthrough / Walkthrough (Solution)
+A sequence of player's actions needed for successful completion of the game.
+This sequence is inputted into the game using an input device (e.g. gamepad). The sequence can be either performed live (created in real-time) or constructed in advance in a form of reproducible recording (e.g. a log of button presses). The latter form allows editing of the sequence.
+Speedrun
+A walkthrough aimed on fastest completion of the game.
+Some games have build-in "Speedrun" or "Time Attack" mode, where the game counts the time spent while playing. For other games it's possible to use external timer, measuring time in seconds or TV frames.
+TAS (Tool-Assisted Superplay / Tool-Assisted Speedrun)
+A walkthrough made with use of tools for editing the sequence of player's actions.
+The process of creating TASes is called "TASing", authors are usually called "TASers".
+The Input editing exempts TASers from certain human limitations (e.g. slow reflexes), allowing to spend full energy on making extraordinary walkthroughs. It can be either speedruns or entertainment videos (playarounds).
+TASes can be distributed:
+Movie (replay)
+Container for storing Input and associated data.
+Unlike video containers, the movies don't contain Output (game footage). The Output appears only when user applies the movie Input to appropriate game file.
+Lag
+The term used when the delay between Input and Output is greater than normally.
+The loop of interaction between player and game usually establishes fixed amount of time between polling Input and updating Output, for example 60 times per second.
+A computer processor can only make fixed amount of operations in this fixed amount of time. But videogames try to mimic the unboundedness of real life, so the quantity of in-game objects may vary greatly. Thus it's possible that processing all objects takes more time than allotted. In such cases the Output update will be delayed, and next Input polling will be delayed too.
+Speedrunners try to avoid excessive delays, and the lag is often considered as a factor when TASing. Usually TASers try to minimize the number of "frames containing lag".
+Emulators can detect lag in a frame right after finishing the frame emulation. The criterion is simple: if the game didn't poll Input during the frame then it's the lag frame. If it did poll Input then this is normal frame. Taseditor highlights lag frames with red color, and it's useless to draw any Input on these frames.
+Desync
+Discrepancy between expected and received Output, which results in player's Input not syncing with the logic of the game.
+Desync may appear when the Input made for one game is applied to another game, using different emulator version or different settings. Also desyncs appear when emulator doesn't support deterministic emulation.
+Segment
+Part of the movie, representing the period of time between two in-game events.
+Breaking the movie into segments is used to decompose huge task to small subtasks.
+The size of a segment can be measured in frames, but the limits of a segment are defined by in-game events. The beginning event cuts all previous tasks and concentrates TASer's attention on the nearest set of conditions. The ending event serves as an optimality criterion for all possible approaches for current task solution.
+More: TASing Process
+Optimization
+The process of searching for optimal (the best) solution of the task in current segment.
+Almost any task in videogames can be solved in a variety of ways. Every way has its own pluses and minuses. When starting a project, TASer chooses his goal (e.g. pacifist speedrun), thus setting priorities to those pluses and minuses, so all the ways of solving a task can be evaluated and compared to each other to determine which one is better.
+Optimization of a TAS consists of editing Input and evaluating resulting Output. When TASer gets better result, he marks current Input as the best until he finds even more optimal Input. Final product (TAS movie) contains best solution for every subtask.
+More: TASing Methodology
+Improvement
+A way to solve the task better (closer to optimum).
+Examples of improvements in speedruns: removing inaccuracy, applying unused timesaver, increasing the usefulness of an old timesaver, adding entertainment without losing speed.
+Timesaver
+An in-game trick that can save time.
+When making a speedrun, TASer is supposed to use every unprohibited opportunity to make the walkthrough become as fast as possible. One thing is polishing the Input to find the best outcome from current knowledge about the game. Another important activity is expanding this knowledge base – finding and applying tricks. True TASer strives to gather the maximum information about the game and use all known tricks to full extent, so that his record wouldn't be easily beaten.
+Examples of timesavers: features of the game, bugs of the game, luck manipulation.
+Note: sometimes TASers deliberately refuse certain timesavers, in this case the TAS aims for extra category. Examples: Super Mario Bros TAS without using B button (denying one feature of the game), Sonic the Hedgehog TAS without zipping (denying one bug of the game).
+Feature
+An intended aspect of the game.
+Some features are unimportant (or even unnoticeable) for an ordinary player, but substantial for a TASer. So before optimizing Input it's recommended to make a research of the game engine.
+Examples of such features: damage boost, forced waiting for score countdown, coordinate subpixels, AI peculiarities, etc...
+Bug / Glitch
+An unintended aspect of the game.
+Bugs abused by TASer should be reproducible on real console (at least theoretically). Bugs caused by emulation are not permitted.
+Many bugs are discovered during real-time play. Some of them require thorough research and disassembly of the game code.
+Examples of bugs: simplistic collision detection system, not checking save data corruption, race conditions, mistake in the order of checks, etc...
+Luck Manipulation
+Unrestricted exploiting of certain game features, which are normally limited by the shortage of player's knowledge.
+Although any experiments with Input modification are manipulations of game features, but some aspects of games appear especially unpredictable for an ordinary player. Developers intentionally entangle algorithms of those features, so that for a naked eye they seem completely random and uncontrollable.
+However, in deterministic world all aspects of videogames are predictable (defined by Input). Using tools and careful analysis you can reveal those hidden laws and dependencies, and then use the knowledge when creating the Input. And sometimes you don't even have to dissect algorithms, when you can use trial-and-error method.
+More: Nonlinear TASing (example of luck manipulation)
+Subpixels
+The term used when in-game objects have coordinates with fractional parts.
+Generally, there's difference between on-screen coordinates of a sprite and in-game coordinates of the object this sprite represents. In some games those coordinates have the same scale and their values coincide, but usually on-screen images represent a rough outline of the real state of things. So, to get max precision TASers observe the memory of emulated console, using Memory Watch tool or custom Lua HUD. This way even allows to see hidden variables of the game, that aren't displayed on-screen normally.
+Recording
+One of ways to create Input for a movie.
+It consists of appending new Input sequentially to the end of current movie, while watching interim results of the Input.
+Another way would be drawing Input directly in the movie.
+More: Toolbox, TASing Methodology, Traditional TASing
+Rerecording
+One of ways to edit Input in a movie.
+It consists of rewriting old Input sequentially from starting frame to ending frame, while watching interim results of the Input changes.
+Another way would be direct modification of existing Input in the movie.
+More: TASing Methodology, Traditional TASing, Rerecords counter
+Multitracking (multi-track recording)
+One of ways to record Input for a walkthrough of the game in multi-player mode.
+It consists of recording Input for a segment of the movie by taking turns for every player separately.
+Another way would be recording Input for all players simultaneously.
+More: Toolbox
+Frame Advance
+Step-by-step emulation of a game using the minimum units of measuring time – frames.
+Used for manual control of progression of time. Considered to be more effective replacement to "slow motion".
+Turbo (turbo speed)
+The feature of speeding up emulation to the maximum possible speed.
+Used for skipping meaningless in-game events and reducing waiting time when emulator is seeking.
+Most emulators allow to customize emulation speed, slowing it down or speeding up when needed. Turbo speed means the fastest speed possible, which depends on your computer performance.
+More: Toolbox, Nonlinear TASing, Semiautomatic TASing
+Savestate
+A snapshot of the emulated system's state at that current moment.
+Unlike in-game saves, savestate contains comprehensive data on the state of emulated hardware.
+Piano Roll
+A type of visual representation of data, similar to table or grid view.
+The interface is used in many music editing programs (MIDI sequencers and MOD trackers). Its name and basic concept was derived from existing storage medium used to operate a mechanic piano (paper rolls).
+Taseditor's Piano Roll displays current movie data (Input and Markers) and allows editing the data by mouse clicks. It also displays auxillary information like pointers, Bookmarks, Lag log, etc.
+Every row of the Piano Roll corresponds to one frame of the movie.
+More: Piano Roll, Piano Roll specs
+Playback cursor
+Pointer at currently played frame of the movie.
+Events of this frame are displayed in emulator's main window as current screenshot. Piano Roll marks respective row with light-blue color and the "Play" symbol (light-blue arrow).
+Only one frame of the movie can be seen at any given moment. To see the screenshot of upcoming events you'll have to move Playback cursor forward (down in Piano Roll). To see the screenshot of previous events you'll have to move Playback cursor backward (up in Piano Roll).
+More: Piano Roll, Playback cursor Navigation
+Greenzone (access zone)
+The storage designed for speeding up Playback cursor navigation.
+This storage automatically collects savestates for all emulated frames of the movie, and when it's necessary to rewind or jump forward to a frame, Taseditor loads respective savestate from Greenzone.
+More: Toolbox, Program Customization, Greenzone specs
+Selection
+Set of rows in Piano Roll that are highlighted by special color (usually dark-blue).
+Any row of Piano Roll (and respective frame of the movie) can be either selected or not selected.
+Selection allows to operate with many frames at once, for example, delete whole section of the movie instead of deleting every single frame in it.
+Upper row of the Selection is called "Selection cursor".
+Selection cursor automatically follows the process of Input editing.
+More: Piano Roll, Selection cursor Navigation
+Marker
+Yellow mark for a row in Piano Roll that emphasizes the frame among its neighbors.
+Any row in the Piano Roll can be marked. Markers can improve the distinctness of movie data.
+Markers can be used to:
+More: Piano Roll, Markers specs
+Note
+Single line of text accompanying every Marker.
+More: Piano Roll, Controls, Advanced Features
+Bookmark
+A numbered mark for a frame of the movie.
+Bookmark stores all necessary data about the frame it was placed on. Including the movie branch that contains Input that definitely leads the game to events of this frame.
+Bookmarks can be used for Playback cursor navigation, but their main purpose is to store branches.
+More: Toolbox, Bookmarks specs
+Branch
+A copy of the movie, storing its state at the moment of creating the Bookmark.
+Current movie can be replaced by the branch when necessary, thus restoring saved state of the movie.
+With branches you can have many different movies in one project, and you can instantly switch among them:
+More: Toolbox, Program Customization, Branches specs
+Project
+Container for storing work data in Taseditor.
+More: Advanced Features
+Lua
+A programming language used in many TAS-friendly emulators.
+Useful for making custom tools and data visualization.
+More: Advanced Features, Lua, Lua API
+Bot (robot)
+A program made for automation of a task.
+Bots are created to free humans from tedious work that doesn't require high intelligence. Unlike humans, bots don't invent the solution, they just methodically test all possible approaches within given limits, following strict algorithm made by the programmer.
+Nowadays bots are only practical for running exhaustive search within a small segment of the movie. Most of time it's faster to search for best solution manually, using human intuition to eliminate dead ends without unnecessary tests.
+Making bots requires programming skills. TASing bots are either written in Lua or built-in into emulators by modifying open source code.
+Pattern
+A predefined sequence of Input values for a button.
+More: Advanced Features, Patterns specs
+Created with the Personal Edition of HelpNDoc: Free EBook and documentation generator
+
+
+
+
+
+
+ Ideas
+Тасэдитор объединяет множество экспериментальных идей в единую систему. Многие из этих идей были озвучены очень давно (см. темы на форуме в духе "инструмент мечты" и т.д.), но для их реализации в рамках единой непротиворечивой системы понадобилось немалое время.
+Основообразующей идеей Тасэдитора является интерфейс Piano Roll, позволяющий взаимодействовать с мувиком в интуитивно понятной форме. Первые упоминания о необходимости создания инструмента для ТАСинга на основе Piano Roll звучали ещё в 2005 году, возможно, даже ранее. Прототип под названием TASEdit был создан в 2008 году. Окончательное видение Тасэдитора сформировалось в сентябре 2011 года и дорабатывалось по ходу разработки вплоть до лета 2012. Помимо реализованных идей в это время было придумано множество перспективных, но второстепенных или сложно реализуемых идей, которые было решено отложить на будущее.
+| + | ++ | +
| + + + + + + + + + + + + + + + + + + + | ++ + + + + + + + | +
Реализованные идеи
+ +Piano Roll
+Основа Тасэдитора, вокруг этой идеи и были сформированы все остальные.
+Выделение
+Как и в любом другом редакторе, в Тасэдиторе Выделение служит для применения операций к множеству кадров одновременно. Кроме того, здесь Выделение служит в качестве указателя (курсора) на место последнего щелчка по Вводу.
+Маркеры
+При редактировании больших мувиков пользователю может понадобиться установка отметок на некоторые строки Piano Roll, чтобы эти строки визуально отличались от соседних. После ряда усовершенствований эта идея вылилась в многогранную фичу.
+Горячие Правки
+Раскраска текстовых символов в ячейках Ввода разными цветами, в зависимости от давности редактирования каждой ячейки. Подробнее см. Интерфейс программы и Настройка программы.
+Гринзона
+Так как интерфейс Piano Roll предоставляет пользователю почти мгновенный доступ к изменению Ввода на любом кадре мувика, желательно также предоставить быстрый доступ к просмотру состояния игры на любом кадре мувика. Это реализуется с помощью кеширования данных о всех полученных состояниях игры.
+Проигрыватель
+Проигрыватель – это собрание всех функций по просмотру Вывода (состояния игры в нужных кадрах).
+Зелёная стрелка
+При создании спидранов ТАСер пытается обогнать свой рекорд на каждом участке. В большинстве случаев критерием оптимальности является номер кадра, на котором происходит конечное событие участка. Для его определения ТАСер перемещает Курсор Проигрывателя, одновременно просматривая экран FCEUX, и останавливает этот ручной поиск в тот момент, когда обнаружено начало интересующего события. Обычно Курсор Проигрывателя так и остаётся на найденном кадре, а ТАСер начинает изменять Ввод на участке, надеясь улучшить его и получить то же событие на более ранний кадр.
+Во время изменения Ввода Гринзона усекается, и Курсор Проигрывателя отступает назад. Когда ТАСер считает, что внёс во Ввод достаточно существенные изменения, он начинает проверку Вывода, чтобы определить, на каком кадре начинается целевое событие теперь. Для этого он опять перемещает Курсор Проигрывателя, одновременно просматривая экран FCEUX.
+Чтобы сделать вывод об улучшении, ТАСеру нужно сравнить старый номер кадра (найденный в прошлый раз) и новый номер, найденный только что. Тасэдитор визуализирует эти данные, чтобы пользователю не требовалось запоминать их в уме. На новый номер указывает Курсор Проигрывателя, на старый номер указывает зелёная стрелка.
+Автоматическое восстановление последней позиции
+При создании любых ТАСов критерием оптимальности может быть состояние игры на одном и том же кадре, либо ход событий на одном и том же участке. ТАСер просматривает участок и оставляет Курсор Проигрывателя на последнем кадре участка, затем изменяет Ввод на участке и опять просматривает участок, останавливая Курсор Проигрывателя на том же самом кадре. Вывод об улучшении ТАСер делает либо во время просмотра событий участка, либо после остановки эмуляции, оценивая характеристики последнего кадра.
+Этот процесс можно автоматизировать, автоматически запуская добегание к утерянной позиции Курсора Проигрывателя после каждого усечения Гринзоны. Для этого служит галочка "Auto-restore last position".
+Мультитрекинг-рекордер
+Рекордер – это собрание всех функций по редактированию Ввода на кадре под Курсором Проигрывателя. Рекордер предоставляет ТАСеру второй способ редактирования Ввода – Запись.
+Lua-автоматизация
+Lua позволяет пользователю расширить возможности Тасэдитора, в частности, предоставляет ТАСеру третий способ редактирования Ввода – автоматическая генерация.
+Закладки и ответвления
+Закладки являются специализированной альтернативой Маркерам. А ответвления служат для хранения нескольких мувиков в одном проекте. Для упрощения создания и навигации по ответвлениям они привязаны к Закладкам, по аналогии с традиционными сохранениями.
+Всплывающие окна
+Служат для показа контекстозависимой информации, которая нужна только в определённые моменты времени.
+Журнал Истории
+История всех существенных изменений проекта служит, главным образом, для удобного отката этих изменений, а также для визуального отслеживания этой истории.
+Счётчик перезаписей
+По традиции во всех ТАСерских эмуляторах ведётся учёт количества перезаписей, использованных во время создания ТАСа. Это число может использоваться для примерной оценки трудозатрат.
+Система клавиш-модификаторов
+Для повышения интуитивности клавиатурного управления в Тасэдиторе используется строгое разделение функций клавиш модификаторов:
+Шаблоны
+Заготовленные последовательности нажатий для одной кнопки. Подробнее см. Продвинутые возможности.
+Пересечение промежутков
+Дополнительный способ быстрой навигации по содержимому Piano Roll, облегчающий визуальное прослеживание длинных последовательностей для отдельно взятой кнопки или Маркеров.
+Компактное сохранение
+Файл проекта Тасэдитора в первую очередь предназначен для сохранения точного снимка рабочего процесса. Чтобы использовать тот же самый формат для обмена файлами между соавторами ТАСа или для опубликования в Интернете, необходимо предоставить пользователю возможность избирательного сохранения рабочих данных в файл. При открытии такого fm3-файла отсутствующие данные будут заменяться данными по умолчанию.
+Подробнее см. Продвинутые возможности и Формат FM3.
+ +Автосохранение
+Как и в случае с любым офисным документом, проект Тасэдитора желательно время от времени сохранять на диск, даже если не планируется выход из программы. Однако до Тасэдитора у ТАСеров не было такой привычки, поэтому имеет смысл сохранять проект автоматически, предоставив пользователю возможность настроить или отключить эту функцию.
+Подробнее см. Настройка программы.
+Запланированные идеи
+Журнал Вывода (Output Log)
+Следующий этап эволюции инструмента Memory Watch – просмотр состояния игровых данных в динамике, а не только в статике. Аналогично Журналу лага, эта фича позволит легче и точнее анализировать принципы изменения игрового Вывода.
+Миникарта
+Графически отображает в окне Тасэдитора весь мувик – Гринзону, лаг, Курсор Проигрывателя, Выделение, Маркеры, Закладки, точки Горячих Правок, подсветку Журнала Вывода и т.д. Предоставляет пользователю мгновенный образ текущего проекта, не обладающий детальностью, зато полностью умещающийся на экране. Также усовершенствует навигацию по мувику.
+Виртуальный Джойстик
+Альтернативный способ ввода инпута. Очень похож на изменение инпута щелчками по Заголовку Piano Roll, однако более удобен и нагляден.
+Усовершенствование Выделения
+Архитектура TAS Editor 1.0 не рассчитана на выделение столбцов Piano Roll, однако в некоторых ситуациях это может быть необходимо при ТАСинге. Например, для очистки Ввода первого джойстика без очистки Ввода второго джойстика. Либо для перемещения Ввода одной/двух кнопок без смещения остальных внопок.
+Кроме того, необходимо усовершенствовать процесс рисования Выделения, чтобы пользователь мог видеть цвет строк Piano Roll под полупрозрачным Выделением.
+Гибкая настройка колонок
+В TAS Editor 1.0 столбцы Piano Roll имеют фиксированную ширину. Количество и порядок следования столбцов также фиксированы, Для команд приставки (сброс, вставка диска и т.д.) отдельные столбцы не отводятся, так как эти команды используются крайне редко. Однако при портировании Тасэдитора на другие эмуляторы количество столбцов будет возрастать (например, у PSX нужно отображать столбцы для 14 кнопок), необходимо предоставить пользователю возможность настраивать их.
+Теплокарта перезаписей
+Хранит и отображает статистику "изменений после просмотра" (перезаписей). Может быть полезна для выявления сложных мест в мувике.
+Прочие мелочи
+Поддержка платформ, отличных от NES
+Если Тасэдитор приобретёт популярность среди ТАСеров, необходимо расширить его доступность для всех эмулируемых платформ.
+Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily
+
+
+
+
+
+
+ Implementation
+At first the TAS Editor was based on the codebase of experimental tool named TASEdit, using FCEUX 2.1.5 as a kick-start.
+The premise of TASEdit was to build an input editor (like TAS Movie Editor) into emulator, so that the delay between editing and checking results would greatly shrink. Since there was no research done on typical behaviors in TASing process, the concept was vague and the code wasn't scalable. Thus, soon after formulating the new vision of the editing tool the code of TAS Editor was fully rewritten to make adding new features easier.
+The following architecture of TAS Editor was designed according to author's notion of a methodical TASing and of features needed for such TASing.
+TAS Editor modules (classes)
+taseditor.cpp
+Main – Main gate between emulator and Taseditor
+[singleton]
+taseditor_window.cpp
+Window – User Interface
+[singleton]
+bookmarks.cpp
+Bookmarks – Manager of Bookmarks
+[singleton]
+branches.cpp
+Branches – Manager of Branches
+[singleton]
+bookmark.cpp
+Bookmark – Single Bookmark data
+snapshot.cpp
+Snapshot – Snapshot of all edited data
+inputlog.cpp
+InputLog – Log of Input
+laglog.cpp
+LagLog – Log of Lag occurrence
+markers.cpp
+Markers – Snapshot of Markers state
+popup_display.cpp
+Popup display – Manager of popup windows
+[singleton]
+history.cpp
+History – History of movie modifications
+[singleton]
+piano_roll.cpp
+Piano Roll – Piano Roll interface
+[singleton]
+selection.cpp
+Selection – Manager of selections
+[singleton]
+editor.cpp
+Editor – Tool for editing
+[singleton]
+splicer.cpp
+Splicer – Tool for montage
+[singleton]
+taseditor_config.cpp
+Config – Current settings
+[singleton]
+playback.cpp
+Playback – Player of emulation states
+[singleton]
+greenzone.cpp
+Greenzone – Access zone
+[singleton]
+recorder.cpp
+Recorder – Tool for input recording
+[singleton]
+markers_manager.cpp
+Markers_manager – Manager of Markers
+[singleton]
+taseditor_lua.cpp
+Lua – Manager of Lua features
+[singleton]
+taseditor_project.cpp
+Project – Manager of working project
+[singleton]
+Emulator modifications
+Taseditor needs the following modifications to be applied to an emulator code.
+Main/Window:
+Movie:
+Input:
+Output:
+SaveStates:
+Config:
+Lua engine:
+Replay:
+Other:
+Created with the Personal Edition of HelpNDoc: Single source CHM, PDF, DOC and HTML Help creation
+
+
+
+
+
+
+ Introduction
+
TASing – the process of creating an extraordinary game playthrough. For a true TASer, just simply beating the game is not enough. You must do something unique, something that would justify the use of tools.
+And that requires a non-standard way of thinking. During the regular play, almost entire flow of our thoughts is determined by the gameplay rules, and those who try to question the rules are quickly fined with a game over and other means. These trivial psychological methods help the game to direct player's fantasy to an intended path, in order to give him a credible atmosphere of integral world and to keep him within a craftily devised comfort zone.
+So, to create an extraordinary playthrough, TASer needs to both use emulator tools masterfully and be able to mentally abstract from the original game rules, while still obeying them physically (because TASing is not cheating, we won't influence the game other way than by joypad input).
+Early TASing, just as regular speedrunning, was not much far away from the "normal" gaming process. TASer simply launched an emulator, switched on buttons logging and played a game, saving and loading often enough to fix the most obvious mistakes, slowing down the gameplay at the most intense moments, thus compensating for the slow reaction of the human organism.
+The ability to fix mistakes emancipates man's imagination and incites him to experiment. Illusions of the game realm now confine his mind much less than before. But real-world stereotypes still affect his thinking. For instance, if a harmful object usually kills you, it's only natural to assume it always kills. But in truth it may appear to be killing only while even frame numbers, or when the subpixel value is equal to zero. But how would you guess it using only savestates and slowdown? First you have to stop being a gamer and become a researcher.
+A huge breakthrough in the TASing history was the introduction of Frame Advance – a frame-by-frame emulation. Now when you're TASing, the game is constantly being held paused, thus allowing to analyze every in-game aspect separately. Until then the game still appeared as a coherent stream of events (with simple slowdown). The stream that the player had to perceive as a complex emotional cocktail. And now with frame-by-frame play TASer can mentally isolate any given event of the current frame. This drastically alters the principles of consuming the in-game information. Material world stereotypes don't dictate how to act in the virtual world anymore, and you see the game more objectively, thus finding imperfections/loopholes in its rules.
+Of course the game still keeps trying to impose typical behavior templates, and they are harder to resist when you're newbie rather than experienced TASer. That's the exact reason why a skilled TASer can beat someone's speedrun (even his own old TAS) – not because of handling the tools better, but owing to "Déformation professionnelle" that helps to notice vulnerabilities in games.
+Many more TASing tools were invented since then, but the very way of interaction between a TASer and a game remained the same. Using rerecords, TASer edits Input in the same succession as the flow of in-game time. This linearity of TASing process builds certain limits in TASer's thinking. When you get used to receiving the game reaction on each button press, you involuntarily associate yourself with a game character. This makes it harder to try to look at the events from an outsider's viewpoint. And yet TASer is expected to have the most objective point of view possible!
+The development of the toolset named "TAS Editor" aims for 2 main goals:
+The first goal is achieved by detailed visualization of all major aspects of TASing.
+The second goal is achieved by switching from linear recording of movie segments to non-linear Input editing. The higher level of abstracting from in-game rules is reached by giving the TASer the following new abilities:
+In addition, TAS Editor 1.0 developed some old TASing tools up to a new level:
+When launching Taseditor, get ready to control the game from bird's eye view. The following chapters of this tutorial will explain you almost everything a prolific TASer needs to know. If you already have an experience in traditional TASing, some learning aspects should come easier, but some may appear more difficult to you than to a newcomer. Either way, try to finish the whole Guide, and you will likely learn a thing or two about TASing in general.
+One of the most unconventional features of TASing with Taseditor is the stress on mouse control. Mouse allows high speed of Input editing and unparalleled convenience of Playback navigation. Even though most of Taseditor functions also have keyboard shortcuts, the comfortable work would be impossible without a mouse.
+The gamepad is useful when you need to quickly record an Input without caring about accuracy. But most of his time TASer spends on various manipulations with once created Input. And here the mouse or keyboard becomes much more handy than gamepad. For example, using a key combination you can move any part of Input one frame back or forth. And when you need to adjust the jump height (the duration of holding the A button), it's easier to do with single click, than to switch Recording on and retype the whole range of frames.
+Nevertheless, it's still possible to work in Taseditor the same way people were TASing before. The program interface supports all essential aspects of the traditional TASing method. If you were to use the TAS Editor window only as an informational panel left in a corner of the desktop, you probably would not even notice any difference from usual flow of TASing. It can be good reason to smoothly move from the old method of TASing to the new one. At first you may only like some accessory features of Taseditor, such as the Lag visualization or the Branches Tree. Then you'll need some Input copy/paste, and Taseditor is the best alternative to an external editor. After some time you'll notice that direct Input editing turns out faster than rerecording.
+
Advantages of the new method reveal themselves quicker when you're making a TAS controlling 2 and more players simultaneously. In old times people invented plenty of hacks and workarounds to make such kind of TASing easier, e.g. binding several buttons to one key, using "Auto-hold", macros and custom multitracking scripts. Now all of this is irrelevant with Taseditor, because here TASer does not play the role of a gamer that associates himself with the controlled character. Now you are not playing the game, you are meditating over the decomposed continuum of the game, while creating a scenario of events via Input. And thus it's does not matter whether you control 1 character, or 2, or many.
+Taseditor was also designed to reduce the rut. There are always lots of tedious recurring activities in TASing. Surely, the program won't save you from the necessity to test all possible branches of gameplay development, but it automates some actions and increases the efficiency in many little things, allowing TASer to keep patience longer than during raw TASing.
+Interesting facts:
+Special attention was paid to user interface. When you gain enough experience, you'll be able to do most of things mechanically, staying focused on the in-game situation analysis.
+If you happen to get a nice idea how to reduce the rut some more, feel free to post on TASVideos forums. Many ideas implemented in TAS Editor were first voiced on these forums as "dream tools".
+Besides the new approach to TASing, Taseditor offers simple means for organization of your working process. Because of unsystematic approach to TASing many newcomers waste their time ineffectively, dissipate the effort and get tired quickly, then start to save the energy by reducing the amount of tests. As a result, they end up with a very suboptimal TAS. Then, as the time goes, they acquire a set of methods and habits, become experienced TASers. But every newbie had to learn by his own mistakes. In this Guide we will try to formulate a clear notion on a methodical TASing (both traditional and new), so that newcomers can realize the essence of the process faster.
+Working with Taseditor is pretty similar to an interactive programming using an interpreted language. You just edit the code and instantly see the result of its execution on the screen. TASer can either immediately observe the effect of his interim actions, or he can get carried away by the construction of a code section and watch the result only after the section is finished.
+Programmers have the valuable ability to increase the code readability with comments. It allows to keep more clear picture of the project in mind, and proceed without constant re-inspection of results, because in most cases the result is rather predictable, when the context is known.
+Also, good code readability allows to quickly refresh all necessary memories when you return to a project delayed long ago. Granted that this project was well documented.
+Taseditor helps to document TAS project on the fly – write comments, assign clear names to structures (patterns and Input sections), test different code versions in separate branches of the repository (see "Branches Tree") and efficiently work in co-authorship. And no, there's no strict conventions to follow. You set your own rules for when and how to shape your project. For example, if you didn't hesitate to describe a trick used in the first level, in next levels you'll be able to quickly duplicate the trick Input by several key strokes. If you didn't – you'll have to search the trick location manually. In simple TASes you can disregard comments and any long-term plans, but in complicated projects this program functionality should be very appropriate.
+TASVideos.org site supports uploading and publishing Taseditor projects (.fm3 files), so you may share not just the TAS movie, but your groundwork as well, encouraging the spirit of openness and mutual aid. If you don't want to share, export the data to .fm2 format and upload that.
+FM3 files are played back by FCEUX emulator since version 2.2.0 the same way as FM2 files. Older versions of FCEUX can also play such files if you change the extension to fm2.
+Next chapter: learning the basics of the program usage.
+Created with the Personal Edition of HelpNDoc: Easily create iPhone documentation
+
+
+
+
+
+
+ Lua API
+TAS Editor v1.0 comes with the library of 24 functions available for Lua scripts running in FCEUX emulator. With Lua scripts you can automate some aspects of TASing and even create your own tools for movie editing.
+In FCEUX folder there's /luaScripts folder with /taseditor subfolder in it. There you can find examples of scripts using functions of this library.
+If you don't know how to make and run Lua scripts in emulators, read Advanced Features and also refer to FCEUX Help.
+Full list of functions:
+taseditor.registerauto(function func)
+taseditor.registermanual(function func, [string name])
+bool taseditor.markedframe(int frame)
+int taseditor.getmarker(int frame)
+int taseditor.setmarker(int frame)
+taseditor.removemarker(int frame)
+string taseditor.getnote(int index)
+taseditor.setnote(int index, string newtext)
+int taseditor.getcurrentbranch()
+string taseditor.getrecordermode()
+int taseditor.getsuperimpose()
+int taseditor.getlostplayback()
+int taseditor.getplaybacktarget()
+taseditor.setplayback(int frame)
+ +table taseditor.getselection()
+taseditor.setselection(table new_set)
+int taseditor.getinput(int frame, int joypad)
+taseditor.submitinputchange(int frame, int joypad, int input)
+taseditor.submitinsertframes(int frame, int number)
+taseditor.submitdeleteframes(int frame, int number)
+int taseditor.applyinputchanges([string name])
+ + +taseditor.registerauto(function func)
+Registers a callback function ("Auto Function") that runs periodically. The Auto Function can be registered and will be called even when TAS Editor isn't engaged.
+When FCEUX is unpaused, your function will be called at the end of every frame (running 60 times per second on NTSC and 50 times per second on PAL).
+When FCEUX is paused, your function will be called 20 times per second.
+User can switch on/off auto-calling by checking "Auto function" checkbox in TAS Editor GUI.
+Like other callback-registering functions provided by FCEUX, there is only one registered callback at a time per registering function per script. If you register two callbacks, the second one will replace the first, and the call to taseditor.registerauto() will return the old callback. You may register nil instead of a function to clear a previously-registered callback.
+If a script returns while it still has registered callbacks, FCEUX will keep it alive to call those callbacks when appropriate, until either the script is stopped by the user or all of the callbacks are de-registered.
+ +taseditor.registermanual(function func, [string name])
+Registers a callback function ("Manual Function") that can be called manually by TAS Editor user. The function can be registered even when TAS Editor isn't engaged.
+The Manual function doesn't depend on paused or unpaused FCEUX status. It will be called once every time user presses Run function button in TAS Editor GUI.
+You can provide a new name for this button.
+The Manual function cannot be run more often than TAS Editor window updates (60/50 FPS or 20FPS when emulator is paused).
+In FCEUX code Manual function runs right after Auto Function.
+You can use this feature to create new tools for TAS Editor. For example, you can write a script that reverses currently selected input, so user will be able to reverse input by selecting a range and clicking Run function button.
+Like other callback-registering functions provided by FCEUX, there is only one registered callback at a time per registering function per script. If you register two callbacks, the second one will replace the first, and the call to taseditor.registermanual() will return the old callback. You may call taseditor.registermanual(nil) to clear a previously-registered callback.
+If a script returns while it still has registered callbacks, FCEUX will keep it alive to call those callbacks when appropriate, until either the script is stopped by the user or all of the callbacks are de-registered.
+ +bool taseditor.engaged()
+Returns true if TAS Editor is currently engaged, false if otherwise.
+Also when TAS Editor is engaged, movie.mode() returns "taseditor" string.
+ +bool taseditor.markedframe(int frame)
+Returns true if given frame is marked in TAS Editor, false if not marked.
+If TAS Editor is not engaged, returns false.
+ +int taseditor.getmarker(int frame)
+Returns index number of the Marker under which given frame is located.
+Returns -1 if TAS Editor is not engaged.
+ +int taseditor.setmarker(int frame)
+Sets Marker on given frame. Returns index number of the Marker created.
+If that frame is already marked, no changes will be made, and the function will return the index number of existing Marker.
+You can set markers even outside input range.
+If TAS Editor is not engaged, returns -1.
+ +taseditor.removemarker(int frame)
+Removes marker from given frame. If that frame was not marked, no changes will be made.
+If TAS Editor is not engaged, no changes will be made.
+ +string taseditor.getnote(int index)
+Returns string representing the Note of given Marker.
+Returns nil if TAS Editor is not engaged.
+If given index is invalid (if Marker with this index number doesn't exist), returns note of the zeroth marker.
+ +taseditor.setnote(int index, string newtext)
+Sets text of the Note of given Marker.
+If given index is invalid (if Marker with this index number doesn't exist), no changes will be made.
+If TAS Editor is not engaged, no changes will be made.
+ +int taseditor.getcurrentbranch()
+Returns number from 0 to 9 representing current Branch.
+Returns -1 if there's no Branches or if TAS Editor is not engaged.
+ +string taseditor.getrecordermode()
+Returns string representing current recorder mode.
+Returns nil if TAS Editor is not engaged.
+When you want to check Recorder's read-only state, use emu.readonly().
+ +int taseditor.getsuperimpose()
+Returns number representing current state of Superimpose checkbox in TAS Editor GUI.
+0 – unchecked
+1 – checked
+2 – indeterminate (you can interpret is as half-checked)
+If TAS Editor is not engaged, returns -1.
+ +int taseditor.getlostplayback()
+Returns the number of the frame where Playback cursor was before input was changed.
+If Playback didn't lose position during Greenzone invalidation, returns -1.
+If TAS Editor is not engaged, returns -1.
+ +int taseditor.getplaybacktarget()
+If TAS Editor's Playback is currently seeking, returns number of target frame.
+If Playback is not seeking or if TAS Editor is not engaged, returns -1.
+ +taseditor.setplayback(int frame)
+Sends Playback cursor (current frame counter) to given frame.
+If given frame wasn't found in TAS Editor Greenzone, starts seeking to the frame.
+If TAS Editor is not engaged, nothing will be done.
+ +taseditor.stopseeking()
+Stops Playback seeking and pauses emulation.
+If Playback wasn't seeking, this function only pauses emulation.
+If TAS Editor is not engaged, nothing will be done.
+ +table taseditor.getselection()
+Returns a table (array) containing numbers of currently selected frames. These numbers are sorted in ascending order.
+If no frames are selected at the moment, returns nil.
+If TAS Editor is not engaged, returns nil.
+ +taseditor.setselection(table new_set)
+Changes current selection to the given set of frames. Frame number in your table don't have to be sorted.
+Call taseditor.setselection(nil) to clear selection.
+If TAS Editor is not engaged, nothing will be done.
+ +int taseditor.getinput(int frame, int joypad)
+Returns a number representing input of given joypad stored in current movie at given frame.
+If given frame is negative, returns -1.
+If given frame is outside current input range, returns 0, which can be interpreted as a blank frame (no buttons pressed at this frame yet).
+Joypad value must be one of the following:
+0 – to get hardware commands (bit 0 = reset, bit 1 = poweron, bit 2 = FDS insert disk, bit 3 = FDS switch side)
+1 – to get 1P buttons (bit 0 = A, bit 1 = B, bit 2 = Select, bit 3 = Start, bit 4 = Up, bit 5 = Down, bit 6 = Left, bit 7 = Right)
+2 – to get 2P buttons
+3 – to get 3P buttons
+4 – to get 4P buttons
+You should handle returned number (if it's not equal to -1) as a byte, each bit corresponds to one button (e.g. if bit 1 is set that means A button is pressed). Use Bitwise Operations to retrieve the state of specific buttons.
+If given joypad is outside [0-4] range, returns -1.
+If TAS Editor is not engaged, returns -1.
+ +taseditor.submitinputchange(int frame, int joypad, int input)
+Sends request to TAS Editor asking to change input of given joypad at given frame.
+Actual movie input won't be changed until the moment you call taseditor.applyinputchanges().
+Using several consecutive requests and then calling applyinputchanges() at the end, you can change several frames of current movie in one moment.
+When applying the pile of requests, TAS Editor will execute them in consecutive order.
+If given frame is negative, TAS Editor will ignore such request.
+If given frame is outside current input range, TAS Editor will expand movie during applyinputchanges() to fit the frame.
+If given joypad is outside [0-4] range, TAS Editor will ignore such request.
+Given input will be treated by TAS Editor as a sequence of bits representing state of each button of given joypad (bit 0 = A, bit 1 = B, bit 2 = Select, bit 3 = Start, bit 4 = Up, bit 5 = Down, bit 6 = Left, bit 7 = Right).
+If TAS Editor is not engaged, nothing will be done.
+ +taseditor.submitinsertframes(int frame, int number)
+Sends request to TAS Editor asking to insert given number of blank frames before given frame.
+Actual movie won't be changed until the moment you call taseditor.applyinputchanges().
+Insertion can move down some old input and Markers (if "Bind Markers to Input" option is checked by user).
+If given number is less or equal to zero, TAS Editor will ignore such request.
+If given frame is negative, TAS Editor will ignore such request.
+If given frame is outside current input range, TAS Editor will expand movie during applyinputchanges() to fit the frame.
+If TAS Editor is not engaged, nothing will be done.
+ +taseditor.submitdeleteframes(int frame, int number)
+Sends request to TAS Editor asking to delete given number of frames starting from given frame.
+Actual movie won't be changed until the moment you call taseditor.applyinputchanges().
+Deletion can move up some old input and Markers (if "Bind Markers to Input" option is checked by user).
+If given number is less or equal to zero, TAS Editor will ignore such request.
+If given frame is negative, TAS Editor will ignore such request.
+If given frame is outside current input range, TAS Editor will expand movie during applyinputchanges() to fit the frame.
+If TAS Editor is not engaged, nothing will be done.
+ +int taseditor.applyinputchanges([string name])
+Instantly applies the list of previously requested changes to current movie. If these requests actually modified movie data, new item will appear in History Log (so user can undo these changes), and Greenzone may become truncated, Playback cursor may lose its position, auto-seeking may be triggered.
+Returns number of frame where first actual changes occurred.
+If no actual changes were found (for example, you asked TAS Editor to set buttons that were already pressed), returns -1.
+If pending list of changes is empty, returns -1.
+You can provide a name that will be assigned to this change. This name will be shown in History Log. If you don't provide a name, TAS Editor will use default name ("Change").
+After applying all requests TAS Editor clears the list of requests.
+If TAS Editor is not engaged, nothing will be done.
+ +taseditor.clearinputchanges()
+Clears the list of previously requested changes, making TAS Editor forget about them before you call applyinputchanges(). Use this function to discard previously submitted input changes.
+It's also recommended to call this function before making several requests in a row, so that you'll be sure that only your new changes will apply.
+If TAS Editor is not engaged, nothing will be done.
+Created with the Personal Edition of HelpNDoc: Full-featured Documentation generator
+
+
+
+
+
+
+ Mistake-proofing
+This page lists many small details of implementation that improve interaction between user and the program. All these points must be considered when porting Taseditor to other platforms.
+Created with the Personal Edition of HelpNDoc: Full-featured Documentation generator
+
+
+
+
+
+
+ Navigation
+FCEUX main window can only display data of one frame of a movie at any given moment. Piano Roll can cover data for tens of frames at the same time. But average movie has thousands of frames. So TASer constantly needs to scroll the Piano Roll up and down or rewind emulator playback to get the data about needed frame or group of frames.
+Throughout the documentation this is called "movie navigation". It takes major part of TASing, and Taseditor introduces many new ways of navigation, striving to make it as fast as possible. Depending on the situation some of them are better then others, so it's not recommended to stick to a single one.
+Ideally, the navigation skills should move to muscle memory, allowing you to always appear in necessary place of the movie without interrupting the analysis of current task.
+All ways of navigating a movie:
+Scrolling Piano Roll
+1. Using vertical scrollbar
+Click on the scrollbar or drag its thumb to scroll Piano Roll like any other list.
+Playback cursor and Selection cursor positions are not affected by Piano Roll scrolling.
+When to use:
+2. Rolling mouse wheel
+Roll mouse wheel up or down to scroll Piano Roll like any other list.
+Mouse cursor can be pointing anywhere except History Log window.
+When to use:
+3. Crossing gaps
+Point mouse cursor to any cell in Input/Markers/icons, hold Alt and roll the mouse wheel up or down to scroll the Piano Roll to the closest cell that contains data different from the data of adjacent cell.
+When to use:
+4. Paging through
+Press Page Up or Page Down key to scroll Piano Roll like any other list. The amount of scrolling depends on the size of Piano Roll visible area.
+When to use:
+5. Jumping to the beginning / to the end of the movie
+Press Home or End to scroll Piano Roll to the beginning or to the end of the movie.
+When to use:
+6. Jumping to Playback cursor
+Click on the upper "Marker #" label (colored light-blue) to immediately scroll Piano Roll to Playback cursor position. Alternative way to do it is to press Shift key twice within a short amount of time.
+When to use:
+7. Jumping to Selection cursor
+Click on the lower "Marker #" label to immediately scroll Piano Roll to Selection cursor position. Alternative way to do it is to press Ctrl key twice within a short amount of time.
+When to use:
+8. Jumping to the Marker above Playback cursor
+Click on the upper edit field to immediately scroll Piano Roll to the Marker which Note is going to be edited.
+Works only when the View -> Follow Marker Note context option is enabled.
+When to use:
+9. Jumping to the Marker above Selection cursor
+Click on the lower edit field to immediately scroll Piano Roll to the Marker which Note is going to be edited.
+Works only when the View -> Follow Marker Note context option is enabled.
+When to use:
+Playback cursor navigation
+The Playback cursor is always bound to current state of emulated game. This means that emulator affects this cursor when emulating the game, and vice versa, when you move this cursor, you affect the emulator.
+There's one limitation in the controlling of the cursor: sometimes it can't immediately move to the desired frame, seeking takes some time.
+When the "Follow cursor" checkbox in the Playback panel is checked, the Piano Roll automatically scrolls after the Playback cursor.
+ +1. Frame-by-frame shift
+Click on < or > button in the Playback panel, or press Shift + Up or Shift + Down, or use Frame Rewind or Frame Advance hotkey to move Playback cursor 1 frame back of forward.
+When to use:
+2. Rewinding by mouse wheel
+Hold right mouse button and roll mouse wheel up or down to move Playback cursor.
+Mouse cursor can be pointing anywhere.
+When to use:
+3. Dragging with mouse
+Click on any cell in the leftmost column of the Piano Roll ("Icons" column) to send the Playback cursor to the frame. Also, click on any cell of the column and hold the left mouse button to drag the Playback cursor by moving the mouse. This method also allows to scroll the Piano Roll by dragging the Playback cursor outside (above or below the Piano Roll).
+When to use:
+4. Jumping on Markers
+Click on << or >> button in the Playback panel, or press Shift + Page Up or Shift + Page Down, or hold Shift and roll the mouse wheel to move Playback cursor to previous or next Marker.
+When to use:
+5. Jumping to Bookmarks
+Press the hotkey (0-9) corresponding to the number of desired Bookmark, or click on a frame number in Bookmarks List, or click on a Bookmark icon in the Branches Tree to send Playback cursor to the bookmarked frame.
+When to use:
+6. Jumping to the beginning / to the end of the movie
+Press Shift + Home or Shift + End, or click the cloudlet or the fireball in the Branches Tree to move Playback cursor to the beginning or to the end of the movie.
+You can also press the Play movie from the beginning hotkey (Shift + R by default) to move Playback cursor to the beginning of the movie.
+When to use:
+Selection cursor navigation
+Selection cursor is usually located on the frame where the most recent changes of Input were made, but you can also move the cursor to any other frame when needed.
+The Piano Roll automatically scrolls after the Selection.
+ +1. Frame-by-frame shift
+Press Ctrl + Up or Ctrl + Down to move current Selection 1 frame up or down.
+When to use:
+2. Moving Selection to the beginning / to the end of the movie
+Press Ctrl + Home or Ctrl + End to move current Selection to the beginning or to the end of the movie.
+When to use:
+3. Jumping on Markers
+Click on << or >> button at the bottom of the Toolbox, or press Ctrl + Page Up or Ctrl + Page Down, or hold Ctrl and roll the mouse wheel to move Selection cursor to previous or next Marker.
+When to use:
+4. Tracking the Selection History
+Press Ctrl + Q or Ctrl + W to revert Selection to its previous or next state.
+This method of navigation allows to return to previously edited segments and quickly remember the sequence of recent changes.
+When to use:
+5. Returning to the origin of Clipboard data
+Press Ctrl + B to revert Selection to its state at the moment of the last "Copy to Clipboard" operation.
+When to use:
+Special
+1. Finding Markers with given text
+Open the Find Note window, enter the text to search and click Find next or press Enter key to set Selection cursor to the closest Marker which Note contains the text. The Piano Roll automatically scrolls after the Selection. You can search up or down from current position of Selection cursor.
+When to use:
+2. Jumping to segment with similar description
+Leave Playback cursor in current segment and click the Similar or More button to set Selection cursor to the Marker containing the most relevant Note. The Piano Roll automatically scrolls after the Selection.
+This method is described in the Advanced Features chapter.
+When to use:
+Created with the Personal Edition of HelpNDoc: Write EPub books for the iPad
+
+
+
+
+
+
+ Nonlinear TASing
+
This is the main method when working with Taseditor. At first it may seem rather different from the traditional TASing, however, they are essentially very similar.
+When using this method, the Recording mode should always be off. The "Auto-restore last position" checkbox should be disabled. The "Turbo seek" and "Follow cursor" checkboxes are usually disabled, but may be enabled when necessary.
+General activity:
+Since all created approaches to playing the segment are automatically saved in the History Log, you could follow the temptation to rely on the Log and not save the approaches to Bookmarks (steps 6 and 7), instead just reach the target event once and then experiment with this Input, gradually improving it (and simply undoing all the changes that are for the worse). Such perfunctory way of TASing is technically possible, but not recommended, because it doesn't let you think far outside the terms of the first approach (because you subconsciously fear to lose the old best approach by leaving it too far away).
+Even if the outcome of the latest modification of the Input made the game behave worse, you should not immediately revert to the previous state of the movie, better try to examine the cause of the worsening and continue the modification to turn it into an improvement. And in order to never be afraid to lose the previous successful playthrough in the depths of the History Log, you should do exactly like they do in the traditional TASing – allot a special slot for storing the best result and set this Bookmark to the end of the segment every time you improve the result.
+And you can do the same with those promising approaches that are somewhat better, but somewhat worse than the current best result. When you're saving all alternative approaches to separate Bookmarks, you can safely remove their Input from the working movie or change it beyond recognition, because you can return to any of them with a single key press, and no need to search within the History Log.
+Unlike the traditional TASing method, here you may lose sight of dividing the movie into logical segments, because now you don't have to mark the beginning and the end of the current segment with Bookmarks. However, it's still recommended to keep an order and mark the beginning of every important segment with Markers, in order to limit the number of optimality factors.
+The beginning and the end of a segment are usually associated with certain events of the game, and not with a soulless frame number. But since the starting event of the segment is not affected by modifying the Input of the segment, this event will always occur in the same frame, so you can lock the frame with a Marker.
+The ending event of the segment may occur in various points of time, depending on the Input in the segment. So if you mark the end with a Marker, you will need to move the Marker up or down every time you change the target event by modifying the Input. Often it's impractical to spend time on dragging, so instead of the trailing Marker you can use aforementioned Bookmark which both stores the best approach and serves as a mark of the end of current segment.
++As for simple segments, you can polish them without marking the ending frame at all, by simply relying on your own memory and on the green arrow provided by Taseditor. With this green arrow the Taseditor hints you the frame where you've stopped watching the segment the last time (before you started modifying the Input of the segment). Usually this is the frame where the target event was detected in previous approach. So you may as well replay the updated segment up to the frame and compare the new result with the old one. If the target event is now detected 2 frames above the green arrow, it means you've outran previous result by 2 frames, so the new Input is better (if your criterion is speed). This entire logical chain pops in your mind once you glance at the Piano Roll after watching the outcome of the recent Input modification.
+The process of polishing the Input in the nonlinear method is a constant alternation of editing and watching the segment. You analyze the situation during the watching and right after stopping the watching.
+Possible ways to watch the outcome of Input:
+Most often you are going to either click the middle mouse button or move the Playback cursor by scrolling the mouse wheel. Don't attach yourself to a single one of the ways, learn to use them depending on a situation.
+The ratio between the time spent on editing and on watching depends on the complexity of the current segment and on the volume of your knowledge about the game. The more you TAS a single game, the better you are aware of its regularities. So near the end of your project you'll be able to foresee the outcome of your Input modifications before even attempting to edit them in. Then you'll only need to watch the segment in order to confirm your guess.
+In some cases you can judge about the optimality of an Input by seeing its interim results and not even watching the segment to the end. For example, if the character bumps into a wall and nullifies his speed in the middle of the segment, you can immediately guess that he is going to reach the target event later than previous time. So sometimes you want to only watch a few frames and continue the editing. However, such a hurry may lead you to reject a solution that is suboptimal at first glance but has a potential to be very successful in another segment. For example, after bumping the wall Mario may accidentally enter inside and go through it. That's why it's recommended to never hurry when TASing, and to watch the current segment to the end, where you can be sure the optimality criterion won't let you down.
+Technically you can watch and edit the Input simultaneously. When the "Follow cursor" checkbox is disabled, the Piano Roll stays still, while the movie is played, so you can draw buttonpresses right when they are executed (replayed). For example, when Mario jumps over an obstacle, try to change the height of the jump by drawing and erasing the A button presses without pausing the emulation. You can slow the emulation down by the - and = hotkeys, in order to have more time for clicking while watching.
+But when you need to have enough time both for clicking and for thinking, better pause the emulator and TAS properly.
+ +The emulation speed can be both decreased and increased. Before Taseditor, speeding up the emulation was used only for quick replay of the finished part of the movie. But now the turbo emulation also serves as an original way of TASing. With an extremely fast emulation you can feel the interconnection between a buttonpress and its distant outcome.
+
+A good example would be the process of luck manipulation.
+Normally, when shooting you can see the connection between pressing the B button and a bullet appearing on screen at the next frame. Applying this association (B = shot) to an in-game situation makes you think "the later I press B, the later the bullet will appear".
+But with turbo-seeking you effectively skip all irrelevant steps of the movie (shooting, bullet flying, collision, enemy death, etc), so right after making the B buttonpress you immediately see which item was dropped by the enemy. This new association (B = possibility of a bonus item) makes you think about this in-game situation more like "the type of the item drop depends on when I press B".
+This way turbo allows to automatically filter useless information that is produced by the game in the middle of the segment, and only consume the necessary data that appears at the end of the segment.
+Here's how you do it:
+Pros of the method:
++ Instant navigation.
++ Possibility to skip useless scenes.
++ Detachment from the game flow increases the objectivity.
+Cons of the method:
+– Lack of the feedback inherent to normal game-player interaction.
+– Emphasis on the mouse controls.
+When the method is recommended to use: most of time. Combine this method with the next method in order to create the full picture of the in-game possibilities.
+The next method fixes the main disadvantage of this method.
+Created with the Personal Edition of HelpNDoc: Easily create EBooks
+
+
+
+
+
+
+ Operations
+All modifications of the movie are registered in History Log. Every record of the Log contains the time when the modification was done and the keyframe (or starting and ending frames of the section) to which the modification was applied.
+Here you can find the list of all possible types of History records and corresponding operations with the movie.
+Input change + |
+Markers change + |
+Other + |
+
| + | ++ | +Initialization + |
+
| + | ++ | ++ | +
| + | ++ | +|
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | ++ | +|
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
| + | +||
Initialization
+Category: other
+The record is created automatically when new History Log is created.
+Instances:
+Example:
+20:24:53 Initialization
+Used: very rarely
+Greenzone is truncated after zeroth frame.
+Undefined
+Category: other
+Undefined modification. The record should not appear in TAS Editor 1.0.
+Used: never
+Set
+Category: Input change
+The record is created when one or more buttonpresses appear in one or several frames.
+Instances:
+Example:
+20:25:18 Set 15-21
+Used: very often
+Greenzone is truncated after the first frame where Input was changed.
+Unset
+Category: Input change
+The record is created when one or more buttonpresses disappear from one or several frames.
+Instances:
+Example:
+20:25:22 Unset 21
+Used: very often
+Greenzone is truncated after the first frame where Input was changed.
+Pattern
+Category: Input change
+The record is created when a sequence of buttonpresses changes to currently chosen pattern.
+The name of the pattern is added to the text of the record.
+Instances:
+Example:
+20:25:40 Pattern 21-30 Alternating (1010...)
+Used: rarely
+Greenzone is truncated after the first frame where Input was changed.
+Clear
+Category: Input change
+The record is created when all buttonpresses disappear from one or several frames.
+Instances:
+Example:
+20:26:51 Clear 15-20
+Used: moderately
+Greenzone is truncated after the first frame where Input was changed.
+Cut
+Category: Input change
+The record is created when all buttonpresses disappear from one or several frames, caused by "Cut" operation.
+This is identical to Clear operation, except that buttonpresses are copied to the Clipboard before clearing.
+Note: although you can undo this operation, the Clipboard contents won't revert.
+Instances:
+Example:
+20:27:05 Cut 21-23
+Used: rarely
+Greenzone is truncated after the first frame where Input was changed.
+Paste
+Category: Input change
+The record is created when a Clipboard data is pasted into the movie.
+Depending on the "Superimpose" checkbox the old Input on those frames is either erased or combined with the new Input. The Piano Roll Header briefly flashes symbols of those buttons that were added in the Paste process.
+Instances:
+Example:
+20:27:11 Paste 21
+Used: moderately/rarely
+Greenzone is truncated after the first frame where Input was changed.
+PasteInsert
+Category: Input change, Markers change
+The record is created when a Clipboard data is inserted into the movie.
+Old Input and Markers are shifted down to make place for the Input from Clipboard.
+Instances:
+Example:
+20:27:16 PasteInsert 21
+Used: rarely
+Greenzone is truncated after the first frame where Input or Lag was changed.
+Clone
+Category: Input change, Markers change
+The record is created when copies of one or several frames are inserted into the movie, shifting the following Input and Markers down.
+Instances:
+Example:
+20:27:34 Clone 23
+Used: often
+Greenzone is truncated after the first frame where Input or Lag was changed.
+Insert
+Category: Input change, Markers change
+The record is created when one or several blank frames are inserted into the movie, shifting the following Input and Markers down.
+Instances:
+Example:
+20:25:58 Insert 21
+Used: moderately
+Greenzone is truncated after the first frame where Input or Lag was changed.
+Insert#
+Category: Input change, Markers change
+The record is created when specific number of blank frames is inserted into the movie, shifting the following Input and Markers down.
+If there's Selection in the Piano Roll, this operation inserts frames before the Selection, otherwise it inserts frames before Playback cursor.
+The number of inserted frames is added to the text of the record.
+Instances:
+Example:
+20:26:09 Insert#4 29
+Used: rarely
+Greenzone is truncated after the first frame where Input or Lag was changed.
+Delete
+Category: Input change, Markers change
+The record is created when one or several frames are deleted from the movie, shifting the following Input and Markers up.
+Instances:
+Example:
+20:26:12 Delete 33
+Used: often
+Greenzone is truncated after the first frame where Input or Lag was changed.
+Truncate
+Category: Input change, Markers change
+The record is created when the tail of the movie is truncated, deleting all Input (and Markers) starting from either the Selection cursor or Playback cursor (if there's no Selection in Piano Roll).
+Instances:
+Example:
+20:26:28 Truncate 42
+Used: very rarely
+Greenzone is truncated after the frame of movie truncation.
+Record
+Category: Input change
+The record is created when emulator is recording Input using virtual gamepads.
+The new Input appears in the Playback cursor frame. Depending on the "Superimpose" checkbox the old Input the frame is either erased or combined with the new Input. The Piano Roll Header briefly flashes symbols of those buttons that were added in the Recording process.
+IDs of gamepads whose Input was changed are added to the text of the record.
+Instances:
+Example:
+20:28:01 Record(1P) 18-24
+Used: moderately
+Greenzone is truncated after the Playback cursor position.
+Import
+Category: Input change
+The record is created when an Input of another FM2/FM3 movie is imported to current project.
+Current movie Input is substituted by the Input of imported file. Markers are not changed.
+The filename of the Input source is added to the text of the record.
+Instances:
+Example:
+20:28:53 Import Battletoads-WIP1.fm2
+Used: very rarely
+Greenzone is truncated after the first frame where Input was changed.
+Bookmark0
+Bookmark1
+Bookmark2
+Bookmark3
+Bookmark4
+Bookmark5
+Bookmark6
+Bookmark7
+Bookmark8
+Bookmark9
+Category: other
+The record is created when the data of a Bookmark slot is changed.
+Re-saving a Bookmark into the same slot only works when the new Bookmark data differs from the data stored in the slot, e.g. when the Bookmark is set to another frame or when current movie Input is different from the Input stored in the slot.
+When a Bookmark is successfully saved, its Branch becomes "current branch of the movie", and emulator shows the "Branch # saved." message.
+Instances:
+Example:
+20:28:53 Bookmark1 10
+Used: often
+Greenzone is not truncated.
+Branch0 to
+Branch1 to
+Branch2 to
+Branch3 to
+Branch4 to
+Branch5 to
+Branch6 to
+Branch7 to
+Branch8 to
+Branch9 to
+Category: Input change, Markers change
+The record is created when current movie is substituted with the data of a Bookmark slot. Both Input and Markers are substituted.
+The time of the Bookmark creation is added to the text of the record, because the movie is in fact being reverted to its state at that time.
+When a Bookmark is successfully loaded, its Branch becomes "current branch of the movie", and emulator shows the "Branch # loaded." message.
+Instances:
+Example:
+20:29:02 Branch1 to 20:28:15
+Used: moderately
+Greenzone is truncated after the first frame where Input or Lag was changed.
+Marker Branch0 to
+Marker Branch1 to
+Marker Branch2 to
+Marker Branch3 to
+Marker Branch4 to
+Marker Branch5 to
+Marker Branch6 to
+Marker Branch7 to
+Marker Branch8 to
+Marker Branch9 to
+Category: Markers change
+The record is created when current movie is substituted with the data of a Bookmark slot, but new Input was identical to old Input, and only Markers were different.
+Instances:
+Example:
+20:29:33 Marker Branch1 to 20:28:15
+Used: very rarely
+Greenzone is not truncated.
+Marker Set
+Category: Markers change
+The record is created when a Marker appears on one or several frames.
+Instances:
+Example:
+20:29:47 Marker Set 15-18
+Used: often
+Greenzone is not truncated.
+Marker Remove
+Category: Markers change
+The record is created when Markers disappear from one or several frames.
+Instances:
+Example:
+20:29:52 Marker Remove 16-18
+Used: moderately
+Greenzone is not truncated.
+Marker Pattern
+Category: Markers change
+The record is created when a sequence of Markers is created using currently chosen pattern.
+The name of the pattern is added to the text of the record.
+Instances:
+Example:
+20:30:11 Marker Pattern 20-30 One Quarter (10001000...)
+Used: very rarely
+Greenzone is not truncated.
+Marker Rename
+Category: Markers change
+The record is created when Note of a Marker is changed.
+The new text of the Note is added to the text of the record.
+Instances:
+Example:
+20:31:01 Marker Rename 20 Testing...
+Used: often
+Greenzone is not truncated.
+Marker Drag
+Category: Markers change
+The record is created when moving a Marker from one frame to another.
+The old and new frame number, as well as the Note of the Marker is added to the text of the record.
+Instances:
+Example:
+20:31:08 Marker Drag 20=>15 Testing...
+Used: moderately
+Greenzone is not truncated.
+Marker Swap
+Category: Markers change
+The record is created when two Markers switch places.
+The old and new frame number of the dragged Marker, as well as its Note is added to the text of the record.
+Instances:
+Example:
+20:31:14 Marker Swap 24<=>28
+Used: rarely
+Greenzone is not truncated.
+Marker Shift
+Category: Markers change
+The record is created when an operation didn't change Input but still shifted some Markers up or down.
+Instances:
+Example:
+20:31:44 Marker Shift 21
+Used: very rarely
+Greenzone is not truncated.
+LUA Marker Set
+Category: Markers change
+The record is created when a Marker appears on a frame as a result of using taseditor.setmarker() function.
+Instances:
+Example:
+20:35:14 LUA Marker Set 0
+Used: rarely
+Greenzone is not truncated.
+LUA Marker Remove
+Category: Markers change
+The record is created when a Marker disappears from one frame as a result of using taseditor.removemarker() function.
+Instances:
+Example:
+20:36:12 LUA Marker Remove 0
+Used: rarely
+Greenzone is not truncated.
+LUA Marker Rename
+Category: Markers change
+The record is created when Note of a Marker is changed as a result of using taseditor.setnote() function.
+The new text of the Note is added to the text of the record.
+Instances:
+Example:
+20:37:03 LUA Marker Rename 0 Hello from Lua!
+Used: rarely
+Greenzone is not truncated.
+LUA Change
+Category: Input change, Markers change
+The record is created when Input or Markers were changed as a result of using taseditor.applyinputchanges() function.
+Instead of the word "Change" the operation can be named with any other text provided by the parameter of taseditor.applyinputchanges() function.
+Instances:
+Example:
+20:39:56 LUA Corruptor 10
+Used: rarely
+Greenzone is truncated after the first frame where Input or Lag was changed.
+Created with the Personal Edition of HelpNDoc: Free Kindle producer
+
+
+
+
+
+
+ Piano Roll
+
Taseditor's workspace is similar to the interface used in music-sequencing programs. Piano Roll is a table containing the most necessary data about the edited project. Users can both observe that data and edit it by mouse clicks on various cells of the table.
+If you just opened the Taseditor window you will most likely see an empty project that contains only the starting (zeroth) frame of the movie. So, before you begin any experiments, you should temporarily unpause the emulator to let the movie reach at least the title screen of the game, the point where players can already affect the game with buttons Input. By default the hotkey to pause/unpause emulator is the Pause key on the keyboard, but in Taseditor you can use middle mouse button (the wheel) instead. Try watching the running game for a couple of seconds, then again press the Pause key or make the middle-click (anywhere) to stop emulation.
+During the emulation, Piano Roll contents become filled with the information about the processed frames. Each line in the Piano Roll list is responsible for a single frame. The index number of the frame is shown at the beginning of the line, the numeration goes top-down. When the window size is not enough to display all the frames, the list gets a vertical scrollbar.
+By the color of each line you can tell the following data about the corresponding frame:
+To start adding and changing the movie Input, click cells of those columns to the right of the column with frame numbers. If you click an empty cell, a symbol corresponding to the real joypad button will appear there.
+A – A button +B – B button +S – Select button +T – Start button +U – D-pad Up +D – D-pad Down +L – D-pad Left +R – D-pad Right + |
+
|
+
If you click on an occupied cell, it will become cleared, and the corresponding button will be considered released on that frame. There is no other button states except these two: either pressed or released.
+At first it might not be very trivial to correlate these 8 symbols with plastic buttons of a real joypad, but try pressing the first player input keys (set in your emulator) while you are in Taseditor. As you tap the buttons, the corresponding letters will flash in the Piano Roll Header, and you can easily associate the columns with buttons.
+When working in Taseditor, the most of time is spent on that very process of setting and removing buttons at different frames. This way you form the sequence of button states, which is then fed to the game and reflected by actions of the game character(s). For example, if you put the letter "A" to a chosen Piano Roll cell at the middle of Super Mario Bros gameplay, Mario will perform a low jump, because a short A button press occurred in the movie. And if you set several "A" symbols in a row (vertically), Mario will do a high jump, because A was held longer.
+Every time you change the Input above the line with the Playback cursor, the light-blue cursor steps back (up in the Piano Roll) also clearing some part of the Greenzone. This happens because the change of Input leads to a change in the game events, so the game data memorized inside the Greenzone becomes irrelevant. Thus after you change Input you need to replay some frames of the movie again – either by unpausing the emulator, or by manually dragging the Playback cursor to the frame of interest – and you will see results of the latest Input changes on FCEUX screen (and also restore a part of the Greenzone).
+Besides, you can hold the right mouse button and roll the mouse wheel down to move the Playback cursor to the needed frame manually. Wheel-based navigation is the most responsive way to observe a little segment of the movie. You may use a single hand, and the mouse pointer may be anywhere, e.g. it may be left over the edited cells. Try this method, it's a very effective way to rewind back and forth. Just hold the right mouse button with one finger and roll the wheel with another finger while looking at the FCEUX window.
+In addition to single cell clicks, you can also change button states in many frames at once. For instance, if you want the R button (Right) to be pressed for 20 straight frames, you don't have to click all 20 cells. You can just click on one of them, hold the left mouse button and move the mouse cursor up or down – it will leave a trail of symbols, thus you will draw a vertical row of buttonpresses. Similarly, you can quickly erase a row of symbols by clicking the first one and moving the eraser up or down. As you may notice, erasing starts when you click an occupied cell, and drawing starts when you click an empty cell.
+Moreover, you can hold the Shift key before clicking on the Input to spread the effect of the click across all frames between the point of click and the Selection cursor. For example, you can set "R" in the first frame, then scroll the Piano Roll to the end, hold Shift and set "R" in the last frame – the R button press will appear in all frames.
+
There's one more way to mass set or mass remove buttonpresses. First, select several frames, for example, the 5th, the 10th and the 20th (to do it you have to hold Ctrl while clicking on numbers 0000005, 0000010 and 0000020). Then click on the "L" letter in the Piano Roll Header. If the selected frames didn't have the Left button symbols, they will get it. And if all of the frames had the Left button already pressed, the click will clear it.
+Later you will find a few other ways to edit the Input, but these were the main ones. At first it might look unnatural to draw buttonpresses with the mouse instead of simulating them using keyboard keys. But this discomfort feeling will disappear soon after you devote a few some days to Taseditor.
+ +When drawing the Input you've probably noticed that previously drawn letters have different color, and as you add new buttonpresses old letters change their color from orange to violet and blue, eventually becoming standard black. This is one of experimental features of Taseditor, called "Hot Changes". It was invented to unobtrusively increase TASer's awareness about recent changes. Every time you modify the Input, the latest buttonpresses receive the hottest color (bright orange), and all the previous edits cool down by one level, becoming less bright.
+Because of the coloring, even a cursory glance on the Piano Roll is enough to get the idea which buttonpresses were added just recently and which were set long ago. Also, you can see which of them were recently removed (they are replaced with a dash).
+If you don't like this feature, you can disable it, but within this Guide we'll imply that you have the "Hot Changes" enabled.
+The narrow column to the left from the column with frame numbers is not just for dragging the Playback cursor. It also displays various informational icons. The blue arrow pointer always points to the frame where the Playback cursor is now. The green arrow pointer shows where the Playback cursor was before the Input above it has changed. And the digit cards in this column indicate Bookmarks, they will be described later.
+ +The yellow marks on the numbers of some frames (frames 12 and 22 on the above picture) are called Markers. Besides the yellow color, they can be recognized by the wide font of the frame number.
+Markers are meant to facilitate the movie navigation and improve TASer's self-organization. You decide how to use them on your own: whether to put them at the beginning of each level or to mark every jump, shot or any in-game event. Essentially, by setting Markers you logically break your movie down into sections, and then you can cross the movie not just by jumping from frame to frame, but from section to section. This allows you to interpret the movie on a higher level of abstraction.
+Such structuring helps to keep a precise image of the entire movie in mind. That kind of an image exists in each TASer's mind, but usually it's rather fuzzy – we remember a rough sequence of the evens, but omit the details (because most of time they are insignificant). When TASer turns emulator off, the image starts to gradually become vague and forgotten. Thus at the next session one needs to re-watch his own movie from the beginning in order to refresh memories, figure key events, arrange priorities and, in general, mentally prepare for resumption of TASing. Sometimes this is needed even more often – depending on the complexity of the TAS. That's why it's recommended to consolidate that image by setting real Markers, not just in your mind but in actual movie.
+A Marker can be set at any frame. Unlike the Input, Markers don't affect the game events. There are several ways to set Markers:
+Example 1. Double-click on a frame number. If there was no Marker at this frame, it will appear there. If the Marker already exists, you can drag it while the left button is still held after the double-click. This way you can move any Marker to a different frame or simply dump it outside the Piano Roll, thus removing it from the movie.
+Example 2. Select one or several frames by clicking the frame number(s), then click the "Frame#" label in the Piano Roll Header. If some of the selected frames didn't have Markers, they will all become marked. If all of them were already marked, all the Markers will be removed. This way you may mass set or mass remove Markers the same way as Input.
+Example 3. Select one or several frames in the Piano Roll, right-click on any of the selected frame numbers and choose "Set Markers" or "Remove Markers" in the context menu. This is the slowest way, so the other two are more preferred.
+Any Marker operation may be undone (Ctrl + Z) anytime, just like any Input operation.
+Markers are automatically numbered by the order they are located in the movie – top-down from first to last. In the upper left corner of TAS Editor window you can see the number of the Marker that is located just above the Playback cursor in the movie (light-blue "Marker #" label). This label both informs you and serves as a button for auto-scrolling. E.g. if you left the Playback cursor in one part of the movie and scrolled the Piano Roll far from that point, you can immediately return to the light-blue cursor anytime by clicking the "Marker" label (or tapping the Shift key twice). You are definitely going to need this feature when editing large movies.
+A similar button can be found in the lower left corner of Taseditor. The "Marker #" label of a dark blue color (the same color as the Selection cursor) displays the number of the Marker located just above the Selection. If you click this label, the Piano Roll will automatically jump to Selection. This button is going to be used as often as the upper one. Its keyboard alternative is tapping the Ctrl key twice.
+It should be easy to remember that the Shift key is almost always used to control the Playback cursor, while the Ctrl key is to control the Selection cursor.
+If both Playback and Selection cursors are below the same Marker, the numbers in both corners will obviously be the same.
+Markers can do more than just divide the movie into logical parts. They may also contain text records (comments and work notes). The Marker Note is displayed right near its number. The upper edit field contains the Note of the Marker above the Playback Cursor, and the lower field shows the Note of the Marker above the Selection cursor.
+By default, every new Marker contains an empty Note. When you create a new Marker by double-click, the lower edit field automatically becomes active, because the Selection cursor points to the just marked frame. So you may quickly type any text for the Note of that Marker and then resume your work with the movie. Text changes are saved automatically.
+You can edit an old Marker Note in any of the following ways:
+When typing a Note, press Enter or just click any unrelated element of TAS Editor window to finish editing. If you changed your mind, press Esc to cancel the editing. All the controls when editing Notes are listed in the Reference.
+It is recommended to enter Notes when creating Markers, so you won't forget why the Marker was set there. This won't take much time if you set Markers by double-clicks and type laconic messages at the same second.
+Proceed to the Toolbox description
+Created with the Personal Edition of HelpNDoc: Full-featured Documentation generator
+
+
+
+
+
+
+ Program customization
+Certain useful features of Taseditor are disabled by default, because using them requires understanding of their working principles. This chapter describes all Taseditor options and settings, as well as FCEUX settings that affect your work in Taseditor.
+Settings are kept in the fceux.cfg file in emulator's main folder. If you delete this file, all settings will reset to default values when you launch FCEUX.
+First, if you've already read chapter 2 and understood the purpose of all GUI elements, you should disable pop-up tooltips (intended for newbies only). Go to "Help" submenu of Taseditor main menu and uncheck the option "Enable Tooltips". Before doing it you may want to actually read all the tooltips by pointing the mouse cursor at different elements of TAS Editor window, and thus consolidate your knowledge of the GUI. + |
+
|
+
Now open the "View" submenu.
+
The "Find Note window" brings up the window dedicated to searching text in Marker Notes. This function is useful when you're documenting your movie with Notes. It's described in the next chapter.
+Then there are several checkboxes allowing to customize the program interface. To try the customization possibilities, create a test project right now (just open Taseditor) and experiment with it.
+View -> Display Branch Screenshots
+Displays pop-up screenshots when you point mouse cursor over Bookmarks. The screenshot helps you to recall movie events saved to the Bookmark, which simplifies searching for the needed branch of the movie, as you don't have to load the Bookmark to have an idea on its contents. This way you can also quickly compare results of several alternative approaches.
+This option is enabled by default. If disabled, no screenshots will pop up on mouse hover.
+It's recommended to have it enabled, unless you're annoyed with pop-up pictures, partially obstructing the view on Piano Roll.
+ +View -> Display Branch Descriptions
+Displays pop-up descriptions when you point mouse cursor over Bookmarks. The text, as well as the screenshot, gives you additional information about the contents of the Bookmark, helping to decide whether this branch should be loaded or not.
+The description text is taken from the Marker above the frame of that Bookmark. The Marker itself may be actually removed from the working movie long ago, but if the Bookmark was created while the Marked existed, then this Marker still exists in the branch of this Bookmark. And if you load this Bookmark, the Marker will reappear on its place.
+So, when trying alternative strategies of playing through a large segment (e.g. whole level of the game), before saving every approach to a separate branch, you can make a name for the approach by setting a Marker at the Playback cursor position and typing a text message like "here I chose upper way". After that, save a Bookmark on that frame. Then you can remove the Marker together with the Input of the old approach and create next approach by applying another strategy of playing current segment. When the new approach if finished and replayed, you can again create a Marker with a Note like "here I chose lower way" and save all that to another Bookmark. After that you can save the project and, say, close Taseditor. Next day you can easily recall all pros and cons of the two strategies you tried. Each Bookmark will show you the screenshot of the bookmarked frame and the text you wrote for that Bookmark. While it can be hard to distinguish the strategies by screenshots (since both approaches end at the same event of the game), but text descriptions will make them easy to recognize.
+This option is enabled by default. If disabled, no descriptions will pop up on mouse hover.
+It's recommended to have it enabled, unless you're annoyed with pop-up text fields.
+ +View -> Enable Hot Changes
+Switches the Hot Changes feature on and off.
+Enabled by default. If disabled, all buttonpress symbols will be displayed in a standard black color. Otherwise, each symbol will have its own level of "hotness", depending on how long ago the corresponding Piano Roll cell was edited. Recently modified buttonpresses are more hot, so they are displayed by more intense shade of red. As the hotness decreases, the symbol colors become darker (more cold) and finally turn into standard black.
+
In total, Taseditor supports 15 shades of hotness + zeroth black color. When you change the state of an Input cell, it receives maximum hotness value (15), and all the previously edited cells cool down by 1. Thereby you only need a quick look at the Piano Roll to get an idea which edits were done just recently and which were done before, or long ago.
+Also, with Hot Changes you can see which buttonpresses were recently removed – instead of an empty cell there will be a dash of the corresponding color. The dash also changes its color while cooling down, and after 15 levels it finally disappears.
+The same dashes appear when you insert new frames in the movie.
+It's recommended to enable this feature to increase the usability of Taseditor. In theory it should even increase your working speed, because this way you never have to recall which actions you did a minute ago. Of course even without Hot Changes you can always remind the sequence of last actions by reverting History (making several Ctrl + Z keypresses) and then returning the movie to normal state again (making as many Ctrl + Y keypresses). But in this case you will also truncate the Greenzone. So better just leave the Hot Changes enabled.
+The only downside of this feature is that Hot Changes data will be stored in the History Log and in FM3 project file, thus increasing the occupied memory.
+ +View -> Follow undo context
+Scrolls the Piano Roll to relevant place every time you make an undo or redo. A purple pointer appears on the modified frame for a brief moment, thus drawing your attention to the movie changes.
+This option is enabled by default. If disabled, the Piano Roll won't automatically scroll to the purple pointer.
+It's recommended to have it enabled, in order to be able to backtrack undos. Usually, right after you revert an operation you want to make another edit on the same frame or nearby, so the autoscrolling is useful.
+ +View -> Follow Marker Note context
+Scrolls the Piano Roll to relevant Marker when you start editing its Note. For example, when you click the upper edit field to start editing the Note of the Marker above the Playback cursor, Piano Roll jumps to that Marker, allowing you to see its context (neighbor Markers and Input). And when you click the lower edit field (a Note above the Selection cursor), Piano Roll scrolls to the Marker above the Selection. This way you can observe the surroundings of the relevant Marker while editing its Note.
+This option is enabled by default. If disabled, the Piano Roll won't automatically scroll to the Markers.
+It's recommended to have it enabled.
+And the View settings are over. During your future work you likely won't need to change these checkboxes.
+
Now open the "Config" submenu. Options listed in this menu affect Taseditor workflow more significantly. You may need reconfiguring some of them more than once.
+ +
Config -> Set Greenzone capacity
+Defines the maximum size of the Greenzone. The Greenzone is used for easier Playback cursor navigation, allowing to instantly return to any frame that was emulated. It needs a lot of computer memory to store emulator's information and disk space for saving FM3 projects.
+The more of green and red frames there are in the Piano Roll, the more memory the Greenzone occupies. For most NES games 1 frame costs about 10 kilobytes (compressed data). So, big movie projects may take hundreds of megabytes. It affects the project loading and saving time.
+To decrease the amount of needed memory, Taseditor regularly cleans the Greenzone tail, forgetting the info about segments that are too far from from the Playback cursor.
+This cleaning doesn't mean the Greenzone becomes inaccessible (white) on those frames. That would be very inconvenient, because to replay these frames you would need to wait until the emulation runs from the beginning of the movie. To avoid such inconvenience and still free some memory from old Greenzone sections, Taseditor uses gradual rarefication of the Greenzone tail.
+This process works like shown in the picture to the right. The light-blue cursor runs down along the Piano Roll. The cursor is the head of the Greenzone. It leaves green/red lines behind, but far above it some of the lines become pale again. At first, every odd frame is cleared, then 3 of every 4, then 7 of 8, and finally 15 of 16.
+Thus the Greenzone tail contains many hollow sections. And if you decide to send emulator to a frame inside such hollow section, you'll need to wait while emulation runs to it from the nearest bright Greenzone frame. But since bright frames alternate every 2 or 4 frames, the waiting will only last a split second, so you won't likely notice the difference between jumping to a regular Greenzone frame (instant jump) and jumping to a cleared tail (instant seeking).
+By adjusting the "Set greenzone capacity" setting you can specify how many Greenzone frames (starting from its head) must stay untouched. On the picture to the right this number is 8.
+For an experiment, choose the "Set greenzone capacity" item, a dialog window will appear asking you to enter a number, type 100 and press OK. This will mean that first hundred of frames above the Playback cursor should not be cleaned. Any cursor navigation along this area will be instant, so you may drag the light-blue cursor and use rewind with maximum comfort. After the first hundred of frames the cleaning will be removing every other frame – you'll see alternation of bright and pale lines in the Piano Roll. This alternation will last for about 200 frames. The Playback cursor navigation along the area of 200 frames will also be almost instant.
+This way the Greenzone covers 100 + 200 = 300 frames, while only 100 + 100 = 200 frames are stored in memory. Then, during next 400 frames, every filled line will alternate with 3 cleared lines, and so on. In total, the Greenzone will only occupy memory needed for storing the data of 500 frames (about 5 MB), while the accessible area will be 3100 frames (about a minute).
+By default, the Greenzone capacity is 10000 frames. This should be enough for most TASes. It's recommended to TAS with no less than 1000 frames of Greenzone capacity, because the further economy would be impractical.
+The minimum number for that parameter is 1 (just for tests), the maximum number is 50000.
+ +Config -> Set max undo levels
+Specifies the maximum number of undo steps, how many times you can restore previous state of the project by pressing Ctrl + Z.
+The History Log needs a lot of computer memory and takes some disk space to save FM3 files. The whole Log is stored in project files in compressed state. The compression is done in background – when the emulator is idle, Taseditor gradually compresses new items of the History Log. Thanks to this behavior, the History Log size doesn't affect FM3 saving time much.
+With this setting you can adjust the amount of memory occupied by History Log. By default you have 100 undo levels, which means you can revert up to hundred of recent movie edits. It's not very much, because during real TASing you make lots of various edits within a small time span, as the time runs imperceptibly. If your computer has enough RAM, you can increase the "max undo levels" value up to the maximum possible number – 1000.
+ +Config -> Set Autosave period
+Specifies how many minutes the project can be left with unsaved changes.
+Taseditor has the feature of automatically saving current project to disk when user doesn't save it manually (Ctrl + S) for too long. Before Taseditor, TASers saved their movie to disk every time they saved a savestate. But Taseditor projects store much more data, and saving FM3 files can take several seconds, so it's not reasonable to resave them too often.
+The default autosave period is 15 minutes. This means, if you've made some substantial changes to the project (e.g. you edited Input, and an asterisk appeared in the TAS Editor window caption), and then didn't save project for 15 minutes, Taseditor will remind you about that or just execute autosaving itself (see "Silent autosave").
+The autosave function only works when current project already has a filename.
+Maximum possible value for this parameter is 1440 minutes (24 hours). You can disable this function by specifying 0 as an autosave period, but that's not recommended.
+The above were numeric settings of Taseditor, next go the checkboxes.
+ +Config -> Enable Greenzoning
+Controls the process of collecting data to the Greenzone.
+If the option is enabled, every new frame is saved into the Greenzone right after it has been emulated. This is intended behavior of Taseditor, so the option is enabled by default.
+Disabling this option may be useful in rare cases, for example, when running bots which need high performance. But in normal situations it's recommended to have this function enabled.
+ +Config -> Silent Autosave
+Defines the behavior of the autosave function.
+If the option is enabled, after the autosave period is over, Taseditor silently saves the project to disk under the same filename.
+If the option is disabled, after the autosave period, Taseditor brings up the "Save As" dialog, where you can confirm the saving or cancel it. In the latter case Taseditor will wait another "autosave period" of time until reminding you about the unsaved data.
+This option is enabled by default. If you want complete control over project (e.g. to prevent saving any accidental changes done while watching somebody else's fm3), disable it. But when you're TASing it's recommended to let Taseditor use silent autosave.
+ +Config -> Autofire Pattern skips Lag
+Accounts for lag when you're using patterns (Alt + clicks on Input).
+If the option is disabled, patterns appear in the Piano Roll exactly (e.g. for the "Alternating (1010...)" pattern the buttonpresses will actually alternate one after another).
+If the option is enabled, the resulting sequence of buttonpresses may differ from original pattern (lag frames will have additional gaps not present in the pattern).
+Since lag frames aren't accounted by most games, you have to skip red lines of the Piano Roll to correctly calculate the space between presses. For instance, if there must be exactly 3 blank frames between every buttonpress (pattern "10001000"), but there's also one lag frame in the middle of current segment, you have to add 1 more blank frame (100001000).
+This option is enabled by default. It's recommended to leave it enabled, because in vast majority of cases you need to skip lag frames, in order to adapt buttonpresses to how the game interprets Input.
+ +Config -> Auto-adjust Input according to Lag
+Enables automatic adjustment of Input according to changes of lag data.
+Basically, games only care about Input at green lines of the Piano Roll. It's pointless to draw any Input on red lines, because during lag frames the game doesn't poll Input. Those frames simply don't exist from the point of view of the game engine.
+When you edit Input, you change the flow of game events, and lag may appear on different frames too. If those frames previously had a meaningful Input, this Input must be shifted to the frames without lag, to allow it to affect the game.
+If this checkbox is enabled, you won't have to adjust the Input manually every time the Lag appears on different frames. Taseditor will insert an extra line at every new lag frame, thus shifting Input 1 frame down. And when an old lag frame disappears, Taseditor will remove respective frames from the movie, thus shifting Input up. As a result, you can be sure that the game will perceive your old Input correctly, no matter any Lag changes.
+Auto-adjustment operations are done by Taseditor only when you're watching (emulating) a segment, i.e. when Playback cursor runs through pale Piano Roll lines. The result of these operations is saved into the current History Log item.
+This feature is enabled by default, and it's recommended to always work with the function enabled. It significantly increases the comfort of TASing, especially when dealing with lag-heavy games.
+ +Config -> Draw Input by dragging
+Allows to draw Input by holding the left mouse button and moving the mouse cursor over the Piano Roll.
+This option is enabled by default, so you can quickly draw or erase a long line of buttonpresses.
+Drawing/erasing is usually constrained by single column, which allows user to do sweeping motions with the mouse. But if you hold the Shift key while drawing, you will be able to draw/erase Input freely (it's rather impractical, but fun).
+If you disable this option, your clicks will only set/unset single buttonpresses. It may be necessary, for example, if you have trembling hands. But otherwise enabling this feature is recommended.
+ +Config -> Combine consecutive Recordings/Draws
+Combines consecutive operations of Input Recording into single item of the History Log. Also combines all Input drawn with the same press of mouse button.
+This feature is disabled by default. So when you're recording Input, every recorded frame will create a separate item in the History Log, and you can undo changes for any frame. Also, when you're drawing Input, every new stroke will create a new History Log item, and you can undo each of them separately.
+However, in real TASing you don't need such precision of the undo. So, to save considerable amount of space in History Log, it's recommended to enable this option.
+ +Config -> Use 1P keys for all single Recordings
+Allows to record any joypad Input using only the first gamepad (1P). This function is used when you record Input traditional way using multitracking method to take turns for different players, e.g. first you record a short segment of Input for player one (1P), then record the Input for 2P and so on.
+Thanks to multitracking, you don't have to press buttons on both controllers at once. And with the "Use 1P keys for all single Recordings" option you don't even have to confugure 2P controls, because the same keys used for 1P can be used for all the rest joypads too.
+The option is enabled by default. If you disable it, emulator will use the second controller keys for recording 2P.
+It's recommended to have it enabled, in order to save the space on the keyboard.
+ +Config -> Use Input keys for Column Set
+Allows editing Input in selected frames by pressing corresponding joypad keys.
+This feature is intended to speed up the Input editing process. To mass-set/mass-unset buttonpresses in a given segment, you usually either draw with mouse, or select a range of frames and click the necessary symbol in the Piano Roll Header – the symbol flashes and the respective Input changes in all selected frames.
+With the "Use Input keys for Column Set" option you can press real keys (assigned to joypads) instead of clicking the Piano Roll Header. The result will be the same.
+The option is disabled by default. Turn it on if you mostly use the new TASing methods and don't record Input traditional way. But when you're using Recording, either disable it or just remove the Selection to avoid Input changes on the selected frames when pressing joypad buttons.
+With this feature you can record joypad buttons even when Recording is off. Put the Selection cursor to the frame you want to apply Input to, and press the needed joypad buttons.
+Multitracking mode in this case works the same way as with regular Recording. For example, if the "2P" radiobutton is chosen at the moment, pressing the key assigned to the A button will only record Input for the "A" column of the 2nd player.
+ +Config -> Bind Markers to Input
+Attaches Markers to Input. If the option is enabled, various Input editing functions will also affect Markers. For example, inserting blank frames into the movie will shift down both Input and Markers.
+Usually Markers are set to frames where certain in-game events occur. And when you improve previous result and reach the given place earlier than before, the corresponding Marker (set there after previous attempt) must point to an earlier frame now. Sometimes you have to drag such Markers manually. But thanks to the binding feature, Markers will shift themselves during Input modifications, so the manual adjustment of Markers is rarely needed.
+Detaching Markers may be necessary when you need to edit Input without shifting Markers. For example, when you need to remove a part of Input, leaving Markers intact.
+The option is on by default. It's recommended to work with attached Markers most of the time, temporarily detaching them when necessary.
+For clarification, Taseditor highlights attached Markers with a pale yellow color, and detached Markers with more bright yellow.
+ +Config -> Empty new Marker Notes
+Defines the default Notes text. If the option is set, each newly created Marker will have an empty Note. If not set, the new Marker will copy the above Marker's Note text.
+The option is enabled by default. It's recommended to left it on, and type original Notes for important Markers, thus not leaving all Notes blank.
+ +Config -> Old control scheme for Branching
+Imitates certain limitations of the traditional TASing method, particularly related to handling the Bookmarks (savestates).
+The option is disabled by default, so hotkeys F1-F10 are used to load branch of the the corresponding Bookmarks, and the numeric keys 1-10 are used for simple jumps to bookmarked frames without changing the movie.
+Besides, Input Recording is switched on with a simple press of the Toggle Read-Only hotkey.
+But if you enable this option, the controls scheme will be the same as in old emulators. Pressing F1-F10 will work depending on the Recording mode. When the Recording is off, functional keys jump to respective Bookmark frame, and when Recording is on, F1-F10 keys load the branch of the Bookmark.
+Besides, Input Recording won't work until you load some Bookmark. This behavior allows you to press the Toggle Read-Only hotkey in the middle of watching the movie, without overwriting old Input until you actually load a savestate.
+Also, there will be a red frame around the "current slot" number in the Bookmarks List. Press numeric keys 1-10 to switch the current slot.
+This option is left to help old TASers move to TASing in Taseditor. However, it's not recommended to use it, because the new controls scheme much better fits the specifics of TASing process in Taseditor.
+ +Config -> Branches restore entire Movie
+Defines the way the branch is restored when you load a Bookmark.
+The option is enabled by default, so when you're loading a Bookmark, you replace the current movie with the movie state stored in that Bookmark.
+If this option is disabled, when you're loading a Bookmark, the current movie is replaced with a truncated version of the bookmarked movie state. The movie will be truncated at the bookmarked frame, thus imitating the traditional behavior of loading a savestate: savestates only recover the part of the movie before the Playback cursor, and the rest frames (from the light-blue cursor to the movie end) aren't loaded. This makes sense when TASing traditional way, because after loading a savestate TASer usually records a new Input starting from the position of the Playback cursor, so there's no need to load the data that will be overwritten anyway. But in Taseditor the movie is edited independently from the Playback cursor position, so you can load the entire movie state from Bookmarks, without caring if the Playback cursor is in the end of the movie or it is in the middle.
+It's recommended to leave this option enabled.
+ +Config -> HUD in Branch screenshots
+Defines the way to capture screenshots when creating Bookmarks.
+If the option is on, it takes a snapshot of the whole emulator window, including icons and emulator messages, Lua output and other data placed over the game picture. If the option is disabled, Bookmarks will only capture the game output.
+The option is enabled by default. It's recommended to leave it on, in order to use Lua output and frame counter when comparing alternate approaches to playing through a segment.
+ +Config -> Autopause at the end of Movie
+Automatically stops movie playback at the last frame, unless it started playing from the last frame.
+When replaying a finished (or partially finished) movie, you usually don't want to pass over the boundary of its Input. That's why the "Autopause at the end of Movie" option is enabled by default. If you disable it, the emulator will play infinitely after the current movie Input ended, expanding the movie size until you press Pause or the middle mouse button.
+It's recommended to leave this option enabled.
+Now you are aware of all Taseditor settings, the remaining part of the chapter describes FCEUX emulator settings that may be useful for a TASer.
+If you are going to TAS traditional way, it's obligatory to set the first controller buttons to such keys that would be easy to press together with the Frame Advance hotkey. While FCEUX supports binding the virtual NES joypad to a real PC gamepad, it's recommended to use the keyboard for recording Input, in order to have fast access to Frame Advance, Frame Rewind, Pause, and to all 10 savestate slots.
+However, if you use Taseditor as intended, you won't need to use Recording too much, and even in cases when you use it (for example, when recording a test playthrough of a level), an access to functional keys isn't critical. So, you can reassign the game controls to a USB gamepad, if you have one.
+Virtual controller buttons are configured in FCEUX the following way. Choose Config -> Input in emulator main menu. In the appeared dialog, select the "Gamepad" item from the leftmost drop-down listbox (it's usually already selected). Click the left Configure button (since you need to configure the first gamepad). In the new window click the Up button, then a small window will appear, now press the keyboard key you want to set for the virtual Up button. Press that key 2nd time to confirms your choice, or just click Close. Then you need to do the same for the rest buttons of NES gamepad – Down, Left, Right, Select, Start, B, A. After you're done with the first controller buttons (Virtual Gamepad 1), you may close both windows: Gamepad and Input Configuration.
+You can check the assigned buttons while playing the game or while Taseditor is engaged – as you press them, the corresponding symbols in the Piano Roll Header will shine with green color. Besides, if you enable Input display (FCEUX: Config -> Display -> Input Display -> 2 player), FCEUX screen will show you the pressed buttons too.
+In addition to recording the regular gaming session, virtual gamepad buttons may be used to quickly set Input when editing movie (see Config -> Use Input keys for Column Set). Select a range of frames where you want to change Input and press the key you assigned to a button of the virtual gamepad.
+When you map the virtual buttons to keyboard keys, make sure none of the emulator or Taseditor hotkeys are already assigned to those keys. The full list of default hotkeys can be found in Reference.
+Some FCEUX hotkeys don't have default mapping (they're not mapped to any key yet), you can configure them this way. In the emulator main menu choose Config -> Map Hotkeys. A window listing all possible emulator hotkeys will appear. Choose the necessary hotkey, double-click it and then press the desired keyboard key.
+First of all, find the item called "Open TAS Editor" and double-click it. In the appearing window press the key that you will always use to quickly launch Taseditor.
+Second, find the item "Reload ROM or TAS Editor Project" and either remap it or remember the default combination (Ctrl + F1). This hotkey will help you quickly return to your interrupted work – just launch FCEUX, press the Reload ROM hotkey, then the aforementioned Open TAS Editor hotkey, and then again Reload ROM (this time it will work as Reload TAS Editor Project). This way you'll return to the state of your paused work in a split second.
+Then look at the hotkeys "Frame Advance" и "Frame Rewind". They are used for Playback cursor navigation. By default they are mapped to "\" and "Backspace". You can reconfigure them to more handy keys or just ignore and use just the mouse wheel for Playback cursor navigation.
+Also see the "Speed Down" and "Speed Up" hotkeys. You may consider remapping them to Numpad keys "+" and "-".
+The "Pause" и "Restore Playback" hotkeys are set to "Pause/Break" and "Spacebar" keys by default, but in most cases it's easier to use the middle mouse button instead of these hotkeys, so you can even reassign the "Spacebar" for something else if you wish.
+Finally, there is the "Cancel Seeking" hotkey ("Esc" key by default). Pressing it is the same as clicking the Taseditor progressbar – if the Playback was seeking to a target frame, the seeking will be canceled.
+Some FCEUX hotkeys don't work when Taseditor is engaged. For example, the "Open ROM" won't work – you have to load ROM before running Taseditor. This is done for mistake-proofing.
+The next chapter describes additional features of Taseditor. You may postpone reading it until you are used to main features. Anyway, now you're ready enough for productive work in Taseditor.
+Created with the Personal Edition of HelpNDoc: Write EPub books for the iPad
+
+
+
+
+
+
+ Program Interface
+This chapter describes the program interface and ways of interacting with it.
+The description uses many specific terms, so make sure you know the Glossary before starting the read. Also, it's advisable to run Taseditor right now, to be able to check everything you read in practice.
+To enter Taseditor do the following:
+When you engage Taseditor, the game is reset, and the emulator pauses. It shall stand paused as you TAS, to prevent the game from urging you on and distracting from analysis of information.
+
While TASing in Taseditor, a considerable part of the desktop is covered by the very Taseditor window. Emulator window is used for picture output, and you'd better scale it up to 2x size, so you won't miss a tiny detail even at a cursory glance. During your work you'll have to move eyes between emulator window and Taseditor window (mostly contents of the Piano Roll). So put those windows close to each other. The remaining space of the desktop can be populated with RAM Watch window, Lua console, etc.
+You can adjust the size of TAS Editor window by dragging its edges with the mouse. The size and position are automatically saved and restored at next launch.
+The window caption displays the program name ("TAS Editor") and the name of current project. If there are any unsaved changes, an asterisk is added to the end of the text. Besides, when the Input Recording mode is on, the word "Recording" appears in the window caption.
+The main menu of the program is similar to one found in text editors like Notepad.
+The File item is responsible for all file operations – creating a new TAS project, opening an existing file, saving, data importing and exporting. There's also a "Recent" sub-menu that stores direct paths to recently used projects.
+The Edit item contains functions that let you edit TAS movie like a simple text file or a table file. Most of those functions can be accessed through standard key combinations, such as Ctrl + C, Ctrl + V and others. They will be reviewed later.
+The View item allows to adjust the program appearance. Besides, here you can open the "Find Note" window, used to search text in Marker Notes. All of that will be described later. Until you study the Chapter 5 of this Guide, it's recommended to keep default preferences.
+The Config item stores the rest settings, e.g. project auto-saving timer, the number of undo levels and other features that will be described during the learning flow. Don't change those settings for now.
+Finally, the Help item contains the link to local copy of this Guide and the "About" window. Here you can also switch on/off hints (tooltips).
+To the right of the main menu there is the Pattern item, displaying the name of current pattern. Patterns are just templates for speeding up the Input creation. They will be described in Chapter 6.
+
|
+
|
+
|
+
Created with the Personal Edition of HelpNDoc: Free PDF documentation generator
+
+
+
+
+ Reference
+Terms that are used throughout this documentation
+Exhaustive review of controls
+ + +The summary of all ways to navigate a movie
+ + +The list and mini-reviews of all possible operations with a movie
+ + +Specifications of "taseditor" library of Lua functions
+Answers to some expected questions
+Abstract classification of typical issues arising when optimizing a segment for fastest time
+Created with the Personal Edition of HelpNDoc: Write eBooks for the Kindle
+
+
+
+
+
+
+ Semiautomatic TASing
+
This method further develops the ideas of the nonlinear TASing method.
+In many cases TASer needs to see the result of the Input modification immediately. Ideally, he should realize all the consequences of his decision right at the moment of making the decision. But in reality he has to spend precious time on inputting the decision and navigating with the Playback cursor to the end of the segment.
+In these cases you can leave the Playback navigation to Taseditor and just focus on editing. Taseditor will immediately react on any Input modification and display the new result.by bringing the Playback cursor to the end of the current segment.
+Since you feel the influence of every click, you build very high level of interconnection between TASer and the game. In such close interaction both TASer controls the game and the game urges TASer's actions into right direction. Of course, such high level of interdependency is not always useful, because it narrows your spectrum of thoughts, not allowing to look down on the game and apply the logic from different games and other fields of life.
+However, when the current segment is simple and all optimality factors are already known (and you only need to find the perfect combination of them), it's useful to abstract from everything else and devote full attention to going over the possible options. This way you can test a lot of approaches before you become bored with the current segment.
+The Recording mode and the "Follow cursor" checkbox should be off. The "Auto-restore last position" checkbox should be on. The "Turbo seek" checkbox can be either disabled or enabled.
+General activity:
+The main difference between this and previous method is that here the Playback cursor is generally located at the end of the current segment, and not at the beginning. Every time the Greenzone truncates, the Playback cursor seeks to the end of the segment, or rather to the frame where the segment end was before you modified the Input. If the Input modification also changed the frame of the target event, you can additionally move the light-blue cursor by mouse wheel if needed. But often there's no need for precise positioning, because you may only need to know the sequence of events occurring in the segment due to the Input modification.
+The replay of the current segment is automatically launched after every interim step of the Input modifications, even when you haven't finished the thought yet and are not ready to compare the current result to the result of the previous approach. Fortunately, when TASer is carried away by the editing process, he doesn't look at FCEUX screen and only clicks the Piano Roll, until his idea is implemented in the form of a full-fledged button combination. And when the Input is starting to become interesting, TASer pays attention to the emulator screen or the Memory Watch window.
+For example, when you need to create a jump over a pit, you first draw a long row of the R button presses, and you don't care that at the same time the FCEUX screen displays how Mario runs and falls into the pit. You just draw some A buttonpresses, then look at the emulator window and erase or draw additional A buttonpresses, thus changing the beginning and the duration of the jump while watching the trajectory of Mario sprite.
+So, the process of polishing the Input in this method is a simultaneous editing and watching the segment. TASer gets in close informational contact with the game and soon starts to think synchronously with its responses. The game starts to help TASer filter and accept decisions. As a result, you may lose impartiality of your mind and stick to obvious decisions encouraged by the game. That's why you shouldn't use this method all the time, it's recommended to alternate it with the previous one.
+As with the simple nonlinear method, you can change the speed of emulation and get different variations of the semiautomatic method:
+Turbo-seeking creates an association between two distant events (the beginning and the end of the segment). Here the association is even more efficient, because there's even less intermediaries – the seeking starts before you even release the mouse button when drawing the Input. So you see the distant result almost at the same time you change the decisive Input, even if the game normally only shows the result in a several seconds.
++A good example would be the process of searching for the first possible frame of pressing the Start button. Some games actually allow to press the button before there's even any graphics on screen. Besides, after the Start button is activated, games often meditate for some time, not giving you any information if the button worked or not. Only after a second or two you can see the changes in the scenery, thus learning the buttonpress was successful.
+In the traditional method of TASing you would need to spend 5-10 minutes on examination of approaches (searching for the very first frame), but the semiautomatic method allows to go over all the approaches much faster:
+In the same way you can search for an optimal duration of holding the A button, trying to land at certain point. Also consider using this method for quick luck manipulation in many games. The automatic turbo-seeking works best when you deal with a single factor of optimality and need to quickly test a hundred of similar approaches.
+In general, the semiautomatic method induces you to think less and experiment more. Sure, many videogames allow this way of solving tasks, but TASing requires more from you, so try not to take a fancy to the comfort of this method.
+Pros of the method:
++ Instant navigation and high speed of the working process incites to conduct more tests.
++ Constant feedback allows to adapt to the game while editing the Input, adjust your decisions and discard incorrect approaches prematurely.
++ Possibility to skip useless scenes.
+Cons of the method:
+– The insistent game feedback provokes TASer to discard some illogical but potentially advantageous approaches.
+– Emphasis on the mouse controls.
+When the method is recommended to use: when you need to polish the segment already knowing its all optimality factors. E.g. for quick resyncing of the old Input this method is better than previous. Also it may be better for making an initial playthrough of a segment.
+Now that you know the main principles of working in Taseditor, you can begin TASing your game of interest. Practice is the best teacher, so you'll only learn all intricacies of the activity by engaging in real development of your own TAS.
+After several weeks of practical TASing it's recommended to reread the 3rd and 4th chapters of this Guide, in order to understand the text on a deeper level.
+In the next chapter: tweaking the program.
+PRACTICE: Thoroughly polish the Input in the segments of your test movie. If the initial dividing appears to be wrong – just redo it on the fly. +Use only the 2nd and the 3rd method of TASing, because traditional method is obsolete. Also try using turbo when suitable. +Estimated time: 30-60 minutes. + |
+
Created with the Personal Edition of HelpNDoc: Produce Kindle eBooks easily
+
+
+
+
+
+
+ Speedrunning synopsis
+Thanks to the definite goal, creating tool-assisted speedruns is the easiest application of TASing, and relevant techniques are examined pretty well. Here you can find the summary of generic tasks emerging in the process of polishing the Input for a speedrun. Before reading this, make sure you've learned the materials in TASing Process and TASing Methodology.
+Speedrunners have to search for the shortest way of completing every segment of the game. This process of searching consists of testing a multitude of approaches for playing the segment and finally choosing the best approach. Here we will discuss only the problem of choice.
+To simplify the problem, TASers usually compare only two approaches: the new working approach and the old best approach; all other old approaches are promptly forgotten (although the interesting ones can always be saved in the Bookmarks).
+The best of all old (previously tested) approaches can be stored:
+When the new working approach is considered to be better (more optimal) than the old best approach, it's naturally assumed that it's also better than any of the old approaches, so this working approach instantly becomes the best. In the case of using Bookmarks you should re-save the new approach to the slot where the old best approach was stored. At the end of the search the contents of this Bookmark slot are loaded into the final movie.
+Optimality criteria in speedruns:
+Respectively, when you're comparing any pair of approaches you are doing one of the three:
+1. Comparing presence/absence of the event.
+ + +2. Comparing the time of occurrence.
+ + + + +3. Comparing the state of the game at the same frame.
+ + +1. Comparing presence/absence of the event.
+Choose the approach where the needed event happens / unneeded event doesn't happen. The occurrence of the event is only the first (and often easy) step in creating the Input for current segment, and next step is to try speeding up the time of the occurrence.
+The search for approaches goes on until the first successful approach is found, or until you're tired (then the event is considered to be unfeasible).
+Programming analogy: comparing two Booleans, comparing two arrays of Booleans.
++A. Most of time it's enough to simply keep in mind the fact that target event didn't occur in previous approaches. Example: finding the Start buttonpress.
++B. When the target event is complex (e.g. you plan to shoot 3 enemies simultaneously), it's recommended to save the most promising approaches into Bookmarks (e.g. an approach where you shot 2 enemies simultaneously and 3rd one shortly after), because if the target event is unfeasible, you might be satisfied with such partial success.
+2. Comparing the time of occurrence.
+Choose the approach where the target event occurs earlier. The time of occurrence is defined by the frame in which the event can be detected, while in previous frame it cannot be detected. The number of this frame is found by bringing the Playback cursor to the frame and watching the FCEUX screen (or Memory Watch) for confirming.
+The search for approaches goes on until you're tired, or until all possible types of approaches are exhausted (then the current best approach is considered to be frame perfect, until new factors are found).
+Programming analogy: comparing two Integer Numbers.
++A. For simplest segments and small subsegments it may be enough to just keep in mind current fastest frame number and compare results of all new approaches with this number. But in general it's not recommended to rely on human memory. Details: TASing Process.
++B. On simple segments you can refer to the green arrow of Taseditor. When using it you're supposed to always leave the Playback cursor at the frame of target event (which is only natural). Thus if the new frame of target event is located above the green arrow, it means the new approach is faster than previous approach. Details:TASing Methodology.
++C. On complex segments use an unbound Marker that always points at current fastest frame number in the Piano Roll. Every time you beat the old result you're supposed to manually move the Marker higher. Thus if the new frame of target event is located above the Marker, it means the new approach is faster than the old best approach. Details: Program Customization.
++D. On segments of any level of complexity it's recommended to use Bookmarks that are displayed in the icons column of the Piano Roll. Every time you beat the old result you're supposed to manually save current approach to the same Bookmark slot, replacing the old best approach stored there. Thus if the new frame of target event is located above the Bookmark icon, it means the new approach is faster than the old best approach.
+3. Comparing the state of the game at the same frame.
+Choose the approach where properties of the game are more advantageous in a whole. This type of comparison is useful when you need to evaluate compound in-game situations. For example, in Formula 1 racing you have to care both about being as fast as possible and wearing tyres as little as possible, so you need to find an optimal balance on each segment of the track instead of just simply hurrying up.
+Here the segment has defined end frame, and every new test is supposed to replay the segment up to that frame. Taseditor stores this frame number in the form of the green arrow, which automatically pauses emulation when you watch new approaches. So TASer only needs to edit Input (creating new approaches), launch replaying, wait for the stopping and evaluate the result (judging by FCEUX screen or Memory Watch).
+The search of approaches goes on until you're tired, or until all possible types of approaches are exhausted (then the current best approach is considered to be perfect, until new factors are found).
+Programming analogy: comparing two Strings, comparing two arrays of Integer Numbers.
++A. For simple segments it may be enough to just keep in mind the value of the most important property of the game state achieved in the old best approach. Every time you watch the replaying of a new approach, you can compare results of the new approach with this value. If you decide the new value is better, you have to memorize it in place of old value. Example: luck manipulation.
+When there's more than one important property, it's not recommended to rely on human memory.
++B. On complex segments and especially on gigantic segments (with the size of a whole level of the game) use Bookmarks that store alternative branches of the movie. The best approach for playing the segment is saved into one Bookmark slot and the new approach is saved into another slot. Then you can easily switch between these slots and compare values of each property of the game state. In addition, you can point the mouse cursor to respective Bookmarks to see screenshots of the game state and visually compare their properties with current image on FCEUX screen.
+To display important RAM data on screenshots you should use Lua graphical output, then Memory Watch window won't be required to judge important properties, and you will be able to successfully judge by screenshots only. Details: Program Customization.
+In the situation when some properties in the new approach are better and some others are worse you'll have to thoroughly weigh all of them (either in your mind or using a Lua-powered aggregate formula) and then decide which state of the game is better.
+Every time you beat the old result you're supposed to manually save the new approach to the same Bookmark slot, replacing the old best approach stored there.
+After finding the fastest approach of playing the segment a good TASer is expected to improve the entertainment value of the play through the segment. The optimality criteria in such activity may be very diverse, but the general requirement is to keep the same time of playing through the segment.
+Alternatively, you can postpone the entertainment improvement of the segment and proceed to the next.
+Created with the Personal Edition of HelpNDoc: Single source CHM, PDF, DOC and HTML Help creation
+
+
+
+
+ TAS Editor Inside
+This section of the documentation describes all ideas put into the Taseditor and reveals major details of the final implementation of TAS Editor 1.0. For more details check the source code of the program (in C++).
+Taseditor is an open source program and is distributed under the MIT license which allows unrestricted use. The license was chosen to encourage a modification and porting Taseditor to another platforms.
+You can download the source code of the FCEUX 2.2.0 emulator with built-in Taseditor from the official SVN repository: http://sourceforge.net/p/fceultra/code/
+To work with SVN you'll need some SVN client program, like TortoiseSVN.
+The source code of Taseditor is well-commented, and to understand the code you only need basic skills of programming in C++ under Win32 API.
+The intended functionality of the program
+The actual program architecture
+ + +The list of unobvious nuances
+ + +Taseditor project file specifications
+Created with the Personal Edition of HelpNDoc: Full-featured multi-format Help generator
+
+
+
+
+
+
+ TASing Methodology
+This chapter is dedicated to the principal activity in TASing – the way of creating an optimal Input for any given segment of the movie. TASes look so shiny exactly because of persistent manual polishing of Input. The size of the segment can be anything, criteria and factors of optimality can vary, but the method is basically one and the same: retry all sorts of approaches and choose the best one. The only question is how to do it with minimum time and effort.
+It's rather difficult to convince yourself to spend time on alternative ways to play through the segment once it's already completed and all obvious mistakes are already fixed. After achieving the current in-game goal people usually want to set another in-game goal. But you must remember that TASer's goal is different from player's goals. So try to abstract away from the game rules and not to retreat from the segment until you complete real goal, not just player's small goal.
+That's actually the most difficult part – to invent new approaches to solving one and the same task. TASers mainly consider the same approach a regular player would have used in this place of the game. That's why people mostly use evolutionary way instead of revolutionary. You keep modifying the existing basic approach, both fixing its mistakes and conducting experiments. In the process of these thoughtful modifications you enrich your knowledge base about the game, and as a result you produce an Input that isn't immediately obvious.
+Of course, sometimes you have a flash of inspiration, when a revolutionary idea leads to tremendous improvements that surpass all polishing gains. People love TASing exactly for these emotional moments. Yet it doesn't exempt you from the need to polish this new revolutionary approach using the same methods to bring it even closer to an ideal.
+Instead of reading the techniques described here you can just immediately start real TASing, so in a course of several projects you would work out your own methods. But most likely after a year of TASing you'll come to the described scheme of work.
+So, the process of creating the best Input for the segment of optimization can be basically described as a loop of fixing mistakes in previous versions of Input of the segment. A mistake is any kind of divergence from the perfect yet unknown Input. Such statement of question is very advantageous, because it means that you can gradually approach the perfect Input by making small steps that you can elaborate even without being a genius. The majority of mistakes can be successfully fixed by repeated examination and modification. That is, even when you don't have any original ideas, you can achieve a success by persistence. The successful progress motivates you to continue the work and thus prepare the ground for breakthrough ideas.
+To correct a mistake in the Input of a movie you have to:
+1. Realizing a mistake happens either when watching the movie in Read-Only mode or right when recording/editing the Input.
+Comment: Instead of detecting a tangible mistake TASers often just assume that current segment is still improvable. It's always wise to doubt the perfectness of current result and try experimenting with the Input – sometimes you indeed find unrealized possibilities. + |
+
2. The means of solving the mistake are either immediately obvious or are found experimentally. In rare cases you have to resort to calculations and comparisons. A correctly chosen segment usually encompasses all key factors of optimality. The information from previous or next segments is rarely required.
+Comment: +Sometimes while fixing one mistake we unwittingly create another mistake. In this case the optimization process would go in wrong direction, but fortunately such situations are extremely rare in TASing, because videogames are much more obvious and linear than real life, so player can find all factors and correct criterion of optimality. Taseditor additionally simplifies the process by data visualization. + |
+
3. The ability to navigate to the place of making the mistake is the essential distinction between TASing and normal speedrunning. Regular players can detect the mistake, but it's TASers who always return back to correct it.
+In traditional method of TASing the navigation may take noticeable amount of time and effort. Taseditor makes the navigation lightning fast.
+Comment: +Sometimes the place of making the mistake is located long before the segment where it is revealed. In this case you have to find the segment affecting the mistake and edit it according to the information given by the played segment. And in this case the speed of navigation is even more important. + |
+
4. Applying modifications to Input is how you make your thoughts real. The less the delay between an idea and its implementation is, the better.
+In traditional method of TASing the Input modification takes longer, because in addition to rewriting erroneous frames you also have to rewrite adjacent frames In Taseditor this is mostly not necessary.
+Comment: В +Since any Input modification entails a change in game flow, sometimes you still have to resync the old Input that follows the place of of fixing the mistake. + |
+
5. To see the outcome you need to resume playing the movie from the beginning of current segment of right from the frame of fixing the mistake. There's no need to re-check previous segments of the movie, because the mistake fixing affects only subsequent events.
+Comment: Although, when you're making an entertaining playthrough instead of a pure speedrun, after fixing a mistake (e.g. making the movement trajectory more smooth) you should ensure that this correction fits it with the general sequence of in-game events, so it's advised to rewatch some previous events together with current segment. + |
+
You have to watch current segment up to its end, that is, to the moment when the target event occurs, so that you can safely apply the optimality criterion. Because the correction may seem profitable at first but appear worse in the end.
+After evaluating the outcome the mistake is either considered to be fixed/non-existent, or you have to return to step 2 and rethink the situation.
+Before Taseditor, all mistakes (both explicit and supposed) were being fixed by creating and reloading savestates. If you're not familiar with the traditional method of TASing, here's its basic principles:
+As you see, almost everything in the traditional method of TASing is done using savestates (Bookmarks). In Taseditor some of their functions are replaced by the Greenzone and the History Log, yet Bookmarks still play important role, allowing to keep alternative branches of the movie in a single project. The Playback cursor navigation now can be done faster by either drag'n'drop or mouse wheel. In fact, now you don't need to put Playback cursor to the frame of modification, you can just scroll the Piano Roll to the place and change the Input by mouse.
+Since the Recording is less effective than direct editing, there's no more need to constantly switch modes. Now the emulator is always in Read-Only mode.
+The game is always paused, as before. But now you are seeing the outcome of your Input only when you actually want to see it. At first this may seem inconvenient (as you don't feel the habitual feedback from your keypresses), but it's actually very advantageous, because it means the higher level of independence from the game. Instead of the standard mechanism of "involvement into the gameplay" there are other mechanisms of data transmission. So in any case you will receive all needed information on how the game interprets your Input, it's just that this data stream won't continually flow into your mind, it will be delivered on command.
+And when it's really necessary, you can have an intensified feedback by switching to the third method of TASing in Taseditor.
+Let's review pros and cons of all three methods, one by one.
+The three methods of TASing in Taseditor: +
|
+
Created with the Personal Edition of HelpNDoc: Easily create Web Help sites
+
+
+
+
+
+
+ TASing Process
+TASing is about striving for an absolute perfectness. For TASers, a game is more than just an amusement, it's an interesting and complex task.
+People enjoy solving creative tasks, because it allows them to express their individuality and improve various skills. However, complicated tasks require both inventiveness and methodicalness. This Manual describes dry and methodical side of TASing, as for inventiveness – you'll have to show it yourself in real setting.
+In general, to create a perfect (or very close to perfect) playthrough of the game you have to record an imperfect walkthrough and then work on consecutive improvements of its separate parts. When every fragment of the movie is perfect, we may consider the whole TAS to be perfect as well.
+The concentration of efforts on small segments of the movie is the key to success. Every working segment has to be large enough to represent an adequate subtask, but small enough to make the task simple.
+Without such structuring an effective and comfortable TASing would not be possible. There's too many factors affecting the final result of the game, and some of those factors append or contradict each other. Human memory is not enough to keep and calculate all interconnections of the game factors within a large segment of the playthrough. Therefore, when TASers deal with long play sessions, they aren't different from regular players who are carried by the temptation to use the first observations as a base for making decisions. But regular players can get away with such carefree approach, while TASers would end up with a clearly imperfect walkthrough.
+Thus real TASing implies that segments are small. Much smaller than a single level of a typical videogame. The whole process of TASing may be portrayed like this: a man watches the recording of his own unfinished playthrough of the game, selects a small piece of the movie and throws all forces into improving it, then selects another piece and so on until the end of the game.
+Of course, it's an incomplete picture, because besides the movie editing TASers also research and experiment with the game (to expose hidden factors) and do many other things. But that's beyond the scope of this Guide.
+The skill of choosing adequate segments comes with experience. Many TASers don't even think what makes them spontaneously focus on a segment of the game and unconsciously limit the beginning and the end of current work. Some believe that they simply record the movie frame-by-frame in succession, but if you watch it from outside you can note that those repeated rerecords occur within a window of 20-200 frames, and the window goes forward the movie by making jumps (the end of previous segment becomes the beginning of next segment). Consider watching live stream videos of TASing, and you'll see certain regularities in handling savestates.
+Here we'll try to analyze the behavior, in order to learn how to define current segment limits sensibly. And then practical TASing will make you do it mechanically.
+An adequate segment (subtask) is supposed to give TASer a consistent goal and simple means to reach it.
+The goal of a segment playthrough is usually to achieve certain in-game event. For example, the goal of playing through the whole game is the event when "THE END" text appears on the screen. The goal of one level can be such event as "the value of the level counter in RAM was increased" or simply "the screen faded at the end of current level". And the goal of a small segment may be something like "the character successfully landed on the other side of the pit". These intermediate goals are defined by the context.
+Based on the goal, TASer defines the optimality criterion in mind. The criterion is the rule which let's you compare any two versions of playing through the current segment of the game. When you're TASing, it's not enough to simply reach the goal, you have to try many approaches to reaching it, and then choose the best approach of all. For example, in a speedrun the best approach to playing a segment is usually the one in which the target event occurs as early as possible. E.g. if the 1st approach to playing the segment made the event occur at frame 350, and the 2nd approach made it appear at frame 340, then the 2nd approach is better than the 1st, and the final movie should contain exactly the 2nd approach.
+There are too many means for reaching the target event. In theory, any gameplay aspect (including those not planned by developers) may help or impede the progress in some way. So, to cope with this vague multitude of possibilities you should regard all aspects of the game as optimality factors.
+
An optimality factor is an aspect of the game that directly affects optimality of playing current segment. The word "directly" implies a monotonous dependence of outcome from applying the factor. For example, on this picture there's no monotonous dependence between the distance to finish and the duration of holding Right. Pressing the same R button either makes Mario be closer to the finish, or moves him away, depending on his position.
+When people perceive such segment in a whole, it's difficult to guess the best moment to release the R button, when to press the L button and so on. So, in order to simplify the understanding of complex dependencies (and thus reveal factors), such segments should be broken into several subsegments.
+Correct statement of question usually cuts off many irrelevant possibilities. For example, regular player could wait until the difficult enemy character walks away, but in a speedrun such tactic is not considered.
+Thus even in an open-world game TASer is left with a limited set of useful actions and in-game indicators that must be followed while polishing one segment. And the less the segment is, the more limited is this set, so it's easier to find an ideal sequence of actions by going over combinations of factors.
+On the other hand, the less the segment is, the less its goal intersects with the final goal of the TAS. The final goal is to make perfect walkthrough, e.g. the fastest in the world (which means the frame counter at the end of the movie should be as low as possible). But in terms of every specific segment the goal may be completely different, sometimes even opposite (for example, to stay in bonus stage as long as possible, which then grants time saving at another point of the game). That's why in very small segments the optimality criterion is not used, and playing such micro-segment is only evaluated as a part of a full-fledged segment.
+For example, when your character is jumping over a pit and shooting enemies at the same time, every bullet release can be considered a separate subsegment (so it becomes easy to isolate such factors as "recharge timer", "max 3 bullets on screen" and so on). But then, when comparing approaches, you should compare different versions of jumping over the pit. Even if the 1st approach to jumping (which ends at the frame 350) allowed you to shoot two enemies and the 2nd approach (which ends at frame 340) allowed to shoot only single enemy, you are supposed to choose the 2nd approach, because the optimality criterion of the unbroken segment fits the final goal of the speedrun better.
+While TASing you have to maintain an optimal balance between the necessity to decrease segments in order to grasp factors and the need to increase them in order to use a relevant criterion. This skill comes with time, so don't sweat it and just rely on your intuition.
+Let's have an example when the segment is too large. In a Super Mario Bros speedrun you are expected to reach the end of World 1-1 as fast as possible, which means you have to maximize the X coordinate of the character moving from left to right. The basic premise is that at the beginning of the level the X value equals zero and at the end of the level it is one thousand. Using gamepad buttons you can influence the coordinate in various ways. +If we take the whole level from the moment X = 0 to the event X = 1000 as our working segment, we can immediately see the optimality criterion (the best approach will be the one with minimal value of the frame counter when X >= 1000), but we can't see definite factors. How exactly we're supposed to press buttons to get the X = 1000 within minimal number of frames? Well, we can apply a regular player's logic and intuition. When we press the R button, the X coordinate usually increases, and with the L button it decreases. So the most obvious decision is to hold the R button and see how many frames is needed to grow the value of X to one thousand. When testing such approach in emulator, it appears that Mario is hampered by obstacles and the X coordinate does not grow, even though the R button is held. This way a new factor comes to light – the need to jump over obstacles and pits. Using the A button Mario eventually reaches the X = 1000 event, and the optimality criterion can eliminate all alternative playthroughs where the A button presses were ill-timed (e.g. where Mario stumbled over edges of pipes, the frame counter at the end of the segment was higher). +Now the player (or rather, TASer who is stuck in player's mindset) may think that all factors are applied and the segment is perfect. But it isn't. Super Mario Bros has somewhat complex physics engine. The X coordinate is influenced by current horizontal speed, and speed is influenced by acceleration. Acceleration is affected by the B button, skidding, Mario's direction and air-ground state. There are also teleporter pipes and useful glitches like the "flagpole glitch" and so on. A lot of things to bear in mind. But human working memory can only store about 7 objects, thus some factors inevitably slip away when you're editing Input on large segment. You'd better shrink the segment to such a scale which reveals factors individually or in a small group. +If we focus on the segment from X = 0 to X = 100, the optimality criterion will be the same, but now it also becomes obvious that in the first half of the segment Mario runs slower, and in the second half he runs with constant speed which can be considered maximum. This way you begin to appreciate the acceleration factor, so you add the RAM address to Memory Watch and start analyzing possible ways to influence the acceleration. After some experiments with turning and jumping you can discover more factors. As a result, you're going to find an intricate combination of R, L, B and A buttonpresses that makes the event X = 100 occur faster than simply holding R and B. And even if the new playthrough of the segment is only several frames faster than old, it's much closer to perfectness. + |
+
Now let's take a look at another extreme. When segment is too small, its optimality criterion may contradict the final goal of the TAS. +First, if you get carried away by maximizing speed and acceleration in equal intervals between every next hundred of pixels, you may forget about the shortcut pipe, because diving into pipes resets speed value to zero, which contradicts with the goal of current segment. In short term the diving factor is disadvantageous for a speedrunner, and its long-term profit may be overlooked when you're busy with habitual actions. +In this case the segment was chosen without much foresight, and as a consequence it sprouted wrong criterion of optimality ("the frame counter at the event X = 200 must be minimal"). Here the segment should end at the moment when any Down button press will start diving animation. +Of course such mistakes are often noticed when replaying finished movie on a fresh mind, but sometimes the situation is less obvious and is only revealed after publishing. +
Second, in the same SMB game after diving into the pipe (World 1-1) you have to reach the exit to the right. It may seem necessary to start maximizing speed from the very beginning. But as you may see in the picture, within first dozen of frames it's better to hold the L button instead of R, so that Mario lands slightly aloof from the wall that needs to be jumped over. If you hold R too early, Mario will land close to the wall and will have to jump vertically, thus losing gathered speed. +This peculiarity is not so obvious when you choose optimizing the segment from the event Mario appears to the Mario lands event. The optimality criterion of such small segment will direct you to wrong sequence of buttonpresses. +Here you should choose the segment from the frame when Mario appears to the moment of overcoming the corner of the wall. +Unfortunately, even experienced TASers not always choose correct limits right away. Sometimes you have to rethink and redo, throw away results of many tests and change the scale of the segment, play the same part of the game many times again. + |
+
As you might have noticed, this document avoids measuring segments in real frames of the movie. Because actual size of segment varies from game to game and from stage to stage. Some parts of the game contain so little possibilities that they can last for more than a thousand of frames and still be easy to play and replay. By the way, some segments don't even need to be played more than once, since they are so simple that any successful playthrough is optimal (for instance, watching unskippable cutscenes between levels). And on the contrary, some stages of the game are supersaturated with events and factors, so you are going to sweat even over a dozen of frames.
+Experienced TASers regard every segment individually (although they don't think too much about it). It's bad idea to choose the next segment by the same principle as previous, this would only work well in extremely repetitive games.
+If you want, you can limit the end of current segment by a fixed frame number (e.g. set the goal to maximize the X coordinate value when the frame counter = 200). But usually it's more convenient to associate the end with some small frontier of the game (like passing over a trap or defeating another enemy) – then the goal itself is going to suggest you basic means for reaching it. The task "touch a flower as fast as possible" sounds more natural (for a gamer) than the task "at the frame 300 become as close to the flower as possible".
+In the vast majority of video games the gameplay divides into "rooms", "enemy waves" and "traps", which are always separated by short periods of relaxation. Even in constantly scrolling and open-world games the level design ensures that there are intense moments and filler intervals between them. The truth is, game designers also structure player's task into subtasks, and in some cases TASer can even borrow the prepared segmentation. Just don't forget to critically assess it and subdivide into more subsegments when needed. Though, such subdivision will naturally take place in the process of editing Input on a excessively large segment. So TASing doesn't always require intense intellectual efforts. If you're skillful and smart, most of time you can just go with the flow and enjoy TASing no less than conventional gaming.
+All this can be compared to how writers divide their books into chapters (game levels), and chapters into paragraphs and sentences (segments) in order to aid with comfortable reading and comprehending author's ideas. A regular reader (player) is satisfied with the author's subdivision, but a literary critic (TASer) needs to be able to "read between lines" by dividing text his own way.
+For example, in Super Mario Bros every group of enemies is separated by a quiet space which doesn't require any skills, and it can be light-heartedly ran over or jumped over while holding Right (granted that Mario speed is already at maximum). So you don't even need TAS tools to be perfect at these moments. These intervals are the most suitable place to set a goal – if you mark an end of the segment at such place, the optimality criterion won't contradict with final goal of TAS for sure. And usually these moments occur often enough so the segment between them is of an acceptable size.
+The division to segments was always present in TASing, but Taseditor allows to accentuate the process visually. Here you can mark the beginning and the end of a segment using Markers or Bookmarks. Thanks to the visible boundaries you won't be distracted onto adjacent Input and can focus on analyzing only closest factors.
+The frame of current segment beginning is usually chosen when watching a test playthrough of the current segment. When recording or watching such playthrough you already pick one or two key factors of optimality. So it's only logical to start the segment at the moment when these factors join into force or dramatically change the behavior. For example, at the beginning of every level you usually start a new segment, because that's the point where you regain the ability to move forward (after the cutscene between levels ends). So it's wise to set a Marker or a Bookmark at the beginning of every level, thus marking both the level boundary and the beginning of current work segment.
+And if in the process of optimizing the segment you reveal some factors that join into force earlier than current beginning of the segment, you can always adjust the chosen boundaries of the segment, or break it in two subsegments.
++The ending frame of current segment is more mobile than the frame of beginning. When you define your goal (e.g. to make the X coordinate reach the value of 50) you can mark the end of current segment by setting a Marker/Bookmark to the frame where current imperfect playthrough accomplishes this goal. Then by polishing the Input you try to reach the goal (X = 50) at an earlier frame. And if in the process of modifying and testing a new Input you discover that the goal indeed can be reached earlier, you move the closing Marker/Bookmark up (to the frame of the improved end). After that you continue testing new approaches, searching for even better one until you don't feel any more potential. In traditional TASing this is exactly how the main Bookmark (storing current best playthrough of the segment) gradually moves up.
+Well, sometimes you can indulge in laziness and avoid marking the end of current segment, instead you just keep the goal in mind and remember the number of the frame where the target event occurs in the best case so far. Such behavior is reasonable when the segment is very simple and you don't plan to redo it many times.
+Moreover, in many platformer games where the player character has constant running speed most of segments can be played optimally from the first try (you just have to hold the Right button and maybe jump over trivial obstacles). So if you don't see any obvious mistakes and don't intend to search for hidden flaws, you may as well skip the segment shaping, just proceed to next segment right away. Such simple games are especially suitable for newbie TASers, because TASing them is very similar to casual playing through videogames using savestates (when you only revise the most obvious mistakes, like falling into a pit, and ignore non-fatal roughness).
+But in complex TASes, where the mind is occupied with many optimality factors, you shouldn't hurry. To make your thought process more precise, you'd better be perfectly aware of current segment boundaries. So mark the beginning of any difficult segment with a Marker, and mark the end by setting a Bookmark every time you find an improvement (use one and the same slot). Since it's not easy to find an improvement when dealing with difficult tasks, don't expect you'll have to re-set the Bookmark too often.
+When you're confident you've found perfect solution of the segment, move to the next segment. Don't remove old Markers, since they may be useful in future, in case you begin doubting the perfectness of your decisions (e.g. after finding a new trick). The logic of movie dividing will most likely remain the same even after finding the new factor (the trick).
+Also, if in the middle of optimization process you become confident you've found perfect Input for the first half (or a third) of current segment, you can divide the segment in two and focus on optimizing the remaining section. Such situations often rise when the initially chosen segment was too large and its logical parts naturally emerged in the process of editing the Input.
+So, if you don't like to keep things organized, you can avoid Markers and Bookmarks whatsoever, working mostly in terms of fuzzy in-game concepts and imagining segments as some emotional sequences of events. Unfortunately, the data about fuzzy goals also occupies part of human working memory, and as a result you won't have enough resources to keep all optimality factors in mind. And you won't even notice how you're losing a multitude of possibilities.
+On the contrary, if you like to keep an order, it's recommended to accompany Markers with text Notes, either before, or during, or after the optimization of the current segment. For example, make up a name for the segment or put a tag. This way you document the development of the TAS during actual TASing, give an objective meaning to the Input appearing in the process. This is especially useful when TASing in co-authorship. But even when working alone, you may notice the documentation from previous levels motivates you to carry on. It only takes seconds to type that kind of texts, and then it helps not to abandon the project.
+Notes also help to better unlock the potential of tricks and bugs of the game. By writing the text you actually formalize your knowledge about the described phenomenon. When the essence of the trick is kept in your mind, you may think that you already know everything about it, and that your current TAS uses the trick the best way possible. But when you construct an objective model (a verbal description of the trick) you often find its new sides.
+It's not uncommon for TASVideos.org to see how one TASer read the description of a trick in the submission text written by another TASer and found a way to use the trick better than original author. There were also cases when author himself reads his recent submission, facepalms and urgently records an improvement.
+Making a perfect TAS can take anything from several days to several years, depending on complexity of the chosen game. Most of that time is spent on finding an ideal sequence of buttonpresses for every segment.
+Often it seems right away that current Input is already the best possible. But usually it's not so, especially if you make the conclusion judging by the external image of the emulated game instead of its internal state (Memory Watch). So it's always reasonable to suppose that current result is not perfect. If you don't see any mistakes or potential improvements at the moment, try to watch the segment together with several previous segments (e.g. watch the last half a minute of your movie), because it's possible that previous segments contain some unregistered optimality factors that have an effect on current segment. And if you still don't get any ideas, consider moving to next segment, but don't completely refuse further attempts to criticize and improve finished segments.
+Rewatch the finished part of your movie from time to time – either from the very beginning, or from the beginning of current level – and try to notice imperfections. Taseditor allows to edit Input in any part of the movie while the movie is still playing, so you can quickly test any spontaneous idea right when it comes to your mind. If the new idea appears to be unsuccessful, just undo latest changes or load the Bookmark containing the last stable state of the movie.
++And if the new idea in fact improves you TAS, after a joyful anticipation you have to ensure that all the following segments of Input sync to the game (because implementing the idea has changed the flow of the game). Most of time it's not necessary to redo all the following Input. Usually you only have to delete or insert a few frames (thus shifting all following segments up or down), or modify several segments between the place of implementing the new idea and the nearest checkpoint (the end of current level, etc). Checkpoints usually reset many in-game properties to default value (e.g. they require you to walk over specific platform, thus equalizing the Y coordinate), so after the checkpoint you old Input will sync with new timeline of the game once you adjust it to match the flow of game events.
+Anyway, even in cases when you have to redo considerable parts of the movie, resyincing is much easier than TASing from zero ground, because now you know the best approach for each segment and only have to match your previous results. And sometimes you can even excel them, because, when you're doing these forced modifications in order to resync old Input, you still possess TASer's critical thinking, so you may notice another mistake or unimplemented idea by the way.
+Sometimes it's like a snowslide – as the trouble grows, so grows the thrill of all the discoveries. Many ingenious speedrun overtakes were made because of noticing a small improvement in the middle of the movie, which then forced TASer to re-record the remaining half of the movie (in order to resync it using traditional method) and stumble upon new discoveries in the process. And then these new tricks appear to be useful in the first level of the game! Since the game has single engine, a trick that works in one level may be applied in another, where the similar conditions are met. Even if some conditions aren't met, sometimes you can create them by losing something less important. In the end, as the movie gets rewritten many times, the small improvement rises into large-scale progress.
+You should learn not to feel sorry when you have to throw away results of your hard work. In TASing you're expected to reconsider even polished parts of the movie from time to time. The traditional method of TASing quickly makes you accustomed to inevitable losses of time, because any inattention or slipped finger requires you to rerecord part of current segment. Taseditor averts such minor losses, but doesn't change the fact that you have to retry new approaches after finding new optimality factors.
+For example, when polishing the Input near the end of World 1-3, you've suddenly found a new trick allowing you to get a mushroom, and it also appears to work in the World 1-1. Now you have to redo both 1-1, 1-3 and even 1-2, because you now play World 1-2 with big Mario. Of course, TASing the same levels second time is easier, but the fact of wasted time may dispirit you at first. Sometimes it may seem that fixing the old mistake is not worth spending additional time. At this point you'd better stop thinking too much and just choose one of the two options – either immediately start fixing, or postpone it for an indefinite period (and leave the Marker with a note describing the issue). If at the end of the project you accumulate a critical mass of such postponed plans, the movie should be called a "test run" and probably also published, at least as a WIP (work in progress). Then take some considerable rest until you feel like redoing the TAS (making an improvement).
+Despite all the difficulties, TASing can bring enjoyment both to viewers and authors. TASes are made by people who consider this kind of work to be balanced by the excitement from intermediate and final results. In many senses TASing is similar to a special meta-videogame with a unique gameplay mechanic. And until games bring fun, people play them no matter how hardcore they are.
+In the next chapter: descriptions of Input optimization methods.
+PRACTICE: Watch the imperfect playthrough of the 1st level that you made in previous chapter, and divide it into segments using Markers and your own discretion. If the movie is rather long, no need to structure it all, you just have to feel the principles. +Estimated time: 5-10 minutes. + |
+
Created with the Personal Edition of HelpNDoc: Free help authoring environment
+
+
+ TAS Editor 1.0
+Welcome to the TAS Editor Manual!
+Taseditor is an Integrated development environment dedicated to TASing. +Playing videogames in Taseditor resembles both interactive programming and drawing notes by mouse in a music editor. + |
+
| + | ++ | ++ | +
If you're seeing the Manual for the first time, please study this whole course + |
+Look here when you need to know comprehensive specifications about limits and possibilities of TAS Editor + |
+Read these docs when you wish to learn details of the system + |
+
| + + + + + + | ++ + + + + + + | ++ + + + | +
Author of TAS Editor v1.0: AnS
+Assistance in testing: feos
+Author of this Manual: AnS
+English translation: AnS, feos
+Created with the Personal Edition of HelpNDoc: Free HTML Help documentation generator
+
+
+
+
+
+
+ Toolbox
+
The Toolbox consists of 7 sections:
+
The top section is allotted to the Playback controls. The Playback is the component of Taseditor dedicated to handle the game emulation: keep it paused, replay in any direction, rewind to desired frame and so on. It allows to treat video games as straightforwardly as if they were regular video recordings, disregarding the interactivity element inherent to them.
+There are 5 buttons at the top of the window.
+The "||" button (pause/resume) is simple graphical analog of the Pause Emulation hotkey. When you click it, the game emulation either pauses or resumes. However, if your mouse has a middle button, it's easier to press it instead of clicking the "||" button, in this case you won't need to move the mouse cursor to the Playback section.
+The ">" button (step forward / advance 1 frame) moves the light-blue cursor 1 frame down, forcing FCEUX to emulate one frame if necessary. You can either click that button or click and hold it to make several steps forward. This button's keyboard analog is Shift + Down. If your mouse has a wheel, it's easier to hold the right mouse button and scroll the wheel 1 step down instead of using the ">" button.
+The "<" button (step back / rewind 1 frame) moves the Playback cursor 1 frame up, displaying the previous frame's events in the FCEUX window. You can hold the button as well, when you wish to go several frames back. This button has its hotkey Frame Rewind (mapped to Backspace key by default), and has a keyboard analog: Shift + Up. If your mouse has a wheel, it's easier to hold the right mouse button and scroll the wheel 1 step up instead of using "<" button.
+The "<<" button (fast rewind) also moves the Playback cursor back, just not by 1 frame but by multiple frames at once. This button moves the light-blue cursor to the frame where the nearest upper Marker is located. In the above picture, if you press the "<<", the light-blue cursor will jump to frame 12 (where the Marker 1 is set). Using this button you may quickly go back to the beginning of the edited segment or to any other past moment of the movie. The keyboard analog for this button is Shift + Page Up. You can also hold it – the light-blue cursor will rapidly jump on Markers up in the Piano Roll, and in the meantime you can look for the desired fragment of the movie by watching FCEUX screen.
+The ">>" button (fast forward) jumps on Markers forward. In the above picture, if you press the ">>", the light-blue cursor will jump to frame 22 (where the Marker 2 is located). With this button you can rapidly skip to the game events forward in the movie. But in case the next Marker is out of the Greenzone range, emulator would need some time to process the unknown frames, so such jump may take some time. This button's keyboard analog is Shift + Page Down. You can click and hold this button as well.
+As an experiment, try to make a test movie of about 1000 frames in size and set a dozen of Markers, one per every 30-50 frames. Then hold Shift and tap some Page Up / Page Down keys to feel the convenience of the fast scrolling. Alternatively you can roll the mouse wheel while holding the Shift key.
+ +Below these 5 buttons you can see a progress bar and three checkboxes.
+The Progress bar helps to estimate the time needed for Playback seeking. Immediate jumps to any frame are only possible after FCEUX emulated the game up to the target frame by applying your movie as a game Input to get the actual game state for the frame. After the actual game state was rendered at least once, it is saved into the Greenzone, so next time the emulator can instantly jump to that frame, granted that Input above the frame didn't change. If the Input was changed, a new emulation attempt is required, because even the smallest change in buttonpresses may cause serious changes in the gameplay chronology. Thus after every such change the Greenzone is automatically truncated, removing the data of all those frames that might be affected by the new Input. These frames must be emulated again, and it takes some time.
+So, when you send the Playback cursor to a frame far from the Greenzone, instead of immediate jump the light-blue cursor starts seeking to that frame. A shadow of the light-blue cursor will be blinking at the target line of the Piano Roll, and the game images on the FCEUX screen will rapidly change as the Playback cursor runs to the target.
+In this case you'll have to wait. The seek time depends on the distance between the target frame and the end of the Greenzone, on your computer power and a few other factors. The progress bar helps to estimate the waiting time. If you don't want to wait, left-click on the progress bar (in addition to being an indicator, it's also a button) or use the Cancel Seeking hotkey (Esc by default). Then the target frame will quit blinking, the light-blue cursor will stop and the emulation will be paused.
+While Playback is seeking you may change the target by clicking on the desired frame row in the icons column of the Piano Roll. If you pause the emulator during seeking, the light-blue cursor will freeze and the target frame blinking will slow down, but the seeking won't be cancelled – when you unpause, the Playback cursor will continue running to the target and stop automatically after hitting it.
+Progress bar is also used when loading and saving Taseditor project files to disk.
+ +The "Turbo seek" checkbox allows to change the seeking speed. When the Turbo is on, FCEUX emulates the game on the highest speed possible, reducing the seeking time tenfold. So, if you seek to a distant frame, check that option. But during the TASing process its often necessary to see all the intermediate frames, not just the last one. In such cases you should uncheck the checkbox and maybe even slow down the emulation with the - and = hotkeys to ensure you're not missing any important detail of the gameplay.
+The "Follow cursor" checkbox forces the Piano Roll to follow the movement of the Playback cursor and autoscroll the view so that the light-blue cursor is always visible. This allows you to observe the Input played back when the emulator is unpaused. But when you edit the movie you should uncheck this option to prevent the Piano Roll from running away from the edited spot.
+The "Auto-restore last position" checkbox makes the Playback automatically start seeking when the Playback cursor was moved back by the Greenzone. Every time you change an Input, the Greenzone is truncated after the first changed frame, forgetting old events that became irrelevant after that change. The Playback cursor must always be inside the Greenzone, so it steps back along with it. With the auto-restore checkbox you can instantly see new events on these frames. When the checkbox is checked, any Input modification triggers the replaying of the changed segment, helping you to compare different scenarios of the game events.
+Thanks to auto-restore TASers can focus on Input editing and rapidly go over many approaches to playing current segment of the movie. This method of TASing will be described later.
+
Below the Playback you can find the Recorder section. The Recorder is used to record buttons Input from keyboard (or gamepad) into the movie, just like in regular playing using any emulator.
+The "Recording" checkbox turns the Recording mode on and off. Before you start recording any physical keypresses, make sure the Playback cursor is on the frame you want to record from. Then either press the "Toggle Read-only" hotkey (Q key by default), or click the Recording checkbox. The word "Recording" will appear in the TAS Editor window caption, and the message "Movie is now Read+Write" will appear on the FCEUX screen. Now you can either unpause the emulator and play the game normally, or type the buttons frame-by-frame using the Frame Advance hotkey. As the playback goes forward, the movie will fill with the data on the buttons you press.
+You may rerecord the same segment of the movie multiple times, overwriting the old button log with new buttonpresses data. If you don't like how a segment was played (e.g. the character fell into a pit), put the Playback cursor before the frame where you made wrong buttonpresses (e.g. the A button was pressed too late) and resume Recording, this time pressing buttons properly.
+When the segment is ready, turn the Recording mode off to prevent accidental erasing of the Input when replaying the movie. Uncheck the checkbox by mouse click or via the hotkey. When TASing in Taseditor, the Recording checkbox is usually unchecked, because direct Input editing is preferred to Recording.
+It's recommended to rationally combine the Recorder features with those of the Piano Roll. For long and easy segments of the game it may be convenient to record buttonpresses from the keyboard or a handy USB-gamepad, but for small dislocated edits the mouse is way better.
+ +The "Superimpose" checkbox in the Recorder section allows to combine the existing Input with the newly recorded data on the same segment of the movie. For example, you can draw the R buttonpresses on rather long segment with a single mouse stroke, to make the character run right. Then you can enable the "Superimpose" option, turn on Recording and play the game by pressing only jump and shoot buttons, without the need to hold Right. The character in the game will still run right, jumping and shooting on command.
+Unlike other checkboxes, the "Superimpose" option has three possible states. In addition to "enabled" and "disabled" it can also be in an interim state between these two. The third state works like this: when the player presses some gamepad buttons during Recording, these buttons are recorded in place of old Input. But if the player presses no buttons during Recording, the old Input on these frames is not overwritten.
+ +The "Use pattern" checkbox applies current pattern to the process of buttons Recording. The name of the current pattern can be seen in the upper right corner of TAS Editor window (the last item of the main menu). If you click this menu item, a pop-down menu will appear, allowing you to choose another pattern from the list.
+Patterns are used to speed up the process of entering monotonous buttonpresses and releases. For example, when you need to shoot at maximum rate (that is, alternate 1 frame of pressing B and 1 frame when B is released), you can just choose the "Alternating (1010...)" pattern and hold the B button without caring about manual mashing. Thanks to the pattern, the B buttonpresses will be recorded only for every other frame.
+ +Besides the checkboxes the Recorder section also contains radio buttons that implement the multitracking feature.
+Multitrack Recording greatly simplifies the traditional method of TASing games made for 2 or more players. Instead of pressing buttons of both gamepads at once, you can record a short segment of controlling the Player 1 and then record actions of Player 2 on the same segment of the movie.
+By default the Recorder is set to recording "All" pads. You can choose a single pad by clicking the respective radio button ("1P", "2P", etc – the number of available gamepads depends on your project type). You can also use the "Switch current Multitracking mode" hotkey (W key by default). Now during the Recording the emulator will accept only the chosen player's buttonpresses, and the Piano Roll columns for other pads won't change even if you accidentally press another player's buttons.
+
The Splicer section comes after the Recorder. It's dedicated to displaying the most necessary data used in non-linear editing of the movie.
+Despite the similar sounding, editing TASes is totally different from using a non-linear video editing software, because Taseditor only allows you to edit Input, not the finished video footage (Output). The resulting video stream is built by the game itself.
+In this section you can see the information on current Selection size: how many rows and columns are covered. With this info you can use the Selection as a measuring scale (ruler). E.g. to find the temporal distance between two in-game events, click the frame of the first event and stretch the Selection to the frame of another – all those frames will be selected, and in the Splicer section the message "Selection: N rows, M columns" will tell you the number of frames in question.
+Also, here is the info about the Clipboard contents: whether it contains an Input that could be pasted to any place in the movie. When an Input is copied to the Clipboard, this line displays total amount of frames copied. The Clipboard data is stored independently of Taseditor, and it's kept there even after you close FCEUX, until some other application copies its own data to the Clipboard.
+The "Splicer" section has no controls, because all Input splicing commands are kept in the Edit menu item and are assigned with accelerator keys. In actual TASing process it's recommended to use the keyboard combinations, because they're easy to remember and the working speed increases immensely.
+ +The list of all Editing functions
+Basically, these are the standard functions of any text editor, but in Taseditor they can be applied to Input in the middle of emulation, which allows to analyze the results on the fly and flexibly tune your plans.
+When TASing in Taseditor you're going to most often use Ctrl + Delete (Delete Frames) and Ctrl + Insert (Clone Frames) to quickly move edited segments up/down in the frame list, thus performing certain in-game actions sooner or later.
+Unlike FCEUX hotkeys, these key combinations can't be reassigned, so if you have some other emulator functions assigned to Ctrl, Insert or Delete, you'll have to change emulator settings.
+
Under the Splicer you can see a small Lua section.
+There is one inactive button and one checkbox here, their purpose will be described later. While you're not familiar with Lua scripting, you won't need this section.
+The Lua scripting language allows to automate some part of TASers' work and to create your own plug-ins for Taseditor.
+
Then goes the Bookmarks/Branches section. We should speak of Bookmarks at a greater length here.
+Bookmarks are the evolution of emulator savestates. Before Taseditor the savestates were the main way to navigate the movie, with their help TASers return back to the place of a mistake and fix it. In Taseditor there are better navigation methods, but this one was left too.
+You have 10 slots for Bookmarks in your disposal. These are numbered with digits from 0 to 9. You can set any of 10 Bookmarks to any movie frame, pointing to that frame with the Playback cursor beforehand.
+Example 1. Set the light-blue cursor to the frame you want a Bookmark at, and make an emulator savestate (Shift + F1-F10 by default). For example, press Shift + F1 to set the first Bookmark. It will appear in the Bookmarks List, flashing one time with the red light.
+Example 2. Set the light-blue cursor to the needed frame and right-click on any line in the Bookmarks List. For example, right-click on the line 2 to create the Bookmark in slot 2.
+You can undo the Bookmark set operations with Ctrl + Z.
+The Bookmarks List displays the frame number where each Bookmark is sat, and the real time of setting the Bookmark. If you hover the mouse cursor over a Bookmark's time (the right column in the List), you'll see the screenshot from the game.
+When setting a Bookmark, Taseditor saves to the chosen slot the data about the Playback cursor position and entire movie contents. Now at any time you can either make a "spatial jump to the Bookmark" (simply returning the Playback cursor to the bookmarked place), or make a "temporal jump to the Bookmark", returning the whole movie to the state saved in the Bookmark slot.
+To jump to a Bookmark in space, left-click on the left half of the needed Bookmark (the pale-colored half of the Bookmarks List where the frame number is displayed). Or use the keyboard – press the corresponding number key (numeric keys 0-9 are under the F1-F10 keys). You can notice the jump by seeing the light-blue cursor movement in the Piano Roll and by green flash in the Bookmarks List.
+To jump to a Bookmark in time, left-click on the right half of the needed Bookmark (the brighter-colored half of the Bookmark List where the time is displayed). Or load the corresponding emulator savestate (keys F1-F10 by default). If any Input was changed during this jump in time (since it returns to its state at the time of creating the Bookmark), the Bookmark flashes with blue color, otherwise it flashes green, like in a simple Playback cursor jump. As usual, when an Input changes, the Greenzone truncates automatically. And of course you can undo the change using Ctrl + Z to revert the movie to its state before the time jump to the Bookmark.
+So, part of the Bookmarks may be used to speed up your movie navigation. For example, set a Bookmark at the beginning of current game level to be able to return the Playback cursor to that frame and replay the level events anytime. You could use a Marker for the same purpose, but the advantage of the Bookmarks is that you can instantly jump to a Bookmark from any remote segment of the movie, no matter how many Markers are set in between, while to reach the desired Marker you would have to jump on the neighbor Markers.
+Another part of the Bookmarks can be used to store alternative approaches to playing the same game segment. When TASing complex games we can't always immediately evaluate the optimality of a playing strategy. Sometimes TASer needs to record several different versions of playing the same segment and then carefully compare the resulting movies, choosing the most appropriate one to be left in the final TAS.
+In traditional TASing every such movie is kept in separate file, so to switch between the alternative movies (or rather between alternative branches of your main movie) you need to load corresponding savestates created when recording these playthroughs.
+
In Taseditor all saved branches of the movie are held together, forming the hierarchy called the Branches Tree. To switch between the alternative branches you need to load the corresponding Bookmark, thus returning the working movie to one of the prepared versions. Basically, it's the same as before. But now we can visualize all alternative playthroughs in a graph scheme to facilitate TASer's comprehension of the multitude of options.
+When you test a couple of approaches to playing the 2nd level of the game, the 1st level playthrough remains the same in both branches, so the discrepancy of the Input starts not from the beginning, but from the 2nd level. So, if you left the Bookmark 1 before the beginning of the 2nd level, you'll see the fork in the graph starting from the card 1.
+As an experiment, create a new project and make a very short movie. Then set the Playback cursor to the end of existing Input and save a Bookmark into the first slot (Shift + F1). Advance a few frames after that Bookmark and draw some buttonpresses, then play this new Input and save to Bookmark 2 (Shift + F2). Now return the movie to the first Bookmark state (press F1) and add some buttonpresses after the bookmarked frame again, but make sure they are different from the last time. Play this new Input to the end and save the 3rd Bookmark (Shift + F3) or any other.
+Now click on the header of the Bookmarks section ("Bookmarks/Branches" label). The Bookmarks List view will change to the Branches Tree view. If the third Bookmark movie differs from the second Bookmark movie, and the difference starts after the first Bookmark frame, you'll see the picture similar to the above. The cloudlet symbolizes the beginning of the movie (the root of the hierarchy). Bookmarks are presented with cards of corresponding numbers. The blue-colored number stands for the current Bookmark containing the branch that corresponds to working movie (currently displayed in the Piano Roll). If the working movie was changed after saving/loading this Bookmark, you'll see the fireball descending from the current Bookmark.
+Red lines connect those Bookmarks that are compatible with the chronology of current working movie. For example, if you set one Bookmark at the end of every level, all such Bookmarks will be sitting on one red line, because the movie of every next Bookmark is actually composed from the movie of previous Bookmark plus an additional level playthrough.
+The Branches Tree also displays current Playback cursor position. Try dragging the cursor in the Piano Roll up and down, or just play the whole movie back (press Shift + Home and unpause the emulator). You will see how the light-blue arrow pointer rides on red lines that connect all Bookmarks of the current timeline. E.g. if the current branch is the Bookmark 2, the pointer will ride that route: "cloudlet -> Bookmark 1 -> Bookmark 2". And the other Bookmarks will be left aside, because they represent an alternative timeline, conflicting with the currently played movie.
+The Branches Tree is automatically rebuilt each time you create a new Bookmark or change an existing Bookmark's contents. Depending on how complex your project is, the graph may appear differently.
+
|
+
|
+
|
+
|
+
|
+
|
+
You can hover the mouse cursor over any Bookmark number to see some info about it.
+Also you can make a single left-click on any Bookmark card to send the Playback cursor to the bookmarked frame (spatial jump). By clicking the cloudlet you send the Playback cursor to the beginning of the movie (equal to pressing Shift + Home), and by clicking the fireball you send the Playback cursor to the end of the movie (equal to Shift + End).
+Besides, you can double-click a Bookmark by the left mouse button to jump to the Bookmark in time. The working movie reverts to the Bookmark's state, the Bookmark becomes current branch and the Playback cursor moves to the Bookmark frame.
+Finally, you can right-click any card to save the current movie state and the Playback cursor position to the chosen Bookmark.
+As you see, the Branches Tree view supports the same functionality as the Bookmarks List view does. Thus it's recommended for advanced users to stick to the Branch Tree view, because it provides more info for a TASer. When you want to switch back to the Bookmarks List view, click the section header again (the "Branches" label).
+Now try using all 10 available slots. Each time slightly change the current movie Input and watch the changes on the FCEUX screen before saving them to a Bookmark. The position of each card on the Tree is defined by the Input preceding the bookmarked frame. It's implied that TASer always watches the edited Input segment in the emulator, and only then saves the tested work into a Bookmark.
+In hands of an experienced TASer Bookmarks become very powerful tool, allowing to greatly simplify the TASing process and implement ideas that look impossible. Usually, an idea is labeled "impossible" only due to its monstrous unbounded complexity. But lower the complexity a hundred times (with the help of tools and a smart process organization), and the achievement moves from the "impossible" category to just "hard" one.
+
The History section is located below the Bookmarks.
+Taseditor keeps strict accounting of all operations in the current project. Every user's action that changes an Input, Markers or Bookmarks is recorded to the log displayed in this section.
+The current item of the History Log is highlighted blue. Other items have white background if they aren't related to the current item, or purple background if they represent the changes made in the same place as the current item. For example, if current History Log item was created by changing the Input of frame 27, all other items affecting that frame will be highlighted purple.
+To undo logged operations you can either use the Ctrl + Z and Ctrl + Y keys, or simply click any line in the History Log with the left mouse button, thus returning the movie to the time when the clicked item was created.
+You may notice the purple cursor line appearing in the Piano Roll for a short moment. It's supposed to stress your attention on the place of the undone changes.
+The maximum number of undo levels can be set in the Config menu, that value defines the maximum size of the History Log and therefore the amount of used memory.
+The full list of all possible records in the History Log can be found in the Reference.
+
At the very bottom of the Toolbox there are 4 buttons controlling the Selection cursor.
+The meaning of the "<<" and ">>" buttons can be easily guessed by analogy with the upper "<<" and ">>" buttons in the Playback section. The upper part of TAS Editor window contains the Playback cursor-related elements, and the lower window part contains Selection cursor-related elements.
+The "<<" button (jump back) moves the Selection cursor to the frame where the nearest upper Marker is located. In the above picture it will jump from frame 27 to frame 22 where the Marker 2 is set. Using this button you can quickly return the selection to the beginning of the edited segment or to any marked segment. This button has its keyboard analog: Ctrl + Page Up. You can hold this button to let the dark-blue cursor rapidly jump on Markers up in the Piano Roll.
+The ">>" button (jump forward) moves the Selection cursor to the nearest marked frame below it. In the above picture it will jump from frame 27 to a frame outside the visible area (where the next Marker is set), and Piano Roll will automatically scroll after the Selection cursor. Using this button you can quickly navigate down through the movie. This button has its keyboard analog: Ctrl + Page Down. You can hold this button as well.
+Since the Selection cursor isn't tied to the game emulation, its jumps on Markers always happen instantly, regardless of the Greenzone presence on the target frame. So it's useful to read the Marker Notes one by one this way, watching them in the lower edit field and pressing Ctrl + Page Down to make an instant jump to the next Note. Besides Page Up / Page Down keys you can roll the mouse wheel while holding the Ctrl key.
+The buttons "Similar" and "More" are used for searching similar Notes. This is another experimental feature of Taseditor, and it will be described later.
+Now you are familiar with fundamental principles of the program usage.
+In the next chapter: systematic approach to TASing.
+PRACTICE: Beat the World 1-1 in Super Mario Bros (or any other game) using only the mouse, without Recording. +No need to do a speedrun, just make yourself familiar with the routine of Input drawing / erasing and watching the results using the mouse wheel / middle mouse button. +Estimated time: 20-30 minutes. + |
+
Created with the Personal Edition of HelpNDoc: Easily create Help documents
+
+
+
+
+
+
+ Traditional TASing
+
This method is similar in form to normal videogames playing, however it is completely different in content and requires different way of thinking.
+Editing Input is done here by recording a new Input over existing Input.
+To switch between movie watching and editing you have to turn the Recording mode on and off (default hotkey is Q). It's recommended to enable the "Follow cursor" checkbox, in order to observe the recorded Input in the Piano Roll.
+General activity:
+When you're making a test playthrough of the game (i.e. playing with savestates, but without polishing), you only do steps 3 – 5. And you are satisfied with any successful accomplishment of a segment, so after reaching the target for the first time you proceed to the next segment right away. In this kind of playing you only use savestates to speed up navigation in case you make a fatal mistake (e.g. didn't press the A button in time and fell into the pit), because you don't want to rewrite existing Input from the very beginning of the game.
+But when you're seriously TASing the game, you need to try many different approaches in order to find the best one. So you have to repeat steps 2 – 8 many times, until you think the segment is played perfectly. The steps 6 – 9 are what distinguishes real TASing from casual playing with savestates.
+The process of Input Recording (step 4) means that you're editing the Input right while watching the results. That is, when watching the game state at the frame 200 you prepare the Input for the frame 201 (lay fingers on necessary buttons) and then pass the Input to the game using Frame Advance, and immediately see the outcome – the game state at the frame 201 (granted that you look at the Memory Watch, because the game screen rendering is one frame behind). Usually this outcome is only an intermediate result, which means you can use it to estimate your progress (step 5) but should not use it to compare current and previous approaches of playing the segment (step 7). So you shouldn't apply the optimality criterion after every frame. Even if at the beginning of the segment you outrun the previous approach, you may fall behind somewhere in the middle. Only when you reach the end of the segment (step 6) you get an objective base for comparing.
+Steps 3 and 4 take the most of time in this cycle. Often before reaching the target event you have to repeat steps 3, 5 and 5 several times in a row, recording and discarding decisions that are obviously wrong even without comparing them to old approaches. For example, if in the middle of acceleration Mario gets killed by an enemy, there's no point in entering the remaining buttons needed for acceleration. You have to return back and rewrite the Input in such a way that the enemy misses. In a tough situation it's even better to break current segment into two subsegments (before and after the interaction with the enemy), in order to optimize them separately. If you don't do so, you will probably become tired after finishing the first approach, and you'll decide to leave the segment as it is. See, you've got to manage your effort optimally as well!
+ +Since the Input editing in this method is done using the Playback cursor (and not the mouse cursor), for an effective work you must learn to quickly deliver the light-blue cursor to any frame necessary. Upon gaining an experience, TASers accustom themselves to "juggle" with Bookmarks using the motor memory. They mechanically create intermediate and auxillary Bookmarks while recording the Input, and find the necessary Bookmark slot without looking.
+This virtuosity comes with time, usually after having finished a couple of TASes. You cultivate certain habits, one finger adheres to Frame Advance, Bookmark slots become logically distributed according to their duties, so that fingers press right keys at right moments. For example, that's how some TASers distribute 10 slots:
+
This skill is very similar to the skill of playing a musical instrument. The quicker you work it out, the better, because until you master it you will think the traditional TASing is too tiresome. That's why many people consider the bar to be too high. But once you master the technique of rapid savestates usage, other intricacies of TASing will come easier.
+However, now there is Taseditor. It revokes the need to train fingers, allowing to quickly navigate the movie without using Bookmarks. Also, you don't need to accustom to constant backups into F1, since there is the History Log. So technically you can forget about the traditional method and right away start editing the movie and testing approaches using the nonlinear method of TASing.
+Anyway, Taseditor slightly expands possibilities of the traditional method:
+Pros of the method:
++ The process is intuitive for any gamer.
++ Constant feedback allows to adapt to the game while editing the Input, adjust your decisions and discard incorrect approaches prematurely.
++ The boundaries of current segment are always marked with Bookmarks (for navigation), thus training TASer to be orderly.
+Cons of the method:
+– The insistent game feedback provokes TASer to discard some illogical but potentially advantageous approaches.
+– Slow navigation may distract and increase fatigability.
+– Since the number of Bookmarks is limited, the markings of previous segments are lost when creating a new segment, so you have to write down some things in a text file.
+When the method is recommended to use: never. You can use the Recording to make the first test playthrough of a segment (or the whole game), i.e. when you don't need precision. But for polishing a segment this method is inferior. Yet it's reasonable to learn it, because many modern emulators have sufficient tools for applying the method, while Taseditor is only in FCEUX as yet.
+The next method is more effective, but it even less resembles a normal gaming.
+Created with the Personal Edition of HelpNDoc: Easily create CHM Help documents
+
