UNPKG

jointjs

Version:

JavaScript diagramming library

jointjs.com

clientIO/joint

44 lines (34 loc) • 3.17 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
<pre class="docs-method-signature"><code>V.normalizePathData(pathData)</code></pre> <p>Convert provided <a href="https://www.w3.org/TR/SVG/paths.html#PathData">SVG path data string</a> into a normalized path data string. The normalization uses a restricted subset of path commands; all segments are translated into lineto, curveto, moveto, and closepath segments. Relative path commands are changed into their absolute counterparts, and chaining of coordinates is disallowed.</p> <p>The function will always return a valid path data string; if an input string cannot be normalized, <code>'M 0 0'</code> is returned.</p> <p>Command translations:</p> <pre><code>V.normalizePathData('M 10 10 H 20') === 'M 10 10 L 20 10'; V.normalizePathData('M 10 10 V 20') === 'M 10 10 L 10 20'; V.normalizePathData('M 10 20 C 10 10 25 10 25 20 S 40 30 40 20') === 'M 10 20 C 10 10 25 10 25 20 C 25 30 40 30 40 20'; V.normalizePathData('M 20 20 Q 40 0 60 20') === 'M 20 20 C 33.33333333333333 6.666666666666666 46.666666666666664 6.666666666666666 60 20'; V.normalizePathData('M 20 20 Q 40 0 60 20 T 100 20') === 'M 20 20 C 33.33333333333333 6.666666666666666 46.666666666666664 6.666666666666666 60 20 C 73.33333333333333 33.33333333333333 86.66666666666666 33.33333333333333 100 20'; V.normalizePathData('M 30 15 A 15 15 0 0 0 15 30') === 'M 30 15 C 21.715728752538098 15.000000000000002 14.999999999999998 21.715728752538098 15 30';</code></pre> <p>Relative-to-absolute normalizations:</p> <pre><code>V.normalizePathData('m 10 10') === 'M 10 10'; V.normalizePathData('M 10 10 m 10 10') === 'M 10 10 M 20 20'; V.normalizePathData('M 10 10 l 10 10') === 'M 10 10 L 20 20'; V.normalizePathData('M 10 10 c 0 10 10 10 10 0') === 'M 10 10 C 10 20 20 20 20 10'; V.normalizePathData('M 10 10 z') === 'M 10 10 Z'</code></pre> <p>Transcription of chained coordinates:</p> <pre><code>V.normalizePathData('M 10 10 20 20') === 'M 10 10 L 20 20'; V.normalizePathData('M 10 10 L 20 20 30 30') === 'M 10 10 L 20 20 L 30 30'; V.normalizePathData('M 10 10 C 10 20 20 20 20 10 20 0 30 0 30 10') === 'M 10 10 C 10 20 20 20 20 10 C 20 0 30 0 30 10';</code></pre> <p>Edge cases:</p> <pre><code>V.normalizePathData('L 10 10') === 'M 0 0 L 10 10'; V.normalizePathData('C 0 10 10 10 10 0') === 'M 0 0 C 0 10 10 10 10 0'; V.normalizePathData('Z') === 'M 0 0 Z'; V.normalizePathData('M 10 10 Z L 20 20') === 'M 10 10 Z L 20 20'; V.normalizePathData('M 10 10 Z C 10 20 20 20 20 10') === 'M 10 10 Z C 10 20 20 20 20 10'; V.normalizePathData('M 10 10 Z Z') === 'M 10 10 Z Z'; V.normalizePathData('') === 'M 0 0'; // empty string V.normalizePathData('X') === 'M 0 0'; // invalid command V.normalizePathData('M') === 'M 0 0'; // no arguments for a command that needs them V.normalizePathData('M 10') === 'M 0 0'; // too few arguments V.normalizePathData('M 10 10 20') === 'M 10 10'; // too many arguments V.normalizePathData('X M 10 10') === 'M 10 10'; // mixing invalid and valid commands V.normalizePathData('X M 10 10 X L 20 20') === 'M 10 10 L 20 20'; // invalid commands interspersed with valid commands</code></pre>