misc_gui.cpp File Reference

GUIs for a number of misc windows. More...

#include "stdafx.h"
#include "debug.h"
#include "landscape.h"
#include "error.h"
#include "gui.h"
#include "gfx_layout.h"
#include "command_func.h"
#include "company_func.h"
#include "town.h"
#include "string_func.h"
#include "company_base.h"
#include "texteff.hpp"
#include "strings_func.h"
#include "window_func.h"
#include "querystring_gui.h"
#include "core/geometry_func.hpp"
#include "newgrf_debug.h"
#include "zoom_func.h"
#include "viewport_func.h"
#include "landscape_cmd.h"
#include "rev.h"
#include "timer/timer.h"
#include "timer/timer_window.h"
#include "pathfinder/water_regions.h"
#include "widgets/misc_widget.h"
#include "table/strings.h"
#include <sstream>
#include <iomanip>
#include "safeguards.h"

Go to the source code of this file.

Data Structures
class	LandInfoWindow
struct	AboutWindow
struct	TooltipsWindow
	Window for displaying a tooltip. More...
struct	QueryStringWindow
	Class for the string query window. More...
struct	QueryWindow
	Window used for asking the user a YES/NO question. More...

Macros
#define	LANDINFOD_LEVEL   1

Enumerations
enum	OskActivation { OSKA_DISABLED , OSKA_DOUBLE_CLICK , OSKA_SINGLE_CLICK , OSKA_IMMEDIATELY }
	Method to open the OSK. More...

Functions
void	ShowLandInfo (TileIndex tile)
	Show land information window. More...
void	ShowAboutWindow ()
void	ShowEstimatedCostOrIncome (Money cost, int x, int y)
	Display estimated costs. More...
void	ShowCostOrIncomeAnimation (int x, int y, int z, Money cost)
	Display animated income or costs on the map. More...
void	ShowFeederIncomeAnimation (int x, int y, int z, Money transfer, Money income)
	Display animated feeder income. More...
TextEffectID	ShowFillingPercent (int x, int y, int z, uint8_t percent, StringID string)
	Display vehicle loading indicators. More...
void	UpdateFillingPercent (TextEffectID te_id, uint8_t percent, StringID string)
	Update vehicle loading indicators. More...
void	HideFillingPercent (TextEffectID *te_id)
	Hide vehicle loading indicators. More...
void	GuiShowTooltips (Window *parent, StringID str, TooltipCloseCondition close_tooltip, uint paramcount)
	Shows a tooltip. More...
static int	GetCaretWidth ()
static Rect	ScrollEditBoxTextRect (Rect r, const Textbuf &tb)
	Reposition edit text box rect based on textbuf length can caret position. More...
void	ShowQueryString (StringID str, StringID caption, uint maxsize, Window *parent, CharSetFilter afilter, QueryStringFlags flags)
	Show a query popup window with a textbox in it. More...
void	ShowQuery (StringID caption, StringID message, Window *parent, QueryCallbackProc *callback, bool focus)
	Show a confirmation window with standard 'yes' and 'no' buttons The window is aligned to the centre of its parent. More...

Variables
static constexpr NWidgetPart	_nested_land_info_widgets []
static WindowDesc	_land_info_desc (WDP_AUTO, nullptr, 0, 0, WC_LAND_INFO, WC_NONE, 0, _nested_land_info_widgets)
static constexpr NWidgetPart	_nested_about_widgets []
static WindowDesc	_about_desc (WDP_CENTER, nullptr, 0, 0, WC_GAME_OPTIONS, WC_NONE, 0, _nested_about_widgets)
static const std::initializer_list< const std::string_view >	_credits
static constexpr NWidgetPart	_nested_tooltips_widgets []
static WindowDesc	_tool_tips_desc (WDP_MANUAL, nullptr, 0, 0, WC_TOOLTIPS, WC_NONE, WDF_NO_FOCUS|WDF_NO_CLOSE, _nested_tooltips_widgets)
static constexpr NWidgetPart	_nested_query_string_widgets []
static WindowDesc	_query_string_desc (WDP_CENTER, nullptr, 0, 0, WC_QUERY_STRING, WC_NONE, 0, _nested_query_string_widgets)
static constexpr NWidgetPart	_nested_query_widgets []
static WindowDesc	_query_desc (WDP_CENTER, nullptr, 0, 0, WC_CONFIRM_POPUP_QUERY, WC_NONE, WDF_MODAL, _nested_query_widgets)

