背光自动亮度手动覆盖LUT

BacklightAutobrightnessManualOverrideLut

定义查找表，指定在应用键盘背光自动亮度进行临时手动覆盖时的最低和最高阈值，这些阈值表示为当前环境光线读取的百分比。 此设置旨在遵循用户偏好，同时提升键盘反光的能效。

手动替代激活条件

键盘反光自动亮度使用桶状环境光响应曲线，该曲线可以使用 BacklightAutobrightnessBucketMapping 值进行自定义。 当按下键盘背光下一级按钮或键盘背光上一级按钮时，将激活一个临时的自动亮度“手动覆盖”功能。 它是应用于桶化曲线顶部的单独附加存储桶，源自当前环境光读数，最小和最大照度值基于当前读数的百分比生成，距离设置为高于或低于当前读数。 此替代的相应反光亮度百分比由系统提供，（可选）基于键盘硬件中建议的亮度级别。

手动覆盖解除条件

激活后，将使用手动替代亮度百分比，直到出现以下任一情况：

• 环境光读取值超出覆盖范围的界限，此时将取消覆盖、消除覆盖范围，并使用分段曲线恢复自动调光控制，或者
• 按下另一个“下一级别上一级别”按钮后，将根据最新的当前环境光读数调整亮度百分比，并重新计算手动覆盖范围。

参数

查找表是由一个或多个用逗号分隔的 4 元组组成的字符串。 每个 4 元组都是以“X:Y:A:B”格式编写的查找表中的一个条目，其中，对于任何环境光读取 R（测量单位为照度，lux）：

• X 和 Y 是最小环境光级别和最大环境光级别，分别用于唯一标识查阅表格条目。 这些值以照度表示，以整数或十进制格式表示为非负数值。 如果 X ≤ R ≤ Y，则给定的查阅表格项将用于生成手动替代范围。

字符串中的所有 4 元组必须按升序声明，并且连续定义（不重叠），这样，对于元组“X₁:Y₁:A₁:B₁,...,X_n:Y_n:A_n:B_n”，Y_i 的值必须等于 X_i+1 的值。

• A 是当前环境光读数的百分比，如果 R 属于从 X 到 Y 的范围，则应用于计算手动替代范围的下限。由于不支持负照度值，因此此值必须表示为介于 0.0 到 1.0 之间的整数或十进制值。

  如果 X ≤ R ≤ Y，则替代范围的下限将计算为 R（1 - A）。 例如，给定查找表条目“50：150：0.3：0.25”，以 R=100 发起的手动覆盖操作的下限阈值为 100(1 - 0.3) = 70 勒克斯。

• B 是当前环境光读数的百分比，如果 R 属于从 X 到 Y 的范围，则应用于计算手动替代范围的上限。此值以整数或十进制格式表示为非负数值。

  如果 X ≤ R ≤ Y，则替代范围的上限阈值将计算为 R（1 + B）。 例如，给定查找表条目“50：150：0.3：0.25”，以 R=100 发起的手动控制的上限阈值为 100（1 + 0.25）= 125 照度。

有效字符串的示例如下：“0:20:1.0:1.0,20:40:0.7:0.6,40:150:0.6:0.6,150:600:0.5:0.5,600:1000:0.4:0.4,1000:4000:0.3:0.25”

Example

下面是有关如何使用上述字符串计算手动重写范围的说明。

• 为了提高可读性，我们将显示查找表拆分为其各个条目，如下所示：

  {0:20:1.0:1.0} {20:40:0.7:0.6} {40:150:0.6:0.6} {150:600:0.5:0.5} {600:1000:0.4:0.4} {1000:4000:0.3:0.25}

• 假设用户按下“下一级”按钮时，环境光读数为 120 照度。 相应的查阅表格条目为“40：150：0.6：0.6”，因为 120 照度介于 40 到 150 照度之间。
• 存储桶将使用低于当前读数 60% 的阈值进行创建。 对于 R=120 和 A=0.6，照度的下限为 120 × (1 - 0.6) = 48 lx。 高于当前读数的上限阈值为 60%。 同样，对于 R=120 和 B=0.6，上限为 120（1 + 0.6） = 192 照度。 因此，手动替代将应用于 [48， 192] 范围内的环境光级别。
• 现在，假设环境光读数恰好在用户再次按下“下一级别”按钮之前上升到160勒克斯。 新的查阅表格项为“150：600：0.5：0.5”。
• 将使用 R=160、A=0.5 和 B=0.5 重新计算手动替代范围。 这会导致手动超控的范围为 [80, 240]。
• 最后，想象环境光读数下降到75 lux。 这超出了手动替代范围。 临时设定已解除，自动亮度功能恢复。

注解

在低环境光水平下，将提升上限阈值，以确保读数至少比当前值高 10 照度。 这可以防止由于环境光读数发生小变化，导致快速进入和退出手动覆盖而可能出现的背光波动。

低于最低表项的最小照度值的环境光读数将使用最低表条目，而超过最高表项的最大照度值的环境光读数将使用最高的表项。

如果 EnableBucketedBacklightAutobrightness 值设置为 0，则不使用键盘反光自动亮度，并且忽略此值。