CoCreate OneSpace Designer - Commands Reference Manual

CAP_3D terminate action

CAP_3D creates a smooth freeform end ("cap") on an existing part.

Syntax


--->(CAP_3D)-------------+
                         |
    +----------<---------+----------------<----------------------------+
    |                                                                  |
    +--(:CAP-PART)--|specify part|-------------------------------------+--->
    |                                                                  |
    +--(:EDGES)--|edge(s)|--(:EDGE-SIDE)--+--(:ON)---+-----------------+
    |                                     |          |                 |
    +--(:EDGE-SIDE)--+--(:ON)---+--------------------------------------+
    |                |          |                                      |
    |                +--(:OFF)--+                                      |
    |                                                                  |
    |                                                                  |
    +--(:TANGENTS)--+--(:TO_FACES)--+                               +--+
    |               |               |                               |  |
    |               |    +----------+                               |  |
    |               |    |                                          |  |
    |               |    +--(:TAN-SMOOTH-ANGLE)--|angle|----+-------+  |
    |               |    |                                  |       |  |
    |               |    +--(:TAN-SMOOTH-WEIGHT)--|weight|--+       |  |
    |               |    |                                  |       |  |
    |               |    +--(:TAN-SMOOTH-ADJACENT)-+-(:ON)--+       |  |
    |               |                              |        |       |  |
    |               |                              +-(:OFF)-+       |  |
    |               |                                               |  |
    |               |           +----------------<---------------+  |  |
    |               |           |                                |  |  |
    |               |           +--(:TAN-USER-ALL)---------------+  |  |
    |               |           |                                |  |  |
    |               +--(:USER)--+--(:TAN-USER-DIR)--|direction|--+--+  |
    |               |           |                                |  |  |
    |               |           +--(:TAN-USER-WEIGHT)--|weight|--+  |  |
    |               |           |                                |  |  |
    |               |           +--(:TAN-USER-SINGLE)--|vertex|--+  |  |
    |               |                                               |  |
    |               +--(:NONE)--------------------------------------+  |
    |                                                                  |
    +--(:CAP-POINT)--|point|-------------------------------------------|
    |                                                                  |
    +--(:CAP-TAN-DIR)--|direction|-------------------------------------|
    |                                                                  |
    +--(:CAP-WEIGHT)--|weight|-----------------------------------------|
    |                                                                  |
    +--(:PREVIEW)------------------------------------------------------+
    |                                                                  |
    +--(:AUTO-WEIGHT)--+--(:ON)---+------------------------------------+
    |                  |          |                                    |
    |                  +--(:OFF)--+                                    |
    |                                                                  |
    +--(:CHECK_PART)---+--(:ON)---+------------------------------------+
                       |          |
                       +--(:OFF)--+

Options

The following options are available:

:CAP_PART - specifies the name of the part to be capped.
:EDGES - specifies the edges that define the "base" of the cap.
:EDGE-SIDE - determines which connecting faces of the existing part are to be deleted when the cap is created. Optionally, you can use :EDGE SIDE :OFF to create the cap on the other side of these "base" edges, thus deleting the connecting faces on the other side of the "base" edges. The :EDGE-SIDE option requires an :EDGES statement.
:TANGENTS - specifies the tangency conditions to be applied to the cap surface:
- :TO_FACES - specifies that the cap surface will meet its neighboring faces tangentially. The following subactions can be used:
  - :TAN-SMOOTH-ANGLE - specifies the angle at which the cap is connected to its neighboring faces.
  - :TAN-SMOOTH-WEIGHT - specifies the smoothness of the cap with respect to its neighboring faces.
  - :TAN-SMOOTH-ADJACENT - specifies a smooth cap connection to the adjacent face rather than to the side face.
- :USER - specifies that user-defined tangency conditions are applied:
  - :TAN-USER-ALL - specifies that user-defined tangency conditions apply to all vertex tangents.
  - :TAN-USER-DIRECTION - specifies the direction for all vertex tangents (if combined with :TAN-USER-ALL) or for a single vertex tangent (if combined with :TAN-USER-SINGLE).
  - :TAN-USER-WEIGHT - specifies the weight for all user-defined vertex tangents (if combined with :TAN-USER-ALL) or for a single user- defined vertex tangent (if combined with :TAN-USER-SINGLE).
  - :TAN-USER-SINGLE - specifies that user-defined tangency conditions apply to a single vertex only.
  The :TANGENTS option requires an :EDGES statement.
- :NONE - specifies that there are no tangency conditions for the cap.
:CAP-POINT - specifies the peak point of the cap. Depending on the "height" of this point, the cap will be convex or concave.
:CAP-TAN-DIR - specifies the tangency direction for the cap.
:CAP-WEIGHT - specifies the cap weight.
:PREVIEW - enables you to preview the result of the cap operation.
:AUTO-WEIGHT - optimizes both tangent weight and cap weight for maximum smoothness. This option overrides other weight statements in the command string.
:CHECK_PART - automatically checks part integrity during the cap operation.

When to use

Use this action to create a cap on an existing part.

Example

The following example caps a part named knob2. A vertical cap tangent is used.

CAP_3D :CAP-PART "/knob2" :EDGES :start (GPNTWC 23.530206 57.732984 3.350769 "vport1") :SELECT_DONE :CAP-POINT (GPNTWC 31.687509 87.433934 3.350769 "vport1") :CAP-TAN-DIR :v