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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
JY&
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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.