# 输入格式支持矩阵与解码规格
NexFilm Engine 面向胶片数字化全流程构建，旨在打破相机数码翻拍与传统专业扫描仪之间的文件格式壁垒。软件底层集成了基于原生 Rust 优化的高性能色彩与图像解码管线，能够直接读取从主流数码相机原始 RAW 到工业级鼓式扫描仪的无压缩图像文件。
以下为当前版本完整支持的输入文件格式规格矩阵：
| 格式类别 | 文件扩展名 | 色彩编码与位深 | 解码特性与暗房建议 |
|---|---|---|---|
| 相机原始 RAW | .dng, .nef, .cr2, .cr3, .arw, .raf, .rw2, .orf, .pef, .3fr, .iiq 等主流单反/无反格式 | 12-bit / 14-bit / 16-bit 线性传感器原始拜耳（Bayer）马赛克数据 | 相机翻拍的最佳输入源。绕过机内白平衡与色调曲线，保留完整的传感器动态范围与线性透射率数据，为高精度去色罩提供充沛的曝光宽容度。 |
| 哈苏 Flextight / Imacon | .fff | 16-bit 线性扫描仪原始传感器数据 | 自 v1.1.0 起，NexFilm 重构了解码判定逻辑，直接按扫描仪流式线性光学密度解算，不再强依赖 FlexColor 的专有设备识别字符串，彻底杜绝了将扫描仪文件误判为相机 RAW 的历史缺陷。 |
| 工业扫描仪 TIFF | .tif, .tiff | 16-bit / 8-bit 未压缩或 LZW 压缩格式 | 完美支持 Epson、Noritsu、Frontier、Plustek 等扫描仪输出的单通道黑白与三通道彩色正片 TIFF。支持按行流式解码百兆乃至 GB 级高分辨率大画幅图像，内存占用平稳可控。 |
| 标准位图格式 | .png, .jpg, .jpeg | 8-bit / 16-bit 标准 sRGB 或 Display P3 色彩空间 | 支持快速读取预览与测试。受限于 8-bit JPEG 严重的动态范围压缩与片基色罩截断，无法达到 RAW 级别的自动物理校色精度，仅建议用于快速验证构图。 |
当前内置解码库暂不支持 Nikon Z8 与 Z9 机身中的 HE（高效率）以及 HE*（高效率无损压缩）NEF 编码文件。若使用上述机型翻拍，请在相机机内设置中将 RAW 记录格式调整为标准的“无损压缩 RAW”，或在导入前使用官方免费的 Adobe DNG Converter 批量转换为标准线性 DNG 格式。
针对 8-bit JPEG 格式，由于其在扫描或拍摄阶段已经被相机或扫描软件施加了非线性的 sRGB 色调曲线并裁剪了暗部与高光，导致片基色罩与微弱暗部信号相互混淆。在 NexFilm 中处理此类文件时，若自动反相效果不理想，建议通过“印片灯光”面板手动微调三通道曝光增益进行补偿。
# 有界代理架构与低内存极速索引
在处理整卷 36 张 6000 万像素相机 RAW 文件或 4×5 大画幅超高分辨率 TIFF 扫描件时，传统修图软件往往会在导入阶段启动全局全图解码，导致数十 GB 的内存被瞬间吞噬、CPU 满载、风扇狂转并引发长时间的界面冻结。
NexFilm 重构了这种传统模型，全面采用双阶有界代理架构（Two-Stage Bounded Proxy Architecture）：
- 第一阶段：轻量元数据快速注册与内嵌预览提取 用户选择文件夹并点击导入时，引擎仅扫描文件头，以零解算开销提取文件中已预先生成的内嵌缩略图（Embedded Preview）与 Exif 拍摄元数据，并在本地数据库中建立轻量索引。这一过程使得数百张高分辨率照片可在 2 到 3 秒内完成入库并在“图库”中呈现完备网格，整个应用常驻内存仅占用不到 200 MB。
- 第二阶段：进入工作台时按需生成有界高精度代理
只有当用户双击某张底片进入“工作台”时，后台计算引擎才按需唤起全管线解码器，针对该画面计算长边限定为
2560 px的高质量工作代理图（Bounded Proxy）。该代理图能够充分满足 4K 乃至 5K 显示器上的实时交互精修需求，同时将实时调色计算的纹理显存牢牢锁定在极低水平。
在最终执行“导出”时，引擎会跳过代理图，重新从磁盘流式读取原始源文件，以最高位深和全分辨率物理执行完整的调色与锐化矩阵计算，确保成片画质毫无妥协。
# 三态导入工作流与元数据注入
为了适应摄影师在不同场景下的摄录习惯，NexFilm 提供了完备的三态导入工作流，在文件入库的源头即赋予其严谨的暗房归档属性：
1. 按卷导入（Import as Roll）
此模式是暗房标准化作业的首选流程，专为按卷冲洗、翻拍或扫描的成套素材量身定制：
- 打开导入对话框，选择“按胶卷导入”。
- 全画幅谱系选择：系统内置覆盖主流银盐格式的画幅预设：
- 135 全画幅（35mm）、135 半格（Half-frame）、APS；
- 120 中画幅全系列：
120 (645)、120 (6x6)、120 (6x7)、120 (6x9)、120 (6x12)、120 (6x17)； - 大画幅座机：
4x5、5x7、8x10。
- 设备与乳剂档案注入：选择或输入拍摄机身（如 Leica M6、Hasselblad 503CW）与胶卷型号（内置柯达 Gold 200、Portra 系列、富士 C200、伊尔福 HP5 Plus、电影卷 5219 等全系参数，并支持添加自定义型号）。
- 时间与胶卷备注（Roll Notes）：录入拍摄日期与自由文本备注（例如“第 03 卷、E100 增感一档、黄昏棚拍”）。这些信息将成为后续批量重命名模板与导出 Exif 标签的物理源。
2. 散张导入
适用于单张扫描排查、临时镜头测试片或不希望归入特定胶卷项目的散落底片：
- 点击导入对话框中的“散张导入”，或直接将一个或多个图像文件拖拽至主窗口中央。
- 散张导入的画面独立存在于图库中，拥有完备的单帧物理反相与微调能力，但默认不强制绑定胶卷元数据，也不参与整卷物理标定。
- 软件具备强大的重复导入识别机制：当拖入的文件路径已存在于当前项目时，系统会自动跳过重复项，防止索引冗余。
3. 追加画面至已有胶卷（Append to Roll）
当一卷胶卷因分段翻拍或补扫而产生新文件时，用户无需新建胶卷，只需在“历史胶卷记录”中选中目标胶卷并点击“继续编辑胶卷”，随后通过右上角的“导入胶卷”选择新文件，新素材即可无缝追加进该卷的现有底片条末端，继承相同的机身与乳剂上下文。
# 历史胶卷记录多维筛选与归档管理
点击顶栏的“历史胶卷记录”即可进入本地数字胶片档案库。随着拍摄项目的日积月累，这里将清晰归档用户处理过的每一卷底片资产。
Rolls 视图的核心功能包括：
- 左侧多维组合筛选器：左侧面板支持按“画幅”（全画幅谱系分类）、“相机机身”以及“拍摄日期”进行交集组合筛选。面板顶部实时更新显示当前筛选条件下的确切胶卷数与画面总数，点击 Clear 按钮可一键复位筛选。
- 胶卷卡片摘要矩阵：右侧以画册式网格陈列胶卷卡片，直观呈现每卷的封面缩略图、总张数、画幅标签、相机、胶卷型号与创建日期。
- 胶卷详情与操作中枢：选中某卷进入胶卷内容视图后，可展开全卷底片微缩阵列，并执行以下关键动作：
- 提升至图库（Promote to Library / 加入图库）：将该归档卷的所有画面载入当前活跃图库，方便重新进入工作台精修。
- 编辑胶卷信息（Edit Info）：支持随时修正或补充相机型号、胶卷名称、日期以及详细的胶卷备注，修改后将自动同步至未来导出的 Exif 元数据中。
- 导出接触印样：一键生成带有物理齿孔、片边字码与卷标头的数字暗房接触印样。
- 删除胶卷记录：点击删除时，系统会弹出双重安全选择：仅从 NexFilm 本地数据库中注销该卷索引，或者在注销索引的同时将磁盘上的原始文件移入操作系统废纸篓。选择后者时，若某些源片同时被其他项目引用，系统将安全保留原文件，杜绝误删风险。
# 源文件离线与定位文件断链修复
NexFilm 始终践行轻量化与非破坏性设计原则：软件绝不复制或挪动用户的原始素材文件。在数据库 nexfilm_user.db 中，仅记录了源文件在本地文件系统中的绝对物理路径。
当用户在操作系统中重命名了存放底片的文件夹、移动了目录结构，或者拔出了外置移动硬盘时，工作台与图库中对应的画面会进入“离线脱机状态”：
- 画面卡片上会出现明显的警告图标，提示“文件路径未找到”。
- 得益于有界代理机制，画面的本地缓存缩略图依然可以正常浏览，但无法进行全分辨率导出或重新计算反相。
断链修复流程（Locate File）：
- 选中处于脱机状态的画面，点击界面上弹出的 定位文件 操作按钮。
- 在系统文件浏览窗口中，定位至该文件当前所在的新路径并点击确认。
- NexFilm 底层引擎会自动校正该记录的绝对路径，并智能探测同目录下其他同样处于脱机状态的相邻画面。若文件名与序列匹配，引擎将自动批量修复整卷的路径关联，无需用户逐张手动重新查找。
通过严密的格式矩阵支持、零内存压力的代理架构以及稳健的档案管理机制，NexFilm 为严肃胶片摄影师构筑了一套值得长期信赖的数字化资产基石。