GMImageMBS.raiseImage

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

image.raiseImage

Backdrop=image.CopyPicture

See also:

• raiseImage(geometry as GMGeometryMBS, raisedFlag as boolean=false)

GMImageMBS.raiseImage(geometry as GMGeometryMBS, raisedFlag as boolean=false)

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

image.raiseImage(GMGeometryMBS.Make(5,8))

Backdrop=image.CopyPicture

See also:

• raiseImage

GMImageMBS.randomThreshold(thresholds as GMGeometryMBS)

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

image.randomThreshold(GMGeometryMBS.make("50x200"))

image.type = image.TrueColorType
Backdrop=image.CopyPicture

Changes the value of individual pixels based on the intensity of each pixel compared to a random threshold. The result is a low-contrast, two color image. The thresholds argument is a geometry containing LOWxHIGH thresholds. If the string contains 2x2, 3x3, or 4x4, then an ordered dither of order 2, 3, or 4 will be performed instead. If a channel argument is specified then only the specified channel is altered. This is a very fast alternative to 'quantize' based dithering.

GMImageMBS.randomThresholdChannel(thresholds as GMGeometryMBS, channel as Integer)

Changes the value of individual pixels based on the intensity of each pixel compared to a random threshold. The result is a low-contrast, two color image. The thresholds argument is a geometry containing LOWxHIGH thresholds. If the string contains 2x2, 3x3, or 4x4, then an ordered dither of order 2, 3, or 4 will be performed instead. If a channel argument is specified then only the specified channel is altered. This is a very fast alternative to 'quantize' based dithering.

GMImageMBS.read(blob as GMBlobMBS)

// 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:

• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(file as folderitem)
• read(path as string)
• read(size as GMGeometryMBS, file as folderitem)
• read(size as GMGeometryMBS, Path as string)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.read(blob as GMBlobMBS, size as GMGeometryMBS)

See also:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(file as folderitem)
• read(path as string)
• read(size as GMGeometryMBS, file as folderitem)
• read(size as GMGeometryMBS, Path as string)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)

See also:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(file as folderitem)
• read(path as string)
• read(size as GMGeometryMBS, file as folderitem)
• read(size as GMGeometryMBS, Path as string)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)

See also:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(file as folderitem)
• read(path as string)
• read(size as GMGeometryMBS, file as folderitem)
• read(size as GMGeometryMBS, Path as string)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)

See also:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(file as folderitem)
• read(path as string)
• read(size as GMGeometryMBS, file as folderitem)
• read(size as GMGeometryMBS, Path as string)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.read(file as folderitem)

See also:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(path as string)
• read(size as GMGeometryMBS, file as folderitem)
• read(size as GMGeometryMBS, Path as string)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.read(path as string)

See also:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(file as folderitem)
• read(size as GMGeometryMBS, file as folderitem)
• read(size as GMGeometryMBS, Path as string)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.read(size as GMGeometryMBS, file as folderitem)

See also:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(file as folderitem)
• read(path as string)
• read(size as GMGeometryMBS, Path as string)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

GMImageMBS.read(size as GMGeometryMBS, Path as string)

See also:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(file as folderitem)
• read(path as string)
• read(size as GMGeometryMBS, file as folderitem)
• read(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)

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

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:

• read(blob as GMBlobMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer)
• read(blob as GMBlobMBS, size as GMGeometryMBS, depth as Integer, magick as string)
• read(blob as GMBlobMBS, size as GMGeometryMBS, magick as string)
• read(file as folderitem)
• read(path as string)
• read(size as GMGeometryMBS, file as folderitem)
• read(size as GMGeometryMBS, Path as string)

GMImageMBS.reduceNoise

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

image.reduceNoise

Backdrop=image.CopyPicture

See also:

• reduceNoise(order as Double)

GMImageMBS.reduceNoise(order as Double)

See also:

• reduceNoise

GMImageMBS.repage

GMImageMBS.resize(geo as GMGeometryMBS)

Var f as folderitem = SpecialFolder.Desktop.Child("test.jpg")
Var image as new GMImageMBS(f)

// resize proportionally to fit
Var geo as new GMGeometryMBS(500,500)
image.resize geo

window1.Title = image.formatExpression("%wx%h")
window1.Backdrop = image.CopyPicture

Same result as 'zoom' method.

See also:

• resize(geo as GMGeometryMBS, filterType as Integer)
• resize(geo as GMGeometryMBS, filterType as Integer, blur as double)

GMImageMBS.resize(geo as GMGeometryMBS, filterType as Integer)

Var f as folderitem = SpecialFolder.Desktop.Child("test.jpg")
Var image as new GMImageMBS(f)

// resize proportionally to fit
Var geo as new GMGeometryMBS(500,500)
image.resize geo, image.CubicFilter

window1.Title = image.formatExpression("%wx%h")
window1.Backdrop = image.CopyPicture

See also:

• resize(geo as GMGeometryMBS)
• resize(geo as GMGeometryMBS, filterType as Integer, blur as double)

GMImageMBS.resize(geo as GMGeometryMBS, filterType as Integer, blur as double)

Var f as folderitem = SpecialFolder.Desktop.Child("test.jpg")
Var image as new GMImageMBS(f)

// resize proportionally to fit
Var geo as new GMGeometryMBS(500,500)
image.resize geo, image.CubicFilter, 3

window1.Title = image.formatExpression("%wx%h")
window1.Backdrop = image.CopyPicture

See also:

• resize(geo as GMGeometryMBS)
• resize(geo as GMGeometryMBS, filterType as Integer)

GMImageMBS.roll(columns as UInt32, rows as UInt32)

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

image.roll(30,30)

Backdrop=image.CopyPicture

See also:

• roll(roll as GMGeometryMBS)

GMImageMBS.roll(roll as GMGeometryMBS)

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

image.roll(GMGeometryMBS.Make(0,0,30,30))

Backdrop=image.CopyPicture

See also:

• roll(columns as UInt32, rows as UInt32)

GMImageMBS.rotate(degree as Double)

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

image.rotate(30)

Backdrop=image.CopyPicture