Functions for managing project settings, such as Grid, Project Notes, tolerances, etc.
More...
|
enum class | API_VolumeTypeID {
API_VolumeTypeID::CubicMeter
, API_VolumeTypeID::CubicKiloMeter
, API_VolumeTypeID::Liter
, API_VolumeTypeID::CubicCentimeter
,
API_VolumeTypeID::CubicMillimeter
, API_VolumeTypeID::CubicFoot
, API_VolumeTypeID::CubicInch
, API_VolumeTypeID::CubicYard
,
API_VolumeTypeID::Gallon
} |
| Possible values for volume unit preferences. More...
|
|
enum | API_ConditionalElementPropertyTypeID { APIConditionalElementPropertyType_Volume
, APIConditionalElementPropertyType_Surface
, APIConditionalElementPropertyType_Length
} |
| Property type of an element used in conditional calculation element rules. More...
|
|
enum | API_PrefsTypeID {
APIPrefs_WorkingUnitsID
, APIPrefs_ReferenceLevelsID
, APIPrefs_DimensionsID
, APIPrefs_CalcUnitsID
,
APIPrefs_CalcRulesID
, APIPrefs_LegacyID
, APIPrefs_ZonesID
, APIPrefs_DataSafetyID
,
APIPrefs_ImagingAndCalcID
, APIPrefs_FloorPlanCutPlaneDef
, APIPrefs_LayoutsID
} |
| The enumeration of the available preferences tab page types. More...
|
|
Functions for managing project settings, such as Grid, Project Notes, tolerances, etc.
◆ API_ConditionalElementPropertyTypeID
Property type of an element used in conditional calculation element rules.
- Since
- Archicad 25
◆ API_PrefsTypeID
The enumeration of the available preferences tab page types.
◆ API_VolumeTypeID
Possible values for volume unit preferences.
Enumerator |
---|
CubicMeter | cubic meter
|
CubicKiloMeter | cubic kilometer
|
Liter | liter
|
CubicCentimeter | cubic centimeter
|
CubicMillimeter | cubic millimeter
|
CubicFoot | cubic feet
|
CubicInch | cubic inches
|
CubicYard | cubic yards
|
Gallon | gallon
|
◆ ACAPI_ProjectSetting_ChangeProjectNotes()
Changes the data of the 'Project Info' dialog.
- Parameters
-
projectNoteInfo | [in] project note data |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - noteInfo is nullptr
- APIERR_NOPLAN - There are no project loaded.
- Example
CHCopyC (
"John Miller", noteInfo.
client);
◆ ACAPI_ProjectSetting_ChangeStorySettings()
GSErrCode ACAPI_ProjectSetting_ChangeStorySettings |
( |
API_StoryCmdType * | storyCmd | ) |
|
Modifies the story structure.
- Parameters
-
storyCmd | [in] Action parameters to change the story settings. |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - storyCommand is nullptr or contains invalid value:
- the index is out of the range of existing stories,
- the action field is invalid.
- APIERR_NOPLAN - No open project.
- APIERR_MEMFULL - Low memory condition.
◆ ACAPI_ProjectSetting_GetExportTolerance()
GSErrCode ACAPI_ProjectSetting_GetExportTolerance |
( |
double * | arcDiff | ) |
|
Returns information on curve tracing parameters.
- Parameters
-
arcDiff | [out] Distance between arc and line when segmenting the arc. |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - arcDiff is nullptr.
- APIERR_NOTSUPPORTED - Not at export.
- Example
-
◆ ACAPI_ProjectSetting_GetLast3DDefLevels()
GSErrCode ACAPI_ProjectSetting_GetLast3DDefLevels |
( |
const GS::Array< API_ElemType > & | elemTypes, |
|
|
GS::Array< double > & | levels ) |
Retrieves the 3D default levels for the construction elems.
- Since
- Archicad 26
- Parameters
-
elemTypes | [in] The elem types for which you want to obtain the 3D default levels. |
levels | [out] The 3D default levels for the elem types given in the elemIDs array. |
- Returns
- NoError - The function has completed with success.
◆ ACAPI_ProjectSetting_GetOffset()
GSErrCode ACAPI_ProjectSetting_GetOffset |
( |
API_Coord * | offset | ) |
|
Returns the offset of origin of the virtual coordinate system.
- Parameters
-
offset | the offset of the origin of the virtual coordinate system |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - offset is nullptr
- APIERR_BADDATABASE - the command was called for a non-2D window
◆ ACAPI_ProjectSetting_GetPreferences()
GSErrCode ACAPI_ProjectSetting_GetPreferences |
( |
void * | prefs, |
|
|
API_PrefsTypeID | prefsTypeID ) |
Returns the preferences data.
- Parameters
-
prefs | [out] Data of a preferences tab page. The content depends on the prefsType parameter. |
prefsTypeID | [in] The type of the preferences you want to get. |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - prefs is nullptr
- APIERR_BADID - prefsTypeID is invalid.
- APIERR_NOPLAN - No open project.
- APIERR_MEMFULL - Low memory condition.
◆ ACAPI_ProjectSetting_GetProjectNotes()
Returns information about the 'Project Info' dialog.
- Parameters
-
projectNoteInfo | [out] project note data |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - projectNoteInfo is nullptr
- APIERR_NOPLAN - There are no project loaded.
- Example
CHCopyC (
"John Miller", noteInfo.
client);
◆ ACAPI_ProjectSetting_GetSplineMaxDist()
GSErrCode ACAPI_ProjectSetting_GetSplineMaxDist |
( |
API_TestSplineFit * | splinePars, |
|
|
double * | distance ) |
Returns the maximal distance of a spline segment and a set of coordinates.
- Parameters
-
splinePars | [in] the coordinates and the parameters of the spline to test. |
distance | [out] the maximal distance of the coordinates from the requested segment of the spline. |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - any of the parameters are nullptr, or the passed handles have wrong sizes.
◆ ACAPI_ProjectSetting_GetStorySettings()
GSErrCode ACAPI_ProjectSetting_GetStorySettings |
( |
API_StoryInfo * | storyInfo, |
|
|
UInt32 | mask = 0 ) |
Returns the data of the installed stories.
- Parameters
-
storyInfo | [out] parameters of the actual stories. |
mask | Can be APIElemMask_FromFloorplan or nullptr. |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - storyInfo is nullptr.
- APIERR_NOPLAN - No open project.
- APIERR_MEMFULL - Low memory condition.
◆ ACAPI_ProjectSetting_SetLast3DDefLevels()
GSErrCode ACAPI_ProjectSetting_SetLast3DDefLevels |
( |
const GS::Array< API_ElemType > & | elemTypes, |
|
|
const GS::Array< double > & | levels ) |
Sets the 3D default levels for the passed construction element types.
- Since
- Archicad 26
- Parameters
-
elemTypes | [in] Elem types for which you want to set the 3D default levels. |
levels | [in] The default 3D level values. |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - The size of elemTypes differes from the size of levels.
◆ ACAPI_ProjectSetting_SetPreferences()
GSErrCode ACAPI_ProjectSetting_SetPreferences |
( |
void * | prefs, |
|
|
API_PrefsTypeID | prefsTypeID ) |
Adjusts the preferences.
- Parameters
-
prefs | [in] Data of a preferences tab page. The content depends on the prefsType parameter. |
prefsTypeID | [in] The type of the preferences you want to set. |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS -
prefs
is nullptr
, or calculation rules are invalid, or the given dimensioning standard index is invalid.
- APIERR_BADID -
prefsTypeID
is invalid (for example, you cannot set Data Safety preferences)
- APIERR_NOPLAN - No open project.
- APIERR_GENERAL - No dimensioning standards in the project.
◆ ACAPI_ProjectSettings_GetSpecFolder()
GSErrCode ACAPI_ProjectSettings_GetSpecFolder |
( |
API_SpecFolderID * | specFolderID, |
|
|
IO::Location * | location ) |
Returns the location of special folders.
- Parameters
-
specFolderID | [in] A pointer to the type of the folder you are interested in. |
location | [out] The file system location of the required folder. |
- Returns
- NoError - The function has completed with success.
- APIERR_BADPARS - specFolderID contains invalid data, or the location parameter is nullptr
- APIERR_REFUSEDPAR - The requested special folder is not initialized or missing