CanvasCV: canvascv::CompoundWidget Class Reference
CanvasCV  1.0.0
canvascv::CompoundWidget Class Referenceabstract

The CompoundWidget class. More...

#include <compoundwidget.h>

Inheritance diagram for canvascv::CompoundWidget:
canvascv::Widget canvascv::LayoutBase canvascv::Layout canvascv::AutoLayout canvascv::CheckBoxes canvascv::MsgBox canvascv::RadioButtons canvascv::SelectionBox canvascv::HorizontalLayout canvascv::VerticalLayout canvascv::HFrame canvascv::VFrame

Public Member Functions

virtual void setOutlineColor (const cv::Scalar &value)
 delegate to internal Widget parts added by derived classes
 
virtual void setFillColor (const cv::Scalar &value)
 delegate to internal Widget parts added by derived classes
 
virtual void setSelectColor (const cv::Scalar &value)
 delegate to internal Widget parts added by derived classes
 
virtual void setThickness (int value)
 delegate to internal Widget parts added by derived classes
 
virtual void setLineType (int value)
 delegate to internal Widget parts added by derived classes
 
virtual void setVisible (bool value)
 delegate to internal Widget parts added by derived classes
 
virtual const std::string & getStatusMsg () const
 delegate to active widget or to our derived class if none active
 
virtual void translate (const cv::Point &translation)
 delegate to internal Widget parts added by derived classes
 
void doForAll (CBWidget cb, int recurseLevel, bool doOnSelf)
 doForAll More...
 
virtual const cv::Rect & getRect ()
 Actual size the widget is occupying due to Layout manager.
 
- Public Member Functions inherited from canvascv::Widget
 Widget (const cv::Point &pos=cv::Point(0, 0))
 constructor
 
virtual ~Widget ()
 virtual destructor
 
virtual const char * getType () const =0
 getType is always implemented by derived to return the same static pointer per widget. More...
 
void notifyOnChange (CBWidgetState cb)
 used to register for notifications on a widget More...
 
cv::Scalar getOutlineColor () const
 get the outline color
 
cv::Scalar getFillColor () const
 get the bg color
 
bool getVisible () const
 is the widget visible
 
int getThickness () const
 get line thickness to use when drawing
 
int getLineType () const
 get the line type (LINE_4, LINE_8, LINE_AA)
 
uchar getAlpha () const
 get the alpha value used for the widge background [0,255] => [transparent,opaque]
 
void setAlpha (uchar value)
 set the alpha value used for the widge background [0,255] => [transparent,opaque]
 
Anchor getLayoutAnchor () const
 getLayoutAnchor returns the anchor for using in the Layout we're in More...
 
void setLayoutAnchor (const Anchor &value)
 setLayoutAnchor sets the anchor for using in the Layout we're in More...
 
Anchor getFlowAnchor () const
 getFlowAnchor get internal widget alignment and direction of growth More...
 
void setFlowAnchor (const Anchor &value)
 setFlowAnchor set internal widget alignment and direction of growth More...
 
int getId ()
 Widgets have a unique id per instance.
 
void setStatusMsg (const std::string &value)
 setStatusMsg More...
 
const cv::Point & getLocation () const
 get widget position in Canvas
 
virtual void setLocation (const cv::Point &value)
 set widget position in Canvas
 
bool getStretchX () const
 get if the Layout we're in should stretch us in the X direction
 
void setStretchX (bool value)
 set if the Layout we're in should stretch us in the X direction (and calls setStretchXToParent(false))
 
bool getStretchY () const
 get if the Layout we're in should stretch us in the Y direction
 
void setStretchY (bool value)
 set if the Layout we're in should stretch us in the Y direction (and calls setStretchYToParent(false))
 
cv::Scalar getSelectColor () const
 get the color to use when a widget is selected
 
std::shared_ptr< WidgetrmvFromLayout ()
 get rid of the widget
 
bool getIsSelectable () const
 get if the widget should appear as selected when the mouse is over it
 
void setIsSelectable (bool value)
 set if the widget should appear as selected when the mouse is over it
 
int getForcedWidth () const
 get the forced width for this widget
 
void setForcedWidth (int value)
 set the forced width for this widget (and calls setStretchX/setStretchXToParent(false))
 
int getForcedHeight () const
 get the forced height for this widget
 
