ball.euler

Syntax

v = ball.euler(bp) (3D ONLY)
ball.euler(bp) = 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

Accepts:

v - ball orientation vector

Arguments:

bp - ball pointer

Component Access

f = ball.euler (bp)->x
ball.euler (bp)->x = f

f = ball.euler.x(bp)
ball.euler.x(bp) = f

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

Access other vector components (\(y\), \(z\)) by substituting the component name where \(x\) appears above. See Member Access Operator for information about accessing members from data types using ->.

Deprecated Component Access

Component access by adding an optional integer in the function arguments (e.g., f = ball.euler(bp,3)) is deprecated. It remains available but will not be supported in future versions. See Component Access with Integers in FISH on the Deprecated Commands and FISH page for details.

This is hidden. Added to include remaining tensor component access functions for inline help.

f = ball.euler.y(bp)
f = ball.euler.z(bp) (3D ONLY)