ui_node_optiontree.cpp

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.
 
*/
 
#include "../ui_main.h"
#include "../ui_parse.h"
#include "../ui_behaviour.h"
#include "../ui_actions.h"
#include "../ui_font.h"
#include "../ui_data.h"
#include "../ui_sprite.h"
#include "../ui_render.h"
#include "../ui_input.h"
#include "../ui_lua.h"
 
#include "ui_node_abstractoption.h"
#include "ui_node_abstractnode.h"
#include "ui_node_optiontree.h"
#include "ui_node_option.h"
#include "ui_node_panel.h"
 
#include "../../cl_language.h"
#include "../../input/cl_keys.h"
 
#include "../../../common/scripts_lua.h"
 
#define EXTRADATA_TYPE abstractOptionExtraData_t
#define EXTRADATA(node) UI_EXTRADATA(node, EXTRADATA_TYPE)
 
static const int COLLAPSEBUTTON_WIDTH = 20;     
static const int DEPTH_WIDTH = 25;              
 
static uiSprite_t* systemCollapse;
static uiSprite_t* systemExpand;
 
/* Used for drag&drop-like scrolling */
static int mouseScrollX;
static int mouseScrollY;

static void UI_OptionTreeNodeUpdateScroll (uiNode_t* node)
{
    const char* font;
    int fontHeight;
    bool updated;
    int elements;
 
    font = UI_GetFontFromNode(node);
    fontHeight = EXTRADATA(node).lineHeight;
    if (fontHeight == 0)
        fontHeight = UI_FontGetHeight(font);
 
    elements = (node->box.size[1] - node->padding - node->padding) / fontHeight;
    updated = EXTRADATA(node).scrollY.set(-1, elements, EXTRADATA(node).count);
    if (updated) {
        if (EXTRADATA(node).onViewChange) {
            UI_ExecuteEventActions(node, EXTRADATA(node).onViewChange);
        }
        else if (EXTRADATA(node).lua_onViewChange != LUA_NOREF) {
            UI_ExecuteLuaEventScript (node, EXTRADATA(node).lua_onViewChange);
        }
    }
}

static uiNode_t* UI_OptionTreeNodeGetFirstOption(uiNode_t* node);
 
static void UI_OptionTreeNodeUpdateCache (uiNode_t* node)
{
    uiNode_t* option = UI_OptionTreeNodeGetFirstOption(node);
    if (option)
        EXTRADATA(node).count = UI_OptionUpdateCache(option);
}

static uiNode_t* UI_OptionTreeNodeGetFirstOption (uiNode_t* node)
{
    if (node->firstChild) {
        assert(node->firstChild->behaviour == ui_optionBehaviour);
        return node->firstChild;
    } else {
        const int v = UI_GetDataVersion(EXTRADATA(node).dataId);
        uiNode_t* option = UI_GetOption(EXTRADATA(node).dataId);
        if (v != EXTRADATA(node).versionId) {
            EXTRADATA(node).versionId = v;
            UI_OptionTreeNodeUpdateCache(node);
        }
        return option;
    }
}
 
void uiOptionTreeNode::draw (uiNode_t* node)
{
    uiNode_t* option;
    const char* ref;
    const char* font;
    vec2_t pos;
    int fontHeight;
    int currentY;
    int currentDecY = 0;
    const float* textColor;
    int count = 0;
    uiOptionIterator_t iterator;
 
    if (!systemExpand)
        systemExpand = UI_GetSpriteByName("icons/system_expand");
    if (!systemCollapse)
        systemCollapse = UI_GetSpriteByName("icons/system_collapse");
 
    ref = UI_AbstractOption_GetCurrentValue(node);
    if (ref == nullptr)
        return;
 
    UI_GetNodeAbsPos(node, pos);
 
    if (EXTRADATA(node).background) {
        UI_DrawSpriteInBox(false, EXTRADATA(node).background, SPRITE_STATUS_NORMAL, pos[0], pos[1], node->box.size[0], node->box.size[1]);
    }
 
    font = UI_GetFontFromNode(node);
    fontHeight = EXTRADATA(node).lineHeight;
    currentY = pos[1] + node->padding;
    if (fontHeight == 0)
        fontHeight = UI_FontGetHeight(font);
    else {
        const int height = UI_FontGetHeight(font);
        currentDecY = (fontHeight - height) / 2;
    }
 
    /* skip option over current position */
    option = UI_OptionTreeNodeGetFirstOption(node);
    UI_OptionTreeNodeUpdateScroll(node);
    option = UI_InitOptionIteratorAtIndex(EXTRADATA(node).scrollY.viewPos, option, &iterator);
 
    /* draw all available options for this selectbox */
    for (; option; option = UI_OptionIteratorNextOption(&iterator)) {
        int decX;
 
        /* outside the node */
        if (currentY + fontHeight > pos[1] + node->box.size[1] - node->padding) {
            count++;
            break;
        }
 
        /* draw the hover effect */
        if (OPTIONEXTRADATA(option).hovered)
            UI_DrawFill(pos[0] + node->padding, currentY, node->box.size[0] - node->padding - node->padding, fontHeight, node->color);
 
        /* text color */
        if (Q_streq(OPTIONEXTRADATA(option).value, ref)) {
            textColor = node->selectedColor;
        } else if (node->disabled || option->disabled) {
            textColor = node->disabledColor;
        } else if (option->color[3] == 0.0f) {
            textColor = node->color;
        } else {
            textColor = option->color;
        }
 
        /* print the option label */
        decX = pos[0] + node->padding + iterator.depthPos * DEPTH_WIDTH;
 
        R_Color(nullptr);
        if (option->firstChild) {
            uiSprite_t* icon = OPTIONEXTRADATA(option).collapsed ? systemExpand : systemCollapse;
            UI_DrawSpriteInBox(OPTIONEXTRADATA(option).flipIcon, icon, SPRITE_STATUS_NORMAL, decX, currentY, icon->size[0], fontHeight);
        }
 
        decX += COLLAPSEBUTTON_WIDTH;
 
        if (OPTIONEXTRADATA(option).icon) {
            uiSpriteStatus_t iconStatus = SPRITE_STATUS_NORMAL;
            if (option->disabled)
                iconStatus = SPRITE_STATUS_DISABLED;
            UI_DrawSpriteInBox(OPTIONEXTRADATA(option).flipIcon, OPTIONEXTRADATA(option).icon, iconStatus, decX, currentY,
                    OPTIONEXTRADATA(option).icon->size[0], fontHeight);
            decX += OPTIONEXTRADATA(option).icon->size[0] + fontHeight / 4;
        }
 
        const char* label = CL_Translate(OPTIONEXTRADATA(option).label);
 
        R_Color(textColor);
        UI_DrawString(font, ALIGN_UL, decX, currentY + currentDecY,
            pos[0], node->box.size[0] - node->padding - node->padding,
            0, label, 0, 0, nullptr, false, LONGLINES_PRETTYCHOP);
 
        /* next entries' position */
        currentY += fontHeight;
        count++;
    }
    R_Color(nullptr);
}
 
