Platforms to show: All Mac Windows Linux Cross-Platform
Back to IMImage7MBS class.
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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 |
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.
The items on this page are in the following plugins: MBS GraphicsMagick Plugin.