OpenTTD Source
20241108-master-g80f628063a
|
Handling of stories. More...
#include "stdafx.h"
#include "story_base.h"
#include "core/pool_func.hpp"
#include "command_func.h"
#include "company_base.h"
#include "company_func.h"
#include "string_func.h"
#include "timer/timer_game_calendar.h"
#include "tile_map.h"
#include "goal_type.h"
#include "goal_base.h"
#include "window_func.h"
#include "gui.h"
#include "vehicle_base.h"
#include "game/game.hpp"
#include "script/api/script_story_page.hpp"
#include "script/api/script_event_types.hpp"
#include "story_cmd.h"
#include "safeguards.h"
Go to the source code of this file.
Functions | |
static bool | VerifyElementContentParameters (StoryPageID page_id, StoryPageElementType type, TileIndex tile, uint32_t reference, const std::string &text) |
This helper for Create/Update PageElement Cmd procedure verifies if the page element parameters are correct for the given page element type. More... | |
static void | UpdateElement (StoryPageElement &pe, TileIndex tile, uint32_t reference, const std::string &text) |
This helper for Create/Update PageElement Cmd procedure updates a page element with new content data. More... | |
std::tuple< CommandCost, StoryPageID > | CmdCreateStoryPage (DoCommandFlag flags, CompanyID company, const std::string &text) |
Create a new story page. More... | |
std::tuple< CommandCost, StoryPageElementID > | CmdCreateStoryPageElement (DoCommandFlag flags, TileIndex tile, StoryPageID page_id, StoryPageElementType type, uint32_t reference, const std::string &text) |
Create a new story page element. More... | |
CommandCost | CmdUpdateStoryPageElement (DoCommandFlag flags, TileIndex tile, StoryPageElementID page_element_id, uint32_t reference, const std::string &text) |
Update a new story page element. More... | |
CommandCost | CmdSetStoryPageTitle (DoCommandFlag flags, StoryPageID page_id, const std::string &text) |
Update title of a story page. More... | |
CommandCost | CmdSetStoryPageDate (DoCommandFlag flags, StoryPageID page_id, TimerGameCalendar::Date date) |
Update date of a story page. More... | |
CommandCost | CmdShowStoryPage (DoCommandFlag flags, StoryPageID page_id) |
Display a story page for all clients that are allowed to view the story page. More... | |
CommandCost | CmdRemoveStoryPage (DoCommandFlag flags, StoryPageID page_id) |
Remove a story page and associated story page elements. More... | |
CommandCost | CmdRemoveStoryPageElement (DoCommandFlag flags, StoryPageElementID page_element_id) |
Remove a story page element. More... | |
CommandCost | CmdStoryPageButton (DoCommandFlag flags, TileIndex tile, StoryPageElementID page_element_id, VehicleID reference) |
Clicked/used a button on a story page. More... | |
Variables | |
uint32_t | _story_page_element_next_sort_value |
uint32_t | _story_page_next_sort_value |
StoryPageElementPool | _story_page_element_pool ("StoryPageElement") |
StoryPagePool | _story_page_pool ("StoryPage") |
Handling of stories.
Definition in file story.cpp.
std::tuple<CommandCost, StoryPageID> CmdCreateStoryPage | ( | DoCommandFlag | flags, |
CompanyID | company, | ||
const std::string & | text | ||
) |
Create a new story page.
flags | type of operation |
company | Company for which this story page belongs to. |
text | Title of the story page. Null is allowed in which case a generic page title is provided by OpenTTD. |
Definition at line 209 of file story.cpp.
References _current_company, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::CanAllocateItem(), CMD_ERROR, DC_EXEC, INVALID_COMPANY, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::IsValidID(), and OWNER_DEITY.
std::tuple<CommandCost, StoryPageElementID> CmdCreateStoryPageElement | ( | DoCommandFlag | flags, |
TileIndex | tile, | ||
StoryPageID | page_id, | ||
StoryPageElementType | type, | ||
uint32_t | reference, | ||
const std::string & | text | ||
) |
Create a new story page element.
flags | type of operation |
tile | Tile location if it is a location page element, otherwise unused. |
page_id | The page which the element belongs to. |
type | Page element type |
reference | Id of referenced object |
text | Text content in case it is a text or location page element |
Definition at line 248 of file story.cpp.
References Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_element_pool >::CanAllocateItem(), and CMD_ERROR.
CommandCost CmdRemoveStoryPage | ( | DoCommandFlag | flags, |
StoryPageID | page_id | ||
) |
Remove a story page and associated story page elements.
flags | type of operation |
page_id | StoryPageID to remove. |
Definition at line 382 of file story.cpp.
References _current_company, CMD_ERROR, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::GetNumItems(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem< Tpool >::index, InvalidateWindowClassesData(), InvalidateWindowData(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::IsValidID(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_element_pool >::Iterate(), OWNER_DEITY, WC_MAIN_TOOLBAR, and WC_STORY_BOOK.
CommandCost CmdRemoveStoryPageElement | ( | DoCommandFlag | flags, |
StoryPageElementID | page_element_id | ||
) |
Remove a story page element.
flags | type of operation |
page_element_id | StoryPageElementID to remove. |
Definition at line 411 of file story.cpp.
References _current_company, CMD_ERROR, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_element_pool >::Get(), InvalidateWindowClassesData(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_element_pool >::IsValidID(), OWNER_DEITY, StoryPageElement::page, and WC_STORY_BOOK.
CommandCost CmdSetStoryPageDate | ( | DoCommandFlag | flags, |
StoryPageID | page_id, | ||
TimerGameCalendar::Date | date | ||
) |
Update date of a story page.
flags | type of operation |
page_id | StoryPageID to update. |
date | date |
Definition at line 342 of file story.cpp.
References _current_company, CMD_ERROR, StoryPage::date, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::Get(), InvalidateWindowClassesData(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::IsValidID(), OWNER_DEITY, and WC_STORY_BOOK.
CommandCost CmdSetStoryPageTitle | ( | DoCommandFlag | flags, |
StoryPageID | page_id, | ||
const std::string & | text | ||
) |
Update title of a story page.
flags | type of operation |
page_id | StoryPageID to update. |
text | title text of the story page. |
Definition at line 320 of file story.cpp.
References _current_company, CMD_ERROR, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::Get(), InvalidateWindowClassesData(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::IsValidID(), OWNER_DEITY, StoryPage::title, and WC_STORY_BOOK.
CommandCost CmdShowStoryPage | ( | DoCommandFlag | flags, |
StoryPageID | page_id | ||
) |
Display a story page for all clients that are allowed to view the story page.
flags | type of operation |
page_id | StoryPageID to show. |
Definition at line 364 of file story.cpp.
References _current_company, _local_company, CMD_ERROR, StoryPage::company, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::Get(), INVALID_COMPANY, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_company_pool >::IsValidID(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::IsValidID(), OWNER_DEITY, and ShowStoryBook().
CommandCost CmdStoryPageButton | ( | DoCommandFlag | flags, |
TileIndex | tile, | ||
StoryPageElementID | page_element_id, | ||
VehicleID | reference | ||
) |
Clicked/used a button on a story page.
flags | Type of operation. |
tile | Tile selected, for tile selection buttons, otherwise unused. |
page_element_id | story page element id of button. |
reference | ID of selected item for buttons that select an item (e.g. vehicle), otherwise unused. |
Definition at line 436 of file story.cpp.
References _current_company, CMD_ERROR, StoryPage::company, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_element_pool >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::Get(), INVALID_COMPANY, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_vehicle_pool >::IsValidID(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_element_pool >::IsValidID(), IsValidTile(), Game::NewEvent(), StoryPageElement::page, SPET_BUTTON_PUSH, SPET_BUTTON_TILE, SPET_BUTTON_VEHICLE, and StoryPageElement::type.
CommandCost CmdUpdateStoryPageElement | ( | DoCommandFlag | flags, |
TileIndex | tile, | ||
StoryPageElementID | page_element_id, | ||
uint32_t | reference, | ||
const std::string & | text | ||
) |
Update a new story page element.
flags | type of operation |
tile | Tile location if it is a location page element, otherwise unused. |
page_element_id | The page element to update. |
reference | Id of referenced object |
text | Text content in case it is a text or location page element |
Definition at line 294 of file story.cpp.
References _current_company, CMD_ERROR, DC_EXEC, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_element_pool >::Get(), InvalidateWindowClassesData(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_element_pool >::IsValidID(), OWNER_DEITY, StoryPageElement::page, StoryPageElement::type, UpdateElement(), VerifyElementContentParameters(), and WC_STORY_BOOK.
|
static |
This helper for Create/Update PageElement Cmd procedure updates a page element with new content data.
pe | The page element to update |
tile | The tile parameter of the DoCommand proc |
reference | The reference parameter of the DoCommand proc (p2) |
text | The text parameter of the DoCommand proc |
Definition at line 97 of file story.cpp.
References StoryPageElement::referenced_id, SPET_BUTTON_PUSH, SPET_BUTTON_TILE, SPET_BUTTON_VEHICLE, SPET_GOAL, SPET_LOCATION, SPET_TEXT, StoryPageElement::text, and StoryPageElement::type.
Referenced by CmdUpdateStoryPageElement().
|
static |
This helper for Create/Update PageElement Cmd procedure verifies if the page element parameters are correct for the given page element type.
page_id | The page id of the page which the page element (will) belong to |
type | The type of the page element to create/update |
tile | The tile parameter of the DoCommand proc |
reference | The reference parameter of the DoCommand proc (p2) |
text | The text parameter of the DoCommand proc |
Definition at line 50 of file story.cpp.
References Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_story_page_pool >::Get(), Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_goal_pool >::Get(), INVALID_COMPANY, Pool< Titem, Tindex, Tgrowth_step, Tmax_size, Tpool_type, Tcache, Tzero >::PoolItem<&_goal_pool >::IsValidID(), IsValidTile(), SPET_BUTTON_PUSH, SPET_BUTTON_TILE, SPET_BUTTON_VEHICLE, SPET_GOAL, SPET_LOCATION, and SPET_TEXT.
Referenced by CmdUpdateStoryPageElement().