IMImage7MBS.OneAuthenticPixel(X as Integer, Y as Integer) as MemoryBlock

The image background color is returned if an error occurs.
See GetOneAuthenticPixel function in ImageMagick documentation.

Memoryblock should have size of ChannelCount * QuantumSize.
Format of pixel values depend on what quantum size/type your library copy uses!

Use OneVirtualPixelInfo for a type independent color information.

IMImage7MBS.OneVirtualPixel(X as Integer, Y as Integer) as MemoryBlock

The image background color is returned if an error occurs.
If you plan to modify the pixel, use GetOneAuthenticPixel() instead.
See GetOneVirtualPixel function in ImageMagick documentation.

Memoryblock should have size of ChannelCount * QuantumSize.
Format of pixel values depend on what quantum size/type your library copy uses!

Use OneVirtualPixelInfo for a type independent color information.

IMImage7MBS.OneVirtualPixelInfo(virtualPixelMethod as Integer, X as Integer, Y as Integer) as IMPixelInfo7MBS

The image background color is returned if an error occurs.
If you plan to modify the pixel, use GetOneAuthenticPixel() instead.
See GetOneVirtualPixelInfo function in ImageMagick documentation.

IMImage7MBS.OptimizeImageLayers as IMImage7MBS

From this it attempts to select the smallest cropped image to replace each frame, while preserving the results of the GIF animation.

See OptimizeImageLayers function in ImageMagick documentation.

IMImage7MBS.OptimizeImageTransparency

Any pixel that does not change the disposal image (and thus does not effect the outcome of an overlay) is made transparent.

WARNING: This modifies the current images directly, rather than generate a new image sequence.

See OptimizeImageTransparency function in ImageMagick documentation.

IMImage7MBS.OptimizePlusImageLayers as IMImage7MBS

See OptimizeImagePlusLayers function in ImageMagick documentation.

IMImage7MBS.OrderedDither(threshold as string) as Boolean

threshold: A string containing the name of the threshold dither map to use, followed by zero or more numbers representing the number of color levels tho dither between.
Any level number less than 2 will be equivalent to 2, and means only binary dithering will be applied to each color channel.
No numbers also means a 2 level (bitmap) dither will be applied to all channels, while a single number is the number of levels applied to each channel in sequence. More numbers will be applied in turn to each of the color channels.
For example: "o3x3,6" will generate a 6 level posterization of the image with a ordered 3x3 diffused pixel dither being applied between each level. While checker,8,8,4 will produce a 332 colormaped image with only a single checkerboard hash pattern (50 grey) between each color level, to basically double the number of color levels with a bare minimim of dithering.

See OrderedDitherImage function in ImageMagick documentation.

IMImage7MBS.Perceptible(epsilon as Double) as Boolean

epsilon: the epsilon threshold (e.g. 1.0e-9).

See PerceptibleImage function in ImageMagick documentation.

IMImage7MBS.Posterize(levels as Integer, DitherMethod as Integer) as Boolean

levels: Number of color levels allowed in each channel. Very low values (2, 3, or 4) have the most visible effect.
DitherMethod: choose from UndefinedDitherMethod, NoDitherMethod, RiemersmaDitherMethod, FloydSteinbergDitherMethod.

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

IMImage7MBS.Preview(PreviewType as Integer) as IMImage7MBS

This may be helpful pin-pointing an appropriate parameter for a particular image processing operation.

preview: the image processing operation. See preview constants.

See xx function in ImageMagick documentation.

IMImage7MBS.Profile(name as string, ProfileData as string) as boolean

If the profile is nil, it is removed from the image otherwise added or applied. Use a name of '*' and a profile of nil to remove all profiles from the image.

ICC and ICM profiles are handled as follows: If the image does not have an associated color profile, the one you provide is associated with the image and the image pixels are not transformed. Otherwise, the colorspace transform defined by the existing and new profile are applied to the image pixels and the new profile is associated with the image.

name: Name of profile to add or remove: ICC, IPTC, or generic profile.
ProfileData: the profile data.

See ProfileImage function in ImageMagick documentation.

IMImage7MBS.Properties as Dictionary

Dim f As FolderItem = GetFolderItem("/Users/cs/Pictures/IMG_3625.jpg", FolderItem.PathTypeNative)
Dim i As New IMImageInfo7MBS

i.Filename = f.NativePath

Dim p As IMImage7MBS = i.ReadImage
Dim d As Dictionary = p.Properties
Break // see in debugger

See ResetImagePropertyIterator, GetNextImageProperty and GetImageProperty functions in ImageMagick documentation.

IMImage7MBS.Quantize(quantizeInfo as IMQuantizeInfo7MBS) as Boolean

The goal of the algorithm is to minimize the color difference between the input and output image while minimizing the processing time.

quantizeInfo: Specifies a QuantizeInfo object.

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

IMImage7MBS.QuantizeImages(quantizeInfo as IMQuantizeInfo7MBS) as Boolean

