readFrame: Read Specific Video Frame

View source: R/generic.R

readFrame.Rcpp_VideoR Documentation

Read Specific Video Frame

Description

Read a specific frame of a Video or VideoStack object and returns it as an Image object.

Usage

## S3 method for class 'Rcpp_Video'
readFrame(x, pos, target = "new")

## S3 method for class 'VideoStack'
readFrame(x, pos, target = "new")

readFrame(x, pos, target = "new")

Arguments

x

A Video or VideoStack object.

pos

An integer corresponding to the position of the frame to read in the video or video stack.

target

The location where the results should be stored. It can take 2 values:

  • "new":a new Image object is created and the results are stored inside (the default).

  • An Image object:the results are stored in another existing Image object. This will replace the content of target. Note that target must have the same dimensions as x.

Value

If target="new", the function returns an Image object. If target is an Image object, the function returns nothing and modifies that Image object in place.

Author(s)

Simon Garnier, garnier@njit.edu

See Also

Video, VideoStack, Image, readNext

Examples

balloon <- video(system.file("sample_vid/Balloon.mp4", package = "Rvision"))
frame10 <- readFrame(balloon, 10)


swarm-lab/Rvision documentation built on Feb. 7, 2024, 4:59 a.m.