more docs on DIST and STOP

docs/control/extensions/README.md

@@ -31,7 +31,7 @@ Here is a list of additional metadata driven camera extensions:
 - **WBDV=1** - White Balance DiVe improvements. Rather than WARM for improving diving white balance, which effects WB the same at all depths, WBDV is more automatic – as the scene get more blue, the more the red channel is gain up. Currently $WBDV=1 is uses =2.33,4.0 internally (gaining red 4x after red gain hits 2.33), so you can try tuning this yourself e.g. $WBDV=2.4,5.0
 - **SHEL=1** - Using $SHEL=1 enables a command shell for Labs over a USB serial port. Every experimental, and looking for feedback. Connect to COM at 115200 8N1. All QR code command work, just type them. Used $ commands will report their data back to the shell, e.g. $BITR or $A or $p:T to read variables.
 - **OPNW=1** - Open Network (allows of faster non-secure http vs https to be used with Open GoPro)
-- **DIST=x** - Time-Lapse Video Distance, x is a GPS travel distance between exposures, rather than time for an in-camera computed timelapse. When x=1 10m will be used.
+- **DIST=x** - Time-Lapse Video Distance, x is a GPS travel distance between exposures in meters, rather than time for an in-camera computed timelapse. So $DIST=5 will set a 5 meter interval for TLV. One exception is when x=1, 10 meters will be used, 1 meter is too noisy (GPS errors.) So this feature is good for 2 meters of larger. For shorter distances or a higher speed, you the new TLV sample rate for 4Hz (p4), for the best distance precision. e.g. mTr5Xp4$DIST=5
 - **GOAL=x** - 0 to 60 (or x) MPH speed timing. Not for precision timing, just for fun. Drive safe. It currents a JPEG in MISC for you speed award. All very crude, from a recent hackathon.
 - **GPSL=x** - to enabled continous GPS location logging, even when not capturing, so the capture can log more of you path and adventures. Path is saved by day into 
 MISC/GPS-yy-mm-dd.gpmf file. GPSL=1 logs everything, GPSL=x will only log movement great than x meter from the last stored location.
@@ -49,7 +49,7 @@ use DIVE=r, where r can be 1.3 to 1.45 is supported.
 - **OLTC=x** - frame offset to LTC, enabling calibration you are seeing any offset.
 - **RLTC=1** - to enable LTC timecode reading from line-in audio.
 MISC/GPS-yy-mm-dd.gpmf file. GPSL=1 logs everything, GPSL=x will only log movement great than x meter from the last stored location.
-- **STOP=x** - Stop Motion where is x the number for frame to store per shutter press. Works great with the remote. Mode button ends capture.  
+- **STOP=x** - A Stop Motion extension where is x the number for frames to store per shutter press. This modify timelapse video. It is recommend to make a stop motion preset with this command ```mT$PRES="0,STOP"mTr5Xp4``` Works great with the remote. Mode button ends capture. 
 - **ONIO=x** - Onion percentage used for Stop Motion where is x the precentage of transparency of the onion skin.
 - **PRES=x,name** - Added creating, naming and sharing presets where x 0-18 for icon selection (-1 for delete), and 'name' is your named preset. e.g, QR Command **oMPRES="14,Scuba"**
 
@@ -226,7 +226,7 @@ Share this QR Code as a URL: <small id="urltext"></small><br>
 
 <br> 
 
-updated: December 2, 2024<br>
+updated: December 29, 2024<br>
 
 [Learn more](..) on QR Control
 

docs/control/notes/README.md

@@ -41,9 +41,9 @@ e.g. $BITR or $A or $p:T to read variables.
 - Fixed crash with creating presets through the menus.  If instability presists, reset the presets.
 
 ### 1.10.70 - September 10, 2024
-- Added STOP=x for Stop Motion where is x the number for frame to store per shutter press. Works great with the remote. Mode button ends capture.  
+- Added STOP=x A Stop Motion extension where is x the number for frames to store per shutter press. This modify timelapse video. It is recommend to make a stop motion preset with this command ```mT$PRES="0,STOP"mTr5Xp4``` Works great with the remote. Mode button ends capture. 
 - Added ONIO=x Onion percentage used for Stop Motion where is x the precentage of transparency of the onion skin.  
