GDLnucleus



The object fission & fusion tool     EN

Functionality

ArchiCAD-objects have all the same file extension GSM. This is a proprietary format of Graphisoft and can only be interpreted by ArchiCAD. The GDL scripts inside the object are most stored in clear text. Shipped with ArchiCAD comes the tool LP_XMLConverter. This tool can convert GSM files into XML. If needed it makes this for complete folders or libraries.

The GDLnucleus tool provides to easy edit the source code of objects in Sublime Text. For every object or group of objects has to be created a project folder, in which all for the development relevant files have to be stored. In this project structure has to be a folder for GSM objects, which for test purposes should be part of your ArchiCAD project. This folder is some kind of a development library.

The build system of Sublime Text can in combination with GDL nucleus and the XML converter transfers complete libraries into XML format by one single shortcut.The XML files are automatically splitted into single files as you know the script editing in ArchiCAD environment. Each object gets a separate subfolder.The way back to ArchiCAD readable objects (in GSM format)is initiated by one single key too.

Back in ArchiCAD you have to reload libraries (best by an additional shortcut) and you can test the new object.. We strongly recommend to use development libraries and project folders not in productive projects or environmaent.

Demonstration videos

Detailed manuals

The versions for Windows and MacOS are not different in the basic functionality or workflow, but they are different implemented.

On MacOS a shell script is doing the dividing and merging of the XML files. On Windows it is done by a DotNet application with optional GUI.

The windows version can be used with MacOS/parallels, but has probably some limitations. E.g. no hotkey call out of sublime text. And there is no manual or support for this environment.

Here you find the two different manuals:

Go here to the MacOS version manual.

Go here to the Windows version manual.

Tipps & FAQ

Library update in ArchiCAD by a hotkey.

When you edit objects in sublime text, changes do not take effect instantly in your ArchiCAD project. The loaded libraries have to be updated/reloaded first. In the default configuration of ArchiCAD you can initiate this process only by the library menu.

When using the GDLnucleus environment you will have to do this so often, that you should define a shortcut for this command. Go to Options>work environment>shortcut schemes and you can define your preferred key.

Dialog for hotkey settings

We recommend CMD-B, because this is the shortcut in sublime text either to start the build process. 

Creating a new object

In ArchiCAD the GUID of each object is essential since version 10, because ArchiCAD identifies the object not by its file name anymore, but by this GUID. This ID is generated, when you cretae a new object using the ArchiCAD object dialog. So it is not recommended to duplicate older XML files. You should create your new GDL project by a "new object" or "save-as" command with checkbox "create new library part". You can do this with the XML converter too, but it is more complicated..

 

Insert preview icon.

Add in the file 95_Pictures.xml the following line to add a preview bitmap to your object:

<Picture MIME="image/png" path="filename.png" SubIdent="0" SectVersion="19" SectionFlags="0"></Picture>

You have to set filetype, filename and the index 0. The path to the bitmap has not to be set explicit. You have to collect all object relevant bitmaps in the folder bitmaps, which should be a subfolder of your main project folder. This path and folder name is used by default, when the converter is called.

Insert bitmaps for the user interface.

Add in the file 95_Pictures.xml for each bitmap you want to integrate into the object a line like this:

<GDLPict MIME="image/gif" path="filename.gif" SubIdent="1" platform="Win" SectVersion="19" SectionFlags="0"></GDLPict>

You have to set filetype, filename and an increasing Index. The index has to be continious and is the equal to the number, which you have to use in GDL to refer to the bitmap. The path to the bitmap has not to be set explicit. You have to collect all object relevant bitmaps in the folder bitmaps, which should be a subfolder of your main project folder. This path and folder name is used by default, when the converter is called. To copy the bitmap files inside the folder is not enough to integrate the bitmaps into your object. They have to be named as in the example above.

Diese Website benutzt Cookies um die Nutzererfahrung zu verbessern. Datenschutzerklärung