CoCreate OneSpace Designer - Commands Reference Manual

SET_CATCH_PARAMETERS interrupt action

SET_CATCH_PARAMETERS catches 2D and 3D coordinates coincident with nearby elements of a specified type, if the element type is active, and the element is visible.

Syntax


---->(SET_CATCH_PARAMETERS)--+--(:NEXT_CATCH)--------------+---->
                             |                             |
                             +--(:DEFAULT_2D)--------------+
                             |                             |
                             +--(:DEFAULT_3D)--------------+
                             |                             |
                             +--(:WP)--+--(:ON)---+--------+
                             |         |          |        |
                             |         +--(:OFF)--+        |
                             |                             |
                             +--(:WP_CURRENT)--------------+
                             |                             |
                             +--(:WP_ALL)------------------+
                             |                             |
                             +--(:PART)--+--(:ON)---+------+
                             |           |          |      |
                             |           +--(:OFF)--+      |
                             |                             |
                             +--(:ALL)---------------------+
                             |                             |
                             +--(:VERTEX)------------------+
                             |                             |
                             +--(:INTERSECTION)------------+
                             |                             |
                             +--(:GRID)--------------------+
                             |                             |
                             +--(:EDGE)--------------------+
                             |                             |
                             +--(:FACE)--------------------+
                             |                             |
                             +--(:WORKPLANE)---------------+
                             |                             |
                             +--(:CENTER)------------------+
                             |                             |
                             +--(:PROJECT)-----------------+
                             |                             |
                             +--(:NO_PROJECT)--------------+
                             |                             |
                             +--(:CURSOR_RANGE)--|pixels|--+

Options

The following options are available to define your catch element(s).

:NEXT_CATCH - catch parameters will be reset to the default values immediately after the next catch.
:DEFAULT_2D - modify default settings for catching in 2D.
:DEFAULT_3D - modify default settings for catching in 3D.

CATCH has no effect on the operation of the SELECT mechanism.

The :ALL option within 2D includes, in order of priority:

:VERTEX
:INTERSECTION
:GRID
:EDGE
:CURRENT_WP

The :ALL option within 3D includes, in order of priority:

:VERTEX
:EDGE
:FACE
:CURRENT_WP

The :ALL option includes, in order of priority:

:VERTEX (2D)
:INTERSECTION (2D)
:GRID (2D)
:EDGE (2D)
:VERTEX (3D)
:EDGE (3D)
:FACE (3D)
:CURRENT_WP

When to use

Use this action to focus on specific types of geometry for selection.

The grid will only be displayed, and caught to, when the grid points or lines are not too close together, in terms of pixels. This means that there will be occasions where you expect to see the grid, but will not. For example:

If too small a grid spacing is specified.
If you display the grid, and then zoom away from the workplane, causing the pixel grid spacing to become too small.
If you display the grid, and then rotate the view or the workplane causing the pixel grid spacing to become too small.

Example

The following parameter sequence specifies catching to 2D centers.

SET_CATCH_PARAMETERS :DEFAULT_2D :CENTER