static uiNode_t* UI_OptionTreeNodeGetOptionAtPosition (uiNode_t* node, int x, int y, int* depth)
{
    uiNode_t* option;
    const char* font;
    int fontHeight;
    int count;
    uiOptionIterator_t iterator;
 
    UI_NodeAbsoluteToRelativePos(node, &x, &y);
 
    font = UI_GetFontFromNode(node);
    fontHeight = EXTRADATA(node).lineHeight;
    if (fontHeight == 0)
        fontHeight = UI_FontGetHeight(font);
 
    option = UI_OptionTreeNodeGetFirstOption(node);
    count = EXTRADATA(node).scrollY.viewPos + (y - node->padding) / fontHeight;
    option = UI_InitOptionIteratorAtIndex(count, option, &iterator);
    *depth = iterator.depthPos;
    return option;
}

void uiOptionTreeNode::onLeftClick (uiNode_t* node, int x, int y)
{
    uiNode_t* option;
    int depth;
 
    if (UI_AbstractOption_GetCurrentValue(node) == nullptr)
        return;
 
    /* select the right option */
    option = UI_OptionTreeNodeGetOptionAtPosition(node, x, y, &depth);
 
    UI_NodeAbsoluteToRelativePos(node, &x, &y);
 
    /* extend/collapse*/
    x -= depth * DEPTH_WIDTH;
    if (x >= 0 && x < COLLAPSEBUTTON_WIDTH) {
        if (option && option->firstChild) {
            OPTIONEXTRADATA(option).collapsed = !OPTIONEXTRADATA(option).collapsed;
            UI_OptionTreeNodeUpdateCache(node);
        }
        return;
    }
 
    /* update the status */
    if (option)
        UI_AbstractOption_SetCurrentValue(node, OPTIONEXTRADATA(option).value);
}

bool uiOptionTreeNode::onScroll (uiNode_t* node, int deltaX, int deltaY)
{
    bool down = deltaY > 0;
    bool updated;
    if (deltaY == 0)
        return false;
    updated = EXTRADATA(node).scrollY.move(EXTRADATA(node).scrollY.viewPos + (down ? 1 : -1));
    if (updated) {
        if (EXTRADATA(node).onViewChange) {
            UI_ExecuteEventActions(node, EXTRADATA(node).onViewChange);
        }
        else if (EXTRADATA(node).lua_onViewChange != LUA_NOREF) {
            UI_ExecuteLuaEventScript (node, EXTRADATA(node).lua_onViewChange);
        }
    }
    /* @todo use super behaviour */
    if (node->onWheelUp && !down) {
        UI_ExecuteEventActions(node, node->onWheelUp);
        updated = true;
    }
    if (node->onWheelDown && down) {
        UI_ExecuteEventActions(node, node->onWheelDown);
        updated = true;
    }
    if (node->onWheel) {
        UI_ExecuteEventActions(node, node->onWheel);
        updated = true;
    }
    return updated;
}

void uiOptionTreeNode::onLoading (uiNode_t* node)
{
    Vector4Set(node->color, 1, 1, 1, 1);
    Vector4Set(node->disabledColor, 0.5, 0.5, 0.5, 1.0);
    EXTRADATA(node).versionId = -1;
    node->padding = 3;
}
 
