controller_base.cpp

Go to the documentation of this file.

/*
    Copyright (C) 2003 - 2025
    by Joerg Hinrichs <joerg.hinrichs@alice-dsl.de>
    Copyright (C) 2003 by David White <dave@whitevine.net>
    Part of the Battle for Wesnoth Project https://www.wesnoth.org/
 
    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.
 
    See the COPYING file for more details.
*/
 
#include "controller_base.hpp"
 
#include "display.hpp"
#include "events.hpp"
#include "game_config_manager.hpp"
#include "gui/widgets/settings.hpp"
#include "hotkey/command_executor.hpp"
#include "log.hpp"
#include "mouse_handler_base.hpp"
#include "preferences/preferences.hpp"
#include "scripting/plugins/context.hpp"
#include "gui/core/event/handler.hpp" // gui2::is_in_dialog
#include "soundsource.hpp"
#include "gui/core/timer.hpp"
#include "sdl/input.hpp" // get_mouse_state
#include "video.hpp"
 
static lg::log_domain log_display("display");
#define ERR_DP LOG_STREAM(err, log_display)
 
using namespace std::chrono_literals;
 
controller_base::controller_base()
    : game_config_(game_config_manager::get()->game_config())
    , scrolling_(false)
    , scroll_up_(false)
    , scroll_down_(false)
    , scroll_left_(false)
    , scroll_right_(false)
    , last_scroll_tick_()
    , scroll_carry_x_(0.0)
    , scroll_carry_y_(0.0)
    , key_release_listener_(*this)
    , long_touch_timer_(0)
{
}
 
controller_base::~controller_base()
{
    if(long_touch_timer_ != 0) {
        gui2::remove_timer(long_touch_timer_);
        long_touch_timer_ = 0;
    }
}
 
void controller_base::long_touch_callback(int x, int y)
{
    if(long_touch_timer_ != 0 && !get_mouse_handler_base().dragging_started()) {
        float x_now;
        float y_now;
        uint32_t mouse_state = sdl::get_mouse_state(&x_now, &y_now);
 
#ifdef MOUSE_TOUCH_EMULATION
        if(mouse_state & SDL_BUTTON(SDL_BUTTON_RIGHT)) {
            // Monkey-patch touch controls again to make them look like left button.
            mouse_state = SDL_BUTTON(SDL_BUTTON_LEFT);
        }
#endif
 
        // Workaround for double-menu b/c of slow events processing, or I don't know.
        int dx = x - x_now;
        int dy = y - y_now;
        int threshold = get_mouse_handler_base().drag_threshold();
        bool yes_actually_dragging = dx * dx + dy * dy >= threshold * threshold;
 
        if(!yes_actually_dragging
           && (mouse_state & SDL_BUTTON_MASK(SDL_BUTTON_LEFT)) != 0)
        {
            show_menu(get_display().get_theme().context_menu(), { static_cast<int>(x_now), static_cast<int>(y_now) }, true);
        }
    }
 
    long_touch_timer_ = 0;
}
 
