#include <game_display.hpp>

Inheritance diagram for game_display:

Public Types
enum	game_mode { RUNNING, LINGER }
	Sets the linger mode for the display. More...

Public Types inherited from display
enum	SCROLL_TYPE { SCROLL, WARP, ONSCREEN, ONSCREEN_WARP }

enum	drawing_layer { LAYER_TERRAIN_BG, LAYER_GRID_TOP, LAYER_MOUSEOVER_OVERLAY, LAYER_FOOTSTEPS, LAYER_MOUSEOVER_TOP, LAYER_UNIT_FIRST, LAYER_UNIT_BG = LAYER_UNIT_FIRST+10, LAYER_UNIT_DEFAULT =LAYER_UNIT_FIRST+40, LAYER_TERRAIN_FG = LAYER_UNIT_FIRST+50, LAYER_GRID_BOTTOM, LAYER_UNIT_MOVE_DEFAULT =LAYER_UNIT_FIRST+60, LAYER_UNIT_FG = LAYER_UNIT_FIRST+80, LAYER_UNIT_MISSILE_DEFAULT = LAYER_UNIT_FIRST+90, LAYER_UNIT_LAST =LAYER_UNIT_FIRST+100, LAYER_REACHMAP, LAYER_MOUSEOVER_BOTTOM, LAYER_FOG_SHROUD, LAYER_ARROWS, LAYER_ACTIONS_NUMBERING, LAYER_SELECTED_HEX, LAYER_ATTACK_INDICATOR, LAYER_UNIT_BAR, LAYER_MOVE_INFO, LAYER_LINGER_OVERLAY, LAYER_BORDER }
	The layers to render something on. More...

Public Member Functions
	game_display (game_board &board, std::weak_ptr< wb::manager > wb, reports &reports_object, const config &theme_cfg, const config &level, bool dummy=false)

	~game_display ()

void	new_turn ()
	Update lighting settings. More...

virtual const std::set< std::string > &	observers () const override

void	scroll_to_leader (int side, SCROLL_TYPE scroll_type=ONSCREEN, bool force=true)
	Scrolls to the leader of a certain side. More...

virtual void	select_hex (map_location hex) override
	Function to display a location as selected. More...

virtual void	highlight_hex (map_location hex) override
	Function to highlight a location. More...

void	display_unit_hex (map_location hex)
	Change the unit to be displayed in the sidebar. More...

void	highlight_reach (const pathfind::paths &paths_list)
	Sets the paths that are currently displayed as available for the unit to move along. More...

void	highlight_another_reach (const pathfind::paths &paths_list, const map_location &goal=map_location::null_location())
	Add more paths to highlight. More...