-- Added DIST=x Time-Lapse Video Distance, x is a GPS travel distance, rather than time for an in-camera computed timelapse. When x=1 10m will be used.   
+- Added DIST=x Time-Lapse Video Distance, x is a GPS travel distance between exposures in meters, rather than time for an in-camera computed timelapse. So $DIST=5 will set a 5 meter interval for TLV. One exception is when x=1, 10 meters will be used, 1 meter is too noisy (GPS errors.) So this feature is good for 2 meters of larger. For shorter distances or a higher speed, you the new TLV sample rate for 4Hz (p4), for the best distance precision. e.g. mTr5Xp4$DIST=5
 - Added DIVE=1 - optimizing the Hypersmooth stabilization for underwater. The water refractive index defaults to 1.335 (good for fresh and command salt water), if you know your area RI is significantly different DIVE=r where r can be 1.3 to 1.45 is supported.
 - Added WARM=x and COOL=x to offset white balance.  WARM is good to use with DIVE, so you can improve the red respond for deeper dives. 
 - Added RLTC=1 to enable LTC timecode reading from line-in audio 
@@ -103,7 +103,7 @@ e.g. $BITR or $A or $p:T to read variables.
 - Added *DRFT=1 for automatic clock fix.
 - Added *DRFS=-11.3 for a fixed clock fix.
 - Added mPp1 or p.5 for interval photo
-- Added STOP=x for Stop Motion where is x the number for frame to store per shutter press. Works great with the remote. Mode button ends capture.  
+- Added STOP=x A Stop Motion extension where is x the number for frames to store per shutter press. This modify timelapse video. It is recommend to make a stop motion preset with this command ```mT$PRES="0,STOP"mTr5Xp4``` Works great with the remote. Mode button ends capture. 
 - Added ONIO=x Onion percentage used for Stop Motion where is x the precentage of transparency of the onion skin.  
 - Added DIVE=1 - optimizing the Hypersmooth stabilization for underwater. The water refractive index defaults to 1.335 (good for fresh and salt water), if you know your area RI is significantly different DIVE=r where r can be 1.3 to 1.45 is supported.
 - Added WARM=x and COOL=x to offset white balance.  WARM is good to use with DIVE, so you can improve the red respond for deeper dives. 
@@ -635,6 +635,6 @@ Display the current mode with with this command:  ```"mode $v"!R``` or fast/clea
 
 
 
-updated: December 13, 2024
+updated: December 29, 2024
 
 [Learn more](..) on QR Control

docs/control/tech/README.md

@@ -436,6 +436,7 @@ The above global metadata can be extracted with this [**demo web tool**](../meta
 * **CBAR** H9-13: enable a small 75% saturated color bars for video tools evaluation. Most cameras limit overlays to 4K30, 2.7Kp60 or lower. Input Data: 1 to enable, 0 to disable
 * **DAMP** H10-13: Control over the auto-exposure damping. Setting the DAMP to 1 is the default, setting to 10 would slow the camera’s exposure adjustments 10X.Input Data: 0.1 to 10000. e.g. `$DAMP=10`
 * **DAUD** H10-13: Disable Audio in video captures, all MP4 files will have no audio track. Application: high bit-rate drones video.Input Data: 1 to disable audio, 0 to re-enable
+* **DIVE** H12-13: Optimizing the Hypersmooth stabilization for underwater. It might be no surprise, but HyperSmooth is designed for the camera operation above the water's surface, underwater there is typically less camera shake, and HS is still 70% effective at removing shake. The hack adapts HS to use the refractive index (RI) of water (defaults to 1.335, good for fresh and command salt water), to remove closer to 100% of unwanted shake. Note: if you know your area's RI is significantly different, use DIVE=r, where r can be 1.3 to 1.45 is supported.
 * **DLRV** H10-11: Disable LRV file creation. Application: high bit-rate drones video. Input Data: 1 to disable LRVs, 0 to re-enable
 * **DSPC** Labs text display contrast:  Set the background opacity for Labs text on the LCD. Input Data: Number from 0-transparent to 6-completely opaque.
 * **DSPL** Labs text display length: How long to display each Labs message, like owner information (OWNR). The default is 1 second. Input Data: Number from 1-9 seconds or 10-9999 milliseconds.
@@ -699,6 +700,6 @@ Command steps explained:
 > repeat<br>
  
 
-updated: December 8, 2024
+updated: December 29, 2024
 
 [Learn more](..) on QR Control