diff options
Diffstat (limited to 'src/window_gui.h')
-rw-r--r-- | src/window_gui.h | 16 |
1 files changed, 10 insertions, 6 deletions
diff --git a/src/window_gui.h b/src/window_gui.h index f44efbcc2..ff806d1f1 100644 --- a/src/window_gui.h +++ b/src/window_gui.h @@ -189,14 +189,18 @@ enum SortButtonState { }; /** - * Data structure for a window viewport + * Data structure for a window viewport. + * A viewport is either following a vehicle (its id in then in #follow_vehicle), or it aims to display a specific + * location #dest_scrollpos_x, #dest_scrollpos_y (#follow_vehicle is then #INVALID_VEHICLE). + * The actual location being shown is #scrollpos_x, #scrollpos_y. + * @see InitializeViewport(), UpdateViewportPosition(). */ struct ViewportData : ViewPort { - VehicleID follow_vehicle; - int32 scrollpos_x; - int32 scrollpos_y; - int32 dest_scrollpos_x; - int32 dest_scrollpos_y; + VehicleID follow_vehicle; ///< VehicleID to follow if following a vehicle, #INVALID_VEHICLE otherwise. + int32 scrollpos_x; ///< Currently shown x coordinate (virtual screen coordinate of topleft corner of the viewport). + int32 scrollpos_y; ///< Currently shown y coordinate (virtual screen coordinate of topleft corner of the viewport). + int32 dest_scrollpos_x; ///< Current destination x coordinate to display (virtual screen coordinate of topleft corner of the viewport). + int32 dest_scrollpos_y; ///< Current destination y coordinate to display (virtual screen coordinate of topleft corner of the viewport). }; /** |