Search Unity

  1. Welcome to the Unity Forums! Please take the time to read our Code of Conduct to familiarize yourself with the forum rules and how to post constructively.
  2. Unite 2023 Registrations are now LIVE! We are thrilled to announce that Unite 2023 Registration is now live and open for all!
    Dismiss Notice
New Forum User Notice Unite 2023 Registrations are now LIVE!

Official New version of Cinemachine 3 pre-release 5 available

Discussion in 'Cinemachine' started by antoinecharton, Apr 25, 2023.

  1. antoinecharton

    antoinecharton

    Unity Technologies

    Joined:
    Jul 22, 2020
    Posts:
    156
    Hello :) Cinemachine 3.0.0-pre.5 is out! It is still a pre release, back-up your awesome games, animations… projects before installing especially if upgrading from 2.X.

    Important: We changed the namespace to be more consistent with the rest of Unity API. If you have any custom scripts that reference Cinemachine you will need to change using Cinemachine; to using Unity.Cinemachine;. The minimum version has also been bumped to 2022.2.16f1.

    Enjoy!

    Apr-25-2023 16-02-37.gif


    Installation
    Minimum version: 2022.2.16f1
    Window -> Package Manager -> + -> Add Package By Name
    Name: com.unity.cinemachine
    Version: 3.0.0-pre.5


    Upgrading

    What's new in cinemachine 3
    Upgrade from cinemachine 2.X


    Change-log

    Fixed
    • MixingCamera calls OnTransitionFromCamera correctly for all its children.

    Added
    • Samples: New 2D platformer sample showing custom camera manager.
    • Samples: New Split-screen sample for the input system.
    • Samples: UI works with both built-in input and Input System package.
    • New BlendHint: IgnoreTarget will blend rotations without considering the tracking target.
    • New BlendHint: FreezeWhenBlendingOut will blend out from a snapshot of the camera state.
    • InputAxisController has the option to suppress input while the attached camera is blending.
    • Added CinemachineCameraEvents and CinemachineBrainEvents behaviours for event processing.
    • Added BlendFinished and CameraDeactivated events.
    • Timeline: Added Track Priority field in CinemachineTrack to control track precedence when tracks are contained in nested timelines.

    Changed
    • Minimum Unity version is now 2022.2.16f1.
    • All namespaces changed from "Cinemachine" to "Unity.Cinemachine".
    • "Cinemachine.Utility" namespace folded into to "Unity.Cinemachine".
    • Renamed .asmdef files to follow the convention: Unity.[PackageName].
    • CinemachineInputAxisController refactored to be more easily customized.
    • CinemachineBlendListCamera has been renamed to CinemachineSequencerCamera.
    • TrackedObjectOffset renamed to TargetOffset.
    • Improved layout of PositionComposer and RotationComposer inspectors.
    • LensSettings was refactored to improve handling of SensorSize and other physical properties.
    • Full physical camera support for builtin pipeline.
    • LensPresets and PhysicalLensPresets are now separate assets.
    • Samples are compatible with Built-in, Universal, and High Definition Render Pipelines.
    • CinemachineUpgradeManager re-opens original scene after upgrade is complete.
    • Events system refactored.
    • Refactored CinemachineCameraManagerBase to be more useful for customizing.
     
    antoinecharton, Apr 25, 2023
    #1
    saskenergy, Onigiri, Lurking-Ninja and 2 others like this.

  2. Lars-Steenhoff

    Lars-Steenhoff

    Joined:
    Aug 7, 2007
    Posts:
    3,449
    Nice update, but try not changing things like going to Unity.Cinemachine for no real benefit other than consistency.
    It should have happened in the beginning not now that many tools have it integrated.
     
    Lars-Steenhoff, Apr 25, 2023
    #2

  3. Lurking-Ninja

    Lurking-Ninja

    Joined:
    Jan 20, 2015
    Posts:
    9,903
    I'm here to disagree with the notion to not to make breaking changes. Please do whenever you deem it necessary as long as it happens on major version change. Whoever don't like the changes they can stay on the previous major version until they can schedule the proper upgrade. So a great yay from me!
    Hope other teams at Unity as well finally embrace the necessary changes.
     
    Lurking-Ninja, Apr 25, 2023
    #3
    CiroContns, saskenergy, FunSTW and 6 others like this.

  4. Walter_Hulsebos

    Walter_Hulsebos

    Joined:
    Aug 27, 2015
    Posts:
    26
    It's a major change, that allows for breaking changes: https://semver.org
    Besides that's by far the least breaking change of the bunch. They renamed a lot of classes and variables for that same consistency.
    If you're using Unity Events or other Reflection based tools to steer Cinemachine you'll have to reconfigure all of those.

    I, for one, am extremely happy about this change, it shows a positive direction for the engine, striving for a more unified ecosystem and better cross-compatibility among separate packages. I.e. the Splines package integration, better Input System integration, making their samples work with all Render Pipelines, and if you look at the roadmap they're even looking into proper Visual Scripting Integration, which is a boon even if you're using something like PlayMaker.

    Now is the perfect time for any such changes, since it's a major version anyways, and thus will break existing stuff it's better to bite the bullet and do all consistency changes in one go.

    Thanks, Unity Team! I'm excited to try out the renewed Cinemachine!
     
    Walter_Hulsebos, Apr 25, 2023
    #4
    saskenergy, florianBrn, Lachee_ and 3 others like this.

  5. antoinecharton

    antoinecharton

    Unity Technologies

    Joined:
    Jul 22, 2020
    Posts:
    156
    That's a really fair point and I totally understand it. While any change will ineluctably cause some pain you don't have to switch now. CM 3 does not mean we will drop support of 2.x immediately. You will still be able to use it for some time with all the tools built around it.
    In the state of things today upgrading is completely optional and a choice. The official versions are still 2.x.
    3.0 is still in a pre release state (For some time) no rush to upgrade if you don't feel the need for it.

    Hope this answer your concern.
     
    Last edited: Apr 26, 2023
    antoinecharton, Apr 26, 2023
    #5
    Lars-Steenhoff, Japsu and Walter_Hulsebos like this.

  6. Lachee_

    Lachee_

    Joined:
    Aug 5, 2013
    Posts:
    4
    I disagree, this is also why it's a major revision. It is a breaking change for sure, but i rather it get done now than in the year 2030. I hope they do TMPro next.
     
    Lachee_, Apr 26, 2023
    #6
    Walter_Hulsebos likes this.

  7. Lars-Steenhoff

    Lars-Steenhoff

    Joined:
    Aug 7, 2007
    Posts:
    3,449
    If it can auto update all scripts that would be nice. (With unity script updater)
     
    Lars-Steenhoff, Apr 26, 2023
    #7
    antoinecharton likes this.

  8. antoinecharton

    antoinecharton

    Unity Technologies

    Joined:
    Jul 22, 2020
    Posts:
    156
    That's something we looked at, unfortunately it doesn't work in the context of a package when you have compilation errors in your project.
     
    antoinecharton, Apr 26, 2023
    #8
    Walter_Hulsebos likes this.

  9. Onigiri

    Onigiri

    Joined:
    Aug 10, 2014
    Posts:
    410
    Hi! Great release! Here a small list of UX bugs/suggestions i got after playing with this version a bit:
    1)There's a strange texture that appears over lens category after going in and out of playmode while cinemachine camera is selected in inspector
    upload_2023-5-4_21-58-21.png
    2)Lens preset dropdown has a separator line on the top for some reason
    upload_2023-5-4_21-59-4.png
    3)"None" is lowercase for some reason. Unity's standard is always uppercase for elements in dropdown
    upload_2023-5-4_22-4-36.png
    4) Would be good to have "Add extension" field as button instead of dropdown. Similar to how it's done in volume editor:
    upload_2023-5-4_22-6-52.png
    That's all for now, thanks for your hard work and passion!
     
    Onigiri, May 4, 2023
    #9
    Walter_Hulsebos likes this.

  10. Gregoryl

    Gregoryl

    Unity Technologies

    Joined:
    Dec 22, 2016
    Posts:
    7,225
    Thanks for the suggestions, we appreciate your feedback.

    1) We don't see this. What version of Unity are you using?
    2) This divider indicates that no presets are defined. It will make sense when you add some presets.
    3) Thanks! Will fix.
    4) Thanks, but I don't think we'll revisit this any time soon
     
    Gregoryl, May 4, 2023
    #10
    Walter_Hulsebos and antoinecharton like this.