Appendix A - Fix named optional parameters

1. Parameters set by ArchiCAD

The new method of ArchiCAD for providing information is the method of optional parameters. If a given library part has a parameter with a name and type matching any optional parameter, ArchiCAD® sets its value according to its function.

1.1. Parameters for D/W attributes (available for Door, Window, Label, Listing)

Floor plan display

ac_hole_cut_linetype - linetype

pen of cut lines [floor plan and section]

ac_hole_overhead_pen - pen

pen of the above view edges (overhead) [floor plan only]

ac_hole_overhead_linetype - linetype

line type of the above view edges (overhead) [floor plan only]

ac_hole_uncut_pen - pen

pen of the below view edges (uncut) [floor plan only]

ac_hole_uncut_linetype - linetype

line type of the below view edges (uncut) [floor plan only]

ac_hole_display_option - integer

floor plan display option: 1 - Projected, 2 - Projected with Overhead, 3 - Symbolic, 5 - Overhead All

Direction

ac_hole_direction_type - integer

vertical anchor of D/W: 1 - Associated to Wall, 2 - Vertical

ac_wido_rotation - angle

door/window rotation angle relative to the horizontal cut plane

Polygonal wall data

ac_walltype - integer

tells whether the window is in a polygonal wall or not. 1 - non polygonal, 2 - polygonal.

ac_wallContourPolygon[][3] - length

The polygon of the wall in 2D points plus an extra angle value for arc sections. [set only if ac_walltype equals 2]

ac_windowInWallContour[4] - integer

Indices of the four vertices of the ac_wallContourPolygon polygon being in the wall contour polygon as window corner points. [set only if ac_walltype equals 2]

Hole position

ac_hole_position_angle - angle

In case of curved walls it gives the angle between the axis of the opening and the normal vector at the wall's starting point.

1.2. Parameters for WALL attributes (available for Door, Window, Label, Listing)

Floor plan display

ac_wall_overhead_pen - pen

pen of the above view edges of the wall (overhead) [floor plan only]

ac_wall_overhead_linetype - linetype

line type of the above view edges of the wall (overhead) [floor plan only]

ac_wall_uncut_linetype - linetype

line type of the below view edges of the wall (uncut) [floor plan only]

ac_wall_display_option - integer

floor plan display option of the wall: 1 - Projected, 2 - Projected with Overhead, 3 - Symbolic, 4 - OutLines Only, 5 - Overhead All

ac_wall_show_projection_to - integer

vertical view depth limitation of the wall: 1 - To Floor Plan Range, 2 - To Absolute Display Limit, 3 - Entire Element

Geometric data

ac_wall_elevation - length

elevation of the wall bottom, relative to home story of the wall

ac_wall_crosssection_type - integer

wall cross section type: 1 - Simple, 2 - Complex, 3 - Slanted, 4 - Trapezoid

ac_wall_profile_name - string

profile name if the wall is complex with profile attribute, "Custom_Profile_i" if complex with custom profile (i being the id of the placed wall) or "n/a" if the wall is simple, slanted or trapezoid

ac_wall_slant_angle1 - angle

first slant angle of the wall relative to the horizontal (90 degrees if the wall is vertical)

ac_wall_slant_angle2 - angle

second slant angle of the wall relative to the horizontal (90 degrees if the wall is vertical)

ac_wall_direction_type - integer

wall direction type; the construction method of the wall actually, which means the adjustment of the wall body and the reference line: 0 - Right, 1 - Left, 2 - Center (Right), 3 - Center (Left). Center values mean that the wall is set to 'Center' in the user interface, but the side notation shows how the wall acts internally.

1.3. Parameters for COLUMN attributes (available for Label, Listing)

Floor plan display

ac_colu_overhead_pen - pen

pen of the above view edges of the column (overhead) [floor plan only]

ac_colu_overhead_linetype - linetype

line type of the above view edges of the column (overhead) [floor plan only]

ac_colu_uncut_linetype - linetype

line type of the below view edges of the column (uncut) [floor plan only]

ac_colu_display_option - integer

floor plan display option of the column: 1 - Projected, 2 - Projected with Overhead, 3 - Symbolic, 4 - OutLines Only, 5 - Overhead All

ac_colu_show_projection_to - integer

vertical view depth limitation of the column: 1 - To Floor Plan Range, 2 - To Absolute Display Limit, 3 - Entire Element

Geometric data

ac_colu_crosssection_type - integer

column cross section type: 1 - Rectangular, 2 - Round, 3 - Complex

ac_colu_profile_name - string

profile name if the column is complex with profile attribute, "Custom_Profile_i" if complex with custom profile (i being the id of the placed column) or "n/a" if the column is rectangular or round

ac_colu_inclination - angle

inclination angle of the column relative to the horizontal line

ac_colu_twist_angle - angle

twist angle of the cross section

1.4. Parameters for BEAM attributes (available for Label, Listing)

Floor plan display

ac_beam_overhead_pen - pen

pen of the above view edges of the beam(overhead) [floor plan only]

ac_beam_overhead_linetype - linetype

line type of the above view edges of the beam (overhead) [floor plan only]

ac_beam_uncut_pen - pen

pen of the below view edges of the beam (uncut) [floor plan only]

ac_beam_uncut_linetype - linetype

line type of the below view edges of the beam (uncut) [floor plan only]

ac_beam_display_option - integer

