# ExtractHistogram

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

## ExtractHistogram 概述

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

## ExtractHistogram 输入

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

## ExtractHistogram 输出

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