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.

Another consequence is that a compressed video can't be played in reverse.

If you want to play a video in reverse, you must export it into separate images and use the video-player-image module.

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.

audio delay

Adds a delay to synchronize audio and video if needed.

video out

Video output flow(s).

show list

Shows the files list.

dimmer

Video intensity.

speed

Sets the video reading speed.

master SMPTE

When On, follow the Master 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.

Only when the play loop is OFF.

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.

Only when the play loop switch is OFF.

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.

Works properly only when loop mode = synchro.

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.

The numerical value corresponds to the selected file number in files list.

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

duration

Length in ms of the selected file.

file number

File number combobox.

The numerical value corresponds to the selected file number in files list.

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

fps

Frame per seconds

duration

Video duration in Ms

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.

the file is read between the start and end position

pos

Sets or gets the current reading position.

The pos inlet is not suitable for precise random access to file position, use current frame num instead.

current frame num

Gets or set the current frame number.

The current frame num inlet can be used for precise random access to file position, especially if you set speed=0 and only for motion-jpeg or uncompressed videos. See About compression format above.

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.

For example ''"c:samplesfile 1.wav","c:samplesfile 2.wav","c:samplesfile 3.wav"'' will set the file list to

  • ''c:samplesfile 1.wav''
  • ''c:samplesfile 2.wav''
  • ''c:samplesfile 3.wav''

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.

Optional setting, does not appear on all objects.

See also

version 3.0.150

Edit All Pages