Draft Layer

Description
The Draft Layer creates a special kind of group that controls the visual properties of objects placed inside of it. By changing the properties of the Layer, such as line width, line color, shape color and transparency, the changes are propagated to the objects that make use of the Layer property.

This tool replaces Draft VisGroup starting from FreeCAD 0.19.

Usage

 * 1) Go to the menu . This adds a new layer. If it is a the first layer, a Layers object will be created too, which contains all the layers.
 * 2) To add objects you can drag them into the layer. This will remove the objects from there original layer. If you want to have an object in several layers, e.g. to control the visibility of different sets of objects, you have to edit the Group property of the layer. Click the button occurring to the right and select/deselect the objects you want to have in or out of the layer.
 * 3) Change the desired view properties of the Layer.

Tree view context menu
The following options are available in the Tree view context menu:

For layer containers

 * [[Image:Draft_Layer.svg|16px]] Merge layer duplicates: this option currently does not work.
 * [[Image:Draft_NewLayer.svg|16px]] Add new layer: adds a new layer to the current document. This option is an alternative for this command.

For layers

 * [[Image:button_right.svg|16px]] Activate this layer: makes the selected layer the active layer.
 * [[Image:Draft_SelectGroup.svg|16px]] Select layer contents: selects the objects inside the selected layer.

Properties
See also: Property editor.

A Draft Layer object is derived from an App FeaturePython object and inherits all its properties. It also has the following additional properties:

Data

 * : specifies the objects that are inside the layer.

View
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, and, this behavior is optional.


 * : specifies the draw style of the layer:, , or
 * : specifies the line color of the layer.
 * : specifies the line width of the layer.
 * : specifies if changes to the of the layer are propagated to the objects inside the layer.
 * : specifies if changes to the of the layer are propagated to the objects inside the layer.
 * : specifies the shape color of the layer.
 * : specifies the transparency of the layer.


 * : specifies the line print color of the layer.
 * : specifies if the of the layer is used when the objects inside the layer are placed on a TechDraw page.

Scripting
See also: Autogenerated API documentation and FreeCAD Scripting Basics.

To create a layer use the method of the Draft module. To add objects to, or remove objects from, a layer change its property.