API_ElemSearchPars

좌표로 요소를 검색하기 위한 structure입니다.

    typedef struct {
        API_ElemTypeID          typeID;
        API_ElemFilterFlags     filterBits;
        API_Coord               loc;
        double                  z;
    } API_ElemSearchPars;

 

멤버

typeID

검색할 요소 타입입니다.

filterBits

필터링에 사용할 flag들입니다. (ACAPI_Element_Filter를 보십시오)

loc

2D 도면 상에서의 위치입니다.

z

이 레벨 아래로 검색합니다.

 

설명

이 structure는 좌표로 요소를 검색할 때 사용합니다. 폴리곤 요소들만 허용됩니다.

요소의 타입은 반드시 폴리곤이어야 하며 typeID 필드에 전달해야 합니다. 특정 속성들(가시성, 층 번호, 레이어 레퍼런스 등)을 기반으로 인스턴스들을 건너뛸 수 있게 해주는 필터들도 전달할 수 있습니다. 더 자세한 것은 ACAPI_Element_Filter 함수를 참조하십시오. 검색할 위치는 loc 필드에 전달해야 합니다. 검색 알고리즘은 z 파라미터에 지정한 것보다 더 높은 레벨에 있는 모든 요소들을 무시할 것입니다.

1번째 요소가 리턴될 것입니다. 즉:

• 요소 타입에 일치합니다.
• 필터를 통과합니다.
• 좌표가 폴리곤의 내부 지점입니다.
• z보다 낮은 가장 높은 레벨을 가지고 있습니다.

APIAny_SearchElementByCoordID 함수를 보십시오.

 

요구사항

버전: API 2.1 또는 이후

헤더: APIdefs_Goodies.h

 

참고사항

APIAny_SearchElementByCoordID, ACAPI_Element_Filter, API_ElemTypeID, API_Coord, API 타입