Class AnimationSprite

Describes and controls and animation by yielding mutators according to the stored AnimationStructure and AnimationSequences Applied to a Node directly via script or ComponentAnimator.

Author

Lukas Scheuerle, HFU, 21019 | Jirka Dell'Oro-Friedl, HFU, 2021-2023

Hierarchy (view full)

Animation
- AnimationSprite

Constructors

constructor

new AnimationSprite(_name?): AnimationSprite
Parameters
- _name: string = "AnimationSprite"
Returns AnimationSprite
Overrides Animation.constructor
- Defined in Core/Source/Animation/AnimationSprite.ts:14

Properties

animationStructure

animationStructure: AnimationStructure

events

events: AnimationEventTrigger = {}

idResource

idResource: string = undefined

labels

labels: AnimationLabel = {}

name

name: string

texture

texture: Texture = TextureDefault.color

totalTime

totalTime: number = 0

`Static` `Readonly` iSubclass

iSubclass: number = ...

`Static` `Readonly` subclasses

subclasses: typeof Animation[] = []

Accessors

fps

get fps(): number
Returns number
Inherited from Animation.fps
- Defined in Core/Source/Animation/Animation.ts:132
set fps(_fps): void
Parameters
- _fps: number
Returns void
Inherited from Animation.fps
- Defined in Core/Source/Animation/Animation.ts:136

getLabels

get getLabels(): Enumerator<any>
Returns Enumerator<any>
Inherited from Animation.getLabels
- Defined in Core/Source/Animation/Animation.ts:126

type

get type(): string
Retrieves the type of this mutable subclass as the name of the runtime class

Returns string
The type of the mutable
Inherited from Animation.type
- Defined in Core/Source/Serialization/Mutable.ts:73

Methods

addEventListener

addEventListener(_type, _handler, _options?): void
See EventTarget.addEventListener for reference. Works with EventListenerUnified and EventUnified
Parameters
- _type: string
- _handler: EventListenerUnified
- Optional _options: boolean | AddEventListenerOptions
Returns void
Inherited from Animation.addEventListener
- Defined in Core/Source/Event/Event.ts:91

calculateDirection

calculateDirection(_time, _playmode): number
Calculates and returns the direction the animation should currently be playing in.
Parameters
- _time: number
  the time at which to calculate the direction
- _playmode: ANIMATION_PLAYMODE
Returns number
1 if forward, 0 if stop, -1 if backwards
Inherited from Animation.calculateDirection
- Defined in Core/Source/Animation/Animation.ts:246

calculateTotalTime

calculateTotalTime(): void
(Re-)Calculate the total time of the Animation. Calculation-heavy, use only if actually needed.

Returns void
Inherited from Animation.calculateTotalTime
- Defined in Core/Source/Animation/Animation.ts:215

clearCache

clearCache(): void
Clear this animations cache.

Returns void
Inherited from Animation.clearCache
- Defined in Core/Source/Animation/Animation.ts:145

convertToAnimation

convertToAnimation(): Animation
Converts the AnimationSprite into an Animation

Returns Animation
- Defined in Core/Source/Animation/AnimationSprite.ts:150

create

create(_texture, _frames, _wrapAfter, _start, _size, _next, _wrap, _framesPerSecond): void
Creates this animation sprite from the given arguments
Parameters
- _texture: Texture
- _frames: number
- _wrapAfter: number
- _start: Vector2
- _size: Vector2
- _next: Vector2
- _wrap: Vector2
- _framesPerSecond: number
Returns void
- Defined in Core/Source/Animation/AnimationSprite.ts:31

deserialize

deserialize(_s): Promise<Serializable>
Recreates this instance of Serializable with the information from the given Serialization.
Parameters
- _s: Serialization
Returns Promise<Serializable>
Overrides Animation.deserialize
- Defined in Core/Source/Animation/AnimationSprite.ts:133

dispatchEvent

dispatchEvent(_event): boolean
See EventTarget.dispatchEvent for reference. Works with with EventUnified
Parameters
- _event: EventUnified
Returns boolean
Inherited from Animation.dispatchEvent
- Defined in Core/Source/Event/Event.ts:105

getEventsToFire

getEventsToFire(_min, _max, _quantization, _direction): string[]
Returns a list of the names of the events the ComponentAnimator needs to fire between _min and _max input values.
Parameters
- _min: number
- _max: number
- _quantization: ANIMATION_QUANTIZATION
- _direction: number
  The direction the animation is supposed to run in. >0 == forward, 0 == stop, <0 == backwards
Returns string[]
a list of strings with the names of the custom events to fire.
Inherited from Animation.getEventsToFire
- Defined in Core/Source/Animation/Animation.ts:171

getModalTime

getModalTime(_time, _playmode, _timeStop?): number
Returns the time to use for animation sampling when applying a playmode
Parameters
- _time: number
- _playmode: ANIMATION_PLAYMODE
- _timeStop: number = _time
Returns number
Inherited from Animation.getModalTime
- Defined in Core/Source/Animation/Animation.ts:225

getMutator

getMutator(_extendable?): Mutator
Collect applicable attributes of the instance and copies of their values in a Mutator-object. By default, a mutator cannot be extended, since extensions are not available in the object the mutator belongs to. A mutator may be reduced by the descendants of Mutable to contain only the properties needed.
Parameters
- _extendable: boolean = false
Returns Mutator
Inherited from Animation.getMutator
- Defined in Core/Source/Serialization/Mutable.ts:81

getMutatorAttributeTypes

