You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
170 lines
6.6 KiB
170 lines
6.6 KiB
/*==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 "hsTypes.h" // need for plSingleModifier |
|
#include "pnModifier/plSingleModifier.h" // inherited |
|
|
|
// local |
|
#include "plAvatar/plScalarChannel.h" |
|
|
|
// stl |
|
#include "hsStlUtils.h" |
|
#include "hsStlSortUtils.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 char *name, hsBool 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. */ |
|
const char * 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(char * name); |
|
|
|
/** Attach a TRACKED_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. */ |
|
hsBool 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(hsBool 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 |
|
|
|
char *fChannelName; // name used for matching animation channels to this modifier |
|
hsBool fAutoApply; // evaluate animation automatically during IEval call |
|
hsBool fEnabled; // if not enabled, we don't eval any of our anims |
|
|
|
// APPLYING THE ANIMATION |
|
virtual hsBool IEval(double secs, hsScalar del, UInt32 dirty); |
|
|
|
virtual hsBool 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 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 classIdx) const; |
|
|
|
}; |
|
const plModifier * FindModifierByClass(const plSceneObject *obj, int classID); |
|
|
|
|
|
#endif |
|
|
|
|