Add pinned quick controls, graph descriptions, and vibration test buttons

FFB graph settings can now be pinned as quick controls shown above the editor block, graphs carry a description (localized for the built-ins), and a new show-node-graph switch replaces the old simple mode. Also: test buttons for all vibration nodes (enabled on track only), a draggable column split for the editor block, role colors for source/generator/output nodes, and darker preview status tints.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: mherbold

MarvinsAIRARefactored/Components/RacingWheel.cs

@@ -623,19 +623,19 @@ public void ProcessTelemetryFrame()
 
 			if ( engine.CurbProtectionActive )
 			{
-				clearColor = 0xFFFFFF00;
+				clearColor = 0xFF606000;
 			}
 
 			if ( engine.CrashProtectionActive )
 			{
-				clearColor = 0xFFFF5B2E;
+				clearColor = 0xFF40260C;
 			}
 
 			for ( var i = 0; i < Simulator.SamplesPerFrame360Hz; i++ )
 			{
 				if ( MathF.Abs( _burstOutputTorque[ i ] ) >= 0.99f )
 				{
-					clearColor = 0xFFFF0000;
+					clearColor = 0xFF600000;
 
 					break;
 				}
@@ -1244,17 +1244,17 @@ public void Tick( App app )
 
 						if ( _previewEngine.CurbProtectionActive )
 						{
-							clearColor = 0xFFFFFF00;
+							clearColor = 0xFF606000;
 						}
 
 						if ( _previewEngine.CrashProtectionActive )
 						{
-							clearColor = 0xFFFF5B2E;
+							clearColor = 0xFF40260C;
 						}
 
 						if ( previewIsOutput && ( MathF.Abs( outputValue ) >= 0.99f ) )
 						{
-							clearColor = 0xFFFF0000;
+							clearColor = 0xFF600000;
 						}
 
 						_algorithmPreviewGraphBase.SetClearColor( clearColor );
@@ -1279,6 +1279,11 @@ public void Tick( App app )
 			_racingWheelPage.Record_MairaMappableButton.Disabled = !app.Simulator.IsOnTrack;
 			_racingWheelPage.Record_MairaMappableButton.Blink = app.RecordingManager.IsRecording;
 
+			// generator (vibration) tests shake the physical wheel, which needs live FFB — gate their test
+			// buttons on the same on-track state as the record button
+
+			DataContext.DataContext.Instance.RacingWheelGraphViewModel.NotifyIsOnTrackChanged( app.Simulator.IsOnTrack );
+
 			// suspend racing wheel force feedback if iracing ffb is enabled or we are calibrating
 
 			SuspendForceFeedback = !app.Simulator.IsConnected || ( app.Simulator.SteeringFFBEnabled && !settings.RacingWheelAlwaysEnableFFB ) || app.SteeringEffects.IsCalibrating;

MarvinsAIRARefactored/Controls/FFBGraphEditor.xaml

@@ -136,6 +136,19 @@
                                                         <Setter Property="BorderBrush"
                                                                 Value="{DynamicResource Brush.Accent.BlueDark}" />
                                                     </DataTrigger>
+                                                    <!-- telemetry source nodes green, the output node purple — same tone
+												     family as the generator blue, so no role shouts over the others;
+												     ordinary chain modules keep the gray default -->
+                                                    <DataTrigger Binding="{Binding IsSource}"
+                                                                 Value="True">
+                                                        <Setter Property="BorderBrush"
+                                                                Value="{DynamicResource Brush.Accent.GreenDark}" />
+                                                    </DataTrigger>
+                                                    <DataTrigger Binding="{Binding IsOutput}"
+                                                                 Value="True">
+                                                        <Setter Property="BorderBrush"
+                                                                Value="{DynamicResource Brush.Accent.PurpleDark}" />
+                                                    </DataTrigger>
                                                     <!-- preview lock (right-click) renders below selection: when the same
 											     node is both, the selection accent wins (last matching trigger) -->
                                                     <DataTrigger Binding="{Binding IsPreviewLocked}"

MarvinsAIRARefactored/Converters/FractionToStarGridLengthConverter.cs

@@ -0,0 +1,28 @@
+using System.Globalization;
+using System.Windows;
+using System.Windows.Data;
+
+namespace MarvinsAIRARefactored.Converters;
+
+// Turns a 0..1 split fraction into a star GridLength so two grid columns can share a settings-driven ratio;
+// pass ConverterParameter=Complement to get the other side's share (1 - fraction).
+[ValueConversion( typeof( double ), typeof( GridLength ) )]
+public class FractionToStarGridLengthConverter : IValueConverter
+{
+	public object Convert( object value, Type targetType, object parameter, CultureInfo culture )
+	{
+		var fraction = (double) value;
+
+		if ( parameter is string text && ( text == "Complement" ) )
+		{
+			fraction = 1.0 - fraction;
+		}
+
+		return new GridLength( fraction, GridUnitType.Star );
+	}
+
+	public object ConvertBack( object value, Type targetType, object parameter, CultureInfo culture )
+	{
+		return DependencyProperty.UnsetValue;
+	}
+}

MarvinsAIRARefactored/DataContext/Settings.cs

@@ -643,6 +643,24 @@ public void ApplyImportedGraphValues( string existingGraphName, FFBGraph importe
 			WriteImportedModuleValues( imported, localGraph.GraphId, moduleIdMap, FindContextSettings( baselineContext ).RacingWheelFFBGraphModuleValues );
 		}
 
+		// The description and pinned quick controls are part of the author's intent for the graph, so an update
+		// adopts them too (pins are remapped onto the local nodes the same way the values were).
+		localGraph.Description = imported.Description;
+
+		foreach ( var importedModule in imported.Modules )
+		{
+			if ( moduleIdMap.TryGetValue( importedModule.ModuleId, out var localModuleId ) )
+			{
+				var localModule = localGraph.Modules.Find( module => module.ModuleId == localModuleId );
+
+				if ( localModule != null )
+				{
+					localModule.PinnedSettings.Clear();
+					localModule.PinnedSettings.AddRange( importedModule.PinnedSettings );
+				}
+			}
+		}
+
 		// Reflect the change live only when it lands on the context we are currently driving. Selecting the matched
 		// graph (when it isn't already selected) loads this context's values and rebuilds the engine + editor; if it
 		// is already selected, reload this context's values directly. A baseline-only write while a different context
@@ -661,6 +679,12 @@ public void ApplyImportedGraphValues( string existingGraphName, FFBGraph importe
 			}
 		}
 
+		// the adopted description/pins reach the editor VM when this graph is (or becomes) the selected one
+		if ( RacingWheelSelectedFFBGraphName == existingGraphName )
+		{
+			RebuildGraphEditorViewModel();
+		}
+
 		App.Instance!.SettingsFile.QueueForSerialization = true;
 	}
 
@@ -1824,6 +1848,26 @@ public bool RacingWheelFFBGraphSnapToGrid
 		}
 	}
 
+	// Shows/hides the top row of the editor block (the node graph and the module settings column). Off by
+	// default: basic users see just the description, the pinned quick controls, and the preview row — advanced
+	// users flip this on for full control of the node graph. Global (not per graph).
+	private bool _racingWheelShowNodeGraph = false;
+
+	public bool RacingWheelShowNodeGraph
+	{
+		get => _racingWheelShowNodeGraph;
+
+		set
+		{
+			if ( value != _racingWheelShowNodeGraph )
+			{
+				_racingWheelShowNodeGraph = value;
+
+				OnPropertyChanged();
+			}
+		}
+	}
+
 	// Node editor viewport height in pixels (global — resized by dragging the grab handle on the node graph /
 	// preview graph seam; the preview graph's height never changes). Clamped here so a hand-edited settings
 	// file cannot collapse or blow up the layout.
@@ -1849,6 +1893,32 @@ public double RacingWheelFFBGraphEditorHeight
 		}
 	}
 
+	// Fraction of the FFB graph block's width given to the left (node graph / preview) column, the rest going to
+	// the module settings / track map column — resized by dragging the grab handle on the vertical seam. Stored
+	// as a fraction rather than pixels so the split survives window resizes. Clamped here so a hand-edited
+	// settings file cannot collapse either column.
+	public const double MinFFBGraphEditorSplit = 0.4;
+	public const double MaxFFBGraphEditorSplit = 0.85;
+
+	private double _racingWheelFFBGraphEditorSplit = 2.0 / 3.0;
+
+	public double RacingWheelFFBGraphEditorSplit
+	{
+		get => _racingWheelFFBGraphEditorSplit;
+
+		set
+		{
+			value = Math.Clamp( value, MinFFBGraphEditorSplit, MaxFFBGraphEditorSplit );
+
+			if ( value != _racingWheelFFBGraphEditorSplit )
+			{
+				_racingWheelFFBGraphEditorSplit = value;
+
+				OnPropertyChanged();
+			}
+		}
+	}
+
 	// Content hashes of the built-in graph files last synced into this settings file, keyed "{GraphType}/{Name}".
 	// When a shipped file's hash differs, the stored built-in graph is refreshed at launch (see
 	// EnsureBuiltInFFBGraphsInitialized) — so built-in graphs updated during development reach users automatically.
@@ -4165,31 +4235,6 @@ public bool RacingWheelAlwaysEnableFFB
 
 	#endregion
 
-	#region Racing wheel - Simple mode
-
-	private bool _racingWheelSimpleModeEnabled = false;
-
-	public bool RacingWheelSimpleModeEnabled
-	{
-		get => _racingWheelSimpleModeEnabled;
-
-		set
-		{
-			if ( value != _racingWheelSimpleModeEnabled )
-			{
-				_racingWheelSimpleModeEnabled = value;
-
-				OnPropertyChanged();
-			}
-
-			var app = App.Instance!;
-
-			app.MainWindow.UpdateRacingWheelSimpleMode();
-		}
-	}
-
-	#endregion
-
 	#region Steering effects - Understeer enabled
 
 	private bool _steeringEffectsUndersteerEnabled = false;

MarvinsAIRARefactored/FFB/FFBGraph.cs

@@ -16,6 +16,7 @@ public class FFBModuleData
 	public string InputAModuleId { get; set; } = FFBGraph.Source360ModuleId;
 	public string InputBModuleId { get; set; } = FFBGraph.Source360ModuleId;
 	public SerializableDictionary<string, float> SettingValues { get; set; } = [];  // bools 0/1, choices as index
+	public List<string> PinnedSettings { get; set; } = [];              // setting keys surfaced as the graph's quick controls above the editor
 	public float NodeX { get; set; } = 0f;                              // node editor canvas position; 0,0 everywhere = needs auto-layout
 	public float NodeY { get; set; } = 0f;
 
@@ -43,6 +44,8 @@ public FFBModuleData Clone()
 			clone.SettingValues[ pair.Key ] = pair.Value;
 		}
 
+		clone.PinnedSettings.AddRange( PinnedSettings );
+
 		return clone;
 	}
 }
@@ -74,6 +77,12 @@ public class FFBGraph
 	// out of another's. Empty on legacy graphs/files - assigned lazily on load/import.
 	public string GraphId { get; set; } = "";
 	public string Name { get; set; } = "";
+
+	// Free-text description shown below the graph selector (rides export/import). For BUILT-IN graphs the UI
+	// resolves a localization key derived from the graph name first (so shipped descriptions arrive translated)
+	// and only falls back to this stored text — see FFBGraphViewModel.GraphDescription.
+	public string Description { get; set; } = "";
+
 	public bool IsBuiltIn { get; set; } = false;
 	public List<FFBModuleData> Modules { get; set; } = [];   // dependency order, last = Output
 
@@ -136,7 +145,7 @@ public static FFBGraph CreateEmpty( string name, bool isBuiltIn = false )
 	/// <summary>Deep copy of the whole graph (used to seed a new graph from an existing one).</summary>
 	public FFBGraph Clone()
 	{
-		var clone = new FFBGraph { GraphId = GraphId, Name = Name, IsBuiltIn = IsBuiltIn };
+		var clone = new FFBGraph { GraphId = GraphId, Name = Name, Description = Description, IsBuiltIn = IsBuiltIn };
 
 		foreach ( var module in Modules )
 		{