*MeasureDistance()

Specifies parameters for a distance measurement item in the animation window.

Syntax

*MeasureDistance (Name, On/Off, Model1, Node1, Model2, Node2, DistOn/DistOff, XOn/XOff, YOn/YOff, ZOn/ZOff, IDOn/IDOff, NameOn/NameOff)

Application

HyperView

Inputs

Name

The measure name.

On/Off

On: Displays the measure.
Off: Turns off the display of the measure.

Model1

Index of the model containing the first node.

Node1

Index of the first node.

Model2

Index of the model containing the second node.

Node2

Index of the second node.

DistOn/DistOff

DistOn: Displays the magnitude of the distance.
DistOff: Turns off the display of the magnitude of the distance.

XOn/XOff

XOn: Displays the X component of the distance.
XOff: Turns off the display of the X component of the distance.

YOn/YOff

YOn: Displays the Y component of the distance.
YOff: Turns off the display of the Y component of the distance.

ZOn/ZOff

ZOn: Displays the Z component of the distance.
ZOff: Turns off the displays of the Z component of the distance.

NameOn/NameOff

NameOn: Displays the measure name.
NameOff: Turns off the display of the measure name.

Context

*BeginGraphic()

*BeginMeasure()

Example

To show the distance between two selected nodes:

*BeginGraphic()
 *BeginMeasures()
     *MeasureDistance("Measure 1", NameOn, 
                       0, 1076, 0, 941, DistOn, 
                       XOff, YOff, ZOff, IDOn, NameOn)
     *MeasureDisplacement("Measure 2", NameOn, 
                           0, 1453, DistOff, XOn, 
                           YOn, ZOn, IDOff, NameOff)
     *MeasureAngle("Measure 3", NameOn, 
                    0, 1028, 0, 843, 0, 205, 
                    AngOn, XOff, YOff, ZOn, IDOff, 
                    NameOff, ShowRads)
     *MeasurePosition("Measure 4", NameOn, 
                       0, 379, XOn, YOn, ZOn, 
                       IDOff, NameOff)
 *EndMeasures()
*EndGraphic()