ACAPI_Element_Get3DInfo

요소의 3D 데이터 정보를 가져옵니다.

    GSErrCode  ACAPI_Element_Get3DInfo (
        const API_Elem_Head&     elemHead,
        API_ElemInfo3D*          info3D
    );

파라미터

elemHead: [in] 3D 정보가 추출되는 요소입니다.
info3D: [out] 가져온 3D 정보입니다.

리턴 값

NoError: 동작이 성공했습니다.
APIERR_BADID: 올바르지 않은 elemHead.guid가 지정되었습니다. (예. 0) 올바르지 않은 typeID가 지정되었습니다. (예. 3D 표현이 누락된 요소, 가령 API_LineID)
APIERR_BADPARS: info3D 파라미터가 NULL입니다.
APIERR_NOTMINE: 다른 사람이 소유한 레이어에서 element에 접근하려고 시도했습니다. 팀워크 모드로 문서에서 작동할 때 발생했을 가능성이 높습니다.
APIERR_LOCKEDLAY: 잠긴 레이어에서 element에 접근하려고 시도했습니다.
APIERR_HIDDENLAY: 숨긴 레이어에서 element에 접근하려고 시도했습니다.
APIERR_GENERAL: 요소를 3D 데이터베이스에서 발견할 수 없습니다.

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

설명

이 함수는 elemHead로 정의된 요소의 3D 데이터의 정보를 리턴합니다. 이 함수는 3D 표현을 가진 요소들에 대해서만 정의되어 있습니다: API_WallID, API_ColumnID, API_BeamID, API_WindowID, API_DoorID, API_ObjectID, API_LampID, API_SlabID, API_RoofID, API_RoomID. 리턴된 structure는 요소의 3D 데이터의 처음과 마지막 바디 인덱스를 포함하고 있습니다. (API_LampID의 경우, 처음과 마지막 광원 인덱스도 포함하고 있습니다) 이 인덱스는 모든 3D 데이터가 연속적인 방식으로 저장되는 전체 3D 데이터 구조에 대한 인덱스입니다.

요소의 3D 데이터는 존재할 필요가 없습니다; ArchiCAD는 기존 3D 창 데이터와 독립적으로 요소를 3D로 변환할 것입니다. 이것은 또한 3D 표현에 원근법 절단 및 3D 절단면들이 존재하지 않음을 의미합니다!

현재, 이것은 벽의 구멍에 대한 정보를 얻을 수 있는 유일한 방법입니다. 벽의 레퍼런스 라인에 수직인 수평 법선 벡터를 가진 폴리곤들을 찾으십시오. 마찬가지로 수직 법선 벡터를 가진 폴리곤들을 찾아봄으로써 벽들의 교차점에 대한 정보를 얻을 수 있습니다.

당신은 이 도움말의 3D 관리자와 API_ElemInfo3D 페이지에서 3D 데이터에 대한 더 많은 정보를 찾을 수 있습니다. 당신은 GDL Reference Manual의 Primitive element 섹션에 대해 익숙해져야 합니다.

요구사항

버전: API 1.3 또는 이후

헤더: ACAPinc.h

참고사항

API_ElemTypeID, API_ElemInfo3D,
요소 관리자, 3D 관리자, API 함수