Draft Layer
|
|
| Menu location |
|---|
| Utilities → New Layer |
| Workbenches |
| Draft |
| Default shortcut |
| None |
| Introduced in version |
| 0.19 |
| See also |
| Draft AutoGroup, Draft LayerManager |
Description[edit | edit source]
The Draft Layer command creates a Draft Layer. A layer is a special kind of group with a number of visual properties. These properties, and any changes to them, are propagated to the objects placed inside the layer. The layers themselves are put in another special group: the Draft LayerContainer.
Usage[edit | edit source]
- Select the Utilities →
New Layer option from the menu, or from the Tree View or 3D View context menu.
- If it does not exist the layer container is created first.
- A layer is created and put in the layer container.
- Optionally change the properties of the layer.
- Optionally put objects in the layer by drag and dropping them on the layer in the Tree View. Objects can also be put in a layer by editing the DataGroup property of the layer.
- Optionally activate the layer.
[edit | edit source]
Layer container options[edit | edit source]
For a Draft LayerContainer these additional options are available in the Tree View context menu:
Add New Layer: adds a new layer to the current document.
Reassign Properties of All Layers: removes overrides from objects in all layers by reassigning the properties of the layer they are in. introduced in 1.1
Merge Layer Duplicates: merges all layers with the same base label.
- The base label of a layer is its DataLabel stripped of trailing digits and spaces. All layers with the same base label are merged into a single layer with the DataLabel set to that base label.
Layer options[edit | edit source]
For a Draft Layer these additional options are available in the Tree View context menu:
Activate Layer: activates the selected layer.
Reassign Properties of Layer: removes overrides from objects in the layer by reassigning the properties of the layer. introduced in 1.1
Select Layer Contents: selects the objects inside the selected layer.
Drag and drop behavior[edit | edit source]
If you drop an object from a Std Group, or a group-like object such as an Arch BuildingPart, on a layer in the Tree View, it is not removed from the group, and vice versa. To remove an object from a layer it must be dropped on another layer or on the document node. There is no need to hold down the Ctrl key when dragging from or dropping on a layer.
Overrides[edit | edit source]
Objects inside a layer can have overrides. The following logic applies:
- When an object is put in a layer it always adopts the properties of that layer.
- A property of the object that is subsequently changed is considered an override.
- When a property of the layer, or the object in the layer, is then changed so that they match again, there is no longer an override, and the property is synced again.
The layer container and all layers have a context menu option to reassign properties and thereby remove overrides.
Notes[edit | edit source]
- A new layer can also be created with the Draft AutoGroup command or with the Draft LayerManager.
Properties[edit | edit source]
See also: Property View.
A Draft Layer object is derived from an App FeaturePython object and inherits all its properties. It also has the following additional properties:
Data[edit | edit source]
Layer
- DataGroup (
LinkList): specifies the objects that are inside the layer.
View[edit | edit source]
Layer
The properties in this section are applied to objects that are put inside the layer. And any changes to these properties are propagated to them. For two properties, ViewLine Color and ViewShape Color, this behavior is optional.
- ViewDraw Style (
Enumeration): specifies the draw style of the layer:Solid,Dashed,DottedorDashdot - ViewLine Color (
Color): specifies the line color of the layer. - ViewLine Width (
Float): specifies the line width of the layer. - ViewOverride Line Color Children (
Bool): specifies if changes to the ViewLine Color of the layer are propagated to the objects inside the layer. - ViewOverride Shape Appearance Children (
Bool): specifies if changes to the ViewShape Appearance of the layer are propagated to the objects inside the layer. introduced in 1.0 - ViewShape Appearance (
MaterialList): specifies the shape appearance of the layer. introduced in 1.0 - View (hidden)Shape Color (
Color): specifies the shape color of the layer. It is kept synchronized with the Diffuse Color of the ViewShape Appearance. - ViewTransparency (
Percent): specifies the transparency of the layer. It is kept synchronized with the Transparency of the ViewShape Appearance.
- ViewLine Print Color (
Color): specifies the line print color of the layer. - ViewUse Print Color (
Bool): specifies if the ViewLine Print Color of the layer is used when a TechDraw DraftView is created from the objects inside the layer.
Scripting[edit | edit source]
See also: Autogenerated API documentation and FreeCAD Scripting Basics.
To create a Draft Layer use the make_layer method of the Draft module. To add objects to, or remove objects from, a layer change its Group property.
import FreeCAD as App
import Draft
doc = App.newDocument()
layer = Draft.make_layer(line_color=(1.0, 0.0, 0.0, 0.0),
shape_color=(1.0, 1.0, 0.0, 0.0))
polygon1 = Draft.make_polygon(5, radius=1000)
polygon2 = Draft.make_polygon(3, radius=500)
polygon3 = Draft.make_polygon(6, radius=220)
layer.Group = [polygon1, polygon2, polygon3]
doc.recompute()
- Drafting: Line, Polyline, Fillet, Arc, Arc From 3 Points, Circle, Ellipse, Rectangle, Polygon, B-Spline, Cubic Bézier Curve, Bézier Curve, Point, Facebinder, ShapeString, Hatch
- Annotation: Text, Dimension, Label, Annotation Styles, Annotation Scale
- Modification: Move, Rotate, Scale, Mirror, Offset, Trimex, Stretch, Clone, Array, Polar Array, Circular Array, Path Array, Path Link Array, Point Array, Point Link Array, Edit, Highlight Subelements, Join, Split, Upgrade, Downgrade, Convert Wire/B-Spline, Draft to Sketch, Set Slope, Flip Dimension, Shape 2D View
- Draft Tray: Working Plane, Set Style, Toggle Construction Mode, AutoGroup
- Snapping: Snap Lock, Snap Endpoint, Snap Midpoint, Snap Center, Snap Angle, Snap Intersection, Snap Perpendicular, Snap Extension, Snap Parallel, Snap Special, Snap Near, Snap Ortho, Snap Grid, Snap Working Plane, Snap Dimensions, Toggle Grid
- Miscellaneous: Apply Current Style, New Layer, Manage Layers, New Named Group, SelectGroup, Add to Layer, Add to Group, Add to Construction Group, Toggle Wireframe, Working Plane Proxy, Heal, Show Snap Toolbar
- Additional: Constraining, Pattern, Preferences, Import Export Preferences, DXF/DWG, SVG, OCA, DAT
- Context menu:
- Most objects: Edit
- Layer container: Add New Layer, Reassign Properties of All Layers, Merge Layer Duplicates
- Layer: Activate Layer, Reassign Properties of Layer, Select Layer Contents
- Text and label: Open Links
- Wire: Flatten
- Working plane proxy: Save Camera Position, Save Visibility of Objects
- Getting started
- Installation: Download, Windows, Linux, Mac, Additional components, Docker, AppImage, Ubuntu Snap
- Basics: About FreeCAD, Interface, Mouse navigation, Selection methods, Object name, Preferences, Workbenches, Document structure, Properties, Help FreeCAD, Donate
- Help: Tutorials, Video tutorials
- Workbenches: Std Base, Assembly, BIM, CAM, Draft, FEM, Inspection, Material, Mesh, OpenSCAD, Part, PartDesign, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Surface, TechDraw, Test Framework
- Hubs: User hub, Power users hub, Developer hub