Skip to main content

Class: DrawingPen

Hierarchy​

Implements​

Constructors​

constructor​

• new DrawingPen(origin?)

Parameters​

NameType
originPoint2D

Overrides​

BaseSketcher2d.constructor

Defined in​

draw.ts:107

Methods​

bezierCurveTo​

▸ bezierCurveTo(end, controlPoints): DrawingPen

Draws a generic bezier curve to the end point, going using a set of control points.

This is the generic definition of a bézier curve, you might want to use either the quadratic or cubic (most common) version, unless you know exactly what you are aiming at.

Parameters​

NameType
endPoint2D
controlPointsPoint2D | Point2D[]

Returns​

DrawingPen

Implementation of​

GenericSketcher.bezierCurveTo

Inherited from​

BaseSketcher2d.bezierCurveTo

Defined in​

Sketcher2d.ts:335


close​

▸ close(): Drawing

Stop drawing, make sure the sketch is closed (by adding a straight line to from the last point to the first) and returns the sketch.

Returns​

Drawing

Implementation of​

GenericSketcher.close

Defined in​

draw.ts:119


closeWithMirror​

▸ closeWithMirror(): Drawing

Stop drawing, make sure the sketch is closed (by mirroring the lines between the first and last points drawn) and returns the sketch.

Returns​

Drawing

Implementation of​

GenericSketcher.closeWithMirror

Defined in​

draw.ts:124


cubicBezierCurveTo​

▸ cubicBezierCurveTo(end, startControlPoint, endControlPoint): DrawingPen

Draws a cubic bezier curve to the end point, using the start and end control point to define its shape. This corresponds to the most commonly used bezier curve.

If you are struggling setting your control points, the smoothSpline might be better for your needs.

Parameters​

NameType
endPoint2D
startControlPointPoint2D
endControlPointPoint2D

Returns​

DrawingPen

Implementation of​

GenericSketcher.cubicBezierCurveTo

Inherited from​

BaseSketcher2d.cubicBezierCurveTo

Defined in​

Sketcher2d.ts:359


done​

▸ done(): Drawing

Stop drawing and returns the sketch.

Returns​

Drawing

Implementation of​

GenericSketcher.done

Defined in​

draw.ts:115


ellipse​

▸ ellipse(xDist, yDist, horizontalRadius, verticalRadius, rotation?, longAxis?, sweep?): DrawingPen

Draws an arc of ellipse by defining its end point and an ellipse. The end point is defined by distances from he start point.

The shape of the ellipse is defined by both its radiuses, its angle relative to the current coordinat system, as well as the long and sweep flags (as defined for SVG paths)

Parameters​

NameTypeDefault value
xDistnumberundefined
yDistnumberundefined
horizontalRadiusnumberundefined
verticalRadiusnumberundefined
rotationnumber0
longAxisbooleanfalse
sweepbooleanfalse

Returns​

DrawingPen

Implementation of​

GenericSketcher.ellipse

Inherited from​

BaseSketcher2d.ellipse

Defined in​

Sketcher2d.ts:291


ellipseTo​

▸ ellipseTo(end, horizontalRadius, verticalRadius, rotation?, longAxis?, sweep?): DrawingPen

Draws an arc of ellipse by defining its end point and an ellipse.

The shape of the ellipse is defined by both its radiuses, its angle relative to the current coordinat system, as well as the long and sweep flags (as defined for SVG paths)

Parameters​

NameTypeDefault value
endPoint2Dundefined
horizontalRadiusnumberundefined
verticalRadiusnumberundefined
rotationnumber0
longAxisbooleanfalse
sweepbooleanfalse

Returns​

DrawingPen

Implementation of​

GenericSketcher.ellipseTo

Inherited from​

BaseSketcher2d.ellipseTo

Defined in​

Sketcher2d.ts:223


hLine​

▸ hLine(distance): DrawingPen

Draws an horizontal line of length distance from the current point

Parameters​

NameType
distancenumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.hLine

Inherited from​

BaseSketcher2d.hLine

Defined in​

Sketcher2d.ts:93


hLineTo​

▸ hLineTo(xPos): DrawingPen

Draws an horizontal line to the x coordinate

Parameters​

NameType
xPosnumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.hLineTo

Inherited from​

BaseSketcher2d.hLineTo

Defined in​

Sketcher2d.ts:101


hSagittaArc​

▸ hSagittaArc(distance, sagitta): DrawingPen

Draws an horizontal arc of circle by defining its end point and the sagitta - the maximum distance between the arc and the straight line going from start to end point.The end point is defined by its horizontal distance from the start point.

Parameters​

NameType
distancenumber
sagittanumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.hSagittaArc

Inherited from​

BaseSketcher2d.hSagittaArc

Defined in​

Sketcher2d.ts:194


halfEllipse​

▸ halfEllipse(xDist, yDist, minorRadius, sweep?): DrawingPen

Draws an arc as half an ellipse, defined by the sagitta of the ellipse (which corresponds to the radius in the axe orthogonal to the straight line).The end point is defined by distances from he start point.

The sweep flag is to be understood as defined for SVG paths.

Parameters​

NameTypeDefault value
xDistnumberundefined
yDistnumberundefined
minorRadiusnumberundefined
sweepbooleanfalse

Returns​

DrawingPen

Implementation of​

GenericSketcher.halfEllipse

Inherited from​

BaseSketcher2d.halfEllipse

Defined in​

Sketcher2d.ts:325


halfEllipseTo​

▸ halfEllipseTo(end, minorRadius, sweep?): DrawingPen

Draws an arc as half an ellipse, defined by the sagitta of the ellipse (which corresponds to the radius in the axe orthogonal to the straight line).

The sweep flag is to be understood as defined for SVG paths.

Parameters​

NameTypeDefault value
endPoint2Dundefined
minorRadiusnumberundefined
sweepbooleanfalse

Returns​

DrawingPen

Implementation of​

GenericSketcher.halfEllipseTo

Inherited from​

BaseSketcher2d.halfEllipseTo

Defined in​

Sketcher2d.ts:311


line​

▸ line(xDist, yDist): DrawingPen

Draws a line at the horizontal distance xDist and the vertical distance yDist of the current point

Parameters​

NameType
xDistnumber
yDistnumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.line

Inherited from​

BaseSketcher2d.line

Defined in​

Sketcher2d.ts:85


lineTo​

▸ lineTo(point): DrawingPen

Draws a line from the current point to the point given in argument

Parameters​

NameType
pointPoint2D

Returns​

DrawingPen

Implementation of​

GenericSketcher.lineTo

Inherited from​

BaseSketcher2d.lineTo

Defined in​

Sketcher2d.ts:75


movePointerTo​

▸ movePointerTo(point): DrawingPen

Changes the point to start your drawing from

Parameters​

NameType
pointPoint2D

Returns​

DrawingPen

Implementation of​

GenericSketcher.movePointerTo

Inherited from​

BaseSketcher2d.movePointerTo

Defined in​

Sketcher2d.ts:64


polarLine​

▸ polarLine(distance, angle): DrawingPen

Draws a line from the current point to the point defined in polar coordiates, of radius r and angle theta (in degrees) from the current point

Parameters​

NameType
distancenumber
anglenumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.polarLine

Inherited from​

BaseSketcher2d.polarLine

Defined in​

Sketcher2d.ts:111


polarLineTo​

▸ polarLineTo(__namedParameters): DrawingPen

Draws a line from the current point to the point defined in polar coordiates, of radius r and angle theta (in degrees) from the origin

Parameters​

NameType
__namedParametersPoint2D

Returns​

DrawingPen

Implementation of​

GenericSketcher.polarLineTo

Inherited from​

BaseSketcher2d.polarLineTo

Defined in​

Sketcher2d.ts:105


quadraticBezierCurveTo​

▸ quadraticBezierCurveTo(end, controlPoint): DrawingPen

Draws a quadratic bezier curve to the end point, using the single control point.

Parameters​

NameType
endPoint2D
controlPointPoint2D

Returns​

DrawingPen

Implementation of​

GenericSketcher.quadraticBezierCurveTo

Inherited from​

BaseSketcher2d.quadraticBezierCurveTo

Defined in​

Sketcher2d.ts:355


sagittaArc​

▸ sagittaArc(xDist, yDist, sagitta): DrawingPen

Draws an arc of circle by defining its end point and the sagitta - the maximum distance between the arc and the straight line going from start to end point.The end point is defined by its horizontal and vertical distances from the start point.

Parameters​

NameType
xDistnumber
yDistnumber
sagittanumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.sagittaArc

Inherited from​

BaseSketcher2d.sagittaArc

Defined in​

Sketcher2d.ts:183


sagittaArcTo​

▸ sagittaArcTo(end, sagitta): DrawingPen

Draws an arc of circle by defining its end point and the sagitta - the maximum distance between the arc and the straight line going from start to end point.

Parameters​

NameType
endPoint2D
sagittanumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.sagittaArcTo

Inherited from​

BaseSketcher2d.sagittaArcTo

Defined in​

Sketcher2d.ts:156


smoothSpline​

▸ smoothSpline(xDist, yDist, splineConfig?): DrawingPen

Draws a cubic bezier curve to the end point, attempting to make the line smooth with the previous segment. The end point is defined by its distance to the first point.

It will base its first control point so that its tangent is the same than the previous segment. You can force another tangent by defining startTangent.

You can configure the tangent of the end point by configuring the endTangent, either as "symmetric" to reproduce the start angle, as an angle from the X axis (in the coordinate system) or a 2d direction (still in the coordinate system.

The start- and end- factors decide on how far the control point is from the start and end point. At a factor of 1, the distance corresponds to a quarter of the straight line distance.

Parameters​

NameType
xDistnumber
yDistnumber
splineConfig?SplineConfig

Returns​

DrawingPen

Implementation of​

GenericSketcher.smoothSpline

Inherited from​

BaseSketcher2d.smoothSpline

Defined in​

Sketcher2d.ts:408


smoothSplineTo​

▸ smoothSplineTo(end, config?): DrawingPen

Draws a cubic bezier curve to the end point, attempting to make the line smooth with the previous segment.

It will base its first control point so that its tangent is the same than the previous segment.

The control point relative to the end is by default set to be in the direction of the straight line between start and end. You can specifiy the endSkew either as an angle (in degrees) to this direction, or as an absolute direction in the coordinate system (a Point).

The start- and end- factors decide on how far the control point is from the start and end point. At a factor of 1, the distance corresponds to a quarter of the straight line distance.

Parameters​

NameType
endPoint2D
config?SplineConfig

Returns​

DrawingPen

Implementation of​

GenericSketcher.smoothSplineTo

Inherited from​

BaseSketcher2d.smoothSplineTo

Defined in​

Sketcher2d.ts:367


tangentArc​

▸ tangentArc(xDist, yDist): DrawingPen

Draws an arc of circle from the current point as a tangent to the previous part of curve drawn.The end point is defined by its horizontal and vertical distances from the start point.

Parameters​

NameType
xDistnumber
yDistnumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.tangentArc

Inherited from​

BaseSketcher2d.tangentArc

Defined in​

Sketcher2d.ts:218


tangentArcTo​

▸ tangentArcTo(end): DrawingPen

Draws an arc of circle from the current point as a tangent to the previous part of curve drawn.

Parameters​

NameType
endPoint2D

Returns​

DrawingPen

Implementation of​

GenericSketcher.tangentArcTo

Inherited from​

BaseSketcher2d.tangentArcTo

Defined in​

Sketcher2d.ts:198


tangentLine​

▸ tangentLine(distance): DrawingPen

Draws a line from the current point as a tangent to the previous part of curve drawn. The distance defines how long the line will be.

Parameters​

NameType
distancenumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.tangentLine

Inherited from​

BaseSketcher2d.tangentLine

Defined in​

Sketcher2d.ts:117


threePointsArc​

▸ threePointsArc(xDist, yDist, viaXDist, viaYDist): DrawingPen

Draws an arc of circle by defining its end point and a third point through which the arc will pass. Both poinats are defined in horizontal (x) and vertical (y) distances from the start point.

Parameters​

NameType
xDistnumber
yDistnumber
viaXDistnumber
viaYDistnumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.threePointsArc

Inherited from​

BaseSketcher2d.threePointsArc

Defined in​

Sketcher2d.ts:143


threePointsArcTo​

▸ threePointsArcTo(end, midPoint): DrawingPen

Draws an arc of circle by defining its end point and a third point through which the arc will pass.

Parameters​

NameType
endPoint2D
midPointPoint2D

Returns​

DrawingPen

Implementation of​

GenericSketcher.threePointsArcTo

Inherited from​

BaseSketcher2d.threePointsArcTo

Defined in​

Sketcher2d.ts:131


vLine​

▸ vLine(distance): DrawingPen

Draws a vertical line of length distance from the current point

Parameters​

NameType
distancenumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.vLine

Inherited from​

BaseSketcher2d.vLine

Defined in​

Sketcher2d.ts:89


vLineTo​

▸ vLineTo(yPos): DrawingPen

Draws a vertical line to the y coordinate

Parameters​

NameType
yPosnumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.vLineTo

Inherited from​

BaseSketcher2d.vLineTo

Defined in​

Sketcher2d.ts:97


vSagittaArc​

▸ vSagittaArc(distance, sagitta): DrawingPen

Draws a vertical arc of circle by defining its end point and the sagitta

  • the maximum distance between the arc and the straight line going from start to end point.The end point is defined by its vertical distance from the start point.

Parameters​

NameType
distancenumber
sagittanumber

Returns​

DrawingPen

Implementation of​

GenericSketcher.vSagittaArc

Inherited from​

BaseSketcher2d.vSagittaArc

Defined in​

Sketcher2d.ts:190