使用手册

按真实界面逐项说明:每个面板在哪、每个控件什么意思、快捷键怎么用。安装与激活见 安装文档。

1. 简介与适用范围

FFF digital Lab 是面向 FlexColor / Flextight 产生的 FFF 扫描文件的 macOS 校正与出片软件。它把胶片扫描的校正工作流带到现代 macOS:Apple 芯片原生、全程离线、色彩管理对齐 FlexColor。

软件处理的是 .fff 文件本身,不是扫描仪驱动。没有 FlexBox 时,它就是一个完整的 FFF 后期工具;接了 FlexBox 之后,它还能直接驱动 1394 时代的 Flextight 扫描仪完成预览与扫描。

两个前提:① 文件必须是合法 FFF(含 0xC519 设置块、IFD 可读);改后缀的 TIFF 或残缺文件不会进文件列表。② 所有处理都在本机完成,不联网、不上传影像。

2. 运行环境

  • ✓硬件:Apple 芯片(arm64)Mac;内存建议 8 GB 及以上(批量导出大文件时更明显)。
  • ✓系统:macOS 13 及以上。
  • ✓网络:不需要联网。激活是本地离线验签。只有用 FlexBox 扫描时才需要局域网。
  • ✓安装:把 FFF digital Lab.app 拖进「应用程序」。首次打开若被 Gatekeeper 拦,右键 →「打开」,或执行安装文档里的 xattr 命令。

3. 界面总览

主窗口从上到下、从左到右分五个区域。下面逐块说明。

  • ✓顶栏第一行:中文 / English 语言切换、授权状态、激活按钮、FlexBox 管理(付费档起)、片夹管理。
  • ✓顶栏第二行:工作目录(点标题在访达打开)、选择目录…、扫描目录、打开预设目录、预设下拉、应用预设、恢复默认、自动校准、自定预设名、存到当前 fff、保存本地预设。
  • ✓顶栏第三行:导出当前预览(框选范围)、输出 DPI、保存 8bit(Cmd+S)、保存 16bit(Cmd+Shift+S)、裁单张 FFF(Cmd+Option+S)、默认保存目录、当前预设、批量导出 16bit-tif、状态栏。
  • ✓左栏「文件」:全选 / 全不选 / 反选、缩略图列表、每张左上角的批量勾选框(单击整项 = 选中该文件)。
  • ✓中栏预览:像素信息条(坐标 / 色块 / RGB / 缩放提示)、吸管(黑点 / 灰点 / 白点)、100% 显示与画笔除尘、背景(黑 / 灰 / 白)、旋转角度、镜像、右转 / 左转。
  • ✓右栏「参数」:校正一致性 → 校准 → 显示 → 直方图 / 色阶 → 层次 → 渐变曲线 → 颜色 → 质感。面板自上而下滚动。

4. 五分钟上手

1. 点「选择目录…」选一个装着 .fff 的文件夹,软件会自动列文件(「扫描目录」可手动重扫)。
2. 在左栏点一张。文件在后台装载,顶部有进度条;旧预览会保留到新图就绪,不会黑屏。
3. 先点「恢复默认」——它会读回该文件自带的预设;或在预设下拉里挑一个内置预设,「应用预设」。此时预览已经是校正后的结果。
4. 在右栏「直方图 / 色阶」里拖动黑 / 灰 / 白三角;需要更细再动「层次」「渐变曲线」「颜色」。改动即时生效,没有单独的「渲染」按钮。
5. 想只调某一格:在预览里拖一个矩形框(ROI)。直方图只统计框内,导出也只出框内。
6. Cmd+S 导出 8bit TIFF,Cmd+Shift+S 导出 16bit。文件名自动编号,不会覆盖已有文件。

整卷 135 的常见做法:先在一格上把 ROI 调到刚好,之后只移动框、不改尺寸,逐格导出或逐格裁成独立 FFF——每格尺寸完全一致,后期拼接不用再对齐。

