GM16ImageMBS.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.

GM16ImageMBS.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.

GM16ImageMBS.channelDepth(channel as Integer) as UInt32

(Read and Write computed property)

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

Var p as Picture = LogoMBS(500)
Var image as new GM16ImageMBS(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.

GM16ImageMBS.chop(geometry as GM16GeometryMBS)

GM16ImageMBS.colorHistogram as dictionary

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

MsgBox str(d.Count)+" color"

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

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

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

GM16ImageMBS.colorize(opacity as UInt32, penColor as GM16ColorMBS)

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

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

Backdrop=image.CopyPicture

See also:

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

GM16ImageMBS.colorize(opacityRed as UInt32, opacityGreen as UInt32, opacityBlue as UInt32, penColor as GM16ColorMBS)

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

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

Backdrop=image.CopyPicture

See also:

• colorize(opacity as UInt32, penColor as GM16ColorMBS)

GM16ImageMBS.colorMap as GM16ColorMBS()

See also:

• colorMap(index as UInt32) as GM16ColorMBS

GM16ImageMBS.colorMap(index as UInt32) as GM16ColorMBS

(Read and Write computed property)

See also:

• colorMap as GM16ColorMBS()

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

Var f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
Var g as new GM16ImageMBS(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).

GM16ImageMBS.CombinePictureWithMask as picture

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

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

Backdrop=image.CombinePictureWithMask

Internally this calls Width and Height, CopyPicture and CopyMask.

GM16ImageMBS.compare(image as GM16ImageMBS) 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:

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

GM16ImageMBS.compositeAt(compositeImage as GM16ImageMBS, offset as GM16GeometryMBS, CompositeOperator as Integer = 2)

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

GM16ImageMBS.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 GM16ImageMBS
Var blob as new GM16BlobMBS(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 GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(blob as GM16BlobMBS)

See also:

• Constructor
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)

See also:

• Constructor
• Constructor(blob as GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)

See also:

• Constructor(blob as GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)

See also:

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

GM16ImageMBS.Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, 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 GM16BlobMBS(data)

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

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

See also:

• Constructor(blob as GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(file as folderitem)

See also:

• Constructor
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, Magick as string)
• Constructor(other as GM16ImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(other as GM16ImageMBS)

See also:

• Constructor
• Constructor(blob as GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, Magick as string)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(Path as string)

See also:

• Constructor
• Constructor(blob as GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(pic as picture)

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

Pixels from both the picture and picture's mask.

See also:

• Constructor
• Constructor(blob as GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)

Var g as new GM16GeometryMBS(600,600)
Var c as new GM16ColorRGBMBS(1.0,0.0,0.0) // red
Var image as new GM16ImageMBS(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 GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GM16ImageMBS.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 GM16ImageMBS(2048, 2048, "I", GM16ImageMBS.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 GM16ImageMBS(640, 480, "RGB", GM16ImageMBS.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 GM16BlobMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, depth as UInt32)
• Constructor(blob as GM16BlobMBS, geometry as GM16GeometryMBS, Magick as string)
• Constructor(file as folderitem)
• Constructor(other as GM16ImageMBS)
• Constructor(Path as string)
• Constructor(pic as picture)
• Constructor(size as GM16GeometryMBS, ColorValue as GM16ColorMBS)

GM16ImageMBS.contrast(sharpen as UInt32)

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

image.contrast(10)

Backdrop=image.CopyPicture

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

Var f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
Var g as new GM16ImageMBS(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.

GM16ImageMBS.CopyPicture as picture

Var g as new GM16GeometryMBS(500,500)
Var c as new GM16ColorRGBMBS("white") // white
Var image as new GM16ImageMBS(g, c)

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

Var draw as GM16GraphicsMBS = 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

GM16ImageMBS.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 GM16ImageMBS(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

GM16ImageMBS.CopyPictureMask as picture

Var f As FolderItem = SpecialFolder.Desktop.Child("test.png")
Var g As New GM16ImageMBS(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

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

See also:

• CopyPictureMask as picture

GM16ImageMBS.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 GM16ImageMBS, 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

GM16ImageMBS.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 GM16ImageMBS, the data is 8bit per channel. For GMImage16MBS, the data is 16bit per channel.

See also:

• CopyPixelsMemory as Memoryblock

GM16ImageMBS.crop(geometry as GM16GeometryMBS)

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

image.crop GM16GeometryMBS.Make(100,200)

Backdrop=image.CopyPicture

GM16ImageMBS.cycleColormap(amount as Integer)

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

image.cycleColormap(5)

image.type = image.TrueColorType

Backdrop=image.CopyPicture