Function CmdCreateStoryPageElement

src/story.cpp:253–285

* Create a new story page element. * @param flags type of operation * @param tile Tile location if it is a location page element, otherwise unused. * @param page_id The page which the element belongs to. * @param type Page element type * @param reference Id of referenced object * @param text Text content in case it is a text or location page element * @return the cost of this operation or a

 * @return the cost of this operation or an error
 */
std::tuple<CommandCost, StoryPageElementID> CmdCreateStoryPageElement(DoCommandFlags flags, TileIndex tile, StoryPageID page_id, StoryPageElementType type, uint32_t reference, const EncodedString &text)
{
	if (!StoryPageElement::CanAllocateItem()) return { CMD_ERROR, StoryPageElementID::Invalid() };

	/* Allow at most 128 elements per page. */
	uint16_t element_count = 0;
	for (StoryPageElement *iter : StoryPageElement::Iterate()) {
		if (iter->page == page_id) element_count++;
	}
	if (element_count >= 128) return { CMD_ERROR, StoryPageElementID::Invalid() };

	if (_current_company != OWNER_DEITY) return { CMD_ERROR, StoryPageElementID::Invalid() };
	if (!StoryPage::IsValidID(page_id)) return { CMD_ERROR, StoryPageElementID::Invalid() };
	if (!VerifyElementContentParameters(page_id, type, tile, reference, text)) return { CMD_ERROR, StoryPageElementID::Invalid() };


	if (flags.Test(DoCommandFlag::Execute)) {
		if (StoryPageElement::GetNumItems() == 0) {
			/* Initialize the next sort value variable. */
			_story_page_element_next_sort_value = 0;
		}

		StoryPageElement *pe = new StoryPageElement(_story_page_element_next_sort_value, type, page_id);
		UpdateElement(*pe, tile, reference, text);

		InvalidateWindowClassesData(WC_STORY_BOOK, page_id);

		_story_page_element_next_sort_value++;
		return { CommandCost(), pe->index };
	}

	return { CommandCost(), StoryPageElementID::Invalid() };
}

/**
 * Update a new story page element.