Lut2Photo使用说明及下载🔗

偷光你的小鱼干

Lut2Photo Android应用版本

一个功能强大的Android LUT图片处理应用,支持批量处理、实时文件夹监控、GPU加速和丰富的水印功能。

⏬ 网盘下载链接


📚 使用指南

快速开始

1. 初始设置

  1. 下载安装应用
  2. 授予权限
    • 存储权限(必需)
    • 通知权限(推荐)
    • 后台运行权限(文件夹监控必需)
  3. 关闭电池优化(文件夹监控必需)
  4. 导入Lut文件(可多选导入)

2. 单次批量处理

  1. 进入手动处理页面
  2. 点击选择图片,从相册选择要处理的图片
  3. 点击选择LUT,选择要应用的LUT文件
  4. 点击选择输出文件夹,设置保存位置
  5. 调节处理参数(可选)
  6. 设置水印(可选)
  7. 点击开始处理

3. 文件夹监控设置

  1. 进入文件夹监控页面
  2. 设置输入文件夹(相机上传文件夹)
  3. 设置输出文件夹(处理后保存位置)
  4. 选择LUT文件
  5. 调节处理参数
  6. 设置水印(可选)
  7. 开启文件夹监控开关

4. LUT 管理

  1. 进入LUT管理页面
  2. 点击导入按钮
    • 支持单个或多个文件导入
    • 支持 .cube 和 .vlt 格式
    • 自动转换为 33 位 LUT
  3. 管理已导入的 LUT
    • 点击选择 LUT 文件
    • 支持多选操作
    • 查看 LUT 详细信息
  4. 导出 LUT 文件
    • 导出 CUBE:导出为 .cube 格式(通用格式)
    • 导出 VLT:导出为 .vlt 格式(松下相机专用)
    • 支持批量导出
  5. 删除不需要的 LUT
    • 点击删除按钮
    • 确认后删除

内置 LUT

  • 内置富士胶片模拟 LUT,感谢 小红书@JC’s here 制作(srgb 转 rec2020.flog2)
  • 内置 sRGB 转 rec.709 Lut
  • 内置 Vlog 转 rec.709 Lut

5. 联机拍摄模式

  1. 准备工作

    • 使用 USB OTG 线连接相机和手机
    • 确保相机支持 PTP/MTP 模式
    • 设置好输入文件夹(照片保存位置)
  2. 启动联机模式

    • 在主页找到”联机拍摄”卡片
    • 打开”启用联机拍摄”开关
    • 等待相机连接(状态显示”相机已连接”)
  3. 拍摄流程

    • 在相机上正常拍摄
    • 照片自动下载到手机
    • 打开文件夹监控开关
    • 自动应用 LUT 处理
    • 处理后的照片保存到输出文件夹
  4. 高级设置

    • 点击”联机设置”按钮
    • 配置下载选项
  5. 注意事项

    • 保持 USB 连接稳定
    • 确保手机电量充足
    • 建议使用高速 USB 3.0 线

支持的相机品牌(来自libgphoto2):

  • 松下(Panasonic)
  • 索尼(Sony)
  • 佳能(Canon)
  • 尼康(Nikon)
  • 富士(Fujifilm)
  • 其他支持 PTP/MTP 的相机

📝todolist

⌛计划内

  • 接入usb设备后自动处理usb设备内的图片

✅已完成

  • .vlt格式支持
  • .vlt与.cube格式互转
  • 无实时预览的图片联机拍摄

⭕评估中

  • 透过hdmi采集卡实现的实时预览

⛔已放弃

- 通过usb实时监看与控制:过度占用带宽,且对相机处理器要求比较高

🚀 主要特性

🎯 核心功能

  • 实时文件夹监控:自动检测新文件并立即处理
  • 批量图片处理:支持同时处理多张图片
  • 双引擎处理:CPU/GPU双重处理引擎,智能回退机制
  • 双Lut处理:可选叠加第二个Lut效果
  • 实时预览:可实时预览lut和水印的应用效果
  • NDK/JNI内存管理:绕开jvm内存限制,支持超大像素图片处理
  • 多种抖动算法:Floyd-Steinberg、随机抖动,有效减少色彩断层
  • 可调节效果强度:0-100%强度调节,支持精细控制
  • 高质量输出:50-100%质量范围,平衡文件大小与画质

🎨 水印系统

  • 文字水印:支持EXIF变量替换,自定义字体、颜色、位置
  • 图片水印:支持PNG/JPG水印图片,可调透明度和尺寸
  • 边框功能:四边独立边框控制,0-150%宽度可调
  • 高级排版:行间距、字间距、对齐方式等精细控制

