Changes the 3D image item settings.
GSErrCode ACAPI_Environment ( APIEnv_Change3DImageSetsID, API_3DImageInfo* imageInfo, bool* mustConvert );
Parameters
- imageInfo
- [in] Parameters of the ‘Filter and Cut Elements in 3D’ dialog box
- mustConvert
- [in] Optional parameter; if it is not
nullptr
and its value istrue
then the function drops the partial conversion data, so that a full rebuild will be performed upon the next Rebuild operation
Return Values
NoError
- The function has completed with success.
APIERR_NOPLAN
- No open project
Remarks
This function is used to change the 3D image item settings which can be accessed via the ‘Filter and Cut Elements in 3D’ dialog box.
Example
API_3DImageInfo imageInfo; bool setMustConvert; GSErrCode err; BNZeroMemory (&imageInfo, sizeof (API_3DImageInfo)); err = ACAPI_Environment (APIEnv_Get3DImageSetsID, &imageInfo, nullptr, nullptr); if (err == NoError) { imageInfo.wall = false; /* don't show walls and columns in 3D */ imageInfo.colu = false; setMustConvert = true; ACAPI_Environment (APIEnv_Change3DImageSetsID, &imageInfo, &setMustConvert, nullptr); }
Requirements
- Version: API 3.1 or later
- Header: APIdefs_Environment.h
See Also
ACAPI_Environment
APIEnv_Get3DImageSetsID
API_3DImageInfo
API Functions