Platforms to show: All Mac Windows Linux Cross-Platform

Back to IMImageQ8MBS class.

Next items

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
AdaptiveThreshold selects an individual threshold for each pixel based on the range of intensity values in its local neighborhood.

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
Adds random noise to the image.

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
Transforms an image as dictated by the affine matrix.

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
Adds an image to the image list.

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
AutoGammaImage extract the 'mean' from the image and adjust the image to try make set its gamma appropriatally.

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
AutoGammaImage extract the 'mean' from the image and adjust the image to try make set its gamma appropriatally.

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
AutoLevelImage adjusts the levels of a particular image channel by scaling the minimum and maximum values to the full quantum range.

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
AutoLevelImage adjusts the levels of a particular image channel by scaling the minimum and maximum values to the full quantum range.

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
The Average() method takes a set of images and averages them together.

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
Changes the value of individual pixels based on the intensity of each pixel channel.

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
BlackThreshold is like Threshold but forces all pixels below the threshold into black while leaving all pixels above the threshold unchanged.

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
The expected size for this image written to a file.

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
Blurs an image.

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
Blurs an image.

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
Surrounds the image with a border of the color defined by the bordercolor member of the image.

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
Changes the brightness and/or contrast of an image. It converts the brightness and contrast parameters into slope and intercept and calls a polynomical function to apply to the image.

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
Changes the brightness and/or contrast of an image. It converts the brightness and contrast parameters into slope and intercept and calls a polynomical function to apply to the image.

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
Charcoal creates a new image that is a copy of an existing one with the edge highlighted.

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
Chop removes a region of an image and collapses the image to occupy the removed portion.

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
Sets the image clip mask based any clipping path information if it exists.

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
Creates a copy of this image object.

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
CloneImageAttributes() clones one or more image attributes.

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
Clones one or more image profiles.

Returns false on any error and true on success.

IMImageQ8MBS.Close

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The destructor.

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
Replaces each color value in the given image, by using it as an index to lookup a replacement color value in a Color Look UP Table in the form of an image.

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
Replaces each color value in the given image, by using it as an index to lookup a replacement color value in a Color Look UP Table in the form of an image.

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
CoalesceImages composites a set of images while respecting any page offsets and disposal methods.

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
Method ColorizeImage creates a new image that is a copy of an existing one with the image pixels colorized.

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
Combines one or more images into a single image.

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
CompareImageLayers() compares each image with the next in a sequence and returns the minimum bounding region of all the pixel differences (of the mageLayerMethod specified) it discovers.

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
Returns the second image composited onto the first at the specified offsets.

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
Consolidates a sequence of CMYK images.

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
Enhances the intensity differences between the lighter and darker elements of the image.

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
Copies the Image Magick Image and returns a Xojo picture.
Example
dim image as IMImageQ8MBS // your image
Canvas1.Backdrop=image.CopyPicture

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
Copies a portion of the Image Magick Image and returns a Xojo picture.
Example
dim image as IMImageQ8MBS // your image
Canvas1.Backdrop=image.CopyPicture(0,0,image.Width,image.Height)

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
Copies the mask of the Image Magick Image and returns a Xojo picture.
Example
dim image as IMImageQ8MBS // your image
Canvas1.Backdrop=image.CopyPictureMask

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
Copies a portion of the mask of the Image Magick Image and returns a Xojo picture.
Example
dim image as IMImageQ8MBS // your image
Canvas1.Backdrop=image.CopyPictureMask(0,0,image.Width,image.Height)

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:

Next items

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


The biggest plugin in space...