stopmotion (version 0.1.0)

crop: Crop images

Description

Crops selected frames to a given geometry. Wraps magick::image_crop.

Usage

crop(images, geometry, gravity = NULL, repage = TRUE, frames = NULL)

Value

a magick-image object

Arguments

images

an object of class magick-image to modify

geometry

a geometry string specifying the cropped region, e.g. "100x100+10+10" (widthxheight+x_offset+y_offset).

gravity

anchor point for the crop: one of "NorthWest", "North", "NorthEast", "West", "Center", "East", "SouthWest", "South", "SouthEast". Defaults to NULL (top-left).

repage

logical. If TRUE (default), resets the virtual canvas after cropping.

frames

integer vector of frame indices to duplicate. Defaults to NULL, which duplicates all frames.

Verbosity

After each operation a message listing the updated frame sequence is printed in interactive sessions. Use stopmotion_verbosity(FALSE) to suppress these messages, or set options(stopmotion.verbose = FALSE) in your script or .Rprofile.

Examples

# \donttest{
  dino_dir <- system.file("extdata", package = "stopmotion")
  images <- read(dir = dino_dir)
  crop(images = images, geometry = "200x200+50+50")
  crop(images = images, geometry = "200x200", gravity = "Center", frames = 1:3)
# }