Description

Positions the given node along the line formed by two selected nodes.

With two nodes that define a line select, snapToLine positions the targetNodeName along that line. Where along the line is specified as a percentage of the distance between the two nodes making up the line unless the -absolute option is used. When -absolute is used the distance along the line is specified in mm.

Functional area

Snap

Command syntax

Syntax

snapToLine "targetNodeName" %s [-allTime] [-absolute] [-ranges]

Arguments

Name	Type	Required	Comments
`targetNodeName`	string	yes	Specifies the name of the node to be snapped.
`%s`	float	yes	Specifies distance along the line the node should be snapped to.

Flags

Name	Argument type	Exclusive to	Comments
`allTime`	—	ranges	Performs the snap over the entire animation range.
`absolute`	—	—	Specifies the argument is in mm rather then a percentage of the distance between the two nodes that define the line.
`ranges`	—	allTime	Performs the snap over the selected time ranges.

Return value

void

Examples

// Snap LMWT half way between LFWT and LBWT at the current frame only.
select LFWT LBWT;
snapToLine LMWT 0.5;

Shogun 1.9 Documentation

snapToLine