Name
StartPath -- begin a new path (V5.0)
Synopsis
[id] = StartPath(id)
Function
This command can be used to create a new path object that will be made available under the identifier id. Alternatively, you can pass Nil as id. In that case, StartPath() will automatically select an identifier and return it to you.

Once the new path is created, you should first define a current point for the path by calling the MoveTo() command. After that, you can start adding vertices to the path.

A vector path is a root object for an infinite number of sub-paths. You can think of a vector path as a collection of an infinite number of separate polygons. Each sub-path within a vector path can be regarded as a separate polygon. Keep in mind, though, that when you draw a vector path using DrawPath() you can only specify a global color that will be used by all sub-paths within the vector path. Thus, it is not possible to use different colors within a single path object. If you need to use another color, you need to create a new path object first.

Inputs
id
identifier for the new path or Nil for auto id selection
Results
id
optional: identifier of the new path; this will only be returned when you pass Nil as argument 1 (see above)
Example
See DrawPath


Show TOC