Video player module.
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
Activates or deactivates the module.
Video output flow.
Adds a delay to synchronize audio and video if needed.
Shows the files list.
Sets the video reading speed.
When On, follow the Master SMPTE.
Plays the file in loop mode until you stop it.
Forces to restart from the beginning, on play or on activation of the patch.
Plays the file.
Only when the play loop is OFF.
Stops the file.
Only when the play loop switch is OFF.
Determines what happens when the sample or MIDI sequence reach it's end:
Sends a 1 value when the module is playing. 0 otherwise.
Sends 1 value each time the current file is starting or re-starting.
Works properly only when loop mode = synchro.
Length in ms of the selected file.
File number combobox.
The numerical value corresponds to the selected file number in files list.
Gets the number of frames of the current file.
Reduction size factor applied to the original size of the video.
This is useful to
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%.
Video resolution width (once reduction factor applied).
Video resolution height (once reduction factor applied).
Start reading position.
End reading position.
the file is read between the start and end position
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.
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 the reading position only to Key frames when pos or current frame num are changed. See About compression format above.
Selects the next file in the list.
Selects the previous file in the list.
Random selection of a file in the list.
Gives only the name of the file, without the path and extension.
Gives the full name of the file, included the path.
Set this value with a filename to add a new file in the sampler list (or piano roll).
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
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.