Graphisoft®

Basic Library Version: 16

Drawing Title

  1. Drawing Title object special parameters
  2. Operations with Drawing Title objects

1. Drawing Title object special parameters

Subtype parameters, input parameters (sets by ArchiCAD):

Name Type Description
AC_PreviewType Integer State of the two preview control buttons near the preview area of the Title Setting tab page.
0
show title only
1
show title and frame of the Drawing/Layout/Cell too
AC_LayoutRect Length one-dimension array with 5 rows. Contains the geometry definition of the Layout´s bounding rect (measured in the Drawing Title object´s coordinate sytem)
AC_LayoutRect[1]
lower left corner X
AC_LayoutRect[2]
lower left corner Y
AC_LayoutRect[3]
upper right corner X
AC_LayoutRect[4]
upper right corner Y
AC_LayoutRect[5]
direction angle (The bottom side´s angle of the rect. Measured in the Drawing Title object´s coordinate system. 0 <= angle > 360)
AC_GridRect Length Contains the geometry definition of the Cell´s bounding rect. The structure is same as with the AC_LayoutRect.
AC_DrawingRect Length Contains the geometry definition of the Drawing´s bounding rect. The structure is same as with the AC_LayoutRect.
AC_UseUniformTextFormat Boolean "Uniform Text Format" checkbox on the Settings Dialog.
AC_TextFont String Text font type control on the Settings Dialog.
AC_TextSize Real Text font size control on the Settings Dialog.
AC_TextPen Pen Text pen control on the Settings Dialog.
AC_TextStyle Integer "Bold", "Italic" and "Underline" buttons on the Settings Dialog.
1
Bold
2
Italic
4
Underline

Parameters on the Settings Dialog

Drawing Title parameters on the Settings Dialog

Subtype parameters, output parameters (sets by the Drawing Title object):

Name Type Description
AC_ConvertedTitle Boolean
0
Programmed Drawing Title object. (contols are active on the Settings Dialog)
1
Automatically created Drawing Title objects after importing Plot Maker layout book (contols are grayed out on the Settings Dialog)
AC_TitleFitMode Integer
1
Object origin aligned to the Drawing bounding box´s lower left corner with the rotation of the Drawing.
2
Object origin aligned to the Layout bounding box´s lower left corner. Rotation angle = 0.
3
Object origin aligned to the Cell bounding box´s lower left corner. Rotation angle = 0.

Subtype parameters, input/output parameters (sets by ArchiCAD and the Drawing Title object too):

Name Type Description
AC_ManualPosition Boolean
0
Custom position. Drawing Title object dragged away by the user ("Move sub-element" operation on the pet palette).
1
Fit to Drawing/Layout/Cell.

Fix named optional parameters, input parameters (sets by ArchiCAD):

Name Type Description
AC_DrawingName String Name of the Drawing.
AC_DrawingNumber String ID of the Drawing.
AC_DrawingScale String Drawing Scale as set in the Drawing Settings Dialog.
AC_OriginalDrawingScale String Original Drawing Scale
AC_Magnification Real Magnification as set in the Drawing Settings Dialog.
AC_SourceFileName String File name of the Drawing, if it came from an external source (e.g. "MyPicture.jpg")
AC_SourceFilePath String File name of the Drawing with full path, if it came from an external source (e.g. "D:\Pictures\MyPicture.jpg")

Parameters on the Settings Dialog

Drawing Title parameters on the Settings Dialog

GDL Requests:

n = request ("HomeDB_info", "", n, LayoutNumber, LayoutName, n) n = request ("Name_of_plan", "", n, ProjectName, ProjectPath)

Name Type Description
ProjectName String File name of the project (e.g. "MyHouse.pln").
ProjectPath String File name of the project with full path (e.g. "D:\Buildings\MyHouse.pln").
LayoutName String Name of the Layout.
LayoutNumber String ID of the Layout.

Operations with Drawing Title objects

Placing a Drawing Title object:

If the AC_TitleFitMode = 1 (Drawing), the Drawing Title will be placed at the Drawing bounding box´s lower left corner with the desired rotation.

If the AC_TitleFitMode = 2 (Layout), the Drawing Title will be placed on the Layout´s lower left corner. Rotation angle = 0.

If the AC_TitleFitMode = 3 (Cell), the Drawing Title will be placed on the Cell´s lower left corner. Rotation angle = 0.

AC_LayoutRect, AC_GridRect and AC_DrawingRect parameters will be updated.

Moving or Rotating Drawing:

If the AC_TitleFitMode = 1 (Drawing), the Drawing Title object will be transformed too.

If the AC_TitleFitMode = 2 (Layout), the Drawing Title will remain in the same position.

If the AC_TitleFitMode = 3 (Cell), the left bottom corner of the new bounding box has to be computed, and the Title has to be shifted with the difference vector of the old and the new corners.

AC_LayoutRect, AC_GridRect and AC_DrawingRect parameters will be updated.

Moving Drawing Title object: ("Move sub-element"):

The AC_ManualPosition parameter will be set to true (1).

The Drawing Title object will be moved to the desired position.

AC_LayoutRect, AC_GridRect and AC_DrawingRect parameters will be updated.

Modifying a placed Drawing Title´s parameters:

If the AC_ManualPosition = 0 and the AC_TitleFitMode = 1 (Drawing), the Drawing Title will be placed at the Drawing bounding box´s lower left corner with the desired rotation.

If the AC_ManualPosition = 0 and the AC_TitleFitMode = 2 (Layout), the Drawing Title will be placed on the Layout´s lower left corner. Rotation angle = 0.

If the AC_ManualPosition = 0 and the AC_TitleFitMode = 3 (Cell), the Drawing Title will be placed on the Cell´s lower left corner. Rotation angle = 0.

AC_LayoutRect, AC_GridRect and AC_DrawingRect parameters will be updated.