ball.euler

Syntax

Vector Access

v = ball.euler(bp<,i>) (3D ONLY)
ball.euler(bp<,i>) = v (3D ONLY)

Get/set the ball orientation. The convention \(\big\{X,Y^{'},Z^{''}\big\}\) is used (i.e., the x-, y-, and z-components correspond to the sequential rotations about the \(X\), \(Y^{'}\), and \(Z^{''}\) axes).

Note

The orientation is updated when orientation tracking is enabled (see the model orientation-tracking command).

Returns:

v - ball orientation vector or component

Accepts:

v - ball orientation vector or component

Arguments:

bp - ball pointer

i - optional vector component

Component Access

f = ball.euler.x(bp) (3D ONLY)
ball.euler.x(bp) = f (3D ONLY)

Get/set the x-component of the ball orientation.

Returns:f - x-component of the ball orientation vector
Accepts:f - x-component of the ball orientation vector
Arguments:bp - ball pointer
f = ball.euler.y(bp) (3D ONLY)
ball.euler.y(bp) = f (3D ONLY)

Get/set the y-component of the ball orientation.

Returns:f - y-component of the ball orientation vector
Accepts:f - y-component of the ball orientation vector
Arguments:bp - ball pointer
f = ball.euler.z(bp) (3D ONLY)
ball.euler.z(bp) = f (3D ONLY)

Get/set the z-component of the ball orientation.

Returns:f - z-component of the ball orientation vector
Accepts:f - z-component of the ball orientation vector
Arguments:bp - ball pointer