Marblecore Imaging Library Documentation

Documentation Introduction
Documentation / Marblecore Imaging / Methods / DrawCurveBorder

DrawCurveBorder method

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

Syntax

Boolean DrawCurveBorder(strPoints As String, bClosed As Boolean, 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.
bClosedBooleanNoSpecifies if the cardinal spline is closed or open.
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.DrawCurveBorder("25,75; 75,25; 125,75");
6 
7 // Save the modified image to the specified file
8 MarblecoreImaging.SaveToFile("example-drawcurveborder.jpg");

Category

Drawing

See also

DrawArc | DrawArrow | DrawBackground | DrawBezier | DrawCheckerboard | DrawCurve | 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