Deploy activities for mods and future AI scripting

OpenRA.Mods.Common/Activities/DeployForGrantedCondition.cs

@@ -0,0 +1,69 @@
+#region Copyright & License Information
+/*
+ * Copyright 2007-2017 The OpenRA Developers (see AUTHORS)
+ * This file is part of OpenRA, which is free software. It is made
+ * available to you under the terms of the GNU General Public License
+ * as published by the Free Software Foundation, either version 3 of
+ * the License, or (at your option) any later version. For more
+ * information, see COPYING.
+ */
+#endregion
+
+using OpenRA.Activities;
+using OpenRA.Mods.Common.Traits;
+using OpenRA.Traits;
+
+namespace OpenRA.Mods.Common.Activities
+{
+	public class DeployForGrantedCondition : Activity
+	{
+		readonly GrantConditionOnDeploy deploy;
+		readonly int facing;
+		readonly bool canTurn;
+
+		public DeployForGrantedCondition(Actor self) : base()
+		{
+			canTurn = self.Info.HasTraitInfo<IFacingInfo>();
+			facing = self.Info.TraitInfo<GrantConditionOnDeployInfo>().Facing;
+			deploy = self.Trait<GrantConditionOnDeploy>();
+		}
+
+		protected override void OnFirstRun(Actor self)
+		{
+			// Turn to the required facing.
+			if (facing != -1 && canTurn)
+				QueueChild(new Turn(self, facing));
+		}
+
+		public override Activity Tick(Actor self)
+		{
+			// Do turn first, if needed.
+			if (ChildActivity != null)
+			{
+				ChildActivity = ActivityUtils.RunActivity(self, ChildActivity);
+				return this;
+			}
+
+			// Without this, turn for facing deploy angle will be canceled and immediately deploy!
+			if (IsCanceled)
+				return NextActivity;
+
+			if (IsInterruptible)
+			{
+				IsInterruptible = false; // must DEPLOY from now.
+				deploy.Deploy();
+				return this;
+			}
+
+			// Wait for deployment
+			if (deploy.DeployState == DeployState.Deploying)
+				return this;
+
+			// Failed or success, we are going to NextActivity.
+			// Deploy() at the first run would have put DeployState == Deploying so
+			// if we are back to DeployState.Undeployed, it means deploy failure.
+			// Parent activity will see the status and will take appropriate action.
+			return NextActivity;
+		}
+	}
+}