archicad.releases.ac25¶

archicad.releases.ac25.b3000commands¶

Graphisoft

class archicad.releases.ac25.b3000commands.Commands(req: Request)¶

Bases: object

Collection of the Archicad JSON interface commands

CloneProjectMapItemToViewMap(projectMapNavigatorItemId: NavigatorItemId, parentNavigatorItemId: NavigatorItemId) → NavigatorItemId¶

Clones a project map item to the view map.

Parameters:

projectMapNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.
parentNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.

Returns:

The identifier of a navigator item.

Return type:

NavigatorItemId

CreateLayout(layoutName: str, layoutParameters: LayoutParameters, masterNavigatorItemId: NavigatorItemId, parentNavigatorItemId: NavigatorItemId) → NavigatorItemId¶

Creates a new layout.

Parameters:

layoutName (str) – The name of the layout.
layoutParameters (LayoutParameters) – The parameters of the layout.
masterNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.
parentNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.

Returns:

The identifier of a navigator item.

Return type:

NavigatorItemId

CreateLayoutSubset(subsetParameters: Subset, parentNavigatorItemId: NavigatorItemId) → NavigatorItemId¶

Creates a new layout subset.

Parameters:

subsetParameters (Subset) – A set of options used to assign IDs to the layouts contained in the subset.
parentNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.

Returns:

The identifier of a navigator item.

Return type:

NavigatorItemId

CreateViewMapFolder(folderParameters: FolderParameters, parentNavigatorItemId: NavigatorItemId | None = None, previousNavigatorItemId: NavigatorItemId | None = None) → NavigatorItemId¶

Creates a view folder item at the given position in the navigator tree.

Parameters:

folderParameters (FolderParameters) – The parameters of a folder.
parentNavigatorItemId (NavigatorItemId, optional) – The identifier of a navigator item.
previousNavigatorItemId (NavigatorItemId, optional) – The identifier of a navigator item.

Returns:

The identifier of a navigator item.

Return type:

NavigatorItemId

DeleteNavigatorItems(navigatorItemIds: List[NavigatorItemIdWrapper]) → List[ExecutionResult]¶

Deletes items from navigator tree.

Parameters:: navigatorItemIds (list of NavigatorItemIdWrapper) – A list of navigator item identifiers.
Returns:: A list of execution results.
Return type:: list of ExecutionResult

ExecuteAddOnCommand(addOnCommandId: AddOnCommandId, addOnCommandParameters: AddOnCommandParameters | None = None) → AddOnCommandResponse¶

Executes a command registered in an Add-On.

Parameters:

addOnCommandId (AddOnCommandId) – The identifier of an Add-On command.
addOnCommandParameters (AddOnCommandParameters, optional) – The input parameters of an Add-On command.

Returns:

The response returned by an Add-On command.

Return type:

AddOnCommandResponse

Get2DBoundingBoxes(elements: List[ElementIdArrayItem]) → List[BoundingBox2DOrError]¶

Get the 2D bounding box of elements identified by their GUIDs. The bounding box is calculated from the global origin on the floor plan view. The output is the array of the bounding boxes respective to the input GUIDs. Only works for elements detailed in Element Information.

Parameters:: elements (list of ElementIdArrayItem) – A list of elements.
Returns:: A list of 2D bounding boxes.
Return type:: list of BoundingBox2DOrError

Get3DBoundingBoxes(elements: List[ElementIdArrayItem]) → List[BoundingBox3DOrError]¶

Get the 3D bounding box of elements identified by their GUIDs. The bounding box is calculated from the global origin in the 3D view. The output is the array of the bounding boxes respective to the input GUIDs. Only works for elements detailed in Element Information.

Parameters:: elements (list of ElementIdArrayItem) – A list of elements.
Returns:: A list of 3D bounding boxes.
Return type:: list of BoundingBox3DOrError

GetActivePenTables() → Tuple[AttributeIdOrError, AttributeIdOrError]¶

Returns the model view and layout book pen table identifiers.

Returns:: The attribute’s identifier or an error. AttributeIdOrError: The attribute’s identifier or an error.
Return type:: AttributeIdOrError

GetAllClassificationSystems() → List[ClassificationSystem]¶

Returns the list of available classification systems.

Returns:: A list of classification systems.
Return type:: list of ClassificationSystem

GetAllClassificationsInSystem(classificationSystemId: ClassificationSystemId) → List[ClassificationItemArrayItem]¶

Returns the tree of classifications in the given classification system.

Parameters:: classificationSystemId (ClassificationSystemId) – The identifier of a classification system.
Returns:: A list of classification items.
Return type:: list of ClassificationItemArrayItem

GetAllElements() → List[ElementIdArrayItem]¶

Returns the identifier of every element in the current plan.

Returns:: A list of elements.
Return type:: list of ElementIdArrayItem

GetAllPropertyNames() → List[PropertyUserId]¶

Returns the human-readable names of available Property definitions for debug and development purposes.

Returns:: A list of PropertyUserId objects.
Return type:: list of PropertyUserId

GetAttributesByType(attributeType: str) → List[AttributeIdWrapperItem]¶

Returns the identifier of every attribute of the given type.

Parameters:: attributeType (str) – The type of an attribute.
Returns:: A list of attribute identifiers.
Return type:: list of AttributeIdWrapperItem

GetBuildingMaterialAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[BuildingMaterialAttributeOrError]¶

Returns the detailed building material attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of building material attributes and potential errors.
Return type:: list of BuildingMaterialAttributeOrError

GetClassificationsOfElements(elements: List[ElementIdArrayItem], classificationSystemIds: List[ClassificationSystemIdArrayItem]) → List[ElementClassificationOrError]¶

Returns the classification of the given elements in the given classification systems.

Parameters:

elements (list of ElementIdArrayItem) – A list of elements.
classificationSystemIds (list of ClassificationSystemIdArrayItem) – A list of classification system identifiers.

Returns:

A list of element classification identifiers or errors.

Return type:

list of ElementClassificationOrError

GetComponentsOfElements(elements: List[ElementIdArrayItem]) → List[ElementComponentsOrError]¶

Returns the identifier of every component for a list of elements. The order of the returned list is the same as the given elements.

Parameters:: elements (list of ElementIdArrayItem) – A list of elements.
Returns:: Array of component list or error.
Return type:: list of ElementComponentsOrError

GetCompositeAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[CompositeAttributeOrError]¶

Returns the detailed composite attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of the composite attributes and potential errors.
Return type:: list of CompositeAttributeOrError

GetDetailsOfClassificationItems(classificationItemIds: List[ClassificationItemIdArrayItem]) → List[ClassificationItemOrError]¶

Returns the details of classification items.

Parameters:: classificationItemIds (list of ClassificationItemIdArrayItem) – A list of classification item identifiers.
Returns:: A list of classification items or errors.
Return type:: list of ClassificationItemOrError

GetDetailsOfProperties(properties: List[PropertyIdArrayItem]) → List[PropertyDefinitionOrError]¶

Returns the details of property definitions.

Parameters:: properties (list of PropertyIdArrayItem) – A list of property identifiers.
Returns:: A list of property definitions or errors.
Return type:: list of PropertyDefinitionOrError

GetElementsByClassification(classificationItemId: ClassificationItemId) → List[ElementIdArrayItem]¶

Returns the identifier of every element with the given classification identifier.

Parameters:: classificationItemId (ClassificationItemId) – The identifier of a classification item.
Returns:: A list of elements.
Return type:: list of ElementIdArrayItem

GetElementsByType(elementType: str) → List[ElementIdArrayItem]¶

Returns the identifier of every element of the given type on the plan.

Parameters:: elementType (str) – The type of an element.
Returns:: A list of elements.
Return type:: list of ElementIdArrayItem

GetElementsRelatedToZones(zones: List[ElementIdArrayItem], elementTypes: List[str] | None = None) → List[ElementsOrError]¶

Returns related elements of the given zones. The related elements will be grouped by type. If multiple zones was given, then the order of the returned list is that of the given zones.

Parameters:

zones (list of ElementIdArrayItem) – A list of elements.
elementTypes (list of str, optional) – A list of element types.

Returns:

A list of ElementsOrError items.

Return type:

list of ElementsOrError

GetFillAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[FillAttributeOrError]¶

Returns the detailed fill attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of fill attributes and potential errors.
Return type:: list of FillAttributeOrError

GetLayerAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[LayerAttributeOrError]¶

Returns the detailed layer attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of layer attributes and potential errors.
Return type:: list of LayerAttributeOrError

GetLayerCombinationAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[LayerCombinationAttributeOrError]¶

Returns the detailed layer combination attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of layer combination attributes and potential errors.
Return type:: list of LayerCombinationAttributeOrError

GetLayoutSettings(layoutNavigatorItemId: NavigatorItemId) → LayoutParameters¶

Returns the parameters (settings) of the given layout.

Parameters:: layoutNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.
Returns:: The parameters of the layout.
Return type:: LayoutParameters

GetLineAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[LineAttributeOrError]¶

Returns the detailed line attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of line attributes and potential errors.
Return type:: list of LineAttributeOrError

GetNavigatorItemTree(navigatorTreeId: NavigatorTreeId) → NavigatorTree¶

Returns the tree of navigator items.

Parameters:: navigatorTreeId (NavigatorTreeId) – The identifier of a navigator item tree.
Returns:: A tree of navigator items.
Return type:: NavigatorTree

GetPenTableAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[PenTableAttributeOrError]¶

Returns the detailed pen table attributes (including their pens) identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of pen table attributes and potential errors.
Return type:: list of PenTableAttributeOrError

GetProductInfo() → Tuple[int, int, str]¶

Accesses the version information from the running Archicad.

Returns:: The version of the running Archicad. int: The build number of the running Archicad. str: The language code of the running Archicad.
Return type:: int

GetProfileAttributePreview(attributeIds: List[AttributeIdWrapperItem], imageWidth: int, imageHeight: int, backgroundColor: RGBColor | None = None) → List[ImageOrError]¶

Returns the preview image of each requested profile attribute in a base64 string format.

Parameters:

attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
imageWidth (int) – The width of the preview image.
imageHeight (int) – The height of the preview image.
backgroundColor (RGBColor, optional) – A color model represented via its red, green and blue components.

Returns:

A list of images and potential errors.

Return type:

list of ImageOrError

GetProfileAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[ProfileAttributeOrError]¶

Returns the detailed profile attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of the profile attributes and potential errors.
Return type:: list of ProfileAttributeOrError

GetPropertyIds(properties: List[PropertyUserId]) → List[PropertyIdOrError]¶

Returns the identifiers of property definitions for the requested property names.

Parameters:: properties (list of PropertyUserId) – A list of PropertyUserId objects.
Returns:: A list of property identifiers or errors.
Return type:: list of PropertyIdOrError

GetPropertyValuesOfElementComponents(elementComponents: List[ElementComponentIdArrayItem], properties: List[PropertyIdArrayItem]) → List[PropertyValuesOrError]¶

Returns the property values of the components for the given property.

Parameters:

elementComponents (list of ElementComponentIdArrayItem) – List of components of elements.
properties (list of PropertyIdArrayItem) – A list of property identifiers.

Returns:

A list of property value lists.

Return type:

list of PropertyValuesOrError

GetPropertyValuesOfElements(elements: List[ElementIdArrayItem], properties: List[PropertyIdArrayItem]) → List[PropertyValuesOrError]¶

Returns the property values of the elements for the given property.

Parameters:

elements (list of ElementIdArrayItem) – A list of elements.
properties (list of PropertyIdArrayItem) – A list of property identifiers.

Returns:

A list of property value lists.

Return type:

list of PropertyValuesOrError

GetPublisherSetNames() → List[str]¶

Returns the names of available publisher sets.

Returns:: The names of available publisher sets.
Return type:: list of str

GetSurfaceAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[SurfaceAttributeOrError]¶

Returns the detailed surface attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of surface attributes and potential errors.
Return type:: list of SurfaceAttributeOrError

GetZoneCategoryAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[ZoneCategoryAttributeOrError]¶

Returns the detailed zone category attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of zone category attributes and potential errors.
Return type:: list of ZoneCategoryAttributeOrError

IsAddOnCommandAvailable(addOnCommandId: AddOnCommandId) → bool¶

Checks if the command is available or not.

Parameters:: addOnCommandId (AddOnCommandId) – The identifier of an Add-On command.
Returns:: Returns true if the command is available.
Return type:: bool

IsAlive() → bool¶

Checks if the Archicad connection is alive.

Returns:: Returns true if the connection is alive.
Return type:: bool

MoveNavigatorItem(navigatorItemIdToMove: NavigatorItemId, parentNavigatorItemId: NavigatorItemId, previousNavigatorItemId: NavigatorItemId | None = None)¶

Moves the given navigator item under the parentNavigatorItemId in the navigator tree. If previousNavigatorItemId is not given then inserts it at the first place under the new parent. If it is given then inserts it after this navigator item.

Parameters:

navigatorItemIdToMove (NavigatorItemId) – The identifier of a navigator item.
parentNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.
previousNavigatorItemId (NavigatorItemId, optional) – The identifier of a navigator item.

RenameNavigatorItem(navigatorItemId: NavigatorItemId, newName: str | None = None, newId: str | None = None)¶

Renames an existing navigator item by specifying either the name or the ID, or both.

Parameters:

navigatorItemId (NavigatorItemId) – The identifier of a navigator item.
newName (str, optional) – New name of the navigator item.
newId (str, optional) – New ID of the navigator item.

SetClassificationsOfElements(elementClassifications: List[ElementClassification]) → List[ExecutionResult]¶

Sets the classifications of elements. In order to set the classification of an element to unclassified, omit the classificationItemId field.

Parameters:: elementClassifications (list of ElementClassification) – A list of element classification identifiers.
Returns:: A list of execution results.
Return type:: list of ExecutionResult

SetLayoutSettings(layoutParameters: LayoutParameters, layoutNavigatorItemId: NavigatorItemId)¶

Sets the parameters (settings) of the given layout.

Parameters:

layoutParameters (LayoutParameters) – The parameters of the layout.
layoutNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.

SetPropertyValuesOfElements(elementPropertyValues: List[ElementPropertyValue]) → List[ExecutionResult]¶

Sets the property values of elements.

Parameters:: elementPropertyValues (list of ElementPropertyValue) – A list of element property values.
Returns:: A list of execution results.
Return type:: list of ExecutionResult

__init__(req: Request)¶

__weakref__¶: list of weak references to the object (if defined)

exception archicad.releases.ac25.b3000commands.UnsucceededCommandCall¶

Bases: Exception

__weakref__¶: list of weak references to the object (if defined)

archicad.releases.ac25.b3000types¶

Graphisoft

class archicad.releases.ac25.b3000types.AddOnCommandId(commandNamespace: str, commandName: str)¶

Bases: _ACBaseType

The identifier of an Add-On command.

Variables:

commandNamespace (str) – The namespace of the Add-On command.
commandName (str) – The name of the Add-On command.

__init__(commandNamespace: str, commandName: str)¶

class archicad.releases.ac25.b3000types.AddOnCommandIdArrayItem(addOnCommandId: AddOnCommandId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: addOnCommandId (AddOnCommandId) – The identifier of an Add-On command.

__init__(addOnCommandId: AddOnCommandId)¶

class archicad.releases.ac25.b3000types.AddOnCommandParameters¶

Bases: _ACBaseType

The input parameters of an Add-On command.

__init__()¶

__weakref__¶: list of weak references to the object (if defined)

class archicad.releases.ac25.b3000types.AddOnCommandResponse¶

Bases: _ACBaseType

The response returned by an Add-On command.

__init__()¶

__weakref__¶: list of weak references to the object (if defined)

class archicad.releases.ac25.b3000types.AttributeHeader(attributeId: AttributeId, name: str)¶

Bases: _ACBaseType

The header object of an attribute.

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.

__init__(attributeId: AttributeId, name: str)¶

class archicad.releases.ac25.b3000types.AttributeId(guid: UUID)¶

Bases: _ACBaseType

The identifier of an attribute.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b3000types.AttributeIdOrError(attributeId: AttributeId | None = None, error: Error | None = None)¶

Bases: _ACUnionType

The attribute’s identifier or an error.

Variables:

attributeId (AttributeId, optional) – The identifier of an attribute.
error (Error, optional) – The details of an error.

__init__(attributeId: AttributeId | None = None, error: Error | None = None)¶

static __new__(cls, attributeId: AttributeId | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.AttributeIdWrapperItem(attributeId: AttributeId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: attributeId (AttributeId) – The identifier of an attribute.

__init__(attributeId: AttributeId)¶

class archicad.releases.ac25.b3000types.BoundingBox2D(xMin: float, yMin: float, xMax: float, yMax: float)¶

Bases: _ACBaseType

The 2D bounding box of an element.

Variables:

xMin (float) – The minimum X value of the bounding box.
yMin (float) – The minimum Y value of the bounding box.
xMax (float) – The maximum X value of the bounding box.
yMax (float) – The maximum Y value of the bounding box.

__init__(xMin: float, yMin: float, xMax: float, yMax: float)¶

class archicad.releases.ac25.b3000types.BoundingBox2DOrError(boundingBox2D: BoundingBox2D | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A 2D bounding box or an error.

Variables:

boundingBox2D (BoundingBox2D, optional) – The 2D bounding box of an element.
error (Error, optional) – The details of an error.

__init__(boundingBox2D: BoundingBox2D | None = None, error: Error | None = None)¶

static __new__(cls, boundingBox2D: BoundingBox2D | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.BoundingBox2DWrapper(boundingBox2D: BoundingBox2D)¶

Bases: _ACBaseType

Variables:: boundingBox2D (BoundingBox2D) – The 2D bounding box of an element.

__init__(boundingBox2D: BoundingBox2D)¶

class archicad.releases.ac25.b3000types.BoundingBox3D(xMin: float, yMin: float, zMin: float, xMax: float, yMax: float, zMax: float)¶

Bases: _ACBaseType

A 3D bounding box of an element.

Variables:

xMin (float) – The minimum X value of the bounding box.
yMin (float) – The minimum Y value of the bounding box.
zMin (float) – The minimum Z value of the bounding box.
xMax (float) – The maximum X value of the bounding box.
yMax (float) – The maximum Y value of the bounding box.
zMax (float) – The maximum Z value of the bounding box.

__init__(xMin: float, yMin: float, zMin: float, xMax: float, yMax: float, zMax: float)¶

class archicad.releases.ac25.b3000types.BoundingBox3DOrError(boundingBox3D: BoundingBox3D | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A 3D bounding box or an error.

Variables:

boundingBox3D (BoundingBox3D, optional) – A 3D bounding box of an element.
error (Error, optional) – The details of an error.

__init__(boundingBox3D: BoundingBox3D | None = None, error: Error | None = None)¶

static __new__(cls, boundingBox3D: BoundingBox3D | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.BoundingBox3DWrapper(boundingBox3D: BoundingBox3D)¶

Bases: _ACBaseType

Variables:: boundingBox3D (BoundingBox3D) – A 3D bounding box of an element.

__init__(boundingBox3D: BoundingBox3D)¶

class archicad.releases.ac25.b3000types.BuildingMaterialAttribute(attributeId: AttributeId, name: str, id: str, connectionPriority: int, cutFillId: AttributeIdOrError, cutFillPenIndex: int, cutSurfaceId: AttributeIdOrError)¶

Bases: _ACBaseType

A building material attribute

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
id (str) – The id of the building material.
connectionPriority (int) – The connection priority of the building material.
cutFillId (AttributeIdOrError) – The attribute’s identifier or an error.
cutFillPenIndex (int) – The index number of a pen.
cutSurfaceId (AttributeIdOrError) – The attribute’s identifier or an error.

__init__(attributeId: AttributeId, name: str, id: str, connectionPriority: int, cutFillId: AttributeIdOrError, cutFillPenIndex: int, cutSurfaceId: AttributeIdOrError)¶

class archicad.releases.ac25.b3000types.BuildingMaterialAttributeOrError(buildingMaterialAttribute: BuildingMaterialAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A building material attribute or an error.

Variables:

buildingMaterialAttribute (BuildingMaterialAttribute, optional) – A building material attribute
error (Error, optional) – The details of an error.

__init__(buildingMaterialAttribute: BuildingMaterialAttribute | None = None, error: Error | None = None)¶

static __new__(cls, buildingMaterialAttribute: BuildingMaterialAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.BuildingMaterialAttributeWrapper(buildingMaterialAttribute: BuildingMaterialAttribute)¶

Bases: _ACBaseType

Variables:: buildingMaterialAttribute (BuildingMaterialAttribute) – A building material attribute

__init__(buildingMaterialAttribute: BuildingMaterialAttribute)¶

class archicad.releases.ac25.b3000types.BuiltInPropertyUserId(nonLocalizedName: str, type: str = 'BuiltIn')¶

Bases: _ACBaseType

The unique identifier of a Built-In Property, identified by its name.

Variables:

nonLocalizedName (str) – The non-localized name of the Built-In Property.
type (str) – EMPTY STRING

__init__(nonLocalizedName: str, type: str = 'BuiltIn')¶

class archicad.releases.ac25.b3000types.ClassificationId(classificationSystemId: ClassificationSystemId, classificationItemId: ClassificationItemId | None = None)¶

Bases: _ACBaseType

The element classification identifier.

Variables:

classificationSystemId (ClassificationSystemId) – The identifier of a classification system.
classificationItemId (ClassificationItemId, optional) – The identifier of a classification item.

__init__(classificationSystemId: ClassificationSystemId, classificationItemId: ClassificationItemId | None = None)¶

class archicad.releases.ac25.b3000types.ClassificationIdOrError(classificationId: ClassificationId | None = None, error: Error | None = None)¶

Bases: _ACUnionType

EMPTY STRING

Variables:

classificationId (ClassificationId, optional) – The element classification identifier.
error (Error, optional) – The details of an error.

__init__(classificationId: ClassificationId | None = None, error: Error | None = None)¶

static __new__(cls, classificationId: ClassificationId | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.ClassificationIdWrapper(classificationId: ClassificationId)¶

Bases: _ACBaseType

Variables:: classificationId (ClassificationId) – The element classification identifier.

__init__(classificationId: ClassificationId)¶

class archicad.releases.ac25.b3000types.ClassificationIdsOrErrorsWrapper(classificationIds: List[ClassificationIdOrError])¶

Bases: _ACBaseType

Variables:: classificationIds (list of ClassificationIdOrError) – A list of element classification identifiers or errors.

__init__(classificationIds: List[ClassificationIdOrError])¶

class archicad.releases.ac25.b3000types.ClassificationItemArrayItem(classificationItem: ClassificationItemInTree_)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: classificationItem (ClassificationItemInTree_) – The details of a classification item.

__init__(classificationItem: ClassificationItemInTree_)¶

class archicad.releases.ac25.b3000types.ClassificationItemDetails(id: str, name: str, description: str)¶

Bases: _ACBaseType

The details of a classification item.

Variables:

id (str) – The unique identifier of the classification item as specified by the user.
name (str) – The display name of the classification item.
description (str) – The description of the classification item.

__init__(id: str, name: str, description: str)¶

class archicad.releases.ac25.b3000types.ClassificationItemDetailsWrapper(classificationItem: ClassificationItemDetails)¶

Bases: _ACBaseType

Variables:: classificationItem (ClassificationItemDetails) – The details of a classification item.

__init__(classificationItem: ClassificationItemDetails)¶

class archicad.releases.ac25.b3000types.ClassificationItemId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a classification item.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b3000types.ClassificationItemIdArrayItem(classificationItemId: ClassificationItemId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: classificationItemId (ClassificationItemId) – The identifier of a classification item.

__init__(classificationItemId: ClassificationItemId)¶

class archicad.releases.ac25.b3000types.ClassificationItemInTree(classificationItemId: ClassificationItemId, id: str, name: str, description: str, children: List[ClassificationItemArrayItem] | None = None)¶

Bases: _ACBaseType

The details of a classification item.

Variables:

classificationItemId (ClassificationItemId) – The identifier of a classification item.
id (str) – The unique identifier of the classification item as specified by the user.
name (str) – The display name of the classification item.
description (str) – The description of the classification item.
children (list of ClassificationItemArrayItem, optional) – A list of classification items.

__init__(classificationItemId: ClassificationItemId, id: str, name: str, description: str, children: List[ClassificationItemArrayItem] | None = None)¶

archicad.releases.ac25.b3000types.ClassificationItemInTree_¶: alias of ClassificationItemInTree

class archicad.releases.ac25.b3000types.ClassificationItemOrError(classificationItem: ClassificationItemDetails | None = None, error: Error | None = None)¶

Bases: _ACUnionType

EMPTY STRING

Variables:

classificationItem (ClassificationItemDetails, optional) – The details of a classification item.
error (Error, optional) – The details of an error.

__init__(classificationItem: ClassificationItemDetails | None = None, error: Error | None = None)¶

static __new__(cls, classificationItem: ClassificationItemDetails | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.ClassificationSystem(classificationSystemId: ClassificationSystemId, name: str, description: str, source: str, version: str, date: str)¶

Bases: _ACBaseType

The details of a classification system.

Variables:

classificationSystemId (ClassificationSystemId) – The identifier of a classification system.
name (str) – The display name of the classification system.
description (str) – The description of the classification system.
source (str) – The source of the classification system (e.g. URL to a classification system standard).
version (str) – The version of the classification system.
date (str) – A date in its string representation as defined in ISO 8601: YYYY-MM-DD.

__init__(classificationSystemId: ClassificationSystemId, name: str, description: str, source: str, version: str, date: str)¶

class archicad.releases.ac25.b3000types.ClassificationSystemId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a classification system.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b3000types.ClassificationSystemIdArrayItem(classificationSystemId: ClassificationSystemId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: classificationSystemId (ClassificationSystemId) – The identifier of a classification system.

__init__(classificationSystemId: ClassificationSystemId)¶

class archicad.releases.ac25.b3000types.ComponentId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a component.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b3000types.CompositeAttribute(attributeId: AttributeId, name: str, totalThickness: float, compositeSkins: List[CompositeSkinListItem], compositeLines: List[CompositeLineListItem], useWith: List[str])¶

Bases: _ACBaseType

A composite attribute.

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
totalThickness (float) – The total thickness of the composite.
compositeSkins (list of CompositeSkinListItem) – A list of composite skins.
compositeLines (list of CompositeLineListItem) – A list of contour/separator lines for the composite.
useWith (list of str) – A list of element types.

__init__(attributeId: AttributeId, name: str, totalThickness: float, compositeSkins: List[CompositeSkinListItem], compositeLines: List[CompositeLineListItem], useWith: List[str])¶

class archicad.releases.ac25.b3000types.CompositeAttributeOrError(compositeAttribute: CompositeAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A composite attribute or an error.

Variables:

compositeAttribute (CompositeAttribute, optional) – A composite attribute.
error (Error, optional) – The details of an error.

__init__(compositeAttribute: CompositeAttribute | None = None, error: Error | None = None)¶

static __new__(cls, compositeAttribute: CompositeAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.CompositeAttributeWrapper(compositeAttribute: CompositeAttribute)¶

Bases: _ACBaseType

Variables:: compositeAttribute (CompositeAttribute) – A composite attribute.

__init__(compositeAttribute: CompositeAttribute)¶

class archicad.releases.ac25.b3000types.CompositeLine(lineId: AttributeIdOrError, linePenIndex: int | None = None)¶

Bases: _ACBaseType

A contour or separator line component for a composite attribute.

Variables:

lineId (AttributeIdOrError) – The attribute’s identifier or an error.
linePenIndex (int, optional) – The index number of a pen.

__init__(lineId: AttributeIdOrError, linePenIndex: int | None = None)¶

class archicad.releases.ac25.b3000types.CompositeLineListItem(compositeLine: CompositeLine)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: compositeLine (CompositeLine) – A contour or separator line component for a composite attribute.

__init__(compositeLine: CompositeLine)¶

class archicad.releases.ac25.b3000types.CompositeSkin(buildingMaterialId: AttributeIdOrError, thickness: float, isCore: bool, isFinish: bool, framePenIndex: int | None = None)¶

Bases: _ACBaseType

A skin component for a composite attribute.

Variables:

buildingMaterialId (AttributeIdOrError) – The attribute’s identifier or an error.
thickness (float) – The thickness of the composite skin.
isCore (bool) – Defines whether the composite skin is part of the core or not.
isFinish (bool) – Defines whether the composite skin is part of the finish or not.
framePenIndex (int, optional) – The index number of a pen.

__init__(buildingMaterialId: AttributeIdOrError, thickness: float, isCore: bool, isFinish: bool, framePenIndex: int | None = None)¶

class archicad.releases.ac25.b3000types.CompositeSkinListItem(compositeSkin: CompositeSkin)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: compositeSkin (CompositeSkin) – A skin component for a composite attribute.

__init__(compositeSkin: CompositeSkin)¶

class archicad.releases.ac25.b3000types.DashItem(dash: float, gap: float)¶

Bases: _ACBaseType

A dash item.

Variables:

dash (float) – The length of the dash.
gap (float) – The length of the gap.

__init__(dash: float, gap: float)¶

class archicad.releases.ac25.b3000types.DashItemWrapper(dashItem: DashItem)¶

Bases: _ACBaseType

Variables:: dashItem (DashItem) – A dash item.

__init__(dashItem: DashItem)¶

class archicad.releases.ac25.b3000types.DashOrLineItem(dashItem: DashItem | None = None, lineItem: LineItem | None = None)¶

Bases: _ACUnionType

A dash or line item.

Variables:

dashItem (DashItem, optional) – A dash item.
lineItem (LineItem, optional) – A line item.

__init__(dashItem: DashItem | None = None, lineItem: LineItem | None = None)¶

static __new__(cls, dashItem: DashItem | None = None, lineItem: LineItem | None = None)¶

class archicad.releases.ac25.b3000types.DisplayValueEnumId(displayValue: str, type: str = 'displayValue')¶

Bases: _ACBaseType

An enumeration value identifier using the displayed value.

Variables:

displayValue (str) – EMPTY STRING
type (str) – EMPTY STRING

__init__(displayValue: str, type: str = 'displayValue')¶

class archicad.releases.ac25.b3000types.ElementClassification(elementId: ElementId, classificationId: ClassificationId)¶

Bases: _ACBaseType

The classification of an element.

Variables:

elementId (ElementId) – The identifier of an element.
classificationId (ClassificationId) – The element classification identifier.

__init__(elementId: ElementId, classificationId: ClassificationId)¶

class archicad.releases.ac25.b3000types.ElementClassificationOrError(classificationIds: List[ClassificationIdOrError] | None = None, error: Error | None = None)¶

Bases: _ACUnionType

Element classification identifiers or errors.

Variables:

classificationIds (list of ClassificationIdOrError, optional) – A list of element classification identifiers or errors.
error (Error, optional) – The details of an error.

__init__(classificationIds: List[ClassificationIdOrError] | None = None, error: Error | None = None)¶

static __new__(cls, classificationIds: List[ClassificationIdOrError] | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.ElementComponentId(elementId: ElementId, componentId: ComponentId)¶

Bases: _ACBaseType

The identifier of an element’s component.

Variables:

elementId (ElementId) – The identifier of an element.
componentId (ComponentId) – The identifier of a component.

__init__(elementId: ElementId, componentId: ComponentId)¶

class archicad.releases.ac25.b3000types.ElementComponentIdArrayItem(elementComponentId: ElementComponentId)¶

Bases: _ACBaseType

An item of a component array.

Variables:: elementComponentId (ElementComponentId) – The identifier of an element’s component.

__init__(elementComponentId: ElementComponentId)¶

class archicad.releases.ac25.b3000types.ElementComponentsOrError(elementComponents: List[ElementComponentIdArrayItem] | None = None, error: Error | None = None)¶

Bases: _ACUnionType

List of components or error.

Variables:

elementComponents (list of ElementComponentIdArrayItem, optional) – List of components of elements.
error (Error, optional) – The details of an error.

__init__(elementComponents: List[ElementComponentIdArrayItem] | None = None, error: Error | None = None)¶

static __new__(cls, elementComponents: List[ElementComponentIdArrayItem] | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.ElementComponentsWrapper(elementComponents: List[ElementComponentIdArrayItem])¶

Bases: _ACBaseType

List of components.

Variables:: elementComponents (list of ElementComponentIdArrayItem) – List of components of elements.

__init__(elementComponents: List[ElementComponentIdArrayItem])¶

class archicad.releases.ac25.b3000types.ElementId(guid: UUID)¶

Bases: _ACBaseType

The identifier of an element.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b3000types.ElementIdArrayItem(elementId: ElementId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: elementId (ElementId) – The identifier of an element.

__init__(elementId: ElementId)¶

class archicad.releases.ac25.b3000types.ElementPropertyValue(elementId: ElementId, propertyId: PropertyId, propertyValue: NormalOrUserUndefinedPropertyValue)¶

Bases: _ACBaseType

A property value with the identifiers of the property and its owner element.

Variables:

elementId (ElementId) – The identifier of an element.
propertyId (PropertyId) – The identifier of a property.
propertyValue (NormalOrUserUndefinedPropertyValue) – A normal or a userUndefined property value.

__init__(elementId: ElementId, propertyId: PropertyId, propertyValue: NormalOrUserUndefinedPropertyValue)¶

class archicad.releases.ac25.b3000types.ElementsOrError(elements: List[ElementIdArrayItem] | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A list of elements or an error.

Variables:

elements (list of ElementIdArrayItem, optional) – A list of elements.
error (Error, optional) – The details of an error.

__init__(elements: List[ElementIdArrayItem] | None = None, error: Error | None = None)¶

static __new__(cls, elements: List[ElementIdArrayItem] | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.ElementsWrapper(elements: List[ElementIdArrayItem])¶

Bases: _ACBaseType

A wrapper for a list of elements.

Variables:: elements (list of ElementIdArrayItem) – A list of elements.

__init__(elements: List[ElementIdArrayItem])¶

class archicad.releases.ac25.b3000types.EnumValueId(type: str, displayValue: str | None = None, nonLocalizedValue: str | None = None)¶

Bases: _ACUnionType

The identifier of a property enumeration value.

Variables:

type (str) – None
displayValue (str, optional) – EMPTY STRING
nonLocalizedValue (str, optional) – EMPTY STRING

__init__(type: str, displayValue: str | None = None, nonLocalizedValue: str | None = None)¶

static __new__(cls, type: str, displayValue: str | None = None, nonLocalizedValue: str | None = None)¶

class archicad.releases.ac25.b3000types.EnumValueIdWrapper(enumValueId: EnumValueId)¶

Bases: _ACBaseType

Variables:: enumValueId (EnumValueId) – The identifier of a property enumeration value.

__init__(enumValueId: EnumValueId)¶

class archicad.releases.ac25.b3000types.Error(code: int, message: str)¶

Bases: _ACBaseType

The details of an error.

Variables:

code (int) – The code of the error.
message (str) – The error message.

__init__(code: int, message: str)¶

class archicad.releases.ac25.b3000types.ErrorItem(error: Error)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: error (Error) – The details of an error.

__init__(error: Error)¶

class archicad.releases.ac25.b3000types.ExecutionResult(success: bool, error: Error | None = None)¶

Bases: _ACUnionType

The result of the execution.

Variables:

success (bool) – None
error (Error, optional) – The details of an error.

__init__(success: bool, error: Error | None = None)¶

static __new__(cls, success: bool, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.FailedExecutionResult(success: bool, error: Error)¶

Bases: _ACBaseType

EMPTY STRING

Variables:

success (bool) – EMPTY STRING
error (Error) – The details of an error.

__init__(success: bool, error: Error)¶

class archicad.releases.ac25.b3000types.FillAttribute(attributeId: AttributeId, name: str, subType: str, pattern: int, appearanceType: str)¶

Bases: _ACBaseType

A fill attribute.

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
subType (str) – The filling type of a fill attribute.
pattern (int) – The pattern of the fill attribute, stored in a 64 bit unsigned integer, and represented as an 8x8 matrix. Each byte in the value is a row, and the bits are the columns of the matrix.
appearanceType (str) – The appearance type of a line or fill attribute.

__init__(attributeId: AttributeId, name: str, subType: str, pattern: int, appearanceType: str)¶

class archicad.releases.ac25.b3000types.FillAttributeOrError(fillAttribute: FillAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A fill attribute or an error.

Variables:

fillAttribute (FillAttribute, optional) – A fill attribute.
error (Error, optional) – The details of an error.

__init__(fillAttribute: FillAttribute | None = None, error: Error | None = None)¶

static __new__(cls, fillAttribute: FillAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.FillAttributeWrapper(fillAttribute: FillAttribute)¶

Bases: _ACBaseType

Variables:: fillAttribute (FillAttribute) – A fill attribute.

__init__(fillAttribute: FillAttribute)¶

class archicad.releases.ac25.b3000types.FolderParameters(name: str)¶

Bases: _ACBaseType

The parameters of a folder.

Variables:: name (str) – The name of the folder.

__init__(name: str)¶

class archicad.releases.ac25.b3000types.Image(content: str)¶

Bases: _ACBaseType

An image encoded as a Base64 string.

Variables:: content (str) – The image content as a string .

__init__(content: str)¶

class archicad.releases.ac25.b3000types.ImageOrError(image: Image | None = None, error: Error | None = None)¶

Bases: _ACUnionType

An image or an error.

Variables:

image (Image, optional) – An image encoded as a Base64 string.
error (Error, optional) – The details of an error.

__init__(image: Image | None = None, error: Error | None = None)¶

static __new__(cls, image: Image | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.ImageWrapper(image: Image)¶

Bases: _ACBaseType

Variables:: image (Image) – An image encoded as a Base64 string.

__init__(image: Image)¶

class archicad.releases.ac25.b3000types.LayerAttribute(attributeId: AttributeId, name: str, intersectionGroupNr: int, isLocked: bool, isHidden: bool, isWireframe: bool)¶

Bases: _ACBaseType

A layer attribute

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
intersectionGroupNr (int) – The intersection group number
isLocked (bool) – Defines whether the layer is locked or not.
isHidden (bool) – Defines whether the layer is hidden or not.
isWireframe (bool) – Defines whether the elements placed on this layer are visible as wireframes or a solid model.

__init__(attributeId: AttributeId, name: str, intersectionGroupNr: int, isLocked: bool, isHidden: bool, isWireframe: bool)¶

class archicad.releases.ac25.b3000types.LayerAttributeOrError(layerAttribute: LayerAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A layer attribute or an error.

Variables:

layerAttribute (LayerAttribute, optional) – A layer attribute
error (Error, optional) – The details of an error.

__init__(layerAttribute: LayerAttribute | None = None, error: Error | None = None)¶

static __new__(cls, layerAttribute: LayerAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.LayerAttributeWrapper(layerAttribute: LayerAttribute)¶

Bases: _ACBaseType

Variables:: layerAttribute (LayerAttribute) – A layer attribute

__init__(layerAttribute: LayerAttribute)¶

class archicad.releases.ac25.b3000types.LayerCombinationAttribute(attributeId: AttributeId, name: str, layerAttributeIds: List[AttributeIdWrapperItem])¶

Bases: _ACBaseType

A layer combination attribute

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
layerAttributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.

__init__(attributeId: AttributeId, name: str, layerAttributeIds: List[AttributeIdWrapperItem])¶

class archicad.releases.ac25.b3000types.LayerCombinationAttributeOrError(layerCombinationAttribute: LayerCombinationAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A layer combination attribute or an error.

Variables:

layerCombinationAttribute (LayerCombinationAttribute, optional) – A layer combination attribute
error (Error, optional) – The details of an error.

__init__(layerCombinationAttribute: LayerCombinationAttribute | None = None, error: Error | None = None)¶

static __new__(cls, layerCombinationAttribute: LayerCombinationAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.LayerCombinationAttributeWrapper(layerCombinationAttribute: LayerCombinationAttribute)¶

Bases: _ACBaseType

Variables:: layerCombinationAttribute (LayerCombinationAttribute) – A layer combination attribute

__init__(layerCombinationAttribute: LayerCombinationAttribute)¶

class archicad.releases.ac25.b3000types.LayoutParameters(horizontalSize: float, verticalSize: float, leftMargin: float, topMargin: float, rightMargin: float, bottomMargin: float, customLayoutNumber: str, customLayoutNumbering: bool, doNotIncludeInNumbering: bool, displayMasterLayoutBelow: bool, layoutPageNumber: int, actPageIndex: int, currentRevisionId: str, currentFinalRevisionId: str, hasIssuedRevision: bool, hasActualRevision: bool)¶

Bases: _ACBaseType

The parameters of the layout.

Variables:

horizontalSize (float) – The horizontal size of the layout in millimeters.
verticalSize (float) – The vertical size of the layout in millimeters.
leftMargin (float) – The layout margin from the left side of the paper.
topMargin (float) – The layout margin from the top side of the paper.
rightMargin (float) – The layout margin from the right side of the paper.
bottomMargin (float) – The layout margin from the bottom side of the paper.
customLayoutNumber (str) – The custom ID.
customLayoutNumbering (bool) – Defines whether a unique ID is used for the current layout or not.
doNotIncludeInNumbering (bool) – Defines whether this layout is included in automatic ID assignment or not.
displayMasterLayoutBelow (bool) – Defines whether to display the master layout above or below the layout.
layoutPageNumber (int) – The page number of layout when this layout contains multi-page drawings.
actPageIndex (int) – The actual index of layout inside the multi-page layout.
currentRevisionId (str) – The ID of the current document revision of the layout.
currentFinalRevisionId (str) – The ID with optional suffix of the current document revision of the layout.
hasIssuedRevision (bool) – Defines whether one or more issued document revisions have already been created for the layout or not.
hasActualRevision (bool) – Defines whether an open document revision exists for the layout or not.

__init__(horizontalSize: float, verticalSize: float, leftMargin: float, topMargin: float, rightMargin: float, bottomMargin: float, customLayoutNumber: str, customLayoutNumbering: bool, doNotIncludeInNumbering: bool, displayMasterLayoutBelow: bool, layoutPageNumber: int, actPageIndex: int, currentRevisionId: str, currentFinalRevisionId: str, hasIssuedRevision: bool, hasActualRevision: bool)¶

class archicad.releases.ac25.b3000types.LineAttribute(attributeId: AttributeId, name: str, appearanceType: str, displayScale: float, period: float, height: float, lineType: str, lineItems: List[DashOrLineItem] | None = None)¶

Bases: _ACBaseType

A line attribute

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
appearanceType (str) – The appearance type of a line or fill attribute.
displayScale (float) – The original scale of the line.
period (float) – The length of the dashed or symbol line’s period.
height (float) – The height of the symbol line.
lineType (str) – The type of a line attribute.
lineItems (list of DashOrLineItem, optional) – A list of dash or line items.

__init__(attributeId: AttributeId, name: str, appearanceType: str, displayScale: float, period: float, height: float, lineType: str, lineItems: List[DashOrLineItem] | None = None)¶

class archicad.releases.ac25.b3000types.LineAttributeOrError(lineAttribute: LineAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A line attribute or an error.

Variables:

lineAttribute (LineAttribute, optional) – A line attribute
error (Error, optional) – The details of an error.

__init__(lineAttribute: LineAttribute | None = None, error: Error | None = None)¶

static __new__(cls, lineAttribute: LineAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.LineAttributeWrapper(lineAttribute: LineAttribute)¶

Bases: _ACBaseType

Variables:: lineAttribute (LineAttribute) – A line attribute

__init__(lineAttribute: LineAttribute)¶

class archicad.releases.ac25.b3000types.LineItem(lineItemType: str, centerOffset: float, length: float, begPosition: Point2D, endPosition: Point2D, radius: float, begAngle: float, endAngle: float)¶

Bases: _ACBaseType

A line item.

Variables:

lineItemType (str) – The type of a line item.
centerOffset (float) – The vertical distance from the origin of the symbol line. Used in separator, center dot, and centerline item types.
length (float) – The length of the item. Used in centerline, right angle, and parallel item types.
begPosition (Point2D) – EMPTY STRING
endPosition (Point2D) – EMPTY STRING
radius (float) – The radius of the item. Used in circle and arc item types.
begAngle (float) – The beginning angle of the item, measured from the vertical axis. Used in the arc item type.
endAngle (float) – The ending angle of the item, measured from the vertical axis. Used in the arc item type.

__init__(lineItemType: str, centerOffset: float, length: float, begPosition: Point2D, endPosition: Point2D, radius: float, begAngle: float, endAngle: float)¶

class archicad.releases.ac25.b3000types.LineItemWrapper(lineItem: LineItem)¶

Bases: _ACBaseType

Variables:: lineItem (LineItem) – A line item.

__init__(lineItem: LineItem)¶

class archicad.releases.ac25.b3000types.NavigatorItem(navigatorItemId: NavigatorItemId, prefix: str, name: str, type: str, sourceNavigatorItemId: NavigatorItemId | None = None, children: List[NavigatorItemArrayItem] | None = None)¶

Bases: _ACBaseType

The details of a navigator item.

Variables:

navigatorItemId (NavigatorItemId) – The identifier of a navigator item.
prefix (str) – The prefix of the navigator item’s name.
name (str) – The name of the navigator item.
type (str) – The types of a navigator item. The ‘UndefinedItem’ type is used when the actual type of the navigator item cannot be retrieved from Archicad.
sourceNavigatorItemId (NavigatorItemId, optional) – The identifier of a navigator item.
children (list of NavigatorItemArrayItem, optional) – A list of navigator items.

__init__(navigatorItemId: NavigatorItemId, prefix: str, name: str, type: str, sourceNavigatorItemId: NavigatorItemId | None = None, children: List[NavigatorItemArrayItem] | None = None)¶

class archicad.releases.ac25.b3000types.NavigatorItemArrayItem(navigatorItem: NavigatorItem_)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: navigatorItem (NavigatorItem_) – The details of a navigator item.

__init__(navigatorItem: NavigatorItem_)¶

class archicad.releases.ac25.b3000types.NavigatorItemId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a navigator item.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b3000types.NavigatorItemIdWrapper(navigatorItemId: NavigatorItemId)¶

Bases: _ACBaseType

Variables:: navigatorItemId (NavigatorItemId) – The identifier of a navigator item.

__init__(navigatorItemId: NavigatorItemId)¶

archicad.releases.ac25.b3000types.NavigatorItem_¶: alias of NavigatorItem

class archicad.releases.ac25.b3000types.NavigatorTree(rootItem: NavigatorItem)¶

Bases: _ACBaseType

A tree of navigator items.

Variables:: rootItem (NavigatorItem) – The details of a navigator item.

__init__(rootItem: NavigatorItem)¶

class archicad.releases.ac25.b3000types.NavigatorTreeId(type: str, name: str | None = None)¶

Bases: _ACUnionType

The identifier of a navigator item tree.

Variables:

type (str) – The type of the navigator item tree.
name (str, optional) – The name of the publisher set.

__init__(type: str, name: str | None = None)¶

static __new__(cls, type: str, name: str | None = None)¶

class archicad.releases.ac25.b3000types.NonLocalizedValueEnumId(nonLocalizedValue: str, type: str = 'nonLocalizedValue')¶

Bases: _ACBaseType

An enumeration value identifier using the nonlocalized value.

Variables:

nonLocalizedValue (str) – EMPTY STRING
type (str) – EMPTY STRING

__init__(nonLocalizedValue: str, type: str = 'nonLocalizedValue')¶

class archicad.releases.ac25.b3000types.NormalAngleListPropertyValue(value: List[float], type: str = 'angleList', status: str = 'normal')¶

Bases: _ACBaseType

An angle list property value containing angles in an array. The values are measured in SI (radians).

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'angleList', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalAnglePropertyValue(value: float, type: str = 'angle', status: str = 'normal')¶

Bases: _ACBaseType

An angle property value containing a real angle. The value is measured in SI (radians).

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'angle', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalAreaListPropertyValue(value: List[float], type: str = 'areaList', status: str = 'normal')¶

Bases: _ACBaseType

An area list property value containing areas in an array. The values are measured in SI (square meters).

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'areaList', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalAreaPropertyValue(value: float, type: str = 'area', status: str = 'normal')¶

Bases: _ACBaseType

An area property value containing a real area. The value is measured in SI (square meters).

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'area', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalBooleanListPropertyValue(value: List[bool], type: str = 'booleanList', status: str = 'normal')¶

Bases: _ACBaseType

A boolean list property value containing boolean values in an array.

Variables:

value (list of bool) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[bool], type: str = 'booleanList', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalBooleanPropertyValue(value: bool, type: str = 'boolean', status: str = 'normal')¶

Bases: _ACBaseType

A boolean property value containing a valid boolean value.

Variables:

value (bool) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: bool, type: str = 'boolean', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalIntegerListPropertyValue(value: List[int], type: str = 'integerList', status: str = 'normal')¶

Bases: _ACBaseType

An integer list property value containing integers in an array.

Variables:

value (list of int) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[int], type: str = 'integerList', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalIntegerPropertyValue(value: int, type: str = 'integer', status: str = 'normal')¶

Bases: _ACBaseType

An integer property value containing a valid integer number.

Variables:

value (int) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: int, type: str = 'integer', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalLengthListPropertyValue(value: List[float], type: str = 'lengthList', status: str = 'normal')¶

Bases: _ACBaseType

A length list property value containing length values in an array. The values are measured in SI (meters).

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'lengthList', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalLengthPropertyValue(value: float, type: str = 'length', status: str = 'normal')¶

Bases: _ACBaseType

A length property value containing a real length value. The value is measured in SI (meters).

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'length', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalMultiEnumPropertyValue(value: List[EnumValueIdWrapper], type: str = 'multiEnum', status: str = 'normal')¶

Bases: _ACBaseType

A multiple choice enumeration property value containing the IDs of the selected enum values in an array.

Variables:

value (list of EnumValueIdWrapper) – A list of enumeration identifiers.
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[EnumValueIdWrapper], type: str = 'multiEnum', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalNumberListPropertyValue(value: List[float], type: str = 'numberList', status: str = 'normal')¶

Bases: _ACBaseType

A number list property value containing numbers in an array.

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'numberList', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalNumberPropertyValue(value: float, type: str = 'number', status: str = 'normal')¶

Bases: _ACBaseType

A number property value containing a valid numeric value.

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'number', status: str = 'normal')¶

Bases: _ACUnionType

A normal or a userUndefined property value.

Variables:

type (str) – None
status (str) – None
value (float, int, str, bool, list of float, list of int, list of str, list of bool, EnumValueId, list of EnumValueIdWrapper) – None; The identifier of a property enumeration value.; A list of enumeration identifiers.

__init__(type: str, status: str, value: float | int | str | bool | List[float] | List[int] | List[str] | List[bool] | EnumValueId | List[EnumValueIdWrapper] | None = None)¶

static __new__(cls, type: str, status: str, value: float | int | str | bool | List[float] | List[int] | List[str] | List[bool] | EnumValueId | List[EnumValueIdWrapper] | None = None)¶

class archicad.releases.ac25.b3000types.NormalSingleEnumPropertyValue(value: EnumValueId, type: str = 'singleEnum', status: str = 'normal')¶

Bases: _ACBaseType

A single enumeration property value containing the ID of the selected enum value.

Variables:

value (EnumValueId) – The identifier of a property enumeration value.
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: EnumValueId, type: str = 'singleEnum', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalStringListPropertyValue(value: List[str], type: str = 'stringList', status: str = 'normal')¶

Bases: _ACBaseType

A string list property value containing strings in an array.

Variables:

value (list of str) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[str], type: str = 'stringList', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalStringPropertyValue(value: str, type: str = 'string', status: str = 'normal')¶

Bases: _ACBaseType

A string property value containing a valid string.

Variables:

value (str) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: str, type: str = 'string', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalVolumeListPropertyValue(value: List[float], type: str = 'volumeList', status: str = 'normal')¶

Bases: _ACBaseType

A volume list property value containing volumes in an array. The values are measured in SI (cubic meters).

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'volumeList', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NormalVolumePropertyValue(value: float, type: str = 'volume', status: str = 'normal')¶

Bases: _ACBaseType

A volume property value containing a real volume. The value is measured in SI (cubic meters).

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'volume', status: str = 'normal')¶

class archicad.releases.ac25.b3000types.NotAvailablePropertyValue(type: str, status: str = 'notAvailable')¶

Bases: _ACBaseType

A notAvailable value means that the property is not available for the property owner (and therefore it has no property value for it).

Variables:

type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(type: str, status: str = 'notAvailable')¶

class archicad.releases.ac25.b3000types.NotEvaluatedPropertyValue(type: str, status: str = 'notEvaluated')¶

Bases: _ACBaseType

A notEvaluated value means that the property could not be evaluated for the property owner for some reason.

Variables:

type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(type: str, status: str = 'notEvaluated')¶

class archicad.releases.ac25.b3000types.OtherNavigatorTreeId(type: str)¶

Bases: _ACBaseType

The identifier of a navigator item tree.

Variables:: type (str) – The type of the navigator item tree.

__init__(type: str)¶

class archicad.releases.ac25.b3000types.Pen(name: str, index: int, color: RGBColor, weight: float, description: str)¶

Bases: _ACBaseType

A pen attribute.

Variables:

name (str) – The name of the pen.
index (int) – The index number of a pen.
color (RGBColor) – A color model represented via its red, green and blue components.
weight (float) – The thickness of the pen defined in millimeters.
description (str) – The description of the pen.

__init__(name: str, index: int, color: RGBColor, weight: float, description: str)¶

class archicad.releases.ac25.b3000types.PenArrayItem(pen: Pen)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: pen (Pen) – A pen attribute.

__init__(pen: Pen)¶

class archicad.releases.ac25.b3000types.PenTableAttribute(attributeId: AttributeId, name: str, pens: List[PenArrayItem])¶

Bases: _ACBaseType

A pen table attribute.

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
pens (list of PenArrayItem) – A collection of pens in a pen table.

__init__(attributeId: AttributeId, name: str, pens: List[PenArrayItem])¶

class archicad.releases.ac25.b3000types.PenTableAttributeOrError(penTableAttribute: PenTableAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A pen table attribute or an error.

Variables:

penTableAttribute (PenTableAttribute, optional) – A pen table attribute.
error (Error, optional) – The details of an error.

__init__(penTableAttribute: PenTableAttribute | None = None, error: Error | None = None)¶

static __new__(cls, penTableAttribute: PenTableAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.PenTableAttributeWrapper(penTableAttribute: PenTableAttribute)¶

Bases: _ACBaseType

Variables:: penTableAttribute (PenTableAttribute) – A pen table attribute.

__init__(penTableAttribute: PenTableAttribute)¶

class archicad.releases.ac25.b3000types.Point2D(x: float, y: float)¶

Bases: _ACBaseType

EMPTY STRING

Variables:

x (float) – X coordinate of 2D point
y (float) – Y coordinate of 2D point

__init__(x: float, y: float)¶

class archicad.releases.ac25.b3000types.PossibleEnumValue(enumValueId: EnumValueId, displayValue: str, nonLocalizedValue: str | None = None)¶

Bases: _ACBaseType

The description of an enumeration value.

Variables:

enumValueId (EnumValueId) – The identifier of a property enumeration value.
displayValue (str) – Displayed value of the enumeration.
nonLocalizedValue (str, optional) – Nonlocalized value of the enumeration if there is one.

__init__(enumValueId: EnumValueId, displayValue: str, nonLocalizedValue: str | None = None)¶

class archicad.releases.ac25.b3000types.PossibleEnumValuesArrayItem(enumValue: PossibleEnumValue)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: enumValue (PossibleEnumValue) – The description of an enumeration value.

__init__(enumValue: PossibleEnumValue)¶

class archicad.releases.ac25.b3000types.ProfileAttribute(attributeId: AttributeId, name: str, useWith: List[str], width: float, height: float, minimumWidth: float, minimumHeight: float, widthStretchable: bool, heightStretchable: bool, hasCoreSkin: bool, profileModifiers: List[ProfileModifierListItem])¶

Bases: _ACBaseType

A profile attribute.

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
useWith (list of str) – A list of element types.
width (float) – The default width (horizontal size) of the profile.
height (float) – The default height (vertical size) of the profile.
minimumWidth (float) – The minimum width (horizontal size) of the profile.
minimumHeight (float) – The minimum height (vertical size) of the profile.
widthStretchable (bool) – Defines whether the profile’s width can be increased beyond its default value or not.
heightStretchable (bool) – Defines whether the profile’s height can be increased beyond its default value or not.
hasCoreSkin (bool) – Defines whether the profile has a core skin or not.
profileModifiers (list of ProfileModifierListItem) – A list of profile modifiers.

__init__(attributeId: AttributeId, name: str, useWith: List[str], width: float, height: float, minimumWidth: float, minimumHeight: float, widthStretchable: bool, heightStretchable: bool, hasCoreSkin: bool, profileModifiers: List[ProfileModifierListItem])¶

class archicad.releases.ac25.b3000types.ProfileAttributeOrError(profileAttribute: ProfileAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A profile attribute or an error.

Variables:

profileAttribute (ProfileAttribute, optional) – A profile attribute.
error (Error, optional) – The details of an error.

__init__(profileAttribute: ProfileAttribute | None = None, error: Error | None = None)¶

static __new__(cls, profileAttribute: ProfileAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.ProfileAttributeWrapper(profileAttribute: ProfileAttribute)¶

Bases: _ACBaseType

Variables:: profileAttribute (ProfileAttribute) – A profile attribute.

__init__(profileAttribute: ProfileAttribute)¶

class archicad.releases.ac25.b3000types.ProfileModifier(name: str, value: float)¶

Bases: _ACBaseType

A profile modifier parameter.

Variables:

name (str) – The name of the modifier.
value (float) – The value of the modifier.

__init__(name: str, value: float)¶

class archicad.releases.ac25.b3000types.ProfileModifierListItem(profileModifier: ProfileModifier)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: profileModifier (ProfileModifier) – A profile modifier parameter.

__init__(profileModifier: ProfileModifier)¶

class archicad.releases.ac25.b3000types.PropertyDefinition(group: PropertyGroup, name: str, description: str, possibleEnumValues: List[PossibleEnumValuesArrayItem] | None = None)¶

Bases: _ACBaseType

A property definition.

Variables:

group (PropertyGroup) – A property group.
name (str) – The localized name of the property.
description (str) – The description of the property.
possibleEnumValues (list of PossibleEnumValuesArrayItem, optional) – A list of enumeration values.

__init__(group: PropertyGroup, name: str, description: str, possibleEnumValues: List[PossibleEnumValuesArrayItem] | None = None)¶

class archicad.releases.ac25.b3000types.PropertyDefinitionOrError(propertyDefinition: PropertyDefinition | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A property definition or an error.

Variables:

propertyDefinition (PropertyDefinition, optional) – A property definition.
error (Error, optional) – The details of an error.

__init__(propertyDefinition: PropertyDefinition | None = None, error: Error | None = None)¶

static __new__(cls, propertyDefinition: PropertyDefinition | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.PropertyDefinitionWrapper(propertyDefinition: PropertyDefinition)¶

Bases: _ACBaseType

Variables:: propertyDefinition (PropertyDefinition) – A property definition.

__init__(propertyDefinition: PropertyDefinition)¶

class archicad.releases.ac25.b3000types.PropertyGroup(name: str)¶

Bases: _ACBaseType

A property group.

Variables:: name (str) – The property group name.

__init__(name: str)¶

class archicad.releases.ac25.b3000types.PropertyId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a property.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b3000types.PropertyIdArrayItem(propertyId: PropertyId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: propertyId (PropertyId) – The identifier of a property.

__init__(propertyId: PropertyId)¶

class archicad.releases.ac25.b3000types.PropertyIdOrError(propertyId: PropertyId | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A property identifier or an error.

Variables:

propertyId (PropertyId, optional) – The identifier of a property.
error (Error, optional) – The details of an error.

__init__(propertyId: PropertyId | None = None, error: Error | None = None)¶

static __new__(cls, propertyId: PropertyId | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.PropertyUserId(type: str, localizedName: List[str] | None = None, nonLocalizedName: str | None = None)¶

Bases: _ACUnionType

The unique identifier of a Property, identified by its name. May represent a User-Defined or a Built-In Property.

Variables:

type (str) – None
localizedName (list of str, optional) – A two-element list of the localized name parts. The first element is the name of the group the property belongs to, and the second element is the actual name of the property.
nonLocalizedName (str, optional) – The non-localized name of the Built-In Property.

__init__(type: str, localizedName: List[str] | None = None, nonLocalizedName: str | None = None)¶

static __new__(cls, type: str, localizedName: List[str] | None = None, nonLocalizedName: str | None = None)¶

Bases: _ACUnionType

A normal, userUndefined, notAvailable or notEvaluated property value.

Variables:

type (str) – None
status (str) – None
value (float, int, str, bool, list of float, list of int, list of str, list of bool, EnumValueId, list of EnumValueIdWrapper) – None; The identifier of a property enumeration value.; A list of enumeration identifiers.

__init__(type: str, status: str, value: float | int | str | bool | List[float] | List[int] | List[str] | List[bool] | EnumValueId | List[EnumValueIdWrapper] | None = None)¶

static __new__(cls, type: str, status: str, value: float | int | str | bool | List[float] | List[int] | List[str] | List[bool] | EnumValueId | List[EnumValueIdWrapper] | None = None)¶

class archicad.releases.ac25.b3000types.PropertyValueOrErrorItem(propertyValue: PropertyValue | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A property value or an error

Variables:

propertyValue (PropertyValue, optional) – A normal, userUndefined, notAvailable or notEvaluated property value.
error (Error, optional) – The details of an error.

__init__(propertyValue: PropertyValue | None = None, error: Error | None = None)¶

static __new__(cls, propertyValue: PropertyValue | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.PropertyValueWrapper(propertyValue: PropertyValue)¶

Bases: _ACBaseType

Variables:: propertyValue (PropertyValue) – A normal, userUndefined, notAvailable or notEvaluated property value.

__init__(propertyValue: PropertyValue)¶

class archicad.releases.ac25.b3000types.PropertyValuesOrError(propertyValues: List[PropertyValueOrErrorItem] | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A list of property values or an error.

Variables:

propertyValues (list of PropertyValueOrErrorItem, optional) – A list of property values.
error (Error, optional) – The details of an error.

__init__(propertyValues: List[PropertyValueOrErrorItem] | None = None, error: Error | None = None)¶

static __new__(cls, propertyValues: List[PropertyValueOrErrorItem] | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.PropertyValuesWrapper(propertyValues: List[PropertyValueOrErrorItem])¶

Bases: _ACBaseType

Variables:: propertyValues (list of PropertyValueOrErrorItem) – A list of property values.

__init__(propertyValues: List[PropertyValueOrErrorItem])¶

class archicad.releases.ac25.b3000types.PublisherSetId(name: str, type: str = 'PublisherSets')¶

Bases: _ACBaseType

The identifier of a publisher set.

Variables:

name (str) – The name of the publisher set.
type (str) – The type of the navigator item tree.

__init__(name: str, type: str = 'PublisherSets')¶

class archicad.releases.ac25.b3000types.RGBColor(red: float, green: float, blue: float)¶

Bases: _ACBaseType

A color model represented via its red, green and blue components.

Variables:

red (float) – The red component of the color model.
green (float) – The green component of the color model.
blue (float) – The blue component of the color model.

__init__(red: float, green: float, blue: float)¶

class archicad.releases.ac25.b3000types.Subset(name: str, includeToIDSequence: bool, customNumbering: bool, continueNumbering: bool, useUpperPrefix: bool, addOwnPrefix: bool, customNumber: str, autoNumber: str, numberingStyle: str, startAt: int, ownPrefix: str)¶

Bases: _ACBaseType

A set of options used to assign IDs to the layouts contained in the subset.

Variables:

name (str) – The name for the layout subset.
includeToIDSequence (bool) – Defines whether this subset is included in automatic ID assignment or not.
customNumbering (bool) – Defines whether the IDs are generated automatically or a custom numbering is used.
continueNumbering (bool) – Defines whether to continue using the ID assignment of the upper levels or not. If ‘true’, layouts within this subset are going to be assigned IDs as if they were not within this subset, but part of the level above. In this case you only use the Subset as a logical grouping which has no effect on IDs.
useUpperPrefix (bool) – Defines whether to use the prefix and ID of the upper levels or not. If ‘true’, layouts in this subset will be assigned IDs based on the previous layout in the layout book structure.
addOwnPrefix (bool) – Defines whether to add own prefix to the subset or not.
customNumber (str) – The custom subset ID.
autoNumber (str) – The automatic subset ID.
numberingStyle (str) – A supported numbering style.
startAt (int) – The starting value of the numbering.
ownPrefix (str) – The custom prefix for the subset.

__init__(name: str, includeToIDSequence: bool, customNumbering: bool, continueNumbering: bool, useUpperPrefix: bool, addOwnPrefix: bool, customNumber: str, autoNumber: str, numberingStyle: str, startAt: int, ownPrefix: str)¶

class archicad.releases.ac25.b3000types.SuccessfulExecutionResult(success: bool)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: success (bool) – EMPTY STRING

__init__(success: bool)¶

class archicad.releases.ac25.b3000types.SurfaceAttribute(attributeId: AttributeId, name: str, materialType: str, ambientReflection: int, diffuseReflection: int, specularReflection: int, transparencyAttenuation: int, emissionAttenuation: int, surfaceColor: RGBColor, specularColor: RGBColor, emissionColor: RGBColor, fillId: AttributeIdOrError, transparency: int, shine: int, texture: Texture | None = None)¶

Bases: _ACBaseType

A surface attribute.

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
materialType (str) – The material type of a surface attribute.
ambientReflection (int) – The ambient reflection of the surface attribute.
diffuseReflection (int) – The diffuse reflection of the surface attribute.
specularReflection (int) – The specular reflection of the surface attribute.
transparencyAttenuation (int) – The transparency attenuation of the surface attribute.
emissionAttenuation (int) – The emission attenuation of the surface attribute.
surfaceColor (RGBColor) – A color model represented via its red, green and blue components.
specularColor (RGBColor) – A color model represented via its red, green and blue components.
emissionColor (RGBColor) – A color model represented via its red, green and blue components.
fillId (AttributeIdOrError) – The attribute’s identifier or an error.
transparency (int) – The transparency of the surface attribute.
shine (int) – The shininess of the surface attribute.
texture (Texture, optional) – A texture

__init__(attributeId: AttributeId, name: str, materialType: str, ambientReflection: int, diffuseReflection: int, specularReflection: int, transparencyAttenuation: int, emissionAttenuation: int, surfaceColor: RGBColor, specularColor: RGBColor, emissionColor: RGBColor, fillId: AttributeIdOrError, transparency: int, shine: int, texture: Texture | None = None)¶

class archicad.releases.ac25.b3000types.SurfaceAttributeOrError(surfaceAttribute: SurfaceAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A surface attribute or an error.

Variables:

surfaceAttribute (SurfaceAttribute, optional) – A surface attribute.
error (Error, optional) – The details of an error.

__init__(surfaceAttribute: SurfaceAttribute | None = None, error: Error | None = None)¶

static __new__(cls, surfaceAttribute: SurfaceAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.SurfaceAttributeWrapper(surfaceAttribute: SurfaceAttribute)¶

Bases: _ACBaseType

Variables:: surfaceAttribute (SurfaceAttribute) – A surface attribute.

__init__(surfaceAttribute: SurfaceAttribute)¶

class archicad.releases.ac25.b3000types.Texture(name: str)¶

Bases: _ACBaseType

A texture

Variables:: name (str) – The name of the texture.

__init__(name: str)¶

class archicad.releases.ac25.b3000types.UserDefinedPropertyUserId(localizedName: List[str], type: str = 'UserDefined')¶

Bases: _ACBaseType

The unique identifier of a User-Defined Property, identified by its name.

Variables:

localizedName (list of str) – A two-element list of the localized name parts. The first element is the name of the group the property belongs to, and the second element is the actual name of the property.
type (str) – EMPTY STRING

__init__(localizedName: List[str], type: str = 'UserDefined')¶

class archicad.releases.ac25.b3000types.UserUndefinedPropertyValue(type: str, status: str = 'userUndefined')¶

Bases: _ACBaseType

A userUndefined value means that there is no actual number/string/etc. value, but the user deliberately set an Undefined value: this is a valid value, too.

Variables:

type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(type: str, status: str = 'userUndefined')¶

class archicad.releases.ac25.b3000types.ZoneCategoryAttribute(attributeId: AttributeId, name: str, categoryCode: str, stampName: str, stampMainGuid: UUID, stampRevisionGuid: UUID, color: RGBColor)¶

Bases: _ACBaseType

A zone category.

Variables:

attributeId (AttributeId) – The identifier of an attribute.
name (str) – The name of an attribute.
categoryCode (str) – The category code of the zone.
stampName (str) – The stamp name of the zone category.
stampMainGuid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.
stampRevisionGuid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.
color (RGBColor) – A color model represented via its red, green and blue components.

__init__(attributeId: AttributeId, name: str, categoryCode: str, stampName: str, stampMainGuid: UUID, stampRevisionGuid: UUID, color: RGBColor)¶

class archicad.releases.ac25.b3000types.ZoneCategoryAttributeOrError(zoneCategoryAttribute: ZoneCategoryAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A zone category attribute or an error.

Variables:

zoneCategoryAttribute (ZoneCategoryAttribute, optional) – A zone category.
error (Error, optional) – The details of an error.

__init__(zoneCategoryAttribute: ZoneCategoryAttribute | None = None, error: Error | None = None)¶

static __new__(cls, zoneCategoryAttribute: ZoneCategoryAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b3000types.ZoneCategoryAttributeWrapper(zoneCategoryAttribute: ZoneCategoryAttribute)¶

Bases: _ACBaseType

Variables:: zoneCategoryAttribute (ZoneCategoryAttribute) – A zone category.

__init__(zoneCategoryAttribute: ZoneCategoryAttribute)¶

archicad.releases.ac25.b3000utilities¶

class archicad.releases.ac25.b3000utilities.Utilities(actypes: Types, accommands: Commands)¶

Bases: object

Utility functions for the archicad module.

FindClassificationItemInSystem(system_name: str, item_id: str) → ClassificationItemId | None¶: Finds the classification item in a system.

FindClassificationSystem(systemName: str) → ClassificationSystemId | None¶: Finds the classification system.

static FindInClassificationItemTree(treeRootItem: ClassificationItemInTree, criterion: Callable[[ClassificationItemInTree], bool]) → List[ClassificationItemInTree]¶

Finds items in a navigator tree.

Parameters:

treeRootItem (ClassificationItemInTree) – The root item of the classification tree.
criterion (Callable[[ClassificationItemInTree], bool]) – The criterion function.

Returns:

The list of classification items, which fulfill the criterion function.

Return type:

List[ClassificationItemInTree]

static FindInNavigatorItemTree(treeRootItem: NavigatorItem, criterion: Callable[[NavigatorItem], bool]) → List[NavigatorItem]¶

Finds items in a navigator tree.

Parameters:

treeRootItem (NavigatorItem) – The root item of the navigator tree.
criterion (Callable[[NavigatorItem], bool]) – The criterion function.

Returns:

The list of navigator items, which fulfill the criterion function.

Return type:

List[NavigatorItem]

GetBuiltInPropertyId(name: str) → PropertyId¶: Returns the PropertyId of the corresponding built-in property.

GetDisplayValueFromPropertyEnumValueId(propertyId: PropertyId, enumValueId: EnumValueId) → str¶

Returns the display value of an enumeration property value.

Parameters:

propertyId (PropertyId) – The identifier of the property.
enumValueId (EnumValueId) – The enumeration value identifier.

Returns:

The display value of the enumeration property value.

Return type:

str

GetPropertyValuesDictionary(elements: List[ElementId], propertyIds: List[PropertyId]) → Dict[ElementId, Dict[PropertyId, Any]]¶

Returns the values of the given elements’ given properties.

Parameters:

elements (List[ElementId]) – The identifier of the property.
propertyIds (List[PropertyId]) – The property value.

Returns:

A dictionary for the property values with two key-levels: the first key is the elementId, the second key is the propertyId.

Return type:

Dict[ElementId, Dict[PropertyId, Any]]

GetUserDefinedPropertyId(groupName: str, name: str) → PropertyId¶: Returns the PropertyId of the corresponding user-defined property.

GetValueFromPropertyValue(propertyId: PropertyId, propertyValue: PropertyValue) → Any¶

Returns the display value of a property value.

Parameters:

propertyId (PropertyId) – The identifier of the property.
propertyValue (PropertyValue) – The property value.

Returns:

The value unwrapped from the property value.

Return type:

Any

static OpenFile(filepath: str)¶: Opens the given file with the default application.

__init__(actypes: Types, accommands: Commands)¶

__weakref__¶: list of weak references to the object (if defined)

archicad.releases.ac25.b326commands¶

Graphisoft

class archicad.releases.ac25.b326commands.Commands(req: Request)¶

Bases: object

Collection of the Archicad JSON interface commands

CloneProjectMapItemToViewMap(projectMapNavigatorItemId: NavigatorItemId, parentNavigatorItemId: NavigatorItemId) → NavigatorItemId¶

Clones a project map item to the view map.

Parameters:

projectMapNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.
parentNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.

Returns:

The identifier of a navigator item.

Return type:

NavigatorItemId

CreateLayout(layoutName: str, layoutParameters: LayoutParameters, masterNavigatorItemId: NavigatorItemId, parentNavigatorItemId: NavigatorItemId) → NavigatorItemId¶

Creates a new layout.

Parameters:

layoutName (str) – The name of the layout.
layoutParameters (LayoutParameters) – The parameters of the layout.
masterNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.
parentNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.

Returns:

The identifier of a navigator item.

Return type:

NavigatorItemId

CreateLayoutSubset(subsetParameters: Subset, parentNavigatorItemId: NavigatorItemId) → NavigatorItemId¶

Creates a new layout subset.

Parameters:

subsetParameters (Subset) – A set of options used to assign IDs to the layouts contained in the subset.
parentNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.

Returns:

The identifier of a navigator item.

Return type:

NavigatorItemId

CreateViewMapFolder(folderParameters: FolderParameters, parentNavigatorItemId: NavigatorItemId | None = None, previousNavigatorItemId: NavigatorItemId | None = None) → NavigatorItemId¶

Creates a view folder item at the given position in the navigator tree.

Parameters:

folderParameters (FolderParameters) – The parameters of a folder.
parentNavigatorItemId (NavigatorItemId, optional) – The identifier of a navigator item.
previousNavigatorItemId (NavigatorItemId, optional) – The identifier of a navigator item.

Returns:

The identifier of a navigator item.

Return type:

NavigatorItemId

DeleteNavigatorItems(navigatorItemIds: List[NavigatorItemIdWrapper]) → List[ExecutionResult]¶

Deletes items from navigator tree.

Parameters:: navigatorItemIds (list of NavigatorItemIdWrapper) – A list of navigator item identifiers.
Returns:: A list of execution results.
Return type:: list of ExecutionResult

ExecuteAddOnCommand(addOnCommandId: AddOnCommandId, addOnCommandParameters: AddOnCommandParameters | None = None) → AddOnCommandResponse¶

Executes a command registered in an Add-On.

Parameters:

addOnCommandId (AddOnCommandId) – The identifier of an Add-On command.
addOnCommandParameters (AddOnCommandParameters, optional) – The input parameters of an Add-On command.

Returns:

The response returned by an Add-On command.

Return type:

AddOnCommandResponse

Get2DBoundingBoxes(elements: List[ElementIdArrayItem]) → List[BoundingBox2DOrError]¶

Get the 2D bounding box of elements identified by their GUIDs. The bounding box is calculated from the global origin on the floor plan view. The output is the array of the bounding boxes respective to the input GUIDs. Only works for elements detailed in Element Information.

Parameters:: elements (list of ElementIdArrayItem) – A list of elements.
Returns:: A list of 2D bounding boxes.
Return type:: list of BoundingBox2DOrError

Get3DBoundingBoxes(elements: List[ElementIdArrayItem]) → List[BoundingBox3DOrError]¶

Get the 3D bounding box of elements identified by their GUIDs. The bounding box is calculated from the global origin in the 3D view. The output is the array of the bounding boxes respective to the input GUIDs. Only works for elements detailed in Element Information.

Parameters:: elements (list of ElementIdArrayItem) – A list of elements.
Returns:: A list of 3D bounding boxes.
Return type:: list of BoundingBox3DOrError

GetActivePenTables() → Tuple[AttributeIdOrError, AttributeIdOrError]¶

Returns the model view and layout book pen table identifiers.

Returns:: The attribute’s identifier or an error. AttributeIdOrError: The attribute’s identifier or an error.
Return type:: AttributeIdOrError

GetAllClassificationSystems() → List[ClassificationSystem]¶

Returns the list of available classification systems.

Returns:: A list of classification systems.
Return type:: list of ClassificationSystem

GetAllClassificationsInSystem(classificationSystemId: ClassificationSystemId) → List[ClassificationItemArrayItem]¶

Returns the tree of classifications in the given classification system.

Parameters:: classificationSystemId (ClassificationSystemId) – The identifier of a classification system.
Returns:: A list of classification items.
Return type:: list of ClassificationItemArrayItem

GetAllElements() → List[ElementIdArrayItem]¶

Returns the identifier of every element in the current plan.

Returns:: A list of elements.
Return type:: list of ElementIdArrayItem

GetAllPropertyNames() → List[PropertyUserId]¶

Returns the human-readable names of available Property definitions for debug and development purposes.

Returns:: A list of PropertyUserId objects.
Return type:: list of PropertyUserId

GetAttributesByType(attributeType: str) → List[AttributeIdWrapperItem]¶

Returns the identifier of every attribute of the given type.

Parameters:: attributeType (str) – The type of an attribute.
Returns:: A list of attribute identifiers.
Return type:: list of AttributeIdWrapperItem

GetBuildingMaterialAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[BuildingMaterialAttributeOrError]¶

Returns the detailed building material attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of building material attributes and potential errors.
Return type:: list of BuildingMaterialAttributeOrError

GetClassificationsOfElements(elements: List[ElementIdArrayItem], classificationSystemIds: List[ClassificationSystemIdArrayItem]) → List[ElementClassificationOrError]¶

Returns the classification of the given elements in the given classification systems.

Parameters:

elements (list of ElementIdArrayItem) – A list of elements.
classificationSystemIds (list of ClassificationSystemIdArrayItem) – A list of classification system identifiers.

Returns:

A list of element classification identifiers or errors.

Return type:

list of ElementClassificationOrError

GetComponentsOfElements(elements: List[ElementIdArrayItem]) → List[ElementComponentsOrError]¶

Returns the identifier of every component for a list of elements. The order of the returned list is the same as the given elements.

Parameters:: elements (list of ElementIdArrayItem) – A list of elements.
Returns:: Array of component list or error.
Return type:: list of ElementComponentsOrError

GetCompositeAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[CompositeAttributeOrError]¶

Returns the detailed composite attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of the composite attributes and potential errors.
Return type:: list of CompositeAttributeOrError

GetDetailsOfClassificationItems(classificationItemIds: List[ClassificationItemIdArrayItem]) → List[ClassificationItemOrError]¶

Returns the details of classification items.

Parameters:: classificationItemIds (list of ClassificationItemIdArrayItem) – A list of classification item identifiers.
Returns:: A list of classification items or errors.
Return type:: list of ClassificationItemOrError

GetDetailsOfProperties(properties: List[PropertyIdArrayItem]) → List[PropertyDefinitionOrError]¶

Returns the details of property definitions.

Parameters:: properties (list of PropertyIdArrayItem) – A list of property identifiers.
Returns:: A list of property definitions or errors.
Return type:: list of PropertyDefinitionOrError

GetElementsByClassification(classificationItemId: ClassificationItemId) → List[ElementIdArrayItem]¶

Returns the identifier of every element with the given classification identifier.

Parameters:: classificationItemId (ClassificationItemId) – The identifier of a classification item.
Returns:: A list of elements.
Return type:: list of ElementIdArrayItem

GetElementsByType(elementType: str) → List[ElementIdArrayItem]¶

Returns the identifier of every element of the given type on the plan.

Parameters:: elementType (str) – The type of an element.
Returns:: A list of elements.
Return type:: list of ElementIdArrayItem

GetElementsRelatedToZones(zones: List[ElementIdArrayItem], elementTypes: List[str] | None = None) → List[ElementsOrError]¶

Returns related elements of the given zones. The related elements will be grouped by type. If multiple zones was given, then the order of the returned list is that of the given zones.

Parameters:

zones (list of ElementIdArrayItem) – A list of elements.
elementTypes (list of str, optional) – A list of element types.

Returns:

A list of ElementsOrError items.

Return type:

list of ElementsOrError

GetFillAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[FillAttributeOrError]¶

Returns the detailed fill attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of fill attributes and potential errors.
Return type:: list of FillAttributeOrError

GetLayerAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[LayerAttributeOrError]¶

Returns the detailed layer attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of layer attributes and potential errors.
Return type:: list of LayerAttributeOrError

GetLayerCombinationAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[LayerCombinationAttributeOrError]¶

Returns the detailed layer combination attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of layer combination attributes and potential errors.
Return type:: list of LayerCombinationAttributeOrError

GetLayoutSettings(layoutNavigatorItemId: NavigatorItemId) → LayoutParameters¶

Returns the parameters (settings) of the given layout.

Parameters:: layoutNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.
Returns:: The parameters of the layout.
Return type:: LayoutParameters

GetLineAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[LineAttributeOrError]¶

Returns the detailed line attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of line attributes and potential errors.
Return type:: list of LineAttributeOrError

GetNavigatorItemTree(navigatorTreeId: NavigatorTreeId) → NavigatorTree¶

Returns the tree of navigator items.

Parameters:: navigatorTreeId (NavigatorTreeId) – The identifier of a navigator item tree.
Returns:: A tree of navigator items.
Return type:: NavigatorTree

GetPenTableAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[PenTableAttributeOrError]¶

Returns the detailed pen table attributes (including their pens) identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of pen table attributes and potential errors.
Return type:: list of PenTableAttributeOrError

GetProductInfo() → Tuple[int, int, str]¶

Accesses the version information from the running Archicad.

Returns:: The version of the running Archicad. int: The build number of the running Archicad. str: The language code of the running Archicad.
Return type:: int

GetProfileAttributePreview(attributeIds: List[AttributeIdWrapperItem], imageWidth: int, imageHeight: int, backgroundColor: RGBColor | None = None) → List[ImageOrError]¶

Returns the preview image of each requested profile attribute in a base64 string format.

Parameters:

attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
imageWidth (int) – The width of the preview image.
imageHeight (int) – The height of the preview image.
backgroundColor (RGBColor, optional) – A color model represented via its red, green and blue components.

Returns:

A list of images and potential errors.

Return type:

list of ImageOrError

GetProfileAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[ProfileAttributeOrError]¶

Returns the detailed profile attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of the profile attributes and potential errors.
Return type:: list of ProfileAttributeOrError

GetPropertyIds(properties: List[PropertyUserId]) → List[PropertyIdOrError]¶

Returns the identifiers of property definitions for the requested property names.

Parameters:: properties (list of PropertyUserId) – A list of PropertyUserId objects.
Returns:: A list of property identifiers or errors.
Return type:: list of PropertyIdOrError

GetPropertyValuesOfElementComponents(elementComponents: List[ElementComponentIdArrayItem], properties: List[PropertyIdArrayItem]) → List[PropertyValuesOrError]¶

Returns the property values of the components for the given property.

Parameters:

elementComponents (list of ElementComponentIdArrayItem) – List of components of elements.
properties (list of PropertyIdArrayItem) – A list of property identifiers.

Returns:

A list of property value lists.

Return type:

list of PropertyValuesOrError

GetPropertyValuesOfElements(elements: List[ElementIdArrayItem], properties: List[PropertyIdArrayItem]) → List[PropertyValuesOrError]¶

Returns the property values of the elements for the given property.

Parameters:

elements (list of ElementIdArrayItem) – A list of elements.
properties (list of PropertyIdArrayItem) – A list of property identifiers.

Returns:

A list of property value lists.

Return type:

list of PropertyValuesOrError

GetPublisherSetNames() → List[str]¶

Returns the names of available publisher sets.

Returns:: The names of available publisher sets.
Return type:: list of str

GetSurfaceAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[SurfaceAttributeOrError]¶

Returns the detailed surface attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of surface attributes and potential errors.
Return type:: list of SurfaceAttributeOrError

GetZoneCategoryAttributes(attributeIds: List[AttributeIdWrapperItem]) → List[ZoneCategoryAttributeOrError]¶

Returns the detailed zone category attributes identified by their GUIDs.

Parameters:: attributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.
Returns:: A list of zone category attributes and potential errors.
Return type:: list of ZoneCategoryAttributeOrError

IsAddOnCommandAvailable(addOnCommandId: AddOnCommandId) → bool¶

Checks if the command is available or not.

Parameters:: addOnCommandId (AddOnCommandId) – The identifier of an Add-On command.
Returns:: Returns true if the command is available.
Return type:: bool

IsAlive() → bool¶

Checks if the Archicad connection is alive.

Returns:: Returns true if the connection is alive.
Return type:: bool

MoveNavigatorItem(navigatorItemIdToMove: NavigatorItemId, parentNavigatorItemId: NavigatorItemId, previousNavigatorItemId: NavigatorItemId | None = None)¶

Moves the given navigator item under the parentNavigatorItemId in the navigator tree. If previousNavigatorItemId is not given then inserts it at the first place under the new parent. If it is given then inserts it after this navigator item.

Parameters:

navigatorItemIdToMove (NavigatorItemId) – The identifier of a navigator item.
parentNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.
previousNavigatorItemId (NavigatorItemId, optional) – The identifier of a navigator item.

RenameNavigatorItem(navigatorItemId: NavigatorItemId, newName: str | None = None, newId: str | None = None)¶

Renames an existing navigator item by specifying either the name or the ID, or both.

Parameters:

navigatorItemId (NavigatorItemId) – The identifier of a navigator item.
newName (str, optional) – New name of the navigator item.
newId (str, optional) – New ID of the navigator item.

SetClassificationsOfElements(elementClassifications: List[ElementClassification]) → List[ExecutionResult]¶

Sets the classifications of elements. In order to set the classification of an element to unclassified, omit the classificationItemId field.

Parameters:: elementClassifications (list of ElementClassification) – A list of element classification identifiers.
Returns:: A list of execution results.
Return type:: list of ExecutionResult

SetLayoutSettings(layoutParameters: LayoutParameters, layoutNavigatorItemId: NavigatorItemId)¶

Sets the parameters (settings) of the given layout.

Parameters:

layoutParameters (LayoutParameters) – The parameters of the layout.
layoutNavigatorItemId (NavigatorItemId) – The identifier of a navigator item.

SetPropertyValuesOfElements(elementPropertyValues: List[ElementPropertyValue]) → List[ExecutionResult]¶

Sets the property values of elements.

Parameters:: elementPropertyValues (list of ElementPropertyValue) – A list of element property values.
Returns:: A list of execution results.
Return type:: list of ExecutionResult

__init__(req: Request)¶

__weakref__¶: list of weak references to the object (if defined)

exception archicad.releases.ac25.b326commands.UnsucceededCommandCall¶

Bases: Exception

__weakref__¶: list of weak references to the object (if defined)

archicad.releases.ac25.b326types¶

Graphisoft

class archicad.releases.ac25.b326types.AddOnCommandId(addOnId: AddOnId, commandName: str)¶

Bases: _ACBaseType

The identifier of an Add-On command.

Variables:

addOnId (AddOnId) – The Add-On identifier.
commandName (str) – The name of the Add-On command.

__init__(addOnId: AddOnId, commandName: str)¶

class archicad.releases.ac25.b326types.AddOnCommandIdArrayItem(addOnCommandId: AddOnCommandId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: addOnCommandId (AddOnCommandId) – The identifier of an Add-On command.

__init__(addOnCommandId: AddOnCommandId)¶

class archicad.releases.ac25.b326types.AddOnCommandParameters¶

Bases: _ACBaseType

The input parameters of an Add-On command.

__init__()¶

__weakref__¶: list of weak references to the object (if defined)

class archicad.releases.ac25.b326types.AddOnCommandResponse¶

Bases: _ACBaseType

The response returned by an Add-On command.

__init__()¶

__weakref__¶: list of weak references to the object (if defined)

class archicad.releases.ac25.b326types.AddOnId(developerId: int, localId: int)¶

Bases: _ACBaseType

The Add-On identifier.

Variables:

developerId (int) – The ID of the Add-On’s developer.
localId (int) – The local ID of the Add-On.

__init__(developerId: int, localId: int)¶

class archicad.releases.ac25.b326types.AttributeHeader(id: AttributeId, name: str)¶

Bases: _ACBaseType

The header object of an attribute.

Variables:

id (AttributeId) – The identifier of an attribute.
name (str) – The name of the attribute.

__init__(id: AttributeId, name: str)¶

class archicad.releases.ac25.b326types.AttributeId(guid: UUID)¶

Bases: _ACBaseType

The identifier of an attribute.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b326types.AttributeIdOrError(attributeId: AttributeId | None = None, error: Error | None = None)¶

Bases: _ACUnionType

The attribute’s identifier or an error.

Variables:

attributeId (AttributeId, optional) – The identifier of an attribute.
error (Error, optional) – The details of an error.

__init__(attributeId: AttributeId | None = None, error: Error | None = None)¶

static __new__(cls, attributeId: AttributeId | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.AttributeIdWrapperItem(attributeId: AttributeId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: attributeId (AttributeId) – The identifier of an attribute.

__init__(attributeId: AttributeId)¶

class archicad.releases.ac25.b326types.BoundingBox2D(xMin: float, yMin: float, xMax: float, yMax: float)¶

Bases: _ACBaseType

The 2D bounding box of an element.

Variables:

xMin (float) – The minimum X value of the bounding box.
yMin (float) – The minimum Y value of the bounding box.
xMax (float) – The maximum X value of the bounding box.
yMax (float) – The maximum Y value of the bounding box.

__init__(xMin: float, yMin: float, xMax: float, yMax: float)¶

class archicad.releases.ac25.b326types.BoundingBox2DOrError(boundingBox2D: BoundingBox2D | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A 2D bounding box or an error.

Variables:

boundingBox2D (BoundingBox2D, optional) – The 2D bounding box of an element.
error (Error, optional) – The details of an error.

__init__(boundingBox2D: BoundingBox2D | None = None, error: Error | None = None)¶

static __new__(cls, boundingBox2D: BoundingBox2D | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.BoundingBox2DWrapper(boundingBox2D: BoundingBox2D)¶

Bases: _ACBaseType

Variables:: boundingBox2D (BoundingBox2D) – The 2D bounding box of an element.

__init__(boundingBox2D: BoundingBox2D)¶

class archicad.releases.ac25.b326types.BoundingBox3D(xMin: float, yMin: float, zMin: float, xMax: float, yMax: float, zMax: float)¶

Bases: _ACBaseType

A 3D bounding box of an element.

Variables:

xMin (float) – The minimum X value of the bounding box.
yMin (float) – The minimum Y value of the bounding box.
zMin (float) – The minimum Z value of the bounding box.
xMax (float) – The maximum X value of the bounding box.
yMax (float) – The maximum Y value of the bounding box.
zMax (float) – The maximum Z value of the bounding box.

__init__(xMin: float, yMin: float, zMin: float, xMax: float, yMax: float, zMax: float)¶

class archicad.releases.ac25.b326types.BoundingBox3DOrError(boundingBox3D: BoundingBox3D | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A 3D bounding box or an error.

Variables:

boundingBox3D (BoundingBox3D, optional) – A 3D bounding box of an element.
error (Error, optional) – The details of an error.

__init__(boundingBox3D: BoundingBox3D | None = None, error: Error | None = None)¶

static __new__(cls, boundingBox3D: BoundingBox3D | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.BoundingBox3DWrapper(boundingBox3D: BoundingBox3D)¶

Bases: _ACBaseType

Variables:: boundingBox3D (BoundingBox3D) – A 3D bounding box of an element.

__init__(boundingBox3D: BoundingBox3D)¶

class archicad.releases.ac25.b326types.BuildingMaterialAttribute(header: AttributeHeader, id: str, connectionPriority: int, cutFillId: AttributeIdOrError, cutFillPenIndex: int, cutSurfaceId: AttributeIdOrError)¶

Bases: _ACBaseType

A building material attribute

Variables:

header (AttributeHeader) – The header object of an attribute.
id (str) – The id of the building material.
connectionPriority (int) – The connection priority of the building material.
cutFillId (AttributeIdOrError) – The attribute’s identifier or an error.
cutFillPenIndex (int) – The cut fill pen index of the building material.
cutSurfaceId (AttributeIdOrError) – The attribute’s identifier or an error.

__init__(header: AttributeHeader, id: str, connectionPriority: int, cutFillId: AttributeIdOrError, cutFillPenIndex: int, cutSurfaceId: AttributeIdOrError)¶

class archicad.releases.ac25.b326types.BuildingMaterialAttributeOrError(buildingMaterialAttribute: BuildingMaterialAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A building material attribute or an error.

Variables:

buildingMaterialAttribute (BuildingMaterialAttribute, optional) – A building material attribute
error (Error, optional) – The details of an error.

__init__(buildingMaterialAttribute: BuildingMaterialAttribute | None = None, error: Error | None = None)¶

static __new__(cls, buildingMaterialAttribute: BuildingMaterialAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.BuildingMaterialAttributeWrapper(buildingMaterialAttribute: BuildingMaterialAttribute)¶

Bases: _ACBaseType

Variables:: buildingMaterialAttribute (BuildingMaterialAttribute) – A building material attribute

__init__(buildingMaterialAttribute: BuildingMaterialAttribute)¶

class archicad.releases.ac25.b326types.BuiltInPropertyUserId(nonLocalizedName: str, type: str = 'BuiltIn')¶

Bases: _ACBaseType

The unique identifier of a Built-In Property, identified by its name.

Variables:

nonLocalizedName (str) – The non-localized name of the Built-In Property.
type (str) – EMPTY STRING

__init__(nonLocalizedName: str, type: str = 'BuiltIn')¶

class archicad.releases.ac25.b326types.ClassificationId(classificationSystemId: ClassificationSystemId, classificationItemId: ClassificationItemId | None = None)¶

Bases: _ACBaseType

The element classification identifier.

Variables:

classificationSystemId (ClassificationSystemId) – The identifier of a classification system.
classificationItemId (ClassificationItemId, optional) – The identifier of a classification item.

__init__(classificationSystemId: ClassificationSystemId, classificationItemId: ClassificationItemId | None = None)¶

class archicad.releases.ac25.b326types.ClassificationIdOrError(classificationId: ClassificationId | None = None, error: Error | None = None)¶

Bases: _ACUnionType

EMPTY STRING

Variables:

classificationId (ClassificationId, optional) – The element classification identifier.
error (Error, optional) – The details of an error.

__init__(classificationId: ClassificationId | None = None, error: Error | None = None)¶

static __new__(cls, classificationId: ClassificationId | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.ClassificationIdWrapper(classificationId: ClassificationId)¶

Bases: _ACBaseType

Variables:: classificationId (ClassificationId) – The element classification identifier.

__init__(classificationId: ClassificationId)¶

class archicad.releases.ac25.b326types.ClassificationIdsOrErrorsWrapper(classificationIds: List[ClassificationIdOrError])¶

Bases: _ACBaseType

Variables:: classificationIds (list of ClassificationIdOrError) – A list of element classification identifiers or errors.

__init__(classificationIds: List[ClassificationIdOrError])¶

class archicad.releases.ac25.b326types.ClassificationItemArrayItem(classificationItem: ClassificationItemInTree_)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: classificationItem (ClassificationItemInTree_) – The details of a classification item.

__init__(classificationItem: ClassificationItemInTree_)¶

class archicad.releases.ac25.b326types.ClassificationItemDetails(id: str, name: str, description: str)¶

Bases: _ACBaseType

The details of a classification item.

Variables:

id (str) – The unique identifier of the classification item as specified by the user.
name (str) – The display name of the classification item.
description (str) – The description of the classification item.

__init__(id: str, name: str, description: str)¶

class archicad.releases.ac25.b326types.ClassificationItemDetailsWrapper(classificationItem: ClassificationItemDetails)¶

Bases: _ACBaseType

Variables:: classificationItem (ClassificationItemDetails) – The details of a classification item.

__init__(classificationItem: ClassificationItemDetails)¶

class archicad.releases.ac25.b326types.ClassificationItemId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a classification item.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b326types.ClassificationItemIdArrayItem(classificationItemId: ClassificationItemId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: classificationItemId (ClassificationItemId) – The identifier of a classification item.

__init__(classificationItemId: ClassificationItemId)¶

class archicad.releases.ac25.b326types.ClassificationItemInTree(classificationItemId: ClassificationItemId, id: str, name: str, description: str, children: List[ClassificationItemArrayItem] | None = None)¶

Bases: _ACBaseType

The details of a classification item.

Variables:

classificationItemId (ClassificationItemId) – The identifier of a classification item.
id (str) – The unique identifier of the classification item as specified by the user.
name (str) – The display name of the classification item.
description (str) – The description of the classification item.
children (list of ClassificationItemArrayItem, optional) – A list of classification items.

__init__(classificationItemId: ClassificationItemId, id: str, name: str, description: str, children: List[ClassificationItemArrayItem] | None = None)¶

archicad.releases.ac25.b326types.ClassificationItemInTree_¶: alias of ClassificationItemInTree

class archicad.releases.ac25.b326types.ClassificationItemOrError(classificationItem: ClassificationItemDetails | None = None, error: Error | None = None)¶

Bases: _ACUnionType

EMPTY STRING

Variables:

classificationItem (ClassificationItemDetails, optional) – The details of a classification item.
error (Error, optional) – The details of an error.

__init__(classificationItem: ClassificationItemDetails | None = None, error: Error | None = None)¶

static __new__(cls, classificationItem: ClassificationItemDetails | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.ClassificationSystem(classificationSystemId: ClassificationSystemId, name: str, description: str, source: str, version: str, date: str)¶

Bases: _ACBaseType

The details of a classification system.

Variables:

classificationSystemId (ClassificationSystemId) – The identifier of a classification system.
name (str) – The display name of the classification system.
description (str) – The description of the classification system.
source (str) – The source of the classification system (e.g. URL to a classification system standard).
version (str) – The version of the classification system.
date (str) – A date in its string representation as defined in ISO 8601: YYYY-MM-DD.

__init__(classificationSystemId: ClassificationSystemId, name: str, description: str, source: str, version: str, date: str)¶

class archicad.releases.ac25.b326types.ClassificationSystemId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a classification system.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b326types.ClassificationSystemIdArrayItem(classificationSystemId: ClassificationSystemId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: classificationSystemId (ClassificationSystemId) – The identifier of a classification system.

__init__(classificationSystemId: ClassificationSystemId)¶

class archicad.releases.ac25.b326types.ComponentId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a component.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b326types.CompositeAttribute(header: AttributeHeader, totalThickness: float, compositeSkins: List[CompositeSkinListItem], compositeLines: List[CompositeLineListItem], useWith: List[str])¶

Bases: _ACBaseType

A composite attribute.

Variables:

header (AttributeHeader) – The header object of an attribute.
totalThickness (float) – The total thickness of the composite.
compositeSkins (list of CompositeSkinListItem) – A list of composite skins.
compositeLines (list of CompositeLineListItem) – A list of contour/separator lines for the composite.
useWith (list of str) – A list of element types.

__init__(header: AttributeHeader, totalThickness: float, compositeSkins: List[CompositeSkinListItem], compositeLines: List[CompositeLineListItem], useWith: List[str])¶

class archicad.releases.ac25.b326types.CompositeAttributeOrError(compositeAttribute: CompositeAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A composite attribute or an error.

Variables:

compositeAttribute (CompositeAttribute, optional) – A composite attribute.
error (Error, optional) – The details of an error.

__init__(compositeAttribute: CompositeAttribute | None = None, error: Error | None = None)¶

static __new__(cls, compositeAttribute: CompositeAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.CompositeAttributeWrapper(compositeAttribute: CompositeAttribute)¶

Bases: _ACBaseType

Variables:: compositeAttribute (CompositeAttribute) – A composite attribute.

__init__(compositeAttribute: CompositeAttribute)¶

class archicad.releases.ac25.b326types.CompositeLine(lineId: AttributeIdOrError, linePenNr: int)¶

Bases: _ACBaseType

A contour or separator line component for a composite attribute.

Variables:

lineId (AttributeIdOrError) – The attribute’s identifier or an error.
linePenNr (int) – The number of the line pen.

__init__(lineId: AttributeIdOrError, linePenNr: int)¶

class archicad.releases.ac25.b326types.CompositeLineListItem(compositeLine: CompositeLine)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: compositeLine (CompositeLine) – A contour or separator line component for a composite attribute.

__init__(compositeLine: CompositeLine)¶

class archicad.releases.ac25.b326types.CompositeSkin(buildingMaterialId: AttributeIdOrError, framePenNr: int, thickness: float, isCore: bool, isFinish: bool)¶

Bases: _ACBaseType

A skin component for a composite attribute.

Variables:

buildingMaterialId (AttributeIdOrError) – The attribute’s identifier or an error.
framePenNr (int) – The number of the frame pen.
thickness (float) – The thickness of the composite skin.
isCore (bool) – Defines whether the composite skin is part of the core or not.
isFinish (bool) – Defines whether the composite skin is part of the finish or not.

__init__(buildingMaterialId: AttributeIdOrError, framePenNr: int, thickness: float, isCore: bool, isFinish: bool)¶

class archicad.releases.ac25.b326types.CompositeSkinListItem(compositeSkin: CompositeSkin)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: compositeSkin (CompositeSkin) – A skin component for a composite attribute.

__init__(compositeSkin: CompositeSkin)¶

class archicad.releases.ac25.b326types.DashItem(dash: float, gap: float)¶

Bases: _ACBaseType

A dash item.

Variables:

dash (float) – The length of the dash.
gap (float) – The length of the gap.

__init__(dash: float, gap: float)¶

class archicad.releases.ac25.b326types.DashItemWrapper(dashItem: DashItem)¶

Bases: _ACBaseType

Variables:: dashItem (DashItem) – A dash item.

__init__(dashItem: DashItem)¶

class archicad.releases.ac25.b326types.DashOrLineItem(dashItem: DashItem | None = None, lineItem: LineItem | None = None)¶

Bases: _ACUnionType

A dash or line item.

Variables:

dashItem (DashItem, optional) – A dash item.
lineItem (LineItem, optional) – A line item.

__init__(dashItem: DashItem | None = None, lineItem: LineItem | None = None)¶

static __new__(cls, dashItem: DashItem | None = None, lineItem: LineItem | None = None)¶

class archicad.releases.ac25.b326types.DisplayValueEnumId(displayValue: str, type: str = 'displayValue')¶

Bases: _ACBaseType

An enumeration value identifier using the displayed value.

Variables:

displayValue (str) – EMPTY STRING
type (str) – EMPTY STRING

__init__(displayValue: str, type: str = 'displayValue')¶

class archicad.releases.ac25.b326types.ElementClassification(elementId: ElementId, classificationId: ClassificationId)¶

Bases: _ACBaseType

The classification of an element.

Variables:

elementId (ElementId) – The identifier of an element.
classificationId (ClassificationId) – The element classification identifier.

__init__(elementId: ElementId, classificationId: ClassificationId)¶

class archicad.releases.ac25.b326types.ElementClassificationOrError(classificationIds: List[ClassificationIdOrError] | None = None, error: Error | None = None)¶

Bases: _ACUnionType

Element classification identifiers or errors.

Variables:

classificationIds (list of ClassificationIdOrError, optional) – A list of element classification identifiers or errors.
error (Error, optional) – The details of an error.

__init__(classificationIds: List[ClassificationIdOrError] | None = None, error: Error | None = None)¶

static __new__(cls, classificationIds: List[ClassificationIdOrError] | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.ElementComponentId(elementId: ElementId, componentId: ComponentId)¶

Bases: _ACBaseType

The identifier of an element’s component.

Variables:

elementId (ElementId) – The identifier of an element.
componentId (ComponentId) – The identifier of a component.

__init__(elementId: ElementId, componentId: ComponentId)¶

class archicad.releases.ac25.b326types.ElementComponentIdArrayItem(elementComponentId: ElementComponentId)¶

Bases: _ACBaseType

An item of a component array.

Variables:: elementComponentId (ElementComponentId) – The identifier of an element’s component.

__init__(elementComponentId: ElementComponentId)¶

class archicad.releases.ac25.b326types.ElementComponentsOrError(elementComponents: List[ElementComponentIdArrayItem] | None = None, error: Error | None = None)¶

Bases: _ACUnionType

List of components or error.

Variables:

elementComponents (list of ElementComponentIdArrayItem, optional) – List of components of elements.
error (Error, optional) – The details of an error.

__init__(elementComponents: List[ElementComponentIdArrayItem] | None = None, error: Error | None = None)¶

static __new__(cls, elementComponents: List[ElementComponentIdArrayItem] | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.ElementComponentsWrapper(elementComponents: List[ElementComponentIdArrayItem])¶

Bases: _ACBaseType

List of components.

Variables:: elementComponents (list of ElementComponentIdArrayItem) – List of components of elements.

__init__(elementComponents: List[ElementComponentIdArrayItem])¶

class archicad.releases.ac25.b326types.ElementId(guid: UUID)¶

Bases: _ACBaseType

The identifier of an element.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b326types.ElementIdArrayItem(elementId: ElementId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: elementId (ElementId) – The identifier of an element.

__init__(elementId: ElementId)¶

class archicad.releases.ac25.b326types.ElementPropertyValue(elementId: ElementId, propertyId: PropertyId, propertyValue: NormalOrUserUndefinedPropertyValue)¶

Bases: _ACBaseType

A property value with the identifiers of the property and its owner element.

Variables:

elementId (ElementId) – The identifier of an element.
propertyId (PropertyId) – The identifier of a property.
propertyValue (NormalOrUserUndefinedPropertyValue) – A normal or a userUndefined property value.

__init__(elementId: ElementId, propertyId: PropertyId, propertyValue: NormalOrUserUndefinedPropertyValue)¶

class archicad.releases.ac25.b326types.ElementsOrError(elements: List[ElementIdArrayItem] | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A list of elements or an error.

Variables:

elements (list of ElementIdArrayItem, optional) – A list of elements.
error (Error, optional) – The details of an error.

__init__(elements: List[ElementIdArrayItem] | None = None, error: Error | None = None)¶

static __new__(cls, elements: List[ElementIdArrayItem] | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.ElementsWrapper(elements: List[ElementIdArrayItem])¶

Bases: _ACBaseType

A wrapper for a list of elements.

Variables:: elements (list of ElementIdArrayItem) – A list of elements.

__init__(elements: List[ElementIdArrayItem])¶

class archicad.releases.ac25.b326types.EnumValueId(type: str, displayValue: str | None = None, nonLocalizedValue: str | None = None)¶

Bases: _ACUnionType

The identifier of a property enumeration value.

Variables:

type (str) – None
displayValue (str, optional) – EMPTY STRING
nonLocalizedValue (str, optional) – EMPTY STRING

__init__(type: str, displayValue: str | None = None, nonLocalizedValue: str | None = None)¶

static __new__(cls, type: str, displayValue: str | None = None, nonLocalizedValue: str | None = None)¶

class archicad.releases.ac25.b326types.EnumValueIdWrapper(enumValueId: EnumValueId)¶

Bases: _ACBaseType

Variables:: enumValueId (EnumValueId) – The identifier of a property enumeration value.

__init__(enumValueId: EnumValueId)¶

class archicad.releases.ac25.b326types.Error(code: int, message: str)¶

Bases: _ACBaseType

The details of an error.

Variables:

code (int) – The code of the error.
message (str) – The error message.

__init__(code: int, message: str)¶

class archicad.releases.ac25.b326types.ErrorItem(error: Error)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: error (Error) – The details of an error.

__init__(error: Error)¶

class archicad.releases.ac25.b326types.ExecutionResult(success: bool, error: Error | None = None)¶

Bases: _ACUnionType

The result of the execution.

Variables:

success (bool) – None
error (Error, optional) – The details of an error.

__init__(success: bool, error: Error | None = None)¶

static __new__(cls, success: bool, error: Error | None = None)¶

class archicad.releases.ac25.b326types.FailedExecutionResult(success: bool, error: Error)¶

Bases: _ACBaseType

EMPTY STRING

Variables:

success (bool) – EMPTY STRING
error (Error) – The details of an error.

__init__(success: bool, error: Error)¶

class archicad.releases.ac25.b326types.FillAttribute(header: AttributeHeader, subType: str, pattern: int)¶

Bases: _ACBaseType

A fill attribute.

Variables:

header (AttributeHeader) – The header object of an attribute.
subType (str) – The filling type of a fill attribute.
pattern (int) – The pattern of the fill attribute, stored in a 64 bit unsigned integer, and represented as an 8x8 matrix. Each byte in the value is a row, and the bits are the columns of the matrix.

__init__(header: AttributeHeader, subType: str, pattern: int)¶

class archicad.releases.ac25.b326types.FillAttributeOrError(fillAttribute: FillAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A fill attribute or an error.

Variables:

fillAttribute (FillAttribute, optional) – A fill attribute.
error (Error, optional) – The details of an error.

__init__(fillAttribute: FillAttribute | None = None, error: Error | None = None)¶

static __new__(cls, fillAttribute: FillAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.FillAttributeWrapper(fillAttribute: FillAttribute)¶

Bases: _ACBaseType

Variables:: fillAttribute (FillAttribute) – A fill attribute.

__init__(fillAttribute: FillAttribute)¶

class archicad.releases.ac25.b326types.FolderParameters(name: str)¶

Bases: _ACBaseType

The parameters of a folder.

Variables:: name (str) – The name of the folder.

__init__(name: str)¶

class archicad.releases.ac25.b326types.Image(content: str)¶

Bases: _ACBaseType

An image encoded as a Base64 string.

Variables:: content (str) – The image content as a string .

__init__(content: str)¶

class archicad.releases.ac25.b326types.ImageOrError(image: Image | None = None, error: Error | None = None)¶

Bases: _ACUnionType

An image or an error.

Variables:

image (Image, optional) – An image encoded as a Base64 string.
error (Error, optional) – The details of an error.

__init__(image: Image | None = None, error: Error | None = None)¶

static __new__(cls, image: Image | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.ImageWrapper(image: Image)¶

Bases: _ACBaseType

Variables:: image (Image) – An image encoded as a Base64 string.

__init__(image: Image)¶

class archicad.releases.ac25.b326types.LayerAttribute(header: AttributeHeader, intersectionGroupNr: int, isLocked: bool, isHidden: bool, isWireframe: bool)¶

Bases: _ACBaseType

A layer attribute

Variables:

header (AttributeHeader) – The header object of an attribute.
intersectionGroupNr (int) – The intersection group number
isLocked (bool) – Defines whether the layer is locked or not.
isHidden (bool) – Defines whether the layer is hidden or not.
isWireframe (bool) – Defines whether the elements placed on this layer are visible as wireframes or a solid model.

__init__(header: AttributeHeader, intersectionGroupNr: int, isLocked: bool, isHidden: bool, isWireframe: bool)¶

class archicad.releases.ac25.b326types.LayerAttributeOrError(layerAttribute: LayerAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A layer attribute or an error.

Variables:

layerAttribute (LayerAttribute, optional) – A layer attribute
error (Error, optional) – The details of an error.

__init__(layerAttribute: LayerAttribute | None = None, error: Error | None = None)¶

static __new__(cls, layerAttribute: LayerAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.LayerAttributeWrapper(layerAttribute: LayerAttribute)¶

Bases: _ACBaseType

Variables:: layerAttribute (LayerAttribute) – A layer attribute

__init__(layerAttribute: LayerAttribute)¶

class archicad.releases.ac25.b326types.LayerCombinationAttribute(header: AttributeHeader, layerAttributeIds: List[AttributeIdWrapperItem])¶

Bases: _ACBaseType

A layer combination attribute

Variables:

header (AttributeHeader) – The header object of an attribute.
layerAttributeIds (list of AttributeIdWrapperItem) – A list of attribute identifiers.

__init__(header: AttributeHeader, layerAttributeIds: List[AttributeIdWrapperItem])¶

class archicad.releases.ac25.b326types.LayerCombinationAttributeOrError(layerCombinationAttribute: LayerCombinationAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A layer combination attribute or an error.

Variables:

layerCombinationAttribute (LayerCombinationAttribute, optional) – A layer combination attribute
error (Error, optional) – The details of an error.

__init__(layerCombinationAttribute: LayerCombinationAttribute | None = None, error: Error | None = None)¶

static __new__(cls, layerCombinationAttribute: LayerCombinationAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.LayerCombinationAttributeWrapper(layerCombinationAttribute: LayerCombinationAttribute)¶

Bases: _ACBaseType

Variables:: layerCombinationAttribute (LayerCombinationAttribute) – A layer combination attribute

__init__(layerCombinationAttribute: LayerCombinationAttribute)¶

class archicad.releases.ac25.b326types.LayoutParameters(horizontalSize: float, verticalSize: float, leftMargin: float, topMargin: float, rightMargin: float, bottomMargin: float, customLayoutNumber: str, customLayoutNumbering: bool, doNotIncludeInNumbering: bool, displayMasterLayoutBelow: bool, layoutPageNumber: int, actPageIndex: int, currentRevisionId: str, currentFinalRevisionId: str, hasIssuedRevision: bool, hasActualRevision: bool)¶

Bases: _ACBaseType

The parameters of the layout.

Variables:

horizontalSize (float) – The horizontal size of the layout in millimeters.
verticalSize (float) – The vertical size of the layout in millimeters.
leftMargin (float) – The layout margin from the left side of the paper.
topMargin (float) – The layout margin from the top side of the paper.
rightMargin (float) – The layout margin from the right side of the paper.
bottomMargin (float) – The layout margin from the bottom side of the paper.
customLayoutNumber (str) – The custom ID.
customLayoutNumbering (bool) – Defines whether a unique ID is used for the current layout or not.
doNotIncludeInNumbering (bool) – Defines whether this layout is included in automatic ID assignment or not.
displayMasterLayoutBelow (bool) – Defines whether to display the master layout above or below the layout.
layoutPageNumber (int) – The page number of layout when this layout contains multi-page drawings.
actPageIndex (int) – The actual index of layout inside the multi-page layout.
currentRevisionId (str) – The ID of the current document revision of the layout.
currentFinalRevisionId (str) – The ID with optional suffix of the current document revision of the layout.
hasIssuedRevision (bool) – Defines whether one or more issued document revisions have already been created for the layout or not.
hasActualRevision (bool) – Defines whether an open document revision exists for the layout or not.

__init__(horizontalSize: float, verticalSize: float, leftMargin: float, topMargin: float, rightMargin: float, bottomMargin: float, customLayoutNumber: str, customLayoutNumbering: bool, doNotIncludeInNumbering: bool, displayMasterLayoutBelow: bool, layoutPageNumber: int, actPageIndex: int, currentRevisionId: str, currentFinalRevisionId: str, hasIssuedRevision: bool, hasActualRevision: bool)¶

class archicad.releases.ac25.b326types.LineAttribute(header: AttributeHeader, appearenceType: str, displayScale: float, period: float, height: float, lineType: str, lineItems: List[DashOrLineItem] | None = None)¶

Bases: _ACBaseType

A line attribute

Variables:

header (AttributeHeader) – The header object of an attribute.
appearenceType (str) – The appearence type of a line attribute.
displayScale (float) – The original scale of the line.
period (float) – The length of the dashed or symbol line’s period.
height (float) – The height of the symbol line.
lineType (str) – The type of a line attribute.
lineItems (list of DashOrLineItem, optional) – A list of dash or line items.

__init__(header: AttributeHeader, appearenceType: str, displayScale: float, period: float, height: float, lineType: str, lineItems: List[DashOrLineItem] | None = None)¶

class archicad.releases.ac25.b326types.LineAttributeOrError(lineAttribute: LineAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A line attribute or an error.

Variables:

lineAttribute (LineAttribute, optional) – A line attribute
error (Error, optional) – The details of an error.

__init__(lineAttribute: LineAttribute | None = None, error: Error | None = None)¶

static __new__(cls, lineAttribute: LineAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.LineAttributeWrapper(lineAttribute: LineAttribute)¶

Bases: _ACBaseType

Variables:: lineAttribute (LineAttribute) – A line attribute

__init__(lineAttribute: LineAttribute)¶

class archicad.releases.ac25.b326types.LineItem(lineItemType: str, centerOffset: float, length: float, begPosition: Point2D, endPosition: Point2D, radius: float, begAngle: float, endAngle: float)¶

Bases: _ACBaseType

A line item.

Variables:

lineItemType (str) – The type of a line item.
centerOffset (float) – The vertical distance from the origin of the symbol line. Used in separator, center dot, and centerline item types.
length (float) – The length of the item. Used in centerline, right angle, and parallel item types.
begPosition (Point2D) – EMPTY STRING
endPosition (Point2D) – EMPTY STRING
radius (float) – The radius of the item. Used in circle and arc item types.
begAngle (float) – The beginning angle of the item, measured from the vertical axis. Used in the arc item type.
endAngle (float) – The ending angle of the item, measured from the vertical axis. Used in the arc item type.

__init__(lineItemType: str, centerOffset: float, length: float, begPosition: Point2D, endPosition: Point2D, radius: float, begAngle: float, endAngle: float)¶

class archicad.releases.ac25.b326types.LineItemWrapper(lineItem: LineItem)¶

Bases: _ACBaseType

Variables:: lineItem (LineItem) – A line item.

__init__(lineItem: LineItem)¶

class archicad.releases.ac25.b326types.NavigatorItem(navigatorItemId: NavigatorItemId, prefix: str, name: str, type: str, sourceNavigatorItemId: NavigatorItemId | None = None, children: List[NavigatorItemArrayItem] | None = None)¶

Bases: _ACBaseType

The details of a navigator item.

Variables:

navigatorItemId (NavigatorItemId) – The identifier of a navigator item.
prefix (str) – The prefix of the navigator item’s name.
name (str) – The name of the navigator item.
type (str) – The types of a navigator item. The ‘UndefinedItem’ type is used when the actual type of the navigator item cannot be retrieved from Archicad.
sourceNavigatorItemId (NavigatorItemId, optional) – The identifier of a navigator item.
children (list of NavigatorItemArrayItem, optional) – A list of navigator items.

__init__(navigatorItemId: NavigatorItemId, prefix: str, name: str, type: str, sourceNavigatorItemId: NavigatorItemId | None = None, children: List[NavigatorItemArrayItem] | None = None)¶

class archicad.releases.ac25.b326types.NavigatorItemArrayItem(navigatorItem: NavigatorItem_)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: navigatorItem (NavigatorItem_) – The details of a navigator item.

__init__(navigatorItem: NavigatorItem_)¶

class archicad.releases.ac25.b326types.NavigatorItemId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a navigator item.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b326types.NavigatorItemIdWrapper(navigatorItemId: NavigatorItemId)¶

Bases: _ACBaseType

Variables:: navigatorItemId (NavigatorItemId) – The identifier of a navigator item.

__init__(navigatorItemId: NavigatorItemId)¶

archicad.releases.ac25.b326types.NavigatorItem_¶: alias of NavigatorItem

class archicad.releases.ac25.b326types.NavigatorTree(rootItem: NavigatorItem)¶

Bases: _ACBaseType

A tree of navigator items.

Variables:: rootItem (NavigatorItem) – The details of a navigator item.

__init__(rootItem: NavigatorItem)¶

class archicad.releases.ac25.b326types.NavigatorTreeId(type: str, name: str | None = None)¶

Bases: _ACUnionType

The identifier of a navigator item tree.

Variables:

type (str) – The type of the navigator item tree.
name (str, optional) – The name of the publisher set.

__init__(type: str, name: str | None = None)¶

static __new__(cls, type: str, name: str | None = None)¶

class archicad.releases.ac25.b326types.NonLocalizedValueEnumId(nonLocalizedValue: str, type: str = 'nonLocalizedValue')¶

Bases: _ACBaseType

An enumeration value identifier using the nonlocalized value.

Variables:

nonLocalizedValue (str) – EMPTY STRING
type (str) – EMPTY STRING

__init__(nonLocalizedValue: str, type: str = 'nonLocalizedValue')¶

class archicad.releases.ac25.b326types.NormalAngleListPropertyValue(value: List[float], type: str = 'angleList', status: str = 'normal')¶

Bases: _ACBaseType

An angle list property value containing angles in an array. The values are measured in SI (radians).

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'angleList', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalAnglePropertyValue(value: float, type: str = 'angle', status: str = 'normal')¶

Bases: _ACBaseType

An angle property value containing a real angle. The value is measured in SI (radians).

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'angle', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalAreaListPropertyValue(value: List[float], type: str = 'areaList', status: str = 'normal')¶

Bases: _ACBaseType

An area list property value containing areas in an array. The values are measured in SI (square meters).

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'areaList', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalAreaPropertyValue(value: float, type: str = 'area', status: str = 'normal')¶

Bases: _ACBaseType

An area property value containing a real area. The value is measured in SI (square meters).

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'area', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalBooleanListPropertyValue(value: List[bool], type: str = 'booleanList', status: str = 'normal')¶

Bases: _ACBaseType

A boolean list property value containing boolean values in an array.

Variables:

value (list of bool) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[bool], type: str = 'booleanList', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalBooleanPropertyValue(value: bool, type: str = 'boolean', status: str = 'normal')¶

Bases: _ACBaseType

A boolean property value containing a valid boolean value.

Variables:

value (bool) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: bool, type: str = 'boolean', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalIntegerListPropertyValue(value: List[int], type: str = 'integerList', status: str = 'normal')¶

Bases: _ACBaseType

An integer list property value containing integers in an array.

Variables:

value (list of int) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[int], type: str = 'integerList', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalIntegerPropertyValue(value: int, type: str = 'integer', status: str = 'normal')¶

Bases: _ACBaseType

An integer property value containing a valid integer number.

Variables:

value (int) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: int, type: str = 'integer', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalLengthListPropertyValue(value: List[float], type: str = 'lengthList', status: str = 'normal')¶

Bases: _ACBaseType

A length list property value containing length values in an array. The values are measured in SI (meters).

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'lengthList', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalLengthPropertyValue(value: float, type: str = 'length', status: str = 'normal')¶

Bases: _ACBaseType

A length property value containing a real length value. The value is measured in SI (meters).

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'length', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalMultiEnumPropertyValue(value: List[EnumValueIdWrapper], type: str = 'multiEnum', status: str = 'normal')¶

Bases: _ACBaseType

A multiple choice enumeration property value containing the IDs of the selected enum values in an array.

Variables:

value (list of EnumValueIdWrapper) – A list of enumeration identifiers.
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[EnumValueIdWrapper], type: str = 'multiEnum', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalNumberListPropertyValue(value: List[float], type: str = 'numberList', status: str = 'normal')¶

Bases: _ACBaseType

A number list property value containing numbers in an array.

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'numberList', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalNumberPropertyValue(value: float, type: str = 'number', status: str = 'normal')¶

Bases: _ACBaseType

A number property value containing a valid numeric value.

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'number', status: str = 'normal')¶

Bases: _ACUnionType

A normal or a userUndefined property value.

Variables:

type (str) – None
status (str) – None
value (float, int, str, bool, list of float, list of int, list of str, list of bool, EnumValueId, list of EnumValueIdWrapper) – None; The identifier of a property enumeration value.; A list of enumeration identifiers.

__init__(type: str, status: str, value: float | int | str | bool | List[float] | List[int] | List[str] | List[bool] | EnumValueId | List[EnumValueIdWrapper] | None = None)¶

static __new__(cls, type: str, status: str, value: float | int | str | bool | List[float] | List[int] | List[str] | List[bool] | EnumValueId | List[EnumValueIdWrapper] | None = None)¶

class archicad.releases.ac25.b326types.NormalSingleEnumPropertyValue(value: EnumValueId, type: str = 'singleEnum', status: str = 'normal')¶

Bases: _ACBaseType

A single enumeration property value containing the ID of the selected enum value.

Variables:

value (EnumValueId) – The identifier of a property enumeration value.
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: EnumValueId, type: str = 'singleEnum', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalStringListPropertyValue(value: List[str], type: str = 'stringList', status: str = 'normal')¶

Bases: _ACBaseType

A string list property value containing strings in an array.

Variables:

value (list of str) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[str], type: str = 'stringList', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalStringPropertyValue(value: str, type: str = 'string', status: str = 'normal')¶

Bases: _ACBaseType

A string property value containing a valid string.

Variables:

value (str) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: str, type: str = 'string', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalVolumeListPropertyValue(value: List[float], type: str = 'volumeList', status: str = 'normal')¶

Bases: _ACBaseType

A volume list property value containing volumes in an array. The values are measured in SI (cubic meters).

Variables:

value (list of float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: List[float], type: str = 'volumeList', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NormalVolumePropertyValue(value: float, type: str = 'volume', status: str = 'normal')¶

Bases: _ACBaseType

A volume property value containing a real volume. The value is measured in SI (cubic meters).

Variables:

value (float) – EMPTY STRING
type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(value: float, type: str = 'volume', status: str = 'normal')¶

class archicad.releases.ac25.b326types.NotAvailablePropertyValue(type: str, status: str = 'notAvailable')¶

Bases: _ACBaseType

A notAvailable value means that the property is not available for the property owner (and therefore it has no property value for it).

Variables:

type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(type: str, status: str = 'notAvailable')¶

class archicad.releases.ac25.b326types.NotEvaluatedPropertyValue(type: str, status: str = 'notEvaluated')¶

Bases: _ACBaseType

A notEvaluated value means that the property could not be evaluated for the property owner for some reason.

Variables:

type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(type: str, status: str = 'notEvaluated')¶

class archicad.releases.ac25.b326types.OtherNavigatorTreeId(type: str)¶

Bases: _ACBaseType

The identifier of a navigator item tree.

Variables:: type (str) – The type of the navigator item tree.

__init__(type: str)¶

class archicad.releases.ac25.b326types.Pen(name: str, index: int, color: RGBColor, weight: float, description: str)¶

Bases: _ACBaseType

A pen attribute.

Variables:

name (str) – The name of the pen.
index (int) – The index of the pen.
color (RGBColor) – A color model represented via its red, green and blue components.
weight (float) – The thickness of the pen defined in millimeters.
description (str) – The description of the pen.

__init__(name: str, index: int, color: RGBColor, weight: float, description: str)¶

class archicad.releases.ac25.b326types.PenArrayItem(pen: Pen)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: pen (Pen) – A pen attribute.

__init__(pen: Pen)¶

class archicad.releases.ac25.b326types.PenTableAttribute(header: AttributeHeader, pens: List[PenArrayItem])¶

Bases: _ACBaseType

A pen table attribute.

Variables:

header (AttributeHeader) – The header object of an attribute.
pens (list of PenArrayItem) – A collection of pens in a pen table.

__init__(header: AttributeHeader, pens: List[PenArrayItem])¶

class archicad.releases.ac25.b326types.PenTableAttributeOrError(penTableAttribute: PenTableAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A pen table attribute or an error.

Variables:

penTableAttribute (PenTableAttribute, optional) – A pen table attribute.
error (Error, optional) – The details of an error.

__init__(penTableAttribute: PenTableAttribute | None = None, error: Error | None = None)¶

static __new__(cls, penTableAttribute: PenTableAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.PenTableAttributeWrapper(penTableAttribute: PenTableAttribute)¶

Bases: _ACBaseType

Variables:: penTableAttribute (PenTableAttribute) – A pen table attribute.

__init__(penTableAttribute: PenTableAttribute)¶

class archicad.releases.ac25.b326types.Point2D(x: float, y: float)¶

Bases: _ACBaseType

EMPTY STRING

Variables:

x (float) – X coordinate of 2D point
y (float) – Y coordinate of 2D point

__init__(x: float, y: float)¶

class archicad.releases.ac25.b326types.PossibleEnumValue(enumValueId: EnumValueId, displayValue: str, nonLocalizedValue: str | None = None)¶

Bases: _ACBaseType

The description of an enumeration value.

Variables:

enumValueId (EnumValueId) – The identifier of a property enumeration value.
displayValue (str) – Displayed value of the enumeration.
nonLocalizedValue (str, optional) – Nonlocalized value of the enumeration if there is one.

__init__(enumValueId: EnumValueId, displayValue: str, nonLocalizedValue: str | None = None)¶

class archicad.releases.ac25.b326types.PossibleEnumValuesArrayItem(enumValue: PossibleEnumValue)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: enumValue (PossibleEnumValue) – The description of an enumeration value.

__init__(enumValue: PossibleEnumValue)¶

class archicad.releases.ac25.b326types.ProfileAttribute(header: AttributeHeader, useWith: List[str], width: float, height: float, minimumWidth: float, minimumHeight: float, widthStretchable: bool, heightStretchable: bool, hasCoreSkin: bool, profileModifiers: List[ProfileModifierListItem])¶

Bases: _ACBaseType

A profile attribute.

Variables:

header (AttributeHeader) – The header object of an attribute.
useWith (list of str) – A list of element types.
width (float) – The default width (horizontal size) of the profile.
height (float) – The default height (vertical size) of the profile.
minimumWidth (float) – The minimum width (horizontal size) of the profile.
minimumHeight (float) – The minimum height (vertical size) of the profile.
widthStretchable (bool) – Defines whether the profile’s width can be increased beyond its default value or not.
heightStretchable (bool) – Defines whether the profile’s height can be increased beyond its default value or not.
hasCoreSkin (bool) – Defines whether the profile has a core skin or not.
profileModifiers (list of ProfileModifierListItem) – A list of profile modifiers.

__init__(header: AttributeHeader, useWith: List[str], width: float, height: float, minimumWidth: float, minimumHeight: float, widthStretchable: bool, heightStretchable: bool, hasCoreSkin: bool, profileModifiers: List[ProfileModifierListItem])¶

class archicad.releases.ac25.b326types.ProfileAttributeOrError(profileAttribute: ProfileAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A profile attribute or an error.

Variables:

profileAttribute (ProfileAttribute, optional) – A profile attribute.
error (Error, optional) – The details of an error.

__init__(profileAttribute: ProfileAttribute | None = None, error: Error | None = None)¶

static __new__(cls, profileAttribute: ProfileAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.ProfileAttributeWrapper(profileAttribute: ProfileAttribute)¶

Bases: _ACBaseType

Variables:: profileAttribute (ProfileAttribute) – A profile attribute.

__init__(profileAttribute: ProfileAttribute)¶

class archicad.releases.ac25.b326types.ProfileModifier(name: str, value: float)¶

Bases: _ACBaseType

A profile modifier parameter.

Variables:

name (str) – The name of the modifier.
value (float) – The value of the modifier.

__init__(name: str, value: float)¶

class archicad.releases.ac25.b326types.ProfileModifierListItem(profileModifier: ProfileModifier)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: profileModifier (ProfileModifier) – A profile modifier parameter.

__init__(profileModifier: ProfileModifier)¶

class archicad.releases.ac25.b326types.PropertyDefinition(group: PropertyGroup, name: str, description: str, possibleEnumValues: List[PossibleEnumValuesArrayItem] | None = None)¶

Bases: _ACBaseType

A property definition.

Variables:

group (PropertyGroup) – A property group.
name (str) – The localized name of the property.
description (str) – The description of the property.
possibleEnumValues (list of PossibleEnumValuesArrayItem, optional) – A list of enumeration values.

__init__(group: PropertyGroup, name: str, description: str, possibleEnumValues: List[PossibleEnumValuesArrayItem] | None = None)¶

class archicad.releases.ac25.b326types.PropertyDefinitionOrError(propertyDefinition: PropertyDefinition | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A property definition or an error.

Variables:

propertyDefinition (PropertyDefinition, optional) – A property definition.
error (Error, optional) – The details of an error.

__init__(propertyDefinition: PropertyDefinition | None = None, error: Error | None = None)¶

static __new__(cls, propertyDefinition: PropertyDefinition | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.PropertyDefinitionWrapper(propertyDefinition: PropertyDefinition)¶

Bases: _ACBaseType

Variables:: propertyDefinition (PropertyDefinition) – A property definition.

__init__(propertyDefinition: PropertyDefinition)¶

class archicad.releases.ac25.b326types.PropertyGroup(name: str)¶

Bases: _ACBaseType

A property group.

Variables:: name (str) – The property group name.

__init__(name: str)¶

class archicad.releases.ac25.b326types.PropertyId(guid: UUID)¶

Bases: _ACBaseType

The identifier of a property.

Variables:: guid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.

__init__(guid: UUID)¶

class archicad.releases.ac25.b326types.PropertyIdArrayItem(propertyId: PropertyId)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: propertyId (PropertyId) – The identifier of a property.

__init__(propertyId: PropertyId)¶

class archicad.releases.ac25.b326types.PropertyIdOrError(propertyId: PropertyId | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A property identifier or an error.

Variables:

propertyId (PropertyId, optional) – The identifier of a property.
error (Error, optional) – The details of an error.

__init__(propertyId: PropertyId | None = None, error: Error | None = None)¶

static __new__(cls, propertyId: PropertyId | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.PropertyUserId(type: str, localizedName: List[str] | None = None, nonLocalizedName: str | None = None)¶

Bases: _ACUnionType

The unique identifier of a Property, identified by its name. May represent a User-Defined or a Built-In Property.

Variables:

type (str) – None
localizedName (list of str, optional) – A two-element list of the localized name parts. The first element is the name of the group the property belongs to, and the second element is the actual name of the property.
nonLocalizedName (str, optional) – The non-localized name of the Built-In Property.

__init__(type: str, localizedName: List[str] | None = None, nonLocalizedName: str | None = None)¶

static __new__(cls, type: str, localizedName: List[str] | None = None, nonLocalizedName: str | None = None)¶

Bases: _ACUnionType

A normal, userUndefined, notAvailable or notEvaluated property value.

Variables:

type (str) – None
status (str) – None
value (float, int, str, bool, list of float, list of int, list of str, list of bool, EnumValueId, list of EnumValueIdWrapper) – None; The identifier of a property enumeration value.; A list of enumeration identifiers.

__init__(type: str, status: str, value: float | int | str | bool | List[float] | List[int] | List[str] | List[bool] | EnumValueId | List[EnumValueIdWrapper] | None = None)¶

static __new__(cls, type: str, status: str, value: float | int | str | bool | List[float] | List[int] | List[str] | List[bool] | EnumValueId | List[EnumValueIdWrapper] | None = None)¶

class archicad.releases.ac25.b326types.PropertyValueOrErrorItem(propertyValue: PropertyValue | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A property value or an error

Variables:

propertyValue (PropertyValue, optional) – A normal, userUndefined, notAvailable or notEvaluated property value.
error (Error, optional) – The details of an error.

__init__(propertyValue: PropertyValue | None = None, error: Error | None = None)¶

static __new__(cls, propertyValue: PropertyValue | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.PropertyValueWrapper(propertyValue: PropertyValue)¶

Bases: _ACBaseType

Variables:: propertyValue (PropertyValue) – A normal, userUndefined, notAvailable or notEvaluated property value.

__init__(propertyValue: PropertyValue)¶

class archicad.releases.ac25.b326types.PropertyValuesOrError(propertyValues: List[PropertyValueOrErrorItem] | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A list of property values or an error.

Variables:

propertyValues (list of PropertyValueOrErrorItem, optional) – A list of property values.
error (Error, optional) – The details of an error.

__init__(propertyValues: List[PropertyValueOrErrorItem] | None = None, error: Error | None = None)¶

static __new__(cls, propertyValues: List[PropertyValueOrErrorItem] | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.PropertyValuesWrapper(propertyValues: List[PropertyValueOrErrorItem])¶

Bases: _ACBaseType

Variables:: propertyValues (list of PropertyValueOrErrorItem) – A list of property values.

__init__(propertyValues: List[PropertyValueOrErrorItem])¶

class archicad.releases.ac25.b326types.PublisherSetId(name: str, type: str = 'PublisherSets')¶

Bases: _ACBaseType

The identifier of a publisher set.

Variables:

name (str) – The name of the publisher set.
type (str) – The type of the navigator item tree.

__init__(name: str, type: str = 'PublisherSets')¶

class archicad.releases.ac25.b326types.RGBColor(red: float, green: float, blue: float)¶

Bases: _ACBaseType

A color model represented via its red, green and blue components.

Variables:

red (float) – The red component of the color model.
green (float) – The green component of the color model.
blue (float) – The blue component of the color model.

__init__(red: float, green: float, blue: float)¶

class archicad.releases.ac25.b326types.Subset(name: str, includeToIDSequence: bool, customNumbering: bool, continueNumbering: bool, useUpperPrefix: bool, addOwnPrefix: bool, customNumber: str, autoNumber: str, numberingStyle: str, startAt: int, ownPrefix: str)¶

Bases: _ACBaseType

A set of options used to assign IDs to the layouts contained in the subset.

Variables:

name (str) – The name for the layout subset.
includeToIDSequence (bool) – Defines whether this subset is included in automatic ID assignment or not.
customNumbering (bool) – Defines whether the IDs are generated automatically or a custom numbering is used.
continueNumbering (bool) – Defines whether to continue using the ID assignment of the upper levels or not. If ‘true’, layouts within this subset are going to be assigned IDs as if they were not within this subset, but part of the level above. In this case you only use the Subset as a logical grouping which has no effect on IDs.
useUpperPrefix (bool) – Defines whether to use the prefix and ID of the upper levels or not. If ‘true’, layouts in this subset will be assigned IDs based on the previous layout in the layout book structure.
addOwnPrefix (bool) – Defines whether to add own prefix to the subset or not.
customNumber (str) – The custom subset ID.
autoNumber (str) – The automatic subset ID.
numberingStyle (str) – A supported numbering style.
startAt (int) – The starting value of the numbering.
ownPrefix (str) – The custom prefix for the subset.

__init__(name: str, includeToIDSequence: bool, customNumbering: bool, continueNumbering: bool, useUpperPrefix: bool, addOwnPrefix: bool, customNumber: str, autoNumber: str, numberingStyle: str, startAt: int, ownPrefix: str)¶

class archicad.releases.ac25.b326types.SuccessfulExecutionResult(success: bool)¶

Bases: _ACBaseType

EMPTY STRING

Variables:: success (bool) – EMPTY STRING

__init__(success: bool)¶

class archicad.releases.ac25.b326types.SurfaceAttribute(header: AttributeHeader, materialType: str, ambientReflection: int, diffuseReflection: int, specularReflection: int, transparencyAttenuation: int, emissionAttenuation: int, surfaceColor: RGBColor, specularColor: RGBColor, emissionColor: RGBColor, fillId: AttributeIdOrError, transparency: int, shine: int, texture: Texture | None = None)¶

Bases: _ACBaseType

A surface attribute.

Variables:

header (AttributeHeader) – The header object of an attribute.
materialType (str) – The material type of a surface attribute.
ambientReflection (int) – The ambient reflection of the surface attribute.
diffuseReflection (int) – The diffuse reflection of the surface attribute.
specularReflection (int) – The specular reflection of the surface attribute.
transparencyAttenuation (int) – The transparency attenuation of the surface attribute.
emissionAttenuation (int) – The emission attenuation of the surface attribute.
surfaceColor (RGBColor) – A color model represented via its red, green and blue components.
specularColor (RGBColor) – A color model represented via its red, green and blue components.
emissionColor (RGBColor) – A color model represented via its red, green and blue components.
fillId (AttributeIdOrError) – The attribute’s identifier or an error.
transparency (int) – The transparency of the surface attribute.
shine (int) – The shininess of the surface attribute.
texture (Texture, optional) – A texture

__init__(header: AttributeHeader, materialType: str, ambientReflection: int, diffuseReflection: int, specularReflection: int, transparencyAttenuation: int, emissionAttenuation: int, surfaceColor: RGBColor, specularColor: RGBColor, emissionColor: RGBColor, fillId: AttributeIdOrError, transparency: int, shine: int, texture: Texture | None = None)¶

class archicad.releases.ac25.b326types.SurfaceAttributeOrError(surfaceAttribute: SurfaceAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A surface attribute or an error.

Variables:

surfaceAttribute (SurfaceAttribute, optional) – A surface attribute.
error (Error, optional) – The details of an error.

__init__(surfaceAttribute: SurfaceAttribute | None = None, error: Error | None = None)¶

static __new__(cls, surfaceAttribute: SurfaceAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.SurfaceAttributeWrapper(surfaceAttribute: SurfaceAttribute)¶

Bases: _ACBaseType

Variables:: surfaceAttribute (SurfaceAttribute) – A surface attribute.

__init__(surfaceAttribute: SurfaceAttribute)¶

class archicad.releases.ac25.b326types.Texture(name: str)¶

Bases: _ACBaseType

A texture

Variables:: name (str) – The name of the texture.

__init__(name: str)¶

class archicad.releases.ac25.b326types.UserDefinedPropertyUserId(localizedName: List[str], type: str = 'UserDefined')¶

Bases: _ACBaseType

The unique identifier of a User-Defined Property, identified by its name.

Variables:

localizedName (list of str) – A two-element list of the localized name parts. The first element is the name of the group the property belongs to, and the second element is the actual name of the property.
type (str) – EMPTY STRING

__init__(localizedName: List[str], type: str = 'UserDefined')¶

class archicad.releases.ac25.b326types.UserUndefinedPropertyValue(type: str, status: str = 'userUndefined')¶

Bases: _ACBaseType

A userUndefined value means that there is no actual number/string/etc. value, but the user deliberately set an Undefined value: this is a valid value, too.

Variables:

type (str) – EMPTY STRING
status (str) – EMPTY STRING

__init__(type: str, status: str = 'userUndefined')¶

class archicad.releases.ac25.b326types.ZoneCategoryAttribute(header: AttributeHeader, categoryCode: str, stampName: str, stampMainGuid: UUID, stampRevisionGuid: UUID, color: RGBColor)¶

Bases: _ACBaseType

A zone category.

Variables:

header (AttributeHeader) – The header object of an attribute.
categoryCode (str) – The category code of the zone.
stampName (str) – The stamp name of the zone category.
stampMainGuid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.
stampRevisionGuid (UUID) – A Globally Unique Identifier (or Universally Unique Identifier) in its string representation as defined in RFC 4122.
color (RGBColor) – A color model represented via its red, green and blue components.

__init__(header: AttributeHeader, categoryCode: str, stampName: str, stampMainGuid: UUID, stampRevisionGuid: UUID, color: RGBColor)¶

class archicad.releases.ac25.b326types.ZoneCategoryAttributeOrError(zoneCategoryAttribute: ZoneCategoryAttribute | None = None, error: Error | None = None)¶

Bases: _ACUnionType

A zone category attribute or an error.

Variables:

zoneCategoryAttribute (ZoneCategoryAttribute, optional) – A zone category.
error (Error, optional) – The details of an error.

__init__(zoneCategoryAttribute: ZoneCategoryAttribute | None = None, error: Error | None = None)¶

static __new__(cls, zoneCategoryAttribute: ZoneCategoryAttribute | None = None, error: Error | None = None)¶

class archicad.releases.ac25.b326types.ZoneCategoryAttributeWrapper(zoneCategoryAttribute: ZoneCategoryAttribute)¶

Bases: _ACBaseType

Variables:: zoneCategoryAttribute (ZoneCategoryAttribute) – A zone category.

__init__(zoneCategoryAttribute: ZoneCategoryAttribute)¶

archicad.releases.ac25.b326utilities¶

class archicad.releases.ac25.b326utilities.Utilities(actypes: Types, accommands: Commands)¶

Bases: object

Utility functions for the archicad module.

FindClassificationItemInSystem(system_name: str, item_id: str) → ClassificationItemId | None¶: Finds the classification item in a system.

FindClassificationSystem(systemName: str) → ClassificationSystemId | None¶: Finds the classification system.

static FindInClassificationItemTree(treeRootItem: ClassificationItemInTree, criterion: Callable[[ClassificationItemInTree], bool]) → List[ClassificationItemInTree]¶

Finds items in a navigator tree.

Parameters:

treeRootItem (ClassificationItemInTree) – The root item of the classification tree.
criterion (Callable[[ClassificationItemInTree], bool]) – The criterion function.

Returns:

The list of classification items, which fulfill the criterion function.

Return type:

List[ClassificationItemInTree]

static FindInNavigatorItemTree(treeRootItem: NavigatorItem, criterion: Callable[[NavigatorItem], bool]) → List[NavigatorItem]¶

Finds items in a navigator tree.

Parameters:

treeRootItem (NavigatorItem) – The root item of the navigator tree.
criterion (Callable[[NavigatorItem], bool]) – The criterion function.

Returns:

The list of navigator items, which fulfill the criterion function.

Return type:

List[NavigatorItem]

GetBuiltInPropertyId(name: str) → PropertyId¶: Returns the PropertyId of the corresponding built-in property.

GetDisplayValueFromPropertyEnumValueId(propertyId: PropertyId, enumValueId: EnumValueId) → str¶

Returns the display value of an enumeration property value.

Parameters:

propertyId (PropertyId) – The identifier of the property.
enumValueId (EnumValueId) – The enumeration value identifier.

Returns:

The display value of the enumeration property value.

Return type:

str

GetPropertyValuesDictionary(elements: List[ElementId], propertyIds: List[PropertyId]) → Dict[ElementId, Dict[PropertyId, Any]]¶

Returns the values of the given elements’ given properties.

Parameters:

elements (List[ElementId]) – The identifier of the property.
propertyIds (List[PropertyId]) – The property value.

Returns:

A dictionary for the property values with two key-levels: the first key is the elementId, the second key is the propertyId.

Return type:

Dict[ElementId, Dict[PropertyId, Any]]

GetUserDefinedPropertyId(groupName: str, name: str) → PropertyId¶: Returns the PropertyId of the corresponding user-defined property.

GetValueFromPropertyValue(propertyId: PropertyId, propertyValue: PropertyValue) → Any¶

Returns the display value of a property value.

Parameters:

propertyId (PropertyId) – The identifier of the property.
propertyValue (PropertyValue) – The property value.

Returns:

The value unwrapped from the property value.

Return type:

Any

static OpenFile(filepath: str)¶: Opens the given file with the default application.

__init__(actypes: Types, accommands: Commands)¶

__weakref__¶: list of weak references to the object (if defined)

archicad.releases.ac25¶

archicad.releases.ac25.b3000commands¶

archicad.releases.ac25.b3000types¶

archicad.releases.ac25.b3000utilities¶

archicad.releases.ac25.b326commands¶

archicad.releases.ac25.b326types¶

archicad.releases.ac25.b326utilities¶

Module contents¶

API Python Wrapper

Navigation

Related Topics