floor plan display option of the beam: 1 - Projected, 2 - Projected with Overhead, 3 - Symbolic, 4 - OutLines Only, 5 - Overhead All

ac_beam_show_projection_to - integer

vertical view depth limitation of the beam: 1 - To Floor Plan Range, 2 - To Absolute Display Limit, 3 - Entire Element

Geometric data

ac_beam_crosssection_type - integer

beam cross section type: 1 - Rectangular, 2 - Complex

ac_beam_profile_name - string

profile name if complex with profile attribute, "Custom_Profile_i" if complex with custom profile (i being the id of the placed beam) or "n/a" if the beam is rectangular

ac_beam_inclination - angle

inclination angle of the column relative to the horizontal line

ac_beam_twist_angle - angle

twist angle of the cross section (0.0 for non-complex beams)

1.5. Parameters for ROOF attributes (available for Label, Listing)

Floor plan display

ac_roof_overhead_pen - pen

pen of the above view edges of the roof (overhead) [floor plan only]

ac_roof_overhead_linetype - linetype

line type of the above view edges of the roof (overhead) [floor plan only]

ac_roof_display_option - integer

floor plan display option of the roof: 1 - Projected, 2 - Projected with Overhead, 3 - Symbolic, 4 - OutLines Only, 5 - Overhead All

ac_roof_show_projection_to - integer

vertical view depth limitation of the roof: 1 - To Floor Plan Range, 2 - To Absolute Display Limit, 3 - Entire Element

1.6. Door/Window Marker attributes

ac_wido_id - string

ID of the opening

ac_wido_a_size - length

opening width

ac_wido_b_size - length

opening height

ac_wido_z_size - length

opening depth/thickness

ac_glob_elevation - length

elevation of the base line of the opening

ac_wido_subfl_thickness - length

height of the subfloor wall part

ac_wido_reveal_side - boolean

legacy opening reveal side value, use ac_wido_reveal_side_2 instead

ac_wido_reveal_side_2 - boolean

reveal side, the value of the WIDO_REVEAL_SIDE global variable set for the opening

ac_wido_mirrored - boolean

mirrored state of the opening

ac_wall_thickness - length

thickness of the wall at the origin of the opening

ac_wido_oversize_l - length

left opening oversize

ac_wido_oversize_r - length

right opening oversize

ac_wido_oversize_t - length

top opening oversize

ac_wido_oversize_b - length

bottom opening oversize

ac_wido_orientation - string

marker position: "L" - Left, "R" - right, or any custom value set in the Details window of the library part editor according to the current mirrored state

ac_wido_type - integer

1 - Door, 2 - Window

ac_symb_rotangle - angle

opening rotation in the wall

ac_sill_to_curr_story - length

sill height of the opening measured from the start of the current storey; the current storey is the storey, in which the sill actually is

ac_sill_to_anchor_level - length

sill height of the opening measured from the level of the anchor point; the anchor point may be the bottom of the wall or the selected storey, accordingly

1.7. Detail/Worksheet Marker attributes

ac_showboundary - boolean

Marker boundary polygon state

2. Parameters read by ArchiCAD

ArchiCAD can get values from library parts through parameters with predefined name and function. The list of such parameters follow below.

2.1. Objects on Floor Plan

Floor plan cutting of planar elements (i.e. skylight object, roof accesory objects)

ac_special_2d_symbol - boolean

This parameter enables a 2D cutting mechanism in ArchiCAD floor plan. If the parameter is set to 1, ArchiCAD cuts the 2D model (generated by the 2D script of the libpart) according to the parameter values in: ac_symb_display_option, ac_symb_show_projection_to and ac_plane_definition. This 2D-based cut works like the display of simple roofs under the same settings. Naturally, this method gives correct output for plane-like element only - like skylights and roof accessories. The plane of the flat object - and the plane of the cut - is defined by the parameter ac_plane_definition. For Skylight and Roof Accessory elements - if ac_special_2d_symbol is 1 -, the above parameters are set by the add-on automatically. For other elements the library developer should fill in the parameters.

ac_plane_definition[6] - length

Plane definition: ([1],[2],[3]): a point on the plane, ([4],[5],[6]): normal vector of the plane.

ac_symb_display_option - integer

1 - Projected, 2 - Projected with Overhead, 3 - Symbolic, 4 - OutLines Only, 5 - Overhead All

ac_symb_show_projection_to - integer

1 - To Floor Plan Range, 2 - To Absolute Display Limit, 3 - Entire Element

3. Parameters for add-ons

Add-ons can get values from library parts through parameters with predefined name and function. The list of such parameters in connection of the AC-package add-ons follow below.

3.1. Parameters of Skylight add-on

Hole edge cut manipulation

ac_edge_lower_type - integer

Cut type of the lower edge: 0 - Vertical, 1 - Perpendicular, 2 - Horizontal, 3 - Custom

ac_edge_lower_angle - angle

Angle of the cut of the lower edge, if ac_edge_lower_type is 3. The value range is [1-179] degrees, 90 is the perpendicular case.

ac_edge_upper_type - integer

Cut type of the upper edge: 0 - Vertical, 1 - Perpendicular, 2 - Horizontal, 3 - Custom

ac_edge_upper_angle - angle

Angle of the cut of the upper edge, if ac_edge_upper_type is 3. The value range is [1-179] degrees, 90 is the perpendicular case.