Animation

package
v0.0.0-...-c858641 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Sep 14, 2025 License: MIT Imports: 27 Imported by: 0

Documentation

Overview

This resource holds data that can be used to animate anything in the engine. Animations are divided into tracks and each track must be linked to a node. The state of that node can be changed through time, by adding timed keys (events) to the track. 

package main

import "graphics.gd/classdb/Animation"

func ExampleAnimation() {
	// This creates an animation that makes the node "Enemy" move to the right by
	// 100 pixels in 2.0 seconds.
	var animation = Animation.New()
	var track_index = animation.AddTrack(Animation.TypeValue)
	animation.TrackSetPath(track_index, "Enemy:position:x")
	animation.TrackInsertKey(track_index, 0.0, 0)
	animation.TrackInsertKey(track_index, 2.0, 100)
	animation.SetLength(2.0)
}

Animations are just data containers, and must be added to nodes such as an graphics.gd/classdb/AnimationPlayer to be played back. Animation tracks have different types, each with its own set of dedicated methods. Check TrackType to see available types.

Note: For 3D position/rotation/scale, using the dedicated TypePosition3d, TypeRotation3d and TypeScale3d track types instead of TypeValue is recommended for performance reasons.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type Advanced 

type Advanced = class

Advanced exposes a 1:1 low-level instance of the class, undocumented, for those who know what they are doing.

type Any 

type Any interface {
	gd.IsClass
	AsAnimation() Instance
}

type Expanded 

type Expanded [1]gdclass.Animation

func (Expanded) AddTrack 

func (self Expanded) AddTrack(atype TrackType, at_position int) int

Adds a track to the Animation.

func (Expanded) AudioTrackInsertKey 

func (self Expanded) AudioTrackInsertKey(track_idx int, time Float.X, stream Resource.Instance, start_offset Float.X, end_offset Float.X) int

Inserts an Audio Track key at the given 'time' in seconds. The 'track_idx' must be the index of an Audio Track.

'stream' is the graphics.gd/classdb/AudioStream resource to play. 'start_offset' is the number of seconds cut off at the beginning of the audio stream, while 'end_offset' is at the ending.

func (Expanded) BezierTrackInsertKey 

func (self Expanded) BezierTrackInsertKey(track_idx int, time Float.X, value Float.X, in_handle Vector2.XY, out_handle Vector2.XY) int

Inserts a Bezier Track key at the given 'time' in seconds. The 'track_idx' must be the index of a Bezier Track.

'in_handle' is the left-side weight of the added Bezier curve point, 'out_handle' is the right-side one, while 'value' is the actual value at this point.

func (Expanded) BezierTrackSetKeyInHandle 

func (self Expanded) BezierTrackSetKeyInHandle(track_idx int, key_idx int, in_handle Vector2.XY, balanced_value_time_ratio Float.X)

Sets the in handle of the key identified by 'key_idx' to value 'in_handle'. The 'track_idx' must be the index of a Bezier Track.

func (Expanded) BezierTrackSetKeyOutHandle 

func (self Expanded) BezierTrackSetKeyOutHandle(track_idx int, key_idx int, out_handle Vector2.XY, balanced_value_time_ratio Float.X)

Sets the out handle of the key identified by 'key_idx' to value 'out_handle'. The 'track_idx' must be the index of a Bezier Track.

func (Expanded) BlendShapeTrackInterpolate 

func (self Expanded) BlendShapeTrackInterpolate(track_idx int, time_sec Float.X, backward bool) Float.X

Returns the interpolated blend shape value at the given time (in seconds). The 'track_idx' must be the index of a blend shape track.

func (Expanded) Compress 

func (self Expanded) Compress(page_size int, fps int, split_tolerance Float.X)

Compress the animation and all its tracks in-place. This will make Instance.TrackIsCompressed return true once called on this graphics.gd/classdb/Animation. Compressed tracks require less memory to be played, and are designed to be used for complex 3D animations (such as cutscenes) imported from external 3D software. Compression is lossy, but the difference is usually not noticeable in real world conditions.

Note: Compressed tracks have various limitations (such as not being editable from the editor), so only use compressed animations if you actually need them.

func (Expanded) Optimize 

func (self Expanded) Optimize(allowed_velocity_err Float.X, allowed_angular_err Float.X, precision int)

Optimize the animation and all its tracks in-place. This will preserve only as many keys as are necessary to keep the animation within the specified bounds.

func (Expanded) PositionTrackInterpolate 

func (self Expanded) PositionTrackInterpolate(track_idx int, time_sec Float.X, backward bool) Vector3.XYZ

Returns the interpolated position value at the given time (in seconds). The 'track_idx' must be the index of a 3D position track.

func (Expanded) RotationTrackInterpolate 

func (self Expanded) RotationTrackInterpolate(track_idx int, time_sec Float.X, backward bool) Quaternion.IJKX

Returns the interpolated rotation value at the given time (in seconds). The 'track_idx' must be the index of a 3D rotation track.

func (Expanded) ScaleTrackInterpolate 

func (self Expanded) ScaleTrackInterpolate(track_idx int, time_sec Float.X, backward bool) Vector3.XYZ

Returns the interpolated scale value at the given time (in seconds). The 'track_idx' must be the index of a 3D scale track.

func (Expanded) TrackFindKey 

func (self Expanded) TrackFindKey(track_idx int, time Float.X, find_mode FindMode, limit bool, backward bool) int

Finds the key index by time in a given track. Optionally, only find it if the approx/exact time is given.

If 'limit' is true, it does not return keys outside the animation range.

If 'backward' is true, the direction is reversed in methods that rely on one directional processing.

For example, in case 'find_mode' is FindModeNearest, if there is no key in the current position just after seeked, the first key found is retrieved by searching before the position, but if 'backward' is true, the first key found is retrieved after the position.

func (Expanded) TrackInsertKey 

func (self Expanded) TrackInsertKey(track_idx int, time Float.X, key any, transition Float.X) int

Inserts a generic key in a given track. Returns the key index.

func (Expanded) ValueTrackInterpolate 

func (self Expanded) ValueTrackInterpolate(track_idx int, time_sec Float.X, backward bool) any

Returns the interpolated value at the given time (in seconds). The 'track_idx' must be the index of a value track.

A 'backward' mainly affects the direction of key retrieval of the track with UpdateDiscrete converted by [Animationmixer.AnimationCallbackModeDiscreteForceContinuous] to match the result with Instance.TrackFindKey.

type Extension 

type Extension[T gdclass.Interface] struct{ gdclass.Extension[T, Instance] }

Extension can be embedded in a new struct to create an extension of this class. T should be the type that is embedding this Extension

func (*Extension[T]) AsAnimation 

func (self *Extension[T]) AsAnimation() Instance

func (*Extension[T]) AsObject 

func (self *Extension[T]) AsObject() [1]gd.Object

func (*Extension[T]) AsRefCounted 

func (self *Extension[T]) AsRefCounted() [1]gd.RefCounted

func (*Extension[T]) AsResource 

func (self *Extension[T]) AsResource() Resource.Instance

type FindMode 

type FindMode int //gd:Animation.FindMode

const (
	// Finds the nearest time key.
	FindModeNearest FindMode = 0
	// Finds only the key with approximating the time.
	FindModeApprox FindMode = 1
	// Finds only the key with matching the time.
	FindModeExact FindMode = 2
)

type ID 

type ID Object.ID

ID is a typed object ID (reference) to an instance of this class, use it to store references to objects with unknown lifetimes, as an ID will not panic on use if the underlying object has been destroyed.

func (ID) Instance 

func (id ID) Instance() (Instance, bool)

type Instance 

type Instance [1]gdclass.Animation

Instance of the class with convieniently typed arguments and results. 

var Nil Instance

Nil is a nil/null instance of the class. Equivalent to the zero value.

func New 

func New() Instance

func (Instance) AddMarker 

func (self Instance) AddMarker(name string, time Float.X)

Adds a marker to this Animation.

func (Instance) AddTrack 

func (self Instance) AddTrack(atype TrackType) int

Adds a track to the Animation.

func (Instance) AnimationTrackGetKeyAnimation 

func (self Instance) AnimationTrackGetKeyAnimation(track_idx int, key_idx int) string

Returns the animation name at the key identified by 'key_idx'. The 'track_idx' must be the index of an Animation Track.

func (Instance) AnimationTrackInsertKey 

func (self Instance) AnimationTrackInsertKey(track_idx int, time Float.X, animation string) int

Inserts a key with value 'animation' at the given 'time' (in seconds). The 'track_idx' must be the index of an Animation Track.

func (Instance) AnimationTrackSetKeyAnimation 

func (self Instance) AnimationTrackSetKeyAnimation(track_idx int, key_idx int, animation string)

Sets the key identified by 'key_idx' to value 'animation'. The 'track_idx' must be the index of an Animation Track.

func (Instance) AsAnimation 

func (self Instance) AsAnimation() Instance

func (Instance) AsObject 

func (self Instance) AsObject() [1]gd.Object

func (Instance) AsRefCounted 

func (self Instance) AsRefCounted() [1]gd.RefCounted

func (Instance) AsResource 

func (self Instance) AsResource() Resource.Instance

func (Instance) AudioTrackGetKeyEndOffset 

func (self Instance) AudioTrackGetKeyEndOffset(track_idx int, key_idx int) Float.X

Returns the end offset of the key identified by 'key_idx'. The 'track_idx' must be the index of an Audio Track.

End offset is the number of seconds cut off at the ending of the audio stream.

func (Instance) AudioTrackGetKeyStartOffset 

func (self Instance) AudioTrackGetKeyStartOffset(track_idx int, key_idx int) Float.X

Returns the start offset of the key identified by 'key_idx'. The 'track_idx' must be the index of an Audio Track.

Start offset is the number of seconds cut off at the beginning of the audio stream.

func (Instance) AudioTrackGetKeyStream 

func (self Instance) AudioTrackGetKeyStream(track_idx int, key_idx int) Resource.Instance

Returns the audio stream of the key identified by 'key_idx'. The 'track_idx' must be the index of an Audio Track.

func (Instance) AudioTrackInsertKey 

func (self Instance) AudioTrackInsertKey(track_idx int, time Float.X, stream Resource.Instance) int

Inserts an Audio Track key at the given 'time' in seconds. The 'track_idx' must be the index of an Audio Track.

'stream' is the graphics.gd/classdb/AudioStream resource to play. 'start_offset' is the number of seconds cut off at the beginning of the audio stream, while 'end_offset' is at the ending.

func (Instance) AudioTrackIsUseBlend 

func (self Instance) AudioTrackIsUseBlend(track_idx int) bool

Returns true if the track at 'track_idx' will be blended with other animations.

func (Instance) AudioTrackSetKeyEndOffset 

func (self Instance) AudioTrackSetKeyEndOffset(track_idx int, key_idx int, offset Float.X)

Sets the end offset of the key identified by 'key_idx' to value 'offset'. The 'track_idx' must be the index of an Audio Track.

func (Instance) AudioTrackSetKeyStartOffset 

func (self Instance) AudioTrackSetKeyStartOffset(track_idx int, key_idx int, offset Float.X)

Sets the start offset of the key identified by 'key_idx' to value 'offset'. The 'track_idx' must be the index of an Audio Track.

func (Instance) AudioTrackSetKeyStream 

func (self Instance) AudioTrackSetKeyStream(track_idx int, key_idx int, stream Resource.Instance)

Sets the stream of the key identified by 'key_idx' to value 'stream'. The 'track_idx' must be the index of an Audio Track.

func (Instance) AudioTrackSetUseBlend 

func (self Instance) AudioTrackSetUseBlend(track_idx int, enable bool)

Sets whether the track will be blended with other animations. If true, the audio playback volume changes depending on the blend value.

func (Instance) BezierTrackGetKeyInHandle 

func (self Instance) BezierTrackGetKeyInHandle(track_idx int, key_idx int) Vector2.XY

Returns the in handle of the key identified by 'key_idx'. The 'track_idx' must be the index of a Bezier Track.

func (Instance) BezierTrackGetKeyOutHandle 

func (self Instance) BezierTrackGetKeyOutHandle(track_idx int, key_idx int) Vector2.XY

Returns the out handle of the key identified by 'key_idx'. The 'track_idx' must be the index of a Bezier Track.

func (Instance) BezierTrackGetKeyValue 

func (self Instance) BezierTrackGetKeyValue(track_idx int, key_idx int) Float.X

Returns the value of the key identified by 'key_idx'. The 'track_idx' must be the index of a Bezier Track.

func (Instance) BezierTrackInsertKey 

func (self Instance) BezierTrackInsertKey(track_idx int, time Float.X, value Float.X) int

Inserts a Bezier Track key at the given 'time' in seconds. The 'track_idx' must be the index of a Bezier Track.

'in_handle' is the left-side weight of the added Bezier curve point, 'out_handle' is the right-side one, while 'value' is the actual value at this point.

func (Instance) BezierTrackInterpolate 

func (self Instance) BezierTrackInterpolate(track_idx int, time Float.X) Float.X

Returns the interpolated value at the given 'time' (in seconds). The 'track_idx' must be the index of a Bezier Track.

func (Instance) BezierTrackSetKeyInHandle 

func (self Instance) BezierTrackSetKeyInHandle(track_idx int, key_idx int, in_handle Vector2.XY)

Sets the in handle of the key identified by 'key_idx' to value 'in_handle'. The 'track_idx' must be the index of a Bezier Track.

func (Instance) BezierTrackSetKeyOutHandle 

func (self Instance) BezierTrackSetKeyOutHandle(track_idx int, key_idx int, out_handle Vector2.XY)

Sets the out handle of the key identified by 'key_idx' to value 'out_handle'. The 'track_idx' must be the index of a Bezier Track.

func (Instance) BezierTrackSetKeyValue 

func (self Instance) BezierTrackSetKeyValue(track_idx int, key_idx int, value Float.X)

Sets the value of the key identified by 'key_idx' to the given value. The 'track_idx' must be the index of a Bezier Track.

func (Instance) BlendShapeTrackInsertKey 

func (self Instance) BlendShapeTrackInsertKey(track_idx int, time Float.X, amount Float.X) int

Inserts a key in a given blend shape track. Returns the key index.

func (Instance) BlendShapeTrackInterpolate 

func (self Instance) BlendShapeTrackInterpolate(track_idx int, time_sec Float.X) Float.X

Returns the interpolated blend shape value at the given time (in seconds). The 'track_idx' must be the index of a blend shape track.

func (Instance) CaptureIncluded 

func (self Instance) CaptureIncluded() bool

func (Instance) Clear 

func (self Instance) Clear()

Clear the animation (clear all tracks and reset all).

func (Instance) Compress 

func (self Instance) Compress()

Compress the animation and all its tracks in-place. This will make Instance.TrackIsCompressed return true once called on this graphics.gd/classdb/Animation. Compressed tracks require less memory to be played, and are designed to be used for complex 3D animations (such as cutscenes) imported from external 3D software. Compression is lossy, but the difference is usually not noticeable in real world conditions.

Note: Compressed tracks have various limitations (such as not being editable from the editor), so only use compressed animations if you actually need them.

func (Instance) CopyTrack 

func (self Instance) CopyTrack(track_idx int, to_animation Instance)

Adds a new track to 'to_animation' that is a copy of the given track from this animation.

func (Instance) FindTrack 

func (self Instance) FindTrack(path string, atype TrackType) int

Returns the index of the specified track. If the track is not found, return -1.

func (Instance) GetMarkerAtTime 

func (self Instance) GetMarkerAtTime(time Float.X) string

Returns the name of the marker located at the given time.

func (Instance) GetMarkerColor 

func (self Instance) GetMarkerColor(name string) Color.RGBA

Returns the given marker's color.

func (Instance) GetMarkerNames 

func (self Instance) GetMarkerNames() []string

Returns every marker in this Animation, sorted ascending by time.

func (Instance) GetMarkerTime 

func (self Instance) GetMarkerTime(name string) Float.X

Returns the given marker's time.

func (Instance) GetNextMarker 

func (self Instance) GetNextMarker(time Float.X) string

Returns the closest marker that comes after the given time. If no such marker exists, an empty string is returned.

func (Instance) GetPrevMarker 

func (self Instance) GetPrevMarker(time Float.X) string

Returns the closest marker that comes before the given time. If no such marker exists, an empty string is returned.

func (Instance) GetTrackCount 

func (self Instance) GetTrackCount() int

Returns the amount of tracks in the animation.

func (Instance) HasMarker 

func (self Instance) HasMarker(name string) bool

Returns true if this Animation contains a marker with the given name.

func (Instance) ID 

func (self Instance) ID() ID

func (Instance) Length 

func (self Instance) Length() Float.X

func (Instance) LoopMode 

func (self Instance) LoopMode() LoopMode

func (Instance) MethodTrackGetName 

func (self Instance) MethodTrackGetName(track_idx int, key_idx int) string

Returns the method name of a method track.

func (Instance) MethodTrackGetParams 

func (self Instance) MethodTrackGetParams(track_idx int, key_idx int) []any

Returns the arguments values to be called on a method track for a given key in a given track.

func (Instance) Optimize 

func (self Instance) Optimize()

Optimize the animation and all its tracks in-place. This will preserve only as many keys as are necessary to keep the animation within the specified bounds.

func (Instance) PositionTrackInsertKey 

func (self Instance) PositionTrackInsertKey(track_idx int, time Float.X, position Vector3.XYZ) int

Inserts a key in a given 3D position track. Returns the key index.

func (Instance) PositionTrackInterpolate 

func (self Instance) PositionTrackInterpolate(track_idx int, time_sec Float.X) Vector3.XYZ

Returns the interpolated position value at the given time (in seconds). The 'track_idx' must be the index of a 3D position track.

func (Instance) RemoveMarker 

func (self Instance) RemoveMarker(name string)

Removes the marker with the given name from this Animation.

func (Instance) RemoveTrack 

func (self Instance) RemoveTrack(track_idx int)

Removes a track by specifying the track index.

func (Instance) RotationTrackInsertKey 

func (self Instance) RotationTrackInsertKey(track_idx int, time Float.X, rotation Quaternion.IJKX) int

Inserts a key in a given 3D rotation track. Returns the key index.

func (Instance) RotationTrackInterpolate 

func (self Instance) RotationTrackInterpolate(track_idx int, time_sec Float.X) Quaternion.IJKX

Returns the interpolated rotation value at the given time (in seconds). The 'track_idx' must be the index of a 3D rotation track.

func (Instance) ScaleTrackInsertKey 

func (self Instance) ScaleTrackInsertKey(track_idx int, time Float.X, scale Vector3.XYZ) int

Inserts a key in a given 3D scale track. Returns the key index.

func (Instance) ScaleTrackInterpolate 

func (self Instance) ScaleTrackInterpolate(track_idx int, time_sec Float.X) Vector3.XYZ

Returns the interpolated scale value at the given time (in seconds). The 'track_idx' must be the index of a 3D scale track.

func (Instance) SetLength 

func (self Instance) SetLength(value Float.X)

func (Instance) SetLoopMode 

func (self Instance) SetLoopMode(value LoopMode)

func (Instance) SetMarkerColor 

func (self Instance) SetMarkerColor(name string, color Color.RGBA)

Sets the given marker's color.

func (*Instance) SetObject 

func (self *Instance) SetObject(obj [1]gd.Object) bool

func (Instance) SetStep 

func (self Instance) SetStep(value Float.X)

func (Instance) Step 

func (self Instance) Step() Float.X

func (Instance) TrackFindKey 

func (self Instance) TrackFindKey(track_idx int, time Float.X) int

Finds the key index by time in a given track. Optionally, only find it if the approx/exact time is given.

If 'limit' is true, it does not return keys outside the animation range.

If 'backward' is true, the direction is reversed in methods that rely on one directional processing.

For example, in case 'find_mode' is FindModeNearest, if there is no key in the current position just after seeked, the first key found is retrieved by searching before the position, but if 'backward' is true, the first key found is retrieved after the position.

func (Instance) TrackGetInterpolationLoopWrap 

func (self Instance) TrackGetInterpolationLoopWrap(track_idx int) bool

Returns true if the track at 'track_idx' wraps the interpolation loop. New tracks wrap the interpolation loop by default.

func (Instance) TrackGetInterpolationType 

func (self Instance) TrackGetInterpolationType(track_idx int) InterpolationType

Returns the interpolation type of a given track.

func (Instance) TrackGetKeyCount 

func (self Instance) TrackGetKeyCount(track_idx int) int

Returns the number of keys in a given track.

func (Instance) TrackGetKeyTime 

func (self Instance) TrackGetKeyTime(track_idx int, key_idx int) Float.X

Returns the time at which the key is located.

func (Instance) TrackGetKeyTransition 

func (self Instance) TrackGetKeyTransition(track_idx int, key_idx int) Float.X

Returns the transition curve (easing) for a specific key (see the built-in math function [graphics.gd/classdb/@GlobalScope.Instance.Ease]).

func (Instance) TrackGetKeyValue 

func (self Instance) TrackGetKeyValue(track_idx int, key_idx int) any

Returns the value of a given key in a given track.

func (Instance) TrackGetPath 

func (self Instance) TrackGetPath(track_idx int) string

Gets the path of a track. For more information on the path format, see Instance.TrackSetPath.

func (Instance) TrackGetType 

func (self Instance) TrackGetType(track_idx int) TrackType

Gets the type of a track.

func (Instance) TrackInsertKey 

func (self Instance) TrackInsertKey(track_idx int, time Float.X, key any) int

Inserts a generic key in a given track. Returns the key index.

func (Instance) TrackIsCompressed 

func (self Instance) TrackIsCompressed(track_idx int) bool

Returns true if the track is compressed, false otherwise. See also Instance.Compress.

func (Instance) TrackIsEnabled 

func (self Instance) TrackIsEnabled(track_idx int) bool

Returns true if the track at index 'track_idx' is enabled.

func (Instance) TrackIsImported 

func (self Instance) TrackIsImported(track_idx int) bool

Returns true if the given track is imported. Else, return false.

func (Instance) TrackMoveDown 

func (self Instance) TrackMoveDown(track_idx int)

Moves a track down.

func (Instance) TrackMoveTo 

func (self Instance) TrackMoveTo(track_idx int, to_idx int)

Changes the index position of track 'track_idx' to the one defined in 'to_idx'.

func (Instance) TrackMoveUp 

func (self Instance) TrackMoveUp(track_idx int)

Moves a track up.

func (Instance) TrackRemoveKey 

func (self Instance) TrackRemoveKey(track_idx int, key_idx int)

Removes a key by index in a given track.

func (Instance) TrackRemoveKeyAtTime 

func (self Instance) TrackRemoveKeyAtTime(track_idx int, time Float.X)

Removes a key at 'time' in a given track.

func (Instance) TrackSetEnabled 

func (self Instance) TrackSetEnabled(track_idx int, enabled bool)

Enables/disables the given track. Tracks are enabled by default.

func (Instance) TrackSetImported 

func (self Instance) TrackSetImported(track_idx int, imported bool)

Sets the given track as imported or not.

func (Instance) TrackSetInterpolationLoopWrap 

func (self Instance) TrackSetInterpolationLoopWrap(track_idx int, interpolation bool)

If true, the track at 'track_idx' wraps the interpolation loop.

func (Instance) TrackSetInterpolationType 

func (self Instance) TrackSetInterpolationType(track_idx int, interpolation InterpolationType)

Sets the interpolation type of a given track.

func (Instance) TrackSetKeyTime 

func (self Instance) TrackSetKeyTime(track_idx int, key_idx int, time Float.X)

Sets the time of an existing key.

func (Instance) TrackSetKeyTransition 

func (self Instance) TrackSetKeyTransition(track_idx int, key_idx int, transition Float.X)

Sets the transition curve (easing) for a specific key (see the built-in math function [graphics.gd/classdb/@GlobalScope.Instance.Ease]).

func (Instance) TrackSetKeyValue 

func (self Instance) TrackSetKeyValue(track_idx int, key int, value any)

Sets the value of an existing key.

func (Instance) TrackSetPath 

func (self Instance) TrackSetPath(track_idx int, path string)

Sets the path of a track. Paths must be valid scene-tree paths to a node and must be specified starting from the graphics.gd/classdb/AnimationMixer.Instance.RootNode that will reproduce the animation. Tracks that control properties or bones must append their name after the path, separated by ":".

For example, "character/skeleton:ankle" or "character/mesh:transform/local".

func (Instance) TrackSwap 

func (self Instance) TrackSwap(track_idx int, with_idx int)

Swaps the track 'track_idx”s index position with the track 'with_idx'.

func (Instance) ValueTrackGetUpdateMode 

func (self Instance) ValueTrackGetUpdateMode(track_idx int) UpdateMode

Returns the update mode of a value track.

func (Instance) ValueTrackInterpolate 

func (self Instance) ValueTrackInterpolate(track_idx int, time_sec Float.X) any

Returns the interpolated value at the given time (in seconds). The 'track_idx' must be the index of a value track.

A 'backward' mainly affects the direction of key retrieval of the track with UpdateDiscrete converted by [Animationmixer.AnimationCallbackModeDiscreteForceContinuous] to match the result with Instance.TrackFindKey.

func (Instance) ValueTrackSetUpdateMode 

func (self Instance) ValueTrackSetUpdateMode(track_idx int, mode UpdateMode)

Sets the update mode (see UpdateMode) of a value track.

func (Instance) Virtual 

func (self Instance) Virtual(name string) reflect.Value

type InterpolationType 

type InterpolationType int //gd:Animation.InterpolationType

const (
	// No interpolation (nearest value).
	InterpolationNearest InterpolationType = 0
	// Linear interpolation.
	InterpolationLinear InterpolationType = 1
	// Cubic interpolation. This looks smoother than linear interpolation, but is more expensive to interpolate. Stick to [InterpolationLinear] for complex 3D animations imported from external software, even if it requires using a higher animation framerate in return.
	InterpolationCubic InterpolationType = 2
	// Linear interpolation with shortest path rotation.
	//
	// Note: The result value is always normalized and may not match the key value.
	InterpolationLinearAngle InterpolationType = 3
	// Cubic interpolation with shortest path rotation.
	//
	// Note: The result value is always normalized and may not match the key value.
	InterpolationCubicAngle InterpolationType = 4
)

type LoopMode 

type LoopMode int //gd:Animation.LoopMode

const (
	// At both ends of the animation, the animation will stop playing.
	LoopNone LoopMode = 0
	// At both ends of the animation, the animation will be repeated without changing the playback direction.
	LoopLinear LoopMode = 1
	// Repeats playback and reverse playback at both ends of the animation.
	LoopPingpong LoopMode = 2
)

type LoopedFlag 

type LoopedFlag int //gd:Animation.LoopedFlag

const (
	// This flag indicates that the animation proceeds without any looping.
	LoopedFlagNone LoopedFlag = 0
	// This flag indicates that the animation has reached the end of the animation and just after loop processed.
	LoopedFlagEnd LoopedFlag = 1
	// This flag indicates that the animation has reached the start of the animation and just after loop processed.
	LoopedFlagStart LoopedFlag = 2
)

type TrackType 

type TrackType int //gd:Animation.TrackType

const (
	// Value tracks set values in node properties, but only those which can be interpolated. For 3D position/rotation/scale, using the dedicated [TypePosition3d], [TypeRotation3d] and [TypeScale3d] track types instead of [TypeValue] is recommended for performance reasons.
	TypeValue TrackType = 0
	// 3D position track (values are stored in [Vector3.XYZ]s).
	TypePosition3d TrackType = 1
	// 3D rotation track (values are stored in [Quaternion.IJKX]s).
	TypeRotation3d TrackType = 2
	// 3D scale track (values are stored in [Vector3.XYZ]s).
	TypeScale3d TrackType = 3
	// Blend shape track.
	TypeBlendShape TrackType = 4
	// Method tracks call functions with given arguments per key.
	TypeMethod TrackType = 5
	// Bezier tracks are used to interpolate a value using custom curves. They can also be used to animate sub-properties of vectors and colors (e.g. alpha value of a [Color.RGBA]).
	TypeBezier TrackType = 6
	// Audio tracks are used to play an audio stream with either type of [graphics.gd/classdb/AudioStreamPlayer]. The stream can be trimmed and previewed in the animation.
	TypeAudio TrackType = 7
	// Animation tracks play animations in other [graphics.gd/classdb/AnimationPlayer] nodes.
	TypeAnimation TrackType = 8
)

type UpdateMode 

type UpdateMode int //gd:Animation.UpdateMode

const (
	// Update between keyframes and hold the value.
	UpdateContinuous UpdateMode = 0
	// Update at the keyframes.
	UpdateDiscrete UpdateMode = 1
	// Same as [UpdateContinuous] but works as a flag to capture the value of the current object and perform interpolation in some methods. See also [graphics.gd/classdb/AnimationMixer.Instance.Capture], [graphics.gd/classdb/AnimationPlayer.Instance.PlaybackAutoCapture], and [graphics.gd/classdb/AnimationPlayer.Instance.PlayWithCapture].
	UpdateCapture UpdateMode = 2
)

Source Files

View all Source files

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.