# SortBlobs

SortBlobs는 Blobs 데이터 구조에서 참조된 미확인 개체를 Fixture와의 관계에서 정렬하는 데 사용됩니다.

## SortBlobs 개요

SortBlobs는 지정된 이미지 Fixture 좌표계를 기준으로 참조된 미확인 개체의 무게 중심 위치를 계산하고 측정 특성(Fixture의 원점 또는 격자로부터의 x 축 또는 y 축에 따른 거리, 미확인 개체의 각도 또는 각 거리 등) 중 한 가지에 따라 참조된 미확인 개체들을 정렬합니다.

참조된 Blobs 데이터 구조의 각 미확인 개체를 검사하고 정렬 기준 매개 변수 설정에 따라 각 미확인 개체를 식별하고 미확인 개체의 거리 또는 고정 위치에 대한 각도 관계를 측정하여 미확인 개체의 위치를 계산합니다.

SortBlobs 함수에 의해 참조된 미확인 개체들이 정렬되면 새 Blobs 데이터 구조와 그에 따른 결과표가 스프레드시트에 자동으로 삽입됩니다. 결과표는 미확인 개체들이 선택된 Fixture와의 거리에 따라 내림차순으로 정렬됩니다(가장 가까운 미확인 개체가 처음).

SortBlobs는 미확인 개체가 다수 있을 대 각 미확인 개체의 위치를 다른 미확인 개체와의 관계에서 파악해야 할 때 매우 유용합니다.

## SortBlobs 입력

매개 변수 | 설명
미확인 개체 | 이 매개 변수는 정렬할 Blobs 데이터 구조를 포함하는 스프레드시트 셀을 셀 참조합니다.
정렬할 개수 | 반환할 최대 미확인 개체 수(1 - 4096, 기본값 = 3)를 지정합니다. 참고 : 이 매개 변수값이 0보다 큰 경우 SortBlobs는 Blobs 데이터 구조의 처음 10개의 미확인 개체에 해당하는 최대 10개의 항목이 포함된 결과표를 자동으로 삽입합니다. 더 많은 항목을 표시하려면 표의 마지막 행을 복사하고 표의 끝에 붙여넣기하여 확장할 수 있습니다. 적절한 미확인 개체가 인덱싱될 수 있도록 새로 붙여넣은 행의 인덱스 수를 증가해야 합니다.
정렬 기준 | 참조된 미확인 개체들을 측정하고 정렬하는 방법을 지정합니다.
0 = Y(기본값) | Fixture의 y 좌표에 따른 거리를 기준으로 작은 것부터 큰 것 순서로 정렬합니다.
1 = X | Fixture의 x 좌표에 따른 거리를 기준으로 작은 것부터 큰 것 순서로 정렬합니다.
2 = 각도 | Fixture 좌표계의 y 축에서 미확인 개체의 무게 중심과 Fixture의 원점으로 만들어진 선분까지의 시계 반대 방향 각도(0 - 360도)를 기준으로 내림차순(가까운 것에서 먼 것 순서)으로 정렬합니다.
3 = 각도 거리 | Fixture 좌표계의 x 축에서 미확인 개체의 무게 중심과 Fixture의 원점으로 만들어진 선분까지의 각도의 절대적인 값(-180 - 180도)을 기준으로 내림차순(가까운 것에서 먼 것 순서)으로 정렬합니다.
4 = 거리 | Fixture의 원점에서 미확인 개체의 무게 중심을 기준으로 내림차순(가까운 곳에서 먼 것 순서)으로 정렬합니다.
5 = 눈금 Y | Fixture의 y 좌표에 따른 거리를 기준으로 먼저 정렬한 다음 x 좌표에 따른 거리를 기준으로 내림차순(가까운 것에서 먼 것 순서)으로 정렬합니다. 참고 : SortBlobs 함수에서 눈금 Y를 선택하고 CalibrateImage 함수 또는 TransBlobsToWorld 함수의 출력처럼 실제 좌표계 값으로 보정된 이미지를 참조하는 경우에는 #ERR이 반환됩니다. 눈금 Y 정렬은 픽셀 좌표에만 적용할 수 있습니다.
6 = 눈금 X | Fixture의 x 좌표에 따른 거리를 기준으로 먼저 정렬한 다음 y 좌표에 따른 거리를 기준으로 내림차순(가까운 것에서 먼 것 순서)으로 정렬합니다. 참고 : SortBlobs 함수에서 눈금 X를 선택하고 CalibrateImage 함수 또는 TransBlobsToWorld 함수의 출력처럼 실제 좌표계 값으로 보정된 이미지를 참조하는 경우에는 #ERR이 반환됩니다. 눈금 X 정렬은 픽셀 좌표에만 적용할 수 있습니다.
7 = 폭 | 폭 값을 기준으로 큰 값에서 작은 값 순서로 정렬합니다.
8 = 높이 | 높이 값을 기준으로 큰 값에서 작은 값 순서로 정렬합니다.
Fixture | Fixture 입력 또는 비전 도구 함수의 이미지 좌표 시스템의 출력을 기준으로 참조된 미확인 개체의 질량 중심을 정의합니다. 참조된 미확인 개체의 무게 중심을 Fixture 기준으로 설정하면 Fixture가 회전하거나 변환된 경우에도 참조된 미확인 개체가 Fixture 기준으로 회전하거나 변환됩니다. 기본 설정은 이미지의 왼쪽 상단 모서리인 (0, 0, 0)입니다.
X | 이미지 좌표계에서의 X 오프셋.
Y | 이미지 좌표계에서의 Y 오프셋.
세타 | 이미지 좌표계 내에서 이미지 X축으로부터의 회전(+/-360도 시계 방향).
표시 | 이미지에서 SortBlobs 그래픽 오버레이를 표시하는 모드를 지정합니다.
0 = 모두 숨기기(기본값) | S 함수를 포함하는 셀이 스프레드시트에 강조 표시되는 경우를 제외하고 점이 표시되지 않습니다.
1 = 결과 그래픽만 | 미확인 개체 윤곽선이 항상 표시됩니다.

## SortBlobs 출력

반환 | 정렬된 미확인 개체들을 포함하는 Blobs 데이터 구조. 입력 매개 변수 중 하나라도 유효하지 않은 경우 #ERR.
결과 | SortBlobs가 처음으로 셀에 삽입되면 스프레드시트에 결과표가 만들어집니다. 참고 : 정렬할 개수 매개 변수값이 0보다 큰 경우 SortBlobs는 Blobs 데이터 구조의 처음 10개의 미확인 개체에 해당하는 최대 10개의 항목이 포함된 결과표를 자동으로 삽입합니다. 더 많은 항목을 표시하려면 표의 마지막 행을 복사하고 표의 끝에 붙여넣기하여 확장할 수 있습니다. 적절한 미확인 개체가 인덱싱될 수 있도록 새로 붙여넣은 행의 인덱스 수를 증가해야 합니다. 다음 미확인 개체 Vision Data Access functions가 자동으로 스프레드시트에 삽입되어 SortBlobs 데이터 구조 결과표가 생성됩니다.
레이블 | 함수 | 설명
인덱스 |  | Blobs 인덱스
X | GetX(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체 무게 중심의 x 좌표를 반환합니다.
Y | GetY(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체 무게 중심의 y 좌표를 반환합니다.
각도 | GetAngle(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체 무게 중심의 ROI의 중심을 기준으로 한 각도를 반환합니다.
색 | GetColor(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체의 색상 값(0 = 검정, 1 =흰색)을 반환합니다.
점수 | GetScore(Blobs, 미확인 개체 인덱스) | 미확인 개체가 FindBlobs 함수의 기준과 얼마나 일치하는지 측정합니다.
면적 | GetArea(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체의 면적(픽셀 단위로 측정)을 반환합니다. 참고 : 미확인 개체에 구멍이 있는 경우 구멍 채우기 확인란을 선택했는지 여부에 따라 면적 값이 달라집니다.
연장 | GetElongation(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체의 픽셀이 미확인 개체의 무게 중심에서 어떻게 확장되는지 나타내는 값을 반환합니다. 예를 들어 원은 연장으로 0을 보고할 것이며 못은 연장 값이 클 것입니다.
구멍 | GetHoles(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체에 포함된 구멍 수를 반환합니다.
둘레 | GetPerimeter(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체를 에워싼 경계의 길이를 반환합니다. 둘레는 미확인 개체 경계를 구성하는 픽셀의 외부 가장자리를 센 값입니다.
Spread | GetSpread(Blobs, 미확인 개체 인덱스) | 참조된 미확인 개체의 픽셀이 미확인 개체의 무게 중심에서 어떻게 분포하는지를 나타내는 값을 반환합니다. 예를 들어 원형 모양의 개체는 타원형 개체보다 스프레드 값이 낮습니다.