Add ball creation unit.

Author: freezy

Editor/Descriptors/CreateBallUnitDescriptor.cs

@@ -0,0 +1,56 @@
+// Visual Pinball Engine
+// Copyright (C) 2021 freezy and VPE Team
+//
+// This program 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, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program 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. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+// ReSharper disable UnusedType.Global
+
+using Unity.VisualScripting;
+using VisualPinball.Unity.Editor;
+using IconSize = VisualPinball.Unity.Editor.IconSize;
+
+namespace VisualPinball.Unity.VisualScripting.Editor
+{
+	[Descriptor(typeof(CreateBallUnit))]
+	public class CreateBallUnitDescriptor : UnitDescriptor<CreateBallUnit>
+	{
+		public CreateBallUnitDescriptor(CreateBallUnit target) : base(target)
+		{
+		}
+
+		protected override string DefinedSummary()
+		{
+			return "This node spawns a new ball at a given position.";
+		}
+
+		protected override EditorTexture DefinedIcon() => EditorTexture.Single(Unity.Editor.Icons.BallRoller(IconSize.Large, IconColor.Orange));
+
+		protected override void DefinedPort(IUnitPort port, UnitPortDescription desc)
+		{
+			base.DefinedPort(port, desc);
+
+			switch (port.key) {
+				case nameof(CreateBallUnit.Position):
+					desc.summary = "The position in playfield space where the ball should be created.";
+					break;
+				case nameof(CreateBallUnit.KickAngle):
+					desc.summary = "The angle in degrees at which the ball is accelerated at the given position. 0 is straight up, then it goes clock-wise, 180 being straight down.";
+					break;
+				case nameof(CreateBallUnit.KickForce):
+					desc.summary = "The force with which the ball is accelerated at the given position.";
+					break;
+			}
+		}
+	}
+}

Editor/Descriptors/CreateBallUnitDescriptor.cs.meta

@@ -52,11 +52,13 @@ public class VisualScriptingGamelogicEngine : MonoBehaviour, IGamelogicEngine
 		public event EventHandler<CoilEventArgs> OnCoilChanged;
 		public event EventHandler<SwitchEventArgs2> OnSwitchChanged;
 
+		[NonSerialized] public BallManager BallManager;
 		[NonSerialized] private Player _player;
 
 		public void OnInit(Player player, TableApi tableApi, BallManager ballManager)
 		{
 			_player = player;
+			BallManager = ballManager;
 			EventBus.Trigger(VisualScriptingEventNames.PlayerStartedEvent, EventArgs.Empty);
 		}
 

Runtime/Gamelogic/VisualScriptingGamelogicEngine.cs

@@ -0,0 +1,77 @@
+// Visual Pinball Engine
+// Copyright (C) 2021 freezy and VPE Team
+//
+// This program 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, either version 3 of the License, or
+// (at your option) any later version.
+//
+// This program 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. See the
+// GNU General Public License for more details.
+//
+// You should have received a copy of the GNU General Public License
+// along with this program. If not, see <https://www.gnu.org/licenses/>.
+
+using Unity.VisualScripting;
+using UnityEngine;
+
+namespace VisualPinball.Unity.VisualScripting
+{
+
+	[UnitTitle("Create Ball")]
+	[UnitCategory("Events\\Visual Pinball")]
+	public class CreateBallUnit : GleUnit
+	{
+		[DoNotSerialize]
+		[PortLabelHidden]
+		public ControlInput InputTrigger;
+
+		[DoNotSerialize]
+		[PortLabelHidden]
+		public ControlOutput OutputTrigger;
+
+		[DoNotSerialize]
+		[PortLabel("Position")]
+		public ValueInput Position { get; private set; }
+
+		[DoNotSerialize]
+		[PortLabel("Kick Angle")]
+		public ValueInput KickAngle { get; private set; }
+
+		[DoNotSerialize]
+		[PortLabel("Kick Force")]
+		public ValueInput KickForce { get; private set; }
+
+		protected override void Definition()
+		{
+			InputTrigger = ControlInput(nameof(InputTrigger), Process);
+			OutputTrigger = ControlOutput(nameof(OutputTrigger));
+
+			Position = ValueInput<Vector3>(nameof(Position), Vector3.zero);
+			KickAngle = ValueInput<float>(nameof(KickAngle), 0);
+			KickForce = ValueInput<float>(nameof(KickForce), 0);
+
+			Requirement(Position, InputTrigger);
+			Succession(InputTrigger, OutputTrigger);
+		}
+
+		private ControlOutput Process(Flow flow)
+		{
+			if (!AssertGle(flow)) {
+				Debug.LogError("Cannot find GLE.");
+				return OutputTrigger;
+			}
+
+			if (Gle is VisualScriptingGamelogicEngine vsGle) {
+				var pos = flow.GetValue<Vector3>(Position);
+				var kickAngle = flow.GetValue<float>(KickAngle);
+				var kickForce = flow.GetValue<float>(KickForce);
+				vsGle.BallManager.CreateBall(new DebugBallCreator(pos.x, pos.y, pos.z, kickAngle, kickForce));
+			}
+
+			return OutputTrigger;
+		}
+	}
+}