ViewWorkAreaBodyC - Work area body.

Developer Documentation

Centre for Vision, Speech & Signal Processing

Parent Classes:

GUIFixedWidgetBodyC

Enumerated types:

enum ObjOpsT { ObjOpAdd, ObjOpDel, ObjOpSelect, ObjOpUnselect } ;: Object operations.

Variables:

StdView::GroupC parent;
HashARC mapping;
HashARC innerMapping;
DisplayMapC displayMap;: -------- Working info. --------------
GUIWidgetC drag;
PixelC dragOffset;
HSetC selection;
PThread::MutexC accessSelection;: Access control for selection.
GUIMenuC backMenu;
GUIMenuC objMenu;
PThread::MsgPipeC> mods;
BooleanT reqQueued;

Methods:

ViewWorkAreaBodyC(const StringC & nname): Constructor.
BooleanT Display(StdView::GroupC & group): Display a group of objects.
BooleanT SubButtonEvent(StdView::ObjectC & gobj,GUIMouseEventC & me,GdkEvent * event): Deal with a button press in a child widget.
void UpdateAdd(StdView::ObjectC & obj): Update display on add
void UpdateDel(StdView::ObjectC & obj): Update display on del
void DeleteSelection(): Delete current selection.
int HandleExposeEvent(GtkWidget * widget,GdkEventExpose * event): Handle expose event.
This should be private but...
void Select(const StdView::ObjectC & obj): Add object to selection.
void Deselect(const StdView::ObjectC & obj): Remove object from selection.
BooleanT IsSelected(StdView::ObjectC & obj): Test if object is selected.
void ClearSelection(): Clear the current selection.
StdView::GroupC GetSelection(): Get the selection in the form of a group.
Note: This generates a new group with each call.
void Minimise(StdView::ObjectC & obj): Pickup an object.
void Drop(): Drop object.
void DropInto(StdView::ObjectC & obj): Drop object.
BooleanT Create(): Create the widget.
BooleanT SetupWidget(StdView::ObjectC & obj,GUIWidgetC & widge): Add a new widget.
GUIWidgetC BuildControlBar(StdView::ObjectC & obj): Build a control bar for object.
int BackPressEvent(GtkWidget * widget,GdkEventButton * event): Handle background press event.
-------- Multithread. --------------
BooleanT Service(): Handle Service request.
void QueueOp(ObjOpsT op,const StdView::ObjectC & obj): Queue an operation.
int gtkBackPressEvent(GtkWidget * widget,GdkEventButton * event,ViewWorkAreaBodyC * wa)

#include "amma/GUI/Fixed.hh"

BooleanT Create(): Create the widget.
BooleanT Service(): Service render request.
BooleanT Move(GUIWidgetC & widge,PixelC where): Move a widget.
Must be called from the GUI thread.
BooleanT Add(const GUIWidgetC & widge): Add a child widget.
Must be called from the GUI thread.
void AddWidget(const GUIWidgetC & newun,PixelC where): Add new widget.
Thread safe.
void GUIAddWidget(GUIWidgetC & newun,PixelC & where): Add new widget.
GUI thread only.
PixelC Position(const GUIWidgetC & widge): Where should we place this widget.

#include "amma/GUI/CWidget.hh"

BooleanT Create(): Create the widget.
BooleanT Add(const GUIWidgetC & widge): Add a child widget.
BooleanT Add(const DListC<GUIWidgetC> & widges): Add children.
void GUIAdd(GUIWidgetC & widge): Add widget.
GUI thread only.
BooleanT Remove(GUIWidgetC & widge): Remove a child widget.
void Destroy(): Undo all refrences.
Used to avoid problems with circluar refrences. This should undo all refrences to AMMA and GUI objects which are not in the destroy tree. The function is called by the root window in its destructor.

#include "amma/GUI/Widget.hh"

