AddPartKey Function

Adds a given new part animation key to the animation timeline to record the animation of the specified attributes of given parts during a specified time span in an active 3D animation editing session.

    AddPartKey(parts: [[[EvItem|canvas-envision-document-items.html#part-items]]][], key: [[[EvAnimationKey|evanimationkey-interface.html]]]): Promise<void>

Parameters

parts: EvItem[]: An array of Part item objects, one or more part items of a 3D model currently edited in an active 3D animation editing session whose specified animated attributes should be recorded with the given part animation key added to the timeline.
key: EvAnimationKey: An EvAnimationKey object, a given new part animation key that should added to the animation timeline to record the animation of the specified attributes of the given part items during the specified time span in the active 3D animation editing session.

Return value

Promise<void>: A Promise that, if fulfilled, resolves to void if the given new part animation key has been successfully added to the animation timeline to record the animation of the specified attributes of the given part items during the specified time span in the active 3D animation editing session.

Discussion

The function will throw an error if the 3D animation editing mode has not been activated.

A part animation key records the animation of the specified attributes of given parts during the time span of the key. In the GUI, each part attribute has its own key on the timeline.

29 April 2025