Add node for toggling lights.

Author: freezy

Editor/Descriptors/SetLampEnabledUnitDescriptor.cs

@@ -0,0 +1,53 @@
+// Visual Pinball Engine
+// Copyright (C) 2022 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(SetLampEnabledUnit))]
+	public class SetLampEnabledUnitDescriptor : UnitDescriptor<SetLampEnabledUnit>
+	{
+		public SetLampEnabledUnitDescriptor(SetLampEnabledUnit target) : base(target)
+		{
+		}
+
+		protected override string DefinedSummary()
+		{
+			return "This node turns a lamp defined by its mapped ID on or off.";
+		}
+
+		protected override EditorTexture DefinedIcon() => EditorTexture.Single(Unity.Editor.Icons.Light(IconSize.Large, IconColor.Orange));
+
+		protected override void DefinedPort(IUnitPort port, UnitPortDescription desc)
+		{
+			base.DefinedPort(port, desc);
+
+			switch (port.key) {
+				case nameof(SetLampEnabledUnit.Id):
+					desc.summary = "The ID of the lamp to toggle.";
+					break;
+				case nameof(SetLampEnabledUnit.IsEnabled):
+					desc.summary = "Whether to turn on or off.";
+					break;
+			}
+		}
+	}
+}

Editor/Descriptors/SetLampEnabledUnitDescriptor.cs.meta

@@ -0,0 +1,56 @@
+// Visual Pinball Engine
+// Copyright (C) 2022 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 System;
+using System.Collections.Generic;
+using System.Linq;
+using Unity.VisualScripting;
+
+namespace VisualPinball.Unity.VisualScripting.Editor
+{
+	[Widget(typeof(SetLampEnabledUnit))]
+	public sealed class SetLampEnabledUnitWidget : GleUnitWidget<SetLampEnabledUnit>
+	{
+		private VariableNameInspector _lampIdInspector;
+		private readonly Func<Metadata, VariableNameInspector> _setLampInspectorConstructor;
+
+		public SetLampEnabledUnitWidget(FlowCanvas canvas, SetLampEnabledUnit unit) : base(canvas, unit)
+		{
+			_setLampInspectorConstructor = meta => new VariableNameInspector(meta, GetNameSuggestions);
+		}
+
+		public override Inspector GetPortInspector(IUnitPort port, Metadata meta)
+		{
+			if (port == unit.Id) {
+				InspectorProvider.instance.Renew(ref _lampIdInspector, meta, _setLampInspectorConstructor);
+				return _lampIdInspector;
+			}
+
+			return base.GetPortInspector(port, meta);
+		}
+
+		private IEnumerable<string> GetNameSuggestions()
+		{
+			if (!GameObjectAvailable) {
+				return new List<string>();
+			}
+			var gle = Gle;
+			return gle == null ? new List<string>() : gle.AvailableLamps.Select(lamp => lamp.Id).ToList();
+		}
+	}
+}

Editor/Widgets/SetLampEnabledUnitWidget.cs

@@ -0,0 +1,71 @@
+// Visual Pinball Engine
+// Copyright (C) 2022 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
+{
+	[UnitShortTitle("Set Lamp")]
+	[UnitTitle("Set Lamp (ID, on/off)")]
+	[UnitSurtitle("Gamelogic Engine")]
+	[UnitCategory("Visual Pinball")]
+	public class SetLampEnabledUnit : GleUnit
+	{
+		[DoNotSerialize]
+		[PortLabelHidden]
+		public ControlInput InputTrigger;
+
+		[DoNotSerialize]
+		[PortLabelHidden]
+		public ControlOutput OutputTrigger;
+
+		[DoNotSerialize]
+		[PortLabel("Lamp ID")]
+		public ValueInput Id { get; private set; }
+
+		[DoNotSerialize]
+		[PortLabel("Is Enabled")]
+		public ValueInput IsEnabled { get; private set; }
+
+		protected override void Definition()
+		{
+			InputTrigger = ControlInput(nameof(InputTrigger), Process);
+			OutputTrigger = ControlOutput(nameof(OutputTrigger));
+
+			Id = ValueInput(nameof(Id), string.Empty);
+			IsEnabled = ValueInput(nameof(IsEnabled), false);
+
+			Requirement(Id, InputTrigger);
+			Succession(InputTrigger, OutputTrigger);
+		}
+
+		private ControlOutput Process(Flow flow)
+		{
+			if (!AssertGle(flow)) {
+				Debug.LogError("Cannot find GLE.");
+				return OutputTrigger;
+			}
+
+			var id = flow.GetValue<string>(Id);
+			var isEnabled = flow.GetValue<bool>(IsEnabled);
+
+			Gle.SetLamp(id, isEnabled ? 255f : 0f);
+
+			return OutputTrigger;
+		}
+	}
+}

Editor/Widgets/SetLampEnabledUnitWidget.cs.meta

@@ -20,7 +20,7 @@
 namespace VisualPinball.Unity.VisualScripting
 {
 	[UnitShortTitle("Set Lamp")]
-	[UnitTitle("Set Lamp (ID, Value)")]
+	[UnitTitle("Set Lamp (ID, Intensity)")]
 	[UnitSurtitle("Gamelogic Engine")]
 	[UnitCategory("Visual Pinball")]
 	public class SetLampUnit : GleUnit