chore!: remove "SetAsProgram()"

Author: Segergren

README.md

@@ -27,7 +27,8 @@ Console.WriteLine($"OBS {Obs.Version} initialized");
 using var scene = Obs.Scenes.Create("My Scene");
 using var monitor = MonitorCapture.FromPrimary();
 scene.AddSource(monitor);
-scene.SetAsProgram();
+Obs.SetOutputSource(scene);
+// Obs.SetOutputSource(1, scene);   // ...or assign to a specific channel (0 = program output; 1-63 hold additional global sources)
 
 // Set up and start recording
 using var recording = new RecordingOutput("My Recording")

samples/ObsKit.NET.Sample.Recording/Program.cs

@@ -61,7 +61,7 @@
 // Create a scene with monitor capture
 using var scene = Obs.Scenes.Create("Recording Scene");
 scene.AddSource(monitorSource);
-scene.SetAsProgram(); // Set as the output source for recording
+Obs.SetOutputSource(scene); // program output
 
 Console.WriteLine($"Scene created with {scene.ItemCount} source(s)");
 

samples/ObsKit.NET.Sample.ReplayBuffer/Program.cs

@@ -47,7 +47,7 @@
 using var scene = Obs.Scenes.Create("Replay Scene");
 using var monitor = MonitorCapture.FromPrimary();
 scene.AddSource(monitor);
-scene.SetAsProgram(); // Set as the output source
+Obs.SetOutputSource(scene); // program output
 
 Console.WriteLine($"Scene created with {scene.ItemCount} source(s)");
 

samples/ObsKit.NET.Sample.Streaming/Program.cs

@@ -50,7 +50,7 @@
 scene.AddSource(monitorSource);
 scene.AddSource(audioInput);
 scene.AddSource(audioOutput);
-scene.SetAsProgram();
+Obs.SetOutputSource(scene);
 
 Console.WriteLine($"Scene created with {scene.ItemCount} source(s)\n");
 

samples/ObsKit.NET.Sample.Webcam/Program.cs

@@ -67,7 +67,7 @@
 // Build a scene with the webcam.
 using var scene = Obs.Scenes.Create("Webcam Scene");
 scene.AddSource(webcam);
-scene.SetAsProgram();
+Obs.SetOutputSource(scene);
 
 Console.WriteLine($"Scene has {scene.ItemCount} source(s); canvas {canvasW}x{canvasH}\n");
 

src/ObsKit.NET/Obs.cs

@@ -251,6 +251,39 @@ public static void SetOutputSource(uint channel, Source? source)
         ObsCore.obs_set_output_source(channel, handle);
     }
 
+    /// <summary>
+    /// Sets a scene as an output channel's source. Channel 0 is the program output (what
+    /// gets recorded/streamed). Pass null to clear the channel.
+    /// </summary>
+    /// <param name="channel">The output channel (0-63).</param>
+    /// <param name="scene">The scene to assign, or null to clear the channel.</param>
+    public static void SetOutputSource(uint channel, Scene? scene)
+    {
+        ThrowIfNotInitialized();
+
+        lock (_lock)
+        {
+            // Drop any plain-source tracking for this channel; scene cleanup is tracked on the scene.
+            _channelSources.Remove(channel);
+        }
+
+        if (scene != null)
+            scene.AssignToChannel(channel);
+        else
+            ObsCore.obs_set_output_source(channel, ObsSourceHandle.Null);
+    }
+
+    /// <summary>
+    /// Sets a scene as the program output (channel 0) — what gets recorded and streamed.
+    /// Shorthand for <see cref="SetOutputSource(uint, Scene?)"/> with channel 0.
+    /// </summary>
+    /// <param name="scene">The scene to make the program output.</param>
+    public static void SetOutputSource(Scene scene)
+    {
+        ArgumentNullException.ThrowIfNull(scene);
+        SetOutputSource(0, scene);
+    }
+
     /// <summary>
     /// Clears a source from an output channel.
     /// </summary>

src/ObsKit.NET/Scenes/Canvas.cs

@@ -156,7 +156,7 @@ public void MoveScene(Scene scene)
 
     /// <summary>
     /// Sets the scene rendered on this canvas (channel 0), like
-    /// <c>Scene.SetAsProgram</c> does for the main canvas.
+    /// <c>Obs.SetOutputSource</c> does for the main canvas.
     /// </summary>
     /// <param name="scene">The scene to render.</param>
     /// <param name="channel">The canvas channel (0-63).</param>

src/ObsKit.NET/Scenes/Scene.cs

@@ -347,15 +347,13 @@ public SceneItem this[int index]
     #endregion
 
     /// <summary>
-    /// Sets this scene as the program output (what gets recorded/streamed).
+    /// Assigns this scene's source to an output channel and records the channel so it is
+    /// cleared on disposal. Invoked by <see cref="Obs.SetOutputSource(uint, Scene?)"/>.
     /// </summary>
-    /// <param name="channel">Output channel (0 = main, 1-5 = aux).</param>
-    public void SetAsProgram(uint channel = 0)
+    internal void AssignToChannel(uint channel)
     {
         var sourceHandle = ObsScene.obs_scene_get_source(Handle);
         ObsCore.obs_set_output_source(channel, sourceHandle);
-
-        // Track the channel so we can clear it on disposal
         _assignedChannel = channel;
     }
 

src/ObsKit.NET/Sources/Transition.cs

@@ -10,7 +10,7 @@ namespace ObsKit.NET.Sources;
 ///
 /// <para>A transition blends between two sub-sources. To use one as the program
 /// transition, assign it to an output channel with
-/// <see cref="ObsKit.NET.Obs.SetOutputSource"/>, seed the starting scene with
+/// <see cref="ObsKit.NET.Obs.SetOutputSource(uint, Source?)"/>, seed the starting scene with
 /// <see cref="Set(Scenes.Scene?)"/>, then animate to a new scene with
 /// <see cref="Start(Scenes.Scene, System.TimeSpan, Native.Types.ObsTransitionMode)"/>.</para>
 /// </summary>