Platforms to show: All Mac Windows Linux Cross-Platform

Back to IMImageQ8MBS class.

Previous items Next items

IMImageQ8MBS.CopyPixel(x as Integer, y as Integer) as IMColorQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Copies a pixel.

Returns nil on any error.
This method works only for bitmap images.
x and y are zero based.

IMImageQ8MBS.CreateHBITMAP as Ptr

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 15.1 ❌ No ✅ Yes ❌ No ❌ No All
Creates a HBITMAP for the image for use with Windows Declares.

The HBITMAP returned needs to be freed when you are done with it or you risk having a memory leak.

IMImageQ8MBS.Crop(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
Crop extracts a region of the image starting at the offset defined by geometry.

Returns nil on any error.
Sets the last exception property.

IMImageQ8MBS.CropImageToTiles(CropGeometry as string) as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 11.3 ✅ 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.

IMImageQ8MBS.CycleColormap(displace as Integer) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.2 ✅ 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.
Returns true on success.
displace: displace the colormap this amount.

IMImageQ8MBS.DecipherImage(passkey as string) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Converts cipher pixels to plain pixels.

Passkey: decipher cipher pixels with this passphrase.
Returns true on success.

IMImageQ8MBS.DeconstructImages as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
DeconstructImages() compares each image with the next in a sequence and returns the minimum bounding region of all differences from the first image.

Returns nil on any error.
Sets the last exception property.

IMImageQ8MBS.DeleteImageAttribute(key as string) as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
DeleteImageAttribute() deletes an attribute from the image.

Returns false on any error.

IMImageQ8MBS.Despeckle() as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Reduces the speckle noise in an image while perserving the edges of the original image.

Sets the last exception property.
For more details please check the ImageMagick documentation.

IMImageQ8MBS.DestroyImage

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Releases the memory used for this image and sets handle to 0.

For more details please check the ImageMagick documentation.
The destructor will call this for you if release=true.

IMImageQ8MBS.DestroyImageAttributes

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Deallocates memory associated with the image attribute list.

IMImageQ8MBS.DestroyImageList

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Destroys the image list and sets the handle to 0.

For more details please check the ImageMagick documentation.
The destructor will call this for you if release=true.

IMImageQ8MBS.DestroyImageProfiles

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Releases memory associated with an image profile map.

IMImageQ8MBS.DistortImage(DistortImageMethod as Integer, values() as Double, bestfit as boolean) as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 12.5 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
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.

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

IMImageQ8MBS.Edge(radius 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
Finds edges in an image.

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.

IMImageQ8MBS.Emboss(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
Returns a grayscale image with a three-dimensional effect.

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.

IMImageQ8MBS.EncipherImage(passkey as string) as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 11.3 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Converts pixels to cipher-pixels.

passkey: encipher pixels with this passphrase.
Returns true on success.

IMImageQ8MBS.EqualizeImage as Boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 15.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Applies a histogram equalization to the image.

Returns true on success or false on failure.

ChannelType: The channels to use.

IMImageQ8MBS.EqualizeImageChannel(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
Applies a histogram equalization to the image.

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

IMImageQ8MBS.ExcerptImage(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
Returns a excerpt of the image as defined by the geometry.

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

IMImageQ8MBS.ExtentImage(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
Extends the image as defined by the geometry, gravity, and image background color.

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.

IMImageQ8MBS.FlattenImages as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Flatten composites all images from the current image pointer to the end of the image list and returns a single flattened image.

Returns nil on any error.
Sets the last exception property.

IMImageQ8MBS.Flip as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Flip creates a vertical mirror image by reflecting the pixels around the central x-axis.

Returns nil on any error.
Sets the last exception property.

IMImageQ8MBS.Flop as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Flop creates a horizontal mirror image by reflecting the pixels around the central y-axis.

Returns nil on any error.
Sets the last exception property.

IMImageQ8MBS.FrameImage(x as Integer, y as Integer, width as Integer, height as Integer, innerBevel as Integer, OuterBevel 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
Adds a simulated three-dimensional border around the image.

The color of the border is defined by the MatteColor of image. Width and height specify the border width of the vertical and horizontal sides of the frame. innerBevel and OuterBevel indicate the width of the inner and outer shadows of the frame.

IMImageQ8MBS.FxImage(expression as string) as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 8.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
FxImage() applies a mathematical expression to the specified image.

Can raise an exception.

IMImageQ8MBS.GaussianBlurChannel(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 GaussianBlur selects a suitable radius for you.
Sets the last exception property.

radius: the radius of the Gaussian, in pixels, not counting the center pixel.
channel: The channel type.
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.GetImageAttribute(key as string) as IMImageAttributeQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
GetImageAttribute searches the list of image attributes and returns a reference to the attribute if it exists otherwise nil.

IMImageQ8MBS.GetImageClippingPathAttribute as IMImageAttributeQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
GetImageClippingPathAttribute searches the list of image attributes and returns a reference to a clipping path if it exists otherwise nil.

IMImageQ8MBS.GetImageProfile(name as string) as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Gets a profile associated with an image by name.

Returns "" on any error.

IMImageQ8MBS.GetNextImageAttribute as IMImageAttributeQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
GetNextImageAttribute() gets the next image attribute.

Returns nil on any error.

IMImageQ8MBS.GetNextImageProfile as string

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Gets the next profile name for an image.

Returns "" on any error.

IMImageQ8MBS.HandleMemory as memoryblock

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
The content of the whole Image structure copied into a memoryblock.

Returns nil on any error.

IMImageQ8MBS.ImagesToBlob(info as IMImageInfoQ8MBS) as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.2 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
ImagesToBlob implements direct to memory image formats.

It returns the image sequence as a string. The magick member of the ImageInfo structure determines the format of the returned blob ( GIF, JPEG, PNG, etc. )

Note, some image formats do not permit multiple images to the same image stream (e.g. JPEG). in this instance, just the first image of the sequence is returned as a blob.

Sets the last exception property and returns "" on any error.
For more details please check the ImageMagick documentation.

IMImageQ8MBS.ImageToBlob(info as IMImageInfoQ8MBS) as String

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
ImagesToBlob implements direct to memory image formats.
Example
dim im as ImageMagickQ8MBS // global

Function IMPictureToString(p as picture, magick as string, quality as Integer) As string
dim image as new IMImageQ8MBS
dim imageinfo as IMImageInfoQ8MBS
dim s,data as string
dim impp as new IMMagickPixelPacketQ8MBS

// empty string for nil picture
if p = nil then
Return ""
end if

// create a new picture info

imageinfo = im.NewImageInfo
imageinfo.ColorSpace=1
// only color space is needed. 1 for RGB.

// background color of image
impp.red = 0
impp.Green = 0
impp.Blue = 0

// creates a new image object
if not image.NewImage(imageinfo,p.Width,p.Height,impp) then
Return ""
end if

// copy RB picture into IM Image at position 0/0
image.ColorSpace = 1
image.SetPicture(p,0,0)

// set compression data
imageinfo.Magick = magick
imageinfo.Quality = quality

// and rendering intent: 2=PerceptualIntent
'image.RenderingIntent = 2

// create image data
data = image.ImageToBlob(imageinfo)

// release memory
image.DestroyImage
imageinfo.DestroyImageInfo

// return result
Return data

Exception
// in case of an exception return nothing
Return ""


End Function

It returns the image sequence as a string. The magick member of the ImageInfo structure determines the format of the returned blob ( GIF, JPEG, PNG, etc. )

Note, some image formats do not permit multiple images to the same image stream (e.g. JPEG). in this instance, just the first image of the sequence is returned as a blob.

Sets the last exception property and returns "" on any error.
For more details please check the ImageMagick documentation.

IMImageQ8MBS.Implode(factor 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
Method ImplodeImage creates a new image that is a copy of an existing one with the image pixels "implode" by the specified percentage.

factor: A double value that defines the extent of the implosion.

Returns nil on any error.
Sets the last exception property.

IMImageQ8MBS.IsBlobExempt as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Returns true if the blob is exempt.

For more details please check the ImageMagick documentation.

IMImageQ8MBS.IsBlobSeekable as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Returns true if the blob is seekable.

For more details please check the ImageMagick documentation.

IMImageQ8MBS.IsBlobTemporary as boolean

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 5.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
Returns true if the blob is temporary.

For more details please check the ImageMagick documentation.

IMImageQ8MBS.MedianFilter(radius 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
Applies a digital filter that improves the quality of a noisy image.

Each pixel is replaced by the median in a set of neighboring pixels as defined by radius.
Sets the last exception property.

For more details please check the ImageMagick documentation.

IMImageQ8MBS.MergeImageLayers(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
MergeImageLayers() composes all the image layers from the current given image onward to produce a single image of the merged layers.

The inital canvas's size depends on the given ImageLayerMethod, and is initialized using the first images images background color. The images are then compositied onto that image in sequence using the given composition that has been assigned to each individual image.

ImageLayerMethod:
the method of selecting the size of the initial canvas.

MergeLayer: Merge all layers onto a canvas just large enough to hold all the actual images. The virtual canvas of the first image is preserved but otherwise ignored.

FlattenLayer: Use the virtual canvas size of first image. Images which fall outside this canvas is clipped. This can be used to 'fill out' a given virtual canvas.

MosaicLayer: Start with the virtual canvas of the first image, enlarging left and right edges to contain all images. Images with negative offsets will be clipped.

Can raise an exception.

IMImageQ8MBS.MosaicImages as IMImageQ8MBS

Type Topic Plugin Version macOS Windows Linux iOS Targets
method Image Magick MBS GraphicsMagick Plugin 6.1 ✅ Yes ✅ Yes ✅ Yes ✅ Yes All
MosaicImages inlays an image sequence to form a single coherent picture.

It returns a single image with each image in the sequence composited at the location defined by the page member of the image structure.
Returns nil on any error.
Sets the last exception property.

Previous items Next items

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


The biggest plugin in space...