Stabilize LUT rendering and improve MIP projection handling

docs/source/02_user_guide/03_user_interface_walkthrough/05_display_notebooks.rst

@@ -14,7 +14,8 @@ Camera View
 The :guilabel:`Camera View` notebook shows the current image and display controls.
 
 1. Left-clicking the image toggles crosshairs.
-2. The right panel includes :ref:`LUT <ui_lut>`, image metrics, and display mode controls.
+2. The right panel includes :guilabel:`Display Mode`, :ref:`LUT <ui_lut>`, image metrics, and image display controls.
+3. Display updates are deferred when the tab is hidden, then refreshed with the newest frame when the view is visible again.
 
 HistogramFrame
 --------------
@@ -34,10 +35,17 @@ IntensityFrame
    :align: center
    :alt: IntensityFrame in the Camera View tab.
 
-1. Select :guilabel:`Gray`, :guilabel:`Gradient`, or :guilabel:`Rainbow` display LUT.
-2. :guilabel:`Flip XY` transposes display axes.
-3. :guilabel:`Autoscale` toggles automatic min/max display scaling.
-4. :guilabel:`Min Counts` and :guilabel:`Max Counts` are used when autoscale is disabled.
+This frame now uses one compact LUT editor for both single-channel and multichannel workflows in both Camera and MIP tabs.
+
+1. :guilabel:`Channel` selects which channel settings are being edited.
+2. In :guilabel:`Single` mode, channel selection is fixed to :guilabel:`All` and disabled.
+3. In :guilabel:`Overlay` mode (with multiple active channels), channel selection is enabled so each channel can be configured independently.
+4. :guilabel:`LUT` uses ImageJ-style colors (:guilabel:`Green`, :guilabel:`Red`, :guilabel:`Magenta`, :guilabel:`Cyan`, :guilabel:`Yellow`, :guilabel:`Blue`, :guilabel:`Orange`, :guilabel:`Gray`).
+5. :guilabel:`Visible` toggles channel contribution on/off.
+6. :guilabel:`Alpha` controls per-channel opacity from 0 to 100%.
+7. :guilabel:`Gamma` controls per-channel gamma from 0.0 to 2.0 (default 1.0).
+8. :guilabel:`Autoscale` applies per-channel automatic min/max scaling.
+9. :guilabel:`Min Counts` and :guilabel:`Max Counts` are used when autoscale is disabled.
 
 MetricsFrame
 ------------
@@ -58,6 +66,7 @@ RenderFrame
    :alt: RenderFrame in the Camera View tab.
 
 This frame switches between live and slice display modes.
+When channel-aware LUT controls are active, the channel selection in this frame is disabled.
 
 MipRenderFrame
 --------------
@@ -68,6 +77,10 @@ MipRenderFrame
 
 This frame controls MIP perspective and channel selection.
 
+1. :guilabel:`Perspective` provides :guilabel:`Multi`, :guilabel:`XY`, :guilabel:`ZY`, and :guilabel:`ZX` views.
+2. In :guilabel:`Multi` perspective, the XY MIP is shown with YZ on the right and XZ on the bottom.
+3. YZ and ZX views are rescaled from acquisition metadata so axial and lateral spacing display isotropically.
+
 .. _ui_waveform_settings:
 
 Waveform Settings

docs/source/02_user_guide/05_acquiring_data/01_acquiring_guide/01_acquiring_guide.rst

@@ -36,7 +36,7 @@ It is implemented as a :ref:`feature list <user_guide_features>`, shown in its :
       )
     ]
 
-The sequence begins with the `PrepareNextChannel` feature and loops over `experiment.MicroscopeState.selected_channels`. As such, continuous mode will display a live preview of all :ref:`selected color channels <ui_channel_settings>` in sequence, then return the first color channel and start again.
+The sequence begins with the `PrepareNextChannel` feature and loops over `experiment.MicroscopeState.selected_channels`. As such, continuous mode will display a live preview of all :ref:`selected color channels <ui_channel_settings>` in sequence, then return the first color channel and start again. In the display notebook, users can choose :guilabel:`Single` view (one channel at a time) or :guilabel:`Overlay` view (multichannel composite) without changing acquisition order.
 
 ----------------