examples/path/split.txt

   1 Splitting paths
   2
   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.
   9
  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.
  14
  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.
  17
  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.