# ExtractHistogram

从图像区域中提取直方图数组。

## ExtractHistogram 概述

直方图函数返回感兴趣区域中像素值的一维表示。直方图由整数数组表示，其中数组的每个元素称为直条，存储区域中像素数的计数，其中直条 n 中的值是像素值 n 区域中的像素数 n。数组中所有直条计数的总和等于区域中的像素数。

## ExtractHistogram 输入

参数 | 说明
图像 | 该参数必须在包含 图像 数据结构的电子表格单元格中使用单元格引用；默认情况下，此参数引用 A0，即包含由 函数返回的 Image 数据结构的单元格。此参数还可以引用其他 Image 数据结构，例如视觉工具图像函数返回的那些数据结构。
固定 | 定义相对于固定输入或视觉工具函数的图像坐标系输出的关注区域 (ROI)。根据“固定坐标”来设置的 ROI 可以确保如果“固定坐标” 被旋转或转换，相应的 ROI 也会根据“固定坐标”而旋转或转换。 默认设置为(0,0,0)，图像的最左上方。
X | 图像坐标中的 X 偏移。
Y | 图像坐标中的 Y 偏移。
Theta | 图像坐标系中图像 X 轴的旋转。（顺时针 +/-360 度）
区域 | 也称为关注区域 (ROI)，指定要进行分析的图像区域。双击区域参数以创建可以变换和旋转的交互图形模式。选择此参数并按属性表的作业编辑工具栏上的最大化区域按钮，自动拉伸区域以覆盖整个图像。
X | 在固定坐标中，偏移原点的 x 值。
Y | 在固定坐标中，偏移原点的 y 值。
宽度 | 沿区域 x 轴的尺寸。
高度 | 沿区域 y 轴的尺寸。
角度 | 在固定坐标上的方向。
曲线 | 在区域 x 轴和相对的边界线之间的角度偏差。
注意: 为了在直方图中计算一个像素，它必须完全包含在图像区域内；不包括部分封闭的像素。 固定和区域参数必须在图像的范围内定义；否则，该函数将返回 #ERR。
外部区域 | 此参数对Annulus、Circle、区域、EditAnnulus、EditCircle、EditCompositeRegion、EditPolygon、EditRegion使用单元格引用。使用此参数时，该函数将忽略区域和固定设置并检查引用区域指定的图像区域。如果引用了编辑复合区域控件，则检查区域可以是多种形状的混合。在混合区域中的任何一个形状可以被指定从（遮蔽）检查区域中添加或删除。 注意:如果此参数已设置为对外部区域的引用，要使用函数的内部区域，必须通过输入值 0 代替单元格引用手动将此参数设置为零。否则，该函数将继续引用外部区域。
显示 | 指定图像顶部的 ExtractHistogram 图形叠加的显示模式。
0 = 隐藏所有（默认值） | 所有图形都将被隐藏，除非包含 ExtractHistogram 函数的单元格是电子表格中的活动单元格。
2 = 仅输入图形 | 输入图像区域将始终显示。
3 = 显示全部：输入和图表 | 输入图像区域和直方图都将始终显示。 注意:直方图是一个可停靠窗口。有关详细信息，请参阅电子表格编辑器 - 图表主题。

## ExtractHistogram 输出

返回 | 包含灰度频率分布的 Hist 数据结构，如果任何输入参数无效，则为 #ERR。
结果 | 最初将 ExtractHistogram 插入单元格时，会在电子表格中创建一个结果表。 以下 Hist Vision Data Access functions 自动插入到电子表格中以创建结果表：
标签 | 函数 | 说明
Thresh | HistThresh(Hist, 0, 255) | 二进制阈值。
对比度 | HistContrast(Hist, 0, 255) | 灰度图像对比度。
DarkCount | HistCount(Hist, 0, Thresh-1) | 低于阈值的像素数。
BrightCount | HistCount(Hist, Thresh, 255) | 阈值上方的像素数。
平均值 | HistMean(Hist, 0, 255) | 平均灰度值。