void controller_base::handle_event(const SDL_Event& event)
{
    if(gui2::is_in_dialog()) {
        return;
    }
 
    events::mouse_handler_base& mh_base = get_mouse_handler_base();
 
    SDL_Event new_event = {};
 
    switch(event.type) {
    case SDL_EVENT_TEXT_INPUT:
        if(have_keyboard_focus()) {
            hotkey::key_event(event, get_hotkey_command_executor());
        }
        break;
 
    case SDL_EVENT_TEXT_EDITING:
        if(have_keyboard_focus()) {
            SDL_Event evt = event;
            evt.type = SDL_EVENT_TEXT_INPUT;
            hotkey::key_event(evt, get_hotkey_command_executor());
            SDL_StopTextInput(video::get_window());
            SDL_StartTextInput(video::get_window());
        }
        break;
 
    case SDL_EVENT_KEY_DOWN:
        // Detect key press events, unless there something that has keyboard focus
        // in which case the key press events should go only to it.
        if(have_keyboard_focus()) {
            if(event.key.key == SDLK_ESCAPE
                || event.key.key == SDLK_AC_BACK)
            {
                get_hotkey_command_executor()->execute_quit_command();
                break;
            }
 
            process_keydown_event(event);
            hotkey::key_event(event, get_hotkey_command_executor());
            process_keyup_event(event);
        } else {
            process_focus_keydown_event(event);
        }
        break;
 
    case SDL_EVENT_KEY_UP:
        process_keyup_event(event);
        hotkey::key_event(event, get_hotkey_command_executor());
        break;
 
    case SDL_EVENT_JOYSTICK_BUTTON_DOWN:
        hotkey::jbutton_event(event, get_hotkey_command_executor());
        break;
 
    case SDL_EVENT_JOYSTICK_HAT_MOTION:
        hotkey::jhat_event(event, get_hotkey_command_executor());
        break;
 
    case SDL_EVENT_MOUSE_MOTION:
        // Ignore old mouse motion events in the event queue
        if(SDL_PeepEvents(&new_event, 1, SDL_GETEVENT, SDL_EVENT_MOUSE_MOTION, SDL_EVENT_MOUSE_MOTION) > 0) {
            while(SDL_PeepEvents(&new_event, 1, SDL_GETEVENT, SDL_EVENT_MOUSE_MOTION, SDL_EVENT_MOUSE_MOTION) > 0) {};
 
            if(!events::is_touch(new_event.motion)) {
                mh_base.mouse_motion_event(new_event.motion, is_browsing());
            }
        } else {
            if(!events::is_touch(new_event.motion)) {
                mh_base.mouse_motion_event(event.motion, is_browsing());
            }
        }
        break;
 
    case SDL_EVENT_FINGER_MOTION:
        if(SDL_PeepEvents(&new_event, 1, SDL_GETEVENT, SDL_EVENT_FINGER_MOTION, SDL_EVENT_FINGER_MOTION) > 0) {
            while(SDL_PeepEvents(&new_event, 1, SDL_GETEVENT, SDL_EVENT_FINGER_MOTION, SDL_EVENT_FINGER_MOTION) > 0) {
            };
            mh_base.touch_motion_event(new_event.tfinger, is_browsing());
        } else {
            mh_base.touch_motion_event(event.tfinger, is_browsing());
        }
        break;
 
    case SDL_EVENT_MOUSE_BUTTON_DOWN:
        if(events::is_touch(event.button)) {
            int x = event.button.x;
            int y = event.button.y;
 
            if(long_touch_timer_ == 0) {
                long_touch_timer_ = gui2::add_timer(gui2::settings::popup_show_delay,
                    std::bind(&controller_base::long_touch_callback, this, x, y));
            }
        }
 
        mh_base.mouse_press(event.button, is_browsing());
        hotkey::mbutton_event(event, get_hotkey_command_executor());
        break;
 
    case SDL_EVENT_FINGER_DOWN:
        // handled by mouse case
        break;
 
    case SDL_EVENT_MOUSE_BUTTON_UP:
        if(long_touch_timer_ != 0) {
            gui2::remove_timer(long_touch_timer_);
            long_touch_timer_ = 0;
        }
 
        mh_base.mouse_press(event.button, is_browsing());
        if(mh_base.get_show_menu()) {
            show_menu(get_display().get_theme().context_menu(), { static_cast<int>(event.button.x), static_cast<int>(event.button.y) }, true);
        }
        break;
 
    case SDL_EVENT_FINGER_UP:
        // handled by mouse case
        break;
 
    case SDL_EVENT_MOUSE_WHEEL:
        // Right and down are positive in Wesnoth's map.
        // Right and up are positive in SDL_MouseWheelEvent on all platforms:
        //     https://wiki.libsdl.org/SDL2/SDL_MouseWheelEvent
#if defined(_WIN32) || defined(__APPLE__)
        mh_base.mouse_wheel(event.wheel.x, -event.wheel.y, is_browsing());
#else
        {
            mh_base.mouse_wheel(event.wheel.x, -event.wheel.y, is_browsing());
        }
#endif
        break;
 
    case TIMER_EVENT:
        gui2::execute_timer(reinterpret_cast<std::size_t>(event.user.data1));
        break;
 
    default:
        break;
    }
}
 
void controller_base::process()
{
    if(gui2::is_in_dialog()) {
        return;
    }
 
    hotkey::run_events(get_hotkey_command_executor());
}
 
void controller_base::keyup_listener::handle_event(const SDL_Event& event)
{
    if(event.type == SDL_EVENT_KEY_UP) {
        hotkey::keyup_event(event, controller_.get_hotkey_command_executor());
    }
}
 
bool controller_base::have_keyboard_focus()
{
    return true;
}
 
