Camera Rig
| Component entity system is in preview release and is subject to change. |
Use the Camera Rig component to add and remove behaviors to drive your camera entity. To use the camera component, you must first add the Camera Framework Gem to your project.
Camera Rig Component Properties
The Camera Rig component has the following properties:
- Target acquirers
-
Array of behaviors that define how a camera selects a target. The rig tries each acquirer in the order listed until one successfully finds a target.
- Look-at behaviors
-
Array of behaviors that modify the look-at target transform. The rig runs each in order to generate a final target transform.
- Transform behaviors
-
Array of behaviors that modify the camera transform based on the look-at target transform. The rig runs each in order before setting the camera component's transform.
Target Acquirers
Target Acquirers identify valid targets and acquire their transforms for use in other rig behaviors.
Acquire By Tag
AcquireByTag has the following properties:
- Target tag
-
Find a target by tag. If multiple entities are found, it uses the first to respond.
- Use Target Rotation
-
If selected, uses the target's rotation when determining camera behavior.
- Use Target Position
-
If selected, uses the target's position when determining camera behavior.
Acquire By Entity Id
AcquireByEntityId has the following properties:
- Entity Target
-
Select a specific entity to use as the camera target
- Use Target Rotation
-
If selected, uses the target's rotation when determining camera behavior.
- Use Target Position
-
If selected, uses the target's position when determining camera behavior.
Look-at Behaviors
Look-at Behaviors changes the target transform to modify camera behavior.
OffsetPosition
Use OffsetPosition to change the position of the target's transform. Positions are often determined from the base of a model. But suppose, for example, that you want to determine its position 1.8 meters up from its base. You can use this property to achieve that positional offset.
Look-at Behaviors has the following properties:
- Positional Offset
-
Vector displacement of the target transform's position.
- Offset Is Relative
-
If selected, uses local coordinates. If deselected, uses world-basis vectors for the offset.
Rotate Camera Target
Use Rotate Camera Target to rotate the target separately from its source target. For example, you may want your character to look up and down without pitching.
Rotate Camera Target has the following properties:
- Axis of Rotation
-
The target cardinal's axis around which the camera rotates. Select the X, Y, or Z axis.
- Event Name
-
Name of event that provides the values for the rotation.
- Invert Axis
-
If selected, inverts the axis of rotation.
- Rotation Speed Scale
-
Multiplier for new input values to scale the speed of rotation.
SlideAlongAxisBasedOnAngle
Use SlideAlongAxisBasedOnAngle to modify the position of the look-at target based on an angle. For example, say that you set the target to slide along the forward and backward axis based on pitch. As the target pitched down, then the position would move ahead of the target. If the target is attached to the character, then every time the target looked down, it would be ahead of the character. Every time it looked up, it would be behind the character.
SlideAlongAxisBasedOnAngle has the following properties:
- Axis to slide along
-
Select an axis along which the target slides:
-
Forwards and Backwards
-
Right and Left
-
Up and Down
-
- Angle Type
-
Select an angle type on which to base the slide:
-
Pitch
-
Yaw
-
Roll
-
- Vector Component to Ignore
-
Select a vector component to ignore: None, X, Y, or Z.
- Max Positive Slide Distance
-
The maximum slide along the axis when the angle reaches 90 degrees.
- Max Negative Slide Distance
-
The maximum slide along the axis when the angle reaches -90 degrees.
Transform Behaviors
Transform Behaviors are a critical component of how the camera responds to the target. For example, you can set the camera to face the target, follow from a distance, or follow the target at a specific angle.
FaceTarget
FaceTarget causes the camera to change the rotation of its transform to look at the target. To use this feature, simply add it. There are no additional properties to configure.
FollowTargetFromAngle
FollowTargetFromAngle causes the camera to follow the target from a specified angle. This feature works well for top-down, isometric, and side scrolling cameras.
Follow Target from Angle has the following properties:
- Angle
-
Angle at which to follow the target.
- Rotation Type
-
Rotation type of the angle for following the target: yaw, pitch, or roll.
- Distance from Target
-
The distance in meters from which the camera follows the target.
FollowTargetFromDistance
FollowTargetFromDistance causes the camera to follow the target from a specified distance. You can also set named events to trigger the camera to zoom in on or out from a target.
FollowTargetFromDistance has the following properties:
- Follow Distance
-
The distance in meters from which the camera follows the target.
- Minimum Follow Distance
-
Minimum distance from which the camera follows the target.
- Maximum Follow Distance
-
Maximum distance from which the camera follows the target.
- Zoom In Event Name
-
Event name that reduces the current follow distance, in effect zooming in.
- Zoom Out Event Name
-
Event name that increases the current follow distance, in effect zooming out.
- Zoom Speed Scale
-
Scale amount for the incoming zoom value.
- Player Index
-
The index of the player (device index) that this feature supports.
Offset Position
Offset Position sets the camera's position to the target's position with an offset.
Offset Position has the following properties:
- Offset
-
The vector offset in meters from the target.
- Is Offset Relative
-
If selected, local basis vectors are used. If deselected, worldbasis vectors are used.
Rotate
Use Rotate to rotate a camera about one of its axes (X, Y, or Z).
Rotate has the following properties:
- Angle
-
Angle in degrees to rotate the camera.
- Axis
-
Axis about which to rotate the camera.
