PcloudAmbienceStimBuff: Updated to use postrin percentage

docs/design/intrin-thresholds.md

@@ -12,10 +12,16 @@ importance classifications.
 ## Interest Threshold Parameters
 
 **Synonyms:**
+- `postrin-interest-percentage`
+- `postrin-interest-pc`
 - `postrin-interest-threshold`
+- `postrin-interest-th` (abbreviation for `-threshold`)
 - `interest-threshold`
 - `postrin-interest`
+- `negtrin-interest-percentage`
+- `negtrin-interest-pc`
 - `negtrin-interest-threshold`
+- `negtrin-interest-th` (abbreviation for `-threshold`)
 - `negtrin-interest`
 
 **Description:**
@@ -27,8 +33,9 @@ postrinInd/negtrinInd with the "importance" argument set to "INTERESTING".
 **Specification:**
 - The parameter is specified as part of the `quale-iface-api-params`
   in the DAP specification
-- The value is a numeric threshold that determines when stencils are
-  constructed and delivered with INTERESTING importance
+- Parameters with the `-percentage` or `-pc` suffix are interpreted as percentages (0-100)
+- Parameters with the `-threshold` or `-th` suffix are interpreted as absolute threshold values
+- The `-threshold` suffix can be abbreviated as `-th`
 - If multiple synonyms are specified, the lattermost (last encountered)
   synonym takes precedence
 - Separate thresholds can be specified for postrin and negtrin using the
@@ -36,11 +43,11 @@ postrinInd/negtrinInd with the "importance" argument set to "INTERESTING".
 
 **Example:**
 ```
-+idev|my-device|pcloudIntensity(postrin-interest-threshold=50|negtrin-interest-threshold=30)|livoxGen1-pcloudIntensity()|livoxProto1()|3JEDK380010Z39
++idev|my-device|pcloudIntensity(postrin-interest-percentage=50|negtrin-interest-threshold=30)|livoxGen1-pcloudIntensity()|livoxProto1()|3JEDK380010Z39
 ```
 
-This example sets the interest threshold to 50 for postrins and 30 for
-negtrins.
+This example sets the interest threshold to 50% for postrins (percentage-based) and 30 for
+negtrins (absolute threshold value).
 
 ## Distraction Threshold Parameters
 

docs/livox-gen1-lidar-dap-spec.md

@@ -46,13 +46,15 @@ Each stim-buff-api is designed to work with specific stim-iface libraries that u
 **Intrinsic Stimuli Support** (for pcloudAmbience quale-iface-api):
 The `pcloudAmbience` quale-iface-api exports both a postrin and a negtrin whose
 thresholds are configurable via standard quale-iface-api-params:
-- **Postrin interest threshold**: Configurable via `postrin-interest-threshold` / `postrin-interest` (default: 30)
-- **Negtrin interest threshold**: Configurable via `negtrin-interest-threshold` / `negtrin-interest` (default: 30)
+- **Postrin interest threshold**: Configurable via `postrin-interest-percentage` / `postrin-interest-pc` / `postrin-interest` (default: 90, interpreted as percentage)
+- **Negtrin interest threshold**: Configurable via `negtrin-interest-percentage` / `negtrin-interest-pc` / `negtrin-interest-threshold` / `negtrin-interest-th` / `negtrin-interest` (default: 30)
 
-Frames whose average intensity is <= postrin-interest-threshold qualify for
-postrin, and frames whose average intensity is >= negtrin-interest-threshold
-qualify for negtrin. The ambience count written to each stimFrame is the number
-of frames that qualify for either intrinsic.
+The postrin interest threshold is percentage-based only (0-100) and specifies the
+percentage of frames whose average intensity must be <= the ambience intensity low
+value threshold. Frames whose average intensity is <= the ambience intensity low
+value qualify for postrin, and frames whose average intensity is >= the negtrin
+interest threshold qualify for negtrin. The ambience count written to each stimFrame
+is the number of frames that qualify for either intrinsic.
 
 ### 3. Point Cloud Coordinate Data Device (Extrospector)
 

stimBuffApis/livoxGen1/pcloudAmbienceStimulusBuffer.h

@@ -42,7 +42,8 @@ public:
 	{
 		// Parse postrinInterestPercentage (interpreted as percentage 0-100)
 		const std::vector<std::string> postrinInterestThresholdParamNames = {
-			"postrin-interest-threshold",
+			"postrin-interest-percentage",
+			"postrin-interest-pc",
 			"postrin-interest"
 		};