BooleanT Create(): Create the widget.
BooleanT Service(): Service request.
Used to send signals from other threads to the program.
GtkWidget * Widget(): Access widget.
int WidgetID() const: Get widget id.
StringC WidgetName() const: Get widget's name.
Call only from GUI thread.
StringC Name() const: Get name of widget.
Defaults to WidgetName(), but may be differnt for Lables etc.
BooleanT GUIShow(): Show widget to the world.
Call only from GUI thread.
BooleanT GUIHide(): Hide widget from the world.
Call only from GUI thread.
void Show(): Show widget to the world.
Thread safe.
void Hide(): Hide widget from the world.
Thread safe.
PixelC Position() const: Widget position within its parent window.
PixelC Size() const: Access Size of wiget.
void GUISetUSize(IntT x,IntT y): Set size of widget.
GUI thread only.
IndexRectangleC Rectangle() const: Widget position and extent within its parent window.
void SetState(GtkStateType state): Set state
void WidgetDestroy(): Called when the underlying widget it destroyed.
The default version of this method simpily 0's the widget ptr.
Signal0C & Signal(const char *): Get handle for named signal.
See handle class for description.
void SetToolTip(const char * text,const char * ctxt = 0): Set the tool tip for the widget.
NB. Not all widgets can display tooltips.
void AddEventMask(IntT event): Add to the event mask.
void DelEventMask(IntT event): Remove from the event mask.
void ShapeCombineMask(GdkBitmap & mask,int off_x = 0,int off_y = 0): Make a shape mask for the widget.
void Destroy(): Undo all refrences.
Used to avoid problems with circluar refrences. This should undo all refrences to AMMA and GUI objects which are not in the destroy tree. The function is called by the root window in its destructor.
BooleanT ReqService(): Request call by GUI thread to 'Service()' method of this widget.
This call is thread safe.
void ConnectSignals(): Connect the default signals to the underly widget.
void ConnectUp(const char * nm,Signal0C & sig): Connect up a signal.
GTKSignalInfoC & SigInfo(const char * nm): Get information about a named signal.
int gtkDestroy(GtkWidget * widget,GUIWidgetBodyC * data)
int gtkEvent(GtkWidget * widget,GdkEvent * event,Signal0C * data)
int gtkEventMouseButton(GtkWidget * widget,GdkEvent * event,Signal0C * data)
int gtkEventMouseMotion(GtkWidget * widget,GdkEvent * event,Signal0C * data)
int gtkGeneric(GtkWidget * widget,Signal0C * data)
int gtkString(GtkWidget * widget,Signal0C * data)
int gtkCListSelect(GtkWidget * widget,IntT row,IntT column,GdkEventButton * event,Signal0C * data)
int gtkCListCol(GtkWidget * widget,IntT column,Signal0C * data)

#include "amma/DP/Entity.hh"

BooleanT Save(ostream & out) const: Save to ostream.
BodyRefCounterVC & Copy() const: Creat a copy of this object.

#include "amma/BRefCntV.hh"

BodyRefCounterVC & Copy() const: Creat a copy of this object.
BooleanT operator==(const BodyRefCounterVC & oth) const: Compair identitys.
BooleanT operator!=(const BodyRefCounterVC & oth) const: Compair identitys.
BooleanT Save(ostream & out) const: Save to ostream.

#include "amma/BRefCnt.hh"

void AddReference(): Another reference to the object has been created.
void RemoveReference(): One reference to the object was deleted.
Locking scheme -------------- The object is possible to lock (to make constant). The scheme assumes that the object is created, it can be locked, after that it can only be destroyed. The locked object cannot be unlocked. This locking scheme is very useful during debugging, using assert() function, when it is necassary to check that object is treated as constant and the constancy is not violated by any casting or passing through the copy constructor of shared objects.
void SetConst(void) const: This locks the object.
Often objects you wish to lock are already const.
void SetConst(void): This locks the object.
BooleanT IsConst(void) const: Returns TRUE if the object is locked, ie. it is assumed to be constant.
BooleanT IsNotConst(void) const: Returns TRUE if the object is unlocked.
ie. there is no special information if the object is constant or not. Counter state information -------------------------
BooleanT ToBeDeleted() const: Returns TRUE if there is only one reference to the object and the whole object or its reference counting part can be deleted.
BooleanT ToBeDeletedRemoveIgnoreNoRemove(): Decrement refrence by 1 return true if this leaves no refrences to the object.
BooleanT ToBeDeletedRemove(): Decrement refrence by 1 return true if this leaves no refrences to the object. This also checks the NoRemove flag.
BooleanT BodyMightBeDeleted() const: Returns TRUE if the reference counted part of the object can be deleted, ie. flag NOREMOVE is false .
BooleanT IsCountZero() const: Are there any refrences left ?
BooleanT BRCPtrCanDeleteObject() const: Used by BRRCPtrC to establish if an object has ZERO refrences and can be deleted.
IntT Count() const: Returns the current state of the counter, ie. how many references to this object exist.
const BodyRefCounterC & operator=(const BodyRefCounterC & b): It has not meaning to assign object 'b' to this object because it would destroy a history of the object which is counted. So this is a dummy function.
BooleanT IsValidObject() const: Test if object is valid.
When amma check is disabled this always returns true.
BooleanT UserBitTest(IntT x) const: Test user flag.
void UserBitSet(IntT x,BooleanT setit = TRUE): Test user flag.
void UserBitZero(IntT x): Set bit to zero.
void ReportBRCError(char * Msg): Report error, used in BRCPtrC.
UIntT Hash() const: Hash on address of object.
void SetUndeletable(): Make object undeletable.
Usefull to prevent recursive deleting in graph structures. Only hackers need this function.
void ReportInvalidObject(char * Msg = 0) const: Tell user about validation failure.

#include "amma/RefCBase.hh"

LabelT Label() const: Returns the label of this reference counter.
The member function is useful mainly to recognize objects during debugging. The value of the label is uniquely defined pointer.

Programmer:Charles Galambos, Documentation by CxxDoc: Tue Mar 20 10:49:27 2001

ViewWorkAreaBodyC

Work area body.

include	"amma/GUI/VUIWorkArea.hh"
User Level:	Default
Library:	GUIView
Example:	ex3DCanvas.cc
Section:	GUI.View
In Scope:	StdGUI