You should download the current version from the list below. The previous version is also available in case you have any problems. If you do encounter any problems with the current version, please send me a note describing the problem.
first[-last] command [parameters]Where,
|
first | = | The first (or only) frame number in a range of frames. |
|
last | = | The last frame number in a range of frames (inclusive). If this is not specified, then the range will consist of a single frame (specified by "first"). |
|
command | = | A command which specifies the operation to be performed on the frame or frames. Commands are case-insensitive. |
|
parameters | = | The command parameters (depends on the individual command). |
|
[ ] | = | Optional. Everything in square brackets is optional, but may be required for the individual command. |
The lines in the script file must appear in frame number order. This means that lower frame numbers must preceed higher frame numbers in the file. A frame number may appear more than once in the script file, and frame ranges may overlap. If two or more commands operate on the same frame number, the commands are executed in the order in which they appear in the script file.
All frame numbers are source frame numbers, which specify the frame number in the source file (starting at 0). To determine the source frame number for a given frame, you can look at the frame number displayed at the bottom of the main VirtualDub window before any segments are deleted.
Syntax: first[-last] BLACK
Syntax: frame COPY
Syntax: first-last FADEIN
Syntax: first-last FADEOUT
Syntax: first[-last] PASTE
Syntax: first[-last] SHIFT [EVEN | ODD] lines [PASTE]
The lines parameter can be positive or negative. If lines is positive, the frame will be shifted down by the specified number of lines. If lines is negative, the frame will be shifted up by the specified number of lines. If the "EVEN" or "ODD" parameter is used, only the even or odd field in an interlaced frame will be shifted. If the "PASTE" parameter is used, the new lines will contain the lines at the same position on the Frame Tweaker clipboard. Otherwise, the new lines will be black.
31-47 FADEIN 546 COPY 547 PASTE 1335 COPY 1336-1337 PASTE 1978 COPY 1979 SHIFT 17 PASTE 2647-2655 FADEOUT 2656-2665 BLACKFrames 0 thru 30 will be deleted from this clip, so FADEIN starts at source frame 31. Frames 547 and 1336-1337 contained bright flashes (from video defects), so they are replaced by the previous frame (the resulting motion pause is much less objectionable than the bright flash). Frame 1979 was shifted up 17 lines due to a video sync glitch, so it is shifted back down 17 lines and the resulting new lines are replaced by lines from the previous frame.
Because a COPY command must preceed a PASTE (or SHIFT) command, you cannot copy backwards.
You can include comment lines in the Frame Tweaker script file by beginning each comment line with pound sign (#). (Actually, any line that begins with a non-numeric is ignored by the current script parser, but let's standardize on the pound sign to allow for future enhancements).
You must not include spaces in a frame range (first-last).
Frame Tweaker has been tested with VirtualDub versions 1.2a, 1.3, and 1.3a.
When you save your configuration, a registry entry is created under the following key:
HKEY_CURRENT_USER\Software\Freeware\VirtualDub\plugins\FrameTweakerIf you want to completely uninstall this filter, just delete the "tweaker.vcf" file in the plugins directory, and delete this registry entry.
WARNING: Due to a bug in VirtualDub 1.2a/1.3/1.3a, you should NEVER press the Cancel button when using the single frame forward and back buttons. VirtualDub will crash if it receives an error from the plugin filter. It's safest to always press the OK button in an error dialog box.