Go to: Synopsis. Return value. Flags. Python examples.

Synopsis

distanceDimension([endPoint=[linear, linear, linear]], [startPoint=[linear, linear, linear]])

Note: Strings representing object names and arguments must be separated by commas. This is not depicted in the synopsis.

distanceDimension is undoable, NOT queryable, and NOT editable.

This command is used to create a distance dimension to display the distance between two specified points.

Return value

string- the shape name of the DAG node created.

Flags

endPoint, startPoint
Long name (short name) Argument types Properties
endPoint(ep) [linear, linear, linear] create
Specifies the point to measure distance to, from the startPoint.
startPoint(sp) [linear, linear, linear] create
Specifies the point to start measuring distance from.
Flag can appear in Create mode of command Flag can appear in Edit mode of command
Flag can appear in Query mode of command Flag can have multiple arguments, passed either as a tuple or a list.

Python examples

import maya.cmds as cmds

# To measure ths distance between [0,2,2] and [1,5,6]:
cmds.distanceDimension( sp=(0, 2, 2), ep=(1, 5, 6) )
#  Result: distanceDimensionShape1  #