Libraries & objects
About Archicad and BIMcloud libraries, their management and migration, objects and other library parts, etc.

Fixed named optional parameters

rocorona
Booster
We know that the GLOBAL variables are still improved, but for many uses the "new way" is the use of optional parameters wit fixed names.
THIS PAGE gives us a full list of the recognized variable names.
Or not? The GDL manual (AC12 page 188) says "If these buttons are pushed, the gs_ui_current_page parameter of the library part is set to the index of the page to show - if there's a parameter with this name."
But this is not in the list. The list only contains parameters starting with "ac_". Is there another page for "gs_" parameters?
_________________

--Roberto Corona--
www.archiradar.com
AC18 - ITA full on Win10
_________________
_________________
2 REPLIES 2
Karl Ottenstein
Moderator
rocorona wrote:
... the gs_ui_current_page parameter ...

But this is not in the list. The list only contains parameters starting with "ac_". Is there another page for "gs_" parameters?
Good catch, Roberto. The Library Developer kit documents 100's of gs_ parameters for particular object subtypes... but within the page for each subtype (e.g., windows). I do not see a 'master' listing anywhere.

Also, searching for gs_ui_current_page only turns up the quote that you gave, and library parts that contain the parameter. No documentation.

The AC 10 online standards (and downloadable 12) include references to this parameter:
http://www.graphisoft.com/ftp/techsupport/documentation/developer_docs/BasicLibraryDoc/10/LibDevGuid...
If you want to use the Previous and Next buttons, too, you should add a integer parameter to your object, gs_ui_current_page. The execution environment (i.e. ArchiCAD) will set this parameter's value when the classic Previous or Next button is pushed.

Example showing the whole mechanism:
Oddly, the online file link calls these the "GDL Technical Standards 2.0" (for version 10). The downloadable document in the 12 lib kit simply calls them the "GDL Technical Standards".

Karl
One of the forum moderators
AC 27 USA and earlier   •   macOS Ventura 13.6.6, MacBook Pro M2 Max 12CPU/30GPU cores, 32GB
rocorona
Booster
If I'm correct, that ones (or 100's...) are those you get when assigning a subtype to an object.
Then, as you get them automatically, you don't really need to know about them. But gs_ui_current_page is one of general use, you have to create in any type of object, if it uses pages in it's UI.
_________________

--Roberto Corona--
www.archiradar.com
AC18 - ITA full on Win10
_________________
_________________