Platforms to show: All Mac Windows Linux Cross-Platform

Back to IMImage7MBS class.

Previous items Next items

IMImage7MBS.RemoveImageProfile(name as string) as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Removes a named profile from the image and returns its value.

See xx function in ImageMagick documentation.

IMImage7MBS.RemoveProperty(Key as String)

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Removes a property from the image and returns its value.

See RemoveImageProperty function in ImageMagick documentation.

IMImage7MBS.RemoveZeroDelayLayers

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Removes any image that as a zero delay time.

Such images generally represent intermediate or partial updates in GIF animations used for file optimization. They are not ment to be displayed to users of the animation. Viewable images in an animation should have a time delay of 3 or more centi-seconds (hundredths of a second).

However if all the frames have a zero time delay, then either the animation is as yet incomplete, or it is not a GIF animation. This a non-sensible situation, so no image will be removed and a 'Zero Time Animation' warning (exception) given.

No warning will be given if no image was removed because all images had an appropriate non-zero time delay set.

Due to the special requirements of GIF disposal handling, GIF animations should be coalesced first, before calling this function, though that is not a requirement.

See RemoveZeroDelayLayers function in ImageMagick documentation.

IMImage7MBS.Resample(xResolution as Double, yResolution as Double, filter as Integer) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Resize image in terms of its pixel size, so that when displayed at the given resolution it will be the same size in terms of real world units as the original image at the original resolution.

xResolution: the new image x resolution.
yResolution: the new image y resolution.
filter: Image filter to use.

See ResampleImage function in ImageMagick documentation.

IMImage7MBS.ResetImageProfileIterator

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Resets the image profile iterator.

Use it in conjunction with GetNextImageProfile to iterate over all the profiles associated with an image.

See ResetImageProfileIterator function in ImageMagick documentation.

IMImage7MBS.ResetPropertyIterator

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Resets the image properties iterator.

Use it in conjunction with GetNextImageProperty() to iterate over all the values associated with an image property.
See ResetImagePropertyIterator function in ImageMagick documentation.

IMImage7MBS.Resize(columns as integer, rows as integer, FilterID as integer) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Scales an image to the desired dimensions, using the given filter (see AcquireFilterInfo()).

If an undefined filter is given the filter defaults to Mitchell for a colormapped image, a image with a matte channel, or if the image is enlarged. Otherwise the filter defaults to a Lanczos.

columns: the number of columns in the scaled image.
rows: the number of rows in the scaled image.
filterID: Image filter to use.

See ResizeImage function in ImageMagick documentation.

IMImage7MBS.Roll(x as integer, y as integer) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Offsets an image as defined by x and y offsets.

x: the number of columns to roll in the horizontal direction.
y: the number of rows to roll in the vertical direction.

See RollImage function in ImageMagick documentation.

IMImage7MBS.Rotate(degrees as double) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Creates a new image that is a rotated copy of an existing one.

Positive angles rotate counter-clockwise (right-hand rule), while negative angles rotate clockwise. Rotated images are usually larger than the originals and have 'empty' triangular corners. X axis. Empty triangles left over from shearing the image are filled with the background color defined by member 'background_color' of the image. RotateImage allocates the memory necessary for the new Image structure and returns a pointer to the new image.

degrees: Specifies the number of degrees to rotate the image.

See RotateImage function in ImageMagick documentation.

IMImage7MBS.RotationalBlur(Angle as double) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Applies a radial blur to the image.

angle: the angle of the radial blur.
blur: the blur.

See RotationalBlurImage function in ImageMagick documentation.

IMImage7MBS.Sample(columns as integer, rows as integer) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Scales an image to the desired dimensions with pixel sampling.

Unlike other scaling methods, this method does not introduce any additional color into the scaled image.

columns: the number of columns in the sampled image.
rows: the number of rows in the sampled image.

See SampleImage function in ImageMagick documentation.

