"""
PTZ控制配置
"""

# PTZ控制配置
PTZ_CONFIG = {
    'default_zoom': 8,               # 默认变焦倍数
    'max_zoom': 20,                  # 最大变焦倍数
    'move_speed': 4,                 # 移动速度 (1-8)
    'coordinate_offset': (0, 0),     # 坐标偏移校准
    
    # 视野角度配置 (根据实际摄像头参数设置)
    'pan_range': (0, 180),           # 水平视野范围 (度) - 全景相机通常覆盖180度
    'tilt_range': (-45, 45),         # 垂直视野范围 (度) - 垂直方向覆盖角度
    'pan_center': 90,                # 水平中心角度 (画面中心对应的PTZ角度)
    'tilt_center': 0,                # 垂直中心角度
    
    # 球机安装方向配置
    # mount_type: 'ceiling' - 吸顶/吊装（镜头朝上）, 'wall' - 壁装/立杆（镜头朝下）
    # 吸顶安装时，俯仰角(tilt)方向与壁装相反，需要反转tilt计算
    'mount_type': 'ceiling',            # 'ceiling' 或 'wall'
    
    # 方向修正（根据mount_type自动设置，也可手动覆盖）
    # pan_flip: 如果球机与全景朝向相反（球机看后面），设为True
    # tilt_flip: 如果俯仰方向相反，设为True（吸顶安装通常需要True）
    'pan_flip': True,
    'tilt_flip': False,              # 由 mount_type='ceiling' 时自动生效
}