void setForcedHeight (int value)
 set the forced height for this widget (and calls setStretchY/setStretchYToParent(false))
 
void update ()
 removes 'dirty' state and invokes the derived 'recalc/recalcCompound'
 
bool isRemoved () const
 returns true if the widget has no layout and false if it does
 
bool getStretchXToParent () const
 get if this widget streches to parent layout width
 
void setStretchXToParent (bool value)
 set if this widget streches to parent layout width (and calls setStretchX(false))
 
bool getStretchYToParent () const
 get if this widget streches to parent layout height
 
void setStretchYToParent (bool value)
 set if this widget streches to parent layout height (and calls setStretchY(false))
 

Protected Member Functions

virtual void recalc () final
 delegate to internal Widget parts added by derived classes
 
virtual void recalcCompound ()=0
 recalcCompound More...
 
virtual void addWidget (const std::shared_ptr< Widget > &widget)
 adds the widget to this Layout after removing it from it's previous layout
 
virtual std::shared_ptr< WidgetrmvWidget (const std::shared_ptr< Widget > &widget)
 rmvWidget More...
 
virtual void renderOn (cv::Mat &dst)
 render the widget to dst More...
 
virtual void drawFG (cv::Mat &dst)
 dst is the roi of the widget size and not the full image
 
virtual bool isAtPos (const cv::Point &pos)
 isAtPos More...
 
virtual const cv::Rect & getMinimalRect ()
 Minimal size the widget coould have occupy.
 
- Protected Member Functions inherited from canvascv::Widget
void setStateChangesBG ()
 widgets like buttons change bg on mouse events
 
void allocateBG (const cv::Size &size)
 invokes Theme::allocateBG()
 
void flatWidget ()
 delegate to Theme
 
void raisedWidget ()
 delegate to Theme
 
void sunkenWidget ()
 delegate to Theme
 
void selectedWidget ()
 delegate to Theme
 
void callDrawFG (bool preAllocateMat=true)
 helper method which delgates to drawFG for derived
 
bool setDirty ()
 setDirty More...
 

Additional Inherited Members

- Public Types inherited from canvascv::Widget
typedef std::function< void(Widget *)> CBWidget
 signature of a callback which only gets the widget
 
typedef std::function< void(Widget *, State)> CBWidgetState
 signature of a callback which gets the State
 
typedef std::function< void(Widget *, int)> CBUserSelection
 signature of a callback which gets a user selection
 

Detailed Description

Utility class to help easy creation of complex widgets and Layout managers.

Examples:
example_add_widget.cpp.

Member Function Documentation

void canvascv::CompoundWidget::doForAll ( CBWidget  cb,
int  recurseLevel,
bool  doOnSelf 
)

invoke the cb for all included widgets. This is usually not necessary since the above methods delegate to both contained widgets and self.

Parameters
cbis what to execute on widgets
recurseLevelis how deep to go when updating kids:
  • -1 means all decendents at all levels
  • 0 means only current level (doOnSelf needs to be also 'true')
  • n>0 means up to kids at level n (1 is children, 2 is also grandchildren, etc.)
doOnSelfis if to also invoke the cb on the first parent
virtual bool canvascv::CompoundWidget::isAtPos ( const cv::Point &  pos)
protectedvirtual
Parameters
pos
Returns
true or false if at location

Reimplemented from canvascv::Widget.

virtual void canvascv::CompoundWidget::recalcCompound ( )
protectedpure virtual

Your BG size recalculation/allocation and FG drawing is done here. It is done semi automatically. Is you invoke setters in this method on your internal widgets, then make sure to update them and/or their layout

Implemented in canvascv::MsgBox, canvascv::CheckBoxes, canvascv::RadioButtons, canvascv::SelectionBox, canvascv::VerticalLayout, and canvascv::HorizontalLayout.

virtual void canvascv::CompoundWidget::renderOn ( cv::Mat &  dst)
protectedvirtual
Parameters
dstis the full size image

Reimplemented from canvascv::Widget.

virtual std::shared_ptr<Widget> canvascv::CompoundWidget::rmvWidget ( const std::shared_ptr< Widget > &  widget)
protectedvirtual
Parameters
widgetwill be removed from this Layout
Returns
filled shared_ptr to removed widget or empty if not found
Note
Widgets must be in layouts to be displayed correctly.

Implements canvascv::Layout.

Reimplemented in canvascv::AutoLayout.


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