Class RigConstraint<TJob, TData, TBinder>
This is the base class for rig constraints. Inherit from this class to implement custom constraints.
Implements
Inherited Members
Namespace: UnityEngine.Animations.Rigging
Assembly: Unity.Animation.Rigging.dll
Syntax
public class RigConstraint<TJob, TData, TBinder> : MonoBehaviour, IRigConstraint where TJob : struct, IWeightedAnimationJob where TData : struct, IAnimationJobData where TBinder : AnimationJobBinder<TJob, TData>, new()
Type Parameters
| Name | Description |
|---|---|
| TJob | The constraint job |
| TData | The constraint data |
| TBinder | The constraint job binder |
Fields
m_Data
The constraint data.
Declaration
[SerializeField]
protected TData m_Data
Field Value
| Type | Description |
|---|---|
| TData |
m_Weight
The constraint weight parameter.
Declaration
[SerializeField]
[Range(0, 1)]
protected float m_Weight
Field Value
| Type | Description |
|---|---|
| float |
Properties
data
The data container for the constraint.
Declaration
public ref TData data { get; }
Property Value
| Type | Description |
|---|---|
| TData |
weight
The constraint weight. This is a value in between 0 and 1.
Declaration
public float weight { get; set; }
Property Value
| Type | Description |
|---|---|
| float |
Methods
CreateJob(Animator)
Creates the animation job for this constraint.
Declaration
public IAnimationJob CreateJob(Animator animator)
Parameters
| Type | Name | Description |
|---|---|---|
| Animator | animator | The animated hierarchy Animator component |
Returns
| Type | Description |
|---|---|
| IAnimationJob | Returns the newly instantiated job. |
DestroyJob(IAnimationJob)
Frees the specified job memory.
Declaration
public void DestroyJob(IAnimationJob job)
Parameters
| Type | Name | Description |
|---|---|---|
| IAnimationJob | job | The job to destroy. |
IsValid()
Retrieves the constraint valid state.
Declaration
public bool IsValid()
Returns
| Type | Description |
|---|---|
| bool | Returns true if constraint data can be successfully evaluated. Returns false otherwise. |
OnValidate()
This function is called when the script is loaded or a value is changed in the Inspector (Called in the editor only). You can use this to ensure that when you modify data in an editor, that data stays within a certain range.
Declaration
protected virtual void OnValidate()
Reset()
Resets constraint data to default values.
Declaration
public void Reset()
UpdateJob(IAnimationJob)
Updates the specified job data.
Declaration
public void UpdateJob(IAnimationJob job)
Parameters
| Type | Name | Description |
|---|---|---|
| IAnimationJob | job | The job to update. |