CWE-ou-minkata/Sources/Plasma/PubUtilLib/plAnimation/plAGModifier.h

/*==LICENSE==*

CyanWorlds.com Engine - MMOG client, server and tools
Copyright (C) 2011  Cyan Worlds, Inc.

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <http://www.gnu.org/licenses/>.

Additional permissions under GNU GPL version 3 section 7

If you modify this Program, or any covered work, by linking or
combining it with any of RAD Game Tools Bink SDK, Autodesk 3ds Max SDK,
NVIDIA PhysX SDK, Microsoft DirectX SDK, OpenSSL library, Independent
JPEG Group JPEG library, Microsoft Windows Media SDK, or Apple QuickTime SDK
(or a modified version of those libraries),
containing parts covered by the terms of the Bink SDK EULA, 3ds Max EULA,
PhysX SDK EULA, DirectX SDK EULA, OpenSSL and SSLeay licenses, IJG
JPEG Library README, Windows Media SDK EULA, or QuickTime SDK EULA, the
licensors of this Program grant you additional
permission to convey the resulting work. Corresponding Source for a
non-source form of such a combination shall include the source code for
the parts of OpenSSL and IJG JPEG Library used as well as that of the covered
work.

You can contact Cyan Worlds, Inc. by email legal@cyan.com
 or by snail mail at:
      Cyan Worlds, Inc.
      14617 N Newport Hwy
      Mead, WA   99021

*==LICENSE==*/
/** \file plAGMasterMod.h

    \ingroup Avatar
    \ingroup AniGraph
*/
#ifndef PLAGMODIFIER_H
#define PLAGMODIFIER_H

#include "HeadSpin.h"                            // need for plSingleModifier
#include "pnModifier/plSingleModifier.h"        // inherited

// local
#include "plScalarChannel.h"

class plSceneObject;

class plAGAnimInstance;
class plAGAnim;
class plAvatarAnim;
class plAnimCmdMsg;
class plOneShotCallbacks;

///////////////
//
// PLAGMODIFIER
//
///////////////
/** \class plAGModifier
    Animates a single scene object.
    May apply multiple animations to that scene object, animating
    the transform with one, colors with another, etc.
    The basic model is that the ag modifier holds an array of
    applicators, each of which is the root of a tree of animation
    operations, such as a blend tree, etc. Each frame it fires
    all its applicators, or (ideally) only those that need to be fired.
    */
class plAGModifier : public plSingleModifier
{
public:
    /** Default constructor, primarily for the class factory. */
    plAGModifier();

    /** Construct given a name. This name will be used to match up 
        incoming channels with this modifier. You may also supply an
        autoApply parameter, which indicates whether this modifier
        should apply itself every frame, or only when explicitly asked to. */
    plAGModifier(const plString &name, bool autoApply = true);

    /** It's a destructor. Destroys the name passed into the constructor,
        and a bunch of other stuff you don't need to know anything about. */
    virtual ~plAGModifier();

    /** Get the name of the channel controlled by this modifier. */
    plString GetChannelName() const;
    /** Change the channel name of the modifier. Will delete the previous
        name. Will NOT remove any channels that are already attached, so 
        you could wind up with a modifier named "Fred" and a bunch of
        channels attached to it that were intended for "Lamont." */
    void SetChannelName(const plString & name);

    /** Attach a new applicator to our modifier. Will arbitrate with existing
        modifiers if necessary, based on pin type. May destruct existing applicators. */
    plAGChannel *MergeChannel(plAGApplicator *app, plAGChannel *chan, plScalarChannel *blend,
                              plAGAnimInstance *anim, int priority);
    /** Remove the given channel. Will also remove the channel's applicator. */
    bool DetachChannel(plAGChannel * channel);

    /** Set the applicator for a modifier.
        \deprecated */
    void SetApplicator(plAGApplicator *app);
    /** Get the applicator for a given pintype. Note that an ag modifier can
        only have one applicator of a given pin type attached at a time.
        The exception is for the unknown pin type, which never conflicts
        with any other pin type, including itself. */
    plAGApplicator *GetApplicator(plAGPinType pin) const;

    /** Apply the animation for our scene object. */
    void Apply(double time) const;

    /** Get the channel tied to our ith applicator */
    plAGChannel * GetChannel(int i) { return fApps[i]->GetChannel(); }

    void Enable(bool val);

    // PERSISTENCE
    virtual void Read(hsStream *stream, hsResMgr *mgr);
    virtual void Write(hsStream *stream, hsResMgr *mgr);

    // PLASMA PROTOCOL
    CLASSNAME_REGISTER( plAGModifier );
    GETINTERFACE_ANY( plAGModifier, plSingleModifier );
    
protected:
    typedef std::vector<plAGApplicator*> plAppTable;
    plAppTable fApps;           // the applicators (with respective channels) that we're applying to our scene object

    plString fChannelName;      // name used for matching animation channels to this modifier
    bool     fAutoApply;        // evaluate animation automatically during IEval call
    bool     fEnabled;          // if not enabled, we don't eval any of our anims

    // APPLYING THE ANIMATION
    virtual bool IEval(double secs, float del, uint32_t dirty);

    virtual bool IHandleCmd(plAnimCmdMsg* modMsg) { return false; } // only plAGMasterMod should handle these
    virtual void IApplyDynamic() {};    // dummy function required by base class

    // INTERNAL ACCESSORS FOR SCENE OBJECT INTERFACES
    plAudioInterface * LeakAI() const { return IGetTargetAudioInterface(0); };
    plCoordinateInterface * LeakCI() const { return IGetTargetCoordinateInterface(0); };
    plDrawInterface * LeakDI() const { return IGetTargetDrawInterface(0); };
    plSimulationInterface * LeakSI() const { return IGetTargetSimulationInterface(0); };
    plObjInterface * LeakGI(uint32_t classIdx) const { return IGetTargetGenericInterface(0, classIdx); }

    friend plAudioInterface * plAGApplicator::IGetAI(const plAGModifier * modifier) const;
    friend plCoordinateInterface * plAGApplicator::IGetCI(const plAGModifier * modifier) const;
    friend plDrawInterface * plAGApplicator::IGetDI(const plAGModifier * modifier) const;
    friend plSimulationInterface * plAGApplicator::IGetSI(const plAGModifier * modifier) const;
    friend plObjInterface * plAGApplicator::IGetGI(const plAGModifier * modifier, uint16_t classIdx) const;

};
const plModifier * FindModifierByClass(const plSceneObject *obj, int classID);


#endif