bool controller_base::handle_scroll(int mousex, int mousey, int mouse_flags)
{
    const bool mouse_in_window =
        video::window_has_mouse_focus()
        || prefs::get().get_scroll_when_mouse_outside(true);
 
    int scroll_speed = prefs::get().scroll_speed();
    double dx = 0.0, dy = 0.0;
 
    int scroll_threshold = prefs::get().mouse_scrolling()
        ? prefs::get().mouse_scroll_threshold()
        : 0;
 
    for(const theme::menu& m : get_display().get_theme().menus()) {
        if(m.get_location().contains(mousex, mousey)) {
            scroll_threshold = 0;
        }
    }
 
    // Scale scroll distance according to time passed
    auto tick_now = std::chrono::steady_clock::now();
 
    // If we weren't previously scrolling, start small.
    auto dt = 1ms;
    if (scrolling_) {
        dt = std::chrono::duration_cast<std::chrono::milliseconds>(tick_now - last_scroll_tick_);
    }
 
    // scroll_speed is in percent. Ticks are in milliseconds.
    // Let's assume the maximum speed (100) moves 50 hexes per second,
    // i.e. 3600 pixels per 1000 ticks.
    double scroll_amount = dt.count() * 0.036 * double(scroll_speed);
    last_scroll_tick_ = tick_now;
 
    // Apply keyboard scrolling
    dy -= scroll_up_    * scroll_amount;
    dy += scroll_down_  * scroll_amount;
    dx -= scroll_left_  * scroll_amount;
    dx += scroll_right_ * scroll_amount;
 
    // Scroll if mouse is placed near the edge of the screen
    if(mouse_in_window) {
        if(mousey < scroll_threshold) {
            dy -= scroll_amount;
        }
 
        if(mousey > video::game_canvas_size().y - scroll_threshold) {
            dy += scroll_amount;
        }
 
        if(mousex < scroll_threshold) {
            dx -= scroll_amount;
        }
 
        if(mousex > video::game_canvas_size().x - scroll_threshold) {
            dx += scroll_amount;
        }
    }
 
    events::mouse_handler_base& mh_base = get_mouse_handler_base();
 
    // Scroll with middle-mouse if enabled
    if((mouse_flags & SDL_BUTTON_MMASK) != 0 && prefs::get().middle_click_scrolls()) {
        const point original_loc = mh_base.get_scroll_start();
 
        if(mh_base.scroll_started()
            && get_display().map_outside_area().contains(mousex, mousey))
        {
            // Scroll speed is proportional from the distance from the first
            // middle click and scrolling speed preference.
            const double speed = 0.01 * scroll_amount;
            const double snap_dist = 16; // Snap to horizontal/vertical scrolling
            const double x_diff = (mousex - original_loc.x);
            const double y_diff = (mousey - original_loc.y);
 
            if(std::fabs(x_diff) > snap_dist || std::fabs(y_diff) <= snap_dist) {
                dx += speed * x_diff;
            }
 
            if(std::fabs(y_diff) > snap_dist || std::fabs(x_diff) <= snap_dist) {
                dy += speed * y_diff;
            }
        } else { // Event may fire mouse down out of order with respect to initial click
            mh_base.set_scroll_start(mousex, mousey);
        }
    }
 
    // If nothing is scrolling, just return.
    if (!dx && !dy) {
        return false;
    }
 
    // If we are continuing a scroll, carry over any subpixel movement.
    if (scrolling_) {
        dx += scroll_carry_x_;
        dy += scroll_carry_y_;
    }
    point dist{int(dx), int(dy)};
    scroll_carry_x_ = dx - double(dist.x);
    scroll_carry_y_ = dy - double(dist.y);
 
    // Scroll the display
    get_display().scroll(dist);
 
    // Even if the integer parts are both zero, we are still scrolling.
    // The subpixel amounts will add up.
    return true;
}
 
void controller_base::play_slice()
{
    if(plugins_context* l = get_plugins_context()) {
        l->play_slice();
    }
 
    events::pump();
    events::raise_process_event();
    events::draw();
 
    // Update sound sources before scrolling
    if(soundsource::manager* l = get_soundsource_man()) {
        l->update();
    }
 
    const theme::menu* const m = get_display().menu_pressed();
    if(m != nullptr) {
        const rect& menu_loc = m->location(video::game_canvas());
        show_menu(m, { menu_loc.x + 1, menu_loc.y + menu_loc.h + 1 }, false);
        return;
    }
 
    const theme::action* const a = get_display().action_pressed();
    if(a != nullptr) {
        execute_action(a->items());
        return;
    }
 
    auto str_vec = additional_actions_pressed();
    if(!str_vec.empty()) {
        execute_action(str_vec);
        return;
    }
 
    bool was_scrolling = scrolling_;
 
    float mousex, mousey;
    uint8_t mouse_flags = sdl::get_mouse_state(&mousex, &mousey);
 
    scrolling_ = handle_scroll(mousex, mousey, mouse_flags);
 
    map_location highlighted_hex = get_display().mouseover_hex();
 
    // Scrolling ended, update the cursor and the brightened hex
    if(!scrolling_ && was_scrolling) {
        get_mouse_handler_base().mouse_update(is_browsing(), highlighted_hex);
    }
}
 
bool controller_base::show_menu(const theme::menu* menu, const point& loc, bool context_menu)
{
    hotkey::command_executor* cmd_exec = get_hotkey_command_executor();
    if(!menu || !cmd_exec) {
        return false;
    }
 
    // context menus cannot appear outside map area,
    // but main top-panel menus can.
    if(context_menu && !get_display().map_area().contains(loc)) {
        return false;
    }
 
    cmd_exec->show_menu(menu->items(), loc, context_menu);
    return true;
}
 
void controller_base::execute_action(const std::vector<std::string>& items)
{
    hotkey::command_executor* cmd_exec = get_hotkey_command_executor();
    if(!cmd_exec) {
        return;
    }
 
    cmd_exec->execute_action(items);
}