Simulation Modeling Tool Kit
Public Member Functions | Static Public Member Functions | Protected Slots | Protected Member Functions | List of all members
pqSMTKPlaneItemWidget Class Reference

Display a 3-D plane with draggable handles for editing a GroupItem. More...

#include <pqSMTKPlaneItemWidget.h>

Inheritance diagram for pqSMTKPlaneItemWidget:
Collaboration diagram for pqSMTKPlaneItemWidget:

Public Member Functions

 pqSMTKPlaneItemWidget (const smtk::extension::qtAttributeItemInfo &info, Qt::Orientation orient=Qt::Horizontal)
bool createProxyAndWidget (vtkSMProxy *&proxy, pqInteractivePropertyWidget *&widget) override
 Subclasses must override this method to create the ParaView widget of their choice.
- Public Member Functions inherited from pqSMTKAttributeItemWidget
void markForDeletion () override
 Indicates that the item should be deleted. More...
 pqSMTKAttributeItemWidget (const qtAttributeItemInfo &info, Qt::Orientation orient=Qt::Horizontal)
 pqSMTKAttributeItemWidget (smtk::attribute::ItemPtr, QWidget *p, smtk::extension::qtBaseView *bview, Qt::Orientation orient=Qt::Horizontal)
pqInteractivePropertyWidget * propertyWidget ()
- Public Member Functions inherited from smtk::extension::qtItem
 qtItem (const qtAttributeItemInfo &info)
smtk::attribute::ItemPtr item () const
template<typename ItemType >
std::shared_ptr< ItemType > itemAs () const
qtUIManageruiManager () const
smtk::attribute::ResourcePtr attributeResource () const
 Return the underlying Attribute Resource.
QPointer< QWidget > widget ()
QPointer< QWidget > parentWidget ()
bool isLeafItem ()
virtual void setLabelVisible (bool)
virtual bool isFixedWidth () const
void showAdvanceLevelOverlay (bool)
bool useSelectionManager () const
void setReadOnly (bool mode)
bool isReadOnly () const

Static Public Member Functions

static qtItemcreatePlaneItemWidget (const qtAttributeItemInfo &info)
- Static Public Member Functions inherited from pqSMTKAttributeItemWidget
static OverrideWhen OverrideWhenConvert (const std::string &str)
static std::string OverrideWhenConvert (OverrideWhen val)
static FallbackStrategy FallbackStrategyConvert (const std::string &str)
static std::string FallbackStrategyConvert (FallbackStrategy val)
static GeometrySource GeometrySourceConvert (const std::string &str)
static std::string GeometrySourceConvert (GeometrySource val)
static void setHideWidgetWhenInactive (bool val)
 Set visibility behavior of 3D widgets when Qt widget is inactive.
static bool hideWidgetWhenInactive ()

Protected Slots

bool updateItemFromWidgetInternal () override
 Retrieve property values from ParaView proxy and store them in the attribute's Item.
bool updateWidgetFromItemInternal () override
- Protected Slots inherited from pqSMTKAttributeItemWidget
void updateItemData () override
 Create Qt widgets as required (may be called multiple times if Item is reconfigured).
virtual void ignoreWidgetValues ()
virtual void acceptWidgetValues ()
virtual bool updateItemFromWidgetInternal ()=0
 Update smtk::attribute::Item(s) from widget, returning true if changes were made.
virtual bool updateWidgetFromItemInternal ()=0
 Update proxy properties from smtk::attribute::Item(s), returning true if changes were made.
- Protected Slots inherited from smtk::extension::qtItem
virtual void onAdvanceLevelChanged (int levelIdx)
virtual void onChildWidgetSizeChanged ()

Protected Member Functions

bool fetchOriginAndNormalItems (smtk::attribute::DoubleItemPtr &originItem, smtk::attribute::DoubleItemPtr &normalItem)
 Starting with the widget's assigned item (which must be a GroupItem), fetch the proper children. More...
- Protected Member Functions inherited from pqSMTKAttributeItemWidget
bool eventFilter (QObject *obj, QEvent *event) override
 An event filter that watches for the associated Qt widget to be hidden or shown. More...
