Arch Roof/de: Difference between revisions

From FreeCAD Documentation
m (FuzzyBot moved page Arch Roof Legacy/de to Arch Roof/de without leaving a redirect: Part of translatable page "Arch Roof Legacy".)
(Updating to match new version of source page)
Line 1: Line 1:
{{GuiCommand/de|Name=Arch Roof|Name/de=Arch Roof|Workbenches=[[Arch Module/de|Arch]]|MenuLocation=Arch Roof|Shortcut=R F|SeeAlso=[[Arch Roof2/de|Arch Roof2]]}}
{{GuiCommand|Name=Arch Roof|Workbenches=[[Arch Module|Arch]]|MenuLocation=Arch -> Roof|Shortcut=R F}}


==Beschreibung==
==Description==


The Roof tool allows you to create a sloped roof from a selected face. Any face of any shape-based object can be used, and the created roof object is parametric, keeping its relationship with the base object. Please note that this tool is still in development, and might fail with very complex shapes.
The Roof tool allows you to create a sloped roof from a selected wire. The created roof object is parametric, keeping its relationship with the base object. Please note that this tool is still in development, and might fail with very complex shapes. The principle is that each edge is seen allotting a profile of roof (slope, width, overhang, thickness…).


[[Image:Arch Roof example.jpg|600px]]
[[Image:RoofExample.png|600px]]


==How to use==
==How to use==


# Create a wire with following the conterclockwise direction and select it.
# Select an existing face
[[Image:CounterclockwiseWire.png|600px]]
# Press the {{KEY|[[Image:Arch Roof.png|16px]] [[Arch Roof]]}} button, or press {{KEY|R}} then {{KEY|F}} keys
# Press the {{KEY|[[Image:Arch Roof.png|16px]] [[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 have not all the needed informations.
# 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.
#[[Image:RoofTable.png]]
# Each line correspond to a roof pane. So you can set properties you want for each roof pane.
# To help you, you can set Angle or Run to 0 and defined a Relative Id, this make automatic calculs to find the data relative to the relative Id.
# It work like this :
## If Angle = 0 and Run = 0 then profile is identical to the relative profile.
## If Angle = 0 then angle is calculated so that the height is the same one as the relative profile.
## If Run = 0 then Run is calculated so that the height is the same one as the relative profile.
# At the end, set an angle to 90° to make a gable.

[[Image:RoofProfil.png|600px]]


==Properties==
==Properties==


* {{PropertyData|Angle}}: The slope angle of the roof
* {{PropertyData|Angles}}: List of the slope angle of the roof pane (an angle for each edge in the wire).
* {{PropertyData|Face}}: The face index of the base object to be used
* {{PropertyData|Runs}}: List of the width of the roof pane (a run for each edge in the wire).
* {{PropertyData|IdRel}}: List of relation Id The slope angle of the roof
* {{PropertyData|Thickness}}: List of thickness of the roof pane. (a thickness for each edge in the wire).
* {{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


==Scripting==
==Scripting==


The Roof tool can by used in [[macros]] and from the python console by using the following function:
The Roof tool can by used in [[macros]] and from the python console by using the following function:
<syntaxhighlight>
{{Code|code=
makeRoof (baseobj,[facenr],[angle],[name])
makeRoof (baseobj,[facenr],[angles],[runs],[idrel],[thickness],[overhang],[name])
</syntaxhighlight>
}}
:Makes a roof based on a face from an existing object. You can provide the number of the face to build the roof on (default = 1), the angle in degrees (default=45) and a name (default = roof).
:Makes a roof based on a closed wire. You can provide a list of angles, run, idrel, thickness, overhang for each edges in the wire to define the roof shape. The default for angle is 45 and the list is automatically complete to match with number of edges in the wire.


Example:
Example:
<syntaxhighlight>
{{Code|code=
import Arch, Draft
import Arch, Draft
rect = Draft.makeRectangle(2,4)
rect = Draft.makeRectangle(30,40)
Arch.makeRoof(rect,angle=30)
Arch.makeRoof(rect,angles=[30.,])
</syntaxhighlight>
}}
<languages/>
<languages/>

Revision as of 13:44, 13 March 2015

Arch Roof

Menu location
Arch -> Roof
Workbenches
Arch
Default shortcut
R F
Introduced in version
-
See also
None

Description

The Roof tool allows you to create a sloped roof from a selected wire. The created roof object is parametric, keeping its relationship with the base object. Please note that this tool is still in development, and might fail with very complex shapes. The principle is that each edge is seen allotting a profile of roof (slope, width, overhang, thickness…).

How to use

  1. Create a wire with following the conterclockwise direction and select it.

  1. Press the Arch Roof button, or press R then F keys
  2. The default roof object could have a strange shape, it's because the tool have not all the needed informations.
  3. 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.
  4. Each line correspond to a roof pane. So you can set properties you want for each roof pane.
  5. To help you, you can set Angle or Run to 0 and defined a Relative Id, this make automatic calculs to find the data relative to the relative Id.
  6. It work 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.
  7. At the end, set an angle to 90° to make a gable.

Properties

  • DatenAngles: List of the slope angle of the roof pane (an angle for each edge in the wire).
  • DatenRuns: List of the width of the roof pane (a run for each edge in the wire).
  • DatenIdRel: List of relation Id The slope angle of the roof
  • DatenThickness: List of thickness of the roof pane. (a thickness for each edge in the wire).
  • DatenOverhang: List of the overhang of the roof pane (an overhang for each edge in the wire).
  • DatenFace: The face index of the base object to be used #Not really used

Scripting

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

makeRoof (baseobj,[facenr],[angles],[runs],[idrel],[thickness],[overhang],[name])
Makes a roof based on a closed wire. You can provide a list of angles, run, idrel, thickness, overhang for each edges in the wire to define the roof shape. The default for angle is 45 and the list is automatically complete to match with number of edges in the wire.

Example:

import Arch, Draft
rect = Draft.makeRectangle(30,40)
Arch.makeRoof(rect,angles=[30.,])