////////////////////////////////////////////////////////////////////////////////////////////////////
// NoesisGUI - http://www.noesisengine.com
// Copyright (c) 2013 Noesis Technologies S.L. All Rights Reserved.
////////////////////////////////////////////////////////////////////////////////////////////////////


#ifndef __GUI_DISCRETEINT16KEYFRAME_H__
#define __GUI_DISCRETEINT16KEYFRAME_H__


#include <NsCore/Noesis.h>
#include <NsCore/ReflectionDeclare.h>
#include <NsGui/Int16KeyFrame.h>
#include <NsGui/AnimationApi.h>


namespace Noesis
{

////////////////////////////////////////////////////////////////////////////////////////////////////
/// Animates from the *Int16* value of the previous key frame to its own *Value* using discrete
/// interpolation.
/// This class is used as part of a Int16KeyFrameCollection in conjunction with a
/// Int16AnimationUsingKeyFrames to animate a Int16 property value along a set of key frames.
///
/// A key frame defines a segment of the Int16AnimationUsingKeyFrames to which it belongs. Each key
/// frame has a target Value and a KeyTime. The KeyTime specifies the time at which the key frame's
/// Value should be reached. A key frame animates from the target value of the previous key frame to
/// its own target value. It starts when the previous key frame ends and ends when its own key time
/// is reached.
///
/// Discrete key frames like DiscreteInt16KeyFrame create sudden "jumps" between values (no
/// interpolation). In other words, the animated property does not change until the key frame's key
/// time is reached, at which point the animated property goes suddenly to the target value.
///
/// http://msdn.microsoft.com/en-us/library/system.windows.media.animation.discreteint16keyframe.aspx
////////////////////////////////////////////////////////////////////////////////////////////////////
class NS_GUI_ANIMATION_API DiscreteInt16KeyFrame final: public Int16KeyFrame
{
public:
    // Hides Freezable methods for convenience
    //@{
    Ptr<DiscreteInt16KeyFrame> Clone() const;
    Ptr<DiscreteInt16KeyFrame> CloneCurrentValue() const;
    //@}

protected:
    /// From Freezable
    //@{
    Ptr<Freezable> CreateInstanceCore() const override;
    //@}

    /// From KeyFrame
    //@{
    int16_t InterpolateValueCore(int16_t baseValue, float keyFrameProgress) override;
    //@}

    NS_DECLARE_REFLECTION(DiscreteInt16KeyFrame, Int16KeyFrame)
};

}


#endif