*untrim_selected_edges

Untrims selected surface free edges.

Syntax

*untrim_selected_edges mark_id_lines mark_id_surfs untrim_option keep_vertices reserved1 reserved2

Type

HyperMesh Tcl Modify Command

Description

This command modifies surfaces by removing user-selected free edges and replacing each chain of edges with a new edge that is determined as follows:
  • In case of "shortcut" option, the new straight edge joins the end-points of selected edge chain.
  • In case of "extend" option, the command attempts to finds the intersection of two rays along tangents at the edge chain end-points. If such an intersection point exists, the new straight edges join the end-points of original edge chains with this intersection point.

The input can include free edges on several surfaces simultaneously, and can include both internal and external free edges. The command ignores all non-free edges of the selection.

If all edges of an internal or external loop are selected, the command removes the entire loop. In these special cases, the command extends the functionalities of *edgesmarkuntrim and *surfacemarkuntrim.

Inputs

mark_id_lines
The ID of the mark containing the free edges to untrim. Valid values are 1 and 2.
mark_id_surfs
Reserved for future use.
untrim_option
Specifies how the new edges be constructed:
0 - Use the shortcut option.
1 - Use the extend option.
keep_vertices
0 - Vertices at the ends of the selected edge chains might be removed if necessary (based on the value of the user-specified "geom. feature angle").
1 - Vertices at the ends of the selected edge chains are preserved.
reserved1
Reserved for future use. Must be set to 0.
reserved2
Reserved for future use. Must be set to 0.

Example

To untrim the red edges with ID 36800-36802 via shortcut option and to preserve the vertices at the ends of the selected edge chains:

*createmark lines 2 36800 36801 36802
*createmark surfaces 2
*untrim_selected_edges 2 2 0 1 0 0

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

12.0