App Part

Introduction


An App Part object, or formally an, is an element that allows grouping objects in 3D space.

It was developed to be used in assemblies, as one of its principal characteristic is that it has an Origin which can serve as reference for included objects.



How to use

 * Press the button in the structure toolbar.

It can also be created from the Python console as described in the Scripting section.

Properties
An App Part ( class) is derived from the basic App GeoFeature ( class), therefore it shares all the latter's properties.

In addition to the properties described in App GeoFeature, the App Part has some properties that help it manage information, like, , , , , and.

See Property for all property types that scripted objects can have.

These are the properties available in the property editor. Hidden properties can be shown by using the command in the context menu of the property editor.

Data

 * : the position of the object in the 3D view. The placement is defined by a point (vector), and a  (axis and angle). See Placement.
 * : the angle of rotation around the . By default, it is (zero degrees).
 * : the unit vector that defines the axis of rotation for the placement. Each component is a floating point value between and . If any value is above, the vector is normalized so that the magnitude of the vector is . By default, it is the positive Z axis,.
 * : a vector with the 3D coordinates of the base point. By default, it is the origin.
 * : the user editable name of this object, it is an arbitrary UTF8 string.
 * : a description for this object. By default, it is an empty string.
 * : and ID or part number of this object. By default, it is an empty string.
 * : a field to specify the license for this object. By default, it is an empty string.
 * : a field to specify the web address to the license or contract for this object. By default, it is an empty string.
 * : a tuple of three floating point RGBA values to define the color of the object; by default it is, which is displayed as  on base 255, white.
 * : a list of referenced objects. By default, it is empty.

Hidden properties Data

 * : a list of expressions. By default, it is empty.
 * : a longer, user editable description of this object, it is an arbitrary UTF8 string that may include newlines. By default, it is an empty string.
 * : map with material properties. By default, it is empty.
 * : map with additional meta information. By default, it is empty.
 * : Origin object linked to the group.
 * : UUID of the object.
 * : whether to display the object or not.
 * : whether the group is touched or not.

View
The App Part only has five of the properties of the basic App GeoFeature, and it does not have hidden properties.


 * : (default),, ,.
 * : (default), . If the option is, the entire shape (vertices, edges, and faces) will be highlighted in the 3D view; if it is  only the bounding box will be highlighted.
 * : if it is, the object appears in the tree view. Otherwise, it is set as invisible.
 * : if it is, the object appears in the 3D view; otherwise it is invisible. By default this property can be toggled on and off by pressing the bar in the keyboard.
 * : if it is, the object appears in the 3D view; otherwise it is invisible. By default this property can be toggled on and off by pressing the bar in the keyboard.

Scripting
FreeCAD Scripting Basics, and scripted objects.

An App Part is created with the method of the document. Once a Part exists, other objects can be added to it with the or  methods of this Part.