IMImage7MBS.Scale(columns as integer, rows as integer) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Changes the size of an image to the given dimensions.

columns: the number of columns in the scaled image.
rows: the number of rows in the scaled image.

See ScaleImage function in ImageMagick documentation.

IMImage7MBS.Segment(colorspaceType as Integer, verbose as Boolean, clusterThreshold as Double, smoothThreshold as Double) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Segment an image by analyzing the histograms of the color components and identifying units that are homogeneous with the fuzzy C-means technique.

colorspace: Indicate the colorspace.
verbose: Set to true to print detailed information about the identified classes.
clusterThreshold: This represents the minimum number of pixels contained in a hexahedra before it can be considered valid (expressed as a percentage).
smoothThreshold: the smoothing threshold eliminates noise in the second derivative of the histogram. As the value is increased, you can expect a smoother second derivative.

Returns true on success.
See SegmentImage function in ImageMagick documentation.

IMImage7MBS.SelectiveBlur(radius as double, sigma as double, threshold as double) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Selectively blur pixels within a contrast threshold.

It is similar to the unsharpen mask that sharpens everything with contrast above a certain threshold.

radius: the radius of the Gaussian, in pixels, not counting the center pixel.
sigma: the standard deviation of the Gaussian, in pixels.
threshold: only pixels within this contrast threshold are included in the blur operation.

See SelectiveBlurImage function in ImageMagick documentation.

IMImage7MBS.Separate(ChannelType as Integer) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Separates a channel from the image and returns it as a grayscale image.

See ChannelType constants for parameter.
See SeparateImage function in ImageMagick documentation.

IMImage7MBS.SeparateImages as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Returns a separate grayscale image for each channel specified.

See SeparateImages function in ImageMagick documentation.

IMImage7MBS.SetGray as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Returns true if all the pixels in the image have the same red, green, and blue intensities and changes the type of the image to bi-level or grayscale.

See xx function in ImageMagick documentation.

IMImage7MBS.SetImageAlphaChannel(AlphaChannelOption as Integer) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Activates, deactivates, resets, or sets the alpha channel.

The alpha channel types: ActivateAlphaChannel, AssociateAlphaChannel, CopyAlphaChannel, DeactivateAlphaChannel, DisassociateAlphaChannel, ExtractAlphaChannel, OffAlphaChannel, OnAlphaChannel, OpaqueAlphaChannel, SetAlphaChannel, ShapeAlphaChannel, and TransparentAlphaChannel.

see AlphaChannel constants.

See SetImageAlphaChannel function in ImageMagick documentation.

IMImage7MBS.SetImageColorMetric(other as IMImage7MBS) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Measures the difference between colors at each pixel location of two images.

A value other than 0 means the colors match exactly. Otherwise an error measure is computed by summing over all pixels in an image the distance squared in RGB space between each image pixel and its corresponding pixel in the reconstruct image. The error measure is assigned to these image members:

  • mean_error_per_pixel: The mean error for any single pixel in the image.
  • normalized_mean_error: The normalized mean quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in the image.
  • normalized_maximum_error: The normalized maximum quantization error for any single pixel in the image. This distance measure is normalized to a range between 0 and 1. It is independent of the range of red, green, and blue values in your image.

A small normalized mean square error, accessed as image->normalized_mean_error, suggests the images are very similar in spatial layout and color.

See SetImageColorMetric function in ImageMagick documentation.

IMImage7MBS.SetImageColorspace(Colorspace as integer) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the colorspace member of the Image object.

See SetImageColorspace function in ImageMagick documentation.

IMImage7MBS.SetImageDepth(depth as Integer) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the depth of the image.

See SetImageDepth function in ImageMagick documentation.

IMImage7MBS.SetImageProfile(name as string, ProfileData as string) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Adds a named profile to the image.

If a profile with the same name already exists, it is replaced. This method differs from the ProfileImage() method in that it does not apply CMS color profiles.

