# SortPatterns

이미지에서의 위치에 따라 패턴을 정렬합니다. SortPattern은 입력 Patterns 데이터 구조의 각 패턴에 대해 지정된 이미지 Fixture 좌표계를 기준으로 패턴 응답의 위치를 계산합니다. 패턴은 x 좌표, y 좌표, 각도, 각도 거리, 거리, 눈금 중 하나에 의해 정렬됩니다. 정렬된 패턴은 새 Paterns 데이터 구조로 반환됩니다.

## SortPatterns 입력

매개 변수 | 설명
패턴 | 이 인수는 함수에서 반환되는 유효한 Patterns 데이터 구조를 포함하는 스프레드시트 셀을 참조해야 합니다.
정렬할 개수 | 정렬할 패턴의 최대 수 (1 - 255, 기본값 = 1)를 지정합니다.
정렬 기준 | 정렬 방법을 지정합니다.
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 좌표에 따른 거리를 기준으로 내림차순(가까운 것에서 먼 것 순서)으로 정렬합니다. 참고 : SortPatterns가 눈금 Y 를 선택하고 CalibrateImage 또는 TransPatternsToWorld 함수의 출력과 같이 실제 좌표계 값으로 보정된 이미지를 참조하는 경우에는 #ERR이 반환됩니다. 눈금 Y 정렬은 픽셀 좌표에만 적용할 수 있습니다.
6 = 눈금 X | Fixture의 x 좌표에 따른 거리를 기준으로 먼저 정렬한 다음 y 좌표에 따른 거리를 기준으로 내림차순(가까운 것에서 먼 것 순서)으로 정렬합니다. 참고 : SortPatterns가 눈금 Y 를 선택하고 CalibrateImage 또는 TransPatternsToWorld 함수의 출력과 같이 실제 좌표계 값으로 보정된 이미지를 참조하는 경우에는 #ERR이 반환됩니다. 눈금 Y 정렬은 픽셀 좌표에만 적용할 수 있습니다.
Fixture | Fixture 입력 또는 비전 도구 함수의 이미지 좌표 시스템의 출력을 기준으로 참조된 패턴을 정의합니다. 패턴을 Fixture 기준으로 설정하면 Fixture가 회전하거나 변환된 경우에도 참조된 패턴이 Fixture 기준으로 회전하거나 변환됩니다. 기본 설정은 이미지의 왼쪽 상단 모서리인 (0, 0, 0)입니다.
X | 이미지 좌표계에서의 X 오프셋.
Y | 이미지 좌표계에서의 Y 오프셋.
세타 | 이미지 좌표계 내에서 이미지 X축으로부터의 회전(+/-360도 시계 방향).
정렬 허용 오차 | 눈금 X 또는 눈금 Y 기준으로 정렬할 때 발견된 패턴이 패턴 그룹에 포함되기 위해 트레이닝된 패턴의 크기 대비 어떤 백분율을 가져야 하는지(1% - 500%, 기본값 = 50%)를 지정합니다. 참고 : 이 매개 변수는 정렬 기준 매개 변수가 눈금 X 또는 눈금 Y로 설정된 경우에만 사용됩니다.
표시 | 이미지에서 SortPatterns 그래픽를 표시하는 모드를 지정합니다.
0 = 모두 숨기기(기본값) | SortPatterns 함수를 포함하는 셀이 스프레드시트에 강조 표시되는 경우를 제외하고 점이 표시되지 않습니다.
1 = 결과 그래픽만 | 발견된 각 패턴에 대해 항상 십자가 표시됩니다.
3 = 모두 표시: 입력, 결과, 일치 형상 | 입력 이미지 영역, 발견된 각 패턴에 대한 십자, 일치 형상이 항상 표시됩니다. 참고 : 일치 형상은 PatMax에서 트레이닝한 패턴에 대해서만 표시됩니다.

## SortPatterns 출력

반환 | 정렬된 패턴들을 포함하는 Patterns 데이터 구조. 입력 매개 변수 중 하나라도 유효하지 않은 경우 #ERR.
결과 | SortPatterns가 처음으로 셀에 삽입되면 다음 Patterns Vision Data Access functions를 사용하여 스프레드시트에 결과표가 만들어집니다.
레이블 | 함수 | 설명
X | GetX(패턴, 인덱스) | 패턴 위치의 x 좌표.
Y | GetY(패턴, 인덱스) | 패턴 위치의 y 좌표.
각도 | GetAngle(패턴, 인덱스) | 패턴 위치의 방향.
크기 | GetScale(Patterns, 인덱스) | 원래 모델의 백분율 크기.
점수 | GetScore(패턴, 인덱스) | 패턴 응답 점수.
참고 : 정렬할 개수 매개 변수값이 0보다 큰 경우 SortPatterns는 Patterns 데이터 구조의 처음 10개 항목에 해당하는 최대 10개의 항목이 포함된 결과표를 자동으로 삽입합니다. 더 많은 항목을 표시하려면 표의 마지막 행을 복사하고 표의 끝에 붙여넣기하여 확장할 수 있습니다. 적절한 패턴이 인덱싱될 수 있도록 새로 붙여넣은 행의 인덱스 수를 증가해야 합니다.