extractFrames: Extracts frames from video

In aaronolsen/StereoMorph: Stereo Camera Calibration and Reconstruction

Extracts frames from video

Description

Extracts frames from a video saving them as a series of images

Usage

extractFrames(file = NULL, save.to = NULL, frames = NULL, names = NULL, 
              ext = 'jpeg', qscale = 2, frame.start = 0, video.i = NULL, 
              warn.min = 100)

Arguments

file	Video file from which frames are to be extracted.
save.to	Where to save the extracted frames.
frames	The frames to be extracted, starting with 0.
names	Names to be given to the extracted frames. If NULL the function will automatically name them with the corresponding frame number, preceded by enough zeros to maintain a constant filename width.
ext	The image type/extension to be added to each extract frame.
qscale	Integer indicating the image quality of the extracted frames. This is an input parameter passed direclty to ffmpeg.
frame.start	The time (in msec) corresponding to the frame immediately before the first frame change.
video.i	Video metadata passed to the function. This parameter is only intended for internal use.
warn.min	The minimum number of extracted frames for which the user is prompted and has to respond 'y' prior to frame extraction. This is intended to prevent the user from mistakenly extracting thousands of frames.

Details

In order to use this function you must separately install the ffmpeg video codec library. For instructions please refer to the 'Extracting video frames' section of the most recent StereoMorph user guide here. This function can be used interactively with prompts by calling extractFrames(). The user will then be prompted for all necessary input parameters. This is useful because the function will report the number of frames in the video before prompting which frames the user would like to extract.

Value

NULL

Author(s)

Aaron Olsen

Examples

## Not run: 
# Use extractFrames() with interactive prompts
extractFrames()

# Extract the first 20 frames from a video
extractFrames(file='Example_video.mov', save.to='Frames', frames=0:20)

## End(Not run)

aaronolsen/StereoMorph documentation built on June 2, 2022, 4:09 a.m.