Std Workbench: Difference between revisions

From FreeCAD Documentation
m (emphasis)
mNo edit summary
(17 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{UnfinishedDocu}}
<translate>
<translate>

<!--T:31-->
{{Docnav
|[[Std_RandomColor|RandomColor]]
|[[Std_TreeSyncView|TreeSyncView]]
|[[Std_View_Menu|Std View Menu]]
|IconL=Std_RandomColor.svg
|IconR=Std_TreeSyncView.svg
|IconC=Freecad.svg
}}

<!--T:2-->
<!--T:2-->
<!--Empty=1 to suppress icon-->
{{GuiCommand
{{GuiCommand
|Name=Std Workbench
|Name=Std Workbench
|Empty=1
|MenuLocation={{StdMenu|[[Std View Menu|View]]}} → Workbench
|MenuLocation=View → Workbench
|Workbenches=All
|SeeAlso=[[Workbenches| Workbenches]], [[Interface]]
|Workbenches=[[Workbenches|Workbenches]]
|SeeAlso=
}}
}}


== Description == <!--T:5-->
==Description== <!--T:5-->


<!--T:6-->
<!--T:6-->
The '''Std Workbench''' command activates a selected [[Workbenches|workbench]] including its graphical user interface (GUI).
This command (AKA the '''Workbench Toolbar''', '''Workbench Selector''', and the '''Workbench Dropdown''' menu) is used to activate the Graphical User Interface ('''GUI''') and switch to the the tools of any of the available [[Workbenches]] in FreeCAD.


<!--T:26-->
[[File:FreeCAD_interface_base_divisions.png|800px]]
[[Image:FreeCAD_interface_base_divisions.svg|800px]]
{{Caption|Workbench Dropdown indicated by number 9 in the stardard [[interface]]}}
{{Caption|The Workbench dropdown list indicated by number 10 in the standard [[interface|interface]]}}


==Notes==<!--T:8-->
==Usage== <!--T:3-->

* There are also two special options available: '''None''' (no workbench) and the [[Complete_Workbench|Complete]] Workbench {{Obsolete|0.17}}
* Additional [[External Workbenches]] can be downloaded using the [[Image:AddonManager.svg|24px]] [[Addon Manager]] and will display in this dropdown menu as well.

== Usage == <!--T:3-->


<!--T:9-->
<!--T:9-->
# There are several ways to invoke the command:
Often the project starts in a workbench, for example with '''Sketch''', then continues in a different workbench, for example with '''Part''', to create objects.
#* Select a workbench from the '''Workbench dropdown list''' in the Workbench toolbar. This option is not available if the current workbench is {{incode|<none>}} (no workbench).
You can switch from the current workbench to a new one with one of the following ways:
#* Select a workbench from the {{MenuCommand|View → Workbench}} sub-menu.


=== From the View menu === <!--T:10-->
==Notes== <!--T:8-->
* In the top menu, open the {{MenuCommand|{{StdMenu|[[Std View Menu|View]]}} → Workbench}} menu and select a workbench. '''Note:''' This menu is always available, even when you have previously selected the '''Complete'''{{Obsolete|0.17}} or '''None''' workbench.


=== From the drop-down menu === <!--T:11-->
<!--T:27-->
* Additional [[External_Workbenches|External Workbenches]] can be downloaded with the [[Image:AddonManager.svg|24px]] [[Addon_Manager|Addon Manager]].
* In the toolbar, open the drop-down menu and select a workbench. '''Note:''' This menu is '''not''' available when you have previously selected the '''Complete'''{{Obsolete|0.17}} or '''None''' workbench.


=== Via Python console === <!--T:12-->
==Preferences== <!--T:32-->


<!--T:13-->
<!--T:33-->
* The start up workbench can be changed in the preferences: {{MenuCommand|Edit → Preferences... → General → General → Start up}}. See [[Preferences_Editor#General|Preferences Editor]].
* Type the command in the Python console, for example: to invoke the Draft workbench type:
:{{incode|Gui.activateWorkbench ("DraftWorkbench")}}


== Examples == <!--T:14-->
==Scripting== <!--T:34-->


<!--T:16-->
<!--T:35-->
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].
[[Image: WorkbenchStd1.png]]


<!--T:15-->
<!--T:36-->
To change the worbench use the {{incode|activateWorkbench}} method of the FreeCADGui module. This method is not available if FreeCAD is in console mode.
{{Caption|Using the the Workbench drop-down menu}}


</translate>
<!--T:18-->
{{Code|code=
[[Image: WorkbenchStd2.png]]
import FreeCADGui


FreeCADGui.activateWorkbench("PartDesignWorkbench")
<!--T:17-->
}}
{{Caption|Invoking a different workbench using the Python console}}
<translate>

<!--T:20-->
[[Image: WorkbenchStd3.png]]


<!--T:19-->
{{Caption|'''Tip:''' If the Python console is open you will see that FreeCAD records the actions it executes in python code. Theoretically, the user can change something in the interface and see the comparable python code generated. This is a very useful way to learn python, FreeCAD, and how to automate redundant tasks (see [[Macros]] for more details).}}


== Other references == <!--T:21-->
<!--T:37-->
{{Docnav
For a general description of the workbenches, see the page [[Workbenches| Workbenches]].
|[[Std_RandomColor|RandomColor]]

|[[Std_TreeSyncView|TreeSyncView]]
<!--T:23-->
|[[Std_View_Menu|Std View Menu]]
{{Std Base}}
|IconL=Std_RandomColor.svg

|IconR=Std_TreeSyncView.svg
{{Interface}}
|IconC=Freecad.svg

}}
<!--T:25-->
{{Userdocnavi}}


</translate>
</translate>
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Interface navi{{#translation:}}}}
{{clear}}
{{clear}}

Revision as of 14:57, 6 January 2021

Std Workbench

Menu location
View → Workbench
Workbenches
Workbenches
Default shortcut
None
Introduced in version
-
See also
None

Description

The Std Workbench command activates a selected workbench including its graphical user interface (GUI).

The Workbench dropdown list indicated by number 10 in the standard interface

Usage

  1. There are several ways to invoke the command:
    • Select a workbench from the Workbench dropdown list in the Workbench toolbar. This option is not available if the current workbench is <none> (no workbench).
    • Select a workbench from the View → Workbench sub-menu.

Notes

Preferences

  • The start up workbench can be changed in the preferences: Edit → Preferences... → General → General → Start up. See Preferences Editor.

Scripting

See also: FreeCAD Scripting Basics.

To change the worbench use the activateWorkbench method of the FreeCADGui module. This method is not available if FreeCAD is in console mode.

import FreeCADGui

FreeCADGui.activateWorkbench("PartDesignWorkbench")