Video Player

Video player module.

About compression format

The codec used for the video compression is very important. To explain simply, acompressed video flow is made of key frames, also known as an intra-frames followed by modified frames. A key frame is a frame in which a complete image is stored in the data stream. In video compression, only changes that occur from one frame to the next are stored in the data stream, in order to greatly reduce the amount of information that must be stored. See Wikipedia.

This means that, in a compressed video, you can't access directly to any frame but only key frames which can occur, for example only every seconds.

If you want to access to any frames at any time, you can use uncompressed videos or use motion-jpeg compression. The motion jpeg format contains only key frames.

You can use a conversion tools to convert you videos to motion-jpeg, for example the free FFmpeg, and use the following command line:

ffmpeg -i input.mov -c:v mjpeg -q:v 3 -an output.mov

Settings

on

Activates or deactivates the module.

video out

Video output flow(s).

show list

Shows the files list.

dimmer

Output ntensity.

speed

Sets the video reading speed.

master SMPTE

When On, the master SMPTE follows the current SMPTE.

play loop

Plays the file in loop mode until you stop it.

loop mode

Synchronization options:

• Free loop: the file is played in loop mode.
• Cycle: the file is played at each beginning cycle.
• Bar: the file is played at each beginning bar.
• Beat: the file is played each beat.
• Eighth note: the file is played each eighth note.
• Sixteenth note: the file is played each sixteenth note.
• 2 bars : the file is played every 2 bars.
• 4 bars : the file is played every 4 bars.
• 6 bars : the file is played every 6 bars.
• 8 bars : the file is played every 8 bars.
• 10 bars : the file is played every 10 bars.
• 12 bars : the file is played every 12 bars.
• 14 bars : the file is played every 14 bars.
• 16 bars : the file is played every 16 bars.
• loop on bar: the file is played entirely as in loop mode, and then, at the end, restarts at the beginning of the next bar.
• loop on beat: the file is played entirely as in loop mode, and then, at the end, restarts at the beginning of the next beat.

auto restart

Forces to restart from the beginning, on play or on activation of the patch.

play

Plays the file.

play button mode

• play-replay:first click play the file (once) second click restart the file.
• play-stop:first click play the file (once) second click stop the file.

stop

Stops the file.

on activation

• do nothing: When parent patch is activated nothing is done nothing special done.
• play once: When patch activated the file is played once.

at the end

Determines what happens when the sample or MIDI sequence reach it's end:

• do nothing: nothing is done.
• next grid section: the grid goes to the next section.

is playing

Sends a 1 value when the module is playing. 0 otherwise.

re-starting

Sends 1 value each time the current file is starting or re-starting.

mode

• Single: the selected file is played in loop.
• Next: each file is played once and then plays to the next file in the list.
• Previous: each file is played once and then plays to the previous file in the list.
• Random: plays files in a random order.

file number

File number combobox.

• -1: no file is selected.
• 0: the first file in the list is selected.
• 1: the second file in the list is selected
• etc.

number of files

Gets the number of files in the list.

duration

Length in ms of the selected file.

nb of channels

Gets the number of audio channels of the selected file.

• 1 : mono,
• 2 : stereo,
• 4 : surround 4 channels,
• etc.

fps

Frame Rate (Number of Frames per seconds) of the original video.

duration

Video duration in mS of the video.

original duration

Video duration in mS of the entire video.

nb of frames

Gets the number of frames of the current file.

size reduction factor

Reduction size factor applied to the original size of the video.

• 1: no size reduction
• 3/4: reduction by 3/4
• etc.

This is useful to

• reduce the size of video and therefore reduce the CPU consumption of video filters,
• fit to the output display resolution.

This can reduce efficiently the number of pixels to process in the video flow and then reduce the CPU load of video effects.

A 1920 × 1080 (2073600 pixels per frame) video with a size factor of 2/3 gives a 1280 x 720 resolution (921600 pixel per frame) so the CPU load will be reduced by 50%.

width

Video resolution width (once reduction factor applied).

height

Video resolution height (once reduction factor applied).

start pos

Start reading position.

end pos

End reading position.

pos

Sets or gets the current reading position.

current frame num

Gets or set the current frame number.

jump to key frames

Jump the reading position only to Key frames when pos or current frame num are changed. See About compression format above.

next

Selects the next file in the list.

previous

Selects the previous file in the list.

next rand

Random selection of a file in the list.

short filename

Gives only the name of the file, without the path and extension.

long filename

Gives the full name of the file, included the path.

add file name

Set this value with a filename to add a new file in the list (this applies to the sampler, video player and piano roll).

list comma text

Input to set the file list with a comma-text.

clear list

Clear the sample list. When you press saverand or savename the recorded file is automatically added to the sample list. With the clear list button you can clear the list directly.

user curve

Output value of the user curve. Can be used to synchronize processing with the current video.

saved in preset

Determines if parameters of this object are saved in the preset-panel.

fade preset

Parameters of the this object can cross faded when you recall a preset in the grid.

See also

• Video Player Image
• Video Player IP Camera
• Video Player Image Multi
• Video Player Flow
• Video Recorder
• Video Player