src/viewport_type.h

   1 /*
   2  * This file is part of OpenTTD.
   3  * 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.
   4  * 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.
   5  * 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/>.
   6  */
   7
   8 /** @file viewport_type.h Types related to viewports. */
   9
  10 #ifndef VIEWPORT_TYPE_H
  11 #define VIEWPORT_TYPE_H
  12
  13 #include "zoom_type.h"
  14 #include "strings_type.h"
  15 #include "table/strings.h"
  16
  17 class LinkGraphOverlay;
  18
  19 /**
  20  * Data structure for viewport, display of a part of the world
  21  */
  22 struct Viewport {
  23         int left;    ///< Screen coordinate left edge of the viewport
  24         int top;     ///< Screen coordinate top edge of the viewport
  25         int width;   ///< Screen width of the viewport
  26         int height;  ///< Screen height of the viewport
  27
  28         int virtual_left;    ///< Virtual left coordinate
  29         int virtual_top;     ///< Virtual top coordinate
  30         int virtual_width;   ///< width << zoom
  31         int virtual_height;  ///< height << zoom
  32
  33         ZoomLevel zoom; ///< The zoom level of the viewport.
  34         std::shared_ptr<LinkGraphOverlay> overlay;
  35 };
  36
  37 /** Location information about a sign as seen on the viewport */
  38 struct ViewportSign {
  39         int32_t center;        ///< The center position of the sign
  40         int32_t top;           ///< The top of the sign
  41         uint16_t width_normal; ///< The width when not zoomed out (normal font)
  42         uint16_t width_small;  ///< The width when zoomed out (small font)
  43
  44         auto operator<=>(const ViewportSign &) const = default;
  45
  46         void UpdatePosition(int center, int top, StringID str, StringID str_small = STR_NULL);
  47         void MarkDirty(ZoomLevel maxzoom = ZOOM_LVL_MAX) const;
  48 };
  49
  50 /** Specialised ViewportSign that tracks whether it is valid for entering into a Kdtree */
  51 struct TrackedViewportSign : ViewportSign {
  52         bool kdtree_valid; ///< Are the sign data valid for use with the _viewport_sign_kdtree?
  53
  54         auto operator<=>(const TrackedViewportSign &) const = default;
  55
  56         /**
  57          * Update the position of the viewport sign.
  58          * Note that this function hides the base class function.
  59          */
  60         void UpdatePosition(int center, int top, StringID str, StringID str_small = STR_NULL)
  61         {
  62                 this->kdtree_valid = true;
  63                 this->ViewportSign::UpdatePosition(center, top, str, str_small);
  64         }
  65
  66
  67         TrackedViewportSign() : kdtree_valid{ false }
  68         {
  69         }
  70 };
  71
  72 /**
  73  * Directions of zooming.
  74  * @see DoZoomInOutWindow
  75  */
  76 enum ZoomStateChange {
  77         ZOOM_IN   = 0, ///< Zoom in (get more detailed view).
  78         ZOOM_OUT  = 1, ///< Zoom out (get helicopter view).
  79         ZOOM_NONE = 2, ///< Hack, used to update the button status.
  80 };
  81
  82 /**
  83  * Some values for constructing bounding boxes (BB). The Z positions under bridges are:
  84  * z=0..5  Everything that can be built under low bridges.
  85  * z=6     reserved, currently unused.
  86  * z=7     Z separator between bridge/tunnel and the things under/above it.
  87  */
  88 static const uint BB_HEIGHT_UNDER_BRIDGE = 6; ///< Everything that can be built under low bridges, must not exceed this Z height.
  89 static const uint BB_Z_SEPARATOR         = 7; ///< Separates the bridge/tunnel from the things under/above it.
  90
  91 /** Viewport place method (type of highlighted area and placed objects) */
  92 enum ViewportPlaceMethod {
  93         VPM_X_OR_Y          =    0, ///< drag in X or Y direction
  94         VPM_FIX_X           =    1, ///< drag only in X axis
  95         VPM_FIX_Y           =    2, ///< drag only in Y axis
  96         VPM_X_AND_Y         =    3, ///< area of land in X and Y directions
  97         VPM_X_AND_Y_LIMITED =    4, ///< area of land of limited size
  98         VPM_FIX_HORIZONTAL  =    5, ///< drag only in horizontal direction
  99         VPM_FIX_VERTICAL    =    6, ///< drag only in vertical direction
 100         VPM_X_LIMITED       =    7, ///< Drag only in X axis with limited size
 101         VPM_Y_LIMITED       =    8, ///< Drag only in Y axis with limited size
 102         VPM_RAILDIRS        = 0x40, ///< all rail directions
 103         VPM_SIGNALDIRS      = 0x80, ///< similar to VMP_RAILDIRS, but with different cursor
 104 };
 105 DECLARE_ENUM_AS_BIT_SET(ViewportPlaceMethod)
 106
 107 /**
 108  * Drag and drop selection process, or, what to do with an area of land when
 109  * you've selected it.
 110  */
 111 enum ViewportDragDropSelectionProcess {
 112         DDSP_DEMOLISH_AREA,        ///< Clear area
 113         DDSP_RAISE_AND_LEVEL_AREA, ///< Raise / level area
 114         DDSP_LOWER_AND_LEVEL_AREA, ///< Lower / level area
 115         DDSP_LEVEL_AREA,           ///< Level area
 116         DDSP_CREATE_DESERT,        ///< Fill area with desert
 117         DDSP_CREATE_ROCKS,         ///< Fill area with rocks
 118         DDSP_CREATE_WATER,         ///< Create a canal
 119         DDSP_CREATE_RIVER,         ///< Create rivers
 120         DDSP_PLANT_TREES,          ///< Plant trees
 121         DDSP_BUILD_BRIDGE,         ///< Bridge placement
 122         DDSP_BUILD_OBJECT,         ///< Build an object
 123
 124         /* Rail specific actions */
 125         DDSP_PLACE_RAIL,           ///< Rail placement
 126         DDSP_BUILD_SIGNALS,        ///< Signal placement
 127         DDSP_BUILD_STATION,        ///< Station placement
 128         DDSP_REMOVE_STATION,       ///< Station removal
 129         DDSP_CONVERT_RAIL,         ///< Rail conversion
 130
 131         /* Road specific actions */
 132         DDSP_PLACE_ROAD_X_DIR,     ///< Road placement (X axis)
 133         DDSP_PLACE_ROAD_Y_DIR,     ///< Road placement (Y axis)
 134         DDSP_PLACE_AUTOROAD,       ///< Road placement (auto)
 135         DDSP_BUILD_ROAD_WAYPOINT,  ///< Road stop placement (waypoint)
 136         DDSP_BUILD_BUSSTOP,        ///< Road stop placement (buses)
 137         DDSP_BUILD_TRUCKSTOP,      ///< Road stop placement (trucks)
 138         DDSP_REMOVE_ROAD_WAYPOINT, ///< Road stop removal (waypoint)
 139         DDSP_REMOVE_BUSSTOP,       ///< Road stop removal (buses)
 140         DDSP_REMOVE_TRUCKSTOP,     ///< Road stop removal (trucks)
 141         DDSP_CONVERT_ROAD,         ///< Road conversion
 142 };
 143
 144
 145 /**
 146  * Target of the viewport scrolling GS method
 147  */
 148 enum ViewportScrollTarget : uint8_t {
 149         VST_EVERYONE, ///< All players
 150         VST_COMPANY,  ///< All players in specific company
 151         VST_CLIENT,   ///< Single player
 152 };
 153
 154 #endif /* VIEWPORT_TYPE_H */