Std SelBoundingBox: Difference between revisions

From FreeCAD Documentation
(Revised. 'In progress' for now.)
(Restored the numbered list in the Usage section.)
 
(14 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Page in progress}}

<translate>
<translate>


<!--T:8-->
{{Docnav
{{Docnav
|[[Std_DrawStyle|Std DrawStyle]]
|[[Std_DrawStyle|DrawStyle]]
|[[Std_ViewIvStereoRedGreen|Std ViewIvStereoRedGreen]]
|[[Std_ViewIvStereoRedGreen|ViewIvStereoRedGreen]]
|[[Std_View_Menu|Std View Menu]]
|[[Std_View_Menu|Std View Menu]]
|IconL=Std_DrawStyle.svg
|IconL=Std_DrawStyle.svg
|IconR=Std_ViewIvStereoRedGreen.svg
|IconR=
|IconC=Freecad.svg
|IconC=Freecad.svg
}}
}}
Line 19: Line 17:
|MenuLocation=View → Bounding box
|MenuLocation=View → Bounding box
|Workbenches=All
|Workbenches=All
|Version=0.19
|SeeAlso=[[Std_DrawStyle|Std DrawStyle]]
|SeeAlso=[[Std_DrawStyle|Std DrawStyle]]
}}
}}
Line 25: Line 24:


<!--T:3-->
<!--T:3-->
The '''Std SelBoundingBox''' command toggles the bounding box highlighting mode. If this mode is switched on, selected objects are marked in a 3D view with a highlighted bounding box instead of a highlighted shape.
The '''Std SelBoundingBox''' command toggles the global bounding box highlighting mode. If this mode is switched on, selected objects are marked in a [[3D_view|3D view]] with a highlighted bounding box even if their {{PropertyView|Selection Style}} is set to 'Shape'.


==Usage== <!--T:5-->
==Usage== <!--T:5-->
Line 34: Line 33:
#* Select the {{MenuCommand|View → [[Image:Std_SelBoundingBox.svg|16px]] Bounding box}} option from the menu.
#* Select the {{MenuCommand|View → [[Image:Std_SelBoundingBox.svg|16px]] Bounding box}} option from the menu.


==Preferences== <!--T:10-->

<!--T:11-->
The related setting is stored: {{MenuCommand|Tools → Edit parameters... → BaseApp → Preferences → View → ShowSelectionBoundingBox}}. It is a boolean value, the default is {{FALSE}}.

==Scripting== <!--T:12-->

<!--T:13-->
{{Emphasis|See also:}} [[FreeCAD_Scripting_Basics|FreeCAD Scripting Basics]].

<!--T:14-->
To change the ShowSelectionBoundingBox setting use the {{incode|SetBool}} method of the appropriate ParameterGrp. The code sample does not work if FreeCAD is in console mode.

</translate>
{{Code|code=
import FreeCAD, FreeCADGui

grp = FreeCAD.ParamGet('User parameter:BaseApp/Preferences/View')
if grp.GetBool('ShowSelectionBoundingBox'):
grp.SetBool('ShowSelectionBoundingBox',False)
else:
grp.SetBool('ShowSelectionBoundingBox',True)

FreeCADGui.updateCommands()
}}
<translate>


<!--T:9-->
{{Docnav
{{Docnav
|[[Std_DrawStyle|Std DrawStyle]]
|[[Std_DrawStyle|DrawStyle]]
|[[Std_ViewIvStereoRedGreen|Std ViewIvStereoRedGreen]]
|[[Std_ViewIvStereoRedGreen|ViewIvStereoRedGreen]]
|[[Std_View_Menu|Std View Menu]]
|[[Std_View_Menu|Std View Menu]]
|IconL=Std_DrawStyle.svg
|IconL=Std_DrawStyle.svg
|IconR=Std_ViewIvStereoRedGreen.svg
|IconR=
|IconC=Freecad.svg
|IconC=Freecad.svg
}}
}}
Line 46: Line 74:
{{Std Base navi{{#translation:}}}}
{{Std Base navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{clear}}

Latest revision as of 16:09, 3 July 2022

Std SelBoundingBox

Menu location
View → Bounding box
Workbenches
All
Default shortcut
None
Introduced in version
0.19
See also
Std DrawStyle

Description

The Std SelBoundingBox command toggles the global bounding box highlighting mode. If this mode is switched on, selected objects are marked in a 3D view with a highlighted bounding box even if their ViewSelection Style is set to 'Shape'.

Usage

  1. There are several ways to invoke the command:
    • Press the Std SelBoundingBox button.
    • Select the View → Bounding box option from the menu.

Preferences

The related setting is stored: Tools → Edit parameters... → BaseApp → Preferences → View → ShowSelectionBoundingBox. It is a boolean value, the default is false.

Scripting

See also: FreeCAD Scripting Basics.

To change the ShowSelectionBoundingBox setting use the SetBool method of the appropriate ParameterGrp. The code sample does not work if FreeCAD is in console mode.

import FreeCAD, FreeCADGui

grp = FreeCAD.ParamGet('User parameter:BaseApp/Preferences/View')
if grp.GetBool('ShowSelectionBoundingBox'):
  grp.SetBool('ShowSelectionBoundingBox',False)
else:
  grp.SetBool('ShowSelectionBoundingBox',True)

FreeCADGui.updateCommands()