ui_actions.h

Go to the documentation of this file.

 
/*
Copyright (C) 2002-2025 UFO: Alien Invasion.
 
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 2
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, write to the Free Software
Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
 
*/
 
#pragma once
 
#include "../../common/common.h"

typedef enum uiActionType_s {
    EA_NULL = 0,
 
    EA_BINARYOPERATOR,
    EA_UNARYOPERATOR,
 
    /* masks */
    EA_HIGHT_MASK = 0xFF00,
 
    /* actions */
    EA_ACTION = 0x0100,
    EA_CMD = EA_ACTION + 1,
    EA_CALL = EA_ACTION + 2,
    EA_ASSIGN = EA_ACTION + 3,
    EA_IF = EA_ACTION + 4,
    EA_ELSE = EA_ACTION + 5,
    EA_ELIF = EA_ACTION + 6,
    EA_WHILE = EA_ACTION + 7,
    EA_DELETE = EA_ACTION + 8,
    EA_LISTENER = EA_ACTION + 9,
    EA_PUSHVARS = EA_ACTION + 10,
    EA_POPVARS = EA_ACTION + 11,
    EA_FORCHILDIN = EA_ACTION + 12,
    EA_BREAK = EA_ACTION + 13,
 
    /* boolean to boolean operators */
    EA_OPERATOR_BOOLEAN2BOOLEAN = 0x0300,
    EA_OPERATOR_AND = EA_OPERATOR_BOOLEAN2BOOLEAN + 1,
    EA_OPERATOR_OR = EA_OPERATOR_BOOLEAN2BOOLEAN + 2,
    EA_OPERATOR_XOR = EA_OPERATOR_BOOLEAN2BOOLEAN + 3,
    EA_OPERATOR_NOT = EA_OPERATOR_BOOLEAN2BOOLEAN + 4,
 
    /* float to boolean operators */
    EA_OPERATOR_FLOAT2BOOLEAN = 0x0400,
    EA_OPERATOR_EQ = EA_OPERATOR_FLOAT2BOOLEAN + 1, 
    EA_OPERATOR_LE = EA_OPERATOR_FLOAT2BOOLEAN + 2, 
    EA_OPERATOR_GE = EA_OPERATOR_FLOAT2BOOLEAN + 3, 
    EA_OPERATOR_GT = EA_OPERATOR_FLOAT2BOOLEAN + 4, 
    EA_OPERATOR_LT = EA_OPERATOR_FLOAT2BOOLEAN + 5, 
    EA_OPERATOR_NE = EA_OPERATOR_FLOAT2BOOLEAN + 6, 
 
    /* float to float operators */
    EA_OPERATOR_FLOAT2FLOAT = 0x0500,
    EA_OPERATOR_ADD = EA_OPERATOR_FLOAT2FLOAT + 1,
    EA_OPERATOR_SUB = EA_OPERATOR_FLOAT2FLOAT + 2,
    EA_OPERATOR_MUL = EA_OPERATOR_FLOAT2FLOAT + 3,
    EA_OPERATOR_DIV = EA_OPERATOR_FLOAT2FLOAT + 4,
    EA_OPERATOR_MOD = EA_OPERATOR_FLOAT2FLOAT + 5,
 
    /* string operators */
    EA_OPERATOR_STRING2BOOLEAN = 0x0600,
    EA_OPERATOR_STR_EQ = EA_OPERATOR_STRING2BOOLEAN + 1,    
    EA_OPERATOR_STR_NE = EA_OPERATOR_STRING2BOOLEAN + 2,    
 
    /* unary operators */
    EA_OPERATOR_UNARY = 0x0700,
    EA_OPERATOR_EXISTS = EA_OPERATOR_UNARY + 1,             
    EA_OPERATOR_PATHFROM = EA_OPERATOR_UNARY + 2,           
    EA_OPERATOR_PATHPROPERTYFROM = EA_OPERATOR_UNARY + 3,   
 
    /* terminal values (leafs) */
    EA_VALUE = 0x0A00,
    EA_VALUE_STRING = EA_VALUE + 1,                     
    EA_VALUE_STRING_WITHINJECTION = EA_VALUE + 2,       
    EA_VALUE_FLOAT = EA_VALUE + 3,                      
    EA_VALUE_RAW = EA_VALUE + 4,                        
    EA_VALUE_CVARNAME = EA_VALUE + 5,                   
    EA_VALUE_CVARNAME_WITHINJECTION = EA_VALUE + 6,     
    EA_VALUE_PATHNODE = EA_VALUE + 7,                   
    EA_VALUE_PATHNODE_WITHINJECTION = EA_VALUE + 8,     
    EA_VALUE_PATHPROPERTY = EA_VALUE + 9,               
    EA_VALUE_PATHPROPERTY_WITHINJECTION = EA_VALUE + 10,
    EA_VALUE_NODEPROPERTY = EA_VALUE + 11,              
    EA_VALUE_VAR = EA_VALUE + 12,                       
    EA_VALUE_CVAR = EA_VALUE + 13,                      
    EA_VALUE_NODE = EA_VALUE + 14,                      
    EA_VALUE_PARAM = EA_VALUE + 15,                     
    EA_VALUE_PARAMCOUNT = EA_VALUE + 16,                
    EA_VALUE_THIS = EA_VALUE + 17,                      
    EA_VALUE_WINDOW = EA_VALUE + 18,                    
    EA_VALUE_PARENT = EA_VALUE + 19,                    
    EA_VALUE_CHILD = EA_VALUE + 20                      
} uiActionType_t;
 
 