virtual void update3DWidgetVisibility (bool visible)
 Hide 3-d widgets when the Qt widget is hidden, show the widget when the Qt widget reappears. More...
void createWidget () override
 Initialize Qt widgets used to represent our smtk::attribute::Item.
virtual void clearChildWidgets ()
 Remove existing widgets in order to prepare for reconfiguration. More...
virtual void updateUI ()
 Actually create widgets for whole of Item (label, editor, and conditional children).
virtual void createEditor ()
 Create the widget(s) that allow editing of the Item (as opposed to labels and conditional child widgets).
bool validateControlItem (const smtk::attribute::StringItemPtr &item)
 Subclasses may call this to validate that a string item is appropriate for controlling the interaction state of the widget (i.e., the possibly tri-state checkbox that ParaView's Qt widgets provide to control render-view widget visibility).
- Protected Member Functions inherited from smtk::extension::qtItem
virtual void setLocalAdvanceLevel (unsigned int level)
virtual void addChildItem (qtItem *)
virtual void removeChildItem (qtItem *)
virtual void clearChildItems ()
QList< qtItem * > & childItems ()

Additional Inherited Members

- Public Types inherited from pqSMTKAttributeItemWidget
enum  OverrideWhen { OverrideWhen::Unset, OverrideWhen::Never }
 Specify when the widget may override values in the item. More...
enum  FallbackStrategy { FallbackStrategy::Hide, FallbackStrategy::Force }
 Specify how to size/place a widget. More...
enum  GeometrySource {
  GeometrySource::Item, GeometrySource::Associations, GeometrySource::Links, GeometrySource::Scene,
  GeometrySource::BestGuess, GeometrySource::None
 Specify how to size/place a widget. More...
using qtItem = smtk::extension::qtItem
using qtAttributeItemInfo = smtk::extension::qtAttributeItemInfo
- Public Slots inherited from pqSMTKAttributeItemWidget
virtual void updateItemFromWidget ()
virtual void updateWidgetFromItem ()
void setOutputOptional (int optionEnabled)
 Change whether the item is enabled (and thus the widget active). More...
void renderViewEventually () const
 Cause the active view (in which the widget appears) to re-render.
- Public Slots inherited from smtk::extension::qtItem
virtual void updateItemData ()
 Tell the qtItem to update itself based on changes to its underlying attribute item.
- Signals inherited from smtk::extension::qtItem
void widgetSizeChanged ()
 Signal indicates that the underlying widget's size has been modified.
void modified ()
 Signal indicates that the underlying item has been modified.
void childModified (qtItem *item)
 Signal indicates that the child from the underlying item has been modified More...
- Protected Attributes inherited from pqSMTKAttributeItemWidget
- Protected Attributes inherited from smtk::extension::qtItem
QPointer< QWidget > m_widget
bool m_isLeafItem
bool m_useSelectionManager
bool m_readOnly
bool m_markedForDeletion
qtAttributeItemInfo m_itemInfo
QList< smtk::extension::qtItem * > m_childItems

Detailed Description

Display a 3-D plane with draggable handles for editing a GroupItem.

For now, this code assumes that the Group has 2 entries and they that their qtAttributeItemInfo entries specify a mapping to the Origin and Normal of the plane. In the future, other item types (such as a DoubleItem holding 4 values used as linear polynomial coefficients) may be supported.

Currently, there is no support to initialize the bounding box coordinates used to size the plane widget; the item's values will be copied to the 3-D representation only if they exist and there is no default or if they are non-default. In the future, flags in the qtAttributeItemInfo may be used to determine a default box based on model geometry loaded into ParaView, as the underlying widget supports this.

Member Function Documentation

◆ fetchOriginAndNormalItems()

bool pqSMTKPlaneItemWidget::fetchOriginAndNormalItems ( smtk::attribute::DoubleItemPtr originItem,
smtk::attribute::DoubleItemPtr normalItem 

Starting with the widget's assigned item (which must be a GroupItem), fetch the proper children.

If errors are encountered, this method returns false.

The documentation for this class was generated from the following files: