API Development KitVersion: 6.1

Structure of an Add-On

 
Practically an add-on is a DLL on Windows, or a shared library on the Macintosh. When you launch ArchiCAD, it looks for the available add-ons in this order:

  • It looks for the Add-Ons folder in its own home directory (that is, where you have installed it)
  • The designated add-ons folder can be changed in the Add-On Manager dialog of ArchiCAD (Tools menu / Add-On Manager...). This path is stored into the system registry under the 'HKEY_CURRENT_USER\Software\Graphisoft\ArchiCAD 9.0.0 xxx\Add-On Manager' key on Windows. Next time when you launch the application, the Add-On Manager will enumerate the add-ons from this location.
    Note that until you change the Designated Add-Ons folder from the Add-On Manager dialog, the 'Default Location' key is set to %DEFAULT%, which means the Add-Ons folder right next to the application. The 'Actual Path' registry entry shows the actual folder where the add-ons are loaded from.
  • You can edit the list of loaded add-ons even individually in the Add-On Manager dialog. The full pathes of the added, disabled and skipped add-ons are stored in the registry also.

 
If ArchiCAD finds an Add-Ons folder somewhere, it gathers all the appropriate files from it and from its subfolders. Subfolders on any level are skipped when the name of it begins with the a parentheses '(' character. Add-ons can also be loaded individually in the Add-On Manager (Tools/Add-On Manager) in ArchiCAD, which also facilitates enabling and disabling of loaded add-ons.

 
Every file must pass several tests to be considered as a valid ArchiCAD add-on. If the any of the following requirements are not fulfilled the add-on commands will be not mounted into the ArchiCAD.

Required Resources

 
In order to be able to build an add-on you must fulfill some requirements in the source files too. Also there are requirements how to set up compilation options and linking parameters.

Required Functions
Compilation and Linking Issues
Jump to top
Copyright © 2004 - Graphisoft R&D Software Development Rt. All rights reserved worldwide.
Built on August 22, 2003