APIAny_SearchElementByCoordID

좌표로 하나의 요소를 검색합니다.

    GSErrCode ACAPI_Goodies (
        APIAny_SearchElementByCoordID,
        const API_ElemSearchPars*     elemSearchPars,
        API_Guid*                     foundElement
    );

 

파라미터

elemSearchPars

[in] 검색 파라미터들입니다.

foundElement 

[out] 발견한 요소의 guid입니다.

 

리턴 값

NoError

함수가 성공적으로 완료되었습니다.

APIERR_BADPARS

searchPars가 NULL입니다. 또는 guid가 NULL입니다. 또는 주어진 파라미터들과 일치하는 요소를 찾지 못했습니다.

APIERR_REFUSEDPAR

검색하고자 하는 요소가 폴리곤 요소가 아닙니다.

다른 공통 API 오류들에 대해서는 API 오류 문서를 보십시오.

 

설명

이 함수는 좌표로 폴리곤 요소를 검색하는 데 사용합니다.

파라미터화 및 더 자세한 것은 API_ElemSearchPars를 참조하십시오.

GUID는  3번째 파라미터에서 2번째 파라미터로 이동했습니다.

 

예제

API_Guid            guid;
API_ElemSearchPars  searchPars;

BNZeroMemory (&searchPars, sizeof (API_ElemSearchPars));
searchPars.typeID = API_MeshID;
searchPars.filterBits = APIFilt_OnVisLayer | APIFilt_OnActFloor;
searchPars.loc.x = 1.0;
searchPars.loc.y = 3.0;
searchPars.z = BiggestDouble;

API_Goodies (APIAny_SearchElementByCoordID, &searchPars, &guid);

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Goodies.h

 

참고사항

API_ElemSearchPars,
ACAPI_Goodies, API 함수