From c7e5dbdbba77b5a247c32b63b68fb34bcfa4be5f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?S=C3=A9bastien=20Duverne?= <55094336+sebastienduverne@users.noreply.github.com> Date: Thu, 31 Oct 2024 18:36:30 -0400 Subject: [PATCH] CMCL-0000: Various doc fixes following user feedback (#1025) * DOCATT-6350 - Installation note in landing page * DOCATT-6317 - Update Group Framing ref page * Added group framing component screenshot --- .../Documentation~/CinemachineGroupFraming.md | 54 ++++++++++-------- ...ef-component-cinemachine-group-framing.png | Bin 0 -> 46989 bytes com.unity.cinemachine/Documentation~/index.md | 3 + 3 files changed, 33 insertions(+), 24 deletions(-) create mode 100644 com.unity.cinemachine/Documentation~/images/ref-component-cinemachine-group-framing.png diff --git a/com.unity.cinemachine/Documentation~/CinemachineGroupFraming.md b/com.unity.cinemachine/Documentation~/CinemachineGroupFraming.md index dde0ef60a..4367aefc6 100644 --- a/com.unity.cinemachine/Documentation~/CinemachineGroupFraming.md +++ b/com.unity.cinemachine/Documentation~/CinemachineGroupFraming.md @@ -1,30 +1,36 @@ -# Group Framing +# Cinemachine Group Framing component -This CinemachineCamera extension adds the ability to frame one or more targets when they are members of a CinemachineTargetGroup. It can be used to dynamically adjust the zoom or to move the camera closer to or farther from the targets, to keep them in the frame at the desired size. +This component is a Cinemachine Camera extension that adds the ability to frame one or more targets when they are members of a Cinemachine Target Group. You can use it to dynamically adjust the zoom or to move the camera closer to or farther from the targets, to keep them in the frame at the desired size. -For this to work, the CinemachineCamera's Tracking Target must be a CinemachineTargetGroup, with at least one member, and having a nonzero size. +To enable the functionality of the Cinemachine Group Framing component, you must: +* Add it to an existing GameObject that contains a [Cinemachine Camera](CinemachineCamera.md) component. +* Create a separate GameObject with a [Cinemachine Target Group](CinemachineTargetGroup.md) component that targets the GameObjects you want to frame together in your Scene. + * Make sure the Cinemachine Target Group has at least one member, and has a nonzero size. +* Set the Cinemachine Camera's Tracking Target property to target the created Cinemachine Target Group. -## Properties - -| **Property:** || **Function:** | -|:---|:---|:---| -| __Framing Mode__ || Specifies the screen dimensions to consider when framing. | -| | _Horizontal_ | Consider only the horizontal dimension. Ignore vertical framing. | -| | _Vertical_ | Consider only the vertical dimension. Ignore horizontal framing. | -| | _Horizontal And Vertical_ | Use the larger of the horizontal and vertical dimensions to get the best fit. | -| __Adjustment Mode__ || How to adjust the camera in depth to get the desired framing. You can zoom, dolly in or out, or do both. | -| | _Zoom Only_ | Don’t move the camera, only adjust the FOV. | -| | _Dolly Only_ | Move the camera, don’t change the FOV. | -| | _Dolly Then Zoom_ | Move the camera as much as permitted by the ranges, then adjust the FOV if necessary to make the shot. | -| __Lateral Adjustment__ || How to adjust the camera horizontally and vertically to get the desired framing. You can change position to reframe, or rotate the camera to reframe. | -| | _Change Position_ | Camera is moved horizontally and vertically until the desired framing is achieved. | -| | _Change Rotation_ | Camera is rotated to achieve the desired framing. | -| __Framing Size__ || The screen-space bounding box that the targets should occupy. Use 1 to fill the whole screen, 0.5 to fill half the screen, and so on. | -| __Center Offset__ || A nonzero value will offset the group in the camera frame. | -| __Damping__ || How gradually to make the framing adjustment. A larger number gives a slower response, smaller numbers a snappier one. | -| __Dolly Range__ || The allowable range that the camera may be moved in order to achieve the desired framing. A negative distance is towards the target, and a positive distance is away from the target. | -| __FOV Range__ || If adjusting FOV, it will be clamped to this range. | -| __Ortho Size Range__ || If adjusting Orthographic Size, it will be clamped to this range. | +![](images/ref-component-cinemachine-group-framing.png) +## Properties +> [!NOTE] +> The availability of some properties depend on the type of Unity Camera you're using: [perspective or orthographic](https://docs.unity3d.com/Manual/CamerasOverview.html). +| Property || Function | +| :--- | :--- | :--- | +| **Framing Mode** || Specifies the screen dimensions to consider when framing. | +|| _Horizontal_ | Consider only the horizontal dimension. Ignore vertical framing. | +|| _Vertical_ | Consider only the vertical dimension. Ignore horizontal framing. | +|| _Horizontal And Vertical_ | Use the larger of the horizontal and vertical dimensions to get the best fit. | +| **Framing Size** || The screen-space bounding box that the targets should occupy. Use 1 to fill the whole screen, 0.5 to fill half the screen, and so on. | +| **Center Offset** || Horizontally and vertically offsets the position of the group in the camera frame. | +| **Damping** || How gradually to make the framing adjustment. Larger numbers give a slower response, smaller numbers a snappier one. | +| **Size Adjustment** || How to adjust the camera in depth to get the desired framing. You can zoom, dolly in or out, or do both.
Only available when using a perspective Unity Camera. | +|| _Zoom Only_ | Don’t move the camera, only adjust the Field of View. | +|| _Dolly Only_ | Move the camera, don’t change the Field of View. | +|| _Dolly Then Zoom_ | Move the camera as much as permitted by the ranges, then adjust the FOV if necessary to make the shot. | +| **Lateral Adjustment** || How to adjust the camera horizontally and vertically to get the desired framing. You can change position to reframe, or rotate the camera to reframe.
Only available when using a perspective Unity Camera. | +|| _Change Position_ | Move the camera horizontally and vertically until the desired framing is achieved. | +|| _Change Rotation_ | Rotate the camera to achieve the desired framing. | +| **Fov Range** || Clamps the camera's Field of View to the specified range.
Only available when including Zoom in **Size Adjustment**. | +| **Dolly Range** || Limits the camera movements to the specified range when achieving the desired framing. A negative distance is towards the target, and a positive distance is away from the target.
Only available when including Dolly in **Size Adjustment**. | +| **Ortho Size Range** || Clamps the camera's Orthographic Size to the specified range.
Only available when using an orthographic Unity Camera. | diff --git a/com.unity.cinemachine/Documentation~/images/ref-component-cinemachine-group-framing.png b/com.unity.cinemachine/Documentation~/images/ref-component-cinemachine-group-framing.png new file mode 100644 index 0000000000000000000000000000000000000000..18223be64ebf0471026f67f63db5549b1dba8c4a GIT binary patch literal 46989 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 T%8kfU;2)!jrW2yaTW|b-)Rr35 literal 0 HcmV?d00001 diff --git a/com.unity.cinemachine/Documentation~/index.md b/com.unity.cinemachine/Documentation~/index.md index 954c3c858..acf5a9704 100644 --- a/com.unity.cinemachine/Documentation~/index.md +++ b/com.unity.cinemachine/Documentation~/index.md @@ -2,6 +2,9 @@ ![Unity Cinemachine](images/CinemachineSplash.png) +>[!NOTE] +>To use the Cinemachine package, you must install it separately from the Unity Editor. For detailed information about package requirements and installation instructions, refer to [Installation](InstallationAndUpgrade.md). + Cinemachine is a suite of modules for controlling the Unity camera. Cinemachine solves the complex mathematics and logic of tracking targets, composing, blending, and cutting between shots. It is designed to significantly reduce the number of time-consuming manual manipulations and script revisions that take place during development. The procedural nature of these modules makes Cinemachine robust and forgiving. When you make adjustments - for example, change an animation, vehicle speed, terrain, or other GameObjects in your Scene - Cinemachine dynamically adjusts its behavior to make the best shot. There is no need, for example, to re-write camera scripts just because a character turns left instead of right.