api_func.h

/*
 * Copyright (c) 2016-2025 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.
*/
 
typedef enum
{
    DRAWFLAG_NORMAL = 0, 
    DRAWFLAG_ADDITIVE, 
    DRAWFLAG_MODULATE, 
    DRAWFLAG_2XMODULATE 
} drawflag_t;
 
typedef enumflags
{
    AF_LEFT, 
    AF_TOP,  
    AF_RIGHT,  
    AF_BOTTOM  
} alignflags_t;
#define AF_NONE 0
 
typedef struct
{
    int iID;    
    int iScaleX; 
    int iScaleY; 
    vector vecColor; 
    float flAlpha; 
    int iFlags; 
    string hexColor;
} font_s;
 
typedef struct
{
    float GetID(font_s fnt);
 
    void Load(string fontDef,font_s &fntNew);
 
    string RGBtoHex(vector normalizedColor);
 
    int GetHeight(font_s fnt);
 
    float StringWidth(string inputText,bool hasColor,font_s fnt);
} fontAPI_t;
var fontAPI_t font;
typedef struct
{
    vector Mins(void); 
    vector Size(void); 
    float Width(void); 
    float Height(void); 
    vector HUDMins(void); 
    vector HUDSize(void); 
} surfaceAPI_t;
var surfaceAPI_t screen;
typedef struct
{
    void Rect(vector rectPos, vector rectSize, vector rectRGB , float rectAlpha);
    void RectOutline(vector rectPos, vector rectSize, float outlineThickness, vector rectColor, float rectAlpha);
    void RoundedRectOutline(vector rectPos, vector rectSize, vector rectColor, float rectAlpha);
 
    void RoundedBox(vector boxPos, vector boxSize, vector boxColor, float boxAlpha);
 
    void Line(float lineThickness, vector startPos, vector endPos, vector lineColor, float lineAlpha);
    void Pic(vector imagePos, string imageName, vector imageSize, vector imageColor, float imageAlpha, float imageFlags);
    void SubPic(vector imagePos, vector displaySize, string imageName, vector sourcePos, vector sourceSize, vector imageColor, float imageAlpha, float imageFlags);
    void Text(vector vecOrigin, string strText, font_s fnt);
    void Text_A(vector vecOrigin, string strText, float a, font_s fnt);
    void Text_RGB(vector vecOrigin, string strText, vector col, font_s fnt);
    void Text_RGBA(vector vecOrigin, string strText, vector col, float a, font_s fnt);
    void RText(vector vecOrigin, string strText, font_s fnt);
    void RText_A(vector vecOrigin, string strText, float a, font_s fnt);
    void RText_RGB(vector vecOrigin, string strText, vector col, font_s fnt);
    void RText_RGBA(vector vecOrigin, string strText, vector col, float a, font_s fnt);
    void TextField(vector vecOrigin, vector vecSize, string strText, font_s fnt, alignflags_t iAlignFlags);
    void TextFieldAtHeight(vector vecOrigin, vector vecSize, int iTextHeight, string strText, font_s fnt, alignflags_t iAlignFlags);
    
    void RadarRect(vector vecOrigin, vector vecSize);
 
    void ScriptedView(vector vecOrigin, vector vecSize);
} drawAPI_t;
var drawAPI_t draw;
typedef struct
{
    vector GetCameraPosition(void);
    vector GetCameraAngles(void);
    float GetArmor(void);
    float GetHealth(void);
    float GetStamina(void);
    int GetTeam(void);
    bool IsStanding(void);
    bool IsLeaning(void);
    bool IsSprinting(void);
    bool IsCrouched(void);
    bool IsProne(void);
    bool IsMoving(void);
    bool IsFalling(void);
    bool HasItem(string itemClassName);
    string GetString(string userKey);
    int GetInteger(string userKey);
    float GetFloat(string userKey);
    bool GetBool(string userKey);
    vector GetVector(string userKey);
    
    float GetGameFlags(void);
} playerAPI_t;
var playerAPI_t player; 
typedef struct
{
    bool IsValid(entity weaponRef = __NULL__);
    string GetTitle(entity weaponRef = __NULL__);
    int GetSlot(entity weaponRef = __NULL__);
    int GetSlotPos(entity weaponRef = __NULL__);
    string GetIcon(entity weaponRef = __NULL__);
    string GetSelectedIcon(entity weaponRef = __NULL__);
    int GetAmmo1(entity weaponRef = __NULL__);
    int GetAmmo2(entity weaponRef = __NULL__);
    int GetClip(entity weaponRef = __NULL__);
    int GetClipSize(entity weaponRef = __NULL__);
    int MaxAmmo(entity weaponRef = __NULL__);
    bool IsEmpty(entity weaponRef = __NULL__);
    bool UsesSecondaryAmmo(entity weaponRef = __NULL__);
    bool AmmoRequired(entity weaponRef = __NULL__);
 
    entity GetActiveWeapon(void);
    entity GetFirstWeaponInInventory(void);
    entity GetLastWeaponInInventory(void);
 
    entity GetNextWeaponRelativeTo(entity);
 
    entity GetPreviousWeaponRelativeTo(entity playerWeapon);
 
    void SelectWeapon(entity);
} weaponAPI_t;
var weaponAPI_t weapon; 
typedef struct
{
    ncSpectatorMode_t Mode(void);
    string LocalizedMode(void);
    string Name(void);
    int Team(void);
} spectatingAPI_t;
var spectatingAPI_t spectating; 
typedef struct
{
    int Load(string atlasPicName); /* loads a permanent handle for the named atlas pic */
    void Draw(int atlasPic, vector drawAtPos, bool forceAdditive);
    void Draw_A(int atlasPic, vector drawAtPos, float picAlpha, bool forceAdditive);
    void Draw_RGBA(int atlasPic, vector drawAtPos, vector picColor, float picAlpha, bool forceAdditive);
    void DrawTop_RGBA(int atlasPic, vector drawAtPos, float percentageDrawn, vector picColor, float picAlpha, bool forceAdditive);
    void DrawBottom_RGBA(int atlasPic, vector drawAtPos, float percentageDrawn, vector picColor, float picAlpha, bool forceAdditive);
    void DrawLeft_RGBA(int atlasPic, vector drawAtPos, float percentageDrawn, vector picColor, float picAlpha, bool forceAdditive);
    void DrawRight_RGBA(int atlasPic, vector drawAtPos, float percentageDrawn, vector picColor, float picAlpha, bool forceAdditive);
 
 
    void DrawTop_RGB(int atlasPic, vector drawAtPos, float percentageDrawn, vector picColor, bool forceAdditive);
    void DrawBottom_RGB(int atlasPic, vector drawAtPos, float percentageDrawn, vector picColor, bool forceAdditive);
    void DrawLeft_RGB(int atlasPic, vector drawAtPos, float percentageDrawn, vector picColor, bool forceAdditive);
    void DrawRight_RGB(int atlasPic, vector drawAtPos, float percentageDrawn, vector picColor, bool forceAdditive);
 
    void Draw_RGB(int atlasPic, vector drawAtPos, vector picColor, bool forceAdditive);
    void DrawCrosshair(int atlasPic);
    float GetWidth(int atlasPic);
    float GetHeight(int atlasPic);
    vector GetSize(int atlasPic);
} atlasPicAPI_t;
var atlasPicAPI_t atlasPic; 
typedef struct
{
    bool Cached(void);
    float GetWidth(string materialName);
    float GetHeight(string materialName);
    vector GetSize(string materialName);
} materialAPI_t;
var materialAPI_t material;  // end of hudC
 