Detailed Description

GUIs for a number of misc windows.

Definition in file misc_gui.cpp.

Enumeration Type Documentation

OskActivation

enum OskActivation

Method to open the OSK.

Enumerator
OSKA_DISABLED	The OSK shall not be activated at all.
OSKA_DOUBLE_CLICK	Double click on the edit box opens OSK.
OSKA_SINGLE_CLICK	Single click after focus click opens OSK.
OSKA_IMMEDIATELY	Focusing click already opens OSK.

Definition at line 45 of file misc_gui.cpp.

Function Documentation

GuiShowTooltips()

void GuiShowTooltips	(	Window *	parent,
		StringID	str,
		TooltipCloseCondition	close_tooltip,
		uint	paramcount
	)

Shows a tooltip.

Parameters

parent	The window this tooltip is related to.
str	String to be displayed
close_tooltip	the condition under which the tooltip closes
paramcount	number of params to deal with

Definition at line 760 of file misc_gui.cpp.

References CloseWindowById(), and WC_TOOLTIPS.

Referenced by ShowMeasurementTooltips().

HideFillingPercent()

void HideFillingPercent

(

TextEffectID *

te_id

)

Hide vehicle loading indicators.

Parameters

*te_id

TextEffectID which is supposed to be hidden.

Definition at line 648 of file misc_gui.cpp.

Referenced by Train::Crash(), and Vehicle::PreDestructor().

ScrollEditBoxTextRect()

static Rect ScrollEditBoxTextRect ( Rect  r, const Textbuf &  tb  )

static

Reposition edit text box rect based on textbuf length can caret position.

Parameters

r	Initial rect of edit text box.
tb	The Textbuf being processed.

Returns

Updated rect.

Definition at line 790 of file misc_gui.cpp.

References Textbuf::pixels.

ShowCostOrIncomeAnimation()

void ShowCostOrIncomeAnimation	(	int	x,
		int	y,
		int	z,
		Money	cost
	)

Display animated income or costs on the map.

Does nothing if cost is zero.

Parameters

x	World X position of the animation location.
y	World Y position of the animation location.
z	World Z position of the animation location.
cost	Estimated cost (or income if negative).

Definition at line 570 of file misc_gui.cpp.

Referenced by CmdChangeBankBalance().

ShowEstimatedCostOrIncome()

void ShowEstimatedCostOrIncome	(	Money	cost,
		int	x,
		int	y
	)

Display estimated costs.

Parameters

cost	Estimated cost (or income if negative).
x	X position of the notification window.
y	Y position of the notification window.

Definition at line 551 of file misc_gui.cpp.

ShowFeederIncomeAnimation()

void ShowFeederIncomeAnimation	(	int	x,
		int	y,
		int	z,
		Money	transfer,
		Money	income
	)

Display animated feeder income.

Parameters

x	World X position of the animation location.
y	World Y position of the animation location.
z	World Z position of the animation location.
transfer	Estimated feeder income.
income	Real income from goods being delivered to their final destination.

Definition at line 594 of file misc_gui.cpp.

ShowFillingPercent()

TextEffectID ShowFillingPercent	(	int	x,
		int	y,
		int	z,
		uint8_t	percent,
		StringID	string
	)

Display vehicle loading indicators.

Parameters

x	World X position of the animation location.
y	World Y position of the animation location.
z	World Z position of the animation location.
percent	Estimated feeder income.
string	String which is drawn on the map.

Returns

TextEffectID to be used for future updates of the loading indicators.

Definition at line 621 of file misc_gui.cpp.

ShowLandInfo()

void ShowLandInfo

(

TileIndex

tile

)

Show land information window.

