Mercurial > hg > openttd

changeset 17039:2290fc082967 draft

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
(svn r21776) -Codechange: Give a more appropriate name to the road connection function. -Document: Add doxygen comments to the function.
author terkhen <terkhen@openttd.org>
date Fri, 14 Jan 2011 11:55:40 +0000
parents ea7cb867020f
children e76eccb63739
files src/road_gui.cpp src/road_gui.h
diffstat 2 files changed, 10 insertions(+), 4 deletions(-) [+]
line wrap: on
line diff
--- a/src/road_gui.cpp
+++ b/src/road_gui.cpp
@@ -135,7 +135,12 @@
 	},
 };
 
-static void BuildRoadOutsideStation(TileIndex tile, DiagDirection direction)
+/**
+ * If required, connects a new structure to an existing road or tram by building the missing roadbit.
+ * @param tile Tile containing the structure to connect.
+ * @param direction Direction to check.
+ */
+void ConnectRoadToStructure(TileIndex tile, DiagDirection direction)
 {
 	tile += TileOffsByDiagDir(direction);
 	/* if there is a roadpiece just outside of the station entrance, build a connecting route */
@@ -153,7 +158,7 @@
 	DiagDirection dir = (DiagDirection)GB(p1, 0, 2);
 	SndPlayTileFx(SND_1F_SPLAT, tile);
 	if (!_settings_client.gui.persistent_buildingtools) ResetObjectToPlace();
-	BuildRoadOutsideStation(tile, dir);
+	ConnectRoadToStructure(tile, dir);
 }
 
 /**
@@ -179,9 +184,9 @@
 	if (!_settings_client.gui.persistent_buildingtools) ResetObjectToPlace();
 	TileArea roadstop_area(tile, GB(p1, 0, 8), GB(p1, 8, 8));
 	TILE_AREA_LOOP(cur_tile, roadstop_area) {
-		BuildRoadOutsideStation(cur_tile, dir);
+		ConnectRoadToStructure(cur_tile, dir);
 		/* For a drive-through road stop build connecting road for other entrance. */
-		if (HasBit(p2, 1)) BuildRoadOutsideStation(cur_tile, ReverseDiagDir(dir));
+		if (HasBit(p2, 1)) ConnectRoadToStructure(cur_tile, ReverseDiagDir(dir));
 	}
 }
 
--- a/src/road_gui.h
+++ b/src/road_gui.h
@@ -16,5 +16,6 @@
 
 struct Window *ShowBuildRoadToolbar(RoadType roadtype);
 struct Window *ShowBuildRoadScenToolbar();
+void ConnectRoadToStructure(TileIndex tile, DiagDirection direction);
 
 #endif /* ROAD_GUI_H */