const std::set< map_location > &	units_that_can_reach_goal () const
	Return the locations of units that can reach goal (. More...

bool	unhighlight_reach ()
	Reset highlighting of paths. More...

void	set_route (const pathfind::marked_route *route)
	Sets the route along which footsteps are drawn to show movement of a unit. More...

const pathfind::marked_route &	get_route ()
	Gets the route along which footsteps are drawn to show movement of a unit. More...

void	float_label (const map_location &loc, const std::string &text, const color_t &color)
	Function to float a label above a tile. More...

void	draw_movement_info (const map_location &loc)
	Draws the movement info (turns available) for a given location. More...

void	invalidate_unit ()
	Function to invalidate that unit status displayed on the sidebar. More...

void	invalidate_unit_after_move (const map_location &src, const map_location &dst)
	Same as invalidate_unit() if moving the displayed unit. More...

virtual const time_of_day &	get_time_of_day (const map_location &loc) const override

virtual bool	has_time_area () const override

void	set_attack_indicator (const map_location &src, const map_location &dst)
	Set the attack direction indicator. More...

void	clear_attack_indicator ()

const map_location &	get_attack_indicator_src ()

std::string	attack_indicator_direction () const
	Function to get attack direction suffix. More...

t_translation::terrain_code	get_terrain_on (int palx, int paly, int x, int y)

virtual const map_location &	displayed_unit_hex () const override
	Virtual functions shadowed in game_display. More...

virtual int	playing_side () const override
	The playing team is the team whose turn it is. More...

std::string	current_team_name () const

display_chat_manager &	get_chat_manager ()

void	begin_game ()

virtual bool	in_game () const override

void	set_game_mode (const game_mode mode)

void	needs_rebuild (bool b)
	Sets whether the screen (map visuals) needs to be rebuilt. This is typically after the map has been changed by wml. More...

bool	maybe_rebuild ()
	Rebuilds the screen if needs_rebuild(true) was previously called, and resets the flag. More...

Public Member Functions inherited from display
	display (const display_context *dc, std::weak_ptr< wb::manager > wb, reports &reports_object, const config &theme_cfg, const config &level, bool auto_join=true)

virtual	~display ()

bool	show_everything () const

const gamemap &	get_map () const

const std::vector< team > &	get_teams () const

std::size_t	playing_team () const
	The playing team is the team whose turn it is. More...

bool	team_valid () const

std::size_t	viewing_team () const
	The viewing team is the team currently viewing the game. More...

int	viewing_side () const

void	set_team (std::size_t team, bool observe=false)
	Sets the team controlled by the player using the computer. More...

void	set_playing_team (std::size_t team)
	set_playing_team sets the team whose turn it currently is More...

void	clear_exclusive_draws ()
	Cancels all the exclusive draw requests. More...

const unit_map &	get_units () const

bool	add_exclusive_draw (const map_location &loc, unit &unit)
	Allows a unit to request to be the only one drawn in its hex. More...

std::string	remove_exclusive_draw (const map_location &loc)
	Cancels an exclusive draw request. More...

void	parse_team_overlays ()
	Check the overlay_map for proper team-specific overlays to be displayed/hidden. More...

void	add_overlay (const map_location &loc, const std::string &image, const std::string &halo="", const std::string &team_name="", const std::string &item_id="", bool visible_under_fog=true, float z_order=0)
	Functions to add and remove overlays from locations. More...

void	remove_overlay (const map_location &loc)
	remove_overlay will remove all overlays on a tile. More...

void	remove_single_overlay (const map_location &loc, const std::string &toDelete)
	remove_single_overlay will remove a single overlay from a tile More...

void	reload_map ()
	Updates internals that cache map size. More...

void	change_display_context (const display_context *dc)

const display_context &	get_disp_context () const

void	reset_halo_manager ()

void	reset_halo_manager (halo::manager &hm)

halo::manager &	get_halo_manager ()

void	update_tod (const time_of_day *tod_override=nullptr)
	Applies r,g,b coloring to the map. More...

void	adjust_color_overlay (int r, int g, int b)
	Add r,g,b to the colors for all images displayed on the map. More...

CVideo &	video ()
	Gets the underlying screen object. More...

surface &	get_screen_surface ()
	return the screen surface or the surface used for map_screenshot. More...

virtual bool	in_editor () const

const SDL_Rect &	minimap_area () const
	mapx is the width of the portion of the display which shows the game area. More...

const SDL_Rect &	palette_area () const

const SDL_Rect &	unit_image_area () const

const SDL_Rect &	max_map_area () const
	Returns the maximum area used for the map regardless to resolution and view size. More...

const SDL_Rect &	map_area () const
	Returns the area used for the map. More...

const SDL_Rect &	map_outside_area () const
	Returns the available area for a map, this may differ from the above. More...

const map_location	hex_clicked_on (int x, int y) const
	given x,y co-ordinates of an onscreen pixel, will return the location of the hex that this pixel corresponds to. More...

const map_location	pixel_position_to_hex (int x, int y) const
	given x,y co-ordinates of a pixel on the map, will return the location of the hex that this pixel corresponds to. More...

map_location	minimap_location_on (int x, int y)
	given x,y co-ordinates of the mouse, will return the location of the hex in the minimap that the mouse is currently over, or an invalid location if the mouse isn't over the minimap. More...

const map_location &	selected_hex () const

const map_location &	mouseover_hex () const

void	invalidate_game_status ()
	Function to invalidate the game status displayed on the sidebar. More...

int	get_location_x (const map_location &loc) const
	Functions to get the on-screen positions of hexes. More...

int	get_location_y (const map_location &loc) const

const rect_of_hexes	hexes_under_rect (const SDL_Rect &r) const
	Return the rectangular area of hexes overlapped by r (r is in screen coordinates) More...

const rect_of_hexes	get_visible_hexes () const
	Returns the rectangular area of visible hexes. More...

bool	shrouded (const map_location &loc) const
	Returns true if location (x,y) is covered in shroud. More...

bool	fogged (const map_location &loc) const
	Returns true if location (x,y) is covered in fog. More...

void	set_grid (const bool grid)
	Determines whether a grid should be overlayed on the game board. More...

bool	get_draw_coordinates () const
	Getter for the x,y debug overlay on tiles. More...

void	set_draw_coordinates (bool value)
	Setter for the x,y debug overlay on tiles. More...

bool	get_draw_terrain_codes () const
	Getter for the terrain code debug overlay on tiles. More...

void	set_draw_terrain_codes (bool value)
	Setter for the terrain code debug overlay on tiles. More...

bool	get_draw_num_of_bitmaps () const
	Getter for the number of bitmaps debug overlay on tiles. More...

void	set_draw_num_of_bitmaps (bool value)
	Setter for the terrain code debug overlay on tiles. More...

surface	screenshot (bool map_screenshot=false)
	Capture a (map-)screenshot into a surface. More...

void	redraw_everything ()
	Invalidates entire screen, including all tiles and sidebar. More...

void	add_redraw_observer (std::function< void(display &)> f)
	Adds a redraw observer, a function object to be called when redraw_everything is used. More...

void	clear_redraw_observers ()
	Clear the redraw observers. More...

theme &	get_theme ()

void	set_theme (config theme_cfg)

std::shared_ptr< gui::button >	find_action_button (const std::string &id)
	Retrieves a pointer to a theme UI button. More...

std::shared_ptr< gui::button >	find_menu_button (const std::string &id)

void	create_buttons ()

void	layout_buttons ()

void	render_buttons ()

void	invalidate_theme ()

void	refresh_report (const std::string &report_name, const config *new_cfg=nullptr)
	Redraws the specified report (if anything has changed). More...

void	draw_minimap_units ()

void	invalidate_all ()
	Function to invalidate all tiles. More...

bool	invalidate (const map_location &loc)
	Function to invalidate a specific tile for redrawing. More...

bool	invalidate (const std::set< map_location > &locs)

bool	propagate_invalidation (const std::set< map_location > &locs)
	If this set is partially invalidated, invalidate all its hexes. More...

bool	invalidate_locations_in_rect (const SDL_Rect &rect)
	invalidate all hexes under the rectangle rect (in screen coordinates) More...

bool	invalidate_visible_locations_in_rect (const SDL_Rect &rect)

void	invalidate_animations ()
	Function to invalidate animated terrains and units which may have changed. More...

void	invalidate_animations_location (const map_location &loc)
	Per-location invalidation called by invalidate_animations() Extra game per-location invalidation (village ownership) More...

void	reset_standing_animations ()

void	set_mouseover_hex_overlay (const surface &image)
	mouseover_hex_overlay_ require a prerendered surface and is drawn underneath the mouse's location More...

void	clear_mouseover_hex_overlay ()

terrain_builder &	get_builder ()

void	flip ()

void	update_display ()
	Copy the backbuffer to the framebuffer. More...

void	rebuild_all ()
	Rebuild all dynamic terrain. More...

const theme::action *	action_pressed ()

const theme::menu *	menu_pressed ()

void	enable_menu (const std::string &item, bool enable)
	Finds the menu which has a given item in it, and enables or disables it. More...

void	set_diagnostic (const std::string &msg)

void	set_turbo (const bool turbo)
	Set/Get whether 'turbo' mode is on. More...

double	turbo_speed () const

void	set_turbo_speed (const double speed)

void	set_idle_anim (bool ison)
	control unit idle animations and their frequency More...

bool	idle_anim () const

void	set_idle_anim_rate (int rate)

double	idle_anim_rate () const

void	bounds_check_position ()

void	bounds_check_position (int &xpos, int &ypos) const

bool	scroll (int xmov, int ymov, bool force=false)
	Scrolls the display by xmov,ymov pixels. More...

bool	set_zoom (bool increase)
	Zooms the display in (true) or out (false). More...

bool	set_zoom (unsigned int amount, const bool validate_value_and_set_index=true)
	Sets the display zoom to the specified amount. More...

void	toggle_default_zoom ()
	Sets the zoom amount to the default. More...

bool	view_locked () const

void	set_view_locked (bool value)
	Sets whether the map view is locked (e.g. More...

void	scroll_to_tile (const map_location &loc, SCROLL_TYPE scroll_type=ONSCREEN, bool check_fogged=true, bool force=true)
	Scroll such that location loc is on-screen. More...

void	scroll_to_tiles (map_location loc1, map_location loc2, SCROLL_TYPE scroll_type=ONSCREEN, bool check_fogged=true, double add_spacing=0.0, bool force=true)
	Scroll such that location loc1 is on-screen. More...

void	scroll_to_tiles (const std::vector< map_location >::const_iterator &begin, const std::vector< map_location >::const_iterator &end, SCROLL_TYPE scroll_type=ONSCREEN, bool check_fogged=true, bool only_if_possible=false, double add_spacing=0.0, bool force=true)
	Scroll to fit as many locations on-screen as possible, starting with the first. More...

void	scroll_to_tiles (const std::vector< map_location > &locs, SCROLL_TYPE scroll_type=ONSCREEN, bool check_fogged=true, bool only_if_possible=false, double add_spacing=0.0, bool force=true)
	Scroll to fit as many locations on-screen as possible, starting with the first. More...

events::generic_event &	scroll_event () const
	Expose the event, so observers can be notified about map scrolling. More...

events::generic_event &	complete_redraw_event ()

bool	tile_fully_on_screen (const map_location &loc) const
	Check if a tile is fully visible on screen. More...

bool	tile_nearly_on_screen (const map_location &loc) const
	Checks if location loc or one of the adjacent tiles is visible on screen. More...

virtual void	draw ()
	Draws invalidated items. More...

void	draw (bool update)

void	draw (bool update, bool force)

map_labels &	labels ()

const map_labels &	labels () const

void	announce (const std::string &msg, const color_t &color=font::GOOD_COLOR, const announce_options &options=announce_options())
	Announce a message prominently. More...

void	recalculate_minimap ()
	Schedule the minimap for recalculation. More...

void	redraw_minimap ()
	Schedule the minimap to be redrawn. More...

void	blindfold (bool flag)

bool	is_blindfolded () const

void	write (config &cfg) const

virtual void	handle_event (const SDL_Event &)

virtual void	handle_window_event (const SDL_Event &event)

void	init_flags ()
	Init the flag list and the team colors used by ~TC. More...

void	reinit_flags_for_team (const team &)
	Rebuild the flag list (not team colors) for a single side. More...

void	reset_reports (reports &reports_object)

void	render_image (int x, int y, const display::drawing_layer drawing_layer, const map_location &loc, surface image, bool hreverse=false, bool greyscale=false, fixed_t alpha=ftofxp(1.0), color_t blendto={0, 0, 0}, double blend_ratio=0, double submerged=0.0, bool vreverse=false)
	Draw an image at a certain location. More...

void	draw_text_in_hex (const map_location &loc, const drawing_layer layer, const std::string &text, std::size_t font_size, color_t color, double x_in_hex=0.5, double y_in_hex=0.5)
	Draw text on a hex. More...

void	drawing_buffer_add (const drawing_layer layer, const map_location &loc, int x, int y, const surface &surf, const SDL_Rect &clip=SDL_Rect())
	Add an item to the drawing buffer. More...

void	drawing_buffer_add (const drawing_layer layer, const map_location &loc, int x, int y, const std::vector< surface > &surf, const SDL_Rect &clip=SDL_Rect())

void	add_arrow (arrow &)

void	remove_arrow (arrow &)

void	update_arrow (arrow &a)
	Called by arrow objects when they change. More...

Public Member Functions inherited from events::sdl_handler
virtual void	process_event ()

virtual void	volatile_draw ()

virtual void	volatile_undraw ()

virtual bool	requires_event_focus (const SDL_Event *=nullptr) const

virtual void	process_help_string (int, int)

virtual void	process_tooltip_string (int, int)

virtual void	join ()

virtual void	join (context &c)

virtual void	join_same (sdl_handler *parent)

virtual void	leave ()

virtual void	join_global ()

virtual void	leave_global ()

virtual bool	has_joined ()

virtual bool	has_joined_global ()

sdl_handler &	operator= (sdl_handler &&)=delete
	Moving would require two instances' context membership to be handled, it's simpler to delete these and require the two instances to be separately constructed / destructed. More...

	sdl_handler (sdl_handler &&)=delete

Static Public Member Functions
static game_display *	get_singleton ()

static int &	debug_highlight (const map_location &loc)
	annotate hex with number, useful for debugging or UI prototype More...

static void	clear_debug_highlights ()

Static Public Member Functions inherited from display
static display *	get_singleton ()
	Returns the display object if a display object exists. More...

static bool	outside_area (const SDL_Rect &area, const int x, const int y)
	Check if the bbox of the hex at x,y has pixels outside the area rectangle. More...

static int	hex_width ()
	Function which returns the width of a hex in pixels, up to where the next hex starts. More...

static int	hex_size ()
	Function which returns the size of a hex in pixels (from top tip to bottom tip or left edge to right edge). More...

static double	get_zoom_factor ()
	Returns the current zoom factor. More...

static gui::button::TYPE	string_to_button_type (const std::string &type)

static void	toggle_benchmark ()
	Toggle to continuously redraw the screen. More...

static void	toggle_debug_foreground ()
	Toggle to debug foreground terrain. More...

static bool	zoom_at_max ()

static bool	zoom_at_min ()

Protected Member Functions
virtual void	pre_draw () override
	game_display pre_draw does specific things related e.g. More...

virtual void	post_draw () override
	Calls the whiteboard's post-draw method. More...

virtual void	draw_invalidated () override
	Only called when there's actual redrawing to do. More...

virtual void	post_commit () override
	Hook for actions to take right after draw() calls drawing_buffer_commit No action here by default. More...

virtual void	draw_hex (const map_location &loc) override
	Redraws a single gamemap location. More...

virtual overlay_map &	get_overlays () override
	Inherited from display. More...

Protected Member Functions inherited from display
map_location	get_middle_location () const

virtual const SDL_Rect &	get_clip_rect ()
	Get the clipping rectangle for drawing. More...

virtual image::TYPE	get_image_type (const map_location &loc)

void	draw_minimap ()

void	get_terrain_images (const map_location &loc, const std::string &timeid, TERRAIN_TYPE terrain_type)

std::vector< surface >	get_fog_shroud_images (const map_location &loc, image::TYPE image_type)

void	draw_image_for_report (surface &img, SDL_Rect &rect)

void	scroll_to_xy (int screenxpos, int screenypos, SCROLL_TYPE scroll_type, bool force=true)

void	drawing_buffer_commit ()
	Draws the drawing_buffer_ and clears it. More...

void	drawing_buffer_clear ()
	Clears the drawing buffer. More...

void	draw_all_panels ()
	redraw all panels associated with the map display More...

void	draw_init ()
	Initiate a redraw. More...

void	draw_wrap (bool update, bool force)

void	process_reachmap_changes ()

Protected Member Functions inherited from video2::draw_layering
	draw_layering (const bool auto_join=true)

virtual	~draw_layering ()

Protected Member Functions inherited from events::sdl_handler
	sdl_handler (const bool auto_join=true)

	sdl_handler (const sdl_handler &)

sdl_handler &	operator= (const sdl_handler &)

virtual	~sdl_handler ()

virtual std::vector< sdl_handler * >	handler_members ()

Protected Attributes
std::set< map_location >	units_that_can_reach_goal_

Protected Attributes inherited from display
const display_context *	dc_

std::unique_ptr< halo::manager >	halo_man_

std::weak_ptr< wb::manager >	wb_

exclusive_unit_draw_requests_t	exclusive_unit_draw_requests_
	map of hexes where only one unit should be drawn, the one identified by the associated id string More...

CVideo &	screen_

std::size_t	currentTeam_

bool	dont_show_all_

int	xpos_
	Position of the top-left corner of the viewport, in pixels. More...

int	ypos_

bool	view_locked_

theme	theme_

int	zoom_index_

const std::unique_ptr< fake_unit_manager >	fake_unit_man_

const std::unique_ptr< terrain_builder >	builder_

surface	minimap_

SDL_Rect	minimap_location_

bool	redrawMinimap_

bool	redraw_background_

bool	invalidateAll_

bool	grid_

int	diagnostic_label_

bool	panelsDrawn_

double	turbo_speed_

bool	turbo_

bool	invalidateGameStatus_

const std::unique_ptr< map_labels >	map_labels_

reports *	reports_object_

events::generic_event	scroll_event_
	Event raised when the map is being scrolled. More...

events::generic_event	complete_redraw_event_
	notify observers that the screen has been redrawn completely atm this is used for replay_controller to add replay controls to the standard theme More...

boost::circular_buffer< unsigned >	frametimes_

unsigned int	fps_counter_

std::chrono::seconds	fps_start_

unsigned int	fps_actual_

uint32_t	last_frame_finished_ = 0u

std::map< std::string, SDL_Rect >	reportRects_

std::map< std::string, surface >	reportSurfaces_

std::map< std::string, config >	reports_

std::vector< std::shared_ptr< gui::button > >	menu_buttons_

std::vector< std::shared_ptr< gui::button > >	action_buttons_

std::set< map_location >	invalidated_

surface	mouseover_hex_overlay_

surface	tod_hex_mask1

surface	tod_hex_mask2

std::vector< std::string >	fog_images_

std::vector< std::string >	shroud_images_

map_location	selectedHex_

map_location	mouseoverHex_

CKey	keys_

bool	animate_map_
	Local cache for preferences::animate_map, since it is constantly queried. More...

bool	animate_water_
	Local version of preferences::animate_water, used to detect when it's changed. More...

std::size_t	activeTeam_

drawing_buffer	drawing_buffer_

bool	map_screenshot_
	Used to indicate to drawing functions that we are doing a map screenshot. More...

reach_map	reach_map_

reach_map	reach_map_old_

bool	reach_map_changed_

Private Member Functions
	game_display (const game_display &)

void	operator= (const game_display &)

virtual void	draw_sidebar () override
	Called near the end of a draw operation, derived classes can use this to render a specific sidebar. More...

void	invalidate_route ()

Private Attributes
overlay_map	overlay_map_

map_location	attack_indicator_src_

map_location	attack_indicator_dst_

pathfind::marked_route	route_

map_location	displayedUnitHex_

double	sidebarScaling_

bool	first_turn_

bool	in_game_

const std::unique_ptr< display_chat_manager >	chat_man_

game_mode	mode_

bool	needs_rebuild_

Static Private Attributes
static std::map< map_location, int >	debugHighlights_

Additional Inherited Members
Protected Types inherited from display
enum	TERRAIN_TYPE { BACKGROUND, FOREGROUND }

typedef std::map< map_location, std::string >	exclusive_unit_draw_requests_t

typedef std::list< blit_helper >	drawing_buffer

typedef std::map< map_location, unsigned int >	reach_map

typedef std::map< map_location, std::vector< overlay > >	overlay_map

Static Protected Member Functions inherited from display
static void	fill_images_list (const std::string &prefix, std::vector< std::string > &images)

static const std::string &	get_variant (const std::vector< std::string > &variants, const map_location &loc)

Static Protected Attributes inherited from display
static unsigned int	zoom_ = DefaultZoom
	The current zoom, in pixels (on screen) per 72 pixels (in the graphic assets), i.e., 72 means 100%. More...

static unsigned int	last_zoom_ = SmallZoom
	The previous value of zoom_. More...

static display *	singleton_ = nullptr

Detailed Description

Definition at line 34 of file game_display.hpp.

Member Enumeration Documentation

◆ game_mode

enum game_display::game_mode

Sets the linger mode for the display.

There have been some discussions on what to do with fog and shroud the extra variables make it easier to modify the behavior. There might even be a split between victory and defeat.

Todo:: if the current implementation is wanted we can change the stuff back to a boolean

Enumerator
RUNNING	no linger overlay, show fog and shroud.
LINGER

Definition at line 210 of file game_display.hpp.

Constructor & Destructor Documentation

◆ game_display() [1/2]

game_display::game_display	(	game_board &	board,
		std::weak_ptr< wb::manager >	wb,
		reports &	reports_object,
		const config &	theme_cfg,
		const config &	level,
		bool	dummy = `false`
	)

Definition at line 65 of file game_display.cpp.

References CVideo::clear_screen(), and display::video().

◆ ~game_display()

game_display::~game_display ( )

Definition at line 86 of file game_display.cpp.

References chat_man_.

◆ game_display() [2/2]

game_display::game_display ( const game_display & )

private

Member Function Documentation

◆ attack_indicator_direction()

std::string game_display::attack_indicator_direction ( ) const

inline

Function to get attack direction suffix.

Definition at line 170 of file game_display.hpp.

References attack_indicator_dst_, attack_indicator_src_, map_location::get_relative_dir(), get_terrain_on(), and map_location::write_direction().

Referenced by draw_hex().

◆ begin_game()

void game_display::begin_game ( )

Definition at line 660 of file game_display.cpp.

References display::create_buttons(), in_game_, and display::invalidate_all().

Referenced by get_chat_manager().

◆ clear_attack_indicator()

void game_display::clear_attack_indicator ( )

Definition at line 646 of file game_display.cpp.

References map_location::null_location(), and set_attack_indicator().

Referenced by events::mouse_handler::attack_enemy_(), events::mouse_handler::mouse_motion(), events::mouse_handler::move_action(), events::mouse_handler::save_whiteboard_attack(), events::mouse_handler::select_hex(), and events::mouse_handler::touch_motion().

◆ clear_debug_highlights()

static void game_display::clear_debug_highlights ( )

inlinestatic

Definition at line 186 of file game_display.hpp.

References debugHighlights_.

◆ current_team_name()

std::string game_display::current_team_name ( ) const

Definition at line 651 of file game_display.cpp.

References display::currentTeam_, display::dc_, display::team_valid(), and display_context::teams().

Referenced by events::menu_handler::clear_labels(), and playing_side().

◆ debug_highlight()

int & game_display::debug_highlight ( const map_location & loc )

static

annotate hex with number, useful for debugging or UI prototype

Definition at line 626 of file game_display.cpp.

References game_config::debug, and debugHighlights_.

Referenced by displayed_unit_hex().

◆ display_unit_hex()

void game_display::display_unit_hex ( map_location hex )

Change the unit to be displayed in the sidebar.

This is used when selecting or highlighting is not wanted.

< Lasts for whole method.

Definition at line 177 of file game_display.cpp.

References display::dc_, displayedUnitHex_, display::dont_show_all_, resources::gameboard, game_board::get_visible_unit(), invalidate_unit(), synced_context::is_synced(), display_context::teams(), map_location::valid(), and display::viewing_team().

Referenced by events::mouse_handler::attack_enemy_(), observers(), select_hex(), and unit_display::unit_healing().

◆ displayed_unit_hex()

virtual const map_location& game_display::displayed_unit_hex ( ) const

inlineoverridevirtual

Virtual functions shadowed in game_display.

These are needed to generate reports easily, without dynamic casting. Hope to factor out eventually.

Reimplemented from display.

Definition at line 180 of file game_display.hpp.

References debug_highlight(), and displayedUnitHex_.

◆ draw_hex()

void game_display::draw_hex ( const map_location & loc )

overrideprotectedvirtual

Redraws a single gamemap location.

Reimplemented from display.

Definition at line 250 of file game_display.cpp.

References attack_indicator_direction(), attack_indicator_dst_, attack_indicator_src_, font::BAD_COLOR, display::currentTeam_, display::dc_, game_config::debug, debugHighlights_, display::draw_hex(), draw_movement_info(), display::draw_text_in_hex(), display::drawing_buffer_add(), footsteps_images(), resources::gameboard, cursor::get(), image::get_image(), display::get_location_x(), display::get_location_y(), display::get_map(), game_board::get_visible_unit(), is_shrouded(), display::LAYER_ATTACK_INDICATOR, display::LAYER_FOOTSTEPS, display::LAYER_LINGER_OVERLAY, display::LAYER_MOUSEOVER_BOTTOM, display::LAYER_MOUSEOVER_TOP, display::LAYER_MOVE_INFO, display::LAYER_REACHMAP, display::LAYER_SELECTED_HEX, game_config::images::linger, mode_, display::mouseoverHex_, gamemap::on_board(), display::reach_map_, route_, RUNNING, image::SCALED_TO_HEX, game_config::images::selected, display::selectedHex_, display::shrouded(), unit::side(), display_context::teams(), image::TOD_COLORED, game_config::images::unreachable, display::viewing_team(), w, cursor::WAIT, and display::wb_.

Referenced by invalidate_unit().

◆ draw_invalidated()

void game_display::draw_invalidated ( )

overrideprotectedvirtual

Only called when there's actual redrawing to do.

Loops through invalidated locations and redraws them. Derived classes can override this, possibly to insert pre- or post-processing around a call to the base class's function.

Reimplemented from display.

Definition at line 227 of file game_display.cpp.

References display::draw_invalidated(), display::exclusive_unit_draw_requests_, display::fake_unit_man_, display::halo_man_, display::invalidated_, and unit_drawer::redraw_unit().

Referenced by invalidate_unit().

◆ draw_movement_info()

void game_display::draw_movement_info ( const map_location & loc )

Draws the movement info (turns available) for a given location.

Definition at line 398 of file game_display.cpp.

References display::currentTeam_, display::dc_, display::draw_text_in_hex(), display::drawing_buffer_add(), unit_map::end(), unit_map::find(), game_board::find_visible_unit(), resources::gameboard, image::get_image(), display::get_location_x(), display::get_location_y(), display::get_map(), display::LAYER_MOVE_INFO, pathfind::marked_route::marks, display::mouseoverHex_, font::NORMAL_COLOR, display::reach_map_, game_config::red_to_green(), route_, image::SCALED_TO_HEX, display::selectedHex_, pathfind::marked_route::steps, display_context::teams(), display_context::units(), movetype::UNREACHABLE, map_location::valid(), w, display::wb_, and font::YELLOW_COLOR.

Referenced by draw_hex(), and get_route().

◆ draw_sidebar()

void game_display::draw_sidebar ( )

overrideprivatevirtual

Called near the end of a draw operation, derived classes can use this to render a specific sidebar.

Very similar to post_commit.

Reimplemented from display.

Definition at line 367 of file game_display.cpp.

References display::invalidateGameStatus_, display::refresh_report(), reports::report_list(), display::reports_object_, and display::team_valid().

◆ float_label()

void game_display::float_label	(	const map_location &	loc,
		const std::string &	text,
		const color_t &	color
	)

Function to float a label above a tile.

Definition at line 609 of file game_display.cpp.

References font::add_floating_label(), font::ANCHOR_LABEL_MAP, display::fogged(), display::get_location_x(), display::get_location_y(), font::floating_label::set_color(), font::floating_label::set_font_size(), font::floating_label::set_lifetime(), font::floating_label::set_move(), font::floating_label::set_position(), font::floating_label::set_scroll_mode(), preferences::show_floating_labels(), font::SIZE_XLARGE, display::turbo_speed(), and display::zoom_.

Referenced by wfl::builtins::DEFINE_WFL_FUNCTION(), get_route(), and unit_frame::redraw().

◆ get_attack_indicator_src()

const map_location& game_display::get_attack_indicator_src ( )

inline

Definition at line 167 of file game_display.hpp.

References attack_indicator_src_.

Referenced by REPORT_GENERATOR().

◆ get_chat_manager()

display_chat_manager& game_display::get_chat_manager ( )

inline

Definition at line 195 of file game_display.hpp.

References begin_game(), and chat_man_.

Referenced by events::menu_handler::add_chat_message(), chat_message(), events::menu_handler::clear_messages(), wfl::builtins::DEFINE_WFL_FUNCTION(), gui2::dialogs::lua_interpreter::display(), ai::formula_ai::display_message(), do_replay_handle(), ai::readonly_context_impl::log_message(), turn_info::process_network_data(), game_events::wml_event_pump::show_wml_messages(), and gui::floating_textbox::tab().

◆ get_overlays()

display::overlay_map & game_display::get_overlays ( )

overrideprotectedvirtual

Inherited from display.

Implements display.

Definition at line 684 of file game_display.cpp.

References overlay_map_.

Referenced by invalidate_unit().

◆ get_route()

const pathfind::marked_route& game_display::get_route ( )

inline

Gets the route along which footsteps are drawn to show movement of a unit.

If no route is currently being shown, the array get_route().steps will be empty.

Definition at line 122 of file game_display.hpp.

References draw_movement_info(), float_label(), and route_.

Referenced by unit_moves().

◆ get_singleton()

static game_display* game_display::get_singleton ( )

inlinestatic

Definition at line 45 of file game_display.hpp.

References new_turn(), and display::singleton_.

Referenced by actions::undo_list::apply_shroud_changes(), chat_message(), battle_context::choose_defender_weapon(), wb::manager::create_temp_move(), wfl::builtins::DEFINE_WFL_FUNCTION(), ai::formula_ai::display_message(), do_replay_handle(), wb::manager::erase_temp_move(), game_events::wml_event_pump::flush_messages(), ai::readonly_context_impl::log_message(), game_events::wml_event_pump::operator()(), gui2::dialogs::mp_change_control::pre_show(), game_events::wml_event_pump::process_event(), turn_info::process_network_data(), game_events::wml_event_pump::raise(), actions::undo_list::redo(), unit_frame::redraw(), REPORT_GENERATOR(), wfl::formula_debugger::show_gui(), game_events::wml_event_pump::show_wml_messages(), SYNCED_COMMAND_HANDLER_FUNCTION(), gui::floating_textbox::tab(), actions::undo::recall_action::undo(), actions::undo::recruit_action::undo(), actions::undo::move_action::undo(), actions::undo_list::undo(), unit_display::unit_healing(), unit_moves(), unit_display::unit_recruited(), game_events::WML_HANDLER_FUNCTION(), and wb::highlighter::~highlighter().

◆ get_terrain_on()

t_translation::terrain_code game_display::get_terrain_on	(	int	palx,
		int	paly,
		int	x,
		int	y
	)

Referenced by attack_indicator_direction().

◆ get_time_of_day()

const time_of_day & game_display::get_time_of_day ( const map_location & loc ) const

overridevirtual

Reimplemented from display.

Definition at line 357 of file game_display.cpp.

References tod_manager::get_time_of_day(), and resources::tod_manager.

Referenced by invalidate_unit().

◆ has_time_area()

bool game_display::has_time_area ( ) const

overridevirtual

Reimplemented from display.

Definition at line 362 of file game_display.cpp.

References tod_manager::has_time_area(), and resources::tod_manager.

Referenced by invalidate_unit().

◆ highlight_another_reach()

void game_display::highlight_another_reach	(	const pathfind::paths &	paths_list,
		const map_location &	goal = `map_location::null_location()`
	)

Add more paths to highlight.

Print numbers where they overlap. Used by Show Enemy Moves. If goal is not null_location, highlight enemy units that can reach goal.

Definition at line 559 of file game_display.cpp.

References pathfind::paths::dest_vect::contains(), pathfind::paths::step::curr, pathfind::paths::destinations, pathfind::paths::dest_vect::find(), pathfind::paths::dest_vect::get_path(), map_location::null_location(), display::reach_map_, display::reach_map_changed_, and units_that_can_reach_goal_.

Referenced by highlight_reach(), observers(), events::mouse_handler::select_hex(), and events::menu_handler::show_enemy_moves().

◆ highlight_hex()

void game_display::highlight_hex ( map_location hex )

overridevirtual

Function to highlight a location.

If a unit is in the location, it will be displayed in the sidebar. Selection is used when a unit has been clicked on, while highlighting is used when a location has been moused over.

< Lasts for whole method.

Reimplemented from display.

Definition at line 153 of file game_display.cpp.

References unit_map::count(), display::dc_, displayedUnitHex_, display::dont_show_all_, resources::gameboard, game_board::get_visible_unit(), display::highlight_hex(), display::invalidate_game_status(), invalidate_unit(), synced_context::is_synced(), display::mouseoverHex_, display::selectedHex_, display_context::teams(), display_context::units(), and display::viewing_team().

Referenced by events::mouse_handler::attack_enemy_(), events::menu_handler::do_search(), events::mouse_handler::mouse_motion(), observers(), and events::mouse_handler::touch_motion().

◆ highlight_reach()

void game_display::highlight_reach ( const pathfind::paths & paths_list )

Sets the paths that are currently displayed as available for the unit to move along.

All other paths will be grayed out.

Definition at line 553 of file game_display.cpp.

References highlight_another_reach(), and unhighlight_reach().

Referenced by events::mouse_handler::mouse_motion(), observers(), events::mouse_handler::select_hex(), and events::mouse_handler::touch_motion().

◆ in_game()

virtual bool game_display::in_game ( ) const

inlineoverridevirtual

Reimplemented from display.

Definition at line 199 of file game_display.hpp.

References in_game_.

◆ invalidate_route()

void game_display::invalidate_route ( )

private

Definition at line 587 of file game_display.cpp.

References i, display::invalidate(), route_, and pathfind::marked_route::steps.

Referenced by set_route().

◆ invalidate_unit()

void game_display::invalidate_unit ( )

inline

Function to invalidate that unit status displayed on the sidebar.

Definition at line 131 of file game_display.hpp.

References draw_hex(), draw_invalidated(), get_overlays(), get_time_of_day(), has_time_area(), invalidate_unit_after_move(), display::invalidateGameStatus_, post_commit(), post_draw(), and pre_draw().

Referenced by actions::undo_list::apply_shroud_changes(), battle_context::choose_defender_weapon(), display_unit_hex(), highlight_hex(), invalidate_unit_after_move(), actions::undo_list::redo(), events::menu_handler::rename_unit(), SYNCED_COMMAND_HANDLER_FUNCTION(), actions::undo_list::undo(), and unit_display::unit_recruited().

◆ invalidate_unit_after_move()

void game_display::invalidate_unit_after_move	(	const map_location &	src,
		const map_location &	dst
	)

Same as invalidate_unit() if moving the displayed unit.

Definition at line 191 of file game_display.cpp.

References displayedUnitHex_, and invalidate_unit().

Referenced by invalidate_unit(), and actions::undo::move_action::undo().

◆ maybe_rebuild()

bool game_display::maybe_rebuild ( )

Rebuilds the screen if needs_rebuild(true) was previously called, and resets the flag.

Definition at line 673 of file game_display.cpp.

References display::invalidate_all(), needs_rebuild_, display::rebuild_all(), and display::recalculate_minimap().

Referenced by game_lua_kernel::intf_redraw(), game_events::wml_event_pump::process_event(), and SYNCED_COMMAND_HANDLER_FUNCTION().

◆ needs_rebuild()

void game_display::needs_rebuild ( bool b )

Sets whether the screen (map visuals) needs to be rebuilt. This is typically after the map has been changed by wml.

Definition at line 667 of file game_display.cpp.

References needs_rebuild_.

Referenced by SYNCED_COMMAND_HANDLER_FUNCTION(), and game_events::WML_HANDLER_FUNCTION().

◆ new_turn()

void game_display::new_turn ( )

Update lighting settings.

Should be called on every new turn.

Definition at line 94 of file game_display.cpp.

References adjust_surface_alpha(), first_turn_, ftofxp, fxpdiv, image::get_image(), tod_manager::get_previous_time_of_day(), tod_manager::get_time_of_day(), i, time_of_day::image_mask, display::invalidate_all(), image::SCALED_TO_HEX, display::tod_hex_mask1, display::tod_hex_mask2, resources::tod_manager, display::turbo_speed(), and display::update_tod().

Referenced by get_singleton(), SYNCED_COMMAND_HANDLER_FUNCTION(), and game_events::WML_HANDLER_FUNCTION().

◆ observers()

virtual const std::set<std::string>& game_display::observers ( ) const

inlineoverridevirtual

Reimplemented from display.

Definition at line 57 of file game_display.hpp.

References chat_man_, display_unit_hex(), highlight_another_reach(), highlight_hex(), highlight_reach(), map_location::null_location(), display::ONSCREEN, scroll_to_leader(), and select_hex().

Referenced by events::menu_handler::has_friends(), and gui2::dialogs::mp_change_control::pre_show().

◆ operator=()

void game_display::operator= ( const game_display & )

private

◆ playing_side()

virtual int game_display::playing_side ( ) const

inlineoverridevirtual

The playing team is the team whose turn it is.

Reimplemented from display.

Definition at line 190 of file game_display.hpp.

References display::activeTeam_, and current_team_name().

Referenced by turn_info::process_network_data().

◆ post_commit()

void game_display::post_commit ( )

overrideprotectedvirtual

Hook for actions to take right after draw() calls drawing_buffer_commit No action here by default.

Reimplemented from display.

Definition at line 245 of file game_display.cpp.

References display::halo_man_.

Referenced by invalidate_unit().

◆ post_draw()

void game_display::post_draw ( )

overrideprotectedvirtual

Calls the whiteboard's post-draw method.

Reimplemented from display.

Definition at line 221 of file game_display.cpp.

References w, and display::wb_.

Referenced by invalidate_unit().

◆ pre_draw()

void game_display::pre_draw ( )

overrideprotectedvirtual

game_display pre_draw does specific things related e.g.

to unit rendering and calls the whiteboard pre-draw method.

Todo:: FIXME: must modify changed, but best to do it at the floating_label level

Reimplemented from display.

Definition at line 208 of file game_display.cpp.

References chat_man_, display::process_reachmap_changes(), w, and display::wb_.

Referenced by invalidate_unit().

◆ scroll_to_leader()

void game_display::scroll_to_leader	(	int	side,
		SCROLL_TYPE	scroll_type = `ONSCREEN`,
		bool	force = `true`
	)

Scrolls to the leader of a certain side.

This will normally be the playing team.

Definition at line 199 of file game_display.cpp.

References display::dc_, unit_map::find_leader(), display_context::get_team(), display::scroll_to_tile(), display_context::units(), unit_map::iterator_base< iter_types >::valid(), and display::viewing_side().

Referenced by observers(), and events::menu_handler::status_table().

◆ select_hex()

void game_display::select_hex ( map_location hex )

overridevirtual

Function to display a location as selected.

If a unit is in the location, and there is no unit in the currently highlighted hex, the unit will be displayed in the sidebar.

Reimplemented from display.

Definition at line 143 of file game_display.cpp.

References display_unit_hex(), display::fogged(), display::select_hex(), and map_location::valid().

Referenced by events::mouse_handler::attack_enemy_(), events::mouse_handler::move_action(), events::mouse_handler::move_unit_along_current_route(), observers(), events::mouse_handler::save_whiteboard_attack(), and events::mouse_handler::select_hex().

◆ set_attack_indicator()

void game_display::set_attack_indicator	(	const map_location &	src,
		const map_location &	dst
	)

Set the attack direction indicator.

Definition at line 632 of file game_display.cpp.

References attack_indicator_dst_, attack_indicator_src_, and display::invalidate().

Referenced by clear_attack_indicator(), events::mouse_handler::mouse_motion(), and events::mouse_handler::touch_motion().

◆ set_game_mode()

void game_display::set_game_mode ( const game_mode mode )

Definition at line 390 of file game_display.cpp.

References display::invalidate_all(), and mode_.

◆ set_route()

void game_display::set_route ( const pathfind::marked_route * route )

Sets the route along which footsteps are drawn to show movement of a unit.

If nullptr, no route is displayed. route does not have to remain valid after being set.

Definition at line 595 of file game_display.cpp.

References invalidate_route(), pathfind::marked_route::marks, route_, and pathfind::marked_route::steps.

Referenced by events::menu_handler::execute_gotos(), events::mouse_handler::mouse_motion(), events::mouse_handler::move_action(), events::mouse_handler::move_unit_along_current_route(), events::menu_handler::move_unit_to_loc(), events::mouse_handler::save_whiteboard_attack(), events::mouse_handler::select_hex(), events::mouse_handler::set_current_paths(), events::mouse_handler::touch_motion(), and units_that_can_reach_goal().

◆ unhighlight_reach()

bool game_display::unhighlight_reach ( )

Reset highlighting of paths.

Definition at line 575 of file game_display.cpp.

References display::reach_map_, display::reach_map_changed_, and units_that_can_reach_goal_.

Referenced by events::mouse_handler::attack_enemy_(), highlight_reach(), events::mouse_handler::mouse_motion(), events::mouse_handler::move_action(), events::mouse_handler::move_unit_along_current_route(), events::menu_handler::move_unit_to_loc(), events::mouse_handler::save_whiteboard_attack(), events::mouse_handler::select_hex(), events::mouse_handler::set_current_paths(), events::menu_handler::show_enemy_moves(), events::mouse_handler::touch_motion(), and units_that_can_reach_goal().

◆ units_that_can_reach_goal()

const std::set<map_location>& game_display::units_that_can_reach_goal ( ) const

inline

Return the locations of units that can reach goal (.

See also: highlight_another_reach()).

Definition at line 106 of file game_display.hpp.

References set_route(), unhighlight_reach(), and units_that_can_reach_goal_.

Referenced by unit_drawer::unit_drawer().

Member Data Documentation

◆ attack_indicator_dst_

map_location game_display::attack_indicator_dst_

private

Definition at line 232 of file game_display.hpp.

Referenced by attack_indicator_direction(), draw_hex(), and set_attack_indicator().

◆ attack_indicator_src_

map_location game_display::attack_indicator_src_

private

Definition at line 231 of file game_display.hpp.

Referenced by attack_indicator_direction(), draw_hex(), get_attack_indicator_src(), and set_attack_indicator().

◆ chat_man_

const std::unique_ptr<display_chat_manager> game_display::chat_man_

private

Definition at line 244 of file game_display.hpp.

Referenced by get_chat_manager(), observers(), pre_draw(), and ~game_display().

◆ debugHighlights_

std::map< map_location, fixed_t > game_display::debugHighlights_

staticprivate

Definition at line 249 of file game_display.hpp.

Referenced by clear_debug_highlights(), debug_highlight(), and draw_hex().

◆ displayedUnitHex_

map_location game_display::displayedUnitHex_

private

Definition at line 238 of file game_display.hpp.

Referenced by display_unit_hex(), displayed_unit_hex(), highlight_hex(), and invalidate_unit_after_move().

◆ first_turn_

bool game_display::first_turn_

private

Definition at line 242 of file game_display.hpp.

Referenced by new_turn().

◆ in_game_

bool game_display::in_game_

private

Definition at line 242 of file game_display.hpp.

Referenced by begin_game(), and in_game().

◆ mode_

game_mode game_display::mode_

private

Definition at line 246 of file game_display.hpp.

Referenced by draw_hex(), and set_game_mode().

◆ needs_rebuild_

bool game_display::needs_rebuild_

private

Definition at line 251 of file game_display.hpp.

Referenced by maybe_rebuild(), and needs_rebuild().

◆ overlay_map_

overlay_map game_display::overlay_map_

private

Definition at line 228 of file game_display.hpp.

Referenced by get_overlays().

◆ route_

pathfind::marked_route game_display::route_

private

Definition at line 234 of file game_display.hpp.

Referenced by draw_hex(), draw_movement_info(), get_route(), invalidate_route(), and set_route().

◆ sidebarScaling_

double game_display::sidebarScaling_

private

Definition at line 240 of file game_display.hpp.

◆ units_that_can_reach_goal_

std::set<map_location> game_display::units_that_can_reach_goal_

protected

Definition at line 160 of file game_display.hpp.

Referenced by highlight_another_reach(), unhighlight_reach(), and units_that_can_reach_goal().

The documentation for this class was generated from the following files:

Public Types

Public Member Functions

Static Public Member Functions

Protected Member Functions

Protected Attributes

Private Member Functions

Private Attributes

Static Private Attributes

Additional Inherited Members

Detailed Description

Member Enumeration Documentation

◆ game_mode

Constructor & Destructor Documentation

◆ game_display() [1/2]

◆ ~game_display()

◆ game_display() [2/2]

Member Function Documentation

◆ attack_indicator_direction()

◆ begin_game()

◆ clear_attack_indicator()

◆ clear_debug_highlights()

◆ current_team_name()

◆ debug_highlight()

◆ display_unit_hex()

◆ displayed_unit_hex()

◆ draw_hex()

◆ draw_invalidated()

◆ draw_movement_info()

◆ draw_sidebar()

◆ float_label()

◆ get_attack_indicator_src()

◆ get_chat_manager()

◆ get_overlays()

◆ get_route()

◆ get_singleton()

◆ get_terrain_on()

◆ get_time_of_day()

◆ has_time_area()

◆ highlight_another_reach()

◆ highlight_hex()

◆ highlight_reach()

◆ in_game()

◆ invalidate_route()

◆ invalidate_unit()

◆ invalidate_unit_after_move()

◆ maybe_rebuild()

◆ needs_rebuild()

◆ new_turn()

◆ observers()

◆ operator=()

◆ playing_side()

◆ post_commit()

◆ post_draw()

◆ pre_draw()

◆ scroll_to_leader()

◆ select_hex()

◆ set_attack_indicator()

◆ set_game_mode()

◆ set_route()

◆ unhighlight_reach()

◆ units_that_can_reach_goal()

Member Data Documentation

◆ attack_indicator_dst_

◆ attack_indicator_src_

◆ chat_man_

◆ debugHighlights_

◆ displayedUnitHex_

◆ first_turn_

◆ in_game_

◆ mode_

◆ needs_rebuild_

◆ overlay_map_

◆ route_

◆ sidebarScaling_

◆ units_that_can_reach_goal_