Marblecore Imaging Library Documentation

Documentation Introduction
Documentation / Marblecore Imaging / Methods / DrawCurve

DrawCurve method

Draws a filled cardinal spline curve with border on the specified position on the image using the specified color, style and opacity.

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

ParameterTypeRequiredDescription
strPointsStringYesSpecifies 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.
nFillColorNumberYesSpecifies the fill color.
nFillOpacityNumberNoOptional parameter containing the opacity percentage (where 0% is completely transparent).
nTensionNumberNoSpecifies how tightly the curve bends through the coordinates of the cardinal spline. Default value is 10. Zero (0) means lines without curves.
nPenColorNumberNoOptional parameter containing a color value. If no color is specified, the current pen color will be used instead.
nPenOpacityNumberNoOptional parameter containing the opacity percentage (where 0% is completely transparent). If no opacity is specified, the current pen opacity will be used instead.
nPenStylePen (Enumeration)NoOptional parameter containing the desired line style. If no style is specified, the current pen style will be used instead.
nPenWidthNumberNoOptional 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.
bPenAntiAliasingState (Enumeration)NoOptional 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