com.unity.cinemachine 3.1.0

com.unity.cinemachine

Source docs
Notes: processedReleased April 16, 2024

Browse versions

PreviousNext

🔧 Bug Fixes

  • Bugfix: index out of range exception when adding a Cm Shot to a timeline track whose CinemachineBrain is inactive.
  • Bugfix: OrbitalFollow with 3-ring setup would inappropriately damp in respose to vertical input if LookAt and Follow were at different vertical positions.
  • Bugfix: StateDrivenCamera min activation time was broken.
  • Bugfix: Solo not updating when brain is in FixedUpdate.
  • Bugfix: Spline roll was being calculated incorrectly when spline was rotated.
  • Bugfix: "Freeze When Blending Out" didn't work when switching betwen two cameras multiple times.
  • Bugfix: Cinemachine cameras would sometimes unnecessarily dirty the scene due to floating-point imprecision when setting transform rotations.

Features

  • Added CinemachineDecollider to resolve camera intersection with colliders and terrains, without necessarily preserving line-of-sight to target.
  • CinemachineDeoccluder has the option to resolve towards the Follow target instead of the LookAt target.
  • Added CinemachineShotQualityEvaluator which is a standalone version of the evaluation code in Deoccluder.
  • Added StateDrivenCamera.CancelWait() method to cancel the current wait on a pending state change.
  • Added FlyAround sample scene showing a simple fly-around camera.
  • Added IgnoreTimeScale option to InputAxisControllerBase.
  • Added confirmation dialog when exiting play mode, if Save During Play is enabled and changes have been made to saveable properties.

📈 Improvements

  • SplineDolly and SplineCart: position on spline is preserved when units change.
  • SimplePlayerAimController sample upgraded to work on arbitrary surfaces (no longer depends on world up).
  • SimplePlayerController sample has logic to avoid input gimbal lock when player is upside-down relative to the camera.
  • PlayerOnSphere sample is now PlayerOnSurface - can walk on arbitrary surfaces.
  • Axis recentering happens independently on axes with differing recentering tmes, so that input on one axis does not impact the recentering state of the others.
  • FreeLookOnSphericalSurface sample is improved, adding a moving surface and second camera.
  • Replaced SameAsFollowTarget with RotateWithFollowTarget (SameAsFollowTarget still exists but is deprecated).
  • Deoccluder evaluates shots in the Finalize stage instead of Aim.