5. 工作目录与文件列表

  • ✓工作目录是只读的,只能靠「选择目录…」设置;点标题「工作目录:」会在访达里打开它。下次启动会记住上次的目录。
  • ✓扫描目录只重扫当前工作目录,与「从扫描仪扫描」无关。只收真实 .fff:跳过 . 开头的条目(如 exFAT / SMB 生成的 ._x.fff),跳过改后缀的 TIFF 或缺 0xC519 的垃圾文件。
  • ✓重扫不会打断当前会话:选中文件、ROI、活跃预设、预览都保持;只有原文件真的不在了才回落到第一张。
  • ✓缩略图后台渲染,启动时算一次;想看更新后的缩略图,点一次「扫描目录」即可。
  • ✓每张左侧的勾选框用于批量导出,默认全选;上方的「全选 / 全不选 / 反选」批量操作。
  • ✓切到另一张文件会清空 ROI(不同文件不复用选区),并重新读入该文件自带的设置。

6. 预览区:取点 / 缩放 / 旋转 / 框选

  • ✓像素信息条:鼠标移到预览上即显示「像素 (x,y) + 色块 + RGB」。如果开了色彩管理,这里显示的是显示空间的值。
  • ✓缩放:触控板双指捏合,或按住 Cmd 滚动;范围约 0.05×–8×。
  • ✓吸管:黑点 / 灰点 / 白点三个模式。选中后到预览上点一下即可取点(黑 / 白点落进反相曲线空间,灰点走完整校正链——与 FlexColor 的取样一致)。吸管与「100% 检视 / 除尘」互斥,三者都用预览上的点击。
  • ✓背景:黑 / 灰 / 白三档,只影响预览画布底色,写盘持久化。
  • ✓旋转 / 镜像:右转 Cmd+R、左转 Cmd+L,每次 90°(与 FlexColor 一样回绕);「镜像」为水平翻转。旋转会带着 ROI 一起转。
  • ✓框选(ROI):在预览上按下并拖动即画出矩形。松手后直方图只统计框内;导出 TIFF、裁单张 FFF、扫描时的「只扫预览里的框选」都以它为准。再拖一次会重画;没有框选就是整幅。选中框选后,按住 Shift + 方向键 可整体微调位置(按住不放会逐渐加速)——只移动框选并重算直方图,图像像素不动。
    鼠标交互:在框内按住拖动 = 整框平移;边框上的中点手柄 = 缩放;在空白处拖动 = 新建框选;在空白处点一下 = 取消框选。
  • ✓框选是归一化坐标,跟随机旋转 / 镜像;换文件会清空。

7. 参数面板逐项说明

每个面板都有一个「本项生效」复选框(如「色阶/直方图生效」「滑块生效」「启用曲线」「颜色校正生效」「锐化生效」)。它对应写回 FFF 预设时的 Apply* 位:取消勾选 = 这一项不参与校正,也不写进预设。拖动滑块调整影调时,预览反馈几乎是实时的;而且它与最终导出 / 写回的结果高度一致(不像 FlexColor 的实时预览那样只是一个近似效果)。「生效」开关一改立即重渲染。

7.1 校正一致性 / Consistency

这一组和 FlexColor 的「文件 → 设置」对应,是最容易造成「和原厂结果不一致」的地方,所以放在最上面。

  • ✓输入 profile / RGB profile / CMYK profile / Gray profile:四个下拉,都带「(不设置)」。原厂模板里 RGB / Gray 本来就是空名,所以「不设置」是合法状态、必须能回去。
  • ✓暗部增强 (EnhancedShadow):压暗部的非线性增强,对应原厂同名参数。
  • ✓ICM 色彩同步 (Convert):色彩管理总开关。与「显示」面板里的「色彩管理」是同一个开关的两个入口,改一个另一处同步。
  • ✓预览用 CPU 色彩管理(仅本会话):强制走 CPU 路径,用来排查 GPU 与 CPU 结果不一致;只在本次运行有效。
  • ✓软打样 (SoftProof):按目标 profile 模拟输出观感(主要用于屏幕预览)。
  • ✓嵌入 profile (EmbedProfile):决定导出的 TIFF 是否内嵌 profile。

7.2 校准(端点 / 网点色)

  • ✓端点:阴影与高光各可选 常数 / 线性 / 夹取 三种模式。
  • ✓网点(阴影) / 网点(高光):R / G / B 三通道各 0–255。
  • ✓注意:网点色是默认值(0 / 255)时,三种端点模式在数学上完全等价,看不出差别;只有改过网点色,端点的作用才显现。当前文件默认网点色正是默认值,所以这一组多数时候可以不动。

7.3 显示 / Display

色彩管理(预览对齐导出文件) + 下方一行状态文本(显示当前色彩世界 / 回退说明)。

7.4 直方图 / 色阶

  • ✓色阶/直方图生效:本项开关。
  • ✓下面是四个叠加面板:综合 RGB、红 R、绿 G、蓝 B。每个都画:输入直方图(灰填充)、原厂式输出叠加线、以及黑 / 灰 / 白三个三角与固定读数行。
  • ✓综合 RGB 的黑 / 白三角会同时写三个通道;单通道面板只写该通道。综合面板的中间三角是 gamma(读数显示 gamma−1,左边=更大 gamma=更亮);单通道面板中间是各自的黑白灰点(gray)。
  • ✓鼠标悬停像素时,直方图上会画一条对应该像素亮度的竖线,便于对照。
  • ✓自动校准(顶栏按钮):按像素累计比例(约 0.2% 边界)自动设置各通道黑 / 白点,不动灰点 / gamma。这是「AutoCol / 直方图拉伸」的等价做法。
  • ✓12 个数都能直接填:四张图(综合 / R / G / B)× 黑 / 灰 / 白 都有数值框,点进去输入并回车,等效于拖三角。需要精确对齐某个值(例如与别的软件一致)时用它。

7.5 层次 / Levels

  • ✓滑块生效 + 三个滑块:亮度 −100…100、对比度 −100…100、阴影深度 0…30。拖动时松手才重渲染。

7.6 渐变曲线

  • ✓启用曲线:曲线是否参与渲染。
  • ✓通道:全部 / 红 / 绿 / 蓝 / 青 / 品 / 黄,七条独立曲线;切换通道时会自动暂存当前通道,不丢编辑。
  • ✓拖动节点调整;+ 中间点 会在最宽的空隙插入一个点并取当前样条值;重置曲线 把全部通道恢复成两点直线。每条曲线最多 10 个点,且不允许两个点 x 相同。
  • ✓选中节点后可用方向键微调、Tab 跳到下一个节点、Delete / Backspace 删除该节点。

7.7 颜色 / Color

  • ✓颜色校正生效 + 源色下拉(红 / 绿 / 蓝 / 青 / 品 / 黄)。选中源色后,右侧 6 个数值是它对六个目标色的偏移,范围约 ±1000。
  • ✓饱和度:−100…100。这一组处理的是胶片的通道串扰与偏色。

7.8 质感 / Texture

  • ✓锐化生效 + 柔化(−100…400,负值即柔化);降噪上限 0…255。
  • ✓彩噪过滤生效:色彩噪声滤波开关(与「柔化」独立)。

