AddSymbolsOnPath

New in version 5.0

AddSymbolsOnPath ( pathData ;​ pathStroke ;​ pathColor ;​ pathColorVariant ;​ symbolDistribution ;​ symbolType ;​ symbolSize ;​ symbolStroke ;​ symbolColor ;​ symbolColorVariant ;​ symbolBackgroundColor ;​ symbolBackgroundColorVariant ;​ shadowEffect ;​ shadowColor )

Argument Type Range Default Note
pathData num[] -inf..+inf (required)
pathStroke num[] 0..1000 1 Dimension:[pt]
pathColor rgba 0..255 black
pathColorVariant int -1..128 solid
symbolDistribution num[] 0..1000 1
symbolType int 0..126 bullet
symbolSize num 0..1000 9 Dimension:[pt]
symbolStroke num[] 0..1000 1 Dimension:[pt]
symbolColor rgba 0..255 black
symbolColorVariant int -1..128 solid
symbolBackgroundColor rgba 0..255 none
symbolBackgroundColorVariant int -1..128 solid
shadowEffect num[] -1000..1000 0
shadowColor rgba 0..255 #888a
Description

The argument symbolDistribution can have up to 4 values:
[1] Distribution unit [1..3]
1…Total path length (default).
2…Length between path vertices.
3…Length between path elements.
[2] Interval length, absolute in pixels or relative in percent of the distribution unit. Default: 25%
[3] Indent length, absolute in pixels or relative in percent of the distribution unit. Default: 0
[4] Orientation, constant in degrees or, if missing, the symbol is rotated automatically to match the direction of the path (default).


ADD_SYMBOLS_ON_PATH_01
1

OpenDrawing(200;​100)

2

AddSymbolsOnPath(M 20 90 L 20 40 A 40 20 20 20 0 0 1 L 180 20;​

3

1.5;​ /* Path stroke.  */

4

steelBlue;​ /* Path color.  */

5

0;​ /* Path color variant.  */

6

1 10% ;​ /* 11 symbols evenly distributed along path. */

7

barVertical;​ /* Symbol type.  */

8

11;​ /* Symbol size.  */

9

1.5;​ /* Symbol stroke.  */

10

steelBlue;​ /* Symbol color.  */

11

0;​ /* Symbol color variant.  */

12

none;​ /* Symbol background color.  */

13

0;​ /* Symbol background color variant.  */

14

2 2 2;​ /* Shadow effect.  */

15

lightGray) /* Shadow color.  */

16

CloseDrawing()

ADD_SYMBOLS_ON_PATH_01
ADD_SYMBOLS_ON_PATH_02
1

OpenDrawing(100;​100)

2

AddSymbolsOnPath(M 50 10 A 50 90 40 40 0 1 1 A 50 10 40 40 0 1 1;​

3

2.5 2.5 2.5;​ /* Path stroke.  */

4

lightGray;​ /* Path color.  */

5

0;​ /* Path color variant.  */

6

1 14.3%;​ /* 7 symbols evenly distributed along path. */

7

bullet;​ /* Symbol type.  */

8

6;​ /* Symbol size.  */

9

2;​ /* Symbol stroke.  */

10

steelBlue;​ /* Symbol color.  */

11

shaded) /* Symbol color variant.  */

12

CloseDrawing()

ADD_SYMBOLS_ON_PATH_02
ADD_SYMBOLS_ON_PATH_03
1

OpenDrawing(200;​100)

2

AddArrowExt(M 20 80 L 20 40 A 40 20 20 20 0 0 1 L 180 20;​

3

1.5;​ /* Stroke.  */

4

steelBlue;​ /* Color.  */

5

0;​ /* Color variant. */

6

-7;​ /* Head type.  */

7

25;​ /* Head size.  */

8

0;​ /* Head gap.  */

9

bullet;​ /* Tail type.  */

10

10;​ /* Tail size.  */

11

0;​ /* Tail gap.  */

12

2 2 2;​ /* Shadow effect. */

13

lightGray) /* Shadow color.  */

14

AddSymbolsOnPath(M 20 80 L 20 40 A 40 20 20 20 0 0 1 L 180 20;​

15

0;​none;​0;​ /* Hide path.  */

16

1 50% 15%;​ /* 2 symbols with 15% indent. */

17

triangleRightOutline;​ /* Symbol type.  */

18

12;​ /* Symbol size.  */

19

2;​ /* Symbol stroke.  */

20

steelBlue;​ /* Symbol color.  */

21

0;​ /* Symbol color variant.  */

22

white) /* Symbol background color.  */

23

CloseDrawing()

ADD_SYMBOLS_ON_PATH_03
ADD_SYMBOLS_ON_PATH_04
1

OpenDrawing(200;​100)

2

AddSymbolsOnPath(M 20 85 C 50 0 150 100 180 20;​

3

0.25;​ /* Path stroke.  */

4

steelBlue;​ /* Path color.  */

5

0;​ /* Path color variant.  */

6

1 10% 10.5%;​ /* Symbols evenly distributed along path. */

7

triangleUp;​ /* Symbol type.  */

8

9;​ /* Symbol size.  */

9

1;​ /* Symbol stroke.  */

10

steelBlue;​ /* Symbol color.  */

11

0;​ /* Symbol color variant.  */

12

white;​ /* Symbol background color.  */

13

0;​ /* Symbol background color variant.  */

14

2 2 2;​ /* Shadow effect.  */

15

lightGray) /* Shadow color.  */

16

AddSymbolsOnPath(M 20 85 C 50 0 150 100 180 20;​

17

0;​none;​0;​ /* Hide path.  */

18

1 100% ;​ /* Symbols on start and end of path. */

19

circle;​ /* Symbol type.  */

20

6;​ /* Symbol size.  */

21

1;​ /* Symbol stroke.  */

22

steelBlue;​ /* Symbol color.  */

23

0;​ /* Symbol color variant.  */

24

white) /* Symbol background color.  */

25

CloseDrawing()

ADD_SYMBOLS_ON_PATH_04
Scroll to Top