Cinemachine
![]() | CinemachineFramingTransposer Class |
This is a Cinemachine Component in the Body section of the component pipeline.
Its job is to position the camera in a fixed screen-space relationship to
the vcam's Follow target object, with offsets and damping.
The camera will be first moved along the camera Z axis until the Follow target
is at the desired distance from the camera's X-Y plane. The camera will then
be moved in its XY plane until the Follow target is at the desired point on
the camera's screen.
The FramingTansposer will only change the camera's position in space. It will not
re-orient or otherwise aim the camera.
For this component to work properly, the vcam's LookAt target must be null.
The Follow target will define what the camera is looking at.
If the Follow target is a CinemachineTargetGroup, then additional controls will
be available to dynamically adjust the camera’s view in order to frame the entire group.
Although this component was designed for orthographic cameras, it works equally
well with persective cameras and can be used in 3D environments.

SystemObject Object
Component
Behaviour
MonoBehaviour
CinemachineCinemachineComponentBase
CinemachineCinemachineFramingTransposer
Component
Behaviour
MonoBehaviour
CinemachineCinemachineComponentBase
CinemachineCinemachineFramingTransposer
Namespace: Cinemachine
Assembly: Cinemachine (in Cinemachine.dll) Version: 2.0.0.0 (2.0.0.0)

[DocumentationSortingAttribute(5.5f, DocumentationSortingAttributeLevel.UserRef)] [ExecuteInEditMode] [AddComponentMenu("")] [RequireComponent(typeof(CinemachinePipeline))] [SaveDuringPlayAttribute] public class CinemachineFramingTransposer : CinemachineComponentBase
Cinemachine.CinemachineFramingTransposer = function(); Type.createClass( 'Cinemachine.CinemachineFramingTransposer', Cinemachine.CinemachineComponentBase);
The CinemachineFramingTransposer type exposes the following members.

Name | Description | |
---|---|---|
![]() | CinemachineFramingTransposer |

Name | Description | |
---|---|---|
![]() | FollowTarget | Returns the owner vcam's Follow target. (Inherited from CinemachineComponentBase.) |
![]() | HardGuideRect | Internal API for the inspector editor |
![]() | IsValid | True if component is enabled and has a valid Follow target (Overrides CinemachineComponentBaseIsValid.) |
![]() | LookAtTarget | Returns the owner vcam's LookAt target. (Inherited from CinemachineComponentBase.) |
![]() | m_LastBounds | For editor visulaization of the calculated bounding box of the group |
![]() | m_lastBoundsMatrix | For editor visualization of the calculated bounding box of the group |
![]() | SoftGuideRect | Internal API for the inspector editor |
![]() | Stage | Get the Cinemachine Pipeline stage that this component implements.
Always returns the Body stage (Overrides CinemachineComponentBaseStage.) |
![]() | TargetGroup | Get Follow target as CinemachineTargetGroup, or null if target is not a group |
![]() | VcamState | Returns the owner vcam's CameraState. (Inherited from CinemachineComponentBase.) |
![]() | VirtualCamera | Get the associated CinemachineVirtualCameraBase (Inherited from CinemachineComponentBase.) |

Name | Description | |
---|---|---|
![]() | MutateCameraState | Positions the virtual camera according to the transposer rules. (Overrides CinemachineComponentBaseMutateCameraState(CameraState, Single).) |
![]() | OnPositionDragged | API for the editor, to process a position drag from the user.
Base class implementation does nothing. (Inherited from CinemachineComponentBase.) |

Name | Description | |
---|---|---|
![]() | m_AdjustmentMode | How to adjust the camera to get the desired framing |
![]() | m_BiasX | A non-zero bias will move the targt position away from the center of the soft zone |
![]() | m_BiasY | A non-zero bias will move the targt position away from the center of the soft zone |
![]() | m_CameraDistance | The distance along the camera axis that will be maintained from the Follow target |
![]() | m_DeadZoneDepth | The camera will not move along its z-axis if the Follow target is within this distance of the specified camera distance |
![]() | m_DeadZoneHeight | Camera will not move vertically if the target is within this range of the position |
![]() | m_DeadZoneWidth | Camera will not move horizontally if the target is within this range of the position |
![]() | m_GroupFramingMode | What screen dimensions to consider when framing |
![]() | m_GroupFramingSize | How much of the screen to fill with the bounding box of the targets. |
![]() | m_LookaheadSmoothing | Controls the smoothness of the lookahead algorithm. Larger values smooth out
jittery predictions and also increase prediction lag |
![]() | m_LookaheadTime | This setting will instruct the composer to adjust its target offset based
on the motion of the target. The composer will look at a point where it estimates
the target will be this many seconds into the future. Note that this setting 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 setting,
or animate the target more smoothly. |
![]() | m_MaxDollyIn | How much closer to the target can the camera go? |
![]() | m_MaxDollyOut | How much farther from the target can the camera go? |
![]() | m_MaximumDistance | Set this to limit how far from the taregt the camera can get |
![]() | m_MaximumFOV | If adjusting FOV, will not set the FOV higher than this |
![]() | m_MaximumOrthoSize | If adjusting Orthographic Size, will not set it higher than this |
![]() | m_MinimumDistance | Set this to limit how close to the target the camera can get |
![]() | m_MinimumFOV | If adjusting FOV, will not set the FOV lower than this |
![]() | m_MinimumOrthoSize | If adjusting Orthographic Size, will not set it lower than this |
![]() | m_ScreenX | Horizontal screen position for target. The camera will move to position the tracked object here |
![]() | m_ScreenY | Vertical screen position for target, The camera will move to to position the tracked object here |
![]() | m_SoftZoneHeight | When target is within this region, camera will gradually move to re-align
towards the desired position, depending onm the damping speed |
![]() | m_SoftZoneWidth | When target is within this region, camera will gradually move to re-align
towards the desired position, depending onm the damping speed |
![]() | m_UnlimitedSoftZone | |
![]() | m_XDamping | How aggressively the camera tries to maintain the offset in the X-axis.
Small numbers are more responsive, rapidly translating the camera to keep the target's
x-axis offset. Larger numbers give a more heavy slowly responding camera.
Using different settings per axis can yield a wide range of camera behaviors |
![]() | m_YDamping | How aggressively the camera tries to maintain the offset in the Y-axis.
Small numbers are more responsive, rapidly translating the camera to keep the target's
y-axis offset. Larger numbers give a more heavy slowly responding camera.
Using different settings per axis can yield a wide range of camera behaviors |
![]() | m_ZDamping | How aggressively the camera tries to maintain the offset in the Z-axis.
Small numbers are more responsive, rapidly translating the camera to keep the
target's z-axis offset. Larger numbers give a more heavy slowly responding camera.
Using different settings per axis can yield a wide range of camera behaviors |
![]() | OnGUICallback | Used by the Inspector Editor to display on-screen guides. |
