Platforms to show: All Mac Windows Linux Cross-Platform
GMImageMBS.normalizedMaxError as Double
Function:
The normalized max 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.
(Read only property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes:
This parameter is only valid if verbose is set to true and the image has just been quantized.
(Read only property)
GMImageMBS.normalizedMeanError as Double
Function:
The normalized 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.
(Read only property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes:
This parameter is only valid if verbose is set to true and the image has just been quantized.
(Read only property)
GMImageMBS.orientation as Integer
Function:
Image orientation. Supported by some file formats such as DPX and TIFF. Useful for turning the right way up.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.page as GMGeometryMBS
Function:
Preferred size and location of an image canvas.
Notes:
Use this option to specify the dimensions and position of the Postscript page in dots per inch or a TEXT page in pixels. This option is typically used in concert with density .
Page may also be used to position a GIF image (such as for a scene in an animation).
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes:
Use this option to specify the dimensions and position of the Postscript page in dots per inch or a TEXT page in pixels. This option is typically used in concert with density .
Page may also be used to position a GIF image (such as for a scene in an animation).
(Read and Write property)
GMImageMBS.penColor as GMColorMBS
Function:
The pen color.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.quality as UInt32
Function:
JPEG/MIFF/PNG compression level (default 75).
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.quantizeColors as UInt32
Function:
Maximum number of colors to quantize to.
Example:
Notes:
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)
image.quantizeColors = 10
image.quantize
image.type = image.TrueColorType
Backdrop=image.CopyPicture
GMImageMBS.quantizeColorSpace as Integer
Function:
Colorspace to quantize in (default RGB).
Example:
Notes:
Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Example:
// load a picture
dim f as FolderItem = SpecialFolder.Desktop.Child("test.png")
dim pic as Picture = Picture.Open(f)
const GrayColorSpace = 2
Dim Converter As New GMImageMBS(Pic)
// quantize with dither
Converter.type = GMImageMBS.BilevelType
Converter.quantizeColorSpace = GrayColorSpace
Converter.quantizeColors = 2
Converter.quantizeDither = True
Converter.quantize
// convert back to Xojo
Converter.type = GMImageMBS.TrueColorType
Backdrop = Converter.CopyPicture
Empirical evidence suggests that distances in color spaces such as YUV or YIQ correspond to perceptual color differences more closely than do distances in RGB space. These color spaces may give better results when color reducing an image.
(Read and Write property)
GMImageMBS.quantizeDither as boolean
Function:
Apply Floyd/Steinberg error diffusion to the image.
Example:
Notes:
The basic strategy of dithering is to trade intensity resolution for spatial resolution by averaging the intensities of several neighboring pixels. Images which suffer from severe contouring when reducing colors can be improved with this option. The quantizeColors or monochrome option must be set for this option to take effect.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)
image.quantizeColors = 10
image.quantizeDither = true
image.quantize
image.type = image.TrueColorType
Backdrop=image.CopyPicture
The basic strategy of dithering is to trade intensity resolution for spatial resolution by averaging the intensities of several neighboring pixels. Images which suffer from severe contouring when reducing colors can be improved with this option. The quantizeColors or monochrome option must be set for this option to take effect.
(Read and Write property)
GMImageMBS.quantizeTreeDepth as UInt32
Function:
Depth of the quantization color classification tree.
Notes:
Values of 0 or 1 allow selection of the optimal tree depth for the color reduction algorithm. Values between 2 and 8 may be used to manually adjust the tree depth.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes:
Values of 0 or 1 allow selection of the optimal tree depth for the color reduction algorithm. Values between 2 and 8 may be used to manually adjust the tree depth.
(Read and Write property)
GMImageMBS.Quiet as Boolean
Function:
Suppress all warning messages.
Notes:
Error messages are still reported.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 19.0 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes:
Error messages are still reported.
(Read and Write property)
GMImageMBS.renderingIntent as Integer
Function:
The type of rendering intent (used when applying an ICC color profile).
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.resolutionUnits as Integer
Function:
Units of image resolution.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.rows as UInt32
Function:
The number of pixel rows in the image.
Example:
Notes:
(Read only property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)
Title = str(image.columns)+" x "+str(image.rows)
Backdrop=image.CopyPicture
GMImageMBS.scene as UInt32
Function:
Image scene number.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.size as GMGeometryMBS
Function:
Width and height of a raw image (an image which does not support width and height information).
Example:
Notes:
Size may also be used to affect the image size read from a multi-resolution format (e.g. Photo CD, JBIG, or JPEG.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)
MsgBox image.size.StringValue
image.size = new GMGeometryMBS(200,200)
Backdrop=image.CopyPicture
Size may also be used to affect the image size read from a multi-resolution format (e.g. Photo CD, JBIG, or JPEG.
(Read and Write property)
GMImageMBS.strokeAntiAlias as boolean
Function:
Enable/disable stroke anti-aliasing.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.strokeColor as GMColorMBS
Function:
Color to use when drawing object outlines.
Example:
Notes:
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
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
GMImageMBS.strokeDashOffset as Double
Function:
While drawing using a dash pattern, specify distance into the dash pattern to start the dash (default 0).
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.strokeLineCap as Integer
Function:
Specify the shape to be used at the end of open subpaths when they are stroked. #
Notes:
Values of LineCap are UndefinedCap, ButtCap, RoundCap, and SquareCap.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes:
Values of LineCap are UndefinedCap, ButtCap, RoundCap, and SquareCap.
(Read and Write property)
GMImageMBS.strokeLineJoin as Integer
Function:
Specify the shape to be used at the corners of paths (or other vector shapes) when they are stroked. Values of LineJoin are UndefinedJoin, MiterJoin, RoundJoin, and BevelJoin.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.strokeMiterLimit as UInt32
Function:
Specify miter limit.
Notes:
When two line segments meet at a sharp angle and miter joins have been specified for 'lineJoin', it is possible for the miter to extend far beyond the thickness of the line stroking the path. The miterLimit' imposes a limit on the ratio of the miter length to the 'lineWidth'. The default value of this parameter is 4.
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes:
When two line segments meet at a sharp angle and miter joins have been specified for 'lineJoin', it is possible for the miter to extend far beyond the thickness of the line stroking the path. The miterLimit' imposes a limit on the ratio of the miter length to the 'lineWidth'. The default value of this parameter is 4.
(Read and Write property)
GMImageMBS.strokePattern as GMImageMBS
Function:
Pattern image to use while stroking object outlines.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.strokeWidth as Double
Function:
Stroke width for drawing vector objects (default one).
Example:
Notes:
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
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
GMImageMBS.subImage as UInt32
Function:
Subimage of an image sequence.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.subRange as UInt32
Function:
Number of images relative to the base image.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.textEncoding as string
Function:
Annotation text encoding (e.g. "UTF-16").
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.tileName as string
Function:
Tile name.
Notes: (Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Notes: (Read and Write property)
GMImageMBS.totalColors as UInt32
Function:
Number of colors in the image.
Example:
Notes:
(Read only property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)
Title = str(image.totalColors) // shows 5284
Backdrop=image.CombinePictureWithMask
GMImageMBS.type as Integer
Function:
The type of this image.
Example:
Notes:
You can set this value to convert the image to the type.
Convert the image representation to the specified type or retrieve the current image type. If the image is reduced to an inferior type, then image information may be lost (e.g. color changed to grayscale).
Available enumerations for the type parameter:
(Read and Write property)
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| property | GraphicsMagick | MBS GraphicsMagick Plugin | 9.3 | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | All |
Example:
dim p as Picture = LogoMBS(500)
dim image as new GMImageMBS(p)
image.type = image.GrayscaleType
Backdrop=image.CopyPicture
You can set this value to convert the image to the type.
Convert the image representation to the specified type or retrieve the current image type. If the image is reduced to an inferior type, then image information may be lost (e.g. color changed to grayscale).
Available enumerations for the type parameter:
| BilevelType | 1 | black/white |
| GrayscaleType | 2 | grayscale |
| GrayscaleMatteType | 3 | grayscale with alpha (opacity) channel |
| PaletteType | 4 | colormapped |
| PaletteMatteType | 5 | colormapped with transparency |
| TrueColorType | 6 | true (full) color |
| TrueColorMatteType | 7 | true (full) color with alpha (opacity) channel |
| ColorSeparationType | 8 | Cyan, magenta, yellow, and black |
| ColorSeparationMatteType | 9 | Cyan, magenta, yellow, and black with alpha (opacity) channel |
| OptimizeType | 10 | Optimize the image type to best represent the existing pixels |
The items on this page are in the following plugins: MBS GraphicsMagick Plugin.
Links
MBS Xojo Plugins
