Skip to content

测量一组图片中全图或特定ROI中的像素值并输出为折线图 | Plots brightness curve for a set of photos (entire or ROI).

License

Notifications You must be signed in to change notification settings

GarthTB/lightness-curve

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📸 Lightness Curve 图像亮度变化测量工具 📊

README English 用前必读 中文 开发语言 Rust 最新版本 0.2.0 开源许可 Apache 2.0

用Rust编写的轻量级高性能工具,用于分析图像序列中特定区域或全图的亮度变化,支持多种色彩空间指标,结果可导出为CSV数据或SVG折线图。

功能特性

  • ⚡ 超高性能:使用并行处理技术,一分钟内处理上千张ZIP压缩的4K8位TIFF图像
  • 📦 零运行时依赖:静态编译的单一可执行文件
  • 🖼️ 广泛格式支持:JPEG、PNG、BMP、TIFF、WebP等
  • 🔍 ROI支持:可分析特定区域或整张图像
  • 🎚️ 多指标支持:
    • RGB平均值 (RGB Avg)
    • 视觉加权亮度 (Luminance)
    • 单独通道 (R, G, B)
    • HSV空间 (Hue, Saturation, Value)
  • 📊 灵活输出:CSV表格或SVG矢量图表
  • 🤖 自动化友好:无交互界面,全配置文件驱动

快速开始

1. 获取程序

Release页面下载预编译二进制文件

或使用Cargo编译:

cargo install lightness-curve

2. 配置文件

在程序同目录创建config.toml文件,完整配置示例如下:

image_dir = "C:/test/input_images"  # 待测图像所在文件夹
order_by = 0  # 输入图像的重排序方式;0:文件名,1:创建时间,2:修改时间
descending = false  # 是否按降序重排序
mode = 0  # 待测指标;0:RGB平均值,1:RGB视觉加权明度,2:R,3:G,4:B,5:H,6:S,7:V
# top_left_x = 0  # ROI的左上角x坐标;若无需截取ROI,可注释掉
# top_left_y = 0  # ROI的左上角y坐标;若无需截取ROI,可注释掉
# width = 0  # ROI的宽度;若无需截取ROI,可注释掉
# height = 0  # ROI的高度;若无需截取ROI,可注释掉
output_data_path = "C:/test/output_data.csv"  # 输出数据文件的路径;若无需输出数据文件,可注释掉
output_plot_path = "C:/test/output_plot.svg"  # 输出折线图的路径;若无需输出折线图,可注释掉

3. 运行程序

./lightness-curve

性能测试

测试环境:Intel(R) Core(TM) i5-12500H 2.50 GHz / 16GB RAM / Windows 11 26100.4061

图像信息:3840x2160,8位RGB 3通道 TIFF,ZIP压缩,每张图像约38MB

图像数量 ROI尺寸 待测指标 处理时间(秒)
100 全图 RGB平均值 3.28
100 全图 H 3.35
100 1920x1080 RGB平均值 3.21
624 全图 RGB平均值 22.70
624 1920x1080 RGB平均值 23.67

注意事项

  • 输出SVG折线图时,纵坐标的精度无法调节,只能显示至小数点后一位
  • 不能处理RAW格式图像,需先转换为常用格式

更新日志

v0.2.0 (2025-06-08)

  • 修复:Alpha通道处理错误
  • 修复:将输出文件读取为待测图像的错误
  • 优化:加长SVG折线图的长度

v0.1.0 (2025-06-07)

  • 初始版本

About

测量一组图片中全图或特定ROI中的像素值并输出为折线图 | Plots brightness curve for a set of photos (entire or ROI).

Topics

Resources

License

Stars

Watchers

Forks

Languages