Elaztek Developer Hub
Blamite Game Engine - blam!  00398.09.22.23.2015.blamite
The core library for the Blamite Game Engine.
debug_menu.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include <string>
4 #include <vector>
5 
6 #define MENU_ITEM_TYPE_UNKNOWN BlamDebugMenuItemType::Unknown
7 #define MENU_ITEM_TYPE_EXEC BlamDebugMenuItemType::Command
8 #define MENU_ITEM_TYPE_CATEGORY BlamDebugMenuItemType::Submenu
9 #define MENU_ITEM_TYPE_GLOBAL BlamDebugMenuItemType::Global
10 #define MENU_ITEM_TYPE_MULTIEXEC BlamDebugMenuItemType::CommandSequence
11 
12 #define DEBUG_MENU_FILE "debug_menu_init"
13 
14 #ifndef BLAM
15 #define BLAM
16 #endif
17 
18 namespace InternalUI
19 {
20  BLAM void CreateFPSCounter();
21  BLAM void UpdateFPSCounter();
22 }
23 
28 {
29  Command,
30 
39  Global,
40  Submenu,
41  Unknown
42 };
43 
50 {
51 public:
53  std::string title;
54 
55  // Properties specific to #BlamDebugMenuItemType::Command
56 
57  std::string exec_line = "";
58 
59  // Properties specific to #BlamDebugMenuItemType::CommandSequence
60 
61  std::vector<std::string> exec_sequence = std::vector<std::string>();
63 
64  // Properties specific to #BlamDebugMenuItemType::Global
65 
66  std::string global_id = "";
67  bool use_bounds = false;
68  double inc = 1;
69  double min = 0;
70  double max = 0;
71 
72  // Properties specific to #BlamDebugMenuItemType::Submenu
73  std::vector<BlamDebugMenuItem> items;
74 
79 
83  void HandleKeyEnter();
84 
88  void HandleKeyLeft();
89 
93  void HandleKeyRight();
94 };
95 
100 {
101  std::string title;
102  std::vector<BlamDebugMenuItem> items;
103 };
104 
109 {
124  BLAM void InitializeDebugMenu();
125 
129  BLAM void ReleaseDebugMenu();
130 
134  BLAM void ReloadDebugMenu();
135 
142 }
BlamUIWidget_Group::RefreshRelativePosition
void RefreshRelativePosition() override
Definition: group.cpp:140
SDLK_BACKSPACE
@ SDLK_BACKSPACE
Definition: SdlEmulationLayer.h:387
BlamUIWidget::hidden
bool hidden
Definition: ui.h:94
BlamDebugMenuItem::title
std::string title
The title of the debug menu item as shown in the menu.
Definition: debug_menu.h:53
BlamUIWidget_BasicRectangle::SetHidden
void SetHidden(bool new_hidden) override
Definition: rectangle.cpp:227
BlamUIWidget_DebugMenu::Draw
void Draw() override
Definition: debug_menu.cpp:104
BlamUIWidget_BasicRectangle::UpdateMetrics
void UpdateMetrics() override
Definition: rectangle.cpp:182
BlamUIWidget_DebugMenu::OnKeyPressEvent
void OnKeyPressEvent(KeyPressEvent *event) override
Definition: debug_menu.cpp:275
BlamUIWidget_DebugMenu::menu_item_size
BlamVector2 menu_item_size
Definition: debug_menu.h:103
BlamUIWidget::update
bool update
Definition: ui.h:93
Blam::Logger::LogEvent
BLAM void LogEvent(std::string message)
Logs a message to the log and/or console.
Definition: aliases.cpp:142
BlamEngineDataFolder::DataRoot
@ DataRoot
The root of all game engine data. Defaults to ./
Blam::Globals::GetGlobal
BLAM EngineGlobal * GetGlobal(std::string name)
Retrieves a global with the specified ID.
Definition: globals.cpp:193
MENU_ITEM_TYPE_MULTIEXEC
#define MENU_ITEM_TYPE_MULTIEXEC
Macro for ExecSequence. See #Blam::Resources::DebugMenu::ExecSequence for details.
Definition: debug_menu.h:10
BlamUIWidget_VLayoutGroup::item_spacing
int item_spacing
Definition: ui.h:173
Blam::Globals::EngineGlobal::float_value
float float_value
The float value of the global.
Definition: globals.h:80
BlamDebugMenuItem::exec_line
std::string exec_line
The command to run upon activation for an Executor menu item type.
Definition: debug_menu.h:57
BlamDebugMenuItem::inc
double inc
How much to add or remove from the value at a time upon activation.
Definition: debug_menu.h:68
Blam::Globals::Int
@ Int
Represents an int.
Definition: globals.h:49
BlamUIWidget_Group
Definition: ui.h:141
BlamUIWidget::position
BlamVector2 position
Definition: ui.h:102
BlamDebugMenuItemType::Submenu
@ Submenu
Enters into a submenu/subscreen upon activation.
SDLK_HOME
@ SDLK_HOME
Definition: SdlEmulationLayer.h:477
color
BlamColor color
Typedef for a color field, used in tag definitions.
Definition: tags.h:359
BlamDebugMenuItem::exec_sequence
std::vector< std::string > exec_sequence
The command sequence to run upon activation for an ExecSequence menu item type.
Definition: debug_menu.h:61
Blam::Resources::DebugMenu::GetDebugMenu
BLAM BlamDebugMenu * GetDebugMenu()
Retrieves the debug menu data.
Definition: debug_menu.cpp:411
logger.h
BlamUIWidget::MarkForUpdate
void MarkForUpdate()
Definition: BlamUIWidget.cpp:354
BlamUIWidget_DebugMenu_Item::ConfigureHotkeyText
void ConfigureHotkeyText(int index)
Definition: debug_menu_item.cpp:302
BlamDebugMenuItem::BlamDebugMenuItem
BlamDebugMenuItem()
Creates a new debug menu item.
Definition: BlamDebugMenuItem.cpp:6
imgui.h
BlamUIWidget_DebugMenu::GetAnimatedActiveItemBackground
BlamColor GetAnimatedActiveItemBackground()
Definition: debug_menu.cpp:533
BlamFontPackageType::Unknown
@ Unknown
Blam::Globals::Long
@ Long
Represents a long.
Definition: globals.h:46
Blam::Globals
Namespace containing things relating to game engine globals.
Definition: globals.h:23
BlamDebugMenuItem::current_exec_index
int current_exec_index
The index of the next item to run within the execution sequence.
Definition: debug_menu.h:62
BlamUIWidget_VLayoutGroup::padding
BlamVector4 padding
Definition: ui.h:172
BlamDebugMenuItem::HandleKeyLeft
void HandleKeyLeft()
Called when the menu item is active and the left arrow key is pressed.
Definition: BlamDebugMenuItem.cpp:41
Blam::Globals::GetGlobalAsFloat
BLAM float * GetGlobalAsFloat(std::string name)
Retrieves a global's value as a float.
Definition: globals.cpp:407
BlamUIWidget_DebugMenu::cached_scale_factor
float cached_scale_factor
Definition: debug_menu.h:102
BlamUIWidget_Text::SetHidden
void SetHidden(bool new_hidden) override
Definition: text.cpp:588
SDLK_UP
@ SDLK_UP
Definition: SdlEmulationLayer.h:485
BlamUIWidget::GetType
BlamWidgetType GetType()
Definition: BlamUIWidget.cpp:180
BlamUIWidget_DebugMenu::RefreshRelativePosition
void RefreshRelativePosition() override
Definition: debug_menu.cpp:182
load_menu_item
BlamResult load_menu_item(rapidxml::xml_node<> *entry_node, BlamDebugMenuItem *menu_item)
Loads data for a debug menu item from an XML node.
Definition: debug_menu.cpp:27
USER_DATA_PATH
#define USER_DATA_PATH(path)
Macro to quickly access a user data folder.
Definition: config.h:43
BlamDebugMenuItem::items
std::vector< BlamDebugMenuItem > items
The contents of the submenu to show upon activation.
Definition: debug_menu.h:73
BlamUIWidget_Group::UpdateMetrics
void UpdateMetrics() override
Definition: group.cpp:155
console.h
Blam::Globals::EngineGlobal::read_only
bool read_only
Whether or not the global is protected from modification.
Definition: globals.h:70
BlamUIWidget::size
BlamVector2 size
Definition: ui.h:103
BlamUIWidget_DebugMenu_Item::UpdateMetrics
void UpdateMetrics() override
Definition: debug_menu_item.cpp:154
Blam::Globals::EngineGlobal::short_value
short short_value
The short value of the global.
Definition: globals.h:77
BlamCommandType::Global
@ Global
A command that is used to modify a global.
BlamUIWidget_VLayoutGroup::ShowImGuiPropertyEditor
void ShowImGuiPropertyEditor() override
Definition: vlayout.cpp:26
Blam::Animation::ColorTransitionAnimation::GetColor
D2D1_COLOR_F GetColor()
Returns the evaluated color data.
Definition: ColorTransition.h:173
Blam::Resources::DebugMenu::InitializeDebugMenu
BLAM void InitializeDebugMenu()
Initializes the debug menu.
Definition: debug_menu.cpp:309
BlamUIWidget_DebugMenu_Item
Definition: debug_menu.h:16
BlamUIWidget::SetPosition
virtual void SetPosition(BlamVector2 new_position)
Definition: BlamUIWidget.cpp:330
SDLK_RETURN
@ SDLK_RETURN
Definition: SdlEmulationLayer.h:385
MENU_ITEM_TYPE_GLOBAL
#define MENU_ITEM_TYPE_GLOBAL
Macro for Global. See #Blam::Resources::DebugMenu::Global for details.
Definition: debug_menu.h:9
errors.h
Blam::Animation::ColorTransitionAnimation::Initialize
void Initialize(D2D1_COLOR_F _c1, D2D1_COLOR_F _c2, float fade_duration, bool _loop)
Prepares data needed for the animation.
Definition: ColorTransition.h:135
BLAM
#define BLAM
Definition: debug_menu.h:15
BlamUIWidget_DebugMenu_Item::SetMenuItem
void SetMenuItem(BlamDebugMenuItem _menu_item)
Definition: debug_menu_item.cpp:282
Blam::Resources::DebugMenu
Namespace containing data for the engine's debug menu.
Definition: debug_menu.h:108
BlamUIWidget_Group::ShowImGuiPropertyEditor
void ShowImGuiPropertyEditor() override
Definition: group.cpp:98
ImGui::CollapsingHeader
IMGUI_API bool CollapsingHeader(const char *label, ImGuiTreeNodeFlags flags=0)
Definition: imgui_widgets.cpp:5422
Blam::Globals::EngineGlobal
Structure containing data for a game engine global.
Definition: globals.h:64
BlamUIWidget_Text::Draw
void Draw() override
Definition: text.cpp:115
BlamWidgetAnchor::TopLeft
@ TopLeft
The widget will be placed at the top-left of the screen.
BlamUIWidget_Group::children
std::vector< BlamUIWidget * > children
Definition: ui.h:148
debug_menu.h
BlamUIWidget::display_name
std::string display_name
Definition: ui.h:99
Blam::Globals::Float
@ Float
Represents a float.
Definition: globals.h:50
InternalUI::CreateFPSCounter
BLAM void CreateFPSCounter()
BlamUIWidget_Text::color
BlamColor color
Definition: ui.h:323
SDLK_PAGEUP
@ SDLK_PAGEUP
Definition: SdlEmulationLayer.h:478
BlamUIWidget::SetHidden
virtual void SetHidden(bool new_hidden)
Definition: BlamUIWidget.cpp:377
BlamUIWidget::SetSize
void SetSize(BlamVector2 new_size)
Definition: BlamUIWidget.cpp:323
BlamWidgetType::DebugMenuItem
@ DebugMenuItem
Special widget. Represents an item within the debug menu.
SDLK_RIGHT
@ SDLK_RIGHT
Definition: SdlEmulationLayer.h:482
ENGINE_DATA_PATH
#define ENGINE_DATA_PATH(path)
Macro to quickly access a game engine data folder.
Definition: config.h:36
BlamDebugMenuItem::HandleKeyRight
void HandleKeyRight()
Called when the menu item is active and the right arrow key is pressed.
Definition: BlamDebugMenuItem.cpp:168
Blam::Resources::Console::RunCommandLine
BLAM HRESULT RunCommandLine(std::string command_line)
Executed the provided string as a console command.
Definition: console.cpp:271
BlamDebugMenuItemType::CommandSequence
@ CommandSequence
Runs a sequence of console commands upon activation.
parse_debug_menu_xml_contents
BlamResult parse_debug_menu_xml_contents(std::string file_path)
Reads the specified file as an XML document and builds debug menu data from it.
Definition: debug_menu.cpp:213
BlamUIWidget_DebugMenu::GetHotkeyCharacterFromIndex
char GetHotkeyCharacterFromIndex(int index)
Definition: debug_menu.cpp:550
main_menu
BlamDebugMenu * main_menu
The debug menu data.
Definition: debug_menu.cpp:15
BlamUIWidget_DebugMenu::OnTickEvent
void OnTickEvent(TickEvent *event) override
Definition: debug_menu.cpp:187
Blam::Globals::EngineGlobal::long_value
long long_value
The long value of the global.
Definition: globals.h:78
BlamUIWidget_VLayoutGroup::auto_height
bool auto_height
Definition: ui.h:174
BlamUIWidget_DebugMenu::UpdateMetrics
void UpdateMetrics() override
Definition: debug_menu.cpp:154
BlamDebugMenuItem::item_type
BlamDebugMenuItemType item_type
The type of menu item. See BlamDebugMenuItemType for details.
Definition: debug_menu.h:52
globals.h
BlamUIWidget_DebugMenu_Item::SetSize
void SetSize(float scale)
Definition: debug_menu_item.cpp:329
BlamUIWidget_VLayoutGroup::Draw
void Draw() override
Definition: vlayout.cpp:15
BlamDebugMenuItem
Class used to store data and functions relating to an item within the engine's debug menu.
Definition: debug_menu.h:49
BlamUIWidget_BasicRectangle::Draw
void Draw() override
Definition: rectangle.cpp:118
BlamUIWidget_BasicRectangle
Definition: ui.h:184
Blam::Globals::Short
@ Short
Represents a short.
Definition: globals.h:45
BlamUIWidget_VLayoutGroup::RefreshRelativePosition
void RefreshRelativePosition() override
Definition: vlayout.cpp:48
Blam::Globals::EngineGlobal::int_value
int int_value
The int value of the global.
Definition: globals.h:79
BlamEngineDataFolder::DefaultConfigs
@ DefaultConfigs
Directory containing default configuration files. Defaults to ./content/blam/default_configs/
BlamUIWidget
Definition: ui.h:82
BlamDebugMenu::items
std::vector< BlamDebugMenuItem > items
The list of items within the debug menu.
Definition: debug_menu.h:102
BlamDebugMenuItemType::Command
@ Command
Runs a console command upon activation.
SDLK_LEFT
@ SDLK_LEFT
Definition: SdlEmulationLayer.h:483
DEBUG_MENU_FILE
#define DEBUG_MENU_FILE
The file name to load the debug menu contents from - without the extension.
Definition: debug_menu.h:12
BlamDebugMenuItem::global_id
std::string global_id
The ID of the engine global to modify upon activation.
Definition: debug_menu.h:66
SDLK_DOWN
@ SDLK_DOWN
Definition: SdlEmulationLayer.h:484
Blam::Resources::DebugMenu::ReloadDebugMenu
BLAM void ReloadDebugMenu()
Clears all existing data for the debug menu and reloads it from the file.
Definition: debug_menu.cpp:405
Blam::Resources::DebugMenu::ReleaseDebugMenu
BLAM void ReleaseDebugMenu()
Releases all debug menu contents.
Definition: debug_menu.cpp:393
BlamDebugMenuItem::HandleKeyEnter
void HandleKeyEnter()
Called when the menu item is active and the enter key is pressed.
Definition: BlamDebugMenuItem.cpp:11
BlamDebugMenuItem::max
double max
The maximum value specified in debug_menu_init.
Definition: debug_menu.h:70
BlamUIWidget_Text::text
std::string text
Definition: ui.h:327
BlamDebugMenuItem::use_bounds
bool use_bounds
Whether or not arbitrary bounds are specified in debug_menu_init.
Definition: debug_menu.h:67
BlamUIWidget_DebugMenu::BlamUIWidget_DebugMenu
BlamUIWidget_DebugMenu()
Definition: debug_menu.cpp:12
BlamUIWidget::RefreshRelativePosition
virtual void RefreshRelativePosition()
Definition: BlamUIWidget.cpp:185
SDLK_TAB
@ SDLK_TAB
Definition: SdlEmulationLayer.h:388
Blam::Animation::ColorTransitionAnimation::Start
void Start()
Instructs the listener to start animating.
Definition: ColorTransition.h:159
BlamUIWidget_VLayoutGroup
Definition: ui.h:166
BlamDebugMenu::title
std::string title
The title of the main page of the debug menu. Defaults to Main.
Definition: debug_menu.h:101
BlamUIWidget_DebugMenu::ShowImGuiPropertyEditor
void ShowImGuiPropertyEditor() override
Definition: debug_menu.cpp:136
BlamUIWidget_Group::ClearChildren
void ClearChildren()
Definition: group.cpp:193
BlamUIWidget_DebugMenu_Item::SetActive
void SetActive(bool _active)
Definition: debug_menu_item.cpp:233
MENU_ITEM_TYPE_CATEGORY
#define MENU_ITEM_TYPE_CATEGORY
Macro for Submenu. See #Blam::Resources::DebugMenu::Submenu for details.
Definition: debug_menu.h:8
BlamUIWidget::IsHidden
bool IsHidden()
Definition: BlamUIWidget.cpp:382
InternalUI
Namespace containing things for the engine's "internal UI", which is powered through ImGUI.
Definition: debug_menu.h:18
Blam::Logger::LogEventForce
BLAM void LogEventForce(std::string message)
Forcibly logs a message to the log and/or console.
Definition: aliases.cpp:274
MENU_ITEM_TYPE_UNKNOWN
#define MENU_ITEM_TYPE_UNKNOWN
Macro for Unknown. See #Blam::Resources::DebugMenu::Unknown for details.
Definition: debug_menu.h:6
BlamUIWidget::z_index
int z_index
Definition: ui.h:106
BlamDebugMenuItemType
BlamDebugMenuItemType
Menu item type enumerator.
Definition: debug_menu.h:27
BlamUIWidget_DebugMenu_Item::IsHeader
bool IsHeader()
Definition: debug_menu_item.cpp:277
BlamWidgetType
BlamWidgetType
Enumerator listing possible UI widget types.
Definition: ui.h:60
BlamUIWidget_DebugMenu::OnCharacterInputEvent
void OnCharacterInputEvent(CharacterInputEvent *event) override
Definition: debug_menu.cpp:224
Blam::Globals::EngineGlobal::value_raw
std::string value_raw
The raw value of the global as a string.
Definition: globals.h:69
config.h
BlamDebugMenu
Structure containing data for the root of the debug menu.
Definition: debug_menu.h:99
BlamUIWidget_DebugMenu::SetHidden
void SetHidden(bool new_hidden) override
Definition: debug_menu.cpp:525
BlamUserDataFolder::DataRoot
@ DataRoot
The root of all user data. Defaults to BlamStrings::Utils::IO::GetEngineDataRoot().
BlamUIWidget_BasicRectangle::color
BlamColor color
Definition: ui.h:196
MENU_ITEM_TYPE_EXEC
#define MENU_ITEM_TYPE_EXEC
Macro for Executor. See #Blam::Resources::DebugMenu::Executor for details.
Definition: debug_menu.h:7
BlamUIWidget_BasicRectangle::ShowImGuiPropertyEditor
void ShowImGuiPropertyEditor() override
Definition: rectangle.cpp:153
BlamUIWidget_DebugMenu::GetIndexFromHotkeyCharacter
int GetIndexFromHotkeyCharacter(char hotkey)
Definition: debug_menu.cpp:539
BlamUIWidget_DebugMenu::~BlamUIWidget_DebugMenu
~BlamUIWidget_DebugMenu()
Definition: debug_menu.cpp:99
DebugMenu
@ DebugMenu
Debug menu.
Definition: render_stack.h:79
InternalUI::UpdateFPSCounter
BLAM void UpdateFPSCounter()
Blam::Globals::EngineGlobal::type
GvarType type
The type of the global.
Definition: globals.h:66
BlamUIWidget_Group::SetHidden
void SetHidden(bool new_hidden) override
Definition: group.cpp:170
BlamUIWidget_Text
Definition: ui.h:293
BlamDebugMenuItem::min
double min
The minimum value specified in debug_menu_init.
Definition: debug_menu.h:69
Blam::Globals::EngineGlobal::boolean_value
bool boolean_value
The boolean value of the global.
Definition: globals.h:76
BlamUIWidget::SetAnchorPosition
void SetAnchorPosition(BlamWidgetAnchor new_anchor_position)
Definition: BlamUIWidget.cpp:343
Blam::Globals::GetGvarTypeLabel
BLAM std::string GetGvarTypeLabel(GvarType type)
Retrieves a string representation of a global's type, for use in UI.
Definition: globals.cpp:40