Skip to content

Plots pixel value curve for images/videos (entire or ROI). | 测量一组照片或一个视频各帧(ROI或全帧)的像素平均值并绘制为折线图

License

Notifications You must be signed in to change notification settings

GarthTB/PixelValueCurve

Repository files navigation

📸 Pixel Value Curve 像素值曲线工具 📈

README English 用前必读 中文 开发框架 .NET 9.0 最新版本 1.1.0 开源协议 Apache 2.0

概述

Pixel Value Curve 是一个高性能的 C# 控制台应用程序, 专为图像和视频帧分析而设计。 它能自动测量图像或视频帧中指定区域(ROI)的像素值, 支持多种色彩空间指标, 并将结果导出为同目录下的 CSV 文件或可视化图表。

核心功能:从图像序列/视频中提取像素数据 → 转换为指定色彩通道 → 计算平均值 → 生成数据报告和可视化图表

特点

  • 极速处理:基于 OpenCV 开发,充分利用多核 CPU,高效处理大型图像/视频
  • 🎯 精确测量:使用每像素每通道32位浮点数保证处理精度
  • 📁 广泛格式支持
    • 图像:JPEG、PNG、TIFF、BMP、WebP 等
    • 视频:MP4、AVI、MOV、MKV 等主流格式
  • 🤖 自动化友好:通过 TOML 配置文件操作,无其他交互
  • 📊 双输出模式:同时生成 CSV 数据和 PNG 图表
  • 🌈 多色彩空间支持:可选 10 种目标指标
色彩空间 支持的指标
L*a*b* L (明度)
HSL L (亮度), S (饱和度)
HSV I (强度)
HSI H (色相), S (饱和度), V (明度)
RGB R, G, B (三通道)

技术栈

快速开始

系统要求

使用步骤

  1. Release页面 下载发行包
  2. 完整解压发行包
  3. 调整程序同目录中的 config.toml 以控制程序运行
  4. 运行程序:
    • 直接运行 PixelValueCurve.exe(结束后立即退出)
    • 命令行运行:.\PixelValueCurve.exe

注意事项

  • 待测文件夹内的所有图片/视频文件都会被分析;若是图片,则只分析一次;若是视频,则每个视频文件分析一次
  • 待测文件夹内除待测文件外不能包含其他文件(包括输出的csv文件和png折线图)
  • 由于 OpenCV 底层限制,有多种格式、通道数、位深的组合不支持色彩空间转换,从而导致程序直接中断

关于

更新日志

v1.1.0 (2025-06-12)

  • 修复:多种图片位深的支持

v1.0.0 (2025-06-12)

  • 初始版本

About

Plots pixel value curve for images/videos (entire or ROI). | 测量一组照片或一个视频各帧(ROI或全帧)的像素平均值并绘制为折线图

Topics

Resources

License

Stars

Watchers

Forks

Languages