计算机视觉图像处理机器学习【免费下载链接】opencv_contrib项目地址https://gitcode.com/gh_mirrors/ope/opencv_contrib点击查看免费下载本教程对应 opencv_contrib 仓库modules/viz模块的官方示例 histo3D.cpp 及其配套文档 histo3D.markdown。你将学习如何用cv::calcHist计算图像的三维颜色直方图、将其归一化后用cv::viz::WCube小立方体在 3D 可视化窗口中渲染出来并通过自定义键盘回调与滑动条实时调节显示阈值。读完本文你可以掌握彩色图像 → 三维直方图 → Viz 交互式 3D 渲染的完整闭环以及 Viz 窗口与imshow窗口协同工作的关键技巧。本教程目标为 Viz 窗口编写自定义键盘回调函数registerKeyboardCallback在 Viz 窗口中展示三维直方图使用viz::WCube渲染每个直方图单元掌握Viz3d::spinOnce与cv::waitKey混用使 Viz 窗口与imshow窗口同时响应键盘事件。该教程位于教程序列prev_tutorial{tutorial_creating_widgets}即 创建自定义 Widget 的下一课建议先了解 Widget 的创建与展示机制。环境与编译前提示例代码顶部使用#ifdef HAVE_OPENCV_VIZ保护了 Viz 相关代码说明该示例依赖 viz 模块与 VTK 库#ifdef HAVE_OPENCV_VIZ #include opencv2/viz.hpp // ... 主逻辑 ... #else int main(int argc, char **argv) { cout you need VIZ module\n; return 0; } #endif如果构建 OpenCV 时未启用WITH_VTKviz 模块的底层渲染引擎程序会退化为仅打印 you need VIZ module。编译运行示例的标准方式在构建目录中# 假设 opencv_contrib 已作为 extra modules 配置进 OpenCV 构建 make opencv_viz ./bin/example_viz_histo3D # 使用内置合成图像 ./bin/example_viz_histo3D /path/to/image.png # 使用任意彩色图像程序整体结构与数据组织程序核心是一个把数据 状态 窗口句柄打包在一起的结构体Histo3DData所有回调都通过void*指针访问它struct Histo3DData { Mat histogram; // 三维直方图CV_32F32×32×32 int seuil; // 滑动条整数值0~100 double threshold; // 实际阈值 seuil / 1e6决定哪些单元被渲染 Ptrviz::Viz3d fen3D; // 3D 可视化窗口句柄 int nbWidget; // 已生成的 Widget 计数 bool status; // 是否需要重绘直方图 double maxH; // 直方图最大值用于归一化立方体尺寸 int code; // 最近一次键盘按键码 };主流程依次为命令行解析 → 图像准备真实图片或合成图片→ 计算三维直方图 → 创建图像窗口与滑动条 → 创建 Viz 窗口并进入事件循环。命令行参数与合成图像生成使用cv::CommandLineParser解析参数支持-h/--help打印帮助位置参数arg1是彩色图像完整路径CommandLineParser parser(argc, argv, keys); if (parser.has(help)) { parser.printMessage(); return 0; } String nomFic parser.getString(0); Mat img; if (nomFic.length() ! 0) { img imread(nomFic, IMREAD_COLOR); if (img.empty()) { cout Image does not exist!; return 0; } }不传参数时程序生成 512×512 的合成测试图用cv::RNG::fill以正态分布填充四个象限每象限 256×256img Mat(512,512,CV_8UC3); RNG r; r.fill(img(Rect(0, 0, 256, 256)), RNG::NORMAL, Vec3b(60, 40, 50), Vec3b(10, 5, 20)); r.fill(img(Rect(256, 0, 256, 256)), RNG::NORMAL, Vec3b(160, 10, 50), Vec3b(20, 5, 10)); r.fill(img(Rect(0, 256, 256, 256)), RNG::NORMAL, Vec3b(90, 100, 50), Vec3b(10, 20, 20)); r.fill(img(Rect(256, 256, 256, 256)), RNG::NORMAL, Vec3b(100, 10, 150), Vec3b(10, 5, 40));四个象限的像素分布中心分别为B,G,R 顺序第一象限(60,40,50)±(10,5,20)、第二象限(160,10,50)±(20,5,10)、第三象限(90,100,50)±(10,20,20)、第四象限(100,10,150)±(10,5,40)。合成图像保证直方图呈现出四个清晰分离的簇便于直观验证 3D 渲染效果。三维直方图计算calcHist normalize直方图计算是本节的核心。注意通道顺序取{2, 1, 0}目的是与 Viz 坐标轴颜色对齐见下文h.seuil 90; h.threshold h.seuil / 1000000.0; float hRange[] { 0, 256 }; const float* etendu[] { hRange, hRange, hRange }; int hBins 32; int histSize[] { hBins, hBins, hBins }; int channel[] { 2, 1, 0 }; calcHist(img, 1, channel, Mat(), h.histogram, 3, histSize, etendu, true, false); normalize(h.histogram, h.histogram, 100.0/(img.total()), 0, NORM_MINMAX, -1, Mat()); minMaxIdx(h.histogram, NULL, h.maxH, NULL, NULL);关键参数说明参数取值作用channel[]{2, 1, 0}依次统计 R、G、B 通道对应三维的 k、i、j 维度histSize[]{32, 32, 32}每个维度的 bin 数直方图共 32768 个单元hRange{0, 256}像素值范围归一化目标100.0/(img.total())将计数归一化到每百万像素中该单元占比量级归一化使 512×512 图像total262144下100/262144 ≈ 3.8e-4。因此滑动条初始值 90 对应的阈值90/1e6 9e-5即只有计数超过约 23 个像素262144×9e-5≈23.6的直方图单元才会被显示阈值越高显示的单元越少。最后用minMaxIdx求出直方图最大值存入h.maxH供渲染时把立方体尺寸缩放到x/maxH的比例。图像窗口与滑动条交互式阈值控制利用cv::namedWindowcv::createTrackbar在图像窗口上放置阈值滑动条封装成AddSlidebar辅助函数void AddSlidebar(String sliderName, String windowName, int sliderMin, int sliderMax, int defaultSlider, int *sliderVal, void(*f)(int, void *), void *r) { createTrackbar(sliderName, windowName, sliderVal, 1, f, r); setTrackbarMin(sliderName, windowName, sliderMin); setTrackbarMax(sliderName, windowName, sliderMax); setTrackbarPos(sliderName, windowName, defaultSlider); }在主函数中namedWindow(Image); imshow(Image, img); AddSlidebar(threshold, Image, 0, 100, h.seuil, h.seuil, UpdateThreshold, h); waitKey(30);滑动条回调UpdateThreshold把整数滑块值转换为阈值并触发重绘void UpdateThreshold(int , void * r) { Histo3DData *h (Histo3DData *)r; h-status true; h-threshold h-seuil / 1000000.0; cout Widget : h-nbWidget , h-threshold \n; }滑动条范围 0~100、初始 90滑块值每变化 1阈值变化1e-6。管理双窗口事件循环viz::Viz3d窗口与imshow窗口并存的关键在于spinOnce非阻塞单帧渲染与waitKey交替调用。只有这样才能让键盘事件同时在两个窗口中被捕获h.fen3D makePtrviz::Viz3d(3D Histogram); h.nbWidget 0; h.fen3D-registerKeyboardCallback(KeyboardViz3d, h); DrawHistogram3D(h); while (h.code ! 27) // 27 ESC { h.fen3D-spinOnce(1); // 渲染一帧 Viz 场景并捕获 Viz 窗口键盘事件 if (h.status) DrawHistogram3D(h); // 需要时重绘直方图 if (h.code ! 27) h.code waitKey(30); // 捕获 imshow 窗口键盘事件 }Viz3d::spinOnce(int time, bool force_redraw)的声明见 viz3d.hpptime为事件循环运行毫秒数此处传 1。循环以 ESCASCII 27退出同时作用于两个窗口。registerKeyboardCallback(callback, cookie)的签名在 viz3d.hpp 中定义回调类型为void (*KeyboardCallback)(const KeyboardEvent, void*)。DrawHistogram3D从三维 Mat 到立方体场景获取三维 Mat 的尺寸三维直方图 Mat32×32×32的平面数、行数、列数可通过step1与total获得int planSize (int)h.histogram.step1(0); // 一个平面k 固定的行数×列数 int cols (int)h.histogram.step1(1); // 每行元素数 32 int rows (int)planSize / cols; // 每平面行数 32 int plans (int)h.histogram.total() / planSize; // 平面数 32 h.fen3D-removeAllWidgets(); h.nbWidget 0; if (h.nbWidget 0) h.fen3D-showWidget(Axis, viz::WCoordinateSystem(10));每次重绘前先removeAllWidgets()清空旧场景再添加一个比例 10 的viz::WCoordinateSystem作为坐标轴基准——它的三根轴分别是红X、绿Y、蓝Z这正是前面通道顺序取{2,1,0}的原因让直方图的 R/G/B 维度与坐标轴颜色一一对应。遍历取值并渲染立方体对每个直方图单元用cv::Mat::atfloat(k, i, j)三个索引依次为平面号、行号、列号读取值超过阈值的单元渲染成一个viz::WCubefor (int k 0; k plans; k) { for (int i 0; i rows; i) { for (int j 0; j cols; j) { double x h.histogram.atfloat(k, i, j); if (x h.threshold) { double r std::max(x / h.maxH, 0.1); // 立方体半边长最小 0.1 viz::WCube s(Point3d(k - r / 2, i - r / 2, j - r / 2), Point3d(k r / 2, i r / 2, j r / 2), false, // false 实体填充而非线框 viz::Color(j / double(plans) * 255, i / double(rows) * 255, k / double(cols) * 255)); h.fen3D-showWidget(format(I3d%d, h.nbWidget), s); } } } }渲染细节解读尺寸编码立方体边长r max(x/maxH, 0.1)把直方图计数线性映射到边长max下限保证弱单元依然可见颜色编码viz::Color(j/plans*255, i/rows*255, k/cols*255)让每个立方体的颜色由其在三维网格中的位置决定与坐标轴颜色体系一致Widget 命名每个立方体通过format(I3d%d, h.nbWidget)获得唯一 IDshowWidget(id, widget)的接口见 viz3d.hpp。WCube构造签名min_point, max_point, wire_frame, color与WCoordinateSystem(scale)的定义可分别在 widgets.hpp 与 widgets.hpp 查看。Viz 键盘回调用 / 和 * 实时缩放阈值回调机制与cv::setMouseCallback的鼠标回调原理一致事件对象的code字段保存按键码symbol保存按键字符。KeyboardEvent结构体字段symbol、code、action等定义在 types.hpp。void KeyboardViz3d(const viz::KeyboardEvent w, void *t) { Histo3DData *x (Histo3DData *)t; if (w.action) cout you pressed w.symbol in viz window x-fen3D-getWindowName() \n; x-code w.code; switch (w.code) { case /: // 除以 0.9降低阈值显示更多单元 x-status true; x-threshold * 0.9; break; case *: // 乘以 1.1提高阈值显示更少单元 x-status true; x-threshold * 1.1; break; } if (x-status) { cout x-threshold \n; DrawHistogram3D(*x); } }交互逻辑说明按/threshold * 0.9阈值降低约 10%直方图显示更多单元按*threshold * 1.1阈值升高约 10%直方图显示更少单元按键后置statustrue并直接调用DrawHistogram3D重绘主循环中if (h.status) DrawHistogram3D(h)也会在下一轮循环再次兜底重绘与滑动条不同键盘缩放是乘法式的二者可组合使用滑动条设绝对阈值键盘做相对微调。运行结果与效果验证上图为无参数运行合成图像、阈值 50 时的效果左侧 Viz - 3D Histogram 窗口显示四簇彩色小立方体集群对应四个象限的像素分布红/绿/蓝坐标轴标注三维方向右侧 Image 窗口显示 2×2 分布的合成图像及threshold: 50滑动条。将图片换成你自己的彩色照片即可观察其颜色分布的三维形态。扩展思路与源码速览交互增强可在KeyboardViz3d中扩展更多按键例如方向键旋转相机setViewerPose、s保存截图saveScreenshot相关接口见 viz3d.hpp渲染风格用setRenderingProperty可将立方体切换为线框/点云表示或用setRepresentation全局切换替换数据源把calcHist换成任意三维数据如点云密度统计DrawHistogram3D的遍历逻辑可直接复用相关示例同一模块的 creating_widgets.cpp 演示如何继承Widget3D创建自定义 Widget其教程见 creating_widgets.markdown官方文档线索完整示例代码位于 histo3D.cpp本文所有代码片段均取自该文件的行级标注块command_line_parser、synthetic_image、calchist_for_histo3d、slide_bar_for_thresh、manage_viz_imshow_window、get_cube_size、get_cube_values、viz_keyboard_callback。通过本示例你已掌握 Viz 模块中键盘回调注册、三维 Widget 批量渲染、双窗口事件循环三项核心技能可将其直接迁移到点云可视化、数据立方体分析等更复杂的 3D 场景中。赞分享计算机视觉图像处理机器学习【免费下载链接】opencv_contrib项目地址https://gitcode.com/gh_mirrors/ope/opencv_contrib点击查看免费下载相关推荐OpenCV Viz 三维直方图可视化实战基于 opencv_contrib 的 3D 直方图与交互式窗口开发OpenCV Viz 三维直方图可视化实战基于 opencv_contrib 的 3D 直方图与交互式窗口开发 本篇指南讲解如何利用 opencv_contr计算机视觉图像处理深度学习机器学习Vega 直方图Histogram实战指南基于 bin 变换的分箱统计与交互式可视化Vega 直方图Histogram实战指南基于 bin 变换的分箱统计与交互式可视化 直方图Histogram将连续数值范围切分为若干分箱bin数据可视化基于 OpenCV SFM 模块的场景稀疏三维重建实战从图像序列到 libmv 重建管线与 Viz 可视化基于 OpenCV SFM 模块的场景稀疏三维重建实战从图像序列到 libmv 重建管线与 Viz 可视化 导读 本文围绕 opencv_contrib 仓库计算机视觉图像处理深度学习机器学习上一篇CANN/asc-devkit Conv3D Tiling获取接口下一篇Whomane后端性能监控日志分析与系统资源占用优化创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
