FilmBox Toolkit 使用说明
面向摄影师的实用工具集合，覆盖测光、景深、闪光、器材管理、胶片日志、测距等全流程场景。
快速开始
- 启动引导：打开 App 后完成首次引导，了解核心功能布局。
- 功能概览：进入首页，即可看到测光表、景深计算器、闪光计算器、器材库、测距仪等模块入口。
- 全局设置：点击右上角或底部「设置」图标，可进行语言切换、主题设置、查看 Pro 功能与隐私政策。
首页（功能入口）
首页是所有工具的聚合入口，采用卡片式设计。
- 点击任意功能卡片即可快速进入。
- 支持多语言切换（系统/简中/繁中/英语/日语/韩语/意大利语），切换后首页各模块标题会自动刷新。
测光表
提供专业级的实时测光功能，替代传统手持测光表。
使用步骤
- 点击首页「测光表」进入。
- 选择模式：
- 平均测光：适合光照均匀的通用场景。
- 点测光：屏幕会自动放大 (5x) 中心区域，便于对微小主体进行精确读数。
- 实时观察屏幕下方的 EV（曝光值）、快门速度、光圈值和 ISO 信息。
- 点击底部「记录」按钮，保存当前曝光数据。
- 全套曝光参数（ISO / 光圈 / 快门 / EV）
- 精确时间戳
- 地理位置（城市/地名）— 需授权定位权限
计算工具
景深计算器
计算在特定条件下的清晰范围。
- 输入参数：焦距、光圈值、对焦距离。
- 结果：实时显示景深范围（前景深与后景深）。
闪光计算器
辅助闪光灯摄影的曝光计算。
- 核心公式：基于引闪指数 (GN)、距离和光圈进行计算。
- 支持常用参数的快速选择，也支持手动输入数值。
器材库（核心管理）
FilmBox Toolkit 的核心数据中心，包含「我的器材」、「照片日志」和「器材百科」三部分。
1. 我的器材
用于管理您的拍摄装备组合。
- 器材组合：默认提供 3 个组合槽位（可重命名）。
- 组合内容：每个组合包含 相机 + 镜头 + 胶片 + 配件。
- 操作：支持新增和删除组合（删除即时的二次确认机制）。若未选择某项，界面会显示“未选择”或“无配件”。
2. 智能选择器
在配置器材时的弹窗功能：
- 搜索：快速查找已有器材。
- 自定义：支持输入新器材名称。自定义添加的器材会自动加入「收藏」，并在下次选择时优先显示在列表顶部。
3. 器材百科
内置的器材数据库。
- 优先展示您收藏的器材。
- 未收藏时显示友好的空状态提示。
- 支持中文关键词和品牌名称的模糊搜索。
照片日志
专为胶片摄影设计的拍摄记录工具。
使用方法
- 进入「照片日志」，选择一卷正在拍摄或已完成的胶片。
- 针对每一张底片，您可以记录：
- 序号：自动递增或手动修改。
- 曝光参数：光圈、快门等。
- 备注：支持手动输入文字描述。
交互细节：切换下一张照片时，键盘会自动收起，方便连续记录。
智能胶片卡片
系统会根据胶片品牌自动渲染卡片背景色，提升视觉辨识度：
- 🟡 Kodak：经典柯达黄
- 🟢 Fuji：富士绿
- 🔵 自定义/其他：蓝白渐变或自动色彩
测距仪 (LiDAR)
利用 iPhone Pro 系列的 LiDAR 雷达进行高精度测距。
若您的设备不支持，进入该功能时会显示提示：“由于你的手机没有 LiDAR 雷达，所以无法使用此功能。”
设置与 Pro
通用设置
- 多语言支持：支持 7 种语言（System / 简体中文 / 繁体中文 / 英语 / 日语 / 韩语 / 意大利语）。
- 主题切换：支持深色/浅色模式或跟随系统。
Pro 功能
解锁 Pro 版可获得全部高级功能。页面会显示当前区域的价格，且解锁按钮与说明文案完全本地化。
隐私与权限
- 定位权限：仅用于在测光记录中自动写入地点信息。
- 相机权限：测光表（取景测光）与测距仪（AR 测距）的必要权限。
常见问题 (FAQ)
A: 点测光模式需要稳定的相机 Session 环境。如果系统资源紧张可能导致画面缩放失败。建议尝试重新进入测光表模块或重启 App。
A: 不可以。该功能强依赖硬件雷达，不支持 LiDAR 的设备会直接显示不可用提示。
A: 自定义添加的器材会被系统默认标记为“收藏”，您可以直接在列表顶部的收藏区域找到它们。
FilmBox Toolkit User Manual
A utility collection for film photographers, covering metering, depth of field, flash, gear management, film logging, and rangefinding.
Quick Start
- Launch Guide: Complete the initial guide after opening the App to understand the core layout.
- Overview: Access modules like Light Meter, DOF Calculator, Flash Calculator, Gear Library, and Rangefinder from the home screen.
- Global Settings: Tap the Settings icon to access language, theme, Pro features, and privacy policy.
Home Screen
The home screen is the hub for all tools, designed with cards for easy access.
- Tap any card to enter the corresponding feature.
- Supports 7 languages (System / Chinese / English / Japanese / Korean / Italian). Module titles refresh automatically upon switching.
Light Meter
Provides professional real-time light metering, replacing traditional handheld meters.
Steps
- Tap "Light Meter" on the home screen.
- Select Mode:
- Average: Suitable for general scenes with even lighting.
- Spot: The screen automatically zooms in (5x) to the center for precise readings of small subjects.
- Observe real-time EV, Shutter Speed, Aperture, and ISO at the bottom.
- Tap "Record" to save the current exposure data.
- Exposure parameters (ISO / Aperture / Shutter / EV)
- Precise timestamp
- Location (City/Place) — Requires location permission
Calculators
Depth of Field (DOF) Calculator
Calculates the range of sharpness under specific conditions.
- Inputs: Focal Length, Aperture, Focus Distance.
- Result: Real-time display of Near Limit and Far Limit.
Flash Calculator
Assists with exposure calculation for flash photography.
- Formula: Based on Guide Number (GN), Distance, and Aperture.
- Supports quick selection of common parameters and manual input.
Gear Library
The core data center of FilmBox Toolkit, containing "My Gear", "Photo Journal", and "Gear Encyclopedia".
1. My Gear
Manage your equipment combinations.
- Gear Sets: 3 default slots (renamable).
- Content: Each set includes Camera + Lens + Film + Accessories.
- Actions: Add/Delete sets (with confirmation). Unselected items show as "None".
2. Smart Selector
When selecting gear:
- Search: Quickly find existing gear.
- Custom: Input new gear names. Custom items are automatically "Favorited" and appear at the top of the list next time.
3. Gear Encyclopedia
Built-in gear database.
- Favorited items appear first.
- Shows a friendly prompt if no favorites exist.
- Supports fuzzy search for brands and models.
Photo Journal
A logging tool designed specifically for film photography.
Usage
- Enter "Photo Journal", select a roll of film (active or finished).
- For each frame, you can log:
- Index: Auto-increment or manual edit.
- Parameters: Aperture, Shutter, etc.
- Notes: Manual text input.
Interaction: The keyboard automatically dismisses when switching to the next photo for continuous logging.
Smart Film Cards
The system renders card colors based on film brand:
- 🟡 Kodak: Classic Yellow
- 🟢 Fuji: Fuji Green
- 🔵 Custom/Other: Blue gradient or auto color
LiDAR Rangefinder
High-precision distance measurement using iPhone Pro series LiDAR.
If your device is unsupported, a prompt will appear: "LiDAR not detected. Feature unavailable."
Settings & Pro
General
- Languages: Supports 7 languages (System / Chinese / English / Japanese / Korean / Italian).
- Theme: Light / Dark / System.
Pro Features
Unlock Pro to access all advanced features. Pricing is localized to your region.
Privacy & Permissions
- Location: Only used to tag location in metering logs.
- Camera: Required for Light Meter (Viewfinder) and Rangefinder (AR).
FAQ
A: Spot metering requires a stable camera session. Low system resources may prevent zooming. Try restarting the module or the App.
A: No. This feature relies on hardware radar. Unsupported devices will show an unavailability prompt.
A: Custom added gear is automatically marked as "Favorite". You can find it at the top of the list in the Favorites section.