#if !defined(FX_UTIL_H_INC) #include "FxUtil.h" #endif #if defined( CHC ) #if !defined(FX_PARSING_H_INC) #include "FxParsing.h" #endif #elif defined( EFFECTSED ) #include "GenericParser2.h" #include "FxUnparse.h" #else #if !defined(GENERICPARSER2_H_INC) #include "../qcommon/GenericParser2.h" #endif #endif #ifndef FX_SCHEDULER_H_INC #define FX_SCHEDULER_H_INC #pragma warning (push, 3) //go back down to 3 for the stl include #include #include #include #include #pragma warning (pop) using namespace std; #define FX_FILE_PATH "effects" #ifdef CHC #define FX_MAX_TRACE_DIST WORLD_SIZE #else #define FX_MAX_TRACE_DIST 16384 // SOF2 uses a larger scale #endif #define FX_MAX_EFFECTS 128 // how many effects the system can store #define FX_MAX_EFFECT_COMPONENTS 24 // how many primitives an effect can hold, this should be plenty #define FX_MAX_PRIM_NAME 32 //----------------------------------------------- // These are spawn flags for primitiveTemplates //----------------------------------------------- #define FX_ORG_ON_SPHERE 0x0001 // Pretty dang expensive, calculates a point on a sphere/ellipsoid #define FX_AXIS_FROM_SPHERE 0x0002 // Can be used in conjunction with org_on_sphere to cause particles to move out // from the center of the sphere #define FX_ORG_ON_CYLINDER 0x0004 // calculate point on cylinder/disk #define FX_ORG2_FROM_TRACE 0x0010 #define FX_TRACE_IMPACT_FX 0x0020 // if trace impacts, we should play one of the specified impact fx files #define FX_ORG2_IS_OFFSET 0x0040 // template specified org2 should be the offset from a trace endpos or // passed in org2. You might use this to lend a random flair to the endpos. // Note: this is done pre-trace, so you may have to specify large numbers for this #define FX_CHEAP_ORG_CALC 0x0100 // Origin is calculated relative to passed in axis unless this is on. #define FX_CHEAP_ORG2_CALC 0x0200 // Origin2 is calculated relative to passed in axis unless this is on. #define FX_VEL_IS_ABSOLUTE 0x0400 // Velocity isn't relative to passed in axis with this flag on. #define FX_ACCEL_IS_ABSOLUTE 0x0800 // Acceleration isn't relative to passed in axis with this flag on. #define FX_RAND_ROT_AROUND_FWD 0x1000 // Randomly rotates up and right around forward vector #define FX_EVEN_DISTRIBUTION 0x2000 // When you have a delay, it normally picks a random time to play. When // this flag is on, it generates an even time distribution #define FX_RGB_COMPONENT_INTERP 0x4000 // Picks a color on the line defined by RGB min & max, default is to pick color in cube defined by min & max #define FX_AFFECTED_BY_WIND 0x10000 // this effect primitive needs to query wind //----------------------------------------------------------------- // // CMediaHandles // // Primitive templates might want to use a list of sounds, shaders // or models to get a bit more variation in their effects. // //----------------------------------------------------------------- class CMediaHandles { private: vector mMediaList; public: void AddHandle( int item ) { mMediaList.push_back( item ); } int GetHandle() { if (mMediaList.size()==0) {return 0;} else {return mMediaList[irand(0,mMediaList.size()-1)];} } void operator=(const CMediaHandles &that ); #ifdef EFFECTSED // For the editor, which needs to iterate through the list and/or clear it. vector &GetHandleArray() { return mMediaList; } const vector &GetHandleArray() const { return mMediaList; } private: vector mMediaNames; public: void PrepareReloadAssets(enum EMediaTypes mediaType); void ReloadAssets(enum EMediaTypes mediaType); #endif }; //----------------------------------------------------------------- // // CFxRange // // Primitive templates typically use this class to define each of // its members. This is done to make it easier to create effects // with a desired range of characteristics. // //----------------------------------------------------------------- class CFxRange { private: float mMin; float mMax; public: CFxRange() {mMin=0; mMax=0;} inline void SetRange(float min,float max) {mMin=min; mMax=max;} inline void SetMin(float min) {mMin=min;} inline void SetMax(float max) {mMax=max;} inline float GetMax() const {return mMax;} inline float GetMin() const {return mMin;} inline float GetVal(float percent) const {return (mMin + (mMax - mMin) * percent);} inline float GetVal() const {if(mMin == mMax){return mMin;} return flrand(mMin, mMax);} inline int GetRoundedVal() const {if(mMin == mMax){return mMin;} return (int)(flrand(mMin, mMax) + 0.5f);} inline void ForceRange(float min,float max) {if(mMin < min){mMin=min;} if(mMin > max){mMin=max;} if(mMax < min){mMax=min;} if(mMax > max){mMax=max;}} void operator=(const CFxRange &that) {mMin=that.mMin; mMax=that.mMax;} bool operator==(const CFxRange &rhs) const { return ((mMin == rhs.mMin) && (mMax == rhs.mMax)); } }; //---------------------------- // Supported primitive types //---------------------------- enum EPrimType { None = 0, Particle, // sprite Line, Tail, // comet-like tail thing Cylinder, Emitter, // emits effects as it moves, can also attach a chunk Sound, Decal, // projected onto architecture OrientedParticle, Electricity, FxRunner, Light, CameraShake, ScreenFlash }; //----------------------------------------------------------------- // // CPrimitiveTemplate // // The primitive template is used to spawn 1 or more fx primitives // with the range of characteristics defined by the template. // // As such, I just made this one huge shared class knowing that // there won't be many of them in memory at once, and we won't // be dynamically creating and deleting them mid-game. Also, // note that not every primitive type will use all of these fields. // //----------------------------------------------------------------- class CPrimitiveTemplate { public: // These kinds of things should not even be allowed to be accessed publicly bool mCopy; int mRefCount; // For a copy of a primitive...when we figure out how many items we want to spawn, // we'll store that here and then decrement us for each we actually spawn. When we // hit zero, we are no longer used and so we can just free ourselves char mName[FX_MAX_PRIM_NAME]; EPrimType mType; #ifdef EFFECTSED bool mEnabled; #endif CFxRange mSpawnDelay; CFxRange mSpawnCount; CFxRange mLife; int mCullRange; CMediaHandles mMediaHandles; CMediaHandles mImpactFxHandles; CMediaHandles mDeathFxHandles; CMediaHandles mEmitterFxHandles; CMediaHandles mPlayFxHandles; int mFlags; // These need to get passed on to the primitive int mSpawnFlags; // These are only used to control spawning, but never get passed to prims. vec3_t mMin; vec3_t mMax; CFxRange mOrigin1X; CFxRange mOrigin1Y; CFxRange mOrigin1Z; CFxRange mOrigin2X; CFxRange mOrigin2Y; CFxRange mOrigin2Z; CFxRange mRadius; CFxRange mHeight; CFxRange mWindModifier; CFxRange mRotation; CFxRange mRotationDelta; CFxRange mAngle1; CFxRange mAngle2; CFxRange mAngle3; CFxRange mAngle1Delta; CFxRange mAngle2Delta; CFxRange mAngle3Delta; CFxRange mVelX; CFxRange mVelY; CFxRange mVelZ; CFxRange mAccelX; CFxRange mAccelY; CFxRange mAccelZ; CFxRange mGravity; CFxRange mDensity; CFxRange mVariance; CFxRange mRedStart; CFxRange mGreenStart; CFxRange mBlueStart; CFxRange mRedEnd; CFxRange mGreenEnd; CFxRange mBlueEnd; CFxRange mRGBParm; CFxRange mAlphaStart; CFxRange mAlphaEnd; CFxRange mAlphaParm; CFxRange mSizeStart; CFxRange mSizeEnd; CFxRange mSizeParm; CFxRange mSize2Start; CFxRange mSize2End; CFxRange mSize2Parm; CFxRange mLengthStart; CFxRange mLengthEnd; CFxRange mLengthParm; CFxRange mTexCoordS; CFxRange mTexCoordT; CFxRange mElasticity; // Lower level parsing utilities bool ParseVector( const char *val, vec3_t min, vec3_t max ); bool ParseFloat( const char *val, float *min, float *max ); bool ParseGroupFlags( const char *val, int *flags ); // Base key processing // Note that these all have their own parse functions in case it becomes important to do certain kinds // of validation specific to that type. bool ParseMin( const char *val ); bool ParseMax( const char *val ); bool ParseDelay( const char *val ); bool ParseCount( const char *val ); bool ParseLife( const char *val ); bool ParseElasticity( const char *val ); bool ParseFlags( const char *val ); bool ParseSpawnFlags( const char *val ); bool ParseOrigin1( const char *val ); bool ParseOrigin2( const char *val ); bool ParseRadius( const char *val ); bool ParseHeight( const char *val ); bool ParseWindModifier( const char *val ); bool ParseRotation( const char *val ); bool ParseRotationDelta( const char *val ); bool ParseAngle( const char *val ); bool ParseAngleDelta( const char *val ); bool ParseVelocity( const char *val ); bool ParseAcceleration( const char *val ); bool ParseGravity( const char *val ); bool ParseDensity( const char *val ); bool ParseVariance( const char *val ); // Group type processing bool ParseRGB( CGPGroup *grp ); bool ParseAlpha( CGPGroup *grp ); bool ParseSize( CGPGroup *grp ); bool ParseSize2( CGPGroup *grp ); bool ParseLength( CGPGroup *grp ); bool ParseModels( CGPValue *grp ); bool ParseShaders( CGPValue *grp ); bool ParseSounds( CGPValue *grp ); bool ParseImpactFxStrings( CGPValue *grp ); bool ParseDeathFxStrings( CGPValue *grp ); bool ParseEmitterFxStrings( CGPValue *grp ); bool ParsePlayFxStrings( CGPValue *grp ); // Group keys bool ParseRGBStart( const char *val ); bool ParseRGBEnd( const char *val ); bool ParseRGBParm( const char *val ); bool ParseRGBFlags( const char *val ); bool ParseAlphaStart( const char *val ); bool ParseAlphaEnd( const char *val ); bool ParseAlphaParm( const char *val ); bool ParseAlphaFlags( const char *val ); bool ParseSizeStart( const char *val ); bool ParseSizeEnd( const char *val ); bool ParseSizeParm( const char *val ); bool ParseSizeFlags( const char *val ); bool ParseSize2Start( const char *val ); bool ParseSize2End( const char *val ); bool ParseSize2Parm( const char *val ); bool ParseSize2Flags( const char *val ); bool ParseLengthStart( const char *val ); bool ParseLengthEnd( const char *val ); bool ParseLengthParm( const char *val ); bool ParseLengthFlags( const char *val ); public: CPrimitiveTemplate(); ~CPrimitiveTemplate() {}; bool ParsePrimitive( CGPGroup *grp ); void operator=(const CPrimitiveTemplate &that); }; // forward declaration struct SEffectTemplate; // Effects are built of one or more primitives struct SEffectTemplate { bool mInUse; bool mCopy; char mEffectName[MAX_QPATH]; // is this extraneous?? int mPrimitiveCount; CPrimitiveTemplate *mPrimitives[FX_MAX_EFFECT_COMPONENTS]; bool operator == (const char * name) const { return !stricmp( mEffectName, name ); } void operator=(const SEffectTemplate &that); }; //----------------------------------------------------------------- // // CFxScheduler // // The scheduler not only handles requests to play an effect, it // tracks the request throughout its life if necessary, creating // any of the delayed components as needed. // //----------------------------------------------------------------- class CFxScheduler { private: #ifdef EFFECTSED friend void UnparseEffect(int id, std::string &str); bool mbStopScheduled; #endif // We hold a scheduled effect here struct SScheduledEffect { CPrimitiveTemplate *mpTemplate; // primitive template CCloud *mParent; int mStartTime; #ifndef EFFECTSED int mModelNum; // uset to determine which ghoul2 model we want to bolt this effect to int mBoltNum; // used to determine which bolt on the ghoul2 model we should be attaching this effect to #ifdef CHC int mEntNum; // used to determine which entity this ghoul model is attached to. #else // SoF2 //union //{ int mEntNum; CFxBoltInterface *mObj; //}; #endif #endif // not fxEd vec3_t mOrigin; vec3_t mAxis[3]; bool operator <= (const int time) const { return mStartTime <= time; } }; // this makes looking up the index based on the string name much easier typedef map TEffectID; typedef list TScheduledEffect; // Effects SEffectTemplate mEffectTemplates[FX_MAX_EFFECTS]; TEffectID mEffectIDs; // if you only have the unique effect name, you'll have to use this to get the ID. // List of scheduled effects that will need to be created at the correct time. TScheduledEffect mFxSchedule; // Private function prototypes SEffectTemplate *GetNewEffectTemplate( int *id, const char *file ); void AddPrimitiveToEffect( SEffectTemplate *fx, CPrimitiveTemplate *prim ); int ParseEffect( const char *file, CGPGroup *base ); void CreateEffect( CPrimitiveTemplate *fx, vec3_t origin, vec3_t axis[3], int lateTime, CCloud *effectCloud); #ifndef EFFECTSED #ifndef CHC // Sof2 only #endif void CreateEffect( CPrimitiveTemplate *fx, CFxBoltInterface *obj, int lateTime, CCloud *effectCloud); #endif public: CFxScheduler(); int RegisterEffect( const char *file, bool bHasCorrectPath = false ); // handles pre-caching #ifdef EFFECTSED // Editor support methods const char *GetEffectName( int id ); int NewEffect(); // create a new effect template containing no primitives void RegisterEffectWithEditor( int id ); void NewPrimitive( int id, EPrimType type ); void DeletePrimitive( int id, CPrimitiveTemplate *prim ); void ScheduleStop() { mbStopScheduled = true; } bool IsStopScheduled() { return mbStopScheduled; } void PrepareReloadAssets(int idToPreserve); void ReloadAssets(int idToPreserve); #endif // Nasty overloaded madness void PlayEffect( int id, vec3_t org ); // uses a default up axis void PlayEffect( int id, vec3_t org, vec3_t fwd ); // builds arbitrary perp. right vector, does a cross product to define up void PlayEffect( int id, vec3_t origin, vec3_t axis[3], const int boltInfo=-1, const int entNum=-1 ); void PlayEffect( const char *file, vec3_t org ); // uses a default up axis void PlayEffect( const char *file, vec3_t org, vec3_t fwd ); // builds arbitrary perp. right vector, does a cross product to define up void PlayEffect( const char *file, vec3_t origin, vec3_t axis[3], const int boltInfo, const int entNum ); #ifndef EFFECTSED #ifndef CHC // SOF2 only void PlayEffect( int id, CFxBoltInterface *obj ); #endif #endif void AddScheduledEffects( void ); // call once per CGame frame int NumScheduledFx() { return mFxSchedule.size(); } void Clean(bool bRemoveTemplates = true, int idToPreserve = 0); // clean out the system // FX Override functions SEffectTemplate *GetEffectCopy( int fxHandle, int *newHandle ); SEffectTemplate *GetEffectCopy( const char *file, int *newHandle ); CPrimitiveTemplate *GetPrimitiveCopy( SEffectTemplate *effectCopy, const char *componentName ); }; //------------------- // The one and only //------------------- extern CFxScheduler theFxScheduler; #endif // FX_SCHEDULER_H_INC