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 |
| | 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 |
| | 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 |
| | 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 |
