APIEnv_​Change3DImageSetsID

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 is true 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