8. 预设

  • ✓下拉里的条目来自四处:内置(随软件附带、来自原厂内置预设)、(fff)(写在这张 FFF 里的预设)、出厂、本地(你自己存的)。
  • ✓在下拉里点一条即立即应用;「应用预设」可再点一次强制应用;「恢复默认」会读回该文件自带的预设并覆盖当前滑块。
  • ✓存到当前 fff:把当前校正写进这张 FFF 的 0xC519 设置块(付费档)。写入前会先丢掉文件缓存,避免截断后旧的 mmap 造成的撕裂;写完后下拉整表重建并选中新条目。
  • ✓保存本地预设:把当前校正另存为可跨文件复用的本地预设(放在用户数据目录的 presets/ 下)。整卷同底片用同一个本地预设,一致性最好。
  • ✓打开预设目录:在访达里管理 / 备份本地预设。随包预设只补缺失,不会覆盖你改过或另存的同名预设。
  • ✓切换界面语言时,预设下拉会整表重建,当前选中项会映射到新语言的同名条目,不会因为语言不同而失配。
  • ✓套预设时的朝向按来源区分:只有本文件的 (fff) 内嵌预设会连同它自己的旋转 / 镜像一起套用(预览真的会转向该朝向);内置 / 出厂 / 本地预设只改外观,不动旋转 / 镜像。

9. 导出

  • ✓单张:保存 8bit(Cmd+S)/ 16bit(Cmd+Shift+S,付费档)。文件名是 <原名>.out8.tif / <原名>.out16.tif,重名时自动加 -1、-2…,绝不覆盖。
  • ✓有 ROI 就出 ROI,没有就出整幅。点击「导出当前预览(框选范围)」一行旁边的按钮即可。
  • ✓输出 DPI:可手填,留空 = 不写 DPI,合法范围 1–65535 的整数。填错会红字提示且不保存(批量导出同样会先校验)。
  • ✓默认保存目录:点一下选目录,之后按钮与快捷键导出的 TIFF 都落到那里;不设则落在源文件同目录。设置会持久化。
  • ✓批量导出 16bit-tif(付费档):导出的就是左栏里勾选的文件,命名 <原名>.tif,输出到你选的目标目录。勾「当前预设」= 用当前滑块覆盖各文件的可调字段;不勾 = 用每个文件自带预设。非法 FFF 或没有可读设置的文件会被跳过并在状态栏报出来。
  • ✓裁单张 FFF(Cmd+Option+S,商用档):把当前 ROI 内的原始设备像素(已烘焙旋转 / 镜像)连当前预设一起,封装成一张完整合法、可独立调色的 <原名>-subcrop.fff,同样自动编号不覆盖。整卷 135 逐格分拆就是靠它。
  • ✓导出是否内嵌 profile 由「嵌入 profile」决定;色彩管理对齐到你的显示器 profile。换显示器后观感不同,先检查系统里该显示器的 profile。

10. 100% 检视与除尘

  • ✓点预览工具栏的「🔍 100% 显示与画笔除尘」打开 100% 检视窗口;在预览上点一下即可把该点钉成 1:1 视图(窗口可拖到任意位置)。窗口内可选 100px / 200px 视野。
  • ✓除尘笔(付费档):在 100% 窗口里点 / 拖落笔。笔径 5–50 px、羽化 0–1;拖动时会显示橙色掩模预览这一笔会覆盖哪里。1–3 px 的灰尘在主预览(降采样再缩放)上看不清,所以必须在这个 1:1 窗口里做。
  • ✓撤销 / 重做(Cmd+Z / Shift+Cmd+Z)、清除全部、写入 FFF,以及当前「落印数」。除尘结果会参与预览与 TIFF 导出;只有点「写入 FFF」才会永久写回该 .fff 文件。
  • ✓除尘笔与「吸管」互斥(两者都用预览/窗口上的点击)。

11. 快捷键

快捷键作用
Cmd+S保存 8bit TIFF(有 ROI 则出 ROI)
Cmd+Shift+S保存 16bit TIFF(付费档)
Cmd+Option+S裁单张 FFF(商用档)
Cmd+R右转 90°
Cmd+L左转 90°
Cmd+Z / Shift+Cmd+Z除尘撤销 / 重做(100% 窗口、除尘笔开启时)
双指捏合 / Cmd+滚轮预览缩放
方向键 / Tab / Delete曲线节点微调 / 切换 / 删除
空格 + 左键拖动平移预览(非吸管模式;按住空格光标变抓手)
Shift + 方向键有框选(ROI)时微调框选位置(按住会加速)

