global.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.
*/
 
var bool autocvar_g_logTimestamps = false;
 
typedef enum
{
        LOGLEVEL_NONE,
        LOGLEVEL_ERRORS,
        LOGLEVEL_WARNINGS,
        LOGLEVEL_DEBUG,
} logLevel_t;
 
#define LOGLEVEL_DEFAULT LOGLEVEL_WARNINGS
var logLevel_t autocvar_g_logLevel = LOGLEVEL_DEFAULT;
 
#define printf(...) print(sprintf(__VA_ARGS__))
 
#ifdef DOXYGEN
#define enumflags enum
#endif
 
void
_NSLog(string msg)
{
        if (autocvar_g_logTimestamps)
                print(sprintf("^9%f ^7%s\n", time, msg));
        else
                print(sprintf("^7%s\n", msg));
}
 
void
_NSError(string functionName, string msg)
{
        if (autocvar_g_logTimestamps)
                print(sprintf("^9%f ^1%s^7: %s\n", time, functionName, msg));
        else
                print(sprintf("^1%s^7: %s\n", functionName, msg));
}
 
void
_NSWarning(string functionName, string msg)
{
        if (autocvar_g_logTimestamps)
                print(sprintf("^9%f ^3%s^7: %s\n", time, functionName, msg));
        else
                print(sprintf("^3%s^7: %s\n", functionName, msg));
}
 
void
_NSAssert(bool condition, string function, string descr)
{
        if (!condition) {
                print(strcat("^1Assertion failed in ", function, ", reason: ", descr, "\n"));
#ifndef MENU
                breakpoint();
#endif
        }
}
 
#define NSLog(...) if (autocvar_g_logLevel >= LOGLEVEL_DEBUG) _NSLog(sprintf(__VA_ARGS__))
 
#define NSError(...) if (autocvar_g_logLevel >= LOGLEVEL_ERRORS) _NSError(__FUNC__, sprintf(__VA_ARGS__))
 
#define NSWarning(...) if (autocvar_g_logLevel >= LOGLEVEL_WARNINGS) _NSWarning(__FUNC__, sprintf(__VA_ARGS__))
 
#define NSAssert(condition, ...) if (autocvar_g_logLevel >= LOGLEVEL_ERRORS) _NSAssert(condition, __FUNC__, sprintf(__VA_ARGS__))
 
typedef enumflags
{
       SEARCH_INSENSITIVE,      
       SEARCH_FULLPACKAGE,      
       SEARCH_ALLOWDUPES,       
       SEARCH_FORCESEARCH,      
       SEARCH_MULTISEARCH,      
       SEARCH_NAMESORT          
} searchFlags_t;
 
const vector g_vec_null = [0.0f, 0.0f, 0.0f];
 
/* the console needs some attention too. */
var float g_initTime;
 
void
InitPrint(string functionName)
{
        int chars = 51i;
        int charsLeft;
        int charExtra;
        string sideLeft = "";
        string sideRight = "";
 
        if (functionName == __NULL__) {
                NSLog("---------------------------------------------------");
                return;
        }
 
        /* word and padding */
        chars = chars - (int)strlen(functionName) - 2i;
        charsLeft = chars / 2i;
        charExtra = chars % 2i;
 
        for (int i = 0i; i < charsLeft; i++)
                sideLeft = strcat(sideLeft,"-");
 
        for (int i = 0i; i < (charsLeft + charExtra); i++) {
                sideRight = strcat(sideRight,"-");
        }
 
        NSLog( "%s %s %s", sideLeft, functionName, sideRight);
}
 
var string g_lastInitFunc;
void
_InitStart(string functionName)
{
        if (g_initTime != 0)
                error(sprintf("Called InitStart() without InitEnd()ing %s!", g_lastInitFunc));
 
        InitPrint(functionName);
        g_lastInitFunc = functionName;
        g_initTime = gettime(1);
}
 
#define InitStart() _InitStart(__FUNC__)
 
void
_InitEnd(void)
{
        float endTime = gettime(1);
        NSLog("loaded in %.1f seconds", (endTime - g_initTime));
        NSLog("---------------------------------------------------");
        g_initTime = 0;
}
 
#define InitEnd() _InitEnd()
 
#define entity_def(x, ...) const string x[] = { __VA_ARGS__ }
 
#define thread(x) if (fork()) { x; abort(); }