Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

IMImage7MBS.DestroyProperties
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Destroys all properties and associated memory attached to the given image.
Notes: See DestroyImageProperties function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.DisposeImages as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Returns the coalesced frames of a GIF animation as it would appear after the GIF dispose method of that frame has been applied.
Notes:
That is it returned the appearance of each frame before the next is overlaid.

See DisposeImages function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Distort(DistortImageMethod as integer, values() as double, bestfit as boolean) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: 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.

method: 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: an array of floating point arguments for this method.

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

Feedback, Comments & Corrections

IMImage7MBS.DistortResize(x as Integer, y as Integer) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Resize image using the equivalent but slower image distortion operator.
Notes:
The filter is applied using a EWA cylindrical resampling. But like resize the final image size is limited to whole pixels with no effects by virtual-pixels on the result.

Note that images containing a transparency channel will be twice as slow to resize as images one without transparency.

See DistortResizeImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Edge(radius as double) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 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.

radius: the radius of the pixel neighborhood.

See EdgeImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Emboss(radius as double, sigma as double) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 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.

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

See EmbossImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Encipher(passkey as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Converts pixels to cipher-pixels.
Notes: See xx function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Enhance as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Applies a digital filter that improves the quality of a noisy image.
Notes: See xx function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Equalize as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Applies a histogram equalization to the image.
Notes: See xx function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Excerpt(rect as IMRectangleInfo7MBS) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Returns a excerpt of the image as defined by the geometry.
Notes:
geometry: Define the region of the image to extend with members x, y, width, and height.

See ExcerptImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.ExportPixels(x as integer, y as integer, width as integer, height as integer, map as string, storageType as integer, data as Ptr) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Extracts pixel data from an image and returns it to you.
Notes:
The method returns MagickTrue on success otherwise MagickFalse if an error is encountered. The data is returned as char, short int, Quantum, unsigned int, unsigned long long, float, or double in the order specified by map.

Suppose you want to extract the first scanline of a 640x480 image as character data in red-green-blue order:

image.ExportImagePixels(0, 0, 640, 480, "RGB", kCharPixel, pixels)

  • x,y,width,height: These values define the perimeter of a region of pixels you want to extract.
  • 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.
  • type: Define the data type of the pixels. Float and double types are normalized to [0..1] otherwise [0..QuantumRange]. Choose from these types: CharPixel (char *), DoublePixel (double *), FloatPixel (float *), LongPixel (unsigned int *), LongLongPixel (unsigned long long *), QuantumPixel (Quantum *), or ShortPixel (unsigned short *).
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 ExportImagePixels function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Extent(rect as IMRectangleInfo7MBS) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Extends the image as defined by the geometry, gravity, and image background color.
Notes:
Set the (x,y) offset of the geometry to move the original image relative to the extended image.

rect: Define the region of the image to extend with members x, y, width, and height.

See ExtentImage function in ImageMagick documentation.

See also:

Feedback, Comments & Corrections

IMImage7MBS.Flip as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Creates a vertical mirror image by reflecting the pixels around the central x-axis.
Notes: See FlipImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Flop as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Creates a horizontal mirror image by reflecting the pixels around the central y-axis.
Notes: See FlopImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.ForwardFourierTransformImage(modulus as Boolean) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Implements the discrete Fourier transform (DFT) of the image either as a magnitude / phase or real / imaginary image pair.
Notes:
modulus: if true, return as transform as a magnitude / phase pair otherwise a real / imaginary image pair.
See ForwardFourierTransformImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Frame(frameInfo as IMFrameInfo7MBS, CompositeOperator as integer) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Adds a simulated three-dimensional border around the image.
Notes:
The color of the border is defined by the matte_color member of image. Members width and height of frame_info specify the border width of the vertical and horizontal sides of the frame. Members inner and outer indicate the width of the inner and outer shadows of the frame.

frameInfo: Define the width and height of the frame and its bevels.
CompositeOperator: the composite operator.

See FrameImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Fx(expression as string) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Applies a mathematical expression to the specified image.
Notes:
expression: A mathematical expression.

See FxImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Gamma(level as double) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Gamma-corrects a particular image channel.
Notes:
The same image viewed on different devices will have perceptual differences in the way the image's intensities are represented on the screen. Specify individual gamma levels for the red, green, and blue channels, or adjust all three with the gamma parameter. Values typically range from 0.8 to 2.3.

You can also reduce the influence of a particular channel with a gamma value of 0.

level: the image gamma as a string (e.g. 1.6,1.2,1.0).

See GammaImage function in ImageMagick documentation.

See also:

Feedback, Comments & Corrections

IMImage7MBS.GaussianBlur(radius as double, sigma as double) as IMImage7MBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Blurs an image.
Notes:
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 GaussianBlur 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.

See GaussianBlurImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.GetImageDynamicThreshold(clusterThreshold as Double, smoothThreshold as Double, byref pixelinfo as IMPixelInfo7MBS) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Returns the dynamic threshold for an image.
Notes:
clusterThreshold: This double 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.
pixelinfo: return the dynamic threshold here.

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

Feedback, Comments & Corrections

IMImage7MBS.GetImageProfile(name as string) as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Gets a profile associated with an image by name.
Notes: See xx function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.GetImageQuantizeError as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Measures the difference between the original and quantized images.
Notes:
This difference is the total quantization error.
The error is computed by summing over all pixels in an image the distance squared in RGB space between each reference pixel value and its quantized value. These values are computed:

  • mean_error_per_pixel: This value is the mean error for any single pixel in the image.
  • normalized_mean_square_error: This value is 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_square_error: This value is 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.
See GetImageQuantizeError function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.GetMagickProperty(ImageInfo as IMImageInfo7MBS = nil, embedText as String) as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Gets attributes or calculated values that is associated with a fixed known property name, or single letter property.
Notes:
It may be called if no image is defined (IMv7), in which case only global ImageInfo values are available:

\n newline
\r carriage return
< less-than character.
> greater-than character.
& ampersand character.
%% a percent sign
%b file size of image read in
%c comment meta-data property
%d directory component of path
%e filename extension or suffix
%f filename (including suffix)
%g layer canvas page geometry (equivalent to "%Wx%H%X%Y")
%h current image height in pixels
%i image filename (note: becomes output filename for "info:")
%k CALCULATED: number of unique colors
%l label meta-data property
%m image file format (file magic)
%n number of images in current image sequence
%o output filename (used for delegates)
%p index of image in current image list
%q quantum depth (compile-time constant)
%r image class and colorspace
%s scene number (from input unless re-assigned)
%t filename without directory or extension (suffix)
%u unique temporary filename (used for delegates)
%w current width in pixels
%x x resolution (density)
%y y resolution (density)
%z image depth (as read in unless modified, image save depth)
%A image transparency channel enabled (true/false)
%B file size of image in bytes
%C image compression type
%D image GIF dispose method
%G original image size (%wx%h; before any resizes)
%H page (canvas) height
%M Magick filename (original file exactly as given, including read mods)
%O page (canvas) offset ( = %X%Y )
%P page (canvas) size ( = %Wx%H )
%Q image compression quality ( 0 = default )
%S ?? scenes ??
%T image time delay (in centi-seconds)
%U image resolution units
%W page (canvas) width
%X page (canvas) x offset (including sign)
%Y page (canvas) y offset (including sign)
%Z unique filename (used for delegates)
%@ CALCULATED: trim bounding box (without actually trimming)
%# CALCULATED: 'signature' hash of image values

This routine only handles specifically known properties. It does not handle special prefixed properties, profiles, or expressions. Nor does it return any free-form property strings.

The returned string is stored in a structure somewhere, and should not be directly freed. If the string was generated (common) the string will be stored as as either as artifact or option 'get-property'. These may be deleted (cleaned up) when no longer required, but neither artifact or option is guranteed to exist.
See GetMagickProperty function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.GetNextImageProfile as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Gets the next profile name for an image.
Notes: See xx function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.GetNextImageProperty as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Gets the next free-form string property name.
Notes: See GetNextImageProperty function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.GetProperty(PropertyKey as String) as String
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Gets a value associated with an image property.
Notes:
This includes, profile prefixes, such as "exif:", "iptc:" and "8bim:" It does not handle non-prifile prefixes, such as "fx:", "option:", or "artifact:".

The returned string is stored as a properity of the same name for faster lookup later.
See GetImageProperty function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Grayscale(PixelIntensityMethod as Integer) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Converts the image to grayscale.
Notes:
PixelIntensityMethod: the pixel intensity method.

See GrayscaleImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.HaldClut(clutImage as IMImage7MBS) as Boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Applies a Hald color lookup table to the image.
Notes:
A Hald color lookup table is a 3-dimensional color cube mapped to 2 dimensions. Create it with the HALD coder. You can apply any color transformation to the Hald image and then use this method to apply the transform to the image.

clutImage: the color lookup table image for replacement color values.

See HaldClutImage function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.HandleMemory as memoryblock
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Returns a memoryblock with a copy of the internal image structure.
Notes: See xx function in ImageMagick documentation.

Feedback, Comments & Corrections

IMImage7MBS.Histogram as IMPixelInfo7MBS()
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ImageMagick7 MBS GraphicsMagick Plugin 20.0 Yes Yes Yes Yes No
Function: Returns the unique colors in an image.
Notes:
Returns array of colors.
See GetImageHistogram function in ImageMagick documentation.

Feedback, Comments & Corrections

Previous items Next items

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

The biggest plugin in space...




Links
MBS FileMaker blog