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/>.
10 /** @file viewport_func.h Functions related to (drawing on) viewports. */
12 #ifndef VIEWPORT_FUNC_H
13 #define VIEWPORT_FUNC_H
15 #include "map/coord.h"
17 #include "viewport_type.h"
18 #include "window_type.h"
19 #include "station_type.h"
21 static const int TILE_HEIGHT_STEP
= 50; ///< One Z unit tile height difference is displayed as 50m.
23 void SetSelectionRed(bool);
25 void DeleteWindowViewport(Window
*w
);
26 void InitializeWindowViewport(Window
*w
, int x
, int y
, int width
, int height
, uint32 follow_flags
, ZoomLevel zoom
);
27 ViewPort
*IsPtInWindowViewport(const Window
*w
, int x
, int y
);
28 Point
GetTileBelowCursor();
29 void UpdateViewportPosition(Window
*w
);
31 void MarkAllViewportsDirty(int left
, int top
, int right
, int bottom
);
33 bool DoZoomInOutWindow(ZoomStateChange how
, Window
*w
);
34 void ZoomInOrOutToCursorWindow(bool in
, Window
* w
);
35 Point
GetTileZoomCenterWindow(bool in
, Window
* w
);
36 void HandleZoomMessage(Window
*w
, const ViewPort
*vp
, byte widget_zoom_in
, byte widget_zoom_out
);
39 * Zoom a viewport as far as possible in the given direction.
40 * @param how Zooming direction.
41 * @param w Window owning the viewport.
42 * @pre \a how should not be #ZOOM_NONE.
44 static inline void MaxZoomInOut(ZoomStateChange how
, Window
*w
)
46 while (DoZoomInOutWindow(how
, w
)) {};
49 void OffsetGroundSprite(int x
, int y
);
51 void DrawGroundSprite(SpriteID image
, PaletteID pal
, const SubSprite
*sub
= NULL
, int extra_offs_x
= 0, int extra_offs_y
= 0);
52 void DrawGroundSpriteAt(SpriteID image
, PaletteID pal
, int32 x
, int32 y
, int z
, const SubSprite
*sub
= NULL
, int extra_offs_x
= 0, int extra_offs_y
= 0);
53 void AddSortableSpriteToDraw(SpriteID image
, PaletteID pal
, int x
, int y
, int w
, int h
, int dz
, int z
, bool transparent
= false, int bb_offset_x
= 0, int bb_offset_y
= 0, int bb_offset_z
= 0, const SubSprite
*sub
= NULL
);
54 void AddChildSpriteScreen(SpriteID image
, PaletteID pal
, int x
, int y
, bool transparent
= false, const SubSprite
*sub
= NULL
, bool scale
= true);
55 void ViewportAddString(const DrawPixelInfo
*dpi
, ZoomLevel small_from
, const ViewportSign
*sign
, StringID string_normal
, StringID string_small
, StringID string_small_shadow
, uint64 params_1
, uint64 params_2
= 0, Colours colour
= INVALID_COLOUR
);
58 void StartSpriteCombine();
59 void EndSpriteCombine();
61 bool HandleViewportClicked(const ViewPort
*vp
, int x
, int y
);
62 void SetRedErrorSquare(TileIndex tile
);
63 void SetTileSelectSize(int w
, int h
);
64 void SetTileSelectBigSize(int ox
, int oy
, int sx
, int sy
);
66 void ViewportDoDraw(const ViewPort
*vp
, int left
, int top
, int right
, int bottom
);
68 bool ScrollWindowToTile(TileIndex tile
, Window
*w
, bool instant
= false);
69 bool ScrollWindowTo(int x
, int y
, int z
, Window
*w
, bool instant
= false);
71 void RebuildViewportOverlay(Window
*w
);
73 bool ScrollMainWindowToTile(TileIndex tile
, bool instant
= false);
74 bool ScrollMainWindowTo(int x
, int y
, int z
= -1, bool instant
= false);
76 void UpdateAllVirtCoords();
78 extern Point _tile_fract_coords
;
80 void MarkTileDirtyByTile(TileIndex tile
);
82 Point
GetViewportStationMiddle(const ViewPort
*vp
, const Station
*st
);
84 #endif /* VIEWPORT_FUNC_H */