TYPE: SOP
TITLE: PolyWire SOP

PolyWire constructs a polygonal wire around a polygonal backbone.  The
four numerical parameters support all the local variables of the Point
operation, plus the LSYSTEM specific variables of $WIDTH, $SEGS, $DIV, $LAGE,
$GEN, and $ARC.

To use this with an LSystem SOP, you can choose the "For LSystems"
preset.

Parameters:
    Group          - The group of polygons to convert to wires.
    Wire Radius    - This is the radius of the wire to sweep over the
                     polygon.                                         /radius
    Maximum Joint Scale - Prevent Joint Buckling scales up the
                     intersection points so that they lie on the
                     intersection of two tubes, rather than a width
                     sized sphere.  This can cause the points to be
                     scaled past the first segment of the tube,
                     however, causing buckling.  This parameter allows
                     you to change on a point level what the maximum
                     scale applied to the points is.                /maxscale
    Smooth Point   - This is an integer value.  If true for a point,
                     the wire will intersect at that point with smooth
                     manifold topology.  If zero, it is just capped.  /smooth
    Divisions      - This is the number of divisions in the circle
		     which is to be swept over the polygon.  It can
                     vary on a point basis.                              /div
    Segments       - The number of segments to divide each edge of the
                     polygon into.  It can vary on a point basis.       /segs
    Segment Scales - These are how far into the segment to make the first
                     circle and how far towards the end to keep going.
                     Both values are in the range 0-1, where 0 is the start
                     and 1 the end.  These are segment specific values.
		     The local var $NSEG is available here for the number 
		     of segments in the previous parameter.         /segscale
    Prevent Joint Buckling - This toggle when set will scale the
                     intersection point of edges to avoid a collapse
                     when sharp turns are made.
    Do Vertex Textures - Toggles whether vertex textures are generated
                     for the geometry.  For best texturing of branch
                     points, the points of the wire should be ordered
                     so the "important" side has least point number.
                     For example, in a Y branch, the bottom of the Y
                     should have the smallest point numbers.
    U Seam Offset  - A per segment parameter which cycles how far around
                     the tube the seam is placed.  The seam is always 
                     snapped to the nearest polygon edge.               /uoff
    U Textures     - Per segment values for the starting/ending values of
                     the u texture.                                    /textu
    V Textures     - The same, but for v textures.                     /textv
    Joint Up Vector - If enabled, the up vector at each joint is set to
                     the specified value.  This will result in twisting 
                     of the branches.                               /upvector

Local Variables
    PTDIST	   - When resolving a segment, this is the distance
		     between the end points of the segment.
    NSEG	   - This is the number of segments which the segments
		     parameter evaluated to for this segment.


See Also: Wire, LSystem
