*solid_split_by_tool

Splits solid geometry using various tool types.

Syntax

*solid_split_by_tool solid_mark=<value> tool_type=<value> ?<option1>=<value1>? ?<option2>=<value2>? ... ?<optonN>=<valueN>?

Type

HyperMesh Tcl Modify Command

Description

Splits solid geometry using various tool types.

Inputs

extend_trimmer=<value>
Specifies the behavior of extending the trimming surface when tool_type=bounding_lines, tool_type=surfaces, or tool_type=sweep_lines. Valid values are:
0 – Do not extend
1 – Extend (default)
line_mark=<value>
The ID of the mark containing the input lines when tool_type=bounding_lines or tool_type=sweep_lines. Valid values are 1 and 2.
plane_base="<value1> <value2> <value3>"
The plane base coordinates when tool_type=plane.
plane_normal="<value1> <value2> <value3>"
The plane normal direction vector coordinates when tool_type=plane.
solid_mark=<value>
The ID of the mark containing the solids to split. Valid values are 1 and 2. This is mandatory.
split_positions="<value1x> <value1y> ?<value2x> <value2y>? ... ?<valueNx> <valueNy>?"
When tool_type=plane or when extend_trimmer=1, the trimmer might cut the solids at several sections. This optionally specifies the sections to use for trimming, by giving a point location on each section.
surf_mark=<value>
The ID of the mark containing the trimming surfaces when tool_type=surfaces. Valid values are 1 and 2.
sweep_direction="<value1> <value2> <value3>"
The sweep direction vector coordinates when tool_type=sweep_lines.
sweep_distance=<value>
The optional limited sweep distance when tool_type=sweep_lines.
tool_type=<value>
Specifies the tool used to split the solids. This is mandatory. Valid values are:
bounding_lines – Input lines are used to construct surfaces, which are used to split solids
plane – An infinite plane is used to split solids
surfaces – Surfaces are used for splitting
sweep_lines – Lines are swept in a direction, either to cover all the solids or for a given distance to form surfaces, which are then used to split solids

Examples

To split solid 2 with line 574, by sweeping the line in the z-direction and then extending the result surface to trim the whole solid:
*createmark solids 1 2
*createmark lines 2 574
*solid_split_by_tool solid_mark=1 tool_type=sweep_lines line_mark=2 "sweep_direction=0 0 1" extend_trimmer=1
To split solid 2 with a surface that is first formed by lines 32 and 37, and then extended to cover the whole solid:
*createmark solids 1 2
*createmark lines 2 32 37
*solid_split_by_tool solid_mark=1 tool_type=bounding_lines line_mark=2 extend_trimmer=1
To split solid 2 with a surface that is first formed by lines 32 and 37, at 2 sections that are located at points (0.4, -0.8, 0.0) and (0.5, -0.1, -0.7), and then extended to cover the whole solid:
*createmark solids 1 2
*createmark lines 2 32 37
*solid_split_by_tool solid_mark=1 tool_type=bounding_lines line_mark=2 extend_trimmer=1 "split_positions=0.4 -0.8 0.0 0.5 -0.01 -0.07"

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

2021