Class CinemachineTargetGroup
Defines a group of target objects, each with a radius and a weight. The weight is used when calculating the average position of the target group. Higher-weighted members of the group will count more. The bounding box is calculated by taking the member positions, weight, and radii into account.
Inheritance
Namespace: Cinemachine
Syntax
[DocumentationSorting(DocumentationSortingAttribute.Level.UserRef)]
public class CinemachineTargetGroup : MonoBehaviourFields
m_PositionMode
How the group's position is calculated
Declaration
public CinemachineTargetGroup.PositionMode m_PositionModeField Value
| Type | Description |
|---|---|
| CinemachineTargetGroup.PositionMode |
m_RotationMode
How the group's orientation is calculated
Declaration
public CinemachineTargetGroup.RotationMode m_RotationModeField Value
| Type | Description |
|---|---|
| CinemachineTargetGroup.RotationMode |
m_Targets
The target objects, together with their weights and radii, that will contribute to the group's average position, orientation, and size
Declaration
public CinemachineTargetGroup.Target[] m_TargetsField Value
| Type | Description |
|---|---|
| CinemachineTargetGroup.Target[] |
m_UpdateMethod
When to update the group's transform based on the position of the group members
Declaration
public CinemachineTargetGroup.UpdateMethod m_UpdateMethodField Value
| Type | Description |
|---|---|
| CinemachineTargetGroup.UpdateMethod |
Properties
BoundingBox
The axis-aligned bounding box of the group, computed using the targets positions and radii
Declaration
public Bounds BoundingBox { get; }Property Value
| Type | Description |
|---|---|
| Bounds |
IsEmpty
Return true if there are no members with weight > 0
Declaration
public bool IsEmpty { get; }Property Value
| Type | Description |
|---|---|
| System.Boolean |
Sphere
The bounding sphere of the group, computed using the targets positions and radii
Declaration
public BoundingSphere Sphere { get; }Property Value
| Type | Description |
|---|---|
| BoundingSphere |
Methods
AddMember(Transform, Single, Single)
Add a member to the group
Declaration
public void AddMember(Transform t, float weight, float radius)Parameters
| Type | Name | Description |
|---|---|---|
| Transform | t | |
| System.Single | weight | |
| System.Single | radius |
FindMember(Transform)
Locate a member's index in the group. Returns -1 if not a member
Declaration
public int FindMember(Transform t)Parameters
| Type | Name | Description |
|---|---|---|
| Transform | t |
Returns
| Type | Description |
|---|---|
| System.Int32 |
GetViewSpaceAngularBounds(Matrix4x4, out Vector2, out Vector2, out Vector2)
Get the local-space angular bounds of the group, from a spoecific point of view. Also returns the z depth range of the members.
Declaration
public void GetViewSpaceAngularBounds(Matrix4x4 observer, out Vector2 minAngles, out Vector2 maxAngles, out Vector2 zRange)Parameters
| Type | Name | Description |
|---|---|---|
| Matrix4x4 | observer | Point of view from which to calculate, and in whose space the return values are |
| Vector2 | minAngles | The lower bound of the screen angles of the members (degrees) |
| Vector2 | maxAngles | The upper bound of the screen angles of the members (degrees) |
| Vector2 | zRange | The min and max depth values of the members, relative to the observer |
GetViewSpaceBoundingBox(Matrix4x4)
The axis-aligned bounding box of the group, in a specific reference frame
Declaration
public Bounds GetViewSpaceBoundingBox(Matrix4x4 observer)Parameters
| Type | Name | Description |
|---|---|---|
| Matrix4x4 | observer | The frame of reference in which to compute the bounding box |
Returns
| Type | Description |
|---|---|
| Bounds | The axis-aligned bounding box of the group, in the desired frame of reference |
GetWeightedBoundsForMember(Int32)
Get the bounding sphere of a group memebr, with the weight taken into account. As the member's weight goes to 0, the position lerps to the group average position.
Declaration
public BoundingSphere GetWeightedBoundsForMember(int index)Parameters
| Type | Name | Description |
|---|---|---|
| System.Int32 | index | Member index |
Returns
| Type | Description |
|---|---|
| BoundingSphere |
RemoveMember(Transform)
Remove a member from the group
Declaration
public void RemoveMember(Transform t)Parameters
| Type | Name | Description |
|---|---|---|
| Transform | t |