The property editor appears when the Model tab of the combo view is active in the interface; it allows managing the publicly exposed properties of the objects in the document.
Generally, the property editor is intended to deal with just one object at one time. The values shown in the property editor belong to the selected object of the active document. Despite this, some properties like colors, can be set for multiple selected objects. If there are no elements selected, the property editor will be empty.
Not all properties can be modified always; depending on the specific status of the property, some of them will be invisible (not listed), or be read-only (not editable).
Empty property editor, when no object is selected.
A property is a piece of information like a number or a text string that is attached to a FreeCAD document or an object in a document. Properties can be viewed and modified with the Property editor.
Properties play a very important part in FreeCAD, since it has been designed to work with parametric objects, which are objects defined only by their properties.
Custom scripted objects in FreeCAD can have properties of the following types:
Boolean Float FloatList FloatConstraint Angle Distance Integer IntegerConstraint Percent Enumeration IntegerList String StringList Link LinkList Matrix Vector VectorList Placement PlacementLink Color ColorList Material Path File FileIncluded PartShape FilletContour Circle
Example of Part object properties
There are two types of feature properties accessible through tabs at the bottom of the property editor:
- VyView : properties related to the "visual" display of an object.
- DataData : properties related to the "physical" parameters of an object.
- VyBounding Box : Indicates if a box showing the overall extent of the object is to be displayed. Value False, or True (Default, False).
- VyControl Point : Indicates if the feature control points are to be displayed. Value False, or True (Default, False).
- VyDeviation : Sets the accuracy of the polygonal representation of the model in the 3d view (tessellation). Lower values = better quality. The value is in percent of object's size (deviation in mm = (w+h+d)/3*valueInPercent/100, where w,h,d are the bounding box dimensions).
- VyDisplay Mode :Display mode of the feature, Flat lines, Shaded, Wireframe, Points . (Default, Flat lines).
- VyLighting : Lighting One side, Two side . (Default, Two side).
- VyLine Color : Gives the color of the line (edges) (Default, 25, 25, 25).
- VyLine Width : Gives the thickness of the line (edges) (Default, 2).
- VyPoint Color : Gives the color of the points (ends of the feature) (Default, 25, 25, 25).
- VyPoint Size : Gives the size of the points (Default, 2).
- VySelectable : Allows selection of the feature. Value False, ou True (Default, True).
- VyShape Color : Give the color shape (default, 204, 204, 204).
- VyTransparency : Sets the degree of transparency in the feature of 0 to 100 (Default, 0).
- VyVisibility : Determines the visibility of the feature (like the bar SPACE). Value False, or True (Default, True).
DataPlacement : Summary of the data below. Every feature has a placement that can be controlled through the Data Properties table. It controls the placement of the part with respect to the coordinate system. NOTE: The placement properties do not affect the physical dimensions of the feature, but merely its position in space!
If you select the title Placement , a button with three small points appears to the right. Clicking this button ..., opens the Tasks_Placement options window.
DataAngle : Specifies the angle to be used with the axis property (below). An angle is set here, and the axis that the angle acts upon is set with the axis property. The feature is rotated by the specified angle, about the specified axis. A usage example might be if you created a revolution feature as required, but then needed to rotate the whole feature by some amount, in order to allow it to line-up with another pre-existing feature.
DataAxis : This property specifies the axis/axes about which the feature is to be rotated. The exact value of rotation comes from the angle property (above). This property takes three arguments, which are passed as numbers in the x, y, and z boxes in the tool. Setting a value for more than one of the axes will cause the part to be rotated in each axis, by the angle value multiplied by the value for the axis. For example, with an angle of 15° set, specifying a value of 1.0 for x, and 2.0 for y will cause the finished part to be rotated 15° in the x-axis AND 30° in the y-axis.
DataPosition : This property specifies the base point to which all dimensions refer. This takes three arguments, which are passed as numbers to the x, y, and z boxes in the tool. Setting a value for more than one of the boxes will cause the part to be translated by the number of units along the corresponding axis.
DataLabel : The Label is the name given to the object (feature), this name can be changed as desired.
PS: The displayed properties can vary, depending on the tool used.
A property is a piece of information like a number or a text string that is attached to a FreeCAD document or an object in the document.
Custom scripted objects can use any of the property types defined in the base system. See the full list in Property.
Some of the most commonly used property types are:
App::PropertyBool App::PropertyFloat App::PropertyAngle App::PropertyDistance App::PropertyInteger App::PropertyString App::PropertyMatrix App::PropertyVector App::PropertyPlacement
Different objects may have different types of properties. However, many objects have the same types because they are derived from the same internal class. For example, most objects that describe geometrical shapes (lines, circles, rectangles, solid bodies, imported parts, etc.), have the "Placement" property that defines their position in the 3D view.
View and Data properties
There are two classes of feature properties accessible through tabs in the property editor:
- View properties, related to the "visual" appearance of the object. The View properties are tied to the ViewProvider (
ViewObjectattribute) of the object, and are only accessible when the graphical user interface (GUI) is loaded. They are not accessible when using FreeCAD in console mode, or as a headless library.
- Data properties, related to the "physical" parameters of the object. The Data properties define the essential characteristics of the object; they exist at all times, even when FreeCAD is used in console mode, or as a library. This means that if you load a document in console mode, you can edit the radius of a circle or the length of a line, even if you cannot see the result on the screen.
For this reason, Data properties are considered to be more "real", as they truly define the geometry of a shape. On the other hand, View properties are less important because they only affect the superficial appearance of the geometry. For example, a circle of 10 mm radius is different from a circle of 5 mm radius; the color of the circle (view property) doesn't affect its shape, but the radius does (data property). In many instances in this documentation, the word "property" is understood to refer to a "Data property" and not to a "View property".
See also: Object name
The most basic scripted object won't show any Data property in the property editor, except for its
Label attribute. The
Label is a user editable string that identifies the object in the tree view. On the other hand, the
Name attribute of an object is assigned at the moment of its creation and cannot be changed; this attribute is read-only, and is not displayed in the property editor either.
A basic parametric object is created as follow
obj = App.ActiveDocument.addObject("App::FeaturePython", "App__FeaturePython") obj.Label = "Plain_object" print(obj.Name) print(obj.Label)
View and Data tabs of the property editor, for a basic "App::FeaturePython" scripted object.
Most geometrical objects that can be created and displayed in the 3D view are derived from a
Part::Feature. See Part Feature for the most basic properties that these objects have.
For 2D geometry, most objects are derived from
Part::Part2DObject (itself derived from
Part::Feature) which is the base of Sketches, and most Draft elements. See Part Part2DObject for the most basic properties that these objects have.
Right clicking in an empty space of the view, or with a property selected, shows only one command:
- Show all: if active, in addition to the standard properties that appear already, it shows all the hidden Data and View properties in their respective tabs.
- Data: "Proxy", "Label2", "Expression Engine", and "Visibility".
- View: "Proxy".
When the Show all option is active, and one property is selected, more actions are available with a second right click:
- Show all: deactivates the Show all command, hiding the additional Data and View properties.
- Add Property: adds a dynamic property to the object; this works with both C++ defined objects, and Python scripted objects.
- Expression...: brings up the formula editor, which allows using expressions in the property value.
- Hidden: if active, sets the property as hidden, meaning that it will only be displayed in the property editor if Show all is active.
- Output: if active, sets the property as output.
- NoRecompute: if active, sets the property as not recomputed when the document is recomputed; this is useful when a property should be kept unaffected by other updates.
- ReadOnly: if active, sets the property to be read-only; it won't be editable in the property editor any more until this switch is turned off. The Expression... menu entry is no longer available. Note: It may be still possible to change the property via a dialog that updates the property.
- Transient: if active, sets the property as transient. The value of a transient property is not saved to file. When opening a file, it is instantiated with its default value.
- Touched: if active, it becomes touched, and ready for recompute.
- EvalOnRestore: if active, it is evaluated when the document is restored.
Example of the properties of a PartDesign object
In this section we show some common properties that are visible for a PartDesign Body, and one PartDesign Feature. The specific properties of an object can found in the specific documentation page of that object.
Most of these properties are inherited from the Part Feature basic object.
- VyAngular Deflection: it is another way to specify how finely to generate the mesh for rendering on screen or when exporting. The default value is 28.5 degrees, or 0.5 radians. The smaller the value the smoother the appearance will be in the 3D view, and the finer the mesh that will be exported.
- VyBounding Box: indicates if a box showing the overall extent of the object is displayed.
- VyDeviation: sets the accuracy of the polygonal representation of the model in the 3D view (tessellation). Lower values indicate better quality. The value is in percent of object's size.
- VyDisplay Mode: display mode of the entire Body,
- VyDisplay Mode Body: display mode of the Tip of the Body,
- VyDraw Style:
Dashdot; defines the style of the edges in the 3D view.
- VyLine Color: the RGB color of the edges, it defaults to
(25, 25, 25).
- VyLine Width: the thickness of the edges, it defaults to
- VyOn Top When Selected:
- VyPoint Color: the RGB color of the vertices, it defaults to
(25, 25, 25).
- VyPoint Size: the size of the vertices, it defaults to
- VySelectable: whether the object is selectable or not.
- VySelection Style:
- VyShape Color: the RGB color of the shape, it defaults to
(204, 204, 204).
- VyShow In Tree: if it is
true, the object appears in the tree view. Otherwise, it is set as invisible.
- VyTransparency: the degree of transparency from
- VyVisibility: whether the object is visible in the 3D view or not. Toggle with the Space bar in the keyboard.
In this case we observe the properties of the PartDesign Revolution feature.
- DataLabel: the user defined name given to the object, this can be changed as desired.
- DataRefine: whether to refine the fusion done with other objects.
- DataBase: the point in space that specifies where the revolution takes place. It cannot be modified directly, only when editing the feature.
- DataAxis: the axis around which the revolution will be performed. It cannot be modified directly, only when editing the feature.
- DataAngle: the angle that specifies how much of the base element is rotated. By default it is
360 deg, but it can be any fraction of that.
- DataMidplane: if the base object is a Sketch, when this property is
true, it will perform the revolution with the sketch serving as a plane of symmetry. This is noticeable if the DataAngle is different from
- DataReversed: by default it is
true. Whether to perform the revolution in one direction or the other.
See also: FreeCAD Scripting Basics.
See scripted objects for the full information on adding properties to objects defined through Python.
Most properties that are visible in the property editor can be accessed from the Python console. These properties are just attributes of the class that defines the selected object. For example, if the property editor shows the DataGroup property, this means that the object has the
These attributes (properties) are added with the
addProperty method of the base object. At least it is necessary to specify the type of property, and its name.
obj.addProperty("App::PropertyFloat", "Custom") print(obj.Custom)
Properties follow the
PascalCase convention, meaning that each word starts with a capital letter, and there are no underscores. When the property editor displays such names, it leaves a space between each capital letter, making it easier to read.
obj.addProperty("App::PropertyDistance", "CustomCamelProperty") obj.CustomCamelProperty = 1000 print(obj.CustomCamelProperty)
Property editor showing the Data properties of a PartDesign Body, with two additional properties, "Custom" and "Custom Camel Property".
In similar way the View properties are added, not to the base object, but to its
ViewObject. Then, it follows that properties like VyAngular Deflection, VyBounding Box, VyDisplay Mode, VyDisplay Mode Body, VyLine Color, and others, can be examined and changed from the Python console.
print(obj.ViewObject.AngularDeflection) print(obj.ViewObject.BoundingBox) print(obj.ViewObject.DisplayMode) print(obj.ViewObject.DisplayModeBody) print(obj.ViewObject.LineColor)
All public properties of the object, and of its view provider, are contained in the corresponding
- Preferences Editor, Interface Customization
- Main window: Standard menu, Main view area, 3D view, Combo view (Tree view, Task panel, Property editor), Selection view, Report view, Python console, Status bar, DAG view, Workbench Selector
- Auxiliary windows: Scene inspector, Dependency graph
- File: New, Open, Close, Close All, Save, Save As, Save a Copy, Save All, Revert, Import, Export,Merge project, Project information, Print, Print preview, Export PDF, Recent files, Exit
- Edit: Undo, Redo, Cut, Copy, Paste, Duplicate selection, Refresh, Box selection, Box element selection, Select All, Delete, Send to Python Console, Placement, Transform, Alignment, Toggle Edit mode, Edit mode, Preferences
- Miscellaneous: Create new view, Orthographic view, Perspective view, Fullscreen, Bounding box, Toggle axis cross, Clipping plane, Texture mapping, Toggle navigation/Edit mode, Appearance, Random color, Workbench, Status bar
- Standard views: Fit all, Fit selection, Isometric, Dimetric, Trimetric, Home, Front, Top, Right, Rear, Bottom, Left, Rotate Left, Rotate Right
- Freeze display: Save views, Load views, Freeze view, Clear views
- Draw style: As is, Points, Wireframe, Hidden line, No shading, Shaded, Flat lines
- Stereo: Stereo red/cyan, Stereo quad buffer, Stereo Interleaved Rows, Stereo Interleaved Columns, Stereo Off, Issue camera position
- Zoom: Zoom In, Zoom Out, Box zoom
- Document window: Docked, Undocked, Fullscreen
- Visibility: Toggle visibility, Show selection, Hide selection, Select visible objects, Toggle all objects, Show all objects, Hide all objects, Toggle selectability, Toggle measurement, Clear measurement
- Toolbars: File, Workbench, Macro, View, Structure
- Panels: Report view, Tree view, Property view, Selection view, Combo view, Python console, DAG view
- Tree view actions: Sync view, Sync selection, Sync placement, Pre-selection, Record selection, Single document, Multi document, Collapse/Expand, Initiate dragging, Go to selection
- Tools: Edit parameters, Save image, Load image, Scene inspector, Dependency graph, Project utility, Measure distance, Add text document, View turntable, Units calculator, Customize, Addon manager
- Macro: Macro recording, Stop macro recording, Macros, Recent macros, Execute macro, Attach to remote debugger, Debug macro, Stop debugging, Step over, Step into, Toggle breakpoint
- Help: Help, FreeCAD Website, Donate, Users documentation, Python scripting documentation, Automatic Python modules documentation, FreeCAD Forum, FreeCAD FAQ, Report a bug, About FreeCAD, What's This
- Structure and Link: Std Part, Std Group, Make link, Make sub-link, Replace with link, Unlink, Import links, Import all links, Go to linked object, Go to deepest linked object, Select all links
- 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, Arch, Draft, FEM, Inspection, Mesh, OpenSCAD, Part, PartDesign, Path, Points, Reverse Engineering, Robot, Sketcher, Spreadsheet, Start, Surface, TechDraw, Test Framework, Web
- Hubs: User hub, Power users hub, Developer hub