Drawing Title

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

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

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.