GuiCommand: Name: Arch Frame MenuLocation: 3D/BIM , Frame Workbenches: BIM_Workbench Shortcut: F R SeeAlso:

Arch Frame

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.

Usage

1. Create a layout object and a profile object, for example with the Draft Workbench or the Sketcher Workbench.
2. Select the layout object first, then, with Ctrl pressed, select the profile object.
3. 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

{{TitleProperty|Component}}

• Base|Link: The layout this frame is based on.

For the other properties in the group see Arch Component.

{{TitleProperty|Frame}}

• Align|Bool: Specifies if the profile must be rotated to have its normal axis aligned with each edge.

• Base Point|Integer: Zero-based index indicating the crossing point of the path on the profile:

• {{Value|0}}

    : The **Base** of the **Placement** of the profile. This point is also used in case of an invalid index.

-   
    {{Value|1}}

    : The midpoint of the 1st edge of the profile.

-   
    {{Value|2}}

    : The endpoint of the 1st edge of the profile.

-   
    {{Value|3}}

    : The midpoint of the 2nd edge of the profile.

-   
    {{Value|4}}

    : The endpoint of the 2nd edge of the profile.

-   \...

-   
    {{Value|n*2-1}}

    : The midpoint of the nth edge of the profile.

-   
    {{Value|n*2}}

    : The endpoint of the nth edge of the profile.

• Edges|Enumeration: The type of edges to consider. The options are:

• {{Value|All edges}}

• {{Value|Vertical edges}}

• {{Value|Horizontal edges}}

• {{Value|Bottom horizontal edges}}

    : Based of the global Z coordinate of the center of mass of the edge.

-   
    {{Value|Top horizontal edges}}

    : Idem.

• Fuse|Bool: If true, overlapping solids are fused.

• Offset|VectorDistance: An optional distance between the layout object and the frame object.

• Profile|Link: The profile this frame is based on.

• Profile Placement|Placement: An optional additional placement to add to the profile before extruding it. Only the Rotation of the Placement is used. Ignored if Align is True.

• Rotation|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](wiki-test2.php?gitpage=Draft_Wire), or a [Draft OrthoArray](wiki-test2.php?gitpage=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()

⏵ documentation index > BIM > Arch Frame

This page is retrieved from https://github.com/FreeCAD/FreeCAD-documentation/blob/main/wiki/Arch_Frame.md