Elaztek Developer Hub
Blamite Game Engine - Keystone  00381.04.17.23.2324.blamite
A library that enables the use of Qt in Blamite's editing tools.
BlamEditorDocument.h
Go to the documentation of this file.
1 #pragma once
2 
3 #include <qwidget.h>
4 #include <qmdisubwindow.h>
5 #include <string>
6 #include <Strings/components/settings/config/config.h>
7 
9 
10 #ifndef KEYSTONE
11 #define KEYSTONE
12 #endif
13 
14 class BlamEditorWindow;
16 
24 {
25  Tag,
26  GameWindow,
27  TagDesigner,
29 };
30 
38 {
39 private:
44 
45 public:
46 
48 
49  std::string document_title = "document";
51  bool loaded = true;
52  bool modified = false;
53 
54  bool override_icon = false;
55  std::string custom_icon_group = "";
56  std::string custom_icon_id = "";
57 
58  std::string file_path = "";
59  std::string document_context = "";
60 
68 
75 
81  virtual void OnThemeChange(BlamEditorTheme* new_theme) {};
82 
86  void Show();
87 
91  void UpdateDefaultIcon();
92 
100  virtual bool ConfirmClose() { return true; }
101 
105  virtual void FlagAsModified() {};
106 
112  virtual bool Close();
113 
121  virtual bool Close(bool force_close);
122 
126  virtual void Save() {};
127 
131  virtual void SaveAs() {};
132 
133  virtual void OnFocused() {};
134 
135  virtual void OnUnfocused() {};
136 };
137 
138 class BlamEditorDocumentSubWindow : public QMdiSubWindow
139 {
140 public:
142 
143  BlamEditorDocumentSubWindow(QWidget* parent = nullptr) : QMdiSubWindow(parent) {}
144 
145  void closeEvent(QCloseEvent* closeEvent);
146 };
147 
153 class BlamEditorDocumentWidget : public QWidget
154 {
155 public:
157 
158  BlamEditorDocumentWidget(QWidget* parent = nullptr) : QWidget(parent) {}
159 };
160 
162 {
167 
172 
180  KEYSTONE BlamConfigurationFile* GetDocumentTypeConfiguration(BlamEditorDocumentType type);
181 
187  KEYSTONE std::map<BlamEditorDocumentType, BlamConfigurationFile*> GetDocumentTypeConfigurations();
188 }
BlamEditorDocument::custom_icon_id
std::string custom_icon_id
The resource ID of the custom icon. Only used when override_icon is true.
Definition: BlamEditorDocument.h:56
BlamEditorDocument::GetDocumentType
BlamEditorDocumentType GetDocumentType()
Retrieves the type of this document.
Definition: BlamEditorDocument.cpp:16
BlamEditorDocument::parent_window
BlamEditorWindow * parent_window
The parent window that owns this document.
Definition: BlamEditorDocument.h:47
BlamEditorDocument::file_path
std::string file_path
The path to the file associated with this document.
Definition: BlamEditorDocument.h:58
BlamEditorDocumentType::GameWindow
@ GameWindow
Special document type used for the Game Viewport window.
BlamEditorDocumentWidget::document
BlamEditorDocument * document
The document associated with this widget.
Definition: BlamEditorDocument.h:156
BlamEditorDocumentType
BlamEditorDocumentType
Enumerator containing all possible editor document types.
Definition: BlamEditorDocument.h:23
BlamEditorDocument::document_title
std::string document_title
The title of this document.
Definition: BlamEditorDocument.h:49
themes.h
BlamKeystone::EditorData::UnloadDocumentConfigurations
KEYSTONE void UnloadDocumentConfigurations()
Unloads all document type configurations.
Definition: document_config.cpp:91
BlamEditorDocument::ConfirmClose
virtual bool ConfirmClose()
Called immediately before closing a document.
Definition: BlamEditorDocument.h:100
BlamEditorTheme
Class representing a Blamite Editor Theme.
Definition: themes.h:47
BlamEditorDocument::BlamEditorDocument
BlamEditorDocument(BlamEditorWindow *_window, BlamEditorDocumentType doctype)
Constructs a new BlamEditorDocument.
Definition: BlamEditorDocument.cpp:10
BlamEditorDocument::UpdateDefaultIcon
void UpdateDefaultIcon()
Updates the document's icon.
Definition: BlamEditorDocument.cpp:114
BlamEditorDocumentWidget::BlamEditorDocumentWidget
BlamEditorDocumentWidget(QWidget *parent=nullptr)
Definition: BlamEditorDocument.h:158
BlamEditorDocument::modified
bool modified
Whether or not the document has been modified.
Definition: BlamEditorDocument.h:52
BlamEditorDocumentType::TagDesigner
@ TagDesigner
Special document type used for the Tag Designer window.
BlamEditorDocumentType::Tag
@ Tag
Indicates the document represents a tag file.
BlamEditorDocumentSubWindow::document
BlamEditorDocument * document
The document associated with this widget.
Definition: BlamEditorDocument.h:141
BlamKeystone::EditorData::LoadDocumentConfigurations
KEYSTONE void LoadDocumentConfigurations()
Loads all document type configurations.
Definition: document_config.cpp:83
BlamEditorDocument::SaveAs
virtual void SaveAs()
Attempts to save the document, prompting the user to save as a new file.
Definition: BlamEditorDocument.h:131
BlamEditorDocument::FlagAsModified
virtual void FlagAsModified()
Flags the document as being modified.
Definition: BlamEditorDocument.h:105
BlamEditorDocumentWidget
Class acting as a simple interface to allow for easy retrieval of the active document.
Definition: BlamEditorDocument.h:153
BlamEditorDocument::OnUnfocused
virtual void OnUnfocused()
Definition: BlamEditorDocument.h:135
BlamEditorDocumentSubWindow::BlamEditorDocumentSubWindow
BlamEditorDocumentSubWindow(QWidget *parent=nullptr)
Definition: BlamEditorDocument.h:143
BlamEditorDocument::document_context
std::string document_context
The context of this document. Will generally be a project or tag folder.
Definition: BlamEditorDocument.h:59
BlamEditorDocument::Save
virtual void Save()
Attempts to save the document, replacing the original file.
Definition: BlamEditorDocument.h:126
BlamEditorDocument
Interface class that any types of editor documents inherit from.
Definition: BlamEditorDocument.h:37
BlamEditorDocument::custom_icon_group
std::string custom_icon_group
The resource group containing the custom icon name. Only used when override_icon is true.
Definition: BlamEditorDocument.h:55
BlamKeystone::EditorData::GetDocumentTypeConfigurations
KEYSTONE std::map< BlamEditorDocumentType, BlamConfigurationFile * > GetDocumentTypeConfigurations()
Retrieves the list of loaded document type configuration files.
Definition: document_config.cpp:117
BlamEditorDocument::OnThemeChange
virtual void OnThemeChange(BlamEditorTheme *new_theme)
Called when the active theme is changed.
Definition: BlamEditorDocument.h:81
BlamEditorDocument::Show
void Show()
Shows the document within the parent window.
Definition: BlamEditorDocument.cpp:21
BlamEditorDocument::loaded
bool loaded
Whether or not the document was able to be successfully loaded.
Definition: BlamEditorDocument.h:51
BlamEditorWindow
Interface class that all main editing tool windows inherit from.
Definition: BlamEditorWindow.h:48
BlamEditorDocumentType::Unspecified
@ Unspecified
Indicates the document type is unspecified or invalid.
BlamEditorDocumentSubWindow::closeEvent
void closeEvent(QCloseEvent *closeEvent)
Definition: BlamEditorDocumentSubWindow.cpp:5
KEYSTONE
#define KEYSTONE
Definition: BlamEditorDocument.h:11
BlamEditorDocumentSubWindow
Definition: BlamEditorDocument.h:138
BlamEditorDocument::Close
virtual bool Close()
Closes the document and releases any resources being used by it.
Definition: BlamEditorDocument.cpp:77
BlamKeystone::EditorData
Namespace contianing functions for accessing common editor data.
Definition: BlamEditorDocument.h:161
BlamEditorDocument::override_icon
bool override_icon
Whether or not this document uses a custom icon other than the application default.
Definition: BlamEditorDocument.h:54
BlamEditorDocument::OnFocused
virtual void OnFocused()
Definition: BlamEditorDocument.h:133
BlamEditorDocument::ui
BlamEditorDocumentWidget * ui
The GUI widget associated with this document.
Definition: BlamEditorDocument.h:50
BlamKeystone::EditorData::GetDocumentTypeConfiguration
KEYSTONE BlamConfigurationFile * GetDocumentTypeConfiguration(BlamEditorDocumentType type)
Attempts to locate the configuration file for the specified document type.
Definition: document_config.cpp:107