Parameters

tile	The tile to show information about.

Definition at line 379 of file misc_gui.cpp.

References CloseWindowById(), and WC_LAND_INFO.

ShowQuery()

void ShowQuery	(	StringID	caption,
		StringID	message,
		Window *	parent,
		QueryCallbackProc *	callback,
		bool	focus
	)

Show a confirmation window with standard 'yes' and 'no' buttons The window is aligned to the centre of its parent.

Parameters

caption	string shown as window caption
message	string that will be shown for the window
parent	pointer to parent window, if this pointer is nullptr the parent becomes the main window WC_MAIN_WINDOW
callback	callback function pointer to set in the window descriptor
focus	whether the window should be focussed (by default false)

Definition at line 1223 of file misc_gui.cpp.

References GetMainWindow(), Window::parent, QueryWindow::proc, WC_CONFIRM_POPUP_QUERY, and Window::window_class.

Referenced by CmdPause(), MakeScreenshotWithConfirm(), and SaveLoadWindow::OnTimeout().

ShowQueryString()

void ShowQueryString	(	StringID	str,
		StringID	caption,
		uint	maxsize,
		Window *	parent,
		CharSetFilter	afilter,
		QueryStringFlags	flags
	)

Show a query popup window with a textbox in it.

Parameters

str	StringID for the text shown in the textbox
caption	StringID of text shown in caption of querywindow
maxsize	maximum size in bytes or characters (including terminating '\0') depending on flags
parent	pointer to a Window that will handle the events (ok/cancel) of this window.
afilter	filters out unwanted character input
flags	various flags,

See also

QueryStringFlags

Definition at line 1079 of file misc_gui.cpp.

References CloseWindowByClass(), MAX_CHAR_LENGTH, QSF_LEN_IN_CHARS, and WC_QUERY_STRING.

Referenced by ToolbarScenDatePanel().

UpdateFillingPercent()

void UpdateFillingPercent	(	TextEffectID	te_id,
		uint8_t	percent,
		StringID	string
	)

Update vehicle loading indicators.

Parameters

te_id	TextEffectID to be updated.
string	String which is printed.

Definition at line 636 of file misc_gui.cpp.

References SetDParam().

Variable Documentation

_nested_about_widgets

constexpr NWidgetPart _nested_about_widgets[]

staticconstexpr

Initial value:

= {
  NWidget(NWID_HORIZONTAL),
    NWidget(WWT_CLOSEBOX, COLOUR_GREY),
    NWidget(WWT_CAPTION, COLOUR_GREY), SetDataTip(STR_ABOUT_OPENTTD, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
  EndContainer(),
  NWidget(WWT_PANEL, COLOUR_GREY), SetPIP(4, 2, 4),
    NWidget(WWT_LABEL, COLOUR_GREY), SetDataTip(STR_ABOUT_ORIGINAL_COPYRIGHT, STR_NULL),
    NWidget(WWT_LABEL, COLOUR_GREY), SetDataTip(STR_ABOUT_VERSION, STR_NULL),
    NWidget(WWT_FRAME, COLOUR_GREY), SetPadding(0, 5, 1, 5),
      NWidget(WWT_EMPTY, INVALID_COLOUR, WID_A_SCROLLING_TEXT),
    EndContainer(),
    NWidget(WWT_LABEL, COLOUR_GREY, WID_A_WEBSITE), SetDataTip(STR_JUST_RAW_STRING, STR_NULL),
    NWidget(WWT_LABEL, COLOUR_GREY, WID_A_COPYRIGHT), SetDataTip(STR_ABOUT_COPYRIGHT_OPENTTD, STR_NULL),
  EndContainer(),
}

Definition at line 385 of file misc_gui.cpp.

_nested_land_info_widgets

constexpr NWidgetPart _nested_land_info_widgets[]

staticconstexpr

Initial value:

= {
  NWidget(NWID_HORIZONTAL),
    NWidget(WWT_CLOSEBOX, COLOUR_GREY),
    NWidget(WWT_CAPTION, COLOUR_GREY), SetDataTip(STR_LAND_AREA_INFORMATION_CAPTION, STR_TOOLTIP_WINDOW_TITLE_DRAG_THIS),
    NWidget(WWT_PUSHIMGBTN, COLOUR_GREY, WID_LI_LOCATION), SetAspect(WidgetDimensions::ASPECT_LOCATION), SetDataTip(SPR_GOTO_LOCATION, STR_LAND_AREA_INFORMATION_LOCATION_TOOLTIP),
    NWidget(WWT_DEBUGBOX, COLOUR_GREY),
  EndContainer(),
  NWidget(WWT_PANEL, COLOUR_GREY, WID_LI_BACKGROUND), EndContainer(),
}

Definition at line 53 of file misc_gui.cpp.

_nested_query_string_widgets

constexpr NWidgetPart _nested_query_string_widgets[]

staticconstexpr

Initial value:

= {
  NWidget(NWID_HORIZONTAL),
    NWidget(WWT_CLOSEBOX, COLOUR_GREY),
    NWidget(WWT_CAPTION, COLOUR_GREY, WID_QS_CAPTION), SetDataTip(STR_JUST_STRING, STR_NULL), SetTextStyle(TC_WHITE),
  EndContainer(),
  NWidget(WWT_PANEL, COLOUR_GREY),
    NWidget(WWT_EDITBOX, COLOUR_GREY, WID_QS_TEXT), SetMinimalSize(256, 0), SetFill(1, 0), SetPadding(2, 2, 2, 2),
  EndContainer(),
  NWidget(NWID_HORIZONTAL, NC_EQUALSIZE),
    NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_QS_DEFAULT), SetMinimalSize(87, 12), SetFill(1, 1), SetDataTip(STR_BUTTON_DEFAULT, STR_NULL),
    NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_QS_CANCEL), SetMinimalSize(86, 12), SetFill(1, 1), SetDataTip(STR_BUTTON_CANCEL, STR_NULL),
    NWidget(WWT_TEXTBTN, COLOUR_GREY, WID_QS_OK), SetMinimalSize(87, 12), SetFill(1, 1), SetDataTip(STR_BUTTON_OK, STR_NULL),
  EndContainer(),
}

Definition at line 1048 of file misc_gui.cpp.

_nested_query_widgets

constexpr NWidgetPart _nested_query_widgets[]

staticconstexpr

Initial value:

= {
  NWidget(NWID_HORIZONTAL),
    NWidget(WWT_CLOSEBOX, COLOUR_RED),
    NWidget(WWT_CAPTION, COLOUR_RED, WID_Q_CAPTION), 
  EndContainer(),
  NWidget(WWT_PANEL, COLOUR_RED),
    NWidget(NWID_VERTICAL), SetPIP(0, WidgetDimensions::unscaled.vsep_wide, 0), SetPadding(WidgetDimensions::unscaled.modalpopup),
      NWidget(WWT_TEXT, COLOUR_RED, WID_Q_TEXT), SetMinimalSize(200, 12),
      NWidget(NWID_HORIZONTAL, NC_EQUALSIZE), SetPIP(WidgetDimensions::unscaled.hsep_indent, WidgetDimensions::unscaled.hsep_indent, WidgetDimensions::unscaled.hsep_indent),
        NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_Q_NO), SetMinimalSize(71, 12), SetFill(1, 1), SetDataTip(STR_QUIT_NO, STR_NULL),
        NWidget(WWT_PUSHTXTBTN, COLOUR_YELLOW, WID_Q_YES), SetMinimalSize(71, 12), SetFill(1, 1), SetDataTip(STR_QUIT_YES, STR_NULL),
      EndContainer(),
    EndContainer(),
  EndContainer(),
}

Definition at line 1190 of file misc_gui.cpp.

_nested_tooltips_widgets

constexpr NWidgetPart _nested_tooltips_widgets[]

staticconstexpr

Initial value:

= {
  NWidget(WWT_EMPTY, INVALID_COLOUR, WID_TT_BACKGROUND),
}

Definition at line 656 of file misc_gui.cpp.