img.background_color -> string
img.background_color = string or pixel -> string or
pixel
The image's background color. By default the background color is "white".
Either a color name or a Pixel object.
A color name or Pixel object.
img.base_columns -> integer
The number of columns in the image before any transformations. Get-only.
img.base_filename -> string
The image's original filename before any transformations. Get-only.
img.base_rows -> integer
The number of rows in the image before any transformations. Get-only.
img.bias -> float
img.bias = float or string -> float or string
Add bias when convolving an image
Either a number between 0.0 and 1.0 or a string in the form "NN%".
img.black_point_compensation -> true or false
img.black_point_compensation = true or false -> true or false
Use black point compensation. Typically used in CMYK-to-RGB conversion along with image.
rendering_intent=Magick::RelativeIntent
img.border_color -> string
img.border_color = string or pixel -> string or pixel
The image's border color. The default border color is "#dfdfdf" (gray).
Either a color name or a Pixel object.
A color name.
img.bounding_box -> rectangle
img.chromaticity -> chromaticity
img.chromaticity = chromaticity -> chromaticity
The red, green, blue, and white-point chromaticity values..
A Chromaticity object.
A Chromaticity object.
img.class_type -> storage_class
img.class_type = storage_class -> storage_class
The image's storage class. If DirectClass then the pixels contain valid RGB or CMYK colors. If PseudoClass then the image has a colormap referenced by the pixel's index member.
A ClassType constant.
A ClassType constant.
img.color_profile -> string
img.color_profile = string -> string
The ICC color profile.
A color profile is represented as a string. If the argument is
nil instead of string then any ICC color profile present in the image is deleted.
The setter form of this attribute deletes any existing ICC color profile(s) before adding the new one. If you need to add both source and destination profiles use add_profile or profile!.
The current color profile, or nil if there is no profile.
img.colors -> integer
The number of colors in the colormap. Only meaningful for PseudoClass images. Get-only.
img.colorspace -> colorspace
img.colorspace = colorspace -> colorspace
Image pixel interpretation. If the colorspace is RGBColorspace the pixels are red, green, blue. If alpha? is true, then red, green, blue, and opacity. If it is CMYKColorspace, the pixels are cyan, yellow, magenta, black. Otherwise the colorspace is ignored.
A ColorspaceType constant.
A ColorspaceType constant.
img.columns -> integer
The width of the image in pixels. Get-only.
img.compose -> operator
img.compose = operator -> operator
The image composite operator. The default is OverCompositeOp. See montage.
A composite operator constant.
A composite operator constant.
img.compression -> type
img.compression = type -> type
The image compression type. The default is the compression type of the specified image file.
A CompressionType constant.
A CompressionType constant.
img.delay -> integer
img.delay = integer -> integer
Number of ticks which must expire before displaying the next image in an animated sequence. The default number of ticks is 0. By default there are 100 ticks per second but this number can be changed via the ticks_per_second attribute.
An integer value between 0 and 65535, inclusive.
The current delay value.
img.density -> string
img.density = string or geometry -> string or geometry
The vertical and horizontal resolution in pixels of the image. The default is "72x72".
The density may be expressed either as a string or a
Geometry object. If a string, it is in the form "XxY", or simply "X". If "Y" is omitted it is set to "X". To specify
the density with a Geometry object, set the width attribute to the x resolution and the height argument to the y resolution.
If height is nil, width will be used as the y resolution as well.
The image density represented as a string.
Also see x_resolution and y_resolution.
img.depth -> integer
The image depth (8, 16, or 32). Get-only.
img.directory -> string
Tile names from within an image montage. Only valid after calling montage or reading a MIFF file which contains a directory. Get-only.
A newline ("\n")-delimited list of the images in the montage.
img.dispose -> method
img.dispose = method -> method
GIF disposal method. This attribute is used to control how successive images are rendered (how the preceding image is disposed of) when creating a GIF animation.
An integer corresponding to the disposal method.
A DisposeType constant.
img.endian -> endian
img.endian = endian -> endian
Specify an endian option for images that support it.
A EndianType constant.
A EndianType constant.
img.extract_info -> rectangle
img.extract_info = rectangle
Specify a rectangle within an image, or retrieve the rectangle specified when the image was constituted. See extract=.
A Rectangle object.
A Rectangle object.
img.filename -> string
The image filename. Get-only.
img.filesize -> integer
The image filesize in bytes. Get-only.
img.filter -> type
img.filter = type -> type
Filter to use when resizing image. The reduction filter employed has a significant effect on the time required to resize an image and the resulting quality. The default filter is Lanczos which has been shown to produce high quality results when reducing most images.
A FilterType constant.
A FilterType constant.
img.format -> string
img.format = string -> string
The image encoding format. For example, "GIF" or "PNG". See formats.
The format name.
The format name.
img.fuzz -> float
img.fuzz = float or string -> float or string
Colors within this distance are considered equal. A number of algorithms search for a target color. By default the color must be exact. Use this [attribute] to match colors that are close to the target color in RGB space.
See opaque, texture_floodfill, and transparent.
The argument may be a floating-point numeric value or a string in the form "NN%". In the second case, the argument is computed as a percentage of
QuantumRange. For example, a value of '5%' sets fuzz to 0.05*QuantumRange.
A Float or string
img.gamma -> float
image.gamma = float -> float
Gamma level of the image. The same color image displayed on two different workstations may look different due to differences in the display monitor. Use gamma correction to adjust for this color difference.
img.geometry -> string
img.geometry = string -> string
Preferred size of the image when encoding.
img.gravity -> gravity
img.gravity = gravity -> gravity
Used with the ImageList#composite_layers method. The direction that the image gravitates within the composite.
A GravityType value.
A GravityType value.
img.image_type -> type
img.image_type = type -> type
The image type classification. For example, GrayscaleType. Don't confuse this attribute with the format, that is "GIF" or "JPG". Get-only.
An ImageType value.
An ImageType value.
img.interlace -> type
img.interlace = type -> type
The type of interlacing scheme (default NoInterlace). This option is used to specify the type of interlacing scheme for raw image formats such as RGB or YUV. NoInterlace means do not interlace, LineInterlace uses scanline interlacing, and PlaneInterlace uses plane interlacing. PartitionInterlace is like PlaneInterlace except the different planes are saved to individual files (e.g. image.R, image.G, and image.B). Use LineInterlace or PlaneInterlace to create an interlaced GIF or progressive JPEG image.
An InterlaceType constant.
An InterlaceType constant.
img.iptc_profile -> string
img.iptc_profile = string -> string
The International Press Telecommunications Council profile.
A IPTC profile is represented as a string. If the argument is
nil instead of string then any IPTC profile present in the image is deleted.
The current IPTC profile, or nil if there is no profile.
img.matte_color -> string
img.matte_color = string or pixel -> string or pixel
img.mean_error_per_pixel -> float
The mean error per pixel computed when a image is color reduced.
This attribute is only valid if the measure_error argument to quantize[ImageList]
[Image] is set to true. Get-only.
img.mime_type -> string
Returns the officially registered (or de facto) MIME media-type. If there is no registered media-type, returns "image/x-magick". Get-only.
img.montage -> string
Tile size and offset within an image montage. Only valid for [images produced by montage.] The string is in the form of a geometry string. Get-only.
img.normalized_mean_error -> float
The normalized mean error computed when an image is color reduced.
This attribute is only valid if the measure_error argument to quantize[ImageList][Image] is set to true. Get-only.
img.normalized_maximum_error -> float
The normalized mean error per pixel computed when an image is color reduced.
This attribute is only valid if the measure_error argument to quantize[ImageList][Image] is set to true. Get-only.
img.number_colors -> integer
Number of unique colors in the image. Get-only.
img.offset -> integer
img.offset = integer -> integer
Number of initial bytes to skip over when reading raw image.
Attenuates the opacity channel of an image. If the image pixels are opaque, they are set to the specified opacity level. Otherwise, the pixel opacity values are blended with the supplied transparency value.
A number between 0 and QuantumRange. Higher numbers increase transparency.
img.orientation -> type
img.orientation = type -> type
The value of the Exif Orientation Tag.
An OrientationType value.
See https://jpegclub.org/exif_orientation.html for more information about the Exif Orientation Tag.
img.page -> rectangle
img.page = rectangle -> rectangle
When compositing, this attribute describes the position of this image with respect to the underlying image. See coalesce, flatten_images, and mosaic.
A Rectangle object.
A Rectangle object.
img.pixel_interpolation_method -> method
img.pixel_interpolation_method = method -> method
Get/set the pixel color interpolation method. Some methods (such as wave, swirl, implode, and composite) use the pixel color interpolation method to determine how to blend adjacent pixels.
An PixelInterpolateMethod enum value.
An PixelInterpolateMethod enum value.
img.quality -> integer
For JPEG images, returns the Independent JPEG Group quality value. This number is a measurement of the amount of compression used when the image was saved. Lower numbers mean higher compression.
A number between 0-100.
For more information, see The JPEG image compression FAQ.
img.quantum_depth -> integer
The image depth to the nearest Quantum (8, 16, or 32). Get-only.
img.rendering_intent -> type
img.rendering_intent = type -> type
The type of rendering intent. See https://www.cambridgeincolour.com/tutorials/color-space-conversion.htm
A RenderingIntent constant.
A RenderingIntent constant.
img.rows -> integer
The height of the image in pixels. Get-only.
img.scene -> integer
The scene number assigned to the image the last time the image was written to a multi-image image file. Don't confuse this attribute with
ImageList's scene attribute, which denotes the image to which Image methods will be sent.
img.start_loop -> true or false
img.start_loop = true or false -> true or false
Indicates the first image in an animation.
img.ticks_per_second -> integer
image.ticks_per_second = integer -> integer
Gets/sets the number of ticks per second. This attribute is used in conjunction with the delay attribute to establish the amount of time that must elapse between frames in an animation.The default is 100.
The current number of ticks per second
img.total_colors -> integer
The number of colors in the image after quantization. Set by
quantize [ImageList][Image] if the measure_error argument
is true. Get-only.
img.total_ink_density -> float
The total ink density for a CMYK image. Total Ink Density (TID) is determined by adding the CMYK values in the darkest shadow area in an image. Get-only.
img.transparent_color -> string
img.transparent_color = string or pixel -> string or
pixel
Specify the name of the transparent color as a String.
A transparent color name or Pixel object.
img.units -> type
img.units = type -> type
Units of image resolution.
A ResolutionType constant.
A ResolutionType constant.
img.virtual_pixel_method -> method
img.virtual_pixel_method = method -> method
Specify how "virtual pixels" behave. Virtual pixels are pixels that are outside the boundaries of the image. Methods such as blur_image, sharpen, and wave use virtual pixels.
The virtual pixel method can be any one of the following
VirtualPixelMethod constants:
Some of these values are not supported by older versions of ImageMagick. To see what values are available, enter the following code in irb:
Magick::VirtualPixelMethod.values {|v| puts v}
A VirtualPixelMethod constant.
img.virtual_pixel_method = Magick::TransparentVirtualPixelMethod
img.x_resolution -> float
img.x_resolution = float -> float
img.y_resolution -> float
img.y_resolution = float -> float