12. 档位与能力对照

能力免费版普通版(付费档)商用版
完整校正链(色阶 / 曲线 / 6×6 颜色 / 层次 / 质感)✓✓✓
预览、实时调整、100% 检视✓✓✓
导出 8bit TIFF✓✓✓
导出分辨率三分之一长边全分辨率全分辨率
导出 16bit TIFF—✓✓
ROI 框选导出 / 批量导出—✓✓
写回 .fff 预设(存到当前 fff)—✓✓
原生画笔除尘(含写入 FFF)—✓✓
FlexBox / 扫描仪交互(预览 · 捕获 · 灯管 · 对焦 · 网络)—✓✓
原生 FFF 裁切分拆(Cmd+Option+S)——✓

月付(¥30 / 月)只对应普通版能力。买断:普通版 ¥359、商用版 ¥499;买断初始含 1 台机器额度,此后每 8 个月 +1 台(不封顶)。FlexBox 盒子赠送同级别永久授权:单机扫描版赠普通版,全血版赠商用版。

13. 激活与授权

  • ✓顶栏显示当前档位:免费 / 已激活(永久)· 付费档 / 商用档 / 已激活(至 日期,剩 N 天)· 档位。
  • ✓点「激活…」打开激活窗口:机器码(可一键复制)→ 到本站登录 →「我的授权」里粘贴机器码生成激活码 → 粘回「激活码」框 →「激活」。验签在本地离线完成。
  • ✓激活码与机器绑定,不提供解绑。月付可以为新机器再分配时长;买断初始 1 台、每 8 个月 +1 台额度,可用新额度为新机器生成新激活码。忘了码也不怕:在「我的授权 → 授权历史」里可随时重看 / 复制。

14. FlexBox 硬件联动

FlexBox 把 1394 扫描仪接到局域网:盒子一侧插扫描仪的 1394 接口,另一侧接入网络;软件通过它发现设备、发送命令、接收扫描数据。这样没有 1394 接口的新 Mac 也能继续使用原有扫描设备。以下功能需要普通版(付费档)起。

14.1 FlexBox 管理

  • ✓发现 / 刷新:扫局域网里的盒子;也可在「手动 IP」里填地址后点「添加」(跨网段 / 广播被挡时用)。
  • ✓每个盒子一行:名字、能力(CAPS)、网络配置…、关机…以及关机进度。
  • ✓每台扫描仪一行:独占 / 释放、预览/扫FFF、灯管、对焦、只读识别…,并显示占用状态(同一台设备同一时间只能被一个会话独占,多盒可并行)。
  • ✓设备列表由盒子上报;「预览/扫FFF」等按钮挂在「已独占」那一行——先独占,再用。

14.2 扫描仪预览 / 扫 FFF

  • ✓扫描目标:片夹 / 片框(列表来自「片夹管理」)、分辨率 %(1–100)、文件名前缀。
  • ✓采集区域:可选「只扫预览里的框选」(用主预览的 ROI)或整片夹;下方显示本次采集区的具体尺寸。
  • ✓用本地对焦数据:勾选则用「对焦数据管理」里保存的本地记录,不勾则用设备 flash 里的值。
  • ✓预设:扫出来的 FFF 直接写入哪个预设(默认当前活跃预设)。
  • ✓预览不落盘;捕获会把结果写到 <工作目录>/<前缀>-NNN.fff(NNN 自动编号)。捕获位置会占用主预览区做逐行实时出图(另有一个进度窗口显示缩略图与行数)。
  • ✓动机构 / 改光学状态的命令会先弹审批:命令、参数、源码出处、机械影响、回退路径,逐条确认后点「确认并发送」。这是安全闸门,不要绕过。

14.3 灯管监视器(原始行)

开始 / 停止、灯光开关,以及采样行数 / 像素数读数与各通道 min / max / mean。用来在正式扫描前确认灯管稳定、读数正常。

