Draft Layer

Description
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

 * 1) There are several ways to invoke the command:
 * 2) * Press the button.
 * 3) * Select the option from the menu.
 * 4) * If the layer container already exists: right-click it in the Tree view and select the option from context menu.
 * 5) If it does not exist the layer container is created first.
 * 6) A layer is created and put in the layer container.
 * 7) Optionally change the properties of the layer.
 * 8) 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  property of the layer.
 * 9) Optionally activate the layer.

Layer container options
For a Draft LayerContainer these additional options are available in the Tree view context menu:


 * : merges all layers with the same base label.
 * The base label of a layer is its stripped of trailing digits and spaces. All layers with the same base label are merged into a single layer with the  set to that base label.


 * : adds a new layer to the current document.

Layer options
For a Draft Layer these additional options are available in the Tree view context menu:


 * : activates the selected layer.
 * : selects the objects inside the selected layer.

Drag and drop behavior
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 key when dragging from or dropping on a 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 a TechDraw DraftView is created from the objects inside the layer.

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

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