typedef union uiTerminalActionData_s {
    int integer;
    float number;
    const char* constString;
    void* data;
    const void* constData;
} uiTerminalActionData_t;

typedef struct uiAction_s {
    short type;

    short subType;

    union {
        struct {
            struct uiAction_s* left;
            struct uiAction_s* right;
        } nonTerminal;

        struct {
            uiTerminalActionData_t d1;
            uiTerminalActionData_t d2;
        } terminal;
    } d;

    struct uiAction_s* next;
} uiAction_t;
 
/* prototype */
struct uiNode_t;
struct cvar_s;

typedef struct uiValue_s {
    uiActionType_t type;    
    union {
        int integer;
        float number;
        char* string;
        struct cvar_s* cvar;
        uiNode_t* node;
    } value;
} uiValue_t;

typedef struct uiCallContext_s {
    uiNode_t* source;
    uiNode_t* tagNode;
    bool useCmdParam;
    linkedList_t* params;
    int paramNumber;
    int varPosition;
    int varNumber;
    bool breakLoop;
} uiCallContext_t;
 
void UI_ExecuteEventActions(uiNode_t* source, const uiAction_t* firstAction);
void UI_ExecuteConFuncActions(uiNode_t* source, const uiAction_t* firstAction);
void UI_ExecuteEventActionsEx (uiNode_t* source, const uiAction_t* firstAction, linkedList_t* params);
bool UI_IsInjectedString(const char* string);
void UI_FreeStringProperty(void* pointer);
const char* UI_GenInjectedString(const char* input, bool addNewLine, const uiCallContext_t* context);
int UI_GetActionTokenType(const char* token, int group);
uiValue_t* UI_GetVariable (const uiCallContext_t* context, int relativeVarId);
 
void UI_PoolAllocAction(uiAction_t** action, int type, const void* data);
uiAction_t* UI_AllocStaticCommandAction(const char* command);
void UI_InitActions(void);
void UI_AddListener(uiNode_t* node, const value_t* property, uiNode_t const* functionNode);
void UI_RemoveListener(uiNode_t* node, const value_t* property, uiNode_t* functionNode);
 
const char* UI_GetParam(const uiCallContext_t* context, int paramID);
int UI_GetParamNumber(const uiCallContext_t* context);