📖 详细说明水印设置参数详解

🎞️ 胶片颗粒效果

  • 真实胶片模拟:基于真实胶片扫描数据的颗粒纹理
  • 多种颗粒类型:支持不同胶片类型的颗粒效果
  • 强度可调:0-100%颗粒强度,精细控制效果
  • 智能混合:根据图片亮度智能调节颗粒分布
  • GPU加速:使用着色器实现高效颗粒渲染

📖 详细说明胶片颗粒参数详解

🔧 技术特性

  • GPU加速处理:OpenGL ES 3.0着色器加速,大幅提升处理速度
  • 内存优化:智能图片压缩,防止大图OOM崩溃
  • 全屏预览:支持双指缩放、拖动的专业图片查看体验
  • MVVM架构:清晰的分层架构,易于维护和扩展
  • Material 3设计:动态颜色主题,现代化UI
  • 无网络权限:完全离线工作,保护用户隐私

🔧 核心功能详解

LUT处理引擎

GPU处理器(推荐)

技术实现

  • 使用OpenGL ES 3.0着色器进行并行计算
  • 支持3D LUT纹理查找,精度更高
  • 二维分块处理,突破GPU纹理尺寸限制
  • 自动回退到CPU处理,确保兼容性

性能优势

1
2
3
4
测试设备:骁龙8e
图片尺寸:4000x6000
GPU处理:~0.8秒
CPU理:~15秒

CPU处理器(备用)

技术实现

  • 纯Kotlin实现,无需外部依赖
  • 三线性插值算法,确保色彩过渡平滑
  • 多线程并行处理,充分利用CPU核心
  • 内存优化,避免大图OOM

水印系统

水印系统支持文字水印、图片水印和边框功能,提供丰富的自定义选项:

  • EXIF变量替换:支持 ISO、光圈、快门、相机型号等 15+ 种变量
  • 自定义字体:支持导入 TTF/OTF 字体文件
  • 精细控制:位置、大小、透明度、颜色等参数可调
  • 多种格式:支持 PNG、JPG、WEBP 水印图片
  • 边框功能:四边独立控制,智能比例计算

批量处理与文件夹监控

批量处理特性

  • 多图片同时选择:支持从相册一次性选择多张图片
  • 进度显示:实时显示处理进度和剩余时间
  • 并行处理:CPU模式下支持最大5个图片同时处理
  • 错误处理:单个图片失败不影响整体进度

文件夹监控机制

工作原理

  1. 实时扫描:每2秒扫描一次输入文件夹
  2. 文件过滤:仅处理JPG/JPEG/PNG/WEBP格式
  3. 完整性校验:检测文件是否上传完成
  4. 去重处理:防止同一文件被多次处理

错误恢复

  • 重试机制:不完整文件最多重试10次
  • 内存管理:自动释放无用内存,防止内存泄漏
  • 电源管理:获取WakeLock,防止系统休眠中断处理

⚙️ 设置详解

处理器设置

处理器类型选择

选项描述适用场景性能表现
AUTO(推荐)自动选择最优处理器适合新手用户GPU可用时优先使用GPU
GPU强制使用GPU处理高性能需求最快,但部分设备不支持
CPU强制使用CPU处理兼容性优先较慢,但兼容性最好

GPU可用性检测

应用会自动检测设备的GPU能力:

  • OpenGL ES 3.0支持检测
  • 3D纹理支持验证
  • 着色器编译测试
  • 内存容量评估

处理参数

效果强度(Strength)

  • 范围:0-100%
  • 默认值:60%
  • 作用:控制LUT效果与原图的混合比例

输出质量(Quality)

  • 范围:50-100%
  • 默认值:90%
  • 影响:输出文件大小和画质

抖动算法(Dithering)

算法描述适用场景计算复杂度
无抖动不使用抖动算法大图片,追求速度最低
Floyd-Steinberg经典错误扩散算法追求高质量过渡
随机抖动基于随机噪声的抖动平衡处理速度与质量

⚠️ 注意:抖动算法主要用于减少色彩断层,对于高质量原图可能效果不明显,触发分块算法会强制应用随机抖动。

水印配置

水印系统提供丰富的配置选项,支持文字水印、图片水印和边框功能的精细控制。

📖 详细配置说明水印设置参数详解

文件夹监控设置

基本配置

项目说明注意事项
输入文件夹监控的源文件夹需要读取权限
输出文件夹处理后的图片保存位置需要写入权限
LUT文件使用的LUT文件仅支持.cube格式
监控开关启用/停止文件夹监控开启后后台运行

