mdlIObject IsEqual

Determines if two handles point to the same object.

Syntax

mdlIObject_handle IsEqual other_handle

Application

MotionView Tcl Query

Description

This command determines if two handles point to the same object. This command can be used in case a single object has been obtained by two different handles. This command is useful when you want to remove the extra handles that are holding the same object.

Inputs

other_handle
The name of the handle which is to be checked against the present handle of the object.

Example

To check if the handles to points are equal or not:
Note: Load the slider_crank.mdl model file before running this example.
hwi OpenStack
hwi GetSessionHandle mySessionName 
mySessionName GetProjectHandle myProjectName 
set activePageNum [myProjectName GetActivePage]
myProjectName GetPageHandle myPageName $activePageNum
set activeWinNum [myPageName GetActiveWindow]
myPageName GetWindowHandle myWindowName $activeWinNum
myWindowName GetClientHandle myClientName 
myClientName GetModelHandle myModelName 
myModelName GetChildHandle hand1 p_cp
myModelName GetChildHandle hand2 p_cp
myModelName GetChildHandle hand3 p_sp
tk_messageBox -message "object1 equals object2 - [hand1 IsEqual hand2]";
tk_messageBox -message "object1 equals object3 - [hand1 IsEqual hand3]";
tk_messageBox -message "object2 equals object3 - [hand2 IsEqual hand3]";
hand1 ReleaseHandle
hand2 ReleaseHandle
hand3 ReleaseHandle
myModelName ReleaseHandle
myClientName ReleaseHandle
myWindowName ReleaseHandle
myPageName ReleaseHandle
myProjectName ReleaseHandle
mySessionName ReleaseHandle
hwi CloseStack

Errors

Returns true if the two handles are equal (meaning they both are pointing to same object), or false if the two handles are not equal.