IMImage7MBS.Charcoal(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

Creates a new image that is a copy of an existing one with the edge highlighted.

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

radius: the radius of the pixel neighborhood.
sigma: the standard deviation of the Gaussian, in pixels.

See CharcoalImage function in ImageMagick documentation.

IMImage7MBS.Chop(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

Removes a region of an image and collapses the image to occupy the removed portion.

rect: Define the region of the image to chop.

See ChopImage function in ImageMagick documentation.

IMImage7MBS.CLAHE(Width as Integer, Height as Integer, NumberBins as Integer, ClipLimit 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

Is a variant of adaptive histogram equalization in which the contrast amplification is limited, so as to reduce this problem of noise amplification.

width: the width of the tile divisions to use in horizontal direction.
height: the height of the tile divisions to use in vertical direction.
NumberBins: number of bins for histogram ("dynamic range").
ClipLimit: contrast limit for localised changes in contrast. A limit less than 1 results in standard non-contrast limited AHE.

See CLAHEImage function in ImageMagick documentation.

IMImage7MBS.Clamp as Boolean

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

Clamps image pixels.

Set each pixel whose value is below zero to zero and any the pixel whose value is above the quantum range to the quantum range (e.g. 65535) otherwise the pixel value remains unchanged.

See xx function in ImageMagick documentation.

IMImage7MBS.Clip as Boolean

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

Clips along the first path from the 8BIM profile, if present.

See ClipImage function in ImageMagick documentation.

IMImage7MBS.Clone as IMImage7MBS

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

Copies an image and returns the copy as a new image object.

See CloneImage function in ImageMagick documentation.

IMImage7MBS.CloneImageProfiles(SourceImage 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

Clones one or more image profiles.

See xx function in ImageMagick documentation.

IMImage7MBS.CloneProperties(Source 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

Clones all the image properties from source image to current image.

See CloneImageProperties function in ImageMagick documentation.

IMImage7MBS.Clut(clutImage as IMImage7MBS, pixelInterpolateMethod 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

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.
method: the pixel interpolation method.

See ClutImage function in ImageMagick documentation.

IMImage7MBS.CoalesceImages as IMImage7MBS

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

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. A new image sequence is returned with all images the same size as the first images virtual canvas and composited with the next image in the sequence.

See CoalesceImages function in ImageMagick documentation.

IMImage7MBS.ColorDecisionList(ColorCorrectionCollection 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

Accepts a lightweight Color Correction Collection (CCC) file which solely contains one or more color corrections and applies the correction to the image.

Here is a sample CCC file:

<ColorCorrectionCollection xmlns="urn:ASC:CDL:v1.2">
<ColorCorrection id="cc03345">
<SOPNode>
<Slope> 0.9 1.2 0.5 </Slope>
<Offset> 0.4 -0.5 0.6 </Offset>
<Power> 1.0 0.8 1.5 </Power>
</SOPNode>
<SATNode>
<Saturation> 0.85 </Saturation>
</SATNode>
</ColorCorrection>
</ColorCorrectionCollection>
which includes the slop, offset, and power for each of the RGB channels as well as the saturation.

ColorCorrectionCollection: the color correction collection in XML.

See ColorDecisionListImage function in ImageMagick documentation.

IMImage7MBS.Colorize(opacity as string, pixelInfo as IMPixelInfo7MBS) as IMImage7MBS

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

Blends the fill color with each pixel in the image.

A percentage blend is specified with opacity. Control the application of different color components by specifying a different percentage for each component (e.g. 90/100/10 is 90 red, 100 green, and 10 blue).

blend: A character string indicating the level of blending as a percentage.
colorize: A color value.

See ColorizeImage function in ImageMagick documentation.

IMImage7MBS.ColorspaceType as Integer

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

Returns the potential type of image: sRGBColorspaceType, RGBColorspaceType, GRAYColorspaceType, etc.

See xx function in ImageMagick documentation.

IMImage7MBS.Combine(Colorspace 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

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.

See CombineImages function in ImageMagick documentation.

IMImage7MBS.CompareImagesLayers(ImageLayerMethod 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

Compares each image with the next in a sequence and returns the minimum bounding region of all the pixel differences (of the LayerMethod 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.

method: the layers type to compare images with. Must be one of... CompareAnyLayer, CompareClearLayer, CompareOverlayLayer.

See xx function in ImageMagick documentation.

IMImage7MBS.ComplexImages(ComplexOperator 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

Performs complex mathematics on an image sequence.

See ComplexImages function in ImageMagick documentation.

IMImage7MBS.Composite(ComposeOperator as integer, Image as IMImage7MBS, ClipToSelf as boolean, xOffset as integer, yOffset as integer)

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

Returns the second image composited onto the first at the specified offset, using the specified composite method.

See xx function in ImageMagick documentation.

IMImage7MBS.CompositeLayers(CompositeOperator as Integer, Source as IMImage7MBS, XOffset as Integer, YOffset as Integer)

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

Compose the source image sequence over the destination image sequence, starting with the current image in both lists.

Each layer from the two image lists are composted together until the end of one of the image lists is reached. The offset of each composition is also adjusted to match the virtual canvas offsets of each layer. As such the given offset is relative to the virtual canvas, and not the actual image.

Composition uses given x and y offsets, as the 'origin' location of the source images virtual canvas (not the real image) allowing you to compose a list of 'layer images' into the destiantioni images. This makes it well sutiable for directly composing 'Clears Frame Animations' or 'Coaleased Animations' onto a static or other 'Coaleased Animation' destination image list. GIF disposal handling is not looked at.

Special case:- If one of the image sequences is the last image (just a single image remaining), that image is repeatally composed with all the images in the other image list. Either the source or destination lists may be the single image, for this situation.

In the case of a single destination image (or last image given), that image will ve cloned to match the number of images remaining in the source image list.

This is equivelent to the "-layer Composite" Shell API operator.

See xx function in ImageMagick documentation.

IMImage7MBS.CompressColormap as Boolean

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

compresses an image colormap by removing any duplicate or unused color entries.

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

IMImage7MBS.ConsolidateCMYKImages as IMImage7MBS

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

Consolidates separate C, M, Y, and K planes into a single image.

See ConsolidateCMYKImages function in ImageMagick documentation.

IMImage7MBS.Constructor(columns as Integer, Rows as Integer, map as String, StorageType as Integer, Pixels as MemoryBlock)

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

Returns an image from the pixel data you supply.

The pixel data must be in scanline order top-to-bottom. The data can be char, short int, int, float, or double. Float and double require the pixels to be normalized [0..1], otherwise [0..QuantumRange]. For example, to create a 640x480 image from unsigned red-green-blue character data, use:

image = new IMImage7MBS(640,480,"RGB", kCharPixel, pixels)

columns: width in pixels of the image.
rows: height in pixels of the image.
map: This string reflects the expected ordering of the pixel array. It can be any combination or order of R = red, G = green, B = blue, A = alpha (0 is transparent), O = opacity (0 is opaque), C = cyan, Y = yellow, M = magenta, K = black, I = intensity (for grayscale), P = pad.
storage: Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..QuantumRange]. Choose from these types: CharPixel, DoublePixel, FloatPixel, IntegerPixel, LongPixel, QuantumPixel, or ShortPixel.
pixels: This array of values contain the pixel components as defined by map and type. You must preallocate this array where the expected length varies depending on the values of width, height, map, and type.

See ConstituteImage function in ImageMagick documentation.

See also:

• Constructor(info as IMImageInfo7MBS)
• Constructor(info as IMImageInfo7MBS, width as integer, height as integer, background as IMPixelInfo7MBS)
• Constructor(Pic as Picture)

IMImage7MBS.Constructor(info as IMImageInfo7MBS)

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.

Returns a pointer to an image initialized to default values.
Many of the image default values are set from the image info. For example, filename, compression, depth, background color, and others.

See AcquireImage function in ImageMagick documentation.

See also:

• Constructor(columns as Integer, Rows as Integer, map as String, StorageType as Integer, Pixels as MemoryBlock)
• Constructor(info as IMImageInfo7MBS, width as integer, height as integer, background as IMPixelInfo7MBS)
• Constructor(Pic as Picture)

IMImage7MBS.Constructor(info as IMImageInfo7MBS, width as integer, height as integer, background as IMPixelInfo7MBS)

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

Creates a blank image canvas of the specified size and background color.

info: the image details.
width: the image width.
height: the image height.
background: the image color.

See NewMagickImage function in ImageMagick documentation.

See also:

• Constructor(columns as Integer, Rows as Integer, map as String, StorageType as Integer, Pixels as MemoryBlock)
• Constructor(info as IMImageInfo7MBS)
• Constructor(Pic as Picture)

IMImage7MBS.Constructor(Pic as Picture)

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

Creates a new picture based on Xojo picture.

Creates a new image and uses SetPicture method to fill it.

See NewMagickImage function in ImageMagick documentation.

See also:

• Constructor(columns as Integer, Rows as Integer, map as String, StorageType as Integer, Pixels as MemoryBlock)
• Constructor(info as IMImageInfo7MBS)
• Constructor(info as IMImageInfo7MBS, width as integer, height as integer, background as IMPixelInfo7MBS)

IMImage7MBS.Contrast(sharpen as boolean) as Boolean

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

Enhances the intensity differences between the lighter and darker elements of the image.

Set sharpen to a True to increase the image contrast otherwise the contrast is reduced.

sharpen: Increase or decrease image contrast.

See ContrastImage function in ImageMagick documentation.

IMImage7MBS.ContrastStretch(BlackPoint as double, WhitePoint 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

Is a simple image enhancement technique that attempts to improve the contrast in an image by 'stretching' the range of intensity values it contains to span a desired range of values.

It differs from the more sophisticated histogram equalization in that it can only apply a linear scaling function to the image pixel values. As a result the 'enhancement' is less harsh.

BlackPoint: the black point.
WhitePoint: the white point.

See ContrastStretchImage function in ImageMagick documentation.

IMImage7MBS.Convolve(kernelInfo as IMKernelInfo7MBS) 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 custom convolution kernel to the image.

See ConvolveImage function in ImageMagick documentation.

IMImage7MBS.CopyPicture as Picture

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

Copies RGB or gray pixels into a new Xojo 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.

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 function in ImageMagick documentation.

IMImage7MBS.CreateHBITMAP as Ptr

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

Creates a Windows HBITMAP from an image.

See ImageToHBITMAP function in ImageMagick documentation.

IMImage7MBS.Crop(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

Extracts a region of the image starting at the offset defined by geometry.

Region must be fully defined, and no special handling of geometry flags is performed.

See CropImage function in ImageMagick documentation.

IMImage7MBS.CropToTiles(CropGeometry as string) as IMImage7MBS

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

Crops a single image, into a possible list of tiles.

This may include a single sub-region of the image. This basically applies all the normal geometry flags for Crop.

CropGeometry: A crop geometry string.

See CropImageToTiles function in ImageMagick documentation.

IMImage7MBS.CycleColormap(displace 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

Displaces an image's colormap by a given number of positions.

If you cycle the colormap a number of times you can produce a psychodelic effect.

WARNING: this assumes an images colormap is in a well know and defined order. Currently Imagemagick has no way of setting that order.

displace: displace the colormap this amount.

See CycleColormap function in ImageMagick documentation.