GMImageMBS.floodFillTexture(x as UInt32, y as UInt32, fillColor as GMColorMBS)

Uses current fuzz setting when determining color match.

See also:

• floodFillTexture(point as GMGeometryMBS, fillColor as GMColorMBS)
• floodFillTexture(point as GMGeometryMBS, fillColor as GMColorMBS, borderColor as GMColorMBS)
• floodFillTexture(x as UInt32, y as UInt32, fillColor as GMColorMBS, borderColor as GMColorMBS)

GMImageMBS.floodFillTexture(x as UInt32, y as UInt32, fillColor as GMColorMBS, borderColor as GMColorMBS)

Uses current fuzz setting when determining color match.

See also:

• floodFillTexture(point as GMGeometryMBS, fillColor as GMColorMBS)
• floodFillTexture(point as GMGeometryMBS, fillColor as GMColorMBS, borderColor as GMColorMBS)
• floodFillTexture(x as UInt32, y as UInt32, fillColor as GMColorMBS)

GMImageMBS.flop

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

image.flop

Backdrop=image.CopyPicture

GMImageMBS.fontTypeMetrics(name as string) as GMTypeMetricMBS

GMImageMBS.formatExpression(expression as string) as string

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

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

For example "%wx%h" is converted to a string containing image WIDTHxHEIGHT like "640x480".

GMImageMBS.frame

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

image.frame

Backdrop=image.CopyPicture

See also:

• frame(geometry as GMGeometryMBS)
• frame(width as UInt32, height as UInt32, innerBevel as Integer=6, outerBevel as Integer=6)

GMImageMBS.frame(geometry as GMGeometryMBS)

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

image.frame(GMGeometryMBS.Make("10x10"))

Backdrop=image.CopyPicture

See also:

• frame
• frame(width as UInt32, height as UInt32, innerBevel as Integer=6, outerBevel as Integer=6)

GMImageMBS.frame(width as UInt32, height as UInt32, innerBevel as Integer=6, outerBevel as Integer=6)

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

image.frame(15,15)

Backdrop=image.CopyPicture

See also:

• frame
• frame(geometry as GMGeometryMBS)

GMImageMBS.gamma(gammaRed as Double, gammaGreen as Double, gammaBlue as Double)

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

image.gamma(1,2,3)

Backdrop=image.CopyPicture

See also:

• gamma as Double

GMImageMBS.gaussianBlur(width as Double, sigma as Double)

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

image.gaussianBlur(30, 10)

Backdrop=image.CopyPicture

The number of neighbor pixels to be included in the convolution mask is specified by width. The standard deviation of the gaussian bell curve is specified by sigma

GMImageMBS.gaussianBlurChannel(channel as Integer, width as Double, sigma as Double)

The number of neighbor pixels to be included in the convolution mask is specified by width. The standard deviation of the gaussian bell curve is specified by sigma.

GMImageMBS.getChromaBluePrimary(byref x as Double, byref y as Double)

GMImageMBS.getchromaGreenPrimary(byref x as Double, byref y as Double)

e.g. x=0.3, y=0.6

GMImageMBS.getchromaRedPrimary(byref x as Double, byref y as Double)

e.g. x=0.64, y=0.33

GMImageMBS.getchromaWhitePoint(byref x as Double, byref y as Double)

e.g. x=0.3127, y=0.329

GMImageMBS.getConstPixels(x as Integer, y as Integer, columns as Integer, rows as Integer) as Ptr

GMImageMBS.GetEXIFOrientation(byref orientation as integer) as boolean

Orientation is set to number from 0 to 8 depending on rotation. -1 if unknown.
This function can only read orientation, if there is an EXIF block in image.
Returns true for success and false for failure.

For new development, please use ExifTagsMBS class instead.

GMImageMBS.getPixels(x as Integer, y as Integer, columns as Integer, rows as Integer) as Ptr

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

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

// draw a red line to the pixel buffer
Var 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

Modified pixels may be subsequently transferred back to the image via syncPixels. This method is valid for DirectClass images.

