feat: add brightness, contrast, saturation, sharpness

Author: darrylhodgins

README.md

@@ -242,6 +242,10 @@ const stillCamera = new StillCamera({
 - [`flip: Flip`](#flip) - *Default: `Flip.None`*
 - `delay: number` - *Default: 1 ms*
 - `shutter: number` - *Default: Auto calculated based on framerate (1000000µs/fps). Number is in microseconds*
+- `sharpness: number` - *Range: `-100`-`100`; Default: `0`*
+- `contrast: number` - *Range: `-100`-`100`; Default: `0`*
+- `brightness: number` - *Range: `0`-`100`; Default: `50`*
+- `saturation: number` - *Range: `-100`-`100`; Default: `0`*
 - `iso: number` - *Default: Auto*
 - `exposureCompensation: number` - *Default: `0`*
 - [`exposureMode: ExposureMode`](#exposuremode) - *Default: Auto*
@@ -281,6 +285,10 @@ const streamCamera = new StreamCamera({
 - [`codec: Codec`](#codec) - *Default: `Codec.H264`*
 - [`sensorMode: SensorMode`](#sensormode) - *Default: `SensorMode.AutoSelect`*
 - `shutter: number` - *Default: Auto calculated based on framerate (1000000µs/fps). Number is in microseconds*
+- `sharpness: number` - *Range: `-100`-`100`; Default: `0`*
+- `contrast: number` - *Range: `-100`-`100`; Default: `0`*
+- `brightness: number` - *Range: `0`-`100`; Default: `50`*
+- `saturation: number` - *Range: `-100`-`100`; Default: `0`*
 - `iso: number` - *Default: Auto*
 - `exposureCompensation: number` - *Default: `0`*
 - [`exposureMode: ExposureMode`](#exposuremode) - *Default: Auto*

src/lib/shared-args.ts

@@ -43,6 +43,26 @@ export function getSharedArgs(options: StillOptions | StreamOptions): string[] {
      */
     ...(options.shutter ? ['--shutter', options.shutter.toString()] : []),
 
+    /**
+     * Sharpness (-100 to 100; default 0)
+     */
+    ...(options.sharpness ? ['--sharpness', options.sharpness.toString()] : []),
+
+    /**
+     * Contrast (-100 to 100; default 0)
+     */
+    ...(options.contrast ? ['--contrast', options.contrast.toString()] : []),
+
+    /**
+     * Brightness (0 to 100; default 50)
+     */
+    ...((options.brightness || options.brightness === 0) ? ['--brightness', options.brightness.toString()] : []),
+
+    /**
+     * Saturation (-100 to 100; default 0)
+     */
+    ...(options.saturation ? ['--saturation', options.saturation.toString()] : []),
+
     /**
      * ISO
      */

src/lib/still-camera.ts

@@ -10,6 +10,10 @@ export interface StillOptions {
   flip?: Flip;
   delay?: number;
   shutter?: number;
+  sharpness?: number;
+  contrast?: number;
+  brightness?: number;
+  saturation?: number;
   iso?: number;
   exposureCompensation?: number;
   exposureMode?: ExposureMode;

src/lib/stream-camera.ts

@@ -31,6 +31,10 @@ export interface StreamOptions {
   codec?: Codec;
   sensorMode?: SensorMode;
   shutter?: number;
+  sharpness?: number;
+  contrast?: number;
+  brightness?: number;
+  saturation?: number;
   iso?: number;
   exposureCompensation?: number;
   exposureMode?: ExposureMode;