Helper function to split a video into still frames — grabVideoStills • zoomGroupStats

This function currently relies on the av package and 'ffmpeg' to split a video file into images. This function will save the images to the directory specified by the user.

grabVideoStills(
  inputVideo,
  imageDir = NULL,
  overWriteDir = FALSE,
  sampleWindow
)

Arguments

inputVideo	full filepath to a video file
imageDir	the directory where you want the function to write the extracted image files
overWriteDir	logical indicating whether you want to overwrite imageDir if it exists
sampleWindow	an integer indicating how frequently you want to sample images in number of seconds.

Value

a data.frame that gives information about the still frames. Each record is a stillframe, with the following info:

imageSeconds - number of seconds from the start of the video when this image was captured
imageName - full path to where the image has been saved as a .png

Examples

vidOut = grabVideoStills(inputVideo=system.file('extdata', "meeting001_video.mp4", 
package = 'zoomGroupStats'), imageDir=tempdir(), overWriteDir=TRUE, sampleWindow=2)
#> Processing meeting001_video.mp4 using ffmpeg. Note that processing videos can be time intensive for long duration videos.
if (FALSE) {
grabVideoStills(inputVideo='myMeeting.mp4', 
imageDir="~/Documents/myMeetings/videoImages", overWriteDir=TRUE,  sampleWindow=45)
}