overlay 0.0.2c

by David Roden


Configuration Dialog

Image Path

This field contains the file name of the first image of your image sequence. You can not edit this field directly. Press the "Browse" button to enter a name.

Use First Image Only

If you check this box the filter will use the first image of the sequence only, i.e. the file you select. If this box is checked the duration edit field gets available.

If this box is unchecked the filter will use the complete sequence. The duration edit field will not be available, as the length of the sequence is determined by the file count.

Browse

Lets you choose a file that is to used as first image of a sequence. The filter will search for a number in the file name after stripping the path information from it. A file name like big0000.tga will work fine, a name like b4_0000.tga will not as the filter stops at the first number in the file name it can find.

After you selected a file the filter will search for the sequence. This can take some time, depending on the speed of your computer, your hard disks, or your network connections (in case the files are accessed via some kind of remote network). It will complain if it can not find a sequence or if the sequence is unusable due to the following situations:

If a sequence could successfully be detected, information about it is displayed.

Sequence Information

This small panel should need no further explanation. It displays the file type of the found sequence, the image dimensions, whether the images have an alpha channel, and the number of found images.

Manual vs. Predefined Placement

Here you can select where you want your images to be laid over the movie. Selecting "Manual Placement" gives you the possibility to enter values for the absolute X and Y position. The origin with the coordinates (0, 0) is the upper left corner of the movie.

Predefined placement lets you choose a corner or the center and an optional distance that the images are kept away from the margin.

WARNING: If your images are bigger than the movie they might not get clipped correctly! This can result in erratic results! (The clipping code is kind of untested as I'm too lazy — and I know what I'm doing when I use this filter.)

Start From Frame

As it is unlikely that you have an image to superimpose over a full-length hollywood movie (containing more than 200000 frames in usual cases) you can choose when your image sequence should start showing. This is the number of the frame the first image should be shown upon. Frames are counted zero-based, i.e. the first frame of the movie is frame 0.

End Frame

This is the number of the last frame the image should be shown upon. Frames are counted zero-based, i.e. the first frame of the movie is frame 0.

Duration

This edit field can only be edited if you checked "Use First Image Only". It determines how long (in numbers of frames) the first image should be shown on the movie.

Fix End Frame or Duration

These check boxes might come in handy for small changes to the number of frames that the image sequence is to be shown on. When a new number in any of the three fields next to these boxes is entered other parameters are adjusted according to the new entry, taking into account which of the parameters should remain as it is.

Repeat Image Sequence after Frames

If this value is greater than zero the image sequence will be repeated every number of frames until the end of the movie.

Repeat Last Image of Sequence

If this box is checked the last image of the sequence will be repeated until the end of the movie.

OK Button

This button closes the configuration dialog and saves all settings. The filter is now ready to be used.

Cancel Button

This button closes the configuration dialog and discards all changes made to the configuration of the filter. It's like you never opened the dialog in the first place.

About Button

This button shows a small "About" dialog, containing the name of the author, his e-mail address and the address of his homepage where you can download this filter (definitely), newer versions of this filter (maybe), and other filters (definitely).

Help Button

This button shows this help file if the file overlay.html was correctly extracted into VirtualDub's plugins directory.


Information

The overlay filter was written by David Roden. Contact is possible via e-mail: Write to dr@todesbaum.de.

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.