Interface: Difference between revisions

From FreeCAD Documentation
(Use the SVG version of the image, not the PNG version)
No edit summary
 
(5 intermediate revisions by 2 users not shown)
Line 15: Line 15:


<!--T:21-->
<!--T:21-->
The main window of the application can be roughly divided into 10 sections:
The main window of the application can be roughly divided into 11 sections:
# The [[main_view_area|main view area]], which can contain different tabbed windows
# [[3D view|3D view]]
# Upper part of the [[combo view|combo view]], which includes the [[Tree view|tree view]] and [[task panel|task panel]]
# The [[3D_view|3D view]], normally embedded in the [[main_view_area|main view area]]
# Lower part of the [[combo view|combo view]], which includes the [[property editor|property editor]]
# The upper part of the [[combo_view|combo view]], which includes the [[tree_view|tree view]] and [[task_panel|task panel]]
# The lower part of the [[combo_view|combo view]], which includes the [[property_editor|property editor]]
# [[Selection view|Selection view]]
# [[Report view|Report view]]
# The [[selection_view|selection view]]
# [[Python console|Python console]]
# The [[report_view|report view]]
# [[Status bar|Status bar]]
# The [[Python_console|Python console]]
# The [[status_bar|status bar]]
# Toolbar area, see the following information on the toolbars
# The toolbar area, see the following information on the toolbars
# [[Std_Workbench|Workbench selector]], which itself is a toolbar
# The [[Std_Workbench|Workbench selector]], which itself is a toolbar
# [[Standard Menu|Standard menu]]
# The [[Standard_Menu|standard menu]]


== Components of the interface == <!--T:5-->
== Components of the interface == <!--T:5-->
Line 62: Line 63:
* [[Report view|Report view]]: the text box that shows different messages from the application and its tools.
* [[Report view|Report view]]: the text box that shows different messages from the application and its tools.
* [[Python console|Python console]]: the editor that allows running [[Python|Python]] code interactively to see results in the [[3D view|3D view]].
* [[Python console|Python console]]: the editor that allows running [[Python|Python]] code interactively to see results in the [[3D view|3D view]].
* [[Status bar|Status bar]]: the bar that shows certain messages from the application, and that has the [[Mouse Model|mouse navigation]] selector.
* [[Status bar|Status bar]]: the bar that shows certain messages from the application, and that has the [[Mouse_navigation|mouse navigation]] selector.
* [[DAG view|DAG view]]: an alternative to the [[tree view|tree view]], which shows the relationships between different objects through a graph.
* [[DAG view|DAG view]]: an alternative to the [[tree view|tree view]], which shows the relationships between different objects through a graph.


Line 75: Line 76:
<!--T:20-->
<!--T:20-->
Other useful interfaces and windows include:
Other useful interfaces and windows include:
* [[Std_SceneInspector|Scene inspector]]: a panel that shows the Coin3D nodes that make up the [[scenegraph|scenegraph]]. For power users and developers, it may be useful to troubleshoot operations that manipulate the scene directly, and the objects created in the [[3D view|3D view]].
* [[Std_SceneInspector|Scene inspector]]: a panel that shows the Coin3D nodes that make up the [[Scenegraph|scenegraph]]. For power users and developers, it may be useful to troubleshoot operations that manipulate the scene directly, and the objects created in the [[3D_view|3D view]].
* [[Std_ExportGraphviz|Dependency graph]]: a window showing the dependency graph of all the objects in the document, created with the auxiliary program [[Graphviz|Graphviz]]. It is helpful to recognize problems in the creation of objects, such as circular dependencies, which may not be entirely evident from the [[tree view|tree view]] or the [[DAG view|DAG view]].
* [[Std_DependencyGraph|Dependency graph]]: a window showing the dependency graph of all the objects in the document, created with the auxiliary program [https://graphviz.org/ Graphviz]. It is helpful to recognize problems in the creation of objects, such as circular dependencies, which may not be entirely evident from the [[Tree_view|tree view]] or the [[DAG_view|DAG view]].


=== Customization === <!--T:17-->
=== Customization === <!--T:17-->
Line 86: Line 87:
These options are in the menu, {{MenuCommand|Tools → Customize}}. See [[Interface Customization|interface customization]].
These options are in the menu, {{MenuCommand|Tools → Customize}}. See [[Interface Customization|interface customization]].


<!--T:11-->
{{Interface{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
</translate>
</translate>
{{Interface navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}

Latest revision as of 10:10, 14 November 2021

Introduction

The FreeCAD interface is based on Qt, a well known graphical user interface (GUI) toolkit, particularly used in Linux, but also available in Windows and MacOS.

Standard interface in v0.19.

The main window of the application can be roughly divided into 11 sections:

  1. The main view area, which can contain different tabbed windows
  2. The 3D view, normally embedded in the main view area
  3. The upper part of the combo view, which includes the tree view and task panel
  4. The lower part of the combo view, which includes the property editor
  5. The selection view
  6. The report view
  7. The Python console
  8. The status bar
  9. The toolbar area, see the following information on the toolbars
  10. The Workbench selector, which itself is a toolbar
  11. The standard menu

Components of the interface

Like many pieces of software, FreeCAD includes a standard menu bar, and then a series of toolbars and panels where the user tools are found.

Menus

The standard menus are: File, Edit, View, Tools, Macro, Windows, Help.

Toolbars

The standard toolbars that appear in the interface are:

  • File toolbar: tools to work with files, open documents, copy, paste, undo and redo actions.
  • Workbench toolbar: it contains a single widget to select the active workbench.
  • Macro toolbar: tools to record, edit, and execute macros.
  • View toolbar: tools to control how objects appear in the 3D view.
  • Structure toolbar: tools to organize objects in the document, and create links to additional documents.

These can be turned on and off by right clicking on an empty space on one of the toolbars and choosing the desired element, or from the menu, View → Toolbars.

Panels

The main panels that allow working with objects are:

  • 3D view: the area where 2D and 3D geometry is drawn.
  • Combo view: the panel that contains the tree view, the task panel, and the property editor.
  • Tree view: the element that shows all objects in the document and their parametric history.
  • Task panel: the panel that shows different actions and options depending on the drawing tool selected.
  • Property editor: the place where object properties are modified.
  • Selection view: the panel that shows elements that are currently selected.
  • Report view: the text box that shows different messages from the application and its tools.
  • Python console: the editor that allows running Python code interactively to see results in the 3D view.
  • Status bar: the bar that shows certain messages from the application, and that has the mouse navigation selector.
  • DAG view: an alternative to the tree view, which shows the relationships between different objects through a graph.

With the exception of the 3D view, all can be turned on and off by right clicking on an empty space on one of the top toolbars and choosing the desired element, or from the menu, View → Panels.

To activate and deactivate the status bar use the menu, View → Status bar.

Other

Other useful interfaces and windows include:

  • Scene inspector: a panel that shows the Coin3D nodes that make up the scenegraph. For power users and developers, it may be useful to troubleshoot operations that manipulate the scene directly, and the objects created in the 3D view.
  • Dependency graph: a window showing the dependency graph of all the objects in the document, created with the auxiliary program Graphviz. It is helpful to recognize problems in the creation of objects, such as circular dependencies, which may not be entirely evident from the tree view or the DAG view.

Customization

Toolbars can have more or fewer buttons, and custom toolbars can be created with a mix of different tools, and to store developed macros.

These options are in the menu, Tools → Customize. See interface customization.