Xojo Conferences
MBSSep2018MunichDE
XDCMay2019MiamiUSA

Platforms to show: All Mac Windows Linux Cross-Platform

Previous items Next items

CDDrawAreaMBS.hline(x1 as Integer, x2 as Integer, y as Integer, c as Integer)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Draws a horizontal line.
Notes:
ArgumentDefaultDescription
x1(Mandatory)The x coordinate of the first end-point of the line.
x2(Mandatory)The x coordinate of the second end-point of the line.
y(Mandatory)The y coordinate of the line.
c(Mandatory)The color of the line.

Feedback, Comments & Corrections

CDDrawAreaMBS.hTriangleTransform(tWidth as Integer = -1, bgColor as Integer = &hFFFFFF, filter as Integer = 2, blur as Double = 1.0)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Wraps the drawing surface onto a horizontal triangle pointing leftwards.
Notes:
ArgumentDefaultDescription
tWidth-1The width of the triangle in pixels.
bgColorFFFFFFThe background color used to fill the space left after transformation.
filterLinearFilterThe filter to use for re-sampling.
blur1The blur factor to use for re-sampling.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.hTriangleTransform(tWidth as Integer, bgColor as color, filter as Integer = 2, blur as Double = 1.0)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 11.1 Yes Yes Yes Yes No
Function: Same as the other hTriangleTransform method, but uses color instead of integer data type for passing color values.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.initDynamicLayer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 12.3 Yes Yes Yes Yes No
Function: Initializes a dynamic layer for drawing text and shapes.
Notes:
This method clears the existing dynamic layer, or creates a new one if there is no existing dynamic layer. This method returned a DrawArea object that can be used to draw on the dynamic layer. The dynamic layer can later be removed using BaseChart.removeDynamicLayer.

The design of the dynamic layer is for drawing small, rapidly updatable contents for desktop applications. For example, the dynamic layer can be used to implement a cross-hair mouse cursor, with text showing the location of the mouse cursor. To do this, in the mouse move event handler, BaseChart.initDynamicLayer can be used to create or clear the dynamic layer. The returned DrawArea object can then be used to draw the cross hair cursor (as two straight lines) and the text. When the mouse cursor leaves the chart, BaseChart.removeDynamicLayer can be used in the mouse out event handler to remove the cross-hair cursor and the text.

Note that as long as the dynamic layer is not removed with BaseChart.removeDynamicLayer, only the returned DrawArea object should be used to draw things on the dynamic layer. No other objects should be used to draw on the chart.

Returns a DrawArea object that can be used to add text and shapes to the dynamic layer.

Feedback, Comments & Corrections

CDDrawAreaMBS.line(x1 as Double, y1 as Double, x2 as Double, y2 as Double, colorValue as color, lineWidth as Integer = 1)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 13.0 Yes Yes Yes Yes No
Function: Draw a straight line.
Notes:
ArgumentDefaultDescription
x1(Mandatory)The x coordinate of the first end-point of the line.
y1(Mandatory)The y coordinate of the first end-point of the line.
x2(Mandatory)The x coordinate of the second end-point of the line.
y2(Mandatory)The y coordinate of the second end-point of the line.
c(Mandatory)The color of the line.
lineWidth1The line width (thickness).

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.line(x1 as Double, y1 as Double, x2 as Double, y2 as Double, colorValue as Integer, lineWidth as Integer = 1)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Draw a straight line.
Notes:
ArgumentDefaultDescription
x1(Mandatory)The x coordinate of the first end-point of the line.
y1(Mandatory)The y coordinate of the first end-point of the line.
x2(Mandatory)The x coordinate of the second end-point of the line.
y2(Mandatory)The y coordinate of the second end-point of the line.
c(Mandatory)The color of the line.
lineWidth1The line width (thickness).

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, colors() as Integer, periodic as boolean=false) as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Creates a multi-point linear gradient color.
Notes:
In this method, the color points are defined as an array of positions and colors along a reference line segment, in the following format:

position0, color0, position1, color1, .... positionN, colorN
The positions are specified as a number from 0 - 256 (0 - 100 in hex), in which 0 represents the starting point of the reference line segment, and 256 (100 in hex) represents the ending point of the reference line segment.

