6.0 KiB
6.0 KiB
Framing Transposer
This Virtual Camera Body algorithm moves the camera in a fixed screen-space relationship to the Follow target. You can also specify offsets, damping, and composition rules. Framing Transposer only changes the camera’s position in space. It does not re-orient or otherwise aim the camera.
Framing Transposer is designed for 2D and orthographic cameras. But it works also with perspective cameras and 3D environments.
This algorithm first moves the camera along the camera Z axis until the Follow target is at the desired distance from the camera’s X-Y plane. It then moves the camera in its X-Y plane until the Follow target is at the desired point on the camera’s screen.
Note: Framing Transposer ignores the LookAt target - only the Follow target is used.
If the Follow target is a Target Group, then additional properties are available to frame the entire group.
Properties
| Property: | Function: | |
|---|---|---|
| Lookahead Time | Adjusts the offset of the Virtual Camera from the Follow target based on the motion of the target. Cinemachine estimates the point where the target will be this many seconds into the future. This feature is sensitive to noisy animation and can amplify the noise, resulting in undesirable camera jitter. If the camera jitters unacceptably when the target is in motion, turn down this property, or animate the target more smoothly. | |
| Lookahead Smoothing | The smoothness of the lookahead algorithm. Larger values smooth out jittery predictions and increase prediction lag. | |
| Lookahead Ignore Y | If checked, ignore movement along the Y axis for lookahead calculations. | |
| X Damping | How responsively the camera tries to maintain the offset in the x-axis. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly. Using different settings per axis can yield a wide range of camera behaviors. | |
| Y Damping | How responsively the camera tries to maintain the offset in the y-axis. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly. | |
| Z Damping | How responsively the camera tries to maintain the offset in the z-axis. Small numbers make the camera more responsive. Larger numbers make the camera respond more slowly. | |
| Target Movement Only | If this is enabled, then damping only applies to the motion of the target. Camera rotation changes will bypass damping. | |
| Screen X | Horizontal screen position for target. The camera moves to position the tracked object here. | |
| Screen Y | Vertical screen position for target, The camera moves to position the tracked object here. | |
| Camera Distance | The distance to maintain along the camera axis from the Follow target. | |
| Dead Zone Width | Do not move the camera horizontally when the target is within this range of the position. | |
| Dead Zone Height | Do not move the camera vertically if the target is within this range of the position. | |
| Dead Zone Depth | Do not move the camera along its z-axis if the Follow target is within this distance of the specified camera distance. | |
| Unlimited Soft Zone | If checked, then the soft zone is unlimited in size. | |
| Soft Zone Width | When the target is in this range, move the camera horizontally to frame the target in the dead zone. The Damping properties affect the rate of the camera movement. | |
| Soft Zone Height | When the target is in this range, move the camera vertically to frame the target in the dead zone. The Damping properties affect the rate of the camera movement. | |
| Bias X | Moves the target position horizontally away from the center of the soft zone. | |
| Bias Y | Moves the target position vertically away from the center of the soft zone. | |
| Group Framing Mode | Available when Follow specifies a Target Group. 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. | |
| None | Don’t do any framing adjustment. | |
| Adjustment Mode | How to adjust the camera to get the desired framing. You can zoom, dolly in or out, or do both. Available when Follow specifies a Target Group. | |
| 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. | |
| Group Framing Size | The bounding box that the targets should occupy. Use 1 to fill the whole screen, 0.5 to fill half the screen, and so on. Available when Follow specifies a Target Group. | |
| Max Dolly In | The maximum distance toward the target to move the camera. Available when Follow specifies a Target Group. | |
| Max Dolly Out | The maximum distance away from the target to move the camera. Available when Follow specifies a Target Group. | |
| Minimum Distance | Set this to limit how close to the target the camera can get. Available when Follow specifies a Target Group. | |
| Maximum Distance | Set this to limit how far from the target the camera can get. Available when Follow specifies a Target Group. | |
| Minimum FOV | If adjusting FOV, do not set the FOV lower than this. Available when Follow specifies a Target Group. | |
| Maximum FOV | If adjusting FOV, do not set the FOV higher than this. Available when Follow specifies a Target Group. | |
| Minimum Ortho Size | If adjusting Orthographic Size, do not set it lower than this. Available when Follow specifies a Target Group. | |
| Maximum Ortho Size | If adjusting Orthographic Size, do not set it higher than this. Available when Follow specifies a Target Group. |