Method: Magick::Image#resample

Defined in:
ext/RMagick/rmimage.cpp

#resample(x_resolution = 72.0, y_resolution = 72.0, filter = self.filter, blur = self.blur) ⇒ Magick

Resample image to specified horizontal resolution, vertical resolution, filter and blur factor.

Resize the image so that its rendered size remains the same as the original at the specified target resolution. For example, if a 300 DPI image renders at 3 inches by 2 inches on a 300 DPI device, when the image has been resampled to 72 DPI, it will render at 3 inches by 2 inches on a 72 DPI device. Note that only a small number of image formats (e.g. JPEG, PNG, and TIFF) are capable of storing the image resolution. For formats which do not support an image resolution, the original resolution of the image must be specified via the density attribute prior to specifying the resample resolution.

Returns a new image.

Parameters:

  • x_resolution (Numeric) (defaults to: 72.0) —

    the target horizontal resolution.

  • y_resolution (Numeric) (defaults to: 72.0) —

    the target vertical resolution.

  • filter (Magick::FilterType) (defaults to: self.filter) —

    the filter type

  • blur (Numeric) (defaults to: self.blur) —

    the blur size

Returns:

See Also:



12059
12060
12061
12062
12063
12064
 
# File 'ext/RMagick/rmimage.cpp', line 12059

VALUE
Image_resample(int argc, VALUE *argv, VALUE self)
{
    rm_check_destroyed(self);
    return resample(False, argc, argv, self);
}