TASK 3 milestone 1: webcam capture (MediaCapture CPU-first, CameraManager refcount, picker, clip/mirror, schema v2, tests)

Models/Source.cs

@@ -1,6 +1,7 @@
 using System.ComponentModel;
 using System.Runtime.CompilerServices;
 using System.Windows.Media;
+using System.Windows.Media.Imaging;
 using ytLive.Helpers;
 
 namespace ytLive.Models;
@@ -15,6 +16,12 @@ public enum SourceType
     TextOverlay
 }
 
+public enum ClipShape
+{
+    Traditional,
+    Round
+}
+
 public class Source : INotifyPropertyChanged
 {
     public event PropertyChangedEventHandler? PropertyChanged;
@@ -52,6 +59,54 @@ public class Source : INotifyPropertyChanged
     private string? _deviceId;
     public string? DeviceId { get => _deviceId; set => Set(ref _deviceId, value); }
 
+    // Webcam live preview: the shared WriteableBitmap owned by CameraManager.
+    private WriteableBitmap? _videoImageSource;
+    public WriteableBitmap? VideoImageSource
+    {
+        get => _videoImageSource;
+        set
+        {
+            if (Set(ref _videoImageSource, value))
+                Raise(nameof(DisplaySource));
+        }
+    }
+
+    private ClipShape _clipShape = ClipShape.Traditional;
+    public ClipShape ClipShape
+    {
+        get => _clipShape;
+        set
+        {
+            if (Set(ref _clipShape, value))
+                Raise(nameof(ShapeButtonText));
+        }
+    }
+
+    private bool _isMirrored;
+    public bool IsMirrored
+    {
+        get => _isMirrored;
+        set
+        {
+            if (Set(ref _isMirrored, value))
+            {
+                Raise(nameof(MirrorScale));
+                Raise(nameof(MirrorButtonText));
+            }
+        }
+    }
+
+    public double MirrorScale => IsMirrored ? -1 : 1;
+
+    /// <summary>Mirror toggle label (mirrored → "Unmirror").</summary>
+    public string MirrorButtonText => IsMirrored ? "Unmirror" : "Mirror";
+
+    /// <summary>Clip-shape toggle label (round → "Rect").</summary>
+    public string ShapeButtonText => ClipShape == ClipShape.Round ? "Rect" : "Round";
+
+    /// <summary>What the preview shows: static image for image/background, live frames for webcam.</summary>
+    public ImageSource? DisplaySource => Type == SourceType.Webcam ? _videoImageSource : _imageSource;
+
     // Image (asset stored in the layout database)
     private string? _assetId;
     private ImageSource? _imageSource;
@@ -65,6 +120,7 @@ public class Source : INotifyPropertyChanged
             {
                 _imageSource = ImageCache.Get(value ?? string.Empty);
                 Raise(nameof(ImageSource));
+                Raise(nameof(DisplaySource));
             }
         }
     }

Models/index.md

@@ -6,7 +6,7 @@ Plain data types. No logic beyond what a property can carry. See
 | File | Purpose |
 |------|---------|
 | `Scene.cs` | A scene: `Name`, `IsHidden`, `IsChatScene`, `IsEditing`, `Sources` collection |
-| `Source.cs` | A source: `SourceType` enum (Image/Webcam/Screen/Background/Text), `X`/`Y`/`Width`/`Height`, `Opacity`, `IsEnabled`, `ImageSource`, asset identity |
+| `Source.cs` | A source: `SourceType` enum (Image/Webcam/Screen/Background/Text), `X`/`Y`/`Width`/`Height`, `Opacity`, `IsEnabled`, `ImageSource` (static) / `VideoImageSource` (webcam live frames), `DisplaySource` (whichever the preview shows), `ClipShape` enum (Traditional/Round), `IsMirrored` + `MirrorScale`, `MirrorButtonText`/`ShapeButtonText` toggle labels, asset identity, webcam `DeviceId` |
 | `QualityOption.cs` | Resolution tier record `(Display, Fps, Bitrate, Width, Height)`; `Label` formats as `1080p60 (8Mbps)` — drives the bottom-bar dropdown and the output-rect math |
 | `StreamConfig.cs` | `StreamConfig` (note: `TargetBitrate`/`Resolution` defaults are stale — not yet wired to the dropdown), `StreamHealth` (bitrate/FPS/dropped/duration), `StreamStatus` enum |
 | `YouTube.cs` | `YouTubeChannel` and `ChatMessage` (chat feed) |