OpenTTD
story_base.h
Go to the documentation of this file.
1 /* $Id$ */
2 
3 /*
4  * This file is part of OpenTTD.
5  * OpenTTD 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, version 2.
6  * OpenTTD 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.
7  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
8  */
9 
12 #ifndef STORY_BASE_H
13 #define STORY_BASE_H
14 
15 #include "company_type.h"
16 #include "story_type.h"
17 #include "date_type.h"
18 #include "core/pool_type.hpp"
19 
22 extern StoryPageElementPool _story_page_element_pool;
23 extern StoryPagePool _story_page_pool;
24 extern uint32 _story_page_element_next_sort_value;
25 extern uint32 _story_page_next_sort_value;
26 
27 /*
28  * Each story page element is one of these types.
29  */
30 enum StoryPageElementType : byte {
31  SPET_TEXT = 0,
34  SPET_END,
35  INVALID_SPET = 0xFF,
36 };
37 
39 template <> struct EnumPropsT<StoryPageElementType> : MakeEnumPropsT<StoryPageElementType, byte, SPET_TEXT, SPET_END, INVALID_SPET, 8> {};
40 
46 struct StoryPageElement : StoryPageElementPool::PoolItem<&_story_page_element_pool> {
47  uint32 sort_value;
49  StoryPageElementType type;
50 
51  uint32 referenced_id;
52  char *text;
53 
57  inline StoryPageElement() { }
58 
62  inline ~StoryPageElement() { free(this->text); }
63 };
64 
65 #define FOR_ALL_STORY_PAGE_ELEMENTS_FROM(var, start) FOR_ALL_ITEMS_FROM(StoryPageElement, story_page_element_index, var, start)
66 #define FOR_ALL_STORY_PAGE_ELEMENTS(var) FOR_ALL_STORY_PAGE_ELEMENTS_FROM(var, 0)
67 
69 struct StoryPage : StoryPagePool::PoolItem<&_story_page_pool> {
70  uint32 sort_value;
73 
74  char *title;
75 
79  inline StoryPage() { }
80 
84  inline ~StoryPage()
85  {
86  if (!this->CleaningPool()) {
87  StoryPageElement *spe;
88  FOR_ALL_STORY_PAGE_ELEMENTS(spe) {
89  if (spe->page == this->index) delete spe;
90  }
91  }
92  free(this->title);
93  }
94 };
95 
96 #define FOR_ALL_STORY_PAGES_FROM(var, start) FOR_ALL_ITEMS_FROM(StoryPage, story_page_index, var, start)
97 #define FOR_ALL_STORY_PAGES(var) FOR_ALL_STORY_PAGES_FROM(var, 0)
98 
99 #endif /* STORY_BASE_H */
100 
StoryPageElement()
We need an (empty) constructor so struct isn&#39;t zeroed (as C++ standard states)
Definition: story_base.h:57
Helper template class that makes basic properties of given enumeration type visible from outsize...
Definition: enum_type.hpp:64
Owner
Enum for all companies/owners.
Definition: company_type.h:20
An element that references a tile along with a one-line text.
Definition: story_base.h:32
StoryPageID page
Id of the page which the page element belongs to.
Definition: story_base.h:48
~StoryPageElement()
(Empty) destructor has to be defined else operator delete might be called with nullptr parameter ...
Definition: story_base.h:62
uint32 sort_value
A number that increases for every created story page element. Used for sorting. The id of a story pag...
Definition: story_base.h:47
Date date
Date when the page was created.
Definition: story_base.h:71
~StoryPage()
(Empty) destructor has to be defined else operator delete might be called with nullptr parameter ...
Definition: story_base.h:84
char * title
Title of story page.
Definition: story_base.h:74
Definition of Pool, structure used to access PoolItems, and PoolItem, base structure for Vehicle...
basic types related to story pages
Struct about story page elements.
Definition: story_base.h:46
uint32 referenced_id
Id of referenced object (location, goal etc.)
Definition: story_base.h:51
Struct about stories, current and completed.
Definition: story_base.h:69
Informative template class exposing basic enumeration properties used by several other templates belo...
Definition: enum_type.hpp:50
StoryPageElementType type
Type of page element.
Definition: story_base.h:49
uint32 sort_value
A number that increases for every created story page. Used for sorting. The id of a story page is the...
Definition: story_base.h:70
Base class for all PoolItems.
Definition: pool_type.hpp:146
Base class for all pools.
Definition: pool_type.hpp:83
An element that references a goal.
Definition: story_base.h:33
A text element.
Definition: story_base.h:31
Types related to companies.
Types related to the dates in OpenTTD.
int32 Date
The type to store our dates in.
Definition: date_type.h:16
static void free(const void *ptr)
Version of the standard free that accepts const pointers.
Definition: depend.cpp:131
char * text
Static content text of page element.
Definition: story_base.h:52
StoryPage()
We need an (empty) constructor so struct isn&#39;t zeroed (as C++ standard states)
Definition: story_base.h:79
uint16 StoryPageID
ID of a story page.
Definition: story_type.h:18
CompanyID company
StoryPage is for a specific company; INVALID_COMPANY if it is global.
Definition: story_base.h:72
StoryPageElementType
Definition: story_base.h:30