Arch Frame

Other languages:

Roof

Fence

BIM

THIS COMMAND IS PART OF THE INTEGRATED BIM WORKBENCH IN V1.0
This page has been updated for that version.

Menu location
Arch Frame
3D/BIM → Frame
Workbenches
BIM
Default shortcut
F R
Introduced in version
-
See also
None

Description

The Arch Frame tool is used to build all kinds of frame objects based on a profile and a layout. The profile is extruded along the edges of the layout, which can be any 2D object such as a sketch, or a Draft object. It is especially useful to create railings, or frame walls. Frame objects can then easily be turned into wall or structure objects.

Frame object created from a Draft OrthoArray of a Draft Line, using a Draft Circle as profile

Usage

Create a layout object and a profile object, for example with the Draft Workbench or the Sketcher Workbench.
Select the layout object first, then, with Ctrl pressed, select the profile object.
Press the Frame button, or press F then R keys.

Options

Frames share the common properties and behaviours of all Arch Components
The frame object can be placed at a certain distance from the layout object, by setting its Offset property
The profile will be copied at the base of each edge of the layout object, then extruded along it. You can control how the profile is placed at the base of each edge with the Align and Rotation properties.

Properties

Data

Component

DataBase (Link): The layout this frame is based on.

For the other properties in the group see Arch Component.

Frame

DataAlign (Bool): Specifies if the profile must be rotated to have its normal axis aligned with each edge.
DataBase Point (Integer): Zero-based index indicating the crossing point of the path on the profile:
- 0: The Base of the Placement of the profile. This point is also used in case of an invalid index.
- 1: The midpoint of the 1st edge of the profile.
- 2: The endpoint of the 1st edge of the profile.
- 3: The midpoint of the 2nd edge of the profile.
- 4: The endpoint of the 2nd edge of the profile.
- ...
- n*2-1: The midpoint of the nth edge of the profile.
- n*2: The endpoint of the nth edge of the profile.
DataEdges (Enumeration): The type of edges to consider. The options are:
- All edges
- Vertical edges
- Horizontal edges
- Bottom horizontal edges: Based of the global Z coordinate of the center of mass of the edge.
- Top horizontal edges: Idem.
DataFuse (Bool): If true, overlapping solids are fused.
DataOffset (VectorDistance): An optional distance between the layout object and the frame object.
DataProfile (Link): The profile this frame is based on.
DataProfile Placement (Placement): An optional additional placement to add to the profile before extruding it. Only the Rotation of the Placement is used. Ignored if DataAlign is true.
DataRotation (Angle): The rotation of the profile around its extrusion axis.

Scripting

See also: Arch API and FreeCAD Scripting Basics.

The Frame tool can be used in macros and from the Python console by using the following function:

Frame = makeFrame(baseobj, profile)

Creates a Frame object from the given baseobj and profile.
- baseobj is any object containing wires, like a Draft Wire, or a Draft OrthoArray with a collection of them.
- profile is an extrudable 2D object containing faces or closed wires.

Example:

import Draft, Arch

Line = Draft.makeLine(FreeCAD.Vector(0, 0, 0), FreeCAD.Vector(0, 0, 2000))
baseobj = Draft.makeArray(Line, FreeCAD.Vector(1000, 0, 0), FreeCAD.Vector(0, 1, 0), 6, 1)

profile = Draft.makeCircle(200)
Frame = Arch.makeFrame(baseobj, profile)
FreeCAD.ActiveDocument.recompute()