batchGrabVideoStills: Batch process video files, breaking them into stills

View source: R/batchGrabVideoStills.R

batchGrabVideoStillsR Documentation

Batch process video files, breaking them into stills

Description

#' This helper calls grabVideoStills, which function currently relies on the av package and 'ffmpeg' to split a video file into images. This function will save the images to the director specified by the user.

Usage

batchGrabVideoStills(
  batchOut,
  imageDir = NULL,
  overWriteDir = FALSE,
  sampleWindow
)

Arguments

batchOut

the full object that is output from batchProcessZoomOutput

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

the batchOut input object, but with a new item–videoInfo–that is a a data.frame that gives information about the batch. Each record corresponds to one video, with:

  • batchMeetingId - the meeting identifier

  • videoExists - boolean indicating whether the video file was there

  • imageDir - path to the directory where video images are saved

  • sampleWindow - integer with the sampleWindow requested

  • numFramesExtracted - the number of image files that were saved

Examples

vidBatchInfo = batchGrabVideoStills(batchOut=batchProcessZoomOutput(
batchInput=system.file('extdata','myMeetingsBatch.xlsx', 
package = 'zoomGroupStats')),
imageDir=tempdir(), overWriteDir=TRUE, sampleWindow=2)
## Not run: 
vidBatchInfo = batchGrabVideoStills(batchOut=zoomOut,
imageDir="~/Documents/myMeetings/videoImages", overWriteDir=TRUE,  sampleWindow=600)

## End(Not run)

andrewpknight/zoomGroupStats documentation built on April 14, 2022, 6:16 a.m.