Xojo Conferences
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

GMImageMBS.getPixels(x as Integer, y as Integer, columns as Integer, rows as Integer) as Ptr
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 16.4 Yes Yes Yes Yes No
Function: Transfers pixels from the image to the pixel cache as defined by the specified region.
Example:
dim f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
dim g as new GMImageMBS(f)

// get pointer to some pixels to write
dim x as ptr = g.getPixels(0, 0, 100, 100)

// draw a red line to the pixel buffer
dim o as Integer
for i as Integer = 0 to 99
o = 100 * i + i
x.UInt32(o * 4) = &hFFFF0000
next

// write back
g.syncPixels

// show
me.Backdrop = g.CopyPicture
Notes: Modified pixels may be subsequently transferred back to the image via syncPixels. This method is valid for DirectClass images.

Feedback, Comments & Corrections

GMImageMBS.gifDisposeMethod as UInt32
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: GIF disposal method.
Notes:
This option (specific to the GIF file format) is used to control how successive frames are rendered (how the preceding frame is disposed of) when creating a GIF animation.

ConstantDisposalDescription
UndefinedDispose0No disposal specified.
NoneDispose1Do not dispose between frames.
BackgroundDispose2Overwrite frame with background color from header.
PreviousDispose3Overwrite with previous frame.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.Graphics as GMGraphicsMBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 10.2 Yes Yes Yes Yes No
Function: Creates a graphics object for this image.
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.Circle(250, 250, 120, 150)

Backdrop=image.CopyPicture
Notes: Using the graphics object you can draw on the image.

Feedback, Comments & Corrections

GMImageMBS.haldClut(image as GMImageMBS)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 16.4 Yes Yes Yes Yes No
Function: Apply a color lookup table (Hald CLUT) to the image.

Feedback, Comments & Corrections

GMImageMBS.iccColorProfile as GMBlobMBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: ICC color profile.
Example:
dim f as FolderItem = SpecialFolder.Desktop.Child("IMG_0793.tif")
dim Image as new GMImageMBS(f)
dim ProfileBlob as GMBlobMBS = Image.iccColorProfile
dim ProfileData as string = ProfileBlob.CopyString
dim cm as LCMS2ProfileMBS = LCMS2ProfileMBS.OpenProfileFromString(ProfileData)
dim name as string = cm.Name

