Xojo Developer Conference
25/27th April 2018 in Denver.
MBS Xojo Conference
6/7th September 2018 in Munich, Germany.

Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

IMImageQ16MBS.CompareImageLayers(ImageLayerMethod as Integer) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 8.3 Yes Yes Yes Yes No
Function: 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.
Notes:
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.

Feedback, Comments & Corrections

IMImageQ16MBS.Composite(ComposeOperator as Integer, Image as IMImageQ16MBS, x as Integer, y as Integer)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.2 Yes Yes Yes Yes No
Function: Returns the second image composited onto the first at the specified offsets.
Notes:
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!

Feedback, Comments & Corrections

IMImageQ16MBS.ConsolidateCMYKImages as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 6.1 Yes Yes Yes Yes No
Function: Consolidates a sequence of CMYK images.
Notes:
Returns nil on any error.
Sets the last exception property.

Feedback, Comments & Corrections

IMImageQ16MBS.ContrastImage(sharpen as boolean) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 15.2 Yes Yes Yes Yes No
Function: Enhances the intensity differences between the lighter and darker elements of the image.
Notes:
Returns true on success or false on failure.
Set sharpen to true to increase the image contrast otherwise the contrast is reduced.

Feedback, Comments & Corrections

IMImageQ16MBS.CopyPicture as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 11.3 Yes Yes Yes Yes No
Function: Copies the Image Magick Image and returns a Realbasic picture.
Example:
dim image as IMImageQ16MBS // your image
Canvas1.Backdrop=image.CopyPicture
Notes:
Sets the last exception property.
Returns nil on any error.
This method works only for bitmap images.

See also:

Feedback, Comments & Corrections

IMImageQ16MBS.CopyPicture(x as Integer, y as Integer, width as Integer, height as Integer) as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.2 Yes Yes Yes Yes No
Function: Copies a portion of the Image Magick Image and returns a Realbasic picture.
Example:
dim image as IMImageQ16MBS // your image
Canvas1.Backdrop=image.CopyPicture(0,0,image.Width,image.Height)
Notes:
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:

Feedback, Comments & Corrections

IMImageQ16MBS.CopyPictureMask as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 11.3 Yes Yes Yes Yes No
Function: Copies the mask of the Image Magick Image and returns a Realbasic picture.
Example:
dim image as IMImageQ16MBS // your image
Canvas1.Backdrop=image.CopyPictureMask
Notes:
Sets the last exception property.
Returns nil on any error.
This method works only for bitmap images.

See also:

Feedback, Comments & Corrections

IMImageQ16MBS.CopyPictureMask(x as Integer, y as Integer, width as Integer, height as Integer) as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.2 Yes Yes Yes Yes No
Function: Copies a portion of the mask of the Image Magick Image and returns a Realbasic picture.
Example:
dim image as IMImageQ16MBS // your image
Canvas1.Backdrop=image.CopyPictureMask(0,0,image.Width,image.Height)
Notes:
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:

Feedback, Comments & Corrections

IMImageQ16MBS.CopyPixel(x as Integer, y as Integer) as IMColorQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.2 Yes Yes Yes Yes No
Function: Copies a pixel.
Notes:
Returns nil on any error.
This method works only for bitmap images.
x and y are zero based.

Feedback, Comments & Corrections

IMImageQ16MBS.CreateHBITMAP as Ptr
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 15.1 No Yes No Yes, Windows only No
Function: Creates a HBITMAP for the image for use with Windows Declares.
Notes: The HBITMAP returned needs to be freed when you are done with it or you risk having a memory leak.

Feedback, Comments & Corrections

IMImageQ16MBS.Crop(x as Integer, y as Integer, width as Integer, height as Integer) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 6.1 Yes Yes Yes Yes No
Function: Crop extracts a region of the image starting at the offset defined by geometry.
Notes:
Returns nil on any error.
Sets the last exception property.

Feedback, Comments & Corrections

IMImageQ16MBS.CropImageToTiles(CropGeometry as string) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 11.3 Yes Yes Yes Yes No
Function: Crops a single image, into a possible list of tiles.
Notes: This may include a single sub-region of the image. This basically applies all the normal geometry flags for Crop.

Feedback, Comments & Corrections

IMImageQ16MBS.CycleColormap(displace as Integer) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.2 Yes Yes Yes Yes No
Function: Displaces an image's colormap by a given number of positions.
Notes:
If you cycle the colormap a number of times you can produce a psychodelic effect.
Returns true on success.
displace: displace the colormap this amount.

