hm_getboundingbox

Syntax

hm_getboundingbox entity_type mark_id entity_flag system_id box_type

Type

HyperMesh Tcl Query Command

Description

This command returns the six values defining the bounding box from the specified entities and options:

x_min y_min z_min x_max y_max z_max

The box values are determined depending on the following options.

Inputs

entity_type

The type of entity to find the bounding box for. See the list of supported entities for this command.

mark_id

The ID of the mark containing the entities. Valid values are 1 and 2.

entity_flag

This is a bit value used when entity_type is assems or comps.

For assems, this specifies whether to consider nodes/elems, geometry, and/or connectors.

For comps, this specifies whether to consider nodes/elems, geometry and/or connectors.

It is ignored for all other entity_types and should be set to 0, but there is no error if bit values are specified that do not correspond to the current entity_type.

The bit values are summed as (Bit0 + 2*Bit1 + 4*Bit2).

Bit0:0 - Do not consider nodes/elems.

• 1 - Consider nodes/elems.

Bit1:0 - Do not consider geometry.

• 1 - Consider geometry.

Bit2:0 - Do not consider connectors

• 1 - Consider connectors.

system_id

The ID of the local coordinate system to return the values relative to. A value of 0 is the global system. Currently only rectangular systems are supported.

box_type

The type of bounding box to return. Currently, only a value of 0 is supported, which indicates to return the coordinates of the box oriented along the axes of the specified system.

Examples

To get the bounding box for the displayed elements oriented relative to the global system:

*createmark elems 1 displayed
hm_getboundingbox elems 1 0 0 0

To get the bounding box for the geometry in comps 1-4 oriented relative to rectangular system 100:

*createmark comps 1-4
hm_getboundingbox elems 1 2 100 0

Errors

if { [ catch {command_name...} ] } {
   # Handle error
}

Version History

11.0