The goal of the algorithm is to minimize the color difference between the input and output images while minimizing the processing time.

quantizeInfo: Specifies an QuantizeInfo structure.
self: Specifies a list of Images.
See QuantizeImages function in ImageMagick documentation.

IMImage7MBS.QueueAuthenticPixels(X as Integer, Y as Integer, Width as Integer, Height as Integer) as Ptr

If the region is successfully initialized a pointer to a Quantum array representing the region is returned, otherwise nil is returned. The returned pointer may point to a temporary working buffer for the pixels or it may point to the final location of the pixels in memory.

Write-only access means that any existing pixel values corresponding to the region are ignored. This is useful if the initial image is being created from scratch, or if the existing pixel values are to be completely replaced without need to refer to their pre-existing values. The application is free to read and write the pixel buffer returned by QueueAuthenticPixels() any way it pleases. QueueAuthenticPixels() does not initialize the pixel array values. Initializing pixel array values is the application's responsibility.

Performance is maximized if the selected region is part of one row, or one or more full rows, since then there is opportunity to access the pixels in-place (without a copy) if the image is in memory, or in a memory-mapped file. The returned pointer must *never* be deallocated by the user.

Pixels accessed via the returned pointer represent a simple array of type Quantum. If the image type is CMYK or the storage class is PseudoClass, call GetAuthenticMetacontent() after invoking GetAuthenticPixels() to obtain the meta-content (of type void) corresponding to the region. Once the Quantum (and/or Quantum) array has been updated, the changes must be saved back to the underlying image using SyncAuthenticPixels() or they may be lost.

x, y, width and height define the perimeter of a region of pixels.

See QueueAuthenticPixels function in ImageMagick documentation.
Format of pixel values depend on what quantum size/type your library copy uses!

IMImage7MBS.RaiseImage(rectangle as IMRectangleInfo7MBS, raise as boolean) as boolean

Members width and height of raise_info define the width of the vertical and horizontal edge of the effect.

rectangle: Define the width and height of the raise area.
raise: A value other than zero creates a 3-D raise effect, otherwise it has a lowered effect.

See RaiseImage function in ImageMagick documentation.

IMImage7MBS.RandomThreshold(minThreshold as Double, maxThreshold as double) as Boolean

The result is a low-contrast, two color image.

low,high: Specify the high and low thresholds. These values range from 0 to QuantumRange.

See xx function in ImageMagick documentation.

IMImage7MBS.RangeThreshold(lowBlack as Double, lowWhite as double, highWhite as double, highBlack as double) as Boolean

lowBlack: Define the minimum black threshold value.
lowWhite: Define the minimum white threshold value.
highWhite: Define the maximum white threshold value.
highBlack: Define the maximum black threshold value.

See RangeThresholdImage function in ImageMagick documentation.

IMImage7MBS.Remap(quantizeInfo as IMQuantizeInfo7MBS, remapImage as IMImage7MBS) as Boolean

quantizeInfo: Specifies an QuantizeInfo object.
remapImage: the reference image.

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

IMImage7MBS.RemapImages(quantizeInfo as IMQuantizeInfo7MBS, remapImage as IMImage7MBS) as Boolean

quantizeInfo: Specifies an QuantizeInfo object.
remapImage: the reference image.

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

IMImage7MBS.RemoveDuplicateLayers

Image size and virtual canvas offset must also match, though not the virtual canvas size itself.

No check is made with regards to image disposal setting, though it is the dispose setting of later image that is kept. Also any time delays are also added together. As such coalesced image animations should still produce the same result, though with duplicte frames merged into a single frame.

See xx function in ImageMagick documentation.

IMImage7MBS.RemoveFirstImageFromList as IMImage7MBS

If the given image list pointer pointed to the removed first image, it is set to the new first image of list, or nil if list was emptied, otherwise it is left as is.

See RemoveFirstImageFromList function in ImageMagick documentation.

IMImage7MBS.RemoveImageProfile(name as string) as string

See xx function in ImageMagick documentation.

IMImage7MBS.RemoveProperty(Key as String)

See RemoveImageProperty function in ImageMagick documentation.

IMImage7MBS.RemoveZeroDelayLayers

Such images generally represent intermediate or partial updates in GIF animations used for file optimization. They are not ment to be displayed to users of the animation. Viewable images in an animation should have a time delay of 3 or more centi-seconds (hundredths of a second).

However if all the frames have a zero time delay, then either the animation is as yet incomplete, or it is not a GIF animation. This a non-sensible situation, so no image will be removed and a 'Zero Time Animation' warning (exception) given.

No warning will be given if no image was removed because all images had an appropriate non-zero time delay set.

Due to the special requirements of GIF disposal handling, GIF animations should be coalesced first, before calling this function, though that is not a requirement.

See RemoveZeroDelayLayers function in ImageMagick documentation.

IMImage7MBS.Resample(xResolution as Double, yResolution as Double, filter as Integer) as IMImage7MBS

xResolution: the new image x resolution.
yResolution: the new image y resolution.
filter: Image filter to use.

See ResampleImage function in ImageMagick documentation.

IMImage7MBS.ResetImageProfileIterator

Use it in conjunction with GetNextImageProfile to iterate over all the profiles associated with an image.

See ResetImageProfileIterator function in ImageMagick documentation.

IMImage7MBS.ResetPropertyIterator

Use it in conjunction with GetNextImageProperty() to iterate over all the values associated with an image property.
See ResetImagePropertyIterator function in ImageMagick documentation.

IMImage7MBS.Resize(columns as integer, rows as integer, FilterID as integer) as IMImage7MBS

If an undefined filter is given the filter defaults to Mitchell for a colormapped image, a image with a matte channel, or if the image is enlarged. Otherwise the filter defaults to a Lanczos.

columns: the number of columns in the scaled image.
rows: the number of rows in the scaled image.
filterID: Image filter to use.

See ResizeImage function in ImageMagick documentation.

IMImage7MBS.Roll(x as integer, y as integer) as IMImage7MBS

x: the number of columns to roll in the horizontal direction.
y: the number of rows to roll in the vertical direction.

See RollImage function in ImageMagick documentation.

IMImage7MBS.Rotate(degrees as double) as IMImage7MBS

Positive angles rotate counter-clockwise (right-hand rule), while negative angles rotate clockwise. Rotated images are usually larger than the originals and have 'empty' triangular corners. X axis. Empty triangles left over from shearing the image are filled with the background color defined by member 'background_color' of the image. RotateImage allocates the memory necessary for the new Image structure and returns a pointer to the new image.

degrees: Specifies the number of degrees to rotate the image.

See RotateImage function in ImageMagick documentation.

IMImage7MBS.RotationalBlur(Angle as double) as IMImage7MBS

angle: the angle of the radial blur.
blur: the blur.

See RotationalBlurImage function in ImageMagick documentation.

IMImage7MBS.Sample(columns as integer, rows as integer) as IMImage7MBS

Unlike other scaling methods, this method does not introduce any additional color into the scaled image.

columns: the number of columns in the sampled image.
rows: the number of rows in the sampled image.

See SampleImage function in ImageMagick documentation.

IMImage7MBS.Scale(columns as integer, rows as integer) as IMImage7MBS

columns: the number of columns in the scaled image.
rows: the number of rows in the scaled image.

See ScaleImage function in ImageMagick documentation.

IMImage7MBS.Segment(colorspaceType as Integer, verbose as Boolean, clusterThreshold as Double, smoothThreshold as Double) as Boolean

colorspace: Indicate the colorspace.
verbose: Set to true to print detailed information about the identified classes.
clusterThreshold: This 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.

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

IMImage7MBS.SelectiveBlur(radius as double, sigma as double, threshold as double) as IMImage7MBS

It is similar to the unsharpen mask that sharpens everything with contrast above a certain threshold.

radius: the radius of the Gaussian, in pixels, not counting the center pixel.
sigma: the standard deviation of the Gaussian, in pixels.
threshold: only pixels within this contrast threshold are included in the blur operation.

See SelectiveBlurImage function in ImageMagick documentation.

IMImage7MBS.Separate(ChannelType as Integer) as IMImage7MBS

See ChannelType constants for parameter.
See SeparateImage function in ImageMagick documentation.

IMImage7MBS.SeparateImages as IMImage7MBS

See SeparateImages function in ImageMagick documentation.

IMImage7MBS.SetGray as Boolean

See xx function in ImageMagick documentation.

IMImage7MBS.SetImageAlphaChannel(AlphaChannelOption as Integer) as Boolean

The alpha channel types: ActivateAlphaChannel, AssociateAlphaChannel, CopyAlphaChannel, DeactivateAlphaChannel, DisassociateAlphaChannel, ExtractAlphaChannel, OffAlphaChannel, OnAlphaChannel, OpaqueAlphaChannel, SetAlphaChannel, ShapeAlphaChannel, and TransparentAlphaChannel.

see AlphaChannel constants.

See SetImageAlphaChannel function in ImageMagick documentation.

IMImage7MBS.SetImageColorMetric(other as IMImage7MBS) as Boolean

A value other than 0 means the colors match exactly. Otherwise an error measure is computed by summing over all pixels in an image the distance squared in RGB space between each image pixel and its corresponding pixel in the reconstruct image. The error measure is assigned to these image members:

• mean_error_per_pixel: The mean error for any single pixel in the image.
• normalized_mean_error: 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_error: 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.

IMImage7MBS.SetImageColorspace(Colorspace as integer) as boolean

See SetImageColorspace function in ImageMagick documentation.

IMImage7MBS.SetImageDepth(depth as Integer) as Boolean

See SetImageDepth function in ImageMagick documentation.