Android Camera2手动白平衡技术问询：等效iOS API及算法实现

当前Android Camera2生态中，手动白平衡相关的现有方案存在明显局限：内置AWB预设仅7种，色温调节精度低且无法控制色调；基于Tanner Helland文章的常用算法效果与实际需求相反，且未考虑切换AWB模式时增益和颜色校正变换矩阵同步变化的问题。以下针对三个核心问题给出实操性解答：

1. 色温、色调转光源补偿增益的算法 #

目标是实现补偿式增益：低色温（如1000K橙光）时画面偏蓝，高色温（如10000K蓝光）时画面偏橙，匹配Filmic App类效果。

核心实现逻辑 #

以D65白点（6500K）为基准，分色温区间计算RGB相对增益，再叠加色调偏移调整：

1. 色温到RGB增益计算
   • 当色温 T < 6500K（暖光环境）：降低红色增益，提升蓝色增益，同步微调绿色增益保持中性平衡

     float redGain = 1.0f;
     float blueGain = 1.0f + (6500.0f - T) / 1000.0f * 0.15f;
     float greenGain = 1.0f + (6500.0f - T) / 1000.0f * 0.05f;
     

   • 当色温 T > 6500K（冷光环境）：降低蓝色增益，提升红色增益，同步微调绿色增益

     float blueGain = 1.0f;
     float redGain = 1.0f + (T - 6500.0f) / 1000.0f * 0.12f;
     float greenGain = 1.0f + (T - 6500.0f) / 1000.0f * 0.04f;
     

   注：上述系数需根据传感器硬件特性校准，不同RGGB传感器的响应曲线存在差异。
2. 色调（绿-品轴）调整
   通过调整绿色增益实现色调偏移，取值范围 -1.0f（品色）到 1.0f（绿色）：

   float hue = 0.5f; // 示例值，根据需求调整
   greenGain *= (1.0f + hue * 0.2f);
   

3. 硬件范围限制
   所有增益值需限制在相机支持的范围内，可通过CameraCharacteristics.SENSOR_INFO_WHITE_BALANCE_GAIN_RANGE获取合法区间。

2. 从AWB激活的CaptureResult反推色温 #

当AWB处于自动模式（如CONTROL_AWB_MODE_AUTO）时，可通过以下步骤从捕获结果反推当前AWB对应的色温：

1. 提取原始增益
   从CaptureResult.COLOR_CORRECTION_GAINS获取RGGB四通道增益，计算绿色通道平均增益：

   float[] gains = result.get(CaptureResult.COLOR_CORRECTION_GAINS);
   float gainR = gains[0];
   float gainG = (gains[1] + gains[2]) / 2.0f;
   float gainB = gains[3];
   

2. 归一化增益
   以绿色增益为基准，得到相对RGB增益：

   float r = gainR / gainG;
   float g = 1.0f;
   float b = gainB / gainG;
   

3. 转换为CIE xy坐标
   通过相机原生的SENSOR_COLOR_TRANSFORM将RGB转换为XYZ空间，再计算xy坐标：

   float[] sensorTransform = characteristics.get(CameraCharacteristics.SENSOR_COLOR_TRANSFORM);
   float X = r * sensorTransform[0] + g * sensorTransform[1] + b * sensorTransform[2];
   float Y = r * sensorTransform[3] + g * sensorTransform[4] + b * sensorTransform[5];
   float Z = r * sensorTransform[6] + g * sensorTransform[7] + b * sensorTransform[8];
   float x = X / (X + Y + Z);
   float y = Y / (X + Y + Z);
   

4. xy坐标转色温
   使用McCamy近似公式计算色温（适用范围2000K-10000K）：

   float n = (x - 0.3320f) / (0.1858f - y);
   float temp = 449 * (float)Math.pow(n,3) + 3525 * (float)Math.pow(n,2) + 6823.3f * n + 5520.33f;
   

注：若AWB启用了色调补偿，需先通过CONTROL_AWB_LOCK锁定AWB状态，再获取结果以保证精度。

3. 捕获请求中颜色校正变换矩阵的正确设置 #

颜色校正变换矩阵（COLOR_CORRECTION_TRANSFORM）的设置需结合相机硬件特性和白平衡模式：

1. 手动白平衡模式
   • 以相机原生的SENSOR_FORWARD_MATRIX1或SENSOR_FORWARD_MATRIX2（对应不同输出格式）为基础矩阵，该矩阵是传感器原生RGB到标准色彩空间（如sRGB）的核心变换。
   • 根据手动设置的白平衡增益，调整基础矩阵：将增益应用到矩阵的对应通道，或重新计算适配当前增益的变换矩阵，确保色彩还原准确。
   • 将调整后的矩阵赋值给CaptureRequest.COLOR_CORRECTION_TRANSFORM。
2. AWB自动模式
   • 无手动干预需求时，直接使用AWB返回的CaptureResult.COLOR_CORRECTION_TRANSFORM即可，AWB会根据当前光源自动优化矩阵。
   • 需微调时，基于AWB返回的矩阵进行二次调整后再设置到捕获请求。

关键原则 #

• 切换AWB模式或调整白平衡增益时，必须同步更新变换矩阵，否则会出现严重色彩偏色。
• 优先使用相机原生矩阵作为基础，避免自定义矩阵导致色彩还原偏离硬件特性。

内容的提问来源于stack exchange，提问作者Matt