Break // check data in debugger
Notes:
Supplied via a Blob since Magick++/ and GraphicsMagick do not currently support formating this data structure directly. Specifications are available from the International Color Consortium for the format of ICC color profiles.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.implode(factor 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: Implode image (special effect).
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.implode(0.3)

Backdrop=image.CopyPicture

Feedback, Comments & Corrections

GMImageMBS.interlaceType as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: The type of interlacing scheme (default NoInterlace ).
Notes:
This option is used to specify the type of interlacing scheme for raw image formats such as RGB or YUV. NoInterlace means do not interlace, LineInterlace uses scanline interlacing, and PlaneInterlace uses plane interlacing. PartitionInterlace is like PlaneInterlace except the different planes are saved to individual files (e.g. image.R, image.G, and image.B). Use LineInterlace or PlaneInterlace to create an interlaced GIF or progressive JPEG image.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.iptcProfile as GMBlobMBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: IPTC profile.
Notes:
Supplied via a Blob since Magick++ and GraphicsMagick do not currently support formating this data structure directly. Specifications are available from the International Press Telecommunications Council for IPTC profiles.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.isValid 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: Does object contain valid image?
Notes:
Set to false in order to invalidate the image. Images constructed via the default constructor are invalid images and isValid() will return false.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.label as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Image label.

See also:

Feedback, Comments & Corrections

GMImageMBS.label(text as string)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Assign a label to an image.
Notes: Use this option to assign a specific label to the image. Optionally you can include the image filename, type, width, height, or scene number in the label by embedding special format characters. If the first character of string is @, the image label is read from a file titled by the remaining characters in the string. When converting to Postscript, use this option to specify a header string to print above the image.

See also:

Feedback, Comments & Corrections

GMImageMBS.level(black_point as Double, white_point as Double, mid_point as Double=1.0)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Level image to increase image contrast, and/or adjust image gamma.
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.level(0, 127.0)

Backdrop=image.CopyPicture
Notes: Adjust the levels of the image by scaling the colors falling between specified white and black points to the full available quantum range. The parameters provided represent the black, mid (gamma), and white points. The black point specifies the darkest color in the image. Colors darker than the black point are set to zero. Mid point (gamma) specifies a gamma correction to apply to the image. White point specifies the lightest color in the image. Colors brighter than the white point are set to the maximum quantum value. The black and white point have the valid range 0 to MaxRGB while mid (gamma) has a useful range of 0 to ten:

Feedback, Comments & Corrections

GMImageMBS.levelChannel(channel as Integer, black_point as Double, white_point as Double, mid_point as Double=1.0)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Level image channel to increase image contrast, and/or adjust image gamma.
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.levelChannel(image.BlueChannel, 0, 127.0)

Backdrop=image.CopyPicture
Notes: Adjust the levels of the image channel by scaling the colors falling between specified white and black points to the full available quantum range. The parameters provided represent the black, mid (gamma), and white points. The black point specifies the darkest color in the image. Colors darker than the black point are set to zero. Mid point (gamma) specifies a gamma correction to apply to the image. White point specifies the lightest color in the image. Colors brighter than the white point are set to the maximum quantum value. The black and white point have the valid range 0 to MaxRGB while mid (gamma) has a useful range of 0 to ten.

Feedback, Comments & Corrections

GMImageMBS.lineWidth as Double
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Stroke width for drawing vector objects (default one)
Notes:
This method is now deprecated. Please use strokeWidth instead.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.magick as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 10.2 Yes Yes Yes Yes No
Function: The name of the codec to use for compression.
Example:
// this converts 32 bit PNG with alpha channel to BMP

dim f as FolderItem = SpecialFolder.Desktop.Child("test.png")
dim p as Picture = Picture.Open(f)

dim g as new GMImageMBS( new GMGeometryMBS(p.Width, p.Height), new GMColorGrayMBS(1.0))

g.type = g.TrueColorMatteType
g.matte = True
g.magick = "BMP"

g.SetPicture(p, 0, 0)
g.SetPictureMask(p.mask.invertMBS, 0, 0)

f = SpecialFolder.Desktop.Child("test.bmp")
g.write(f)
Notes: (Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.magnify
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Magnify image by integral size (double the dimensions)
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.magnify

Backdrop=image.CopyPicture

Feedback, Comments & Corrections

GMImageMBS.map(mapImage as GMImageMBS, dither as boolean=false)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Remap image colors with closest color from a reference image.
Example:
// some picture we want to map colors
dim pic as Picture = LogoMBS(500)

// build a picture with palette
dim backgroundColor as new GMColorMBS(255,255,255) // white
dim size as new GMGeometryMBS(10,10)

dim i as new GMImageMBS(pic)
dim x as new GMImageMBS(size, backgroundColor)

x.pixelColor(0,0) = new GMColorMBS(0 ,0 ,0 ) // black
x.pixelColor(0,1) = new GMColorMBS(255,0 ,0 ) // red
x.pixelColor(0,2) = new GMColorMBS(0 ,255,0 ) // green
x.pixelColor(0,3) = new GMColorMBS(0 ,0 ,255) // blue
x.pixelColor(0,4) = new GMColorMBS(255,255,0 ) // yellow
x.pixelColor(0,5) = new GMColorMBS(0 ,255,255) // cyan
x.pixelColor(0,6) = new GMColorMBS(255,0 ,255) // magenta

// do the map
i.map(x, false)

// convert result from palette picture to bitmap picture
i.type = i.TrueColorType

// and copy picture to backdrop
Backdrop = i.CopyPicture
Notes: Set dither to true in to apply Floyd/Steinberg error diffusion to the image. By default, color reduction chooses an optimal set of colors that best represent the original image. Alternatively, you can choose a particular set of colors from an image file with this option.

Feedback, Comments & Corrections

GMImageMBS.matte 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: Image supports transparency (matte channel)
Notes: (Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.matteColor as GMColorMBS
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Image matte (frame) color.
Notes: (Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.matteFloodfill(target as GMColorMBS, opacity as UInt32, x as Integer, y as Integer, PaintMethod 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: Floodfill designated area with a replacement opacity value.

Feedback, Comments & Corrections

GMImageMBS.meanErrorPerPixel as Double
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: The mean error per pixel computed when an image is color reduced.
Notes: This parameter is only valid if verbose is set to true and the image has just been quantized.

Feedback, Comments & Corrections

GMImageMBS.medianFilter(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: Filter image by replacing each pixel component with the median color in a circular neighborhood.
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.medianFilter(10)

Backdrop=image.CopyPicture

Feedback, Comments & Corrections

GMImageMBS.minify
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Reduce image by integral (half) size.
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.minify

Backdrop=image.CopyPicture

Feedback, Comments & Corrections

GMImageMBS.modequalizeifyImage
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Not documented.

Feedback, Comments & Corrections

GMImageMBS.modifyImage
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Prepare to update image (copy if reference > 1).
Notes: Normally Magick++'s implicit reference counting takes care of all instance management. In the rare case that the automatic instance management does not work, use this method to assure that there is only one reference to the image to be modified. It should be used in the cases where a GraphicsMagick C function is used directly on an image which may have multiple references:

Feedback, Comments & Corrections

GMImageMBS.modulate(brightness as Double, saturation as Double, hue as Double)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Modulate percent hue, saturation, and brightness of an image.
Example:
dim logo as Picture = LogoMBS(500)
dim image as new GMImageMBS(logo)

image.type = image.TrueColorType

// brightness 150%
image.modulate(150,100,100)
backdrop = image.CopyPicture
Notes: Modulation of saturation and brightness is as a ratio of the current value (100 for no change). Modulation of hue is an absolute rotation of -180 degrees to +180 degrees from the current position corresponding to an argument range of 0 to 200 (100 for no change).

Feedback, Comments & Corrections

GMImageMBS.modulusDepth as UInt32
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
property GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Image modulus depth (minimum number of bits required to support red/green/blue components without loss of accuracy).
Notes:
The pixel modulus depth may be decreased by supplying a value which is less than the current value, updating the pixels (reducing accuracy) to the new depth. The pixel modulus depth can not be increased over the current value using this method.
(Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.monochrome 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: Transform image to black and white while color reducing (quantizing).
Notes: (Read and Write computed property)

Feedback, Comments & Corrections

GMImageMBS.montageGeometry 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: Tile size and offset within an image montage.
Notes: Only valid for montage images.

Feedback, Comments & Corrections

GMImageMBS.motionBlur(radius as Double, sigma as Double, angle as Double)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method GraphicsMagick MBS GraphicsMagick Plugin 9.3 Yes Yes Yes Yes No
Function: Motion blur image with specified blur factor.
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)

image.motionBlur(30,10,90)

Backdrop=image.CopyPicture
Notes: 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. The angle parameter specifies the angle the object appears to be comming from (zero degrees is from the right).

Feedback, Comments & Corrections

Previous items Next items

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




Links
MBS FileMaker Plugins