For example, the array (in hex):

000000, FF0000, 000080, FFFF00, 000100, 00FF00
means the starting point (000000) is red (FF0000), the mid-point (000080 in hex) is yellow (FFFF00), and the ending point (000100 in hex) is green (00FF00).

One common usage of multi-point gradient colors is to define colors that have metallic look and feel. ChartDirector comes from several predefined gradient color arrays as follows.

NameValue (in Hex)
goldGradient 000000, FFE743, 000060, FFFFE0, 0000B0, FFF0B0, 000100, FFE743
silverGradient 000000, C8C8C8, 000060, F8F8F8, 0000B0, E0E0E0, 000100, C8C8C8
redMetalGradient 000000, E09898, 000060, FFF0F0, 0000B0, F0D8D8, 000100, E09898
greenMetalGradient 000000, 98E098, 000060, F0FFF0, 0000B0, D8F0D8, 000100, 98E098
blueMetalGradient 000000, 9898E0, 000060, F0F0FF, 0000B0, D8D8F0, 000100, 9898E0

ArgumentDefaultDescription
startX(Mandatory)The x coordinate of the starting point of the reference gradient line segment.
startY(Mandatory)The y coordinate of the starting point of the reference gradient line segment.
endX(Mandatory)The x coordinate of the ending point of the reference gradient line segment.
endY(Mandatory)The y coordinate of the ending point of the reference gradient line segment.
colorArray(Mandatory)An array defining the positions and colors of the pixels along the reference gradient line segment.
periodicfalseSpecifies whether the gradient will repeat itself periodically. If the gradient does not repeat itself, the points that lie beyond the end points of the gradient line segment will assume the colors of the end points.
Return Value
A 32-bit integer representing the linear gradient color.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, startColor as color, endColor as color, periodic as boolean=false) as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 11.1 Yes Yes Yes Yes No
Function: Same as the other linearGradientColor method, but uses color instead of integer data type for passing color values.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.linearGradientColor(startX as Integer, startY as Integer, endX as Integer, endY as Integer, startColor as Integer, endColor as Integer, periodic as boolean=false) as Integer
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Creates a two-point linear gradient color.
Notes:
ArgumentDefaultDescription
startX(Mandatory)The x coordinate of the starting point of the reference gradient line segment.
startY(Mandatory)The y coordinate of the starting point of the reference gradient line segment.
endX(Mandatory)The x coordinate of the ending point of the reference gradient line segment.
endY(Mandatory)The y coordinate of the ending point of the reference gradient line segment.
startColor(Mandatory)The color at the starting point of the reference gradient line segment.
endColor(Mandatory)The color at the ending point of the reference gradient line segment.
periodicfalseSpecifies whether the gradient will repeat itself periodically. If the gradient does not repeat itself, the points that lie beyond the end points of the gradient line segment will assume the colors of the end points.
Return Value
A 32-bit integer representing the linear gradient color.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.load(path as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Load an image file into the current DrawArea.
Notes:
This method will overwrite the current DrawArea. The image type is determined based on file extension, which must be png, jpg/jpeg, gif or wbmp/wmp.
ArgumentDefaultDescription
filename(Mandatory)The filename of the image to be loaded.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

Feedback, Comments & Corrections

CDDrawAreaMBS.loadGIF(path as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Load a GIF image into the current DrawArea.
Notes:
This method will overwrite the current DrawArea.
ArgumentDefaultDescription
filename(Mandatory)The filename of the image to be loaded.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

Feedback, Comments & Corrections

CDDrawAreaMBS.loadJPG(path as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Load a JPG image into the current DrawArea.
Notes:
This method will overwrite the current DrawArea.
ArgumentDefaultDescription
filename(Mandatory)The filename of the image to be loaded.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

Feedback, Comments & Corrections

CDDrawAreaMBS.loadPNG(path as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Load a PNG image into the current DrawArea.
Notes:
This method will overwrite the current DrawArea.
ArgumentDefaultDescription
filename(Mandatory)The filename of the image to be loaded.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

Feedback, Comments & Corrections

CDDrawAreaMBS.loadWMP(path as string) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Load a WAP bitmap image into the current DrawArea.
Notes:
This method will overwrite the current DrawArea.
ArgumentDefaultDescription
filename(Mandatory)The filename of the image to be loaded.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

Feedback, Comments & Corrections

CDDrawAreaMBS.merge(d as CDDrawAreaMBS, x as Integer, y as Integer, align as Integer, transparency as Integer)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Copy another DrawArea to the current DrawArea.
Notes:
ArgumentDefaultDescription
d(Mandatory)A DrawArea object representing the source.
x(Mandatory)The x coordinate of a reference point in the current DrawArea.
y(Mandatory)The y coordinate of a reference point in the current DrawArea.
align(Mandatory)The alignment of the source DrawArea relative to the reference point. See Alignment Specification for supported alignment types.
transparency(Mandatory)Specify the transparency level when copying the other DrawArea to the current DrawArea. A value of 0 means non-transparent. A value of 255 means totally transparent.

Feedback, Comments & Corrections

CDDrawAreaMBS.move(xOffset as Double, yOffset as Double, bgColor as color, filter as Integer = 2, blur as Double = 1.0)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 11.1 Yes Yes Yes Yes No
Function: Same as the other move method, but uses color instead of integer data type for passing color values.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.move(xOffset as Double, yOffset as Double, bgColor as Integer = &hFFFFFF, filter as Integer = 2, blur as Double = 1.0)
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Moves the drawing surface.
Notes:
ArgumentDefaultDescription
xOffset(Mandatory)The pixel offset to move towards the left.
yOffset(Mandatory)The pixel offset to move towards the bottom.
bgColorFFFFFFThe background color used to fill the space left after moving.
filterLinearFilterThe filter to use for re-sampling. (Only applies for fractional pixel offsets.)
blur1The blur factor to use for re-sampling. (Only applies for fractional pixel offsets.)

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.out(file as folderitem) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea to an image file.
Notes:
The file format is determined based on file extension, which must be png, jpg/jpeg, gif, wbmp/wmp or bmp.
ArgumentDefaultDescription
filename(Mandatory)The filename of the output image file.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

Feedback, Comments & Corrections

CDDrawAreaMBS.outBMP as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea as a BMP image to memory.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outBMP(file as folderitem) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea to a BMP image file.
Notes:
ArgumentDefaultDescription
filename(Mandatory)The filename of the output image file.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outGIF as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea as a GIF image to memory.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outGIF(file as folderitem) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea to a GIF image file.
Notes:
ArgumentDefaultDescription
filename(Mandatory)The filename of the output image file.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outJPG(file as folderitem, quality as Integer = 80) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea to a JPEG image file.
Notes:
ArgumentDefaultDescription
filename(Mandatory)The filename of the output image file.
quality80The quality of the image.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outJPG(quality as Integer = 80) as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea as a JPEG image to memory.
Notes:
ArgumentDefaultDescription
quality80The quality of the image.
Return Value
A binary string containing the JPEG image.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outPDF as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 15.1 Yes Yes Yes Yes No
Function: Writes the DrawArea as a PDF image to memory.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outPDF(file as folderitem) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 15.1 Yes Yes Yes Yes No
Function: Writes the DrawArea to a PDF image file.
Notes: A return value being true indicates no error. A false value indicates the operation is unsuccessful.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outPicture as picture
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea into a picture.
Notes: Returns nil on any error.

Feedback, Comments & Corrections

CDDrawAreaMBS.outPNG as string
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea as a PNG image to memory.

See also:

Feedback, Comments & Corrections

CDDrawAreaMBS.outPNG(file as folderitem) as boolean
Type Topic Plugin Version macOS Windows Linux Console & Web iOS
method ChartDirector MBS ChartDirector Plugin 8.2 Yes Yes Yes Yes No
Function: Writes the DrawArea to a PNG image file.
Notes:
ArgumentDefaultDescription
filename(Mandatory)The filename of the output image file.
Return Value
A true value indicates no error. A false value indicates the operation is unsuccessful.

See also:

Feedback, Comments & Corrections

Previous items Next items

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





Links
MBS FileMaker Plugins