Installation:

1. install the Unofficial update - strongly encouraged
2. or install the persistent base if not already installed
3. drag the node into the link editor and press the Install button
4. delete the node from the scene after install is complete
5. reset the UU workspace main toolbar or load a layout to update the UU toolbar button

LMB open the toolbar, RMB open the panel

Usage:

tool bar

• record - button will create a new keyframe using the chosen interpolation type. All keyframes must be selected first. If no previous keys exist or no keys are selected then the key interpolation will be controlled by the trueSpace default behavior.
  All keyframes will be selected after creating the new keyframe in preparation to record the next keyframe.
  right click opens the keying panel
• other buttons from left to right are Bezier, Linear, Constant Start Value, Constant End Value, Custom Bezier, Flat Custom Bezier . These change the interpolation of selected keys
  right click to open the interpolation panel and view controls

interpolation panel

• Type - interpolator options -------, Bezier, Linear, Constant Start Value, Constant End Value, Custom Bezier, Flat Custom Bezier

  "-------" will have no effect when the "Set Interpolation" button is pressed and will let trueSpace control the interpolation type when the record button is pressed.
  No keys will be selected after the key is set. The "-------" option is the same as pressing the standard record button.

• Sharpness - smaller values make a sharper curve - no effect in linear, start and end modes
• Set Interpolation - button will set the interpolation type for the selected keyframe(s)
• Select All - select all keyframes. Required for the interpolation type to be set during record.
• Record - same as the toolbar button
• Sharpness and Angle Controls - interactively set values for the selected keyframes. Middle Mouse Drag to reset the value.
  Sharpness default 0.33, range 0.01 to 1.0
  Angle default 0.0, range -88.12 to 88.12, tS angle is odd 10deg looks like a 45 deg angle. This looks like a tS bug.
• Clear Selection - for conditions where a left click does no deselect all keyframes.

interpolation panel - view controls section

• Time to Center - bring an out of range time indicator into view
• Zoom All - same as trueSpace "Zoom to Fit All" from the context menu
• Zoom All+ - same as trueSpace "Zoom to Fit All" from the context menu, but zooms out a bit
• Zoom Selection - same as trueSpace "Zoom to Fit Selection" from the context menu, but zooms out a bit
• Zoom Timeline - fit the entire timeline into view
• Pan and Zoom - Dopesheet and FCurve, LMB to zoom up down left right, MMB to pan up down left right.
  Green section is to set the extents of the curve view vertical values.
• Speed - control the speed (0.1 to 1.0) of the pan and zoom in the vertical(value) and horizontal(time) directions.
• Auto-Extend Limits - when panning or zooming beyond the timeline start and end or the FCurve upper and lower values the limits will expand to allow the action.
• Reset - set the FCurve view value ranges to their defaults

If using the FCurve view the Zoom All will not run unless at least one Matrix key is set for the active clip.
If multiple clips it will ask to continue with the warning of a potential crash. There is now way to tell which clip is active so a question is the only way to allow zoom all on a compatible clip mixed in with incompatible clips.

A workaround for the Zoom to All limitation is to select all the keys and then use Zoom Selection

Video shows an earlier version of the interpolation tools

Notes:

• All keyframes must be selected to create keys with the defined interpolation settings.
• The first keyframe will always be created as a tS default key
• All the keys will be selected automatically after recording a keyframe to prepare for the next record action
• If all keys are not selected, the record buttons will behave the same as the default tS record button, but will give a warning message if the interpolation type is not set to "default".
• The Anim view must be active(selected) for the view control tools to work
• The standard record button in the timeline will not use the default interpolations defined in this panel.
• If the interpolation type is set to "default" then keyframes will be created without any modifications using the normal trueSpace behavior. No need to preselect all existing keyframes.
• Flat interpolation is really the custom type with an angle set to 0.
• Linear and flat interpolations are good for inverse kinematics animations in trueSpace because of a bug in the IK system. Bezier with a small sharpness value should also work fairly well, but may not be good enough to avoid the IK bug, more testing is needed.
  If there is enough time between keyframes the inverse kinematics will behave in a more predictable manner.
• Auto-Extend Limits is good for getting by awkwardly trying to use the tool near the borders. The down side is that some undo history will be created.
• DEV NOTES
• Sept 2017 Dev Note - tS has no way to select a set of keyframes. It can select all or none. Interpolation only works on selected keys. Round about way to set interpolation during key recording:
  1. set a keyframe
  2. create a temporary track and set the keyframe again
  3. select all keys on the temp track and set the interpolation
  4. copy keyframes
  5. paste keyframes into the target track
• Feb 2022 Dev Note - new way to set interpolation while recording
  1. select all keyframes first
  2. animate the object value
  3. set a keyframe
  4. invert the selection to get the new keyframe
  5. set the interpolation value
  6. select all keys automatically to continue setting keyframes
• dev note: no real way to read which animation clip is active
• dev note: script command RsAnimView.ZoomToFitAll will crash in the FCurve view if there are no Matrix keys in the active animation clip.
• dev note: mmclick on clickable bitmap does not seem to work, drag is required

February 21, 2025

• fixed installer bug
• OpenToolbar script added

December 5, 2024

• fix crash bug - zoom to fit all run on non-Matrix animations in FCurve view
• changes from UU - use util functions to set values, add Record panel
  • modifyKeys - use util function to set value
  • recordKeys use SelectAll from UU version to avoid error message
  • Record panel view
• reduced the use of undo history to zero in most cases
• use standard floating panel
• reversed direction of up/down pan control - pans same mouse direction as drag green bars
• add speed controls for pan and zoom
• auto-extend limits to allow zooming and panning beyond the start and end timeline values
• installer load on demand form
• updates the UU toolbar button

February 8, 2022/February 9, 2022

• fix select all button error
• fix clear selection button
• interpolation default change to -------
• change values of interpolation dropdown list
• add custom bezier toolbar button and dropdown option
• select all after create key and not all selected before
• reset button for the curve values range
• Feb 9 - prevent select keys on objects that can't be animated

February 5, 2022

• compatible with multiple animation tracks and clips
• no longer requires manual selection of an animation track
• new default interpolation type to use tS default behavior
• new clear selection button
• new interactive curve sharpness and angle controls
• new view controls
• new plugin requirement

February 24, 2018

• persistent install v2 compatible
• compatible with new batch installer
• unique toolbar winid
• new button to reload toolbar

September 24, 2017

• easier to use - found ways around tS limitations
  • no way to select keyframes
  • no way to read which track is active
• only sets interpolation on selected keys
• removed default type and sharpness
• right click interpolation buttons sets the interpolation type on the panel

January 1 2013: - fixed linear button tooltip

back to the trueSpace Animation Plugins and Scripts list