getMutatorAttributeTypes(_mutator): MutatorAttributeTypes
Returns an associative array with the same attributes as the given mutator, but with the corresponding types as string-values Does not recurse into objects!
Parameters
- _mutator: Mutator
Returns MutatorAttributeTypes
Inherited from Animation.getMutatorAttributeTypes
- Defined in Core/Source/Serialization/Mutable.ts:137

getMutatorForAnimation

getMutatorForAnimation(): MutatorForAnimation
Collect the attributes of the instance and their values applicable for animation. Basic functionality is identical to getMutator, returned mutator should then be reduced by the subclassed instance

Returns MutatorForAnimation
Inherited from Animation.getMutatorForAnimation
- Defined in Core/Source/Serialization/Mutable.ts:116

getMutatorForUserInterface

getMutatorForUserInterface(): MutatorForUserInterface
Collect the attributes of the instance and their values applicable for the user interface. Basic functionality is identical to getMutator, returned mutator should then be reduced by the subclassed instance

Returns MutatorForUserInterface
Inherited from Animation.getMutatorForUserInterface
- Defined in Core/Source/Serialization/Mutable.ts:123

getPositions

getPositions(): Vector2[]
Returns the positions of the spritesheet

Returns Vector2[]
- Defined in Core/Source/Animation/AnimationSprite.ts:91

getScale

getScale(): Vector2
Returns the scale of the spritesheet

Returns Vector2
- Defined in Core/Source/Animation/AnimationSprite.ts:81

getState

getState(_time, _direction, _quantization): Mutator
Generates and returns a Mutator with the information to apply to the Node to animate in the state the animation is in at the given time, direction and quantization
Parameters
- _time: number
- _direction: number
- _quantization: ANIMATION_QUANTIZATION
Returns Mutator
Inherited from Animation.getState
- Defined in Core/Source/Animation/Animation.ts:153

mutate

mutate(_mutator, _selection?, _dispatchMutate?): Promise<void>
Updates the attribute values of the instance according to the state of the mutator. The mutation may be restricted to a subset of the mutator and the event dispatching suppressed. Uses mutateBase, but can be overwritten in subclasses
Parameters
- _mutator: Mutator
- Optional _selection: string[]
- Optional _dispatchMutate: boolean
Returns Promise<void>
Overrides Animation.mutate
- Defined in Core/Source/Animation/AnimationSprite.ts:111

removeEvent

removeEvent(_name): void
Removes the event with the given name from the list of events.
Parameters
- _name: string
  name of the event to remove.
Returns void
Inherited from Animation.removeEvent
- Defined in Core/Source/Animation/Animation.ts:206

removeEventListener

removeEventListener(_type, _handler, _options?): void
See EventTarget.removeEventListener for reference. Works with EventListenerUnified and EventUnified
Parameters
- _type: string
- _handler: EventListenerUnified
- Optional _options: boolean | AddEventListenerOptions
Returns void
Inherited from Animation.removeEventListener
- Defined in Core/Source/Event/Event.ts:98

serialize

serialize(): Serialization
Returns a Serialization of this object.

Returns Serialization
Overrides Animation.serialize
- Defined in Core/Source/Animation/AnimationSprite.ts:116

setEvent

setEvent(_name, _time): void
Adds an Event to the List of events.
Parameters
- _name: string
  The name of the event (needs to be unique per Animation).
- _time: number
  The timestamp of the event (in milliseconds).
Returns void
Inherited from Animation.setEvent
- Defined in Core/Source/Animation/Animation.ts:197

setTexture

setTexture(_texture): void
Sets the texture to be used as the spritesheet
Parameters
- _texture: Texture
Returns void
- Defined in Core/Source/Animation/AnimationSprite.ts:23

updateMutator

updateMutator(_mutator): void
Updates the values of the given mutator according to the current state of the instance
Parameters
- _mutator: Mutator
Returns void
Inherited from Animation.updateMutator
- Defined in Core/Source/Serialization/Mutable.ts:157

`Static` getMutatorFromPath

getMutatorFromPath(_mutator, _path): Mutator
Decorator allows to attach Mutable functionality to existing classes.
Parameters
- _mutator: Mutator
- _path: string[]
Returns Mutator
Inherited from Animation.getMutatorFromPath
- Defined in Core/Source/Serialization/Mutable.ts:58

Class AnimationSprite

Author

Hierarchy (view full)

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns AnimationSprite

Properties

animationStructure

events

idResource

labels

name

texture

totalTime

Static Readonly iSubclass

Static Readonly subclasses

Accessors

fps

Returns number

Parameters

Returns void

getLabels

Returns Enumerator<any>

type

Returns string

Methods

addEventListener

Parameters

Returns void

calculateDirection

Parameters

Returns number

calculateTotalTime

Returns void

clearCache

Returns void

convertToAnimation

Returns Animation

create

Parameters

Returns void

deserialize

Parameters

Returns Promise<Serializable>

dispatchEvent

Parameters

Returns boolean

getEventsToFire

Parameters

Returns string[]

getModalTime

Parameters

Returns number

getMutator

Parameters

Returns Mutator

getMutatorAttributeTypes

Parameters

Returns MutatorAttributeTypes

getMutatorForAnimation

Returns MutatorForAnimation

getMutatorForUserInterface

Returns MutatorForUserInterface

getPositions

Returns Vector2[]

getScale

Returns Vector2

getState

Parameters

Returns Mutator

mutate

Parameters

Returns Promise<void>

removeEvent

`Static` `Readonly` iSubclass

`Static` `Readonly` subclasses

`Static` getMutatorFromPath