fix build process for extension modules
[PyX.git] / examples / path / split.txt
blobff248ab81f0ee85bec6b9f66f981e82d52b0ea51
1 Splitting paths
3 In this example we use the `split` method of a path to split it into several
4 paths. Similar to the `at` method you can pass a list of numbers to the split
5 method (or PyX length instances) to specify the splitting point by the arc
6 length ... or you can use parametrization instances like the one returned by
7 the `end` method, where you can substract a length to conventiently express a
8 certain location measured from the end of the path.
10 For a single splitting point, you can also pass the parameter directly instead
11 of warpping this single value into a list. Note, however, that the return value
12 of the `split` method is always a list; splitting a non-closed path at one
13 point still yields two segments.
15 ! When splitting at the beginning or the end of the path, one segment may
16 be empty. Still PyX returns a corresponding path of length 0.
18 ! When splitting at non-closed subpaths the result of the split method
19 will be a list containing one path more than the number of splitting
20 points. However, for a closed subpath a splitting at a single point
21 will open the subpath but return a single path only. Consider a circle
22 which you split at a single value: The result will still be a circle,
23 but the path will not be closed anymore.