# ExtractHistogram

이미지 영역에서 히스토그램 배열을 추출합니다.

## ExtractHistogram 개요

Histogram 함수는 관심 영역에서 픽셀 값의 1차원 표현을 반환합니다. 히스토그램은 정수의 배열로 표현되며 배열의 각 요소(구간이라고 함)에 해당 영역의 픽셀 수가 계수되고 n번 째 구간의 값은 픽셀 값이 n인 영역에 속하는 픽셀의 수입니다. 배열의 모든 구간의 계수를 더하면 영역의 픽셀 수와 같습니다.

## ExtractHistogram 입력

매개 변수 | 설명
이미지 | 이 매개 변수는 이미지 데이터 구조를 포함하는 스프레드시트 셀의 셀 참조를 사용해야 합니다. 기본적으로 이 매개 변수는 함수에 의해 반환되는 Image 데이터 구조를 포함하는 셀인 A0을 참조합니다. 이 매개 변수는 비전 도구 이미지 함수에서 반환하는 결과 등의 다른 Image 데이터 구조를 참조할 수도 있습니다.
Fixture | Fixture 입력 또는 비전 도구 함수의 결과 이미지 좌표계를 기준으로 관심 영역(ROI)을 정의합니다. ROI를 Fixture 기준으로 설정하면 Fixture가 회전하거나 변환된 경우에도 ROI가 Fixture 기준으로 회전하거나 변환됩니다. 기본 설정은 이미지의 왼쪽 상단 모서리인 (0, 0, 0)입니다.
X | 이미지 좌표계에서의 X 오프셋.
Y | 이미지 좌표계에서의 Y 오프셋.
세타 | 이미지 좌표계 내에서 이미지 X축으로부터의 회전(+/-360도 시계 방향).
영역 | 관심 영역(ROI)이라고도 하며, 이미지 중 분석 대상이 되는 영역을 지정합니다. 영역 매개 변수를 두 번 클릭하면 변환하고 회전할 수 있는 대화형 그래픽 모드를 만듭니다. 이 매개 변수를 선택하고 속성 시트의 작업 편집 도구 모음에서 영역 최대화 버튼을 누르면 영역이 자동으로 확대되어 전체 이미지가 포함됩니다.
X | Fixture 좌표에서 원점으로부터의 x 오프셋.
Y | Fixture 좌표에서 원점으로부터의 y 오프셋.
폭 | 영역의 x 축 방향 크기.
높이 | 영역의 y 축을 방향 크기.
각도 | Fixture 좌표에서의 방향.
곡률 | 영역의 x 축과 반대 가장자리선 사이의 각 편차.
참고 : 히스토그램에서 픽셀이 계수되도록 하려면 이미지 영역 내에 완전히 포함되어야 합니다. 부분적으로 둘러싸인 픽셀은 포함되지 않습니다. Fixture 및 영역 매개 변수는 이미지의 경계 내에서 정의되어야 합니다. 그렇지 않으면 함수가 #ERR을 반환됩니다.
외부 영역 | 이 매개 변수는 Annulus, Circle, Region, EditAnnulus, EditCircle, EditCompositeRegion, EditPolygon, EditRegion에 대한 셀 참조를 사용합니다. 이 매개 변수를 사용하면 함수는 영역 및 Fixture 설정을 무시하고 참조된 영역에서 지정한 이미지 영역을 검사합니다. EditCompositeRegion 컨트롤을 참조하는 경우, 검사 영역에는 다수 도형이 혼합될 수 있습니다. 복합 영역의 각 도형은 검사 영역에 추가되거나 검사 영역에서 뺄(마스킹) 수 있습니다. 참고 : 이 매개 변수가 외부 영역에 대한 참조로 설정된 경우 함수의 내부 영역을 사용하려면 셀 참조 대신 0 값을 입력하여 수동으로 이 매개 변수를 0으로 설정해야 합니다. 그렇지 않으면 함수가 외부 영역을 계속 참조합니다.
표시 | 이미지에서 ExtractHistogram 그래픽 오버레이를 표시하는 모드를 지정합니다.
0 = 모두 숨기기(기본값) | ExtractHistogram 함수를 포함하는 셀이 스프레드시트의 활성 셀인 경우를 제외하고 모든 그래픽이 표시되지 않습니다.
2 = 입력 그래픽만 | 입력 이미지 영역이 항상 표시됩니다.
3 = 모두 표시: 입력 및 차트 | 입력 이미지 영역과 히스토그램 차트가 항상 표시됩니다. 참고 : 히스토그램 차트는 도킹 가능 창입니다. 자세한 내용은 스프레드시트 편집기 - 차트 항목을 참조하십시오.

## ExtractHistogram 출력

반환 | 회색조 돗수 분포를 포함하는 Hist 데이터 구조. 입력 매개 변수 중 하나라도 유효하지 않은 경우 #ERR.
결과 | ExtractHistogram가 처음으로 셀에 삽입되면 스프레드시트에 결과표가 만들어집니다. 다음 Hist Vision Data Access functions가 자동으로 스프레드시트에 삽입되어 결과표가 생성됩니다.
레이블 | 함수 | 설명
임계값 | HistThresh(Hist, 0, 255) | 이진 임계값.
대조 | HistContrast(Hist, 0, 255) | 회색조 이미지 대비.
어두운점계수 | HistCount(Hist, 0, 임계값-1) | 임계값 미안인 픽셀 수.
밝은점계수 | HistCount(Hist, 임계값, 255) | 임계값을 초과하는 픽셀 수.
평균 | HistMean(Hist, 0, 255) | 평균 회색조 값.