FigureArray

1 개요

CFLFigureArray 클래스는 Figure 배열을 표현하는 클래스입니다. Figures 에 대한 정보를 사용하여 관련된 연산을 수행하는 클래스입니다.

2 멤버 함수 목록

아래는 주요 기능별로 정리된 멤버 함수 목록입니다. 각 함수의 상세한 파라미터 설정은 FLImaging® API 레퍼런스를 참고 바랍니다.

1. 객체 및 컨테이너 관리

• PushFront : 배열의 앞에 객체를 추가
• PushBack : 배열의 뒤에 객체를 추가
• InsertAt : 배열의 특정 위치에 객체를 추가
• PushBackElementwise : 도형 배열을 해당 배열의 뒤에 추가
• PopFront : 배열의 앞에 객체를 제거
• PopBack : 배열의 뒤에 객체를 제거
• RemoveAt : 배열의 특정 위치의 객체를 제거
• Assign : 해당 객체에 배열 객체를 복사
• SetAt : 배열 특정 인덱스 값을 변경
• Reserve : Container 의 메모리를 미리 할당
• ShrinkToFit : Container 의 불필요한 메모리를 정리
• EnableAutoDestroyElements : 객체의 깊은 복사 여부를 설정
• IsAutoDestroyElements : 객체의 깊은복사 여부를 확인

2. 조회 및 탐색

• GetAt : 배열의 특정 위치의 포인터를 반환
• GetCount : 배열에 저장된 객체의 수를 반환
• Front : 배열에 저장된 맨 앞의 요소를 반환
• Back : 배열에 저장된 맨 뒤의 요소를 반환
• GetFigure : 조건식에 부합한 객체를 추출하여 출력
• Query : 조건식에 부합한 객체를 추출하여 출력
• GetFigureWithinRegion : 간섭 영역 내의 객체를 추출하여 출력
• RemoveFigure : 조건식에 부합한 객체를 제거
• Filter : 조건식에 부합한 객체를 제거
• RemoveFigureWithinRegion : 간섭 영역 내의 객체를 제거

3. 정렬

• Sort : 입력된 정렬 기준으로 객체 정렬
• Sort2D : 정렬 기준 및 중심점 계산 기준으로 2D 객체 정렬
• Sort2DClusterMode : 정렬 기준과 클러스터 중심 계산 기준으로 2D 객체 정렬

4. 객체 변환 및 구조 변경

• Flatten : 내부 FigureArray들의 원소를 최상위 깊이의 원소로 변경
• MakeFigureValidElementwise : 유효하지 않은 Figure를 유효한 Figure로 변환
• MakeCrossHairElementwise : 원소 중심으로 지정된 길이의 십자선을 생성

5. 원소별 정보 조회

• GetCenterElementwise : 원소들의 중심 반환
• GetCenterOfGravityElementwise : 원소들의 무게중심 반환
• GetMinimumEnclosingRectangleElementwise : 원소들의 최소 둘레 직사각형 반환
• GetBoundaryRectElementwise : 원소들의 외접 직사각형 반환
• GetDeclTypeElementwise : 원소들의 도형 타입 반환
• GetTemplateTypeElementwise : 원소들의 템플릿 타입 반환
• GetPerimeterElementwise : 원소들의 둘레 길이 반환
• GetAreaElementwise : 원소들의 넓이 반환
• GetAngleElementwise : 원소들의 각도 반환
• GetWidthElementwise : 원소들의 너비 반환
• GetHeightElementwise : 원소들의 높이 반환
• GetMinimumDistanceElementwise : 원소들의 최소 거리 반환
• GetMaximumDistanceElementwise : 원소들의 최대 거리 반환

6. 원소별 변형

• InflateElementwise : 원소들의 크기를 팽창
• ExtendElementwise : 원소들의 크기를 확장
• ScaleElementwise : 원소들의 크기를 스케일링
• RotateElementwise : 원소들을 회전
• FlipElementwise : 원소들을 뒤집기
• MultiplyElementwise : 원소들의 좌표 스칼라 곱
• ConvertDeclTypeElementwise : 원소들을 설정한 도형 타입으로 변환
• ConvertTemplateTypeElementwise : 원소들을 설정한 자료형으로 변환

3 추가 설명

아래는 몇 가지 함수에 대한 사용법을 예시를 통해 설명합니다. 각 함수의 동작을 이해하고 실제 코드에서 어떻게 활용할 수 있는지에 대한 예시를 제공합니다.

GetFigure, Query

GetFigure, Query 이 함수는 특정 조건식(strExpression)에 부합하는 객체를 얻어오는 수행합니다. 사용자는 주어진 조건식을 기반으로 필요한 객체를 선택할 수 있습니다.

// 여러 Figure들이 담겨있는 Source FigureArray
CFLFigureArray flfaSource, flfaResult;
flfaSource.Load(L"C:/Users/Public/Documents/FLImaging/ExampleImages/Figure/Circles.fig");

// 각각의 도형의 면적이 전체 평균 면적보다 크거나 같은 Figure를 얻어옵니다.
flfaSource.GetFigure(L"area >= mean('area')", &flfaResult);

// 여러 Figure들이 담겨있는 Source FigureArray
CFLFigureArray flfaSource = new CFLFigureArray();
CFLFigureArray flfaResult = new CFLFigureArray();
flfaSource.Load("C:/Users/Public/Documents/FLImaging/ExampleImages/Figure/Circles.fig");

// 각각의 도형의 면적이 전체 평균 면적보다 크거나 같은 Figure 원소들을 제거합니다.
flfaSource.GetFigure("area >= mean('area')", ref flfaResult);

# 여러 Figure들이 담겨있는 Source FigureArray
flfaSource = CFLFigureArray()
flfaResult = CFLFigureArray()
flfaSource.Load("C:/Users/Public/Documents/FLImaging/ExampleImages/Figure/Circles.fig")

# 각각의 도형의 면적이 전체 평균 면적보다 크거나 같은 Figure 원소들을 제거합니다.
flfaSource.GetFigure("area >= mean('area')", flfaResult)

RemoveFigure, Filter

RemoveFigure, Filter 이 함수는 특정 조건식(strExpression)에 부합하는 객체를 제외하는 역할을 수행합니다. 사용자는 주어진 조건식을 기반으로 필요 없는 객체를 제거할 수 있습니다.

// 여러 Figure들이 담겨있는 Source FigureArray
CFLFigureArray flfaSource;
flfaSource.Load(L"C:/Users/Public/Documents/FLImaging/ExampleImages/Figure/Circles.fig");

// 각각의 도형의 면적이 전체 평균 면적보다 크거나 같은 Figure 원소들을 제거합니다.
flfaSource.RemoveFigure(L"area >= mean('area')");

// 여러 Figure들이 담겨있는 Source FigureArray
CFLFigureArray flfaSource = new CFLFigureArray();
flfaSource.Load("C:/Users/Public/Documents/FLImaging/ExampleImages/Figure/Circles.fig");

// 각각의 도형의 면적이 전체 평균 면적보다 크거나 같은 Figure 원소들을 제거합니다.
flfaSource.RemoveFigure("area >= mean('area')");

# 여러 Figure들이 담겨있는 Source FigureArray
flfaSource = CFLFigureArray()
flfaSource.Load("C:/Users/Public/Documents/FLImaging/ExampleImages/Figure/Circles.fig")

# 각각의 도형의 면적이 전체 평균 면적보다 크거나 같은 Figure 원소들을 제거합니다.
flfaSource.RemoveFigure("area >= mean('area')")