g3n-engine/animation/animation.go

// Copyright 2016 The G3N Authors. All rights reserved.
// Use of this source code is governed by a BSD-style
// license that can be found in the LICENSE file.

// Package animation
package animation

// Animation is a keyframe animation, containing channels.
// Each channel animates a specific property of an object.
// Animations can span multiple objects and properties.
type Animation struct {
	name     string     // Animation name
	loop     bool       // Whether the animation loops
	paused   bool       // Whether the animation is paused
	start    float32    // Initial time offset value
	time     float32    // Total running time
	minTime  float32    // Minimum time value across all channels
	maxTime  float32    // Maximum time value across all channels
	channels []IChannel // List of channels
}

// NewAnimation creates and returns a pointer to a new Animation object.
func NewAnimation() *Animation {

	anim := new(Animation)
	return anim
}

// SetName sets the animation name.
func (anim *Animation) SetName(name string) {

	anim.name = name
}

// Name returns the animation name.
func (anim *Animation) Name() string {

	return anim.name
}

// Reset resets the animation to the beginning.
func (anim *Animation) Reset() {

	anim.time = anim.start
}

// SetPaused sets whether the animation is paused.
func (anim *Animation) SetPaused(state bool) {

	anim.paused = state
}

// Paused returns whether the animation is paused.
func (anim *Animation) Paused() bool {

	return anim.paused
}

// SetLoop sets whether the animation is looping.
func (anim *Animation) SetLoop(state bool) {

	anim.loop = state
}

// Loop returns whether the animation is looping.
func (anim *Animation) Loop() bool {

	return anim.loop
}

// SetStart sets the initial time offset value.
func (anim *Animation) SetStart(v float32) {

	anim.start = v
}

// Update interpolates and updates the target values for each channel.
// If the animation is paused, returns false. If the animation is not paused,
// returns true if the input value is inside the key frames ranges or false otherwise.
func (anim *Animation) Update(delta float32) bool {

	// Check if paused
	if anim.paused {
		return false
	}

	// Check if input is less than minimum
	anim.time = anim.time + delta
	if anim.time < anim.minTime {
		return false
	}

	// Check if input is greater than maximum
	if anim.time > anim.maxTime {
		if anim.loop {
			anim.Reset()
		} else {
			return false
		}
	}

	// Update all channels
	for i := 0; i < len(anim.channels); i++ {
		ch := anim.channels[i]
		ch.Update(anim.time)
	}

	return true
}

// AddChannel adds a channel to the animation.
func (anim *Animation) AddChannel(ch IChannel) {

	// TODO (maybe) prevent user from adding two channels of the same type that share target ?

	// Add the channel
	anim.channels = append(anim.channels, ch)

	// Update maxTime and minTime values
	kf := ch.Keyframes()
	firstKf := kf[0]
	if anim.minTime > firstKf {
		anim.minTime = firstKf
	}
	lastKf := kf[len(kf)-1]
	if anim.maxTime < lastKf {
		anim.maxTime = lastKf
	}
}