Std ToggleVisibility

From FreeCAD Documentation
Other languages:

Std ToggleVisibility

Menu location
View → Toggle visibility
Workbenches
All
Default shortcut
Space
Introduced in version
-
See also
Std ShowSelection, Std HideSelection, Std ToggleObjects, Std ShowObjects, Std HideObjects

Description

The Std ToggleVisibility command toggles the visibility of selected objects in 3D views.

Usage

  1. Select one or more objects.
    • Invisible objects can be selected in the Tree view.
    • Be careful when you use Ctrl+A to select all objects in the Tree view. This will also select sub-elements of PartDesign bodies and objects used for Part Booleans. In most cases these should stay invisible.
    • Objects used for Part Booleans are also selected when you use Ctrl+A in a 3D view.
  2. There are several ways to invoke the command:
    • Select the View → Visibility → Toggle visibility option from the menu.
    • Select the Toggle visibility option from the Tree view context menu or 3D view context menu.
    • Use the keyboard shortcut: Space.

Notes

  • Invisible objects are displayed with a greyed out label and a greyed out icon in the Tree view.
  • Objects nested in a Std Part, or a Std Link to a Std Group, or a LinkGroup, and features of a PartDesign Body will only be visible in 3D views if their successive parents are visible as well. This means that a feature in a PartDesign Body that is nested in a Std Part will only be visible in 3D views if the feature itself, the PartDesign Body, and the Std Part are all visible. And if the Std Part is in turn nested in another Std Part, then that last object must also be visible.
  • If the visibility of a Std Group (or an object derived from it such as an Arch BuildingPart) is changed, the visibility of its nested objects will change accordingly. But their visibility can be changed independently as well.
  • The action can only be undone with Std Undo if the fine-tuning parameter AutoTransactionView is set to true.
  • The visibility of an object can also be changed through its related DataVisibility property in the Property editor.

Scripting

See also: Autogenerated API documentation and FreeCAD Scripting Basics.

Use the show and hide methods of an object to change its visibility. An object's Visibility property can also be changed directly. 

import FreeCADGui

obj = FreeCADGui.ActiveDocument.myObjectName

if obj.Visibility == True:
    obj.hide()
else:
    obj.show()

# Alternatively:
obj.Visibility = not obj.Visibility


Std Base
User documentation
Retrieved from "http://wiki.freecad.org/index.php?title=Std_ToggleVisibility&oldid=1468549"