高级选项

  • 处理参数:与批量处理不同的强度、质量、抖动设置
  • 水印配置:与批量处理相同的水印参数
  • 文件命名:自动按照原文件名-LUT名.jpg格式命名

后台运行保障

为了确保文件夹监控服务稳定运行,应用实现了多重保障机制:

  1. 前台服务:使用Foreground Service确保高优先级
  2. WakeLock:防止系统休眠中断处理
  3. 开机启动:支持开机自动恢复监控
  4. 崩溃恢复:应用崩溃后自动重启监控
  5. 通知提醒:实时显示监控状态和处理进度

🎨 使用场景

专业摄影应用

相机制造商支持

  • 松下:使用LUMIX Sync边拍边传以及机内lut监看搭配本应用
  • 索尼:配合Imaging Edge Mobile实现实时LUT处理
  • 佳能/尼康:通过相应应用传输后自动处理
  • 其他 :可监控文件夹然后直接从读卡器等设备复制快速应用

📡 技术支持

技术栈

  • 开发语言:Kotlin
  • 框架:Android Jetpack,Material Design 3
  • 架构:MVVM + Repository Pattern
  • 图形处理:OpenGL ES 3.0,Canvas API
  • 并发处理:Kotlin Coroutines
  • 数据存储:SharedPreferences,DocumentFile API

贡献与反馈

Bug 报告和问题反馈

如果您在使用过程中遇到问题,请按照以下步骤提交反馈:

1. 启用 Logcat 捕获

  • 打开应用,进入”设置”页面
  • 找到”Logcat 捕获”卡片
  • 打开”启用 Logcat 捕获”开关
  • 应用会自动记录系统信息和运行日志

2. 复现问题

  • 在开启 Logcat 捕获后
  • 重新操作导致问题的步骤
  • 确保问题被记录到日志中

3. 分享日志文件

  • 在”Logcat 捕获”卡片中
  • 点击”分享日志文件”按钮
  • 选择分享方式
  • 将日志文件发送给开发者

4. 提交 Issue

  • 访问 GitHub Issues
  • 点击”New Issue”
  • 描述问题:
    • 问题现象
    • 复现步骤
    • 设备型号和 Android 版本
    • 附上日志文件
  • 提交 Issue

注意事项

  • 日志文件包含应用运行信息,不包含个人隐私
  • 提交反馈后可关闭 Logcat 捕获以节省存储空间
  • 关闭开关会自动删除所有日志文件

功能建议

  • 欢迎在 GitHub 上提出 Feature Request
  • 描述您期望的功能和使用场景
  • 我们会认真考虑每一个建议

🙏 开源库鸣谢

本项目使用了以下优秀的开源库,感谢所有开源项目的贡献者!

Android Jetpack 组件

  • Core KTX 1.16.0 - Android KTX 核心扩展
  • AppCompat 1.6.1 - Android 兼容性支持
  • Material Components 1.12.0 - Material Design 3 组件
  • Lifecycle 2.9.2 - 生命周期管理
  • Navigation 2.7.6 - 导航组件
  • WorkManager 2.9.0 - 后台任务管理
  • ExifInterface 1.3.7 - EXIF 信息读写
  • Palette 1.0.0 - 颜色提取

Kotlin 生态

  • Kotlin 2.0.21 - 主要开发语言
  • Kotlin Coroutines 1.10.2 - 协程支持

图片处理

UI 组件

工具库

原生库

构建工具

  • Android Gradle Plugin 8.11.2
  • CMake 3.22.1 - 原生代码构建
  • Android NDK 29.0 - 原生开发工具包

许可证说明

  • 本项目主要使用 Apache 2.0、BSD、MIT 许可证的库
  • libgphoto2 和 libusb 使用 LGPL v2.1 许可证
  • pinyin4j 使用 GPL v2 许可证
  • 所有使用均遵守各自的许可证条款

其他

本App免费使用,如果有帮到你,可以在设置页找到赞助码🍵

作者:偷光你的小鱼干(某些情况下也叫狸花饺子喵、Alittlecookie)


🌟 喜欢这个项目吗?记得给个 Star ⭐

📖 项目地址https://github.com/qh7574/Lut2Photo-Android

  • 标题: Lut2Photo使用说明及下载🔗
  • 作者: 偷光你的小鱼干
  • 创建于 : 2025-12-04 12:08:13
  • 更新于 : 2025-12-12 16:41:18
  • 链接: https://alittlecookie.cn/2025/12/04/Lut2Photo使用说明及下载🔗/
  • 版权声明: 本文章采用 CC BY-NC-SA 4.0 进行许可。
评论