GMImageMBS.sample(geometry as GMGeometryMBS)

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

image.sample GMGeometryMBS.make(100,100)

Backdrop=image.CopyPicture

GMImageMBS.scale(geometry as GMGeometryMBS)

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

image.scale new GMGeometryMBS(100,100)

Backdrop=image.CopyPicture

GMImageMBS.segment(clusterThreshold as Double=1.0, smoothingThreshold as Double=1.5)

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

image.segment

image.type = image.TrueColorType

Backdrop=image.CopyPicture

A histogram is built for the image. This histogram is filtered to reduce noise and a second derivative of the histogram plot is built and used to identify potential cluster colors (peaks in the histogram). The cluster colors are then validated by scanning through all of the pixels to see how many pixels fall within each cluster. Some candidate cluster colors may not match any of the image pixels at all and should be discarded. Specify clusterThreshold, as the number of pixels matching a cluster color in order for the cluster to be considered valid. SmoothingThreshold eliminates noise in the second derivative of the histogram. As the value is increased, you can expect a smoother second derivative. The default is 1.5.

GMImageMBS.setChromaBluePrimary(x as Double, y as Double)

e.g. x=0.15, y=0.06

GMImageMBS.setchromaGreenPrimary(x as Double, y as Double)

e.g. x=0.3, y=0.6

GMImageMBS.setchromaRedPrimary(x as Double, y as Double)

e.g. x=0.64, y=0.33

GMImageMBS.setchromaWhitePoint(x as Double, y as Double)

e.g. x=0.3127, y=0.329

GMImageMBS.SetEXIFOrientation(orientation as integer) as boolean

Changing orientation may need to set orientation via SetOrientation and SetEXIFOrientation. With a JPEG you have orientation both in JPEG header and in EXIF metadata.
Returns true for success and false for failure.

For new development, please use ExifTagsMBS class instead.

GMImageMBS.SetPicture(pic as picture, x as Integer, y as Integer)

GMImageMBS.SetPictureMask(maskpic as picture, x as Integer, y as Integer)

// this converts 32 bit PNG with alpha channel to BMP

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

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

GMImageMBS.setPixels(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.setPixels(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

This area is subsequently transferred from the pixel cache to the image via syncPixels.

GMImageMBS.setStrokeDashArray(values() as Double)

Specify the pattern of dashes and gaps used to stroke paths. The strokeDashArray represents a zero-terminated array of numbers that specify the lengths of alternating dashes and gaps in pixels. If an odd number of values is provided, then the list of values is repeated to yield an even number of values. A typical strokeDashArray array might contain the members 5 3 2 0, where the zero value indicates the end of the pattern array.

GMImageMBS.shade(azimuth as Double=30.0, elevation as Double=30.0, colorShading as boolean=false)

Specify azimuth and elevation as the position of the light source. By default, the shading results as a grayscale image.. Set colorShading to true to shade the red, green, and blue components of the image.

GMImageMBS.sharpen(radius as Double=0.0, sigma as Double=1.0)

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

image.sharpen

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.

GMImageMBS.sharpenChannel(channel as Integer, radius as Double=0.0, sigma as Double=1.0)

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.

GMImageMBS.shave(geometry as GMGeometryMBS)

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

image.shave(new GMGeometryMBS(200,200))

Backdrop=image.CopyPicture

GMImageMBS.shear(xShearAngle as Double, yShearAngle as Double)

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

image.shear(10,20)

Backdrop=image.CopyPicture

Shearing slides one edge of an image along the X or Y axis, creating a parallelogram. An X direction shear slides an edge along the X axis, while a Y direction shear slides an edge along the Y axis. The amount of the shear is controlled by a shear angle. For X direction shears, x degrees is measured relative to the Y axis, and similarly, for Y direction shears y degrees is measured relative to the X axis. Empty triangles left over from shearing the image are filled with the color defined as borderColor.

GMImageMBS.signature(force as boolean=false) as string

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

MsgBox image.signature

Backdrop=image.CopyPicture

Set force to true in order to re-calculate the signature regardless of whether the image data has been modified.

GMImageMBS.solarize(factor as Double=50.0)

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

image.solarize

Backdrop=image.CopyPicture

GMImageMBS.spread(amount as UInt32=3)

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

image.spread 5

Backdrop=image.CopyPicture

GMImageMBS.statistics as GMImageStatisticsMBS

Var f as FolderItem = SpecialFolder.Desktop.Child("test.jpg")
Var g as new GMImageMBS(f)
Var stat as GMImageStatisticsMBS = g.statistics
Var gs as GMImageChannelStatisticsMBS = stat.blue

MsgBox "blue channel: "+str(gs.minimum)+"-"+str(Gs.maximum)+", mean "+str(gs.mean)

Statistics are normalized to the range of 0.0 to 1.0 and are output to the specified ImageStatistics structure.

GMImageMBS.stegano(watermark as GMImageMBS)

Var p as Picture = LogoMBS(500)
Var p1 as Picture = New Picture(550,500,32)
Var p2 as Picture = New Picture(550,500,32)

p1.Graphics.DrawPicture p, 0,0
p2.Graphics.DrawPicture p,50,0

Var image1 as new GMImageMBS(p1)
Var image2 as new GMImageMBS(p2)

image2.zoom(new GMGeometryMBS(100,100)) // scale down

// add watermark
image1.stegano(image2)

// now make a threshold so you see the difference
image1.threshold 254

image1.type = image1.TrueColorType
Backdrop=image1.CopyPicture

GMImageMBS.stereo(rightImage as GMImageMBS)

Var p as Picture = LogoMBS(500)
Var p1 as Picture = New Picture(550,500,32)
Var p2 as Picture = New Picture(550,500,32)

p1.Graphics.DrawPicture p, 0,0
p2.Graphics.DrawPicture p,50,0

Var image1 as new GMImageMBS(p1)
Var image2 as new GMImageMBS(p2)

image1.stereo(IMAGE2)

Backdrop=image1.CopyPicture

GMImageMBS.strip

GMImageMBS.strokeDashArray as Double()

Specify the pattern of dashes and gaps used to stroke paths. The strokeDashArray represents a zero-terminated array of numbers that specify the lengths of alternating dashes and gaps in pixels. If an odd number of values is provided, then the list of values is repeated to yield an even number of values. A typical strokeDashArray array might contain the members 5 3 2 0, where the zero value indicates the end of the pattern array.

GMImageMBS.swirl(degree as Double)

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

image.swirl 200

Backdrop=image.CopyPicture

GMImageMBS.syncPixels