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

Synopsis

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

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

distanceDimension is undoable, queryable, and editable.

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

Flags

endPoint, startPoint
Long name (short name) [argument types] Properties
startPoint(sp) [float, float, float] create
Specifies the point to start measuring distance from.
endPoint(ep) [float, float, float] create
Specifies the point to measure distance to, from the startPoint.

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.

Return value


string - the shape name of the DAG node created.

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  #