# Operations

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 Log records and corresponding operations with the movie.

Input change | Markers change | Other
Set | Marker Set | Initialization
Unset | Marker Remove | Undefined
Pattern | Marker Pattern |
Clear |
Cut
Paste
PasteInsert
Clone
Insert
Insert#
Delete
Truncate
Record |
Import
Branch | Bookmark
| Marker Branch |
Marker Rename
Marker Drag
Marker Swap
Marker Shift
LUA Marker Set
LUA Marker Remove
LUA Marker Rename
LUA Change

Initialization

Category: other

The record is created automatically when a new History Log is created.

Examples:

- when creating a new project
- when loading a compactly saved project that has no History Log

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.

Examples:

- click on an empty Input cell of the Piano Roll
- draw a new stroke by dragging the mouse after clicking on an empty Input cell
- Shift + click on an empty Input cell
- select some frames and then click on a button symbol in the Header of the Piano Roll
- select some frames and then press a key assigned to a virtual gamepad button

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.

Examples:

- click on an occupied Input cell of the Piano Roll
- erase some Input by dragging the mouse after clicking on an occupied Input cell
- Shift + click on an occupied Input cell
- select some frames and then click on a button symbol in the Header of the Piano Roll
- select some frames and then press a key assigned to a virtual gamepad button

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.

Examples:

- Alt + click on an Input cell of the Piano Roll
- Alt + dragging the mouse after clicking on an Input cell
- select some frames and then Alt + click on a button symbol in the Header of the Piano Roll
- select some frames and then Alt + press a key assigned to a virtual gamepad button

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.

Examples:

- select some frames and then press Delete
- select some frames and then choose Edit -> Clear in TAS Editor menu
- right-click on a selected frame number and choose Clear in the context menu

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 the Clear operation, except that buttonpresses are copied to the Clipboard before deleting them.

Note: although you can undo this operation, the Clipboard contents won't revert.

Examples:

- select some frames and then press Ctrl + X
- select some frames and then choose Edit -> Cut in TAS Editor menu

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.

Examples:

- select some frames and then press Ctrl + V
- select some frames and then choose Edit -> Paste in TAS Editor menu

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.

Examples:

- select some frames and then press Ctrl + Shift + V
- select some frames and then choose Edit -> PasteInsert in TAS Editor menu

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.

Examples:

- select some frames and then press Ctrl + Insert
- select some frames and then choose Edit -> Clone in TAS Editor menu
- right-click on a selected frame number and choose Clone in the context menu

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.

Examples:

- select some frames and then press Ctrl + Shift + Insert
- select some frames and then choose Edit -> Insert in TAS Editor menu
- right-click on a selected frame number and choose Insert in the context menu

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 a 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 the Playback cursor.

The number of inserted frames is added to the text of the record.

Examples:

- press Insert and enter the number of frames to insert
- choose Edit -> Insert # of Frames in TAS Editor menu
- right-click on a selected frame number and choose Insert # of Frames in the context menu

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.

Examples:

- select some frames and then press Ctrl + Delete
- select some frames and then choose Edit -> Delete in TAS Editor menu
- right-click on a selected frame number and choose Delete in the context menu

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 the Playback cursor (when there's no Selection).

Examples:

- choose Edit -> Truncate movie in TAS Editor menu
- right-click on a selected frame number and choose Truncate movie in the context menu

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 the emulator is recording Input using gamepads.

The new Input appears at the Playback cursor frame. Depending on the "Superimpose" checkbox, the old Input of the frame is either overwritten 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.

Examples:

- switch Recording mode on, unpause the emulator and press any keys assigned to buttons of gamepads
- when emulator is paused, switch Recording mode on, hold any keys assigned to buttons of virtual pads and press Frame Advance

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 from another FM2/FM3 movie is imported into the 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.

Examples:

- choose File -> Import Input in TAS Editor menu and open the file which should be the source of Input

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.

Note: 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 placed to another frame or when the current movie Input differs from the Input stored in the slot.

When a Bookmark is successfully saved, its Branch becomes "the current branch of the movie", and the emulator shows the message "Branch # saved."

Examples:

- press a "Save state" hotkey: Shift + key in the row from F1 to F10
- right-click anywhere inside the Bookmarks List
- right-click on a Bookmark icon in the Branches Tree

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 the 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 actually reverted to its own state at that time.

When a Bookmark is successfully loaded, its Branch becomes "the current branch of the movie", and the emulator shows the message "Branch # loaded."

Examples:

- press a "Load state" hotkey: Shift + key in the row from F1 to F10
- click on the right half of the Bookmarks List
- double-click on a Bookmark icon in the Branches Tree

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 the new Input was identical to the old Input, and only Markers were different.

Examples:

- press a "Load state" hotkey: Shift + key in the row from F1 to F10
- click on the right half of the Bookmarks List
- double-click on the a Bookmark icon in the Branches Tree

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.

Examples:

- double-click on a non-marked frame number in the Piano Roll
- select some frames and then click on the "Frame#" in the Header of the Piano Roll
- right-click on a selected frame number and choose Set Markers in the context menu

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.

Examples:

- double-click on a marked frame number in the Piano Roll, drag the Marker outside the Piano Roll and release it
- select some frames and then click on the "Frame#" in the Header of the Piano Roll
- right-click on a selected frame number and choose Remove Markers in the context menu

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.

Examples:

- select some frames and then Alt + click on the "Frame#" in the Header of the Piano Roll

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.

Examples:

- type the text of the Note right after creating the new Marker by double-click
- click on the upper edit field, erase old text and type new, then press Enter or click anywhere outside the edit field
- click on the lower edit field, erase old text and type new, then press Enter or click anywhere outside the edit field

20:31:01 Marker Rename 20 Testing...

Used: often

Greenzone is not truncated.

Marker Drag

Category: Markers change

The record is created after moving a Marker from one frame to another.

The old and new frame number, as well as the Note of the Marker, are added to the text of the record.

Examples:

- double-click on a marked frame number in the Piano Roll, drag the Marker to a non-marked frame number and release

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, are added to the text of the record.

Examples:

- double-click on a marked frame number in the Piano Roll, drag the Marker to another marked frame number and release

20:31:14 Marker Swap 24<=>28

Used: rarely

Greenzone is not truncated.

Marker Shift

Category: Markers change

The record is created when a splicing operation didn't change Input but still shifted some Markers up or down.

Examples:

- insert blank frame near the end of the movie (granted that there's no buttonpresses after the frame, yet there is at least one Marker)
- clone a blank frame near the end of the movie (granted that there's no buttonpresses after the frame, yet there is at least one Marker)
- copy a blank frame to the Clipboard and PasteInsert it somewhere near the end of the movie (granted that there's no buttonpresses, yet there is at least one Marker)

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.

Examples:

- run a Lua script with a taseditor.setmarker(framenum) line

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.

Examples:

- run a Lua script with a taseditor.removemarker(framenum) line

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.

Examples:

- run a Lua script with a taseditor.setnote(markernum, newtext) line

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.

Examples:

- run a Lua script containing such lines as taseditor.submitinputchange(frame, joypad, input) and taseditor.applyinputchanges(name)
- run a Lua script containing such lines as taseditor.submitinsertframes(frame, number) or taseditor.submitdeleteframes(frame, number) and taseditor.applyinputchanges(name)

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