Support setting/getting control values

Author: sebgod

BayerPattern.cs

@@ -2,15 +2,29 @@
 
 namespace TianWen.DAL
 {
-    [Flags]
-    public enum BayerPattern
+    public enum BayerPattern : ulong
     {
-        Monochrome = 0,
-        HasBayerMatrix = 1,
-        RGGB = 0b0000_0010 | HasBayerMatrix,
-        BGGR = 0b0000_0100 | HasBayerMatrix,
-        GBRG = 0b0000_1000 | HasBayerMatrix,
-        GRBG = 0b0001_0000 | HasBayerMatrix,
+        // TYPE
+        Monochrome = 0b00,
+        R = 0b001,
+        G = 0b010,
+        B = 0b011,
+        L = 0b100, // Luminance (Kodak Truesense)
+        E = 0b101, // Emerald
+
+        RGGB = R << 9 | G << 6 | G << 3 | B,
+        BGGR = B << 9 | G << 6 | G << 3 | R,
+        GBRG = G << 9 | B << 6 | R << 3 | G,
+        GRBG = G << 9 | R << 6 | B << 3 | G,
+
+        /// <summary>
+        /// Native BIN1 pattern of Sony IMX294 sensors (QHY294C-PRO).
+        /// </summary>
+        RRGG_RRGG_GGBB_GGBB =
+            R << 45 | R << 42 | G << 39 | G << 36 |
+            R << 33 | R << 30 | G << 27 | G << 24 |
+            G << 21 | G << 18 | B << 15 | B << 12 |
+            G <<  9 | G <<  6 | B <<  3 | B
     }
 
     public static class BayerPatternEx

CMOSControlType.cs

@@ -0,0 +1,30 @@
+namespace TianWen.DAL
+{
+    public enum CMOSControlType
+    {
+        Gain = 1,
+        Exposure,
+        Gamma,
+        WB_R,
+        WB_B,
+        Brightness,
+        BandwidthOverload,
+        Overclock,
+        TemperatureDeci,// return 10*temperature
+        Flip,
+        AutoMaxGain,
+        AutoMaxExp,
+        AutoMaxBrightness,
+        HardwareBin,
+        HighSpeedMode,
+        CoolerPowerPerc,
+        TargetTemp,// not need *10
+        CoolerOn,
+        MonoBin,
+        FanOn,
+        PatternAdjust,
+        AntiDewHeater,
+        Humidity,
+        EnableDDR
+    }
+}

CMOSErrorCode.cs

@@ -0,0 +1,50 @@
+namespace TianWen.DAL
+{
+    public enum CMOSErrorCode
+    {
+        Success = 0,
+        /// <summary>
+        /// no camera connected or index value out of boundary
+        /// </summary>
+        InvalidIndex,
+        InvalidId,
+        InvalidControlType,
+        /// <summary>
+        /// Camera is not connected, or couldn't be opened
+        /// </summary>
+        CameraClosed,
+        /// <summary>
+        /// Failed to find the camera, maybe the camera has been removed
+        /// </summary>
+        CameraRemoved,
+        /// <summary>
+        /// cannot find the path of the file.
+        /// </summary>
+        InvalidPath,
+        InvalidFileFormat,
+        /// <summary>
+        /// Wrong video format size
+        /// </summary>
+        InvalidSize,
+        /// <summary>
+        /// Unsupported image format
+        /// </summary>
+        InvalidImageFormat,
+        /// <summary>
+        /// Start position is out of boundary
+        /// </summary>
+        OutOfBoundary,
+        Timeout,
+        /// <summary>
+        /// Stop capture first
+        /// </summary>
+        InvalidSequence,
+        BufferTooSmall,
+        VideoModeActive,
+        ExposureInProgress,
+        /// <summary>
+        /// general error, eg: value is out of valid range
+        /// </summary>
+        GeneralError
+    };
+}

INativeCMOSDeviceInfo.cs

@@ -39,5 +39,11 @@ public interface INativeCMOSDeviceInfo : INativeDeviceInfo
         IReadOnlyList<PixelDataFormat> SupportedPixelDataFormats { get; }
 
         BayerPattern BayerPattern { get; }
+
+        bool TryGetControlRange(CMOSControlType ctrlType, out int min, out int max);
+
+        CMOSErrorCode GetControlValue(CMOSControlType controlType, out int value, out bool isAuto);
+
+        CMOSErrorCode SetControlValue(CMOSControlType controlType, int value, bool isAuto = false);
     }
 }