APIAny_InsertSubPolyID

폴리곤에 전체 서브 폴리곤(구멍)을 삽입합니다.

    GSErrCode ACAPI_Goodies (
        APIAny_InsertSubPolyID,
        API_ElementMemo*     memo,
        API_ElementMemo*     insMemo
    );

 

파라미터

memo

[in/out] 폴리곤 데이터입니다.

insMemo

[in] 새로운 서브 폴리곤의 데이터입니다.

 

리턴 값

NoError

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

APIERR_BADPARS

파라미터들 중 하나 이상이 NULL입니다. 또는 memo나 insMemo가 초기화되지 않았습니다.

APIERR_MEMFULL

메모리가 부족합니다.

APIERR_IRREGULARPOLY

입력 폴리곤이 불규칙적입니다.

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

 

설명

이 함수는 API_ElementMemo structure에 전달된 폴리곤에 새로운 서브 폴리곤(구멍)을 삽입하는 데 사용합니다. 새로운 구멍의 도형은 insMemo 파라미터에 전달되어야 합니다.

폴리곤 데이터 structure에 대한 더 자세한 것은 API_Polygon structure를 참조하십시오. API_ElementMemo structure의 coords, pends, parcs, vertexIDs 핸들들은 memo 파라미터의 경우 반드시 초기화되어야 합니다. insMemo 파라미터의 vertexID와 pends 핸들들은 무시합니다.

이 함수는 외곽 리스트의 끝에 새로운 구멍을 배치합니다.

다른 메모 핸들들은 건드리지 않는다는 것을 참고하십시오. 폴리곤이 초기화된 사이드 각도들을 가진 지붕에 속한 경우, 반드시 수동으로 정렬되어야 합니다.

 

요구사항

버전: API 4.1 또는 이후

헤더: APIdefs_Goodies.h

 

참고사항

API_Polygon, API_ElementMemo,
APIAny_InsertPolyNodeID, APIAny_DeletePolyNodeID, APIAny_DeleteSubPolyID,
ACAPI_Goodies, API 함수