Arch Roof/pt-br: Difference between revisions

From FreeCAD Documentation
(Created page with "==Utilização==")
(Updating to match new version of source page)
 
(12 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

<div class="mw-translate-fuzzy">
{{Docnav
{{Docnav
|[[Arch_Grid/pt-br|Grade]]
|[[Arch_Grid/pt-br|Grade]]
|[[Arch_Space/pt-br|Espaço]]
|[[Arch_Space/pt-br|Espaço]]
|[[Arch_Module/pt-br|Arch]]
|[[Arch_Workbench/pt-br|Arch]]
|IconL=Arch_Grid.svg
|IconL=Arch_Grid.svg
|IconR=Arch_Space.svg
|IconR=Arch_Space.svg
|IconC=Workbench_Arch.svg
|IconC=Workbench_Arch.svg
}}
}}
</div>


<div class="mw-translate-fuzzy">
{{GuiCommand
{{GuiCommand
|Name=Arch Roof
|Name=Arch Roof
|MenuLocation=Arch → Roof
|MenuLocation=Arch → Roof
|Workbenches=[[Arch_Module/pt-br|Arch]]
|Workbenches=[[Arch_Workbench/pt-br|Arch]]
|Shortcut={{KEY|R}} {{KEY|F}}
|Shortcut={{KEY|R}} {{KEY|F}}
|SeeAlso=[[Arch_Structure/pt-br|Arch Structure]], [[Arch_Wall/pt-br|Arch Wall]]
|SeeAlso=[[Arch_Structure/pt-br|Arch Structure]], [[Arch_Wall/pt-br|Arch Wall]]
}}
}}
</div>


<span id="Description"></span>
==Descrição==
==Descrição==


Line 28: Line 34:
</div>
</div>


<span id="Usage_(wire_base)"></span>
<div class="mw-translate-fuzzy">
==Utilização==
==Utilização==
</div>


# Create a wire with following the counter-clockwise direction and select it.
# Create a closed wire with following the counter-clockwise direction and select it.
#:[[Image:CounterclockwiseWire.png|600px]]
#:[[Image:CounterclockwiseWire.png|600px]]
# Press the {{Button|[[Image:Arch Roof.svg|16px]] [[Arch Roof|Arch Roof]]}} button, or press {{KEY|R}} then {{KEY|F}} keys
# Press the {{Button|[[Image:Arch Roof.svg|16px]] [[Arch Roof|Arch Roof]]}} button, or press {{KEY|R}} then {{KEY|F}} keys
# The default roof object could have a strange shape, it's because the tool is missing some necessary information.
# The default roof object could have a strange shape, it's because the tool is missing some necessary information.
# After creating the default roof, double click on the object in the [[tree view]] to access and edit all the properties. Angle must be between 0 and 90.
# After creating the default roof, double click on the object in the [[Tree_view|tree view]] to access and edit all the properties. Angle must be between 0 and 90.
#:[[File:RoofTable.png]]
#:[[File:RoofTable.png]]
# Each line corresponds to a roof pane. So you can set the properties you want for each roof pane.
# Each line corresponds to a roof pane. So you can set the properties you want for each roof pane.
Line 46: Line 55:
# {{Emphasis|Note}}: for better comprehension, please see this [https://www.youtube.com/watch?v=4Urwru71dVk youtube clip].
# {{Emphasis|Note}}: for better comprehension, please see this [https://www.youtube.com/watch?v=4Urwru71dVk youtube clip].


==Usage (solid base)==
==Options==


If your roof has a complex shape (e.g. contains pitched windows or other non-standard features) you can create a custom solid object using various other FreeCAD workbenches ([[Part_Workbench|Part]], [[Sketcher_Workbench|Sketcher]] etc.). And then use this solid as the {{PropertyData|Base}} object of your roof:
* Roofs share the common properties and behaviors of all [[Arch Component|Arch Components]]


# Select the solid base object.
==Properties==
# Press the {{Button|[[Image:Arch_Roof.svg|16px]] [[Arch Roof|Arch Roof]]}} button, or press {{KEY|R}} then {{KEY|F}} keys.


==Subtracting a roof==
* {{PropertyData|Angles}}: List of the slope angle of the roof pane (an angle for each edge in the wire).

* {{PropertyData|Runs}}: List of the width of the roof pane (a run for each edge in the wire).
Roofs have an automatically generated subtraction volume ({{Version|1.0}} for roofs with a solid base). When a roof is [[Arch_Remove|removed]] from the walls of a building, both the roof itself as well as everything above it is subtracted from the walls.
* {{PropertyData|IdRel}}: List of relation Id of the slope angle of the roof.

* {{PropertyData|Thickness}}: List of thickness of the roof pane. (a thickness for each edge in the wire).
{{Version|1.0}}: It is possible to override the automatic subtraction volume by setting the {{PropertyData|Subvolume}} property of the roof to a custom solid object.
* {{PropertyData|Overhang}}: List of the overhang of the roof pane (an overhang for each edge in the wire).

* {{PropertyData|Face}}: The face index of the base object to be used (not really used).
[[File:Arch_Roof_Subtract_Default.png|x150px]] [[File:Arch_Roof_Subtract_Subvolume.png|x150px]] [[File:Arch_Roof_Subvolume_Example.png|x150px]]
{{Caption|Solid-based roof before (1st image) and after (2nd image) [[Arch_Remove|removing]] it from walls.<br>
The 3rd image shows the generated subtraction volume.}}

<span id="Options"></span>
==Opções==

* Roofs share the common properties and behaviors of all [[Arch_Component|Arch Components]].

<span id="Properties"></span>
==Propriedades==

===Data===

{{TitleProperty|Roof}}

* {{PropertyData|Angles|FloatList}}: The list of angles of the roof segments.
* {{PropertyData|Border Length|Length}}: The total length of the borders of the roof.
* {{PropertyData|Face|Integer}}: The face number of the base object used to build the roof (not used).
* {{PropertyData|Flip|Bool}}: Specifies if the direction of the roof should be flipped.
* {{PropertyData|Heights|FloatList}}: The list of calculated heights of the roof segments.
* {{PropertyData|Id Rel|IntegerList}}: The list of IDs of the relative profiles of the roof segments.
* {{PropertyData|Overhang|FloatList}}: The list of overhangs of the roof segments.
* {{PropertyData|Ridge Length|Length}}: The total length of the ridges and hips of the roof.
* {{PropertyData|Runs|FloatList}}: The list of horizontal length projections of the roof segments.
* {{PropertyData|Subvolume|Link}}: The volume to subtract. If specified it is used instead of the auto-generated subvolume. {{Version|1.0}}
* {{PropertyData|Thickness|FloatList}}: The list of thicknesses of the roof segments.


==Scripting==
==Scripting==

{{Emphasis|See also:}} [[Arch API|Arch API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].
{{Emphasis|See also:}} [[Arch API|Arch API]] and [[FreeCAD Scripting Basics|FreeCAD Scripting Basics]].


The Roof tool can be used in [[macros|macros]] and from the [[Python|Python]] console by using the following function:
The Roof tool can be used in [[Macros|macros]] and from the [[Python|Python]] console by using the following function:

{{Code|code=
{{Code|code=
Roof = makeRoof(baseobj=None, facenr=0, angles=[45.,], run=[], idrel=[0,], thickness=[50.,], overhang=[100.,], name="Roof")
Roof = makeRoof(baseobj=None, facenr=0, angles=[45.,], run=[], idrel=[0,], thickness=[50.,], overhang=[100.,], name="Roof")
Line 98: Line 137:


<div class="mw-translate-fuzzy">
<div class="mw-translate-fuzzy">
{{Docnav
[[Category:Arch/pt-br]]
|[[Arch_Grid/pt-br|Grade]]
|[[Arch_Space/pt-br|Espaço]]
|[[Arch_Workbench/pt-br|Arch]]
|IconL=Arch_Grid.svg
|IconR=Arch_Space.svg
|IconC=Workbench_Arch.svg
}}
</div>
</div>



Latest revision as of 09:47, 21 April 2024

Arch Roof

Menu location
Arch → Roof
Workbenches
Arch
Default shortcut
R F
Introduced in version
-
See also
Arch Structure, Arch Wall

Descrição

The Arch Roof tool allows for the creation of a sloped roof from a selected wire. The created roof object is parametric, keeping its relationship with the base object. The principle is that each edge is seen allotting a profile of roof (slope, width, overhang, thickness).

Note: This tool is still in development, and might fail with very complex shapes.

Utilização

  1. Create a closed wire with following the counter-clockwise direction and select it.
  2. Press the Arch Roof button, or press R then F keys
  3. The default roof object could have a strange shape, it's because the tool is missing some necessary information.
  4. After creating the default roof, double click on the object in the tree view to access and edit all the properties. Angle must be between 0 and 90.
  5. Each line corresponds to a roof pane. So you can set the properties you want for each roof pane.
  6. To help you, you can set Angle or Run to 0 and define a Relative Id, this makes an automatic calculation to find the data relative to the Relative Id.
  7. It works like this:
    1. If Angle = 0 and Run = 0 then profile is identical to the relative profile.
    2. If Angle = 0 then Angle is calculated so that the height is the same one as the relative profile.
    3. If Run = 0 then Run is calculated so that the height is the same one as the relative profile.
  8. Finally, set an Angle to 90° to make a gable.
  9. Note: for better comprehension, please see this youtube clip.

Usage (solid base)

If your roof has a complex shape (e.g. contains pitched windows or other non-standard features) you can create a custom solid object using various other FreeCAD workbenches (Part, Sketcher etc.). And then use this solid as the DadosBase object of your roof:

  1. Select the solid base object.
  2. Press the Arch Roof button, or press R then F keys.

Subtracting a roof

Roofs have an automatically generated subtraction volume (introduced in version 1.0 for roofs with a solid base). When a roof is removed from the walls of a building, both the roof itself as well as everything above it is subtracted from the walls.

introduced in version 1.0: It is possible to override the automatic subtraction volume by setting the DadosSubvolume property of the roof to a custom solid object.

Solid-based roof before (1st image) and after (2nd image) removing it from walls.
The 3rd image shows the generated subtraction volume.

Opções

Propriedades

Data

Roof

  • DadosAngles (FloatList): The list of angles of the roof segments.
  • DadosBorder Length (Length): The total length of the borders of the roof.
  • DadosFace (Integer): The face number of the base object used to build the roof (not used).
  • DadosFlip (Bool): Specifies if the direction of the roof should be flipped.
  • DadosHeights (FloatList): The list of calculated heights of the roof segments.
  • DadosId Rel (IntegerList): The list of IDs of the relative profiles of the roof segments.
  • DadosOverhang (FloatList): The list of overhangs of the roof segments.
  • DadosRidge Length (Length): The total length of the ridges and hips of the roof.
  • DadosRuns (FloatList): The list of horizontal length projections of the roof segments.
  • DadosSubvolume (Link): The volume to subtract. If specified it is used instead of the auto-generated subvolume. introduced in version 1.0
  • DadosThickness (FloatList): The list of thicknesses of the roof segments.

Scripting

See also: Arch API and FreeCAD Scripting Basics.

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

Roof = makeRoof(baseobj=None, facenr=0, angles=[45.,], run=[], idrel=[0,], thickness=[50.,], overhang=[100.,], name="Roof")
  • Creates a Roof object from the given baseobj, which can be a closed wire or a solid object.
    • If baseobj is a wire, you can provide lists for angles, run, idrel, thickness, and overhang, for each edge in the wire to define the shape of the roof.
    • The lists are automatically completed to match the number of edges in the wire.

Example:

import FreeCAD as App
import Arch, Draft

doc = App.newDocument()

rect = Draft.makeRectangle(3000, 4000)
doc.recompute()

roof = Arch.makeRoof(rect, angles=[30.,])

p1 = App.Vector(0, 0, 0)
p2 = App.Vector(1000, 1000, 0)
p3 = App.Vector(0, 2000, 0)

wire = Draft.make_wire([p1, p2, p3], closed=True)
doc.recompute()

roof1 = Arch.makeRoof(wire)

doc.recompute()