Feedback, Comments & Corrections

IMImageQ16MBS.DecipherImage(passkey as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 11.3 Yes Yes Yes Yes No
Function: Converts cipher pixels to plain pixels.
Notes:
Passkey: decipher cipher pixels with this passphrase.
Returns true on success.

Feedback, Comments & Corrections

IMImageQ16MBS.DeconstructImages as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 6.1 Yes Yes Yes Yes No
Function: DeconstructImages() compares each image with the next in a sequence and returns the minimum bounding region of all differences from the first image.
Notes:
Returns nil on any error.
Sets the last exception property.

Feedback, Comments & Corrections

IMImageQ16MBS.DeleteImageAttribute(key as string) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 6.1 Yes Yes Yes Yes No
Function: DeleteImageAttribute() deletes an attribute from the image.
Notes: Returns false on any error.

Feedback, Comments & Corrections

IMImageQ16MBS.Despeckle() as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.1 Yes Yes Yes Yes No
Function: Reduces the speckle noise in an image while perserving the edges of the original image.
Notes:
Sets the last exception property.
For more details please check the ImageMagick documentation.

Feedback, Comments & Corrections

IMImageQ16MBS.DestroyImage
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.1 Yes Yes Yes Yes No
Function: Releases the memory used for this image and sets handle to 0.
Notes:
For more details please check the ImageMagick documentation.
The destructor will call this for you if release=true.

Feedback, Comments & Corrections

IMImageQ16MBS.DestroyImageAttributes
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 6.1 Yes Yes Yes Yes No
Function: Deallocates memory associated with the image attribute list.

Feedback, Comments & Corrections

IMImageQ16MBS.DestroyImageList
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.2 Yes Yes Yes Yes No
Function: Destroys the image list and sets the handle to 0.
Notes:
For more details please check the ImageMagick documentation.
The destructor will call this for you if release=true.

Feedback, Comments & Corrections

IMImageQ16MBS.DestroyImageProfiles
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.2 Yes Yes Yes Yes No
Function: Releases memory associated with an image profile map.

Feedback, Comments & Corrections

IMImageQ16MBS.DistortImage(DistortImageMethod as Integer, values() as Double, bestfit as boolean) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 12.5 Yes Yes Yes Yes No
Function: DistortImage() distorts an image using various distortion methods, by mapping color lookups of the source image to a new destination image usally of the same size as the source image, unless 'bestfit' is set to true.
Notes:
If 'bestfit' is enabled, and distortion allows it, the destination image is adjusted to ensure the whole source 'image' will just fit within the final destination image, which will be sized and offset accordingly. Also in many cases the virtual offset of the source image will be taken into account in the mapping.

If the '-verbose' control option has been set print to standard error the equicelent '-fx' formula with coefficients for the function, if practical.

A description of each parameter follows:
self: the image to be distorted.
m: the method of image distortion. ArcDistortion always ignores source image offset, and always 'bestfit' the destination image with the top left corner offset relative to the polar mapping center. Affine, Perspective, and Bilinear, do least squares fitting of the distrotion when more than the minimum number of control point pairs are provided. Perspective, and Bilinear, fall back to a Affine distortion when less than 4 control point pairs are provided. While Affine distortions let you use any number of control point pairs, that is Zero pairs is a No-Op (viewport only) distortion, one pair is a translation and two pairs of control points do a scale-rotate-translate, without any shearing.
values: arguments given.
bestfit: Attempt to 'bestfit' the size of the resulting image. This also forces the resulting image to be a 'layered' virtual canvas image. Can be overridden using 'distort:viewport' setting.

Extra Controls from Image meta-data (artifacts)...

  • "verbose" Output to stderr alternatives, internal coefficents, and FX equivalents for the distortion operation (if feasible). This forms an extra check of the distortion method, and allows users access to the internal constants IM calculates for the distortion.
  • "distort:viewport" Directly set the output image canvas area and offest to use for the resulting image, rather than use the original images canvas, or a calculated 'bestfit' canvas.
  • "distort:scale" Scale the size of the output canvas by this amount to provide a method of Zooming, and for super-sampling the results.

Other settings that can effect results include
  • 'interpolate' For source image lookups (scale enlargements)
  • 'filter' Set filter to use for area-resampling (scale shrinking). Set to 'point' to turn off and use 'interpolate' lookup instead

See also:

Feedback, Comments & Corrections

IMImageQ16MBS.DistortImage(DistortImageMethod as Integer, values() as Double, bestfit as boolean) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 12.5 Yes Yes Yes Yes No
Function: DistortImage() distorts an image using various distortion methods, by mapping color lookups of the source image to a new destination image usally of the same size as the source image, unless 'bestfit' is set to true.
Notes:
If 'bestfit' is enabled, and distortion allows it, the destination image is adjusted to ensure the whole source 'image' will just fit within the final destination image, which will be sized and offset accordingly. Also in many cases the virtual offset of the source image will be taken into account in the mapping.

If the '-verbose' control option has been set print to standard error the equicelent '-fx' formula with coefficients for the function, if practical.

A description of each parameter follows:
self: the image to be distorted.
m: the method of image distortion. ArcDistortion always ignores source image offset, and always 'bestfit' the destination image with the top left corner offset relative to the polar mapping center. Affine, Perspective, and Bilinear, do least squares fitting of the distrotion when more than the minimum number of control point pairs are provided. Perspective, and Bilinear, fall back to a Affine distortion when less than 4 control point pairs are provided. While Affine distortions let you use any number of control point pairs, that is Zero pairs is a No-Op (viewport only) distortion, one pair is a translation and two pairs of control points do a scale-rotate-translate, without any shearing.
values: arguments given.
bestfit: Attempt to 'bestfit' the size of the resulting image. This also forces the resulting image to be a 'layered' virtual canvas image. Can be overridden using 'distort:viewport' setting.

Extra Controls from Image meta-data (artifacts)...

  • "verbose" Output to stderr alternatives, internal coefficents, and FX equivalents for the distortion operation (if feasible). This forms an extra check of the distortion method, and allows users access to the internal constants IM calculates for the distortion.
  • "distort:viewport" Directly set the output image canvas area and offest to use for the resulting image, rather than use the original images canvas, or a calculated 'bestfit' canvas.
  • "distort:scale" Scale the size of the output canvas by this amount to provide a method of Zooming, and for super-sampling the results.

Other settings that can effect results include
  • 'interpolate' For source image lookups (scale enlargements)
  • 'filter' Set filter to use for area-resampling (scale shrinking). Set to 'point' to turn off and use 'interpolate' lookup instead

See also:

Feedback, Comments & Corrections

IMImageQ16MBS.Edge(radius as Double) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.1 Yes Yes Yes Yes No
Function: Finds edges in an image.
Notes:
Radius defines the radius of the convolution filter. Use a radius of 0 and Edge selects a suitable radius for you.
Sets the last exception property.

For more details please check the ImageMagick documentation.

Feedback, Comments & Corrections

IMImageQ16MBS.Emboss(radius as Double, sigma as Double) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 5.1 Yes Yes Yes Yes No
Function: Returns a grayscale image with a three-dimensional effect.
Notes:
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 Emboss selects a suitable radius for you.
Sets the last exception property.

For more details please check the ImageMagick documentation.

Feedback, Comments & Corrections

IMImageQ16MBS.EncipherImage(passkey as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 11.3 Yes Yes Yes Yes No
Function: Converts pixels to cipher-pixels.
Notes:
passkey: encipher pixels with this passphrase.
Returns true on success.

Feedback, Comments & Corrections

IMImageQ16MBS.EqualizeImage as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 15.2 Yes Yes Yes Yes No
Function: Applies a histogram equalization to the image.
Notes:
Returns true on success or false on failure.

ChannelType: The channels to use.

Feedback, Comments & Corrections

IMImageQ16MBS.EqualizeImageChannel(ChannelType as Integer) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 15.2 Yes Yes Yes Yes No
Function: Applies a histogram equalization to the image.
Notes:
Returns true on success or false on failure.

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

Feedback, Comments & Corrections

IMImageQ16MBS.ExcerptImage(x as Integer, y as Integer, width as Integer, height as Integer) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 11.3 Yes Yes Yes Yes No
Function: Returns a excerpt of the image as defined by the geometry.
Notes: Define the region of the image to extend with x, y, width, and height.

Feedback, Comments & Corrections

IMImageQ16MBS.ExtentImage(x as Integer, y as Integer, width as Integer, height as Integer) as IMImageQ16MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method Image Magick MBS GraphicsMagick Plugin 11.3 Yes Yes Yes Yes No
Function: Extends the image as defined by the geometry, gravity, and image background color.
Notes:
Define the region of the image to extend with x, y, width, and height.

Set the (x,y) offset of the geometry to move the original image relative to the extended image.

Feedback, Comments & Corrections

Previous items Next items

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




Links
MBS FileMaker tutorial videos