Xojo Conferences
XDCMay2019MiamiUSA
MBSOct2019CologneDE

Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

GMImageMBS.composite(compositeImage as GMImageMBS, offset as GMGeometryMBS, CompositeOperator as Integer=2)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Compose an image onto another at specified x and y offset and using a specified algorithm.

See also:

Feedback, Comments & Corrections

GMImageMBS.composite(compositeImage as GMImageMBS, xOffset as Integer, yOffset as Integer, CompositeOperator as Integer=2)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Compose an image onto another at specified x and y offset and using a specified algorithm.

See also:

Feedback, Comments & Corrections

GMImageMBS.Constructor
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Default constructor.
Example:
// get some image data (e.g. from blob in database)
dim logo as Picture = LogoMBS(500)
dim jpegData as string = PictureToJPEGStringMBS(logo, 80)

// new image
Dim mp as new GMImageMBS
dim 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:

Feedback, Comments & Corrections

GMImageMBS.Constructor(size as GMGeometryMBS, ColorValue as GMColorMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Construct a blank image canvas of specified size and color.
Example:
dim g as new GMGeometryMBS(600,600)
dim c as new GMColorRGBMBS(1.0,0.0,0.0) // red
dim 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:

Feedback, Comments & Corrections

GMImageMBS.Constructor(width as UInt32, height as UInt32, map as string, StorageType as Integer, data as ptr)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 14.1 Yes Yes Yes Yes No
Function: Initializes single image frame from an array of raw pixels, with specified storage type (ConstituteImage).
Example:
dim data as new memoryblock(2048*2048) // your data
dim image as new GMImageMBS(2048, 2048, "I", GMImageMBS.StorageTypeCharPixel, data)
Notes:
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:

Feedback, Comments & Corrections

GMImageMBS.contrast(sharpen as UInt32)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Contrast image (enhance intensity differences in image).
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.contrast(10)

Backdrop=image.CopyPicture

Feedback, Comments & Corrections

GMImageMBS.convolve(order as Integer, ColorMatrix() as Double)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 16.4 Yes Yes Yes Yes No
Function: Convolve image.
Example:
dim f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
dim g as new GMImageMBS(f)

dim 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
Notes:
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.

Feedback, Comments & Corrections

GMImageMBS.CopyPicture as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Creates a copy of the image and returns it as a new picture.
Example:
dim g as new GMGeometryMBS(500,500)
dim c as new GMColorRGBMBS("white") // white
dim image as new GMImageMBS(g, c)

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

dim draw as GMGraphicsMBS = image.Graphics

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

Backdrop=image.CopyPicture
Notes: You may need to set image type to RGB to get it working.

See also:

Feedback, Comments & Corrections

GMImageMBS.CopyPicture(x as Integer, y as Integer, width as Integer, height as Integer) as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Creates a copy of the image and returns it as a new picture.
Example:
dim p as Picture = LogoMBS(500)
dim 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)
Notes: You may need to set image type to RGB to get it working.

See also:

Feedback, Comments & Corrections

GMImageMBS.CopyPictureMask as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Creates a copy of the image's mask and returns it as a new picture.

See also:

Feedback, Comments & Corrections

GMImageMBS.CopyPictureMask(x as Integer, y as Integer, width as Integer, height as Integer) as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Creates a copy of the image's mask and returns it as a new picture.

See also:

Feedback, Comments & Corrections

GMImageMBS.CopyPixelsMemory as Memoryblock
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 15.0 Yes Yes Yes Yes No
Function: Copy the pixels as they are into a memoryblock.
Notes:
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:

Feedback, Comments & Corrections

GMImageMBS.CopyPixelsMemory(x as Integer, y as Integer, width as Integer, height as Integer) as Memoryblock
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 15.0 Yes Yes Yes Yes No
Function: Copy the pixels as they are into a memoryblock.
Notes:
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:

Feedback, Comments & Corrections

GMImageMBS.CreateHBITMAP as Ptr
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 15.1 No Yes No Yes, Windows only No
Function: Creates a HBITMAP for the image for use with Windows Declares.
Example:
// get test image
dim logo as Picture = LogoMBS(500)

// create GraphicsMagick image
dim g as new GMImageMBS(logo)

// make a HBitmap
dim hBitmap as ptr = g.CreateHBITMAP

// convert back to Xojo picture
dim pic as Picture = WindowsBitmapMBS.HBitmapToPicture(hBitmap, true)

// show in window
Backdrop = pic

// and cleanup memory
WindowsBitmapMBS.DeleteBitmap(hBitmap)
Notes: The HBITMAP returned needs to be freed when you are done with it or you risk having a memory leak.

Feedback, Comments & Corrections

GMImageMBS.crop(geometry as GMGeometryMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Crop image (return subregion of original image).
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.crop GMGeometryMBS.Make(100,200)

Backdrop=image.CopyPicture

Feedback, Comments & Corrections

GMImageMBS.cycleColormap(amount as Integer)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Cycle (rotate) image colormap.
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.cycleColormap(5)

image.type = image.TrueColorType

Backdrop=image.CopyPicture

Feedback, Comments & Corrections

GMImageMBS.defineSet(magick as string, key as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Set or obtain a definition flag to applied when encoding or decoding the specified format.
Notes:
Similar to the defineValue() method except that passing the flag value 'true' creates a value-less define with that format and key. Passing the flag value 'false' removes any existing matching definition. The method returns 'true' if a matching key exists, and 'false' if no matching key exists.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.defineValue(magick as string, key as string) as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Set or obtain a definition string to applied when encoding or decoding the specified format.
Notes:
The meanings of the definitions are format specific. The format is designated by the magick argument, the format-specific key is designated by key, and the associated value is specified by value. See the defineSet() method if the key must be removed entirely.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.despeckle
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Despeckle image (reduce speckle noise).
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.despeckle

Backdrop=image.CopyPicture

Feedback, Comments & Corrections

GMImageMBS.display
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Display image on screen.
Notes:
Caution: if an image format is is not compatible with the display visual (e.g. JPEG on a colormapped display) then the original image will be altered. Use a copy of the original if this is a problem.

The plugin is not compiled with X11 so this call may not be useful.

Feedback, Comments & Corrections

GMImageMBS.edge(radius as Double=0.0)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Edge image (hilight edges in image).
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.edge

Backdrop=image.CopyPicture
Notes: The radius is the radius of the pixel neighborhood. Specify a radius of zero for automatic radius selection.

Feedback, Comments & Corrections

Previous items Next items

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




Links
MBS Xojo Chart Plugins