poISystem SetOrientationByCoords

Sets the orientation of the coordinate system using the coordinate values of three nodes.

Syntax

system_handle SetOrientationByCoords coord_string

Application

HyperView Tcl Modify

Description

This command sets the orientation of the coordinate system using the coordinates of three nodes. The orientation can be set for user-defined systems only! The first three values define node1, the next three values define the location of node2, and the final three values define the location of node3.

Inputs

coord_string: The string representing the coordinates of the three nodes defining the system.

Example

To set the orientation of a user-defined system using coordinates:

hwi OpenStack
hwi GetSessionHandle session_handle
session_handle GetProjectHandle project_handle
project_handle GetPageHandle page_handle [project_handle GetActivePage]
page_handle GetWindowHandle window_handle [page_handle GetActiveWindow]
window_handle GetClientHandle client_handle
client_handle GetModelHandle model_handle [client_handle GetActiveModel]

model_handle GetUserDefinedSystemHandle sys1 "UserSystem 2"
# Set the orientation of the system so that it has the same axes alignment 
# as the global system
sys1 SetOrientationByCoords "0 0 0 5 0 0 0 5 0"

hwi CloseStack

Errors

Returns a non-zero value if there is an error.