void uiOptionTreeNode::onLoaded (uiNode_t* node)
{
}
 
void UI_OptionTree_SelectValue (uiNode_t* node, const char* value) {
    /* is the option exists */
    uiNode_t* firstOption = UI_OptionTreeNodeGetFirstOption(node);
 
    uiOptionIterator_t iterator;
    UI_InitOptionIteratorAtIndex(0, firstOption, &iterator, false, true);
    uiNode_t* option = UI_FindOptionByValue(&iterator, value);
 
    /* update the selection */
    if (option) {
        UI_AbstractOption_SetCurrentValue(node, OPTIONEXTRADATA(option).value);
    } else {
        Com_Printf("UI_OptionTree_SelectValue: Option value \"%s\" not found\n", value);
        return;
    }
 
    /* expend parents */
    for (int i = 0; i < iterator.depthPos; i++)
        OPTIONEXTRADATA(iterator.depthCache[i]).collapsed = false;
    UI_OptionTreeNodeUpdateCache(node);
    UI_OptionTreeNodeUpdateScroll(node);
 
    /* fix scroll bar */
    firstOption = UI_OptionTreeNodeGetFirstOption(node);
    UI_InitOptionIteratorAtIndex(0, firstOption, &iterator);
    int pos = UI_FindOptionPosition(&iterator, option);
    if (pos == -1)
        return;
 
    bool updated;
    updated = EXTRADATA(node).scrollY.move(pos);
    if (updated) {
        if (EXTRADATA(node).onViewChange) {
            UI_ExecuteEventActions(node, EXTRADATA(node).onViewChange);
        }
        else if (EXTRADATA(node).lua_onViewChange != LUA_NOREF) {
            UI_ExecuteLuaEventScript (node, EXTRADATA(node).lua_onViewChange);
        }
    }
}
 
static void UI_OptionTreeSetSelectedValue (uiNode_t* node, const uiCallContext_t* context)
{
    if (UI_GetParamNumber(context) != 1) {
        Com_Printf("UI_OptionTreeSetSelectedValue: Invalide number of param\n");
        return;
    }
 
    const char* value = UI_GetParam(context, 1);
 
    UI_OptionTree_SelectValue(node, value);
}
 
void uiOptionTreeNode::doLayout (uiNode_t* node)
{
    UI_OptionTreeNodeUpdateCache(node);
    node->invalidated = false;
}

void uiOptionTreeNode::onMouseDown (uiNode_t* node, int x, int y, int button)
{
    if (!UI_GetMouseCapture() && button == K_MOUSE1 &&
        EXTRADATA(node).scrollY.fullSize > EXTRADATA(node).scrollY.viewSize) {
        UI_SetMouseCapture(node);
        mouseScrollX = x;
        mouseScrollY = y;
    }
}
 
void uiOptionTreeNode::onMouseUp (uiNode_t* node, int x, int y, int button)
{
    if (UI_GetMouseCapture() == node)  /* More checks can never hurt */
        UI_MouseRelease();
}
 
void uiOptionTreeNode::onCapturedMouseMove (uiNode_t* node, int x, int y)
{
    const int lineHeight = getCellHeight(node);
    const int deltaY = (mouseScrollY - y) / lineHeight;
    /* We're doing only vertical scroll, that's enough for the most instances */
    if (deltaY != 0) {
        bool updated;
        updated = EXTRADATA(node).scrollY.moveDelta(deltaY);
        if (updated) {
            if (EXTRADATA(node).onViewChange) {
                UI_ExecuteEventActions(node, EXTRADATA(node).onViewChange);
            }
            else if (EXTRADATA(node).lua_onViewChange != LUA_NOREF) {
                UI_ExecuteLuaEventScript (node, EXTRADATA(node).lua_onViewChange);
            }
        }
        /* @todo not accurate */
        mouseScrollX = x;
        mouseScrollY = y;
    }
    onMouseMove(node, x, y);
}

int uiOptionTreeNode::getCellHeight (uiNode_t* node)
{
    int lineHeight = EXTRADATA(node).lineHeight;
    if (lineHeight == 0)
        lineHeight = UI_FontGetHeight(UI_GetFontFromNode(node));
    return lineHeight;
}
 
void UI_RegisterOptionTreeNode (uiBehaviour_t* behaviour)
{
    behaviour->name = "optiontree";
    behaviour->extends = "abstractoption";
    behaviour->manager = UINodePtr(new uiOptionTreeNode());
    behaviour->drawItselfChild = true;
    behaviour->lua_SWIG_typeinfo = UI_SWIG_TypeQuery("uiOptionTreeNode_t *");
 
    /* Call this to toggle the node status. */
    UI_RegisterNodeMethod(behaviour, "setselectedvalue", UI_OptionTreeSetSelectedValue);
    /* Sprite used to display the background */
    UI_RegisterExtradataNodeProperty(behaviour, "background", V_UI_SPRITEREF, EXTRADATA_TYPE, background);
}