GMImageMBS.Graphics as GMGraphicsMBS

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.Circle(250, 250, 120, 150)

Backdrop=image.CopyPicture

Using the graphics object you can draw on the image.

GMImageMBS.haldClut(image as GMImageMBS)

GMImageMBS.Hash(Size as Integer = 8) as String

Var p As Picture = LogoMBS(500)
Var g As New GMImageMBS(p)
msgbox g.Hash

Hash is returned as 64 characters being 1 or 0.
We convert image to 8x8, turn grayscale and check if pixels are above or below mean value.
This hash is quite immune against resizing, compression artifacts and hue changes.
You can use LevenshteinDistanceMBS or JaroWinklerDistanceMBS to compare two hashes.

Added size parameter for version 22.4:
The size of the bitmap. Value from 8 to 1024. Default is 8.

GMImageMBS.implode(factor as Double=0.0)

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

image.implode(0.3)

Backdrop=image.CopyPicture

GMImageMBS.label(text as string)

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:

• label as string

GMImageMBS.level(black_point as Double, white_point as Double, mid_point as Double=1.0)

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

image.level(0, 127.0)

Backdrop=image.CopyPicture

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:

GMImageMBS.levelChannel(channel as Integer, black_point as Double, white_point as Double, mid_point as Double=1.0)

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

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

Backdrop=image.CopyPicture

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.

GMImageMBS.magnify

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

image.magnify

Backdrop=image.CopyPicture

GMImageMBS.map(mapImage as GMImageMBS, dither as boolean=false)

// some picture we want to map colors
Var pic as Picture = LogoMBS(500)

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

Var i as new GMImageMBS(pic)
Var 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

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.

GMImageMBS.matteFloodfill(target as GMColorMBS, opacity as UInt32, x as Integer, y as Integer, PaintMethod as Integer)

Paint methods:

PointMethod	0	Replace pixel color at point.
ReplaceMethod	1	Replace color for all image pixels matching color at point.
FloodfillMethod	2	Replace color for pixels surrounding point until encountering pixel that fails to match color at point.
FillToBorderMethod	3	Replace color for pixels surrounding point until encountering pixels matching border color.
ResetMethod	4	Replace colors for all pixels in image with pen color.

GMImageMBS.medianFilter(radius as Double=0.0)

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

image.medianFilter(10)

Backdrop=image.CopyPicture

GMImageMBS.minify

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

image.minify

Backdrop=image.CopyPicture

GMImageMBS.modequalizeifyImage

GMImageMBS.modifyImage

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:

GMImageMBS.modulate(brightness as Double, saturation as Double, hue as Double)

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

image.type = image.TrueColorType

// brightness 150%
image.modulate(150,100,100)
backdrop = image.CopyPicture

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

GMImageMBS.montageGeometry as GMGeometryMBS

Only valid for montage images.

GMImageMBS.motionBlur(radius as Double, sigma as Double, angle as Double)

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

image.motionBlur(30,10,90)

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

GMImageMBS.negate(grayscale as boolean=false)

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

image.negate

Backdrop=image.CopyPicture

Set grayscale to only negate grayscale values in image.

GMImageMBS.normalize

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

image.normalize

Backdrop=image.CopyPicture

GMImageMBS.oilPaint(radius as Double=3.0)

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

image.oilPaint

Backdrop=image.CopyPicture

GMImageMBS.opacity(opacity as UInt32)

If the image pixels are opaque then they are set to the specified opacity value, otherwise they are blended with the supplied opacity value. The value of opacity ranges from 0 (completely opaque) to MaxRGB. The defines OpaqueOpacity and TransparentOpacity are available to specify completely opaque or completely transparent, respectively.

GMImageMBS.opaque(opaqueColor as GMColorMBS, penColor as GMColorMBS)

GMImageMBS.ping(data as GMBlobMBS)

Ping is similar to read except only enough of the image is read to determine the image columns, rows, and filesize. Access the columns, rows, and fileSize attributes after invoking ping. The image pixels are not valid after calling ping.

See also:

• ping(file as folderitem)
• ping(Path as string)