Method: Magick::Image#excerpt

Defined in:
ext/RMagick/rmimage.cpp

#excerpt(x, y, width, height) ⇒ Magick::Image

This method is very similar to crop. It extracts the rectangle specified by its arguments from the image and returns it as a new image. However, excerpt does not respect the virtual page offset and does not update the page offset and is more efficient than cropping.

Parameters:

  • x (Numeric) —

    the x position for the start of the rectangle

  • y (Numeric) —

    the y position for the start of the rectangle

  • width (Numeric) —

    the width of the rectancle

  • height (Numeric) —

    the height of the rectangle

Returns:

See Also:



6560
6561
6562
6563
6564
6565
 
# File 'ext/RMagick/rmimage.cpp', line 6560

VALUE
Image_excerpt(VALUE self, VALUE x, VALUE y, VALUE width, VALUE height)
{
    rm_check_destroyed(self);
    return excerpt(False, self, x, y, width, height);
}