14.4 对焦数据管理

  • ✓四件事,按顺序:读取设备 flash(只读) → 生成对焦数据(自适应扫掠) → 写入设备 flash → 需要时 还原原始基线。
  • ✓扫掠参数(自适应):总跨度上界 max_span、起始半程 start_half、每档最多轮数、最小细分步长 min_step、进度回调上限 max_steps。第 1 轮范围 = 设备 flash 值 ± start_half,最多长到 ±max_span。
  • ✓⚠ 扫掠 / 写入 / 还原都会动机构:写入前必须先有 _ORIG 字节级备份(第一步「读取设备 flash」)。每次危险动作都会二次确认才执行。本地对焦记录按时间降序列出,可随时回看。

14.5 片夹管理

  • ✓新建片夹:开口宽 W、高 H(cm)、offset(cm)、名称。offset = 片夹孔位相对外形基准边的下移量;扫描时采集区会整体下移同样距离。
  • ✓选中一条后可改名、删除;可指定它对应的目标片框(扫描窗口里的「片夹 / 片框」就是这张表)。

14.6 网络配置与关机

网络配置:设置 SSID / 密码 / 国家后写入盒子(需盒子固件支持配网帧)。关机:确认后盒子开始关机,进度走完请手动拔掉电源插头。

14.7 允许远程维护(地址上报)

勾选后,盒子每 5 分钟把「串号 + 当前公网 IPv6 + 固件版本」上报到我们的服务器,用于你请求协助时我们直达该盒子排查;关闭即注销(服务端删除该记录)。仅当盒子所在网络有公网 IPv6 时才会上报;IPv4 / NAT 环境不会上报,这不是故障。(仅声明支持该功能的盒子才显示这一项。)

行内状态会显示:未开启:不会上报 / 本机未配置上报地址 / 已开启,但当前网络无公网 IPv6,暂不上报 / 最近上报:成功 / 上次上报失败(网络或服务端问题,会自动重试)。建议日常不要勾选,仅在我们需要协助你排查时临时开启;详见 隐私政策。

15. 常见问题

不需要,也没有这个按钮。任何参数变化都会自动重渲染:调整影调时预览几乎是实时跟随的,而且和最终输出保持一致——不像 FlexColor 的实时反馈那样偏近似。「生效」开关一改立即重渲染。
先选一张文件并等它装载完;装载完成后它才会显示「(先渲染)」以外的东西。若仍为空,检查是不是有 ROI 框在一个全黑/全白的区域。
这是有意设计:不同文件的选区不复用,避免把上一张的框带到下一张。切换文件会清空 ROI。
先确认预览信息条里的色彩管理状态与「嵌入 profile」设置;再用支持色彩管理的软件打开 TIFF。换显示器后观感不同,先检查系统里该显示器的 profile。
被跳过的是读不出主图或读不到设置块的文件(非法 FFF / 残缺文件),状态栏会逐个报出路径。它们进不了文件列表时也会被「扫描目录」过滤掉。
不点「写入 FFF」就只影响当前预览与导出,原始 .fff 不变。点了「写入 FFF」才会把除尘结果写回该文件。
只收合法的 FFF(含 0xC519 设置块、IFD 可读)。改后缀的 TIFF、AppleDouble 的 ._x.fff、残缺文件都不会进列表。
登录后在「我的授权 → 授权历史」里,每条签发记录都能重新查看和复制完整激活码。

16. 数据位置与卸载

  • ✓用户数据目录:~/Library/Application Support/FFF digital Lab/。里面有上次的工作目录(last_dir.txt)、语言(lang.txt)、预览背景(view_bg.txt)、默认保存目录(save_dir.txt)、本地预设(presets/)与随包预设存储。
  • ✓把应用拖进废纸篓即可卸载;卸载不会删除上面的数据。要彻底清除,手动删掉该目录。
  • ✓随包预设会在升级后自动补上缺失的文件,不覆盖你自己改过 / 另存的同名预设。

← 回到安装文档