TYPE: SOP
TITLE: Primitive SOP

The Primitive operation can make all primitives open or closed, reverse the
vertex order for all faces, set primitive colors and translate, rotate and
scale the primitives.

It can also operate on profiles (e.g. 0.5 1.2-3.9) and mixed primitives
(e.g. 0 0.5 4-12 1.2-3.9). It is possible to transform a spline surface and
its profiles at the same time. Profiles can be scaled only about X and Y, and
rotated about Z (within the domain of the surface they belong to).

Parameters:
    Source Group      - Primitive and/or profile group to operate on.
    Template Group    - A subset of template points to transform to.
Transform
    Do Transformation - Allows transformations to occur.
    Rotate to template - Rotates primitives to face template normals.
                        Match Normals rotates the primitive so its normal
                        matches the template normal.
    Transform Order   - Order in which transformations occur.
    Rotate Order      - Order in which rotations occur.
    Translate         - Moves primitives along xyz axes.	/tx /ty /tz
    Rotate            - Rotates primitives about xyz axes.	/rx /ry /rz
    Scale             - Non-uniform scaling along xyz axes.	/sx /sy /sz
    Pivot             - Local pivot point for transformations.	/px /py /pz
    Lookat Object     - Object to point at.
    Up-Vector         - Orientation along axes.	/upvectorx /upvectory /upvectorz
Attributes
    Overview	      - These attribute changes do apply to
			primitives, not to profiles.
    Color             - Diffuse color (RGB)	/diffr /diffg /diffb
    Alpha             - Transparency value	/alpha
    Crease            - Crease weight for polygonal subdivision	/crease
    Texture           - Create a string attribute for texture maps /texture
Face/Hull tab
    Preserve Shape U/V - If clamping or closing rounded, preserves shape.
    Close U/V          - Closes, opens, or unrolls primitive in U direction.
    Clamp U/V          - Clamps NURBS endpoints to original positions.
    Operation          - 
	Reverse     - Reverses U for faces, U & V for hulls
	Reverse U/V - Reverses U or V.
	Swap        - Interchanges U, V. Preserves topology.
	Shift       - Cycles vertices by U/V Offset.
    U Offset           - Amount to cycle vertices in U direction.	/vtxuoff
    V Offset           - Amount to cycle vertices in V direction.	/vtxvoff
Meta
    Overview	       - These options applie only to meta-surfaces.
    Meta-surface Weight - Allows meta-surface weighting.
    Weight             - Weight of meta-surface.

Local Variables
    PR                - Primitive or profile number.
    NPR               - Total number of primitives or profiles.
    PT                - Point number of first point in primitive.
    NVTX              - The number of vertices in the primitive.
    CEX, CEY, CEZ     - Centroid of the primitive or profile.
    DX, DY, DZ        - Direction from the centroid to the primitive centroid.
    NX, NY, NZ        - Normal of the primitive.
    CR, CG, CB, CA    - Diffuse primitive color & Alpha for primitive.
    CREASE            - Crease weight for each edge of primitive
    WEIGHT            - Weight of meta-primitive (0 for non-meta-primitive)

See also: Ends, Transform(xform), Point, Reverse, Vertex
