*connect_surfaces_11

Extends surfaces to meet other surfaces.

Syntax

*connect_surfaces_11 source_mark_id target_mark_id extend_mode trim_mode distance min_angle_to_target_surf max_angle_edge_to_surf lines_to_extend_over guide_mode ignore_guide_edges guide_angle advanced_options reserved

Type

HyperMesh Tcl Modify

Description

Extends surfaces to meet other surfaces.

Inputs

source_mark_id
The ID of the mark containing the surfaces to extend. Valid values are 1 and 2.
target_mark_id
The ID of the mark containing the surfaces to target (destination surfaces). Valid values are 1 and 2.
extend_mode
The mode for extending the surfaces. Valid values are:
  • 1 - By distance.
  • 2 - By thickness ratio.
  • 3 - Over edges to target surface.
  • 4 - Over edges by distance.
trim_mode
The mode for trimming the surfaces. Valid values are:
  • 0 - Do not trim the result.
  • 1 - Trim the result.
distance
The extend distance, if extend_mode = 1.
Thickness ratio, if extend_mode = 2.
min_angle_to_target_surf
The minimum angle between surfaces that will be considered for extension.
max_angle_edge_to_surf
The maximum angle between an edge and a surface that will be considered for extension.
lines_to_extend_over
The ID of the mark containing the edges over which the extension can occur. Valid values are 1 and 2.
guide_mode
The mode for using guide edges. Valid values are:
  • 0 - Do not use guide edges.
  • 1 - Use guide edges.
ignore_guide_edges
The ID of the mark containing the edges to ignore as guide edges. Valid values are 1 and 2.
guide_angle
The minimum angle to use for determining if an edge is a guide edge.
advanced_options
The advanced option settings for surface extension. Bit values are used and the value is calculated as (Bit0 + 2*Bit1 + 4*Bit2 + 8*Bit3 + 16*Bit4 + 32*Bit5).
Bit0
0 – Do not allow shortening.
1 – Allow shortening.
Bit1
0 – Do not allow inter-component extensions.
1 – Allow inter-component extensions.
Bit2
0 – Place result in original components.
1 – Duplicate input surfaces and place result in "Extended Surfaces" component.
Bit3
0 – If Bit4=1, place the extended surfaces in the component defined by Bit2.
1 – If Bit4=1, place the extended surfaces in the current component.
Bit4
0 – Extensions are created using original surfaces.
1 – Extensions are created using new surfaces.
Bit5
0 – Create a new surface for each edge of the original surface.
1 – Create a single surface for each original surface.
reserved
Reserved for future use. Must be set to 0.

Examples

To extend surfaces 2 and 3 by a distance of 5.0, with no advanced options:
*createmark surfaces 1 2 3
*connect_surfaces_11 1 1 1 1 5.0 15.0 30.0 1 0 1 30.0 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

11.0