/* To be implemented by HUD */
void HUD_Init(void);
 
__variant
linkToClientProgs(string funcName)
{
    static void empty(void)
    {
        print("Called unimplemented client-side API call.\n");
        breakpoint();
    }
 
    void *func = externvalue(0, funcName);
 
    if (func) {
        return ((__variant)func);
    } else {
        return (empty);
    }
}
 
void
_client_main(void)
{
    font.GetHeight = linkToClientProgs("Font_GetHeight");
    font.GetID = linkToClientProgs("Font_GetID");
    font.Load = linkToClientProgs("Font_Load");
    font.RGBtoHex = linkToClientProgs("Font_RGBtoHex");
    font.StringWidth = linkToClientProgs("Font_StringWidth");
 
    screen.Width = linkToClientProgs("CLPF_surface_ScreenWidth");
    screen.Height = linkToClientProgs("CLPF_surface_ScreenHeight");
    screen.Size = linkToClientProgs("CLPF_surface_ScreenSize");
    screen.Mins = linkToClientProgs("CLPF_surface_ScreenMins");
    screen.HUDMins = linkToClientProgs("CLPF_surface_HUDMins");
    screen.HUDSize = linkToClientProgs("CLPF_surface_HUDSize");
 
    material.GetSize = linkToClientProgs("CLPF_material_GetSize");
    material.GetWidth = linkToClientProgs("CLPF_material_GetWidth");
    material.GetHeight = linkToClientProgs("CLPF_material_GetHeight");
    material.Cached = linkToClientProgs("CLPF_material_Cached");
 
    player.GetCameraPosition = linkToClientProgs("CLPF_player_GetCameraPosition");
    player.GetCameraAngles = linkToClientProgs("CLPF_player_GetCameraAngles");
    player.GetHealth = linkToClientProgs("CLPF_player_GetHealth");
    player.GetArmor = linkToClientProgs("CLPF_player_GetArmor");
    player.GetStamina = linkToClientProgs("CLPF_player_GetStamina");
    player.GetTeam = linkToClientProgs("CLPF_player_GetTeam");
    player.HasItem = linkToClientProgs("CLPF_player_HasItem");
    player.IsStanding = linkToClientProgs("CLPF_player_IsStanding");
    player.IsLeaning = linkToClientProgs("CLPF_player_IsLeaning");
    player.IsSprinting = linkToClientProgs("CLPF_player_IsSprinting");
    player.IsCrouched = linkToClientProgs("CLPF_player_IsCrouching");
    player.IsProne = linkToClientProgs("CLPF_player_IsProne");
    player.IsMoving = linkToClientProgs("CLPF_player_IsMoving");
    player.IsFalling = linkToClientProgs("CLPF_player_IsFalling");
    player.GetGameFlags = linkToClientProgs("CLPF_player_GetGameFlags");
 
    player.GetString = linkToClientProgs("CLPF_player_GetString");
    player.GetInteger = linkToClientProgs("CLPF_player_GetInteger");
    player.GetBool = linkToClientProgs("CLPF_player_GetBool");
    player.GetFloat = linkToClientProgs("CLPF_player_GetFloat");
    player.GetVector = linkToClientProgs("CLPF_player_GetVector");
 
    weapon.IsValid = linkToClientProgs("CLPF_weapon_IsValid");
    weapon.GetTitle = linkToClientProgs("CLPF_weapon_GetTitle");
    weapon.GetIcon = linkToClientProgs("CLPF_weapon_GetIcon");
    weapon.GetSelectedIcon = linkToClientProgs("CLPF_weapon_GetSelectedIcon");
    weapon.GetSlot = linkToClientProgs("CLPF_weapon_GetSlot");
    weapon.GetSlotPos = linkToClientProgs("CLPF_CLPF_weapon_GetSlotPos");
    weapon.GetAmmo1 = linkToClientProgs("CLPF_weapon_GetAmmo1");
    weapon.GetAmmo2 = linkToClientProgs("CLPF_weapon_GetAmmo2");
    weapon.GetClip = linkToClientProgs("CLPF_weapon_GetClip");
    weapon.GetClipSize = linkToClientProgs("CLPF_CLPF_weapon_GetClipSize");
    weapon.MaxAmmo = linkToClientProgs("CLPF_weapon_MaxAmmo");
    weapon.IsEmpty = linkToClientProgs("CLPF_weapon_IsEmpty");
    weapon.UsesSecondaryAmmo = linkToClientProgs("CLPF_weapon_UsesSecondaryAmmo");
    weapon.AmmoRequired = linkToClientProgs("CLPF_weapon_AmmoRequired");
    weapon.GetActiveWeapon = linkToClientProgs("CLPF_weapon_GetActiveWeapon");
    weapon.GetFirstWeaponInInventory = linkToClientProgs("CLPF_weapon_GetFirstWeaponInInventory");
    weapon.GetLastWeaponInInventory = linkToClientProgs("CLPF_weapon_GetLastWeaponInInventory");
    weapon.GetNextWeaponRelativeTo = linkToClientProgs("CLPF_weapon_GetNextWeaponRelativeTo");
    weapon.GetPreviousWeaponRelativeTo = linkToClientProgs("CLPF_weapon_GetPreviousWeaponRelativeTo");
    weapon.SelectWeapon = linkToClientProgs("CLPF_weapon_SelectWeapon");
 
    draw.Rect = linkToClientProgs("CLPF_draw_Rect");
    draw.RectOutline = linkToClientProgs("CLPF_draw_RectOutline");
    draw.RoundedRectOutline = linkToClientProgs("CLPF_draw_RoundedRectOutline");
    draw.RoundedBox = linkToClientProgs("CLPF_draw_RoundedBox");
    draw.Line = linkToClientProgs("CLPF_draw_Line");
    draw.Pic = linkToClientProgs("CLPF_draw_Pic");
    draw.SubPic = linkToClientProgs("CLPF_draw_SubPic");
 
    draw.TextField = linkToClientProgs("Font_DrawField");
    draw.TextFieldAtHeight = linkToClientProgs("Font_DrawFieldAtHeight");
    draw.RText = linkToClientProgs("Font_DrawRText");
    draw.RText_A = linkToClientProgs("Font_DrawRText_A");
    draw.RText_RGB = linkToClientProgs("Font_DrawRText_RGB");
    draw.RText_RGBA = linkToClientProgs("Font_DrawRText_RGBA");
    draw.Text = linkToClientProgs("Font_DrawText");
    draw.Text_A= linkToClientProgs("Font_DrawText_A");
    draw.Text_RGB= linkToClientProgs("Font_DrawText_RGB");
    draw.Text_RGBA = linkToClientProgs("Font_DrawText_RGBA");
    draw.RadarRect = linkToClientProgs("CLPF_draw_RadarRect");
    draw.ScriptedView = linkToClientProgs("CLPF_draw_ScriptedView");
 
    spectating.Mode = linkToClientProgs("CLPF_spectating_Mode");
    spectating.LocalizedMode = linkToClientProgs("CLPF_spectating_LocalizedMode");
    spectating.Name = linkToClientProgs("CLPF_spectating_Name");
    spectating.Team = linkToClientProgs("CLPF_spectating_Team");
 
    atlasPic.Load = linkToClientProgs("CLPF_atlasPic_Load");
    atlasPic.Draw = linkToClientProgs("CLPF_atlasPic_Draw");
    atlasPic.Draw_A = linkToClientProgs("CLPF_atlasPic_Draw_A");
    atlasPic.Draw_RGB = linkToClientProgs("CLPF_atlasPic_Draw_RGB");
    atlasPic.Draw_RGBA = linkToClientProgs("CLPF_atlasPic_Draw_RGBA");
    atlasPic.DrawTop_RGBA = linkToClientProgs("CLPF_atlasPic_DrawTop_RGBA");
    atlasPic.DrawBottom_RGBA = linkToClientProgs("CLPF_atlasPic_DrawBottom_RGBA");
    atlasPic.DrawLeft_RGBA = linkToClientProgs("CLPF_atlasPic_DrawLeft_RGBA");
    atlasPic.DrawRight_RGBA = linkToClientProgs("CLPF_atlasPic_DrawRight_RGBA");
 
    atlasPic.DrawTop_RGB = linkToClientProgs("CLPF_atlasPic_DrawTop_RGB");
    atlasPic.DrawBottom_RGB = linkToClientProgs("CLPF_atlasPic_DrawBottom_RGB");
    atlasPic.DrawLeft_RGB = linkToClientProgs("CLPF_atlasPic_DrawLeft_RGB");
    atlasPic.DrawRight_RGB = linkToClientProgs("CLPF_atlasPic_DrawRight_RGB");
 
    atlasPic.DrawCrosshair = linkToClientProgs("CLPF_atlasPic_DrawCrosshair");
    atlasPic.GetWidth = linkToClientProgs("CLPF_atlasPic_GetWidth");
    atlasPic.GetHeight = linkToClientProgs("CLPF_atlasPic_GetHeight");
    atlasPic.GetSize = linkToClientProgs("CLPF_atlasPic_GetSize");
}