Android CameraServer Mapper相关梳理

坐标 Mapper 类设计与实现文件位置:device3/CoordinateMapper.h/.cpp,ZoomRatioMapper.h/.cpp,DistortionMapper.h/.cpp,RotateAndCropMapper.h/.cpp,UHRCropAndMeteringRegionMapper.h/.cpp1. 功能概述坐标 Mapper 子系统解决的核心问题：Camera HAL 和 App 处于不同的坐标空间。HAL 操作在传感器原始坐标空间（pre-correction active array、raw distorted pixels、uncropped sensor region）App 操作在校正后的坐标空间（corrected、cropped、zoom-rotated view）Mapper 负责在两者之间转换 metadata 中的坐标，确保 metering regions、crop regions、face rectangles 等一致存储方式:Camera3Device中以std::unordered_mapstd::string, MapperType按 camera ID 存储，支持 logical multi-camera 的物理子相机。2. 类层次结构CoordinateMapper (abstract base) +-- ZoomRatioMapper +-- DistortionMapper +-- RotateAndCropMapper UHRCropAndMeteringRegionMapper (standalone, NOT inheriting from CoordinateMapper)3. CoordinateMapper (基类)文件:CoordinateMapper.h/CoordinateMapper.cpp3.1 核心设计成员类型含义mRemappedKeysstd::setuint32_t该 mapper 修改的 metadata tag 集合作用:sendPartialCaptureResult()用mRemappedKeys从 partial result 中剔除这些 key，防止 App 看到未映射的中间坐标值。完整映射坐标只在最终 combined result 中发送。3.2 静态 Metadata Key 数组数组Key格式kMeteringRegionsToCorrect[3]AF_REGIONS, AE_REGIONS, AWB_REGIONS5-element (left, top, right, bottom, weight)kRectsToCorrect[1]SCALER_CROP_REGION4-element (left, top, width, height)kResultPointsToCorrectNoClamp[2]FACE_RECTANGLES, FACE_LANDMARKSresult-only, 不做 clamp3.3 纯虚函数initRemappedKeys()— 子类填充自己处理的 tag 集合4. ZoomRatioMapper文件:ZoomRatioMapper.h/ZoomRatioMapper.cpp4.1 功能桥接CONTROL_ZOOM_RATIO和SCALER_CROP_REGION两种缩放机制。App 可以使用任一 API，mapper 确保无论 HAL 支持哪种都能正确工作。4.2 关键成员变量成员类型含义mHalSupportsZoomRatioboolHAL 是否原生支持 ZOOM_RATIOmArrayWidth/Heightint32_tactive array 或 pre-correction array 尺寸mArrayWidth/HeightMaximumResolutionint32_tUHR 模式 array 尺寸mIsValidbool构造是否成功4.3 Metadata KeysmRemappedKeys: 3 个 metering regions、SCALER_CROP_REGION、FACE_RECTANGLES、FACE_LANDMARKS、CONTROL_ZOOM_RATIO、LOGICAL_MULTI_CAMERA_ACTIVE_PHYSICAL_SENSOR_CROP_REGION4.4 核心算法deriveZoomRatio()— 从 crop region 推导 zoom ratio:计算 crop region 边缘到 array 中心的距离每边缩放因子:zoomRatioEdge = arrayDimension / (2 * edgeDistance)，clamp = 1.0取 4 个因子的最小值（处理 letterboxing/pillarboxing）scaleCoordinates()— 围绕 array 中心缩放坐标:xCentered = x - (arrayWidth - 2) / 2 scaledX = xCentered * scaleRatio + (arrayWidth - 2) / 2(arrayWidth - 2) / 2是 pixel-center 表示法的中心点。4.5 请求路径 (updateCaptureReques