Retrieves information on the 3D data of an element.
GSErrCode ACAPI_Element_Get3DInfo ( const API_Elem_Head& elemHead, API_ElemInfo3D* info3D );
- [in] The element to get the 3D information for.
- [out] The 3D information to be retrieved.
- The operation was successful.
elemHead.guidwas specified. Incorrect
typewas specified, for example 0 or an element without 3D representation. such as
elementwas attempted to be accessed on a layer owned by someone else. Most likely to occur when working on documents in teamwork mode.
elementwas attempted to be accessed on a locked layer.
elementwas attempted to be accessed on a hidden layer.
- The element wasn’t found in the 3D database.
For other common API errors see the API Errors document.
This function returns information on the 3D data of the element defined by
elemHead. This function is defined only for those elements which have 3D representation:
API_RoomID. The returned structure contains the first and last body (or, in case of
API_LampID, the first and last light also) indices of the element’s 3D data. This index is an index to the whole 3D data structure, where all the 3D data is stored in a continuous way.
The 3D data of the element doesn’t need to exist; Archicad will convert the element to 3D independently of any existing 3D window data. This also means that the 3D representation doesn’t contain perspective cuts and 3D cut planes!
Currently, this is the only way to obtain information on holes in walls. Look for polygons which have a horizontal normal vector perpendicular to the reference line of the wall. Similarly, you can get information on the intersection of walls by looking for polygons with a vertical normal vector.
- Version: API 1.3 or later
- Header: ACAPinc.h