name: the profile name, for example icc, exif, and 8bim (8bim is the Photoshop wrapper for iptc profiles).
profile: A String that contains the named profile.


See SetImageProfile function in ImageMagick documentation.

IMImage7MBS.SetImageType(type as Integer) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets the type of image.

Choose from these types:
Bilevel Grayscale GrayscaleMatte Palette PaletteMatte TrueColor TrueColorMatte ColorSeparation ColorSeparationMatte OptimizeType

See SetImageType function in ImageMagick documentation.

IMImage7MBS.SetMonochrome as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Checks if image is monochrome and changes type to black & white.

Returns true if all the pixels in the image have the same red, green, and blue intensities and the intensity is either 0 or QuantumRange and changes the type of the image to bi-level.

See SetImageMonochrome function in ImageMagick documentation.

IMImage7MBS.SetPicture(pic as Picture) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sets pixel to the values in the picture.

You must make sure you have the right color space to make this work well with colorspaces.
Xojo on Mac uses Generic RGB, while Windows may use the colorspace of the display.

Returns true in case of success and false in case of failure.
As conversion between various quantum depths can be slow, please use rarely.

See also ExportPixels and ImportPixels to read/write pixel data to/from memory blocks.
See GetAuthenticPixels and SyncAuthenticPixels functions in ImageMagick documentation.

IMImage7MBS.SetProperty(PropertyKey as String, Value as String) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Saves the given string value either to specific known attribute or to a freeform property string.

Attempting to set a property that is normally calculated will produce an exception.
See SetImageProperty function in ImageMagick documentation.

IMImage7MBS.Shade(gray as boolean, azimuth as double, elevation as double) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Shines a distant light on an image to create a three-dimensional effect.

You control the positioning of the light with azimuth and elevation; azimuth is measured in degrees off the x axis and elevation is measured in pixels above the Z axis.

gray: A value other than zero shades the intensity of each pixel.
azimuth, elevation: Define the light source direction.

See ShadeImage function in ImageMagick documentation.

IMImage7MBS.Sharpen(radius as double, sigma as double) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Sharpens the image.

We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma). For reasonable results, radius should be larger than sigma. Use a radius of 0 and Sharpen selects a suitable radius for you.

Using a separable kernel would be faster, but the negative weights cancel out on the corners of the kernel producing often undesirable ringing in the filtered result; this can be avoided by using a 2D gaussian shaped image sharpening kernel instead.

radius: the radius of the Gaussian, in pixels, not counting the center pixel.
sigma: the standard deviation of the Laplacian, in pixels.

See SharpenImage function in ImageMagick documentation.

IMImage7MBS.Shave(rect as IMRectangleInfo7MBS) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Shaves pixels from the image edges.

It allocates the memory necessary for the new Image structure and returns a pointer to the new image.

Shave returns a pointer to the shaved image. A null image is returned if there is a memory shortage or if the image width or height is zero.

rect: Specifies a RectangleInfo which defines the region of the image to crop.

See ShaveImage function in ImageMagick documentation.

IMImage7MBS.Shear(Xshear as double, Yshear as double) as IMImage7MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Creates a new image that is an image copy of an existing one.

Shearing slides one edge of an image along the X or Y axis, creating a parallelogram. An X direction shear slides an edge along the X axis, while a Y direction shear slides an edge along the Y axis. The amount of the shear is controlled by a shear angle. For X direction shears, Xshear is measured relative to the Y axis, and similarly, for Y direction shears Yshear is measured relative to the X axis. Empty triangles left over from shearing the image are filled with the background color defined by member 'backgroundColor' of the image.. Shear() allocates the memory necessary for the new Image structure and returns a pointer to the new image.

See ShearImage function in ImageMagick documentation.

Previous items Next items

The items on this page are in the following plugins: MBS GraphicsMagick Plugin.


💬 Ask a question or report a problem
The biggest plugin in space...