Create Swept Beam
create_swept_beamPlace or update a sloped, curved beam in Archicad from a Morph line, polyline, line, arc, or point list, with profile, slope, offsets, and end cuts; dry-run by default.
Instructions
Place a Swept Beam: a sloped, curved beam with a Profile Manager profile or a rectangle, as the 'Swept Beam' library part. The path comes from source_guid (a Morph line, Polyline, Line or Arc) or from points [{x, y, z}] in metres. Flat sources take start_height (metres above the source) and slope_percent; morph lines and points keep their own heights. profile is {"attribute": ""} or {"rectangle": {"width", "height", "building_material"}} (default 0.2 x 0.2 rectangle). update_guid rewrites the path of an existing Swept Beam, keeping its GUID; its profile, offsets, flip and end cuts stay unless given, and node roll resets to 0. End cuts in degrees: cut_start_plan and cut_end_plan turn a cut counter-clockwise from square in plan (-80 to 80); cut_start_tilt and cut_end_tilt lean the top of the face out past the end (-85 to 85, 0 is square to the beam, the beam's slope there gives a vertical face). ref_line ('left face', 'centre', 'right face', looking from the first point to the last) puts that face of the beam on the path; ref_offset (metres) moves the beam that far away from it (with centre, to the right). DRY-RUN BY DEFAULT: reports nodes, arcs, the maximum deviation from the source and warnings. Pass dry_run=false to place or update.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flip | No | ||
| port | No | ||
| points | No | ||
| dry_run | No | ||
| profile | No | ||
| offset_u | No | ||
| offset_w | No | ||
| ref_line | No | ||
| ref_offset | No | ||
| source_guid | No | ||
| update_guid | No | ||
| cut_end_plan | No | ||
| cut_end_tilt | No | ||
| start_height | No | ||
| slope_percent | No | ||
| cut_start_plan | No | ||
| cut_start_tilt | No | ||
| path_tolerance | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||