Changes the 3D image item settings.
GSErrCode ACAPI_Environment ( APIEnv_Change3DImageSetsID, API_3DFilterAndCutSettings* filterAndCutSettings, bool* mustConvert );
Parameters
- filterAndCutSettings
- [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_3DFilterAndCutSettings filterAndCutSettings = {}; bool setMustConvert; GSErrCode err; err = ACAPI_Environment (APIEnv_Get3DImageSetsID, &filterAndCutSettings); if (err == NoError) { filterAndCutSettings.elemTypeFilter.insert ({API_ZombieElemID, false}); // Hide everything in 3D ACAPI_Environment (APIEnv_Change3DImageSetsID, &filterAndCutSettings); filterAndCutSettings.elemTypeFilter.clear (); filterAndCutSettings.elemTypeFilter.insert ({API_WallID, true}); filterAndCutSettings.elemTypeFilter.insert ({API_BeamID, true}); // show walls and beams only setMustConvert = true; ACAPI_Environment (APIEnv_Change3DImageSetsID, &filterAndCutSettings, &setMustConvert); }
Requirements
- Version: API 26 or later
- Header: APIdefs_Environment.h
See Also
ACAPI_Environment
APIEnv_Get3DImageSetsID
API_3DFilterAndCutSettings
API Functions