dotted_line_array 0.0.6 icon indicating copy to clipboard operation
dotted_line_array: ^0.0.6 copied to clipboard

A Flutter library for drawing dotted line and arc with HTML5 Canvas API's array syntax

dotted_line_array #

This Flutter Canvas library allows you to draw dotted straight line and arc with the array syntax of html5 canvas.

Features #

Similar to this, this library lets you draw dotted line and arc with varying gaps and lengths using the HTML5 canvas's setLineDash() array syntax.

Getting started #

Import this package and follow the syntax provided below.

Usage #

setLineDash()

ParameterClass//typeDescription
canvasCanvasCanvas object
point1OffsetBeginning point
point2OffsetEnd point
paintPaintPaint object
lineDashListArray of numbers as specified by the HTML5 Canvas API's docs. Each number describes a length in pixels.

setArcDash()

ParameterClass//typeDescription
canvasCanvasCanvas object
xdoubleCenter of the arc X
ydoubleCenter of the arc Y
radiusXdoubleArc horizontal radius
radiusYdoubleArc vertical radius
paintPaintPaint object
startAngledoubleStarting angle in degrees
sweepAngledoubleClockwise sweep amount starting from startAngle, also in degrees
lineDashListArray of numbers as specified by the HTML5 Canvas API's docs. Each number describes a length in degrees.

Note: For the setArcDash, I find thinking about each of the dashes' length in degrees, rather than in pixels, more intuitive. This unfortunately makes working with both setArcDash and setLineDash together, like the UI in the screenshots below, for example, more difficult. So, I might change something in the future.

Syntax Comparisons #

Dart

//Negative signs are ignored; [2, -2] is the same as [2, 2].
const lineDash = [2, 20];

//straight line
setLineDash(canvas, point1, point2, paint, lineDash);

//Circle or ellipse
setArcDash(canvas, x, y, radiusX, radiusY, paint, startAngle, sweepAngle, lineDash);

JavaScript

ctx.setLineDash([2, 20]);

//Straight Line
ctx.lineTo(x1, y1, x2, y2);

//Circle
ctx.arc(x, y, radius, startAngle, endAngle, [, counterclockwise]);

//Circle or Ellipse
ctx.ellipse(x, y, radiusX, radiusY, rotation, startAngle, endAngle [, counterclockwise]);

ctx.stroke();

Result comparisons (Flutter: purple background, HTML5: white) #

Note: The Flutter example was captured on a smaller device.

[2, 20]

2,20 dart example

2,20 javascript example

[5, 10, 12]

5,10,12 dart example

5,10,12 javascript example

[1, 20, 0, 5, 2]

1,20,0,5,2 dart example

1,20,0,5,2 javascript example

[20, 3, 3, 3, 3, 3, 3, 3]

20,3,3,3,3,3,3,3 dart example

20,3,3,3,3,3,3,3 javascript example

Example Combining Straight Lines with Arcs #

With [5, 5] for lines and [7.8, 7.8] for arcs #

ui-example-with-equal-arrays-of-same-number

With [1.0, 2.0, 3.0, 4.0] for lines and [2.0, 4.0, 6.0, 8.0] for arcs #

ui-example-with-arrays-of-different-numbers

UI design by Natawan Meechai

UI src: https://github.com/Khongchai/yawwn/blob/main/lib/widgets/progress/dotted_line_path_points.dart

6
likes
120
pub points
22%
popularity

Publisher

verified publisher iconkhong.xyz

A Flutter library for drawing dotted line and arc with HTML5 Canvas API's array syntax

Repository (GitHub)

Documentation

API reference

License

Icon for licenses.MIT (LICENSE)

Dependencies

flutter

More

Packages that depend on dotted_line_array