Merge pull request #686 from pupil-labs/Scene_camera_exposure_doc

Scene camera exposure doc

neon/.vitepress/config.mts

@@ -103,8 +103,8 @@ let theme_config_additions = {
             link: "/data-collection/offset-correction/",
           },
           {
-            text: "Backlight Compensation",
-            link: "/data-collection/backlight-compensation/",
+            text: "Scene Camera Exposure",
+            link: "/data-collection/scene-camera-exposure/",
           },
         ],
       },

neon/data-collection/scene-camera-exposure/index.md

@@ -0,0 +1,32 @@
+# Scene Camera Exposure
+The [scene camera’s](https://docs.pupil-labs.com/neon/data-collection/data-streams/#scene-video) exposure can be adjusted to improve image quality in different lighting conditions. There are four modes:
+
+- **Manual:** This mode lets you set the exposure time manually.
+- **Automatic**: `Highlights`, `Balanced`, and `Shadows` automatically adjust exposure according to the surrounding lighting.
+
+::: tip 
+The mode you choose should depend on the lighting conditions in your environment. The images below provide some 
+examples and important considerations.
+:::
+
+## Changing Exposure Modes
+From the home screen of the Neon Companion app, tap 
+the [Scene and Eye Camera preview](https://docs.pupil-labs.com/neon/data-collection/first-recording/#_4-open-the-live-preview), 
+and then select `Balanced` to reveal all four modes.
+
+## Manual Exposure Mode
+Allows you to set the exposure time between 1 ms and 1000 ms. 
+
+::: tip
+Exposure duration is inversely related to camera frame rate. Exposure values above 330 ms will reduce the scene camera rate below 30fps.
+:::
+
+## Automatic Exposure Modes
+`Highlights`- optimizes the exposure to capture bright areas in the environment, while potentially underexposing dark areas.
+![This mode optimizes the exposure to capture bright areas in the environment, while potentially underexposing dark areas.](Highlight.webp)
+
+`Balanced` - optimizes the exposure to capture brighter and darker areas equally.
+![This mode optimizes the exposure to capture brighter and darker areas in the environment equally.](./Balance.webp)
+
+`Shadows` - optimizes the exposure to capture darker areas in the environment, while potentially overexposing brighter areas.
+![This mode optimizes the exposure to capture darker areas in the environment, while potentially overexposing bright areas.](Shadow.webp)