用途
blender-cameras 用于在 Blender 中进行具备电影思维的相机设置，适用于任何相机摆放、取景、焦段、景深（DoF）或相机动画相关的工作。它的核心理念是：用与真实摄影师相同的决策方式来架设相机——用焦段决定画面感觉，用光圈决定焦点与虚实，用构图完成叙事。
接入方式
该技能提供 MCP 后端。资料说明：在首次调用 Blender 之前，需要阅读 ../text-to-blender/references/mcp-backends.md。对于共享能力优先使用官方 MCP，并在整个任务中保持所选后端不变。配方中的工具名称属于客户端/历史示例，需通过上述参考文件及其 agent-host 指南进行映射。
焦段速查
- 14–24mm：非常广、有畸变感；用于建筑、幽闭室内、夸张透视。
- 28–35mm：广角、“纪录片”感；用于建立镜头、环境交代。
- 50mm：中性（接近人眼）；默认叙事镜头。
- 85mm：中长焦；人像、角色近景（更上镜）。
- 100–135mm：长焦；产品英雄镜头、孤立主体。
- 200mm+：超长焦；野生动物、监控感、强压缩。
快速原则：85mm 用于亲密感，24mm 用于宏大感，50mm 用于中性表达。
光圈 / f-stop 对照
- f/1.2–2.0：极浅景深；英雄人像、梦幻感。
- f/2.8：浅景深；标准人像。
- f/4：中等景深；画面内两个主体。
- f/5.6–8：中等偏深；群像、环境。
- f/11+：极深景深；风景、“全部清晰”。
主要配方（脚本示例）
资料给出多段 Python 脚本示例，均保留原始代码：
配方 0 — 包围盒感知的英雄机位（编排链首选）：适用于有明确主体的场景。它计算主体的包围盒，把相机放在能让主体垂直方向约占画面 80% 的距离上，并通过 Track-To 约束对准。示例中使用 GEO- 前缀的网格作为主体，并给出取景距离的数学推导（frame_per_meter = sensor_h_mm / focal_mm，camera_distance = biggest / (frame_per_meter * target_fill)）。资料提示：细长竖直主体（剑、旗、蜡烛）按高度取景正合适；而宽扁水平主体（车、桌子）按最大维度取景会过放大，此时应改用 frame_per_meter_h = (sensor_h_mm * aspect_ratio) / focal_mm 或降低 target_fill。
配方 1 — 英雄人像机位（85mm + 浅景深）：创建 CAM-hero 相机，位置 (3, -4, 1.6)，lens 85，sensor_width 36，开启 DoF 且 aperture_fstop 2.8，聚焦主体对象，并添加 Track-To 约束自动对准。
配方 2 — 广角环境建立镜头（24mm）：创建 CAM-establish，位置 (8, -10, 2.5)，rotation_euler 设 (80°, 0, 35°)，lens 24，sensor_width 36，关闭 DoF。
配方 3 — 产品英雄镜头（100mm + 微距景深）：创建 CAM-product，近距离位置 (0.4, -1.5, 0.2)，lens 100，sensor_width 36，开启 DoF 且 aperture_fstop 2.0，聚焦主体并 Track-To。
配方 4 — 构图辅助（三分法叠加）：开启相机数据的 show_composition_thirds，关闭 golden 与 center。资料说明这些叠加仅在视口中显示，不影响渲染。
配方 5 — 环绕相机动画（10 秒 360° 转台）：用空物体作枢轴，相机作为其子级；对枢轴的 Z 旋转在第 1 帧到第 240 帧（24fps 下 10 秒）做 0→360° 关键帧，并将关键帧插值设为 LINEAR 以获得匀速环绕。示例中包含兼容新旧 Blender 动作结构的 fcurves 获取函数。
配方 6 — 推入 / 推轨（相机前移，不变焦）：对相机位置在第 1 帧与第 120 帧插入关键帧，实现 5 秒推轨。资料强调推轨（物理前移）与变焦（改变焦段）在视觉上不同：推轨用于电影感，变焦用于监控/新闻感。
构图规则（通过位置实现）
- 三分法：把主体放在 4 个交点上，而不是正中。
- 头顶留白：头顶上方留约 10% 空白。
- 视线留白：主体朝左时，在左侧留出“看进去”的空间。
- 前 / 中 / 后景：三个深度层次更有电影感。
传感器尺寸参考
- 全画幅 DSLR / 35mm 电影：36mm（默认）。
- APS-C：22.5mm（1.5–1.6× 裁切）。
- Super 35：24.89mm（多数电影机）。
- Micro Four Thirds：17.3mm（无反）。
- iPhone 15 Pro：9.8mm（手机参考）。
通过 cam_data.sensor_width 设置。
适用场景
资料列出的适用场景包括：需要电影感的相机摆放、各类焦段与景深控制、构图辅助、相机动画（转台、推轨）、以及为编排链提供以主体为中心的自动化机位。
常见问题与修复
- 人像面部畸变：人类主体使用 50mm 以上焦段。
- 主体模糊、背景清晰：把 dof.focus_object 设为主体。
- 相机正对主体居中：应用三分法，偏移主体。
- 环绕相机剧烈倾斜：使用 Track-To 约束而非手动旋转。
- 动画中相机穿地：添加 Floor 约束或检查 Z 关键帧。
- Cycles 中 DoF 很慢：成品可接受，视口可用更简单的近似。
何时加载 references/overview.md
资料建议以下情况加载该参考：需要默认之外的电影效果（变形宽银幕、镜头光晕、暗角）；多机位场景（用于剪辑的相机标记）；相机抖动 / 手持噪点；立体 / VR 相机设置。该参考覆盖：完整焦段理论、光圈/f-stop 表、构图辅助、匹配真实相机（iPhone、电影机、DSLR）的传感器变体、相机动画模式与电影效果。
限制
资料未提供该技能的收费方式、价格、平台限制、性能指标或精度保证，这些信息暂未提供。