MAXKey Common Properties, Operators, and Methods

Constructor

addNewKey <controller> <time> [#select] [#interpolate]

Adds a new key to the controller track at the time specified. The new key is also selected in the track view if the #select optional argument is specified. The value for the new key is taken from the previous key, unless the #interpolate argument is specified in which case the value is the interpolated controller value at that time.

getKey <controller> <index_integer>

Returns the indexed key as a MAXKey instance.

<key_array>[<index_integer>]

where <key_array> is:

<controller>.keys
<node>.<animatable_property>.keys

Properties

For keys associated with all keyframeable controller types, the following properties are accessible:

<key>.time Time

time value or number (interpreted as frames)

Warning:

Moving keys to times that either match or exceed subsequent key times will cause errors in the timeline, and possibly crash 3ds Max. It is your responsibility when moving keys to ensure that this doesn't happen.

<key>.selected Boolean

specifies whether the key is selected. Read/write access.

The .time property is read-only for the keys for some controllers, and read/write for the keys of other controllers. The controller type description specifies whether the .time property is read-only or read/write.

For controllers where the key .time property is read/write, the following properties are also available:

<key>.value varies --class determined by its containing controller

Methods

copy <key>

Creates a copy of the key value. This copy is not independent of the original key, as a key value always references a key in a controller. This method exists primarily to support copying of arrays.

The keys on Bézier, TCB, and Barycentric Morph controllers have additional properties and methods. See Bezier Controller Keys, TCB Controller Keys, and Barycentric Morph Controller Keys for details.