NSIO.h

Go to the documentation of this file.

/*
 * Copyright (c) 2016-2024 Vera Visions LLC.
 *
 * Permission to use, copy, modify, and distribute this software for any
 * purpose with or without fee is hereby granted, provided that the above
 * copyright notice and this permission notice appear in all copies.
 *
 * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
 * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
 * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
 * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
 * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
 * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
*/
 
class NSIO
{
public:
        void NSIO(void);
 
        virtual void Spawned(void);
 
        virtual void Respawn(void);
 
        virtual void SpawnKey(string,string);
 
        /* EntityDef interactions */
        nonvirtual float GetDefAct(string);
        nonvirtual string GetDefString(string);
        nonvirtual float GetDefFloat(string);
        nonvirtual bool GetDefBool(string);
        nonvirtual int GetDefInt(string);
        nonvirtual vector GetDefVector(string);
 
        nonvirtual float GetSubDefAct(string, string);
        nonvirtual string GetSubDefString(string, string);
        nonvirtual float GetSubDefFloat(string, string);
        nonvirtual bool GetSubDefBool(string, string);
        nonvirtual int GetSubDefInt(string, string);
        nonvirtual vector GetSubDefVector(string, string);
 
#ifdef SERVER
        virtual void Save(float);
 
        virtual void Restore(string,string);
 
        virtual void RestoreComplete(void);
 
        virtual void TransitionComplete(void);
 
        virtual void Input(entity,string,string);
 
        /* helper functions to allocate outputs */
        nonvirtual void UseOutput(entity,string);
        nonvirtual string PrepareOutput(string,string);
 
        nonvirtual string CreateOutput(string);
 
        nonvirtual bool CheckOutput(string);
 
        virtual void ParentUpdate(void);
 
        /* save game related methods */
        nonvirtual void SaveFloat(float,string,float);
        nonvirtual void SaveInt(float,string,int);
        nonvirtual void SaveString(float,string,string);
        nonvirtual void SaveVector(float,string,vector);
        nonvirtual void SaveBool(float,string,bool);
        nonvirtual void SaveEntity(float,string,entity);
 
#endif
 
        nonvirtual float GetSpawnFloat(string);
        nonvirtual int GetSpawnInt(string);
        nonvirtual string GetSpawnString(string);
        nonvirtual vector GetSpawnVector(string);
        nonvirtual bool GetSpawnBool(string);
        nonvirtual entity GetSpawnEntity(string, entity);
 
        /* load game/spawn helper functions */
        nonvirtual float ReadFloat(string);
        nonvirtual int ReadInt(string);
        nonvirtual string ReadString(string);
        nonvirtual vector ReadVector(string);
        nonvirtual bool ReadBool(string);
        nonvirtual entity ReadEntity(string);
 
        nonvirtual float GetTime(void);
 
        /* save game related methods */
        nonvirtual void DebugFloat(string,float);
        nonvirtual void DebugInt(string,int);
        nonvirtual void DebugString(string,string);
        nonvirtual void DebugVector(string,vector);
        nonvirtual void DebugBool(string,bool);
        nonvirtual void DebugEntity(string,entity);
 
private:
        string m_strSpawnData;
#ifdef SERVER
        string m_strOnTrigger;
        string m_strOnUser1;
        string m_strOnUser2;
        string m_strOnUser3;
        string m_strOnUser4;
 
        /* entityDef powered modelevent callbacks */
        string m_strModelEventCB;
#endif
};
 
.bool _mapspawned;
 
void
_NSEntLog(string className, string functionName, float edictNum, string warnMessage)
{
        if (autocvar_g_logTimestamps)
                print(sprintf("^9%f ^7%s (%d)^7: %s\n", time, className, edictNum, warnMessage));
        else
                print(sprintf("^7%s (%d)^7: %s\n", className, edictNum, warnMessage));
}
 
void
_NSEntWarning(string className, string functionName, float edictNum, string warnMessage)
{
        if (autocvar_g_logTimestamps)
                print(sprintf("^9%f ^3%s (%d)^7: %s\n", time, functionName, edictNum, warnMessage));
        else
                print(sprintf("^3%s (%d)^7: %s\n", functionName, edictNum, warnMessage));
}
 
void
_NSEntError(string className, string functionName, float edictNum, string warnMessage)
{
        if (autocvar_g_logTimestamps)
                print(sprintf("^9%f ^1%s (id: %d)^7: %s\n", time, functionName, edictNum, warnMessage));
        else
                print(sprintf("^1%s (id: %d)^7: %s\n", functionName, edictNum, warnMessage));
}
#define EntLog(...) if (autocvar_g_logLevel >= LOGLEVEL_DEBUG) _NSEntLog(classname, __FUNC__, num_for_edict(this), sprintf(__VA_ARGS__))
 
#define EntWarning(...) if (autocvar_g_logLevel >= LOGLEVEL_WARNINGS) _NSEntWarning(classname, __FUNC__, num_for_edict(this), sprintf(__VA_ARGS__))
 
#define EntError(...) if (autocvar_g_logLevel >= LOGLEVEL_ERRORS) _NSEntError(classname, __FUNC__, num_for_edict(this), sprintf(__VA_ARGS__))