Marblecore Imaging Library Documentation

Documentation / Marblecore Imaging / Methods / DrawCurve

DrawCurve method

Syntax

Boolean DrawCurve(strPoints As String, nFillColor As Number, nFillOpacity As Number, nTension As Number, nPenColor As Number, nPenOpacity As Number, nPenStyle As Pen, nPenWidth As Number, bPenAntiAliasing As State)

Return value

Returns true if the function succeeded.

Parameters

Parameter	Type	Required	Description
strPoints	String	Yes	Specifies the points for the curve as a string. Each point pair is separated with a semicollon (;). Within each point the horizontal and vertical coordinate is separated with a comma (,). Example string: 0,100; 25,50; 50,0; 100,100.
nFillColor	Number	Yes	Specifies the fill color.
nFillOpacity	Number	No	Optional parameter containing the opacity percentage (where 0% is completely transparent).
nTension	Number	No	Specifies how tightly the curve bends through the coordinates of the cardinal spline. Default value is 10. Zero (0) means lines without curves.
nPenColor	Number	No	Optional parameter containing a color value. If no color is specified, the current pen color will be used instead.
nPenOpacity	Number	No	Optional parameter containing the opacity percentage (where 0% is completely transparent). If no opacity is specified, the current pen opacity will be used instead.
nPenStyle	Pen (Enumeration)	No	Optional parameter containing the desired line style. If no style is specified, the current pen style will be used instead.
nPenWidth	Number	No	Optional parameter containing the desired line width (thickness) in pixels (ranging from 1...100). If no width is specified, the current pen width will be used instead.
bPenAntiAliasing	State (Enumeration)	No	Optional parameter enabling or disabling line anti-aliasing. If not specified the current pen anti-aliasing setting will be used instead.

Example

The example below shows how to use the method. If you take a look at the example code, assume there is a reference to the Marblecore Imaging object with the name 'MarblecoreImaging'. Transparent parts of the image are displayed using a checkerboard pattern.

1 // Creates a new transparent image
2 MarblecoreImaging.Create(150, 150, true);
3 
4 // Execute the operation
5 MarblecoreImaging.DrawCurve("25,75; 75,25; 125,75", 16711680);
6 
7 // Save the modified image to the specified file
8 MarblecoreImaging.SaveToFile("example-drawcurve.jpg");

Category

Drawing

See also

DrawArc | DrawArrow | DrawBackground | DrawBezier | DrawCheckerboard | DrawCurveBorder | DrawCurveFilled | DrawCurveGradient | DrawEllipse | DrawEllipseBorder | DrawEllipseFilled | DrawEllipseGradient | DrawFloodFill | DrawLine | DrawPie | DrawPieBorder | DrawPieFilled | DrawPieGradient | DrawPixel | DrawPolygon | DrawPolygonBorder | DrawPolygonFilled | DrawPolygonGradient | DrawRectangle | DrawRectangleBorder | DrawRectangleFilled | DrawRectangleGradient | DrawRectangleTransparent | DrawRhombus | DrawRhombusBorder | DrawRhombusFilled | DrawRhombusGradient | DrawRoundRectangle | DrawRoundRectangleBorder | DrawRoundRectangleFilled | DrawRoundRectangleGradient | DrawTriangle | DrawTriangleBorder | DrawTriangleFilled | DrawTriangleGradient | GetPixelColor | LineTo | MoveTo