*body_split_with_swept_lines

Splits surfaces or solids using swept lines.

Syntax

*body_split_with_swept_lines entity_type mark_id line_mark_id vector_id back_dist options

Type

HyperMesh Tcl Modify Command

Description

Input lines are used to construct cutting surfaces, which are then used to trim selected solids or surfaces.

Inputs

entity_type
The type of entities to split. Valid values are solids or surfaces.
entity_mark
The ID of the mark containing the entities to split. Valid values are 1 and 2.
line_mark_id
The ID of the mark containing the lines from which to to generate the swept surface used for splitting. Valid values are 1 and 2.
vector_id
using the *createvector command. This must be set to 1.
In the case where a limited sweep is specified (see options), the length of the vector defines the position of the back edge of the swept surface relative to the position of the corresponding input line. A positive value results in shifting the position of the back edge in the direction of the input vector.
back_dist
In the case where a limited sweep is specified (see options), this defines the position of the front edge of the cutting surface with respect to the position of corresponding input line. For a value of 0 the front edge coincides with input line. A positive value results in shifting the position of the front edge in the direction of the input vector.
options
The options to use for trimming the selected entities. Bit values are used and the value is calculated as (Bit0 + 2*Bit1 + 4*Bit2).
Bit0
0 - Limited sweep. The swept surfaces are created and used as defined by vector length and back_dist.
1 - Unlimited sweep. Cutting surfaces are extended in sweep direction to trim as many input surfaces as possible.
Bit1
0 - Limited lines. Original input lines are used to generate swept surfaces.
1 - Extended lines. Input lines are extended before sweeping them to generate cutting surfaces.
Bit2
0 - Cutting surfaces become part of the model.
1 - Cutting surfaces are temporary and are only used to generate trimming lines on intersected surfaces.

Examples

To trim solid 111 by sweeping lines 5 and 6 in the z-direction and extending the cutting surfaces in all directions:
*createmark solids 1 111
*createmark lines 1 5 6
*createvector 1 0 0 1
*body_trim_with_swept_lines solids 1 1 1 0 3

Errors

Incorrect usage results in a Tcl error. To detect errors, you can use the catch command:
if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

13.0