V1.1 : Added parallel / antiparallel modes

Author: gotmachine

FlyByWireSASMode.cs

@@ -86,7 +86,7 @@
   <ItemGroup>
     <Compile Include="FlyByWireSASMode.cs" />
     <Compile Include="Properties\AssemblyInfo.cs" />
-    <Compile Include="VesselFlyByWireState.cs" />
+    <Compile Include="VesselState.cs" />
   </ItemGroup>
   <ItemGroup>
     <None Include="packages.config" />

FlyByWireSASMode.csproj

@@ -2,7 +2,7 @@
   "NAME": "FlyByWireSASMode",
   "URL": "https://raw.githubusercontent.com/gotmachine/FlyByWireSASMode/master/GameData/FlyByWireSASMode/FlyByWireSASMode.version",
   "DOWNLOAD": "https://github.com/gotmachine/FlyByWireSASMode/releases",
-  "VERSION": {"MAJOR": 1, "MINOR": 0, "PATCH": 0, "BUILD": 0},
+  "VERSION": {"MAJOR": 1, "MINOR": 1, "PATCH": 0, "BUILD": 0},
   "KSP_VERSION": {"MAJOR": 1, "MINOR": 12, "PATCH": 5},
   "KSP_VERSION_MIN": {"MAJOR": 1, "MINOR": 12, "PATCH": 3},
   "KSP_VERSION_MAX": {"MAJOR": 1, "MINOR": 12, "PATCH": 5}

GameData/FlyByWireSASMode/FlyByWireSASMode.version

@@ -1,4 +1,4 @@
-using System.Reflection;
+using System.Reflection;
 using System.Runtime.CompilerServices;
 using System.Runtime.InteropServices;
 
@@ -33,4 +33,4 @@
 // by using the '*' as shown below:
 // [assembly: AssemblyVersion("1.0.*")]
 [assembly: AssemblyVersion("1.0.0.0")]
-[assembly: AssemblyFileVersion("1.0.0.0")]
+[assembly: AssemblyFileVersion("1.1.0.0")]

GameData/FlyByWireSASMode/ParallelNegMarker.png

@@ -4,10 +4,12 @@ This Kerbal Space Program plugin adds a new **fly by wire** SAS mode.
 
 When enabled, pitch and yaw inputs don't control the vessel directly anymore, but instead control the position of a custom navball direction marker that the SAS will follow automatically.
 
+Additionally, this also add two target related modes, **parallel** and **antiparallel**, especially useful for docking.
+
 ![Navball](https://raw.githubusercontent.com/gotmachine/FlyByWireSASMode/master/NavballScreenshot.png)
 
 
-The **fly by wire** mode is available for pilots and probe cores at the same SAS level as the target and maneuver modes, but this is configurable in the ```settings.cfg``` file.
+These addtional modes are available for pilots and probe cores at the same SAS level as the target and maneuver modes, but this is configurable in the ```settings.cfg``` file (doing that with a ModuleManager patch is recommended).
 
 ### Download and installation
 
@@ -27,5 +29,8 @@ MIT
 
 ### Changelog
 
+#### 1.1.0 - 28/04/2024
+- Added parallel / antiparallel modes
+
 #### 1.0.0 - 27/04/2024
 - Inital release

GameData/FlyByWireSASMode/ParallelPosMarker.png

@@ -0,0 +1,96 @@
+using UnityEngine;
+
+namespace FlyByWireSASMode
+{
+    internal enum CustomSASMode
+    {
+        Stock,
+        FlyByWire,
+        ParallelPos,
+        ParallelNeg
+    }
+
+    internal class VesselState
+    {
+        public Vessel vessel;
+        public CustomSASMode sasMode;
+        public Vector3 direction;
+
+        public VesselState(Vessel vessel, CustomSASMode sasMode)
+        {
+            this.vessel = vessel;
+            this.sasMode = sasMode;
+            vessel.OnPreAutopilotUpdate += OnPreAutopilotUpdate;
+            ResetDirection();
+        }
+
+        public void ResetDirection()
+        {
+            direction = vessel.GetTransform().up;
+        }
+
+        public void Destroy()
+        {
+            vessel.OnPreAutopilotUpdate -= OnPreAutopilotUpdate;
+        }
+
+        private void OnPreAutopilotUpdate(FlightCtrlState st)
+        {
+            // continuously set mode to stability assist so we know which button to disable
+            vessel.Autopilot.mode = VesselAutopilot.AutopilotMode.StabilityAssist;
+
+            if (sasMode == CustomSASMode.FlyByWire)
+            {
+                // clear manual input
+                st.pitch = 0f;
+                st.yaw = 0f;
+
+                if (FlightGlobals.ActiveVessel == vessel)
+                {
+                    // get input manually so this can work when under partial control
+                    float pitch, yaw;
+                    if (GameSettings.PITCH_DOWN.GetKey())
+                        pitch = -1f;
+                    else if (GameSettings.PITCH_UP.GetKey())
+                        pitch = 1f;
+                    else
+                        pitch = 0f;
+
+                    if (GameSettings.YAW_LEFT.GetKey())
+                        yaw = -1f;
+                    else if (GameSettings.YAW_RIGHT.GetKey())
+                        yaw = 1f;
+                    else
+                        yaw = 0f;
+
+                    // increase speed when further away from control direction
+                    float speed = Vector3.Dot(vessel.GetTransform().up, direction) - 1.2f;
+
+                    // transform pitch/yaw input into a X/Y translation on the navball
+                    Quaternion navballAttitudeGymbal = FlyByWireSASMode.instance.navBall.attitudeGymbal;
+                    direction =
+                        navballAttitudeGymbal.Inverse()
+                        * Quaternion.Euler(pitch * -speed, yaw * -speed, 0f)
+                        * navballAttitudeGymbal
+                        * direction;
+
+                    direction.Normalize();
+                }
+            }
+            else
+            {
+                Transform targetTransform = vessel.targetObject?.GetTransform();
+                if (targetTransform == null)
+                    return;
+
+                direction = vessel.targetObject is Vessel ? targetTransform.up : vessel.targetObject.GetFwdVector();
+                if (sasMode == CustomSASMode.ParallelNeg)
+                    direction *= -1f;
+            }
+
+            // set SAS to follow requested direction
+            vessel.Autopilot.SAS.lockedMode = false;
+            vessel.Autopilot.SAS.SetTargetOrientation(direction, false);
+        }
+    }
+}