docs.unity3d.com
    Show / Hide Table of Contents

    Cinemachine Mixing Camera

    The Cinemachine Mixing Camera component uses the weighted average of its child Virtual Cameras to compute the position and other properties of the Unity camera.

    Cinemachine Mixing Camera with two child Virtual Cameras (red)

    Mixing Camera manages up to eight child Virtual Cameras. In the Mixing Camera component, these Virtual Cameras are fixed slots, not a dynamic array. Mixing Camera uses this implementation to support weight animation in Timeline. Timeline cannot animate array elements.

    To create a Mixing Camera:

    1. In the Unity menu, choose Cinemachine > Create Mixing Camera. A new Mixing Camera appears in the Hierarchy window. By default, Unity also adds two Virtual Cameras as children of the Mixing Camera.

    2. Adjust the children Virtual Cameras.

    3. Add up to six more child cameras.

    4. Select the Mixing Camera in the Hierarchy window then adjust the Child Camera Weights in the Inspector window.

    Child Camera Weights (red) and their contributions to the final position (blue)

    Properties:

    Property: Function:
    Solo Toggles whether or not the Mixing Camera is temporarily live. Use this property to get immediate visual feedback in the Game view to adjust the Virtual Camera.
    Game Window Guides Toggles the visibility of compositional guides in the Game view. This property applies to all Virtual Cameras.
    Save During Play Check to apply the changes while in Play mode. Use this feature to fine-tune a Virtual Camera without having to remember which properties to copy and paste. This property applies to all Virtual Cameras.
    Priority The importance of this Mixing Camera for choosing the next shot. A higher value indicates a higher priority. Cinemachine Brain chooses the next live Virtual Camera from all Virtual Cameras that are activated and have the same or higher priority as the current live Virtual Camera. This property has no effect when using a Virtual Camera with Timeline.
    Child Camera Weights The weight of the Virtual Camera. Each child Virtual Camera has a corresponding Weight property. Note that setting one camera's weight to 1 does not put the other weights to zero. The contribution of any individual camera is its weight divided by the sum of all the child weights.
    Mix Result A graphical representation of the weights of the child Virtual Cameras. The light part of the bar of each child camera represents the proportion of its contribution to the final position of the Mixing Camera. When the bar is completely dark, the camera makes no contribution to the position of the Mixing Camera.
    Back to top
    Terms of use
    Copyright © 2023 Unity Technologies — Terms of use
    • Legal
    • Privacy Policy
    • Cookies
    • Do Not Sell or Share My Personal Information
    • Your Privacy Choices (Cookie Settings)
    "Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S. and elsewhere (more info here). Other names or brands are trademarks of their respective owners.
    Generated by DocFX on 18 October 2023