	MidiVid Home
Main Page \| Class Hierarchy \| Class List \| File List \| Class Members \| File Members \| Related Pages

Display Source Plugin

The Display Source plugin

The Display Source plugin is the workhorse of MidiVid. Using the default settings, it simply displays a video source in the center of the screen. By using the various options and parameters, you can do some pretty cool things with it.

Display Source Options

Source: Allows you to choose the video source this plugin will display. Any of the available sources can be used, including AVI's, images, the current framebuffer, video capture devices, and any active samples you have.

Stretch to Fill Screen: Stretches the video source to fit to the current display size, ignoring aspect ratio.

Transparent Key Color: Allows you to set a key color and tolerance, and does not draw anything of (or near) that color. If you set the key color to be black, and set the key distance to zero, then only absolute black will become transparent. If you set the key distance to 10, then any color within 10 units of absolute black will become transparent.

Erase on Note Off: Clears the display when the note (or key) is released.

Reset Playback each note: Restarts the video source from the beginning each time the plugin is triggered. If this option is unchecked, video playback resumes from the last point each time the plugin is triggered.

Looped Playback: Restarts the video source when it plays to the end. If this option is unchecked, the last frame of the video source will hold when it reaches the end.

Sustain Note: Tells MidiVid to continue playing the video source until it ends, even after you've released the note (or key) that triggered it. This is useful when using drum pads, or other instant-off MIDI devices as controllers.

Override Size, Position, and Orientation: Enables parameter knobs for controlling the size, position, and angle to display the video source. With these parameters you can scale the video up or down, flip it horizontally or vertically, rotate it, and position it anywhere on (or off) the screen. Using this option allows for some cool video feedback when used with the Framebuffer Loopback Source.

Cycle RGB Channel Writes: Enabling this option tells the display plugin to only update one color channel at a time. (First red, then green, then blue, then back to red again) at a rate controlled by a parameter knob.

Display Source Parameters

Key Red, Green, & Blue: When Transparent Key Color is enabled, sets the RGB color value that will become transparent.

Key Dist: When Transparent Key Color is enabled, sets the color key tolerance. Higher values will make more colors near the chosen key color become transparent.

Alpha: The alpha (transparency) value to draw the video source with. 255 is fully opaque, 0 is completely transparent. Drawing a video source with a low alpha value can give a "ghosted trails" look to the video, and is useful when doing video feedback. It can also be used to draw one source over another source, or fade from one source to another.

XPos & YPos: Sets the screen position of the center of the displayed video source. (Only available when Override Size, Position, and Orientation is enabled)

Width & Height: Sets the width and height of the displayed video source. Negative values will flip the image either horizontally or vertically. (Only available when Override Size, Position, and Orientation is enabled)

Angle: Chooses the angle (tilt) at which the video source will be drawn. (Only available when Override Size, Position, and Orientation is enabled)

Channels: Chooses which color channels (RGB) will be displayed. (Only available when Cycle RGB Channel Writes is disabled)

Cyc Rate: When Cycle RGB Channel Writes is enabled, this chooses the number of frames to delay between changing which color channel is currently drawn. A rate of 1 means the channel cycles every frame.