Platforms to show: All Mac Windows Linux Cross-Platform
Back to IMImageQ8MBS class.
IMImageQ8MBS.AdaptiveThreshold(width as Integer, height as Integer, offset as Integer) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
This allows for thresholding of an image whose global intensity histogram doesn't contain distinctive peaks.
Sets the last exception property.
width: The width of the local neighborhood.
height: The height of the local neighborhood.
offset: The mean offset.
For more details please check the ImageMagick documentation.
IMImageQ8MBS.AddNoise(NoiseType as Integer) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Constants
UndefinedNoise | =0 |
UniformNoise | =1 |
GaussianNoise | =2 |
MultiplicativeGaussianNoise | =3 |
ImpulseNoise | =4 |
LaplacianNoise | =5 |
PoissonNoise | =6 |
For more details please check the ImageMagick documentation.
Sets the last exception property.
IMImageQ8MBS.AffineTransformImage(matrix as IMImageAffineMatrixQ8MBS) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 11.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
IMImageQ8MBS.AppendImageToList(img as IMImageQ8MBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
For more details please check the ImageMagick documentation.
IMImageQ8MBS.AutoGammaImage as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns true on success or false on failure.
IMImageQ8MBS.AutoGammaImageChannel(ChannelType as Integer) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns true on success or false on failure.
channelType: The channels to auto-level. If the special 'SyncChannels' flag is set all given channels is adjusted in the same way using the mean average of those channels.
Constants for channel:
const UndefinedChannel | = 0 |
const RedChannel | = &h0001 |
const GrayChannel | = &h0001 |
const CyanChannel | = &h0001 |
const GreenChannel | = &h0002 |
const MagentaChannel | = &h0002 |
const BlueChannel | = &h0004 |
const YellowChannel | = &h0004 |
const AlphaChannel | = &h0008 |
const OpacityChannel | = &h0008 |
const BlackChannel | = &h0020 |
const IndexChannel | = &h0020 |
const AllChannels | = &h7fffffff |
IMImageQ8MBS.AutoLevelImage as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns true on success or false on failure.
IMImageQ8MBS.AutoLevelImageChannel(ChannelType as Integer) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns true on success or false on failure.
ChannelType: The channels to auto-level. If the special 'SyncChannels' flag is set the min/max/mean value of all given channels is used for all given channels, to all channels in the same way.
Constants for channel:
const UndefinedChannel | = 0 |
const RedChannel | = &h0001 |
const GrayChannel | = &h0001 |
const CyanChannel | = &h0001 |
const GreenChannel | = &h0002 |
const MagentaChannel | = &h0002 |
const BlueChannel | = &h0004 |
const YellowChannel | = &h0004 |
const AlphaChannel | = &h0008 |
const OpacityChannel | = &h0008 |
const BlackChannel | = &h0020 |
const IndexChannel | = &h0020 |
const AllChannels | = &h7fffffff |
IMImageQ8MBS.Average as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Each image in the set must have the same width and height. Average() returns a single image with each corresponding pixel component of each image averaged. On failure, a nil image is returned and exception describes the reason for the failure.
Sets the last exception property.
For more details please check the ImageMagick documentation.
IMImageQ8MBS.BilevelChannel(channel as Integer, threshold as Double) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The result is a high-contrast image.
channel: The channel type.
threshold: define the threshold values.
Constants for channel:
const UndefinedChannel | = 0 |
const RedChannel | = &h0001 |
const GrayChannel | = &h0001 |
const CyanChannel | = &h0001 |
const GreenChannel | = &h0002 |
const MagentaChannel | = &h0002 |
const BlueChannel | = &h0004 |
const YellowChannel | = &h0004 |
const AlphaChannel | = &h0008 |
const OpacityChannel | = &h0008 |
const BlackChannel | = &h0020 |
const IndexChannel | = &h0020 |
const AllChannels | = &h7fffffff |
For more details please check the ImageMagick documentation.
IMImageQ8MBS.BlackThreshold(threshold as string) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
No exceptions are generated.
threshold: Define the threshold value. (ASCII string)
For more details please check the ImageMagick documentation.
IMImageQ8MBS.BlobSize as Integer
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
For more details please check the ImageMagick documentation.
IMImageQ8MBS.Blur(radius as Double, sigma as Double) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma) . For reasonable results, the radius should be larger than sigma. Use a radius of 0 and BlurImage selects a suitable radius for you.
radius: The radius of the Gaussian, in pixels, not counting the center pixel.
sigma: The standard deviation of the Gaussian, in pixels.
For more details please check the ImageMagick documentation.
IMImageQ8MBS.BlurImageChannel(channel as Integer, radius as Double, sigma as Double) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
We convolve the image with a Gaussian operator of the given radius and standard deviation (sigma) . For reasonable results, the radius should be larger than sigma. Use a radius of 0 and BlurImageChannel selects a suitable radius for you.
channel: The channel type.
radius: The radius of the Gaussian, in pixels, not counting the center pixel.
sigma: The standard deviation of the Gaussian, in pixels.
Constants for channel:
const UndefinedChannel | = 0 |
const RedChannel | = &h0001 |
const GrayChannel | = &h0001 |
const CyanChannel | = &h0001 |
const GreenChannel | = &h0002 |
const MagentaChannel | = &h0002 |
const BlueChannel | = &h0004 |
const YellowChannel | = &h0004 |
const AlphaChannel | = &h0008 |
const OpacityChannel | = &h0008 |
const BlackChannel | = &h0020 |
const IndexChannel | = &h0020 |
const AllChannels | = &h7fffffff |
For more details please check the ImageMagick documentation.
IMImageQ8MBS.BorderImage(x as Integer, y as Integer, width as Integer, height as Integer) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 11.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The width and height of the border are defined by the corresponding parameters.
IMImageQ8MBS.BrightnessContrastImage(brightness as Double, contrast as Double) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns true on success or false on failure.
brightness: the brightness percent (-100 .. 100).
contrast: the contrast percent (-100 .. 100).
IMImageQ8MBS.BrightnessContrastImageChannel(ChannelType as Integer, brightness as Double, contrast as Double) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns true on success or false on failure.
brightness: the brightness percent (-100 .. 100).
contrast: the contrast percent (-100 .. 100).
ChannelType: The channels to use.
Constants for channel:
const UndefinedChannel | = 0 |
const RedChannel | = &h0001 |
const GrayChannel | = &h0001 |
const CyanChannel | = &h0001 |
const GreenChannel | = &h0002 |
const MagentaChannel | = &h0002 |
const BlueChannel | = &h0004 |
const YellowChannel | = &h0004 |
const AlphaChannel | = &h0008 |
const OpacityChannel | = &h0008 |
const BlackChannel | = &h0020 |
const IndexChannel | = &h0020 |
const AllChannels | = &h7fffffff |
IMImageQ8MBS.Charcoal(radius as Double, sigma as Double) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.4 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
radius: the radius of the pixel neighborhood.
sigma: The standard deviation of the Gaussian, in pixels.
Returns nil on any error.
Sets the last exception property.
IMImageQ8MBS.Chop(x as Integer, y as Integer, width as Integer, height as Integer) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 6.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns nil on any error.
Sets the last exception property.
IMImageQ8MBS.ClipPath(path as string, inside as boolean) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
pathname: | name of clipping path resource. If name is preceded by #, use clipping path numbered by name. |
inside: | if true, later operations take effect inside clipping path. Otherwise later operations take effect outside clipping path. |
Returns true on success and false on any error.
IMImageQ8MBS.Clone as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
For more details please check the ImageMagick documentation.
IMImageQ8MBS.CloneImageAttributes(image as IMImageAttributeQ8MBS) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 6.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns false on any error.
IMImageQ8MBS.CloneImageProfiles(SourceImage as IMImageQ8MBS) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns false on any error and true on success.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
There is no need to call this method except you want to free all resources used by this object now without waiting for Xojo to do it for you.
IMImageQ8MBS.ClutImage(clutImage as IMImageQ8MBS) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The values are extracted along a diagonal of the CLUT image so either a horizontal or vertial gradient image can be used.
Typically this is used to either re-color a gray-scale image according to a color gradient in the CLUT image, or to perform a freeform histogram (level) adjustment according to the (typically gray-scale) gradient in the CLUT image.
When the 'channel' mask includes the matte/alpha transparency channel but one image has no such channel it is assumed that that image is a simple gray-scale image that will effect the alpha channel values, either for gray-scale coloring (with transparent or semi-transparent colors), or a histogram adjustment of existing alpha channel values. If both images have matte channels, direct and normal indexing is applied, which is rarely used.
ClutImage: the color lookup table image for replacement color values.
Returns true on success or false on failure.
IMImageQ8MBS.ClutImageChannel(ChannelType as Integer, clutImage as IMImageQ8MBS) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The values are extracted along a diagonal of the CLUT image so either a horizontal or vertial gradient image can be used.
Typically this is used to either re-color a gray-scale image according to a color gradient in the CLUT image, or to perform a freeform histogram (level) adjustment according to the (typically gray-scale) gradient in the CLUT image.
When the 'channel' mask includes the matte/alpha transparency channel but one image has no such channel it is assumed that that image is a simple gray-scale image that will effect the alpha channel values, either for gray-scale coloring (with transparent or semi-transparent colors), or a histogram adjustment of existing alpha channel values. If both images have matte channels, direct and normal indexing is applied, which is rarely used.
ClutImage: the color lookup table image for replacement color values.
ChannelType: The channels to use.
Returns true on success or false on failure.
Constants for channel:
const UndefinedChannel | = 0 |
const RedChannel | = &h0001 |
const GrayChannel | = &h0001 |
const CyanChannel | = &h0001 |
const GreenChannel | = &h0002 |
const MagentaChannel | = &h0002 |
const BlueChannel | = &h0004 |
const YellowChannel | = &h0004 |
const AlphaChannel | = &h0008 |
const OpacityChannel | = &h0008 |
const BlackChannel | = &h0020 |
const IndexChannel | = &h0020 |
const AllChannels | = &h7fffffff |
IMImageQ8MBS.CoalesceImages as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 6.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
GIF, MIFF, and MNG animation sequences typically start with an image background and each subsequent image varies in size and offset. CoalesceImages() returns a new sequence where each image in the sequence is the same size as the first and composited with the next image in the sequence.
Returns nil on any error.
Sets the last exception property.
IMImageQ8MBS.Colorize(opacity as string, PenColorRed as Integer, PenColorGreen as Integer, PenColorBlue as Integer, PenColorOpacity as Integer) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.4 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The colorization is controlled with the pen color and the opacity levels.
opacity: A character string indicating the level of opacity as a percentage (0-100).
PenColorRed, PenColorGreen, PenColorBlue and PenColorOpacity define the pen color used.
Returns nil on any error.
Sets the last exception property.
IMImageQ8MBS.Combine(channel as Integer) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
The grayscale value of the pixels of each image in the sequence is assigned in order to the specified channels of the combined image. The typical ordering would be image 1 => Red, 2 => Green, 3 => Blue, etc.
The lastexception property is set.
IMImageQ8MBS.CompareImageLayers(ImageLayerMethod as Integer) as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 8.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Images do NOT have to be the same size, though it is best that all the images are 'coalesced' (images are all the same size, on a flattened canvas, so as to represent exactly how an specific frame should look).
No GIF dispose methods are applied, so GIF animations must be coalesced before applying this image operator to find differences to them.
ImageLayerMethod:
the layers type to compare images with. Must be one of... CompareAnyLayer, CompareClearLayer, CompareOverlayLayer.
Can raise an exception.
IMImageQ8MBS.Composite(ComposeOperator as Integer, Image as IMImageQ8MBS, x as Integer, y as Integer)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
compose: Specifies an image composite operator.
Image: The second image.
x: An integer that specifies the column offset of the composited image.
y: An integer that specifies the row offset of the composited image.
No error code and exception!
IMImageQ8MBS.ConsolidateCMYKImages as IMImageQ8MBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 6.1 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns nil on any error.
Sets the last exception property.
IMImageQ8MBS.ContrastImage(sharpen as boolean) as Boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 15.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Returns true on success or false on failure.
Set sharpen to true to increase the image contrast otherwise the contrast is reduced.
IMImageQ8MBS.CopyPicture as picture
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 11.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Sets the last exception property.
Returns nil on any error.
This method works only for bitmap images.
See also:
IMImageQ8MBS.CopyPicture(x as Integer, y as Integer, width as Integer, height as Integer) as picture
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Sets the last exception property.
Returns nil on any error.
This method works only for bitmap images.
x and y are zero based.
See also:
IMImageQ8MBS.CopyPictureMask as picture
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 11.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Sets the last exception property.
Returns nil on any error.
This method works only for bitmap images.
See also:
IMImageQ8MBS.CopyPictureMask(x as Integer, y as Integer, width as Integer, height as Integer) as picture
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | Image Magick | MBS GraphicsMagick Plugin | 5.2 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Sets the last exception property.
Returns nil on any error.
This method works only for bitmap images.
x and y are zero based.
See also:
The items on this page are in the following plugins: MBS GraphicsMagick Plugin.