hm_getplanepanel

Provides a panel to define a plane.

Syntax

hm_getplanepanel ?message? ?default_value?

Type

HyperMesh Tcl GUI

Description

Provides a panel to define a plane. A list with two sublists is returned from this command when successfully executed: {{normal_x normal_y normal_z} {base_x base_y base_z}}

Inputs

?message?
Optional string to show in the status bar when entering the panel.
?default_value?
Optional default value to set the entity filter to when entering the panel. message must be specified to use this option.
Valid values are:
  • N1N2N3 (default if not specified)
  • X_AXIS
  • Y_AXIS
  • Z_AXIS
  • AV_VECTOR
  • SCREEN_NORMAL
  • SCREEN_PARALLEL

Example

To get a plane definition from a user:

set plane [hm_getplanepanel "Please define a plane"]
foreach {nx ny nz} [lindex [lindex $plane 0] 0] {}
foreach {bx by bz} [lindex [lindex $plane 0] 1] {}

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.110

2017.1 - Added new optional default_value argument.