SpriteFrames

package
v0.0.0-...-0d6c339 Latest Latest
Warning

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

Go to latest
Published: Sep 16, 2025 License: MIT Imports: 24 Imported by: 0

Documentation

Overview

Sprite frame library for an graphics.gd/classdb/AnimatedSprite2D or graphics.gd/classdb/AnimatedSprite3D node. Contains frames and animation data for playback.

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
	AsSpriteFrames() Instance
}

type Expanded

type Expanded [1]gdclass.SpriteFrames

func (Expanded) AddFrame

func (self Expanded) AddFrame(anim string, texture Texture2D.Instance, duration Float.X, at_position int)

Adds a frame to the 'anim' animation. If 'at_position' is -1, the frame will be added to the end of the animation. 'duration' specifies the relative duration, see Instance.GetFrameDuration for details.

func (Expanded) SetFrame

func (self Expanded) SetFrame(anim string, idx int, texture Texture2D.Instance, duration Float.X)

Sets the 'texture' and the 'duration' of the frame 'idx' in the 'anim' animation. 'duration' specifies the relative duration, see Instance.GetFrameDuration for details.

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]) 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

func (*Extension[T]) AsSpriteFrames

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

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.SpriteFrames

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) AddAnimation

func (self Instance) AddAnimation(anim string)

Adds a new 'anim' animation to the library.

func (Instance) AddFrame

func (self Instance) AddFrame(anim string, texture Texture2D.Instance)

Adds a frame to the 'anim' animation. If 'at_position' is -1, the frame will be added to the end of the animation. 'duration' specifies the relative duration, see Instance.GetFrameDuration for details.

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) AsSpriteFrames

func (self Instance) AsSpriteFrames() Instance

func (Instance) Clear

func (self Instance) Clear(anim string)

Removes all frames from the 'anim' animation.

func (Instance) ClearAll

func (self Instance) ClearAll()

Removes all animations. An empty default animation will be created.

func (Instance) DuplicateAnimation

func (self Instance) DuplicateAnimation(anim_from string, anim_to string)

Duplicates the animation 'anim_from' to a new animation named 'anim_to'. Fails if 'anim_to' already exists, or if 'anim_from' does not exist.

func (Instance) GetAnimationLoop

func (self Instance) GetAnimationLoop(anim string) bool

Returns true if the given animation is configured to loop when it finishes playing. Otherwise, returns false.

func (Instance) GetAnimationNames

func (self Instance) GetAnimationNames() []string

Returns an array containing the names associated to each animation. Values are placed in alphabetical order.

func (Instance) GetAnimationSpeed

func (self Instance) GetAnimationSpeed(anim string) Float.X

Returns the speed in frames per second for the 'anim' animation.

func (Instance) GetFrameCount

func (self Instance) GetFrameCount(anim string) int

Returns the number of frames for the 'anim' animation.

func (Instance) GetFrameDuration

func (self Instance) GetFrameDuration(anim string, idx int) Float.X

Returns a relative duration of the frame 'idx' in the 'anim' animation (defaults to 1.0). For example, a frame with a duration of 2.0 is displayed twice as long as a frame with a duration of 1.0. You can calculate the absolute duration (in seconds) of a frame using the following formula:

In this example, playing_speed refers to either graphics.gd/classdb/AnimatedSprite2D.Instance.GetPlayingSpeed or graphics.gd/classdb/AnimatedSprite3D.Instance.GetPlayingSpeed.

func (Instance) GetFrameTexture

func (self Instance) GetFrameTexture(anim string, idx int) Texture2D.Instance

Returns the texture of the frame 'idx' in the 'anim' animation.

func (Instance) HasAnimation

func (self Instance) HasAnimation(anim string) bool

Returns true if the 'anim' animation exists.

func (Instance) ID

func (self Instance) ID() ID

func (Instance) RemoveAnimation

func (self Instance) RemoveAnimation(anim string)

Removes the 'anim' animation.

func (Instance) RemoveFrame

func (self Instance) RemoveFrame(anim string, idx int)

Removes the 'anim' animation's frame 'idx'.

func (Instance) RenameAnimation

func (self Instance) RenameAnimation(anim string, newname string)

Changes the 'anim' animation's name to 'newname'.

func (Instance) SetAnimationLoop

func (self Instance) SetAnimationLoop(anim string, loop bool)

If 'loop' is true, the 'anim' animation will loop when it reaches the end, or the start if it is played in reverse.

func (Instance) SetAnimationSpeed

func (self Instance) SetAnimationSpeed(anim string, fps Float.X)

Sets the speed for the 'anim' animation in frames per second.

func (Instance) SetFrame

func (self Instance) SetFrame(anim string, idx int, texture Texture2D.Instance)

Sets the 'texture' and the 'duration' of the frame 'idx' in the 'anim' animation. 'duration' specifies the relative duration, see Instance.GetFrameDuration for details.

func (*Instance) SetObject

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

func (Instance) Virtual

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

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL