CoCreate OneSpace Designer - Commands Reference Manual

CHECK_PART terminate action

CHECK_PART checks the consistency of a selected part or multiple parts.

Syntax


--->(CHECK_PART)---+-(:OBJECTS)---|part or parts|-----------------------+------>
                   |                                                    |
                   +---------------<------------------------------------+
                   |                                                    |
                   +-(:MINIMAL_CHECK)-----------------------------------+
                   |                                                    |
                   +-(:MAXIMAL_CHECK)-----------------------------------+
                   |                                                    |
                   |                                                    |
                   +--(:LABELS)-------+--(:ON)---+----------------------+
                   |                  |          |                      |
                   |                  +--(:OFF)--+                      |
                   |                                                    |
                   +--(:KEEP_LABELS)--+--(:ON)---+----------------------+
                   |                  |          |                      |
                   |                  +--(:OFF)--+                      |
                   |                                                    |
                   +--(:WARNINGS)-----+--(:ON)---+----------------------+
                   |                  |          |                      |
                   |                  +--(:OFF)--+                      |
                   |                                                    |
                   +-+-(:VERBOSE)-(:ON)-+-----------------------------+-+
                   | |                  |                             | |
                   | |                  +-(:MINIMAL_EDGE)-|edge len|--+ |
                   | |                  |                             | |
                   | |                  +-(:VOIDS)-------+--(:ON)--+--+ |
                   | |                  |                |         |  | |
                   | |                  |                +--(:OFF)-+  | |
                   | |                  |                             | |
                   | |                  +-(:KNIFE_EDGES)-+--(:ON)--+--+ |
                   | |                                   |         |  | |
                   | |                                   +--(:OFF)-+  | |
                   | |                                                | |
                   | |                                                | |
                   | +-(:VERBOSE)-(:OFF)------------------------------+ |
                   |                                                    |
                   |                                                    |
                   +--(:NO_DISPLAY_BOX)--+--(:ON)---+-------------------+
                   |                     |          |                   |
                   +---------------------+--(:OFF)--+-------------------+

Options

The following options are available to check a part or parts:

:MINIMAL_CHECK -> no face-face intersection (part selfintersection) check and no 'change of convexity' test along edges
:MAXIMAL_CHECK -> minimal check + face-face intersection (part selfintersection) check + 'change of convexity' test along edges
:LABELS - specifies whether or not to generate temporary labels to display error locations. (not allowed for non-modifiable parts)
:KEEP_LABELS - specifies whether or not to generate permanent labels (if labels is active).
:VERBOSE - activates/deactivates verbose mode for messages in the output box.
:WARNINGS - toggle the display of warning messages by the part checker. It is possible to set :WARNINGS to :ON only when either :LABELS or :VERBOSE are set to :ON.
:NO_DISPLAY_BOX - this suppresses output to the display box which is shown even if 'verbose' is disabled; especially the messages which inform the user about the check result; this is useful if the checker is used programmatically
:MINIMAL_EDGE - (model advisor warning) edges shorter than the specified distance are detected; this is a variable of type lenght (dependend on selected UNIT) - accepted are values between 0.1mm and 0.000001mm
:KNIFE_EDGES - (model advisor warning) 'knife edges' will be found
:VOIDS - (model advisor warning) check for 'void shells' (air bubbles in the model)

Notes

to specify model advisor settings (which are local to this dialog) you need to activate verbose mode first
'labels' do not work with non-modifiable parts
automatic repair is not possible for non-modifable parts

When to use

Use this action to check the consistency of a specified part or parts. A part might be inconsistent due to use of the local operations.

Evaluation of the result

If a part is found to be inconsistent, messages are displayed in the output box identifying the faults.

The check action helps you to identify whether a part may be corrupt (for advanced users):

*Set-Action-Result* for CHECK_PART:

Check_Part will return T or Nil for a list of parts and for a single part an assoc list containing optionaly the localized messages.

All "err-code-??" are non localized unique identifiers.

  ([("Error:"   ("err-code-e1" ("msg-e1" entity-e11 .. entity-e1m) ... "err-code-en" ("msg-en" entity-en1 .. entity-enm)))]
   [("Warning:" ("err-code-w1" ("msg-w1" entity-w11 .. entity-w1m) ... "err-code-wn" ("msg-wn" entity-wn1 .. entity-wnm)))]
   [("Fixed:"   ("err-code-f1" ("msg-f1" entity-f11 .. entity-f1m) ... "err-code-fn" ("msg-fn" entity-fn1 .. entity-fnm)))]
   [("Info:"    ("err-code-i1" ("msg-i1" entity-i11 .. entity-i1m) ... "err-code-in" ("msg-in" entity-in1 .. entity-inm)))])


The result can be evaluated by (assuming that 'res-list' is the assoc list shown above):

  (when
    (setf warnings (assoc "Warning:" res-list :test #`equal)) => ("Warning:"((.....)))
    (when warnings
       (setf knifes (assoc "CHECK_KNIFE_EDGE" warnings :test #`equal)) => (CHECK_KNIFE_EDGE ("..." ...))
    )
  )


A correct call of the body checker would look like:

  (oli::sd-call-cmds (k2-ui::check_part :objects TEST-PART
                                        :maximal_check
                                        :verbose :on
                     )
                     :success 
                            (progn
                               (display *sd-action-result*)
                               (display "Success")
                            )
                     :failure 
                            (progn
                               (when (sd-inq-error-obj :object)
                                 (display (sd-inq-error-obj :message))
                               )
                               (display "Failure")
                            )
  )

Note: This makes the following command obsolete:

BODY_CHECK

SET_BODY_CHECK_MESSAGE_LEVEL :USER    (non-verbose mode)
                             :SYSTEM  (verbose mode)

Example

The following parameter sequence checks the specified part.

CHECK_PART :objects "p1"