MotionBuilder 2016

Software Dependencies

• Supported Operating Systems - Microsoft Windows 7 SP1 or later (64-bit only), Red Hat Linux 6.5 (64-bit only), and CentOS 6.5 (64-bit only).
• Upgraded to Python 2.7.6.
• Upgraded to QT 4.8.6.
• Upgraded to FBX SDK 2016.
• MotionBuilder 2016 and the distributed plug-ins are compiled using Visual Studio 2012.
• GCC 4.8.2 is required for Linux.

New Methods and Properties

• Added the following enums for accessing the Match options of animation clips:
  • FBStoryClipMatchingTimeType – Matching Time Types, when matching clips to each other.
  • FBStoryClipMatchingTranslationType – Matching Translation Types, when matching clips to each other.
  • FBStoryClipMatchingRotationType – Matching Rotation Types, when matching clips to each other.
• FBStoryClip::Match() – Added to match an animation clip to its previous/next animation clip, one to each other.
• FBStoryClip::CanAssignSourcesToDestinations() – Added to determine whether an animation clip can assign its sources to some destinations.
• FBStoryClip::GetAssignSourcesToDestinationsInfo() – New method that returns information about the current state of the Sources to Destinations assignment.
• FBStoryClip::SetAssignSourcesToDestinationsInfo() – New method that sets the effective destinations information for the Sources to Destinations assignment.
• FBStoryFolder::ExpandSelectedClips() – Added to expand one or more clips and fill the gap between clips.
• Following are added to the FBSystem class for getting the names of the loaded plug-in items and their information.
  • FBSystem::GetLoadedPluginItemsName() – New method for getting a string list containing the names of all the loaded plug-ins.
  • FBSystem::GetLoadedPluginItemInfo() – New method for getting a string list containing information about a specified plug-in item.
  • FBSystem::GetLoadedPluginItemGroups() – New method for getting a string list containing the groups to which a specified plug-in item belongs.
  • FBSystem::EPluginItemInfo – New enumerator for getting information about each plug-in item.
• Following are added to the FBStoryClip class for controlling a Story Clip's TimeWarp.
  • FBStoryClip::TimeWarpEnabled – New property to set an animation clip's TimeWarp activeness.
  • FBStoryClip::TimeWarpInterpolatorType – New property to set an animation clip's TimeWarp interpolation type.
  • FBStoryClip::TimeWarpReverse – New property to reverse an animation clip's TimeWarp FCurve.
  • FBStoryClip::CustomTimeWarp – New property for an animation clip's custom TimeWarp FCurve.
• FBStoryClipTimeWarpInterpolatorType – New enumerator for types of TimeWrap interpolator.
• FBStoryClipChangeType::kFBStoryClipMoveClip and FBStoryClipChangeType::kFBStoryClipRemoved – Added these event types for the Story feature.
• FBStoryClip::SetTime() – New function to set a story clip's time.
• FBStoryFolder::AlignSelectedClips() – New method to align selected clips in a Story.
• LockPitchToSpeed and ClipPitch – Added these properties for audio clips to the FBStoryClip class.
• FBStoryClip::GhostManipulatorOffset – New property that allows you to offset the ghost manipulator in space without offsetting a story clip.
• pTimeOffset – New parameter in FBStoryClip() for a clip’s time offset.
• FBPlotOptions::mPlotTangentMode – New attribute to specify the tangent mode to use when plotting a curve.
• FBPlayerControl::OnChange – New event that is triggered for changes in the player control.
• FBPlayerControl::SetPlaySpeedMode() and FBPlayerControl::GetPlaySpeedMode() – New methods for setting and getting the play speed mode.
• kFBSpeed_Custom – New enumeration for custom play speed in FBTransportPlaySpeed.
• FBModel::GetHierarchyWorldMatrices() – New method for computing global transform matrices between a model and its children (all levels).
• FBModelHiercharyTraverserType – New enumeration for types of hierarchy traverser search.
• Following callbacks are added to the FBUndoManager class for undo and redo:
  • FBUndoManager::OnRedo
  • FBUndoManager::OnRedoCompleted
  • FBUndoManager::OnUndo
  • FBUndoManager::OnUndoCompleted

Improvements

• FBModel::SetMatrix() – Updated this function for increasing the precision of rotation vector values when a matrix is converted and the angle is near to the gimbal lock.
• MOTIONBUILDER_SAVELOAD_EMBEDMEDIAS – Updated this environment variable. It is used to specify if media must be embedded when saving a scene, but was only effective when saving using the UI. Now, this environment variable is effective even when saving without the UI.

Deprecation

• The FBApplication::SwitchViewerCamera() method is deprecated. Instead, you can use the following FBRenderer methods:
  • FBRenderer::SetCameraInPane()
  • FBRenderer::GetCameraInPane()
  • FBRenderer::SetPaneCount()
  • FBRenderer::GetPaneCount()
  • FBRenderer::SetSchematicViewInPane()
  • FBRenderer::GetSchematicViewPaneIndex()
  • FBRenderer::SetCameraSwitcherInPane()
  • FBRenderer::IsCameraSwitcherInPane()
• The CurrentCamera property in the FBRenderer class is deprecated. Instead, you can use the following methods:
  • FBRenderer::SetCameraInPane()
  • FBRenderer::GetCameraInPane()
• The UseCameraSwitcher property in the FBRenderer class is deprecated. Instead, you can use the following methods:
  • FBRenderer::SetCameraSwitcherInPane()
  • FBRenderer::IsCameraSwitcherInPane()
• These two methods in FBPlayerControl: SetPlaySpeed() and GetPlaySpeed() that accept and return the enum speed value pre-defined by FBTransportPlaySpeed are deprecated. Instead, you can use FBPlayerControl::SetPlaySpeedMode() method and FBPlayerControl::GetPlaySpeedMode() method. The new FBPlayerControl::SetPlaySpeed() method and FBPlayerControl::GetPlaySpeed() method that accept and return a double speed value are added to support custom play speeds.

Bug Fixes and Workarounds

For information on bug fixes and workarounds, refer to the MotionBuilder 2016 Release Notes.