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