./src/rm-videofile-mode.lsp

render-mode/videofile-mode [ Render Modes ]

[ Top ] [ render-mode ] [ Render Modes ]

Name

 videofile-mode

File

 rm-videofile-mode.lsp

Description

 A basic render-mode for sampled video. It will place videofiles linked
 to in the videofile-slot of events in time. When a new event starts before
 the previous one is finished, the new one will replace the previous one,
 which will result in more activity overall. Frames will not be mixed!

 When pitch->speed is t (default: nil), the pitch-value of the event - if
 it is supplied - will result in a change of speed of the video: When the
 frame rate equals pitch in hz, the video will play back at its original
 speed. An octave up or down will result in double or half speed. (This can
 lead to potentially interesting effects when playing back the video with
 pitch values at audio rate, but starting from different frames
 each time.) If interpolate-frames is t (by default), frames are
 interpolated. If preserve-pitch is t (default: nil), the audio
 speed will be changed using time-stretch instead of samplerate-conversion.

 Another feature is the control of video brightness via the amplitude-slot.
 An amp of 1 will result in the original brightness, while an amp of 0 will
 result in a black screen. (Works in the opposite direction as well: amp 2
 results in a white screen.)

 If the video has an audio stream attached to it, the audio will be preserved
 in the result and cut the same way as the video. Any change of speed
 will be reflected in the audio, using ffmpegs "atempo".

 If there should be no events at some point, the gap will be filled
 using a monochrome color. This color can be set using the
 background-color option and defaults to black. (more info on
 syntax is here: https://ffmpeg.org/ffmpeg-utils.html#Color)

Output Format

 :video

Required Slots

 videofile, start-time, duration

Optional Slots

 pitch, amplitude

Options

 pitch->speed (default: nil)
 interpolate-frames (default: t)
 preserve-pitch (default: nil)
 amplitude->brightness (default: nil)
 fps (frames per second, default: 25)
 height (default: 1080)
 width (default: 1920)
 background-color (default: black)

Dependencies

 ffmpeg