GMImageMBS.cdl(cdl as string)

Bake in the ASC-CDL, which is a convention for the for the exchange of basic primary color grading information between for the exchange of basic primary color grading information between equipment and software from different manufacturers. It is a useful transform for other purposes as well.

GMImageMBS.channel(channel as Integer)

Use this option to extract a particular channel from the image. MatteChannel for example, is useful for extracting the opacity values from an image.

GMImageMBS.channelDepth(channel as Integer) as UInt32

(Read and Write computed property)

GMImageMBS.charcoal(radius as Double=0.0, sigma as Double=1.0)

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)

image.charcoal

Backdrop=image.CopyPicture

The radius parameter specifies the radius of the Gaussian, in pixels, not counting the center pixel. The sigma parameter specifies the standard deviation of the Laplacian, in pixels.

GMImageMBS.chop(geometry as GMGeometryMBS)

GMImageMBS.colorHistogram as dictionary

Var f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
Var g as new GMImageMBS(f)
Var d as Dictionary = g.colorHistogram

MsgBox str(d.Count)+" color"

// check first color
Var c as GMColorMBS = d.key(0)

MsgBox "Color "+str(c.colorValue)+": "+str(d.Value(c))

The dictionary has a GMColorMBS/GMColor16MBS object as key for each color and an unsigned integer as value.

GMImageMBS.colorize(opacity as UInt32, penColor as GMColorMBS)

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)

image.colorize(10, new GMColorMBS("red"))

Backdrop=image.CopyPicture

See also:

• colorize(opacityRed as UInt32, opacityGreen as UInt32, opacityBlue as UInt32, penColor as GMColorMBS)

GMImageMBS.colorize(opacityRed as UInt32, opacityGreen as UInt32, opacityBlue as UInt32, penColor as GMColorMBS)

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)

image.colorize(10, 0, 5, new GMColorMBS("red"))

Backdrop=image.CopyPicture

See also:

• colorize(opacity as UInt32, penColor as GMColorMBS)

GMImageMBS.colorMap as GMColorMBS()

See also:

• colorMap(index as UInt32) as GMColorMBS

GMImageMBS.colorMap(index as UInt32) as GMColorMBS

(Read and Write computed property)

See also:

• colorMap as GMColorMBS()

GMImageMBS.colorMatrix(order as Integer, ColorMatrix() as Double)

Var f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
Var g as new GMImageMBS(f)

Var m(8) as Double

m(0) = 0.25
m(1) = 0
m(2) = 0.25

m(3) = 0
m(4) = 0
m(5) = 0

m(6) = 0.25
m(7) = 0
m(8) = 0.25

g.colorMatrix 3, m

Backdrop = g.CopyPicture

The user supplied matrix may be of order 1 to 5 (1x1 through 5x5).

GMImageMBS.CombinePictureWithMask as picture

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)

Var c as new GMColorMBS("white")
image.transparent(c)

Backdrop=image.CombinePictureWithMask

Internally this calls Width and Height, CopyPicture and CopyMask.

GMImageMBS.compare(image as GMImageMBS) as boolean

Sets meanErrorPerPixel, normalizedMaxError, and normalizedMeanError in the current image. False is returned if the images are identical. An ErrorOption exception is thrown if the reference image columns, rows, colorspace, or matte differ from the current image:

GMImageMBS.composite(compositeImage as GMImageMBS, gravity as Integer, CompositeOperator as Integer = 2)

GMImageMBS.compositeAt(compositeImage as GMImageMBS, offset as GMGeometryMBS, CompositeOperator as Integer = 2)

GMImageMBS.compositeXY(compositeImage as GMImageMBS, xOffset as Integer, yOffset as Integer, CompositeOperator as Integer = 2)

GMImageMBS.Constructor

// get some image data (e.g. from blob in database)
Var logo as Picture = LogoMBS(500)
Var jpegData as string = PictureToJPEGStringMBS(logo, 80)

// new image
Var mp as new GMImageMBS
Var blob as new GMBlobMBS(jpegData)

// read data from blob into this image object
mp.Read blob

// sometimes you need to explicit convert to RGB/RGBA
'mp.type = mp.TrueColorMatteType
Backdrop=mp.CombinePictureWithMask

See also:

• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GMImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(blob as GMBlobMBS)

See also:

• Constructor
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GMImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)

GMImageMBS.Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)

See also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GMImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)

See also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GMImageMBS)
• Constructor(Path as string)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)

See also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(other as GMImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)

// first open file and read data in blob
SVG_File  = FolderItem.ShowOpenFileDialog("")
If SVG_File = Nil Then Return

Var stream as BinaryStream = BinaryStream.Open(SVG_File)
Var data as string = stream.Read(stream.Length)
Var blob as new GMBlobMBS(data)

// 400 width and 400 height
Var geo As New GMGeometryMBS(400, 400, 0, 0)

// pass type here to have GraphicsMagick know it since there is no file name in blob:
Var g as New GMImageMBS(blob, geo, "svg")

See also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(file as folderitem)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(file as folderitem)

See also:

• Constructor
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(other as GMImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(other as GMImageMBS)

See also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)

GMImageMBS.Constructor(Path as string)

See also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GMImageMBS)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(pic as picture)

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)
Backdrop=image.CopyPicture

Pixels from both the picture and picture's mask.

See also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GMImageMBS)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)

Var g as new GMGeometryMBS(600,600)
Var c as new GMColorRGBMBS(1.0,0.0,0.0) // red
Var image as new GMImageMBS(g, c)

const TrueColorType=6

// Ensure that there are no other references to this image.
image.modifyImage
// Set the image type to TrueColor DirectClass representation.
image.type=TrueColorType

Backdrop=image.CopyPicture(0,0,600,600)

See also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

Var data as new memoryblock(2048*2048) // your data
Var image as new GMImageMBS(2048, 2048, "I", GMImageMBS.StorageTypeCharPixel, data)

Returns an Image corresponding to an image stored in a raw memory array format. The pixel data must be in scanline order top-to-bottom. The data can be unsigned char, unsigned short int, unsigned int, unsigned long, float, or double. Float and double require the pixels to be normalized to the range [0..1], otherwise the range is [0..MaxVal] where MaxVal is the maximum possible value for that type.

Note that for most 32-bit architectures the size of an unsigned long is the same as unsigned int, but for 64-bit architectures observing the LP64 standard, an unsigned long is 64 bits, while an unsigned int remains 32 bits. This should be considered when deciding if the data should be described as "Integer" or "Long".

For example, to create a 640x480 image from unsigned red-green-blue character data, use

image = new GMImageMBS(640, 480, "RGB", GMImageMBS.StorageTypeCharPixel, pixels);

width: width in pixels of the image.
height: 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 (same as Transparency), O = Opacity, T = Transparency, C = cyan, Y = yellow, M = magenta, K = black, or I = intensity (for grayscale). Specify "P" = pad, to skip over a quantum which is intentionally ignored. Creation of an alpha channel for CMYK images is currently not supported.
type: Define the data type of the pixels. Float and double types are expected to be normalized [0..1] otherwise [0..MaxRGB]. Choose from these types: StorageTypeCharPixel, StorageTypeShortPixel, StorageTypeIntegerPixel, StorageTypeLongPixel, StorageTypeFloatPixel, or StorageTypeDoublePixel.
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 also:

• Constructor
• Constructor(blob as GMBlobMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, depth as UInt32)
• Constructor(blob as GMBlobMBS, geometry as GMGeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GMImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)

GMImageMBS.contrast(sharpen as UInt32)

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)

image.contrast(10)

Backdrop=image.CopyPicture

GMImageMBS.convolve(order as Integer, ColorMatrix() as Double)

Var f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
Var g as new GMImageMBS(f)

Var m(8) as Double

m(0) = 0.25
m(1) = 0
m(2) = 0.25

m(3) = 0
m(4) = 0
m(5) = 0

m(6) = 0.25
m(7) = 0
m(8) = 0.25

g.convolve 3, m

Backdrop = g.CopyPicture

Applies a user-specified convolution to the image.
order represents the number of columns and rows in the filter kernel.
kernel is an array of doubles representing the convolution kernel.

GMImageMBS.CopyPicture as picture

Var g as new GMGeometryMBS(500,500)
Var c as new GMColorRGBMBS("white") // white
Var image as new GMImageMBS(g, c)

image.strokeColor = new GMColorRGBMBS("red") // Outline color
image.fillColor = new GMColorRGBMBS("green") // Fill color
image.strokeWidth = 5

Var draw as GMGraphicsMBS = image.Graphics

// Draw a circle
draw.Rectangle(250, 250, 100, 100)

Backdrop=image.CopyPicture

You may need to set image type to RGB to get it working.

See also:

• CopyPicture(x as Integer, y as Integer, width as Integer, height as Integer) as picture

GMImageMBS.CopyPicture(x as Integer, y as Integer, width as Integer, height as Integer) as picture

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)

image.threshold 127

// convert to RGB so CopyPicture works
image.type = image.TrueColorType
Backdrop=image.CopyPicture(0,0,250,250)

You may need to set image type to RGB to get it working.

See also:

• CopyPicture as picture

GMImageMBS.CopyPictureMask as picture

Var f As FolderItem = SpecialFolder.Desktop.Child("test.png")
Var g As New GMImageMBS(f)

// get image with mask
Var p As picture = g.CopyPicture
p.mask = g.CopyPictureMask

window1.Backdrop = p

See also:

• CopyPictureMask(x as Integer, y as Integer, width as Integer, height as Integer) as picture

GMImageMBS.CopyPictureMask(x as Integer, y as Integer, width as Integer, height as Integer) as picture

See also:

• CopyPictureMask as picture

GMImageMBS.CopyPixelsMemory as Memoryblock

Optional specify rectangle.
Returns nil on low memory or bad parameter. Image must be of type class direct (not palette picture).
Order of pixel data is normally Red, Green, Blue, Opacity. Or Cyan, Magenta, Yellow, Black for CMYK images.
For GMImageMBS, the data is 8bit per channel. For GMImage16MBS, the data is 16bit per channel.

See also:

• CopyPixelsMemory(x as Integer, y as Integer, width as Integer, height as Integer) as Memoryblock

GMImageMBS.CopyPixelsMemory(x as Integer, y as Integer, width as Integer, height as Integer) as Memoryblock

Optional specify rectangle.
Returns nil on low memory or bad parameter. Image must be of type class direct (not palette picture).
Order of pixel data is normally Red, Green, Blue, Opacity. Or Cyan, Magenta, Yellow, Black for CMYK images.
For GMImageMBS, the data is 8bit per channel. For GMImage16MBS, the data is 16bit per channel.

See also:

• CopyPixelsMemory as Memoryblock

GMImageMBS.crop(geometry as GMGeometryMBS)

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)

image.crop GMGeometryMBS.Make(100,200)

Backdrop=image.CopyPicture

GMImageMBS.cycleColormap(amount as Integer)

Var p as Picture = LogoMBS(500)
Var image as new GMImageMBS(p)

image.cycleColormap(5)

image.type = image.TrueColorType

Backdrop=image.CopyPicture