rnr::WinGtk Class Reference

WinGtk window derived class. More...

#include <WinGtk.h>

Inheritance diagram for rnr::WinGtk:

Classes
struct	BttnInfo_T

Public Member Functions
	WinGtk (const std::string &strWinName, int nWidth, int nHeight, bool bDecorate=true)
	Default initialization constructor. More...
virtual	~WinGtk ()
	Destructor.
virtual const char *	getGuiToolkitName ()
	Get GUI toolkit name. More...
virtual void	setLookAndFeel (const std::string &strKey, const std::string &strVal)
	Set GUI look and feel value. More...
virtual GdkColor *	getLookAndFeelGdkColor (const std::string &strKey)
	Get the GUI look and feel GDK color. More...
virtual PangoFontDescription *	getLookAndFeelFont (const std::string &strKey)
	Get the GUI look and feel Pango font description. More...
virtual void	show ()
	Show/refresh all gui widgets in window.
virtual void	showCvImage (cv::Mat &img, uint_t uImgIndex=0)
	Show a OpenCV image on the workspace. More...
virtual void	showPageRef (int nPageId)
	Show page reference number. More...
virtual void	showPageRef (const std::string &strPageRef)
	Show page reference. More...
virtual void	showStatus (const char *sFmt,...)
	Show status message. More...
virtual void	clearStatus ()
	Clear status message.
virtual int	waitKey (int delay)
	Wait for keypress or timeout. More...
virtual void	waitMouse (int delay)
	Wait for timeout or registered mouse event. More...
virtual void	wait (int delay)
	Wait for timeout. More...
virtual bool	addImageButton (int nBttnId, AlignOp eAlign, const std::string &strIconPath, const std::string &strAltText, const std::string &strToolTip="")
	Add a button with an image to window button menu. More...
virtual bool	addImageButton (int nBttnId, AlignOp eAlign, void *wBttnImg, const std::string &strAltText, const std::string &strToolTip="")
	Add a button with a GTK image widget to window button menu. More...
virtual bool	addLabelButton (int nBttnId, AlignOp eAlign, const std::string &strLabel, const std::string &strToolTip="")
	Add a button with a label to window button menu. More...
virtual bool	addButton (int nBttnId, AlignOp eAlign, GtkWidget *wBttn)
	Add a GTK button widget to window button menu. More...
virtual bool	replaceButtonImage (int nBttnId, const std::string &strIconPath, const std::string &strToolTip="")
	Replace existing button image with new image. More...
virtual bool	replaceButtonImage (int nBttnId, void *wBttnImg, const std::string &strToolTip="")
	Replace existing button image with new GTK image widget. More...
virtual bool	replaceButtonLabel (int nBttnId, const std::string &strLabel, const std::string &strToolTip="")
	Replace existing button label with new label. More...
virtual bool	removeButton (int nBttnId)
	Remove a button from a menu. More...
virtual void	removeAllButtons ()
	Remove all buttons from all menus.
virtual bool	showButtonState (int nBttnId, WidgetState eBttnState)
	Show a button's widget state. More...
virtual void	initWorkspace ()
	Initialize window's workspace to hold a GTK toolkit widget tree. More...
virtual void	initWorkspaceAsGtk ()
	Initialize window's workspace to hold a GTK widget tree. More...
virtual uint_t	initWorkspaceAsCvImage ()
	Initialize the workspace as a display to show OpenCV images. More...
virtual void	initWorkspaceAsGstWin (const cv::Size &sizeVidWin)
	Initialize the workspace as a window display to show GStreamer video/images. More...
virtual uint_t	addWorkspaceCvImageDisplay (void *wContainer)
	Add an OpenCV display widget to the container widget. More...
virtual void	removeWorkspaceCvImageDisplay (uint_t uImgIndex)
	Remove OpenCV display widget from workspace. More...
virtual void	showWorkspace ()
	Show/refresh all gui widgets in workspace.
virtual void	eraseWorkspace ()
	Remove all widgets contained in the window's workspace container. More...
GtkWidget *	getMainWidget ()
	Get the top-level main widget. More...
GtkWindow *	getMainWindowWidget ()
	Get the top-level main window. More...
GtkWidget *	getWorkspaceVBox ()
	Get the window's workspace top vertical box container widget. More...
GtkWidget *	getExtraVBox ()
	Get the window's workspace extra vertical box container widget. More...
GtkWidget *	getGstWin ()
	Get GStreamer X-Window widget. More...
Public Member Functions inherited from rnr::Win
	Win (const std::string &strWinName, int nWidth, int nHeight, bool bDecorate=true)
	Windowing class initialization constructor. More...
virtual	~Win ()
	Destructor.
virtual std::string	getLookAndFeel (const std::string &strKey)
	Get the GUI look and feel value. More...
cv::Size	getWorkspaceSize ()
	Get the window's workspace size. More...
ulong_t	getGstXid ()
	Get GStreamer X-Window id. More...
void	registerCvImageMouseCallback (MouseCbFunc_T funcCb, void *param, uint_t uImgIndex=0)
	Register application mouse event callback. More...
void	unregisterCvImageMouseCallback (uint_t uImgIndex=0)
	Unregister application mouse event callback. More...
void	registerKeyboardCallback (KeyCbFunc_T funcCb, void *param)
	Register application keyboard press event callback. More...
void	unregisterKeyboardCallback ()
	Unregister application keyboard press event callback.
void	registerButtonClickCallback (BttnCbFunc_T funcCb, void *param)
	Register application button click event callback. More...
void	unregisterButtonClickCallback ()
	Unregister application button click event callback.

Protected Types
typedef std::map< int, BttnInfo_T >	MapBttns_T
	button map type
typedef std::map< std::string, GdkColor >	MapGdkColor_T
	color map type
typedef std::map< std::string, PangoFontDescription * >	MapPangoFont_T
	font map type
Protected Types inherited from rnr::Win
typedef std::map< std::string, std::string >	MapLookFeel_T

Protected Member Functions
int	getBttnMenuIdx (AlignOp eAlign)
	Get button menu index from alignment enum. More...
bool	findBttn (int nBttnId, MapBttns_T::iterator &pos)
	Find button. More...
void	convertLookAndFeelDefaults ()
	Convert Look and Feel defaults to native GTK/GDK values.
virtual void	configureCvImage (uint_t uImgIndex)
	Configure OpenCV image widget. More...
Protected Member Functions inherited from rnr::Win
void	setLookAndFeelDefaults ()
	Set look and feel standard set defaults.

Static Protected Member Functions
static void	onRemoveWidget (GtkWidget *w, gpointer user_data)
	Remove widget callback handler. More...
static gboolean	onAlarm (gpointer user_data)
	Timeout expiry callback handler. More...
static gboolean	onKeyPress (GtkWidget *w, GdkEventKey *event, gpointer *user_data)
	Keyboard press event callback handler. More...
static gboolean	onMouseCvImage (GtkWidget *w, GdkEventKey *event, gpointer *user_data)
	Mouse event on OpenCV Image widget workspace callback handler. More...
static void	onButtonClick (GtkWidget *w, gpointer *user_data)
	Button press event handler. More...
static void	onRealizeGstWin (GtkWidget *w, gpointer user_data)
	Realize GStreamer video window callback. More...

Protected Attributes
GtkWidget *	m_wMain
	main widget
GtkWindow *	m_wWindowMain
	main widnow widget
GtkWidget *	m_wContainer
	top container widget (hbox)
GtkWidget *	m_wBttnMenu [NumOfButtonMenus]
	left menu container widget
GtkWidget *	m_wWorkspace
	middle workspace container widget
GtkWidget *	m_wExtraVBox
	extra vertical box
GtkWidget *	m_wIcon
	workspace identifying icon
GtkWidget *	m_wStatusFrame
	holds page reference and status bar
GtkWidget *	m_wPageRef
	workflow page reference
GtkWidget *	m_wStatusBar
	status message bar
GtkWidget *	m_wCvImage [MaxCvImages]
	CvImage widgets.
GtkWidget *	m_wCvImageBox [MaxCvImages]
	CvImage box containers.
GtkWidget *	m_wGstWin
	GstWin container widget.
CvSize	m_sizeCvImage [MaxCvImages]
	size of shown CvImage
CvPoint	m_ptCvImageOrig [MaxCvImages]
	origin of shown CvImage
MapBttns_T	m_mapBttns [NumOfButtonMenus]
	left/right map of menu buttons.
MapGdkColor_T	m_mapColors
	look and feel color map
MapPangoFont_T	m_mapFonts
	look and feel font map
Protected Attributes inherited from rnr::Win
std::string	m_strWinName
	window name (and title)
int	m_nWinWidth
	window width
int	m_nWinHeight
	window height
bool	m_bDecorate
	do [not] decorate window
CvRect	m_rectWorkspace
	workspace bounding rectangle
ulong_t	m_uGstWinXid
	GstWin container X window id.
uint_t	m_uLastKey
	last pressed keyboard code
bool	m_bMouseEvent
	was a mouse event (click, drag, etc)
MouseCbFunc_T	m_funcMouseCb [MaxCvImages]
	registered mouse cb func
void *	m_dataMouseCb [MaxCvImages]
	registered mouse cb data
KeyCbFunc_T	m_funcKeyCb
	registered keyboard callback func
void *	m_dataKeyCb
	registered keyboard callback data
BttnCbFunc_T	m_funcBttnCb
	registered menu button callback func
void *	m_dataBttnCb
	registered menu button callback data
MapLookFeel_T	m_mapLookFeel
	look and feel map

Additional Inherited Members
Static Public Attributes inherited from rnr::Win
static const int	MaxCvImages = 4
	max workspace images/video
static const int	NumOfButtonMenus = 2
	left and right menus

Detailed Description

WinGtk window derived class.

The WinGtk class uses the GTK (GIMP Toolkit) libraries for creating the graphical user interfaces.

Definition at line 89 of file WinGtk.h.

Constructor & Destructor Documentation

WinGtk::WinGtk	(	const std::string &	strWinName,
		int	nWidth,
		int	nHeight,
		bool	bDecorate = true
	)

Default initialization constructor.

Parameters

strWinName	Window name.
nWidth	Window width in pixels.
nHeight	Window height in pixels.
bDecorate	Do [not] decorate window with title, border, etc. Windowing system specific.

Definition at line 94 of file WinGtk.cxx.

References rnr::AlignOpLeft, rnr::AlignOpRight, convertLookAndFeelDefaults(), getBttnMenuIdx(), m_mapColors, rnr::Win::m_nWinHeight, rnr::Win::m_nWinWidth, rnr::Win::m_rectWorkspace, rnr::Win::m_strWinName, m_wBttnMenu, m_wContainer, m_wCvImage, m_wCvImageBox, m_wExtraVBox, m_wGstWin, m_wMain, m_wPageRef, m_wStatusBar, m_wStatusFrame, m_wWindowMain, m_wWorkspace, rnr::Win::MaxCvImages, and onKeyPress().

                                        :
    Win(strWinName, nWidth, nHeight, bDecorate)

{
  const int  nHBoxBorder       =  6;    // hbox outside border width
  const int  nMenuWidth        = 48;    // button menu width
  const int  nStatusBarHeight  = 20;    // status bar height
  const int  nWorkspaceBorder  =  4;    // workspace outside border width

  int         nWorkspaceWidth;
  int         nWorkspaceHeight = nHeight - nStatusBarHeight;
  GtkWidget  *wHBox;
  GtkWidget  *wVBox;
  GtkWidget  *w;
  int         i;

  nWorkspaceWidth  = nWidth - (nHBoxBorder + nMenuWidth + nWorkspaceBorder) * 2;
  nWorkspaceHeight = nHeight - nHBoxBorder - nStatusBarHeight 
                             - nWorkspaceBorder;

  // default colors & fonts
  convertLookAndFeelDefaults();

  // required
  gtk_init(0, NULL);

  // create a new gtk window
  m_wMain = gtk_window_new(GTK_WINDOW_TOPLEVEL);
  m_wWindowMain = GTK_WINDOW(m_wMain);
  
  //
  // Configure window's look and feel
  //
  gtk_window_set_title(m_wWindowMain, m_strWinName.c_str());
  gtk_window_resize(m_wWindowMain, m_nWinWidth, m_nWinHeight);
  gtk_window_set_decorated(m_wWindowMain, bDecorate);
  gtk_widget_modify_bg(m_wMain, GTK_STATE_NORMAL, &m_mapColors["color_win_bg"]);
  //gtk_widget_modify_base(m_wMain, GTK_STATE_NORMAL,
  //    &m_mapColors["color_win_bg"]);
 
  //
  // Top-Level Container.
  //
  // Each window can only have one direct descendent widget. This is it: a 
  // vertical box that will contaion all child widgets.
  //
  m_wContainer = gtk_vbox_new(FALSE, 0);
  gtk_container_add(GTK_CONTAINER(m_wMain), m_wContainer);

  //
  // The left-menu, workspace, right-menu horizontal box container
  //
  wHBox = gtk_hbox_new(FALSE, 0);
  gtk_container_set_border_width(GTK_CONTAINER(wHBox), nHBoxBorder);
  gtk_box_pack_start(GTK_BOX(m_wContainer), wHBox, FALSE, FALSE, 0);

  // 
  // Left menu vertical button box container
  //
  w = gtk_vbutton_box_new();
  gtk_button_box_set_layout(GTK_BUTTON_BOX(w), GTK_BUTTONBOX_START);
  g_object_set(G_OBJECT(w),
      "width-request", nMenuWidth,
      "height-request", nWorkspaceHeight,
      NULL);
  gtk_container_set_border_width(GTK_CONTAINER(w), 2);
  gtk_button_box_set_child_size(GTK_BUTTON_BOX(w), nMenuWidth, nMenuWidth);
  gtk_button_box_set_child_ipadding(GTK_BUTTON_BOX(w), 0, 0);
  gtk_box_set_spacing(GTK_BOX(w), 1);
  gtk_box_pack_start(GTK_BOX(wHBox), w, TRUE, TRUE, 0);
  m_wBttnMenu[getBttnMenuIdx(AlignOpLeft)] = w;

  //
  // Middle workspace vertical box container
  //
  m_wWorkspace = gtk_vbox_new(FALSE, 0);
  g_object_set(G_OBJECT(m_wWorkspace),
      "width-request", nWorkspaceWidth,
      "height-request", nWorkspaceHeight,
      NULL);
  gtk_widget_modify_bg(m_wWorkspace, GTK_STATE_NORMAL,
      &m_mapColors["color_win_bg"]);
  gtk_container_set_border_width(GTK_CONTAINER(m_wWorkspace), nWorkspaceBorder);
  gtk_box_pack_start(GTK_BOX(wHBox), m_wWorkspace, FALSE, FALSE, 0);
  m_rectWorkspace = cvRect(nMenuWidth, 0, nWorkspaceWidth, nWorkspaceHeight);
  for(i=0; i<MaxCvImages; ++i)
  {
    m_wCvImage[i]    = NULL;
    m_wCvImageBox[i] = NULL;
  }
  m_wGstWin     = NULL;

  // 
  // Right menu vertical button box container
  //
  w = gtk_vbutton_box_new();
  gtk_button_box_set_layout(GTK_BUTTON_BOX(w), GTK_BUTTONBOX_START);
  g_object_set(G_OBJECT(w),
      "width-request", nMenuWidth,
      "height-request", nWorkspaceHeight,
      NULL);
  gtk_button_box_set_child_size(GTK_BUTTON_BOX(w), nMenuWidth, nMenuWidth);
  gtk_button_box_set_child_ipadding(GTK_BUTTON_BOX(w), 0, 0);
  gtk_box_set_spacing(GTK_BOX(w), 1);
  gtk_box_pack_start(GTK_BOX(wHBox), w, TRUE, TRUE, 0);
  m_wBttnMenu[getBttnMenuIdx(AlignOpRight)] = w;

  //
  // Extra widgets vbox
  //
  m_wExtraVBox = gtk_vbox_new(FALSE, 0);
  g_object_set(G_OBJECT(m_wExtraVBox),
      "width-request", nWorkspaceWidth,
      NULL);
  gtk_box_pack_start(GTK_BOX(m_wContainer), m_wExtraVBox, FALSE, FALSE, 0);

  //
  // Bottom status.
  //
  m_wStatusFrame = gtk_frame_new(NULL);
  gtk_box_pack_start(GTK_BOX(m_wContainer), m_wStatusFrame, FALSE, FALSE, 0);
  gtk_widget_modify_bg(m_wStatusFrame, GTK_STATE_NORMAL,
      &m_mapColors["color_status_border"]);
  gtk_container_set_border_width(GTK_CONTAINER(m_wStatusFrame), 3);

  wHBox = gtk_hbox_new(FALSE, 0);
  gtk_container_add(GTK_CONTAINER(m_wStatusFrame), wHBox);

  // page reference
  m_wPageRef = gtk_label_new("");
  gtk_widget_modify_fg(m_wPageRef, GTK_STATE_NORMAL,
      &m_mapColors["color_status_fg"]);
  gtk_widget_modify_bg(m_wPageRef, GTK_STATE_NORMAL,
      &m_mapColors["color_status_bg"]);
  g_object_set(G_OBJECT(m_wPageRef),
      "width-request",  nMenuWidth,
      "height-request", nStatusBarHeight,
      NULL);
  gtk_label_set_justify(GTK_LABEL(m_wPageRef), GTK_JUSTIFY_LEFT);
  gtk_box_pack_start(GTK_BOX(wHBox), m_wPageRef, FALSE, FALSE, 4);

  // status bar
  m_wStatusBar = gtk_label_new("");
  gtk_widget_modify_fg(m_wStatusBar, GTK_STATE_NORMAL,
      &m_mapColors["color_status_fg"]);
  gtk_widget_modify_bg(m_wStatusBar, GTK_STATE_NORMAL,
      &m_mapColors["color_status_bg"]);
  g_object_set(G_OBJECT(m_wStatusBar),
      "width-request", nWorkspaceWidth-nMenuWidth,
      "height-request", nStatusBarHeight,
      NULL);
  gtk_label_set_justify(GTK_LABEL(m_wStatusBar), GTK_JUSTIFY_LEFT);
  gtk_misc_set_alignment(GTK_MISC(m_wStatusBar), 0, 0.5);
  gtk_box_pack_start(GTK_BOX(wHBox), m_wStatusBar, FALSE, FALSE, 4);

  //
  // Install event handlers
  //
  gtk_signal_connect(GTK_OBJECT(m_wMain), "key-press-event",
                     GTK_SIGNAL_FUNC(WinGtk::onKeyPress), this);


  // show window
  gtk_widget_show_all(m_wMain);
}

Member Function Documentation

bool WinGtk::addButton ( int  nBttnId, AlignOp  eAlign, GtkWidget *  wBttn  )

virtual

Add a GTK button widget to window button menu.

Parameters

nBttnId	Unique button id.
eAlign	Menu item icon alignment. See rnmpwin_align.
wBttn	Button widget.

Definition at line 568 of file WinGtk.cxx.

References findBttn(), getBttnMenuIdx(), m_mapBttns, rnr::WinGtk::BttnInfo_T::m_nBttnId, rnr::WinGtk::BttnInfo_T::m_pWin, rnr::WinGtk::BttnInfo_T::m_wBttn, m_wBttnMenu, m_wMain, onButtonClick(), and replaceButtonImage().

Referenced by addLabelButton(), show(), and wait().

{
  BttnInfo_T  info;
  int         n = getBttnMenuIdx(eAlign);

  info.m_nBttnId  = nBttnId;
  info.m_wBttn    = wBttn;
  info.m_pWin     = this;

  // add to button map
  m_mapBttns[n][nBttnId] = info;

  // bind button press event
  gtk_signal_connect(GTK_OBJECT(wBttn), "clicked",
                      GTK_SIGNAL_FUNC(onButtonClick),
                      &m_mapBttns[n][nBttnId]);

  gtk_box_pack_start(GTK_BOX(m_wBttnMenu[n]), wBttn, TRUE, TRUE, 0);

  // RDK TODO Need to center image with 1 px border to fit 5 buttons/side
  //GtkBorder bttnborder = {1,1,1,1};
  //gfloat    x, y;
  //gtk_button_set_image_position(GTK_BUTTON(wBttn), GTK_POS_RIGHT);
  gtk_button_set_alignment(GTK_BUTTON(wBttn), 0.5, 0.5);
  //g_object_set(G_OBJECT(wBttn),
  //             image-position", GTK_POS_RIGHT,
  //             "inner-border", &bttnborder,
  //             "image-spacing", 0,
  //             NULL);
  //gtk_widget_set_size_request(wBttn, 50, 50);

  // show
  gtk_widget_show(wBttn);
  gtk_widget_show(m_wMain);
  gtk_widget_queue_draw( GTK_WIDGET(wBttn) );

  return true;
}

virtual bool rnr::WinGtk::addImageButton ( int  nBttnId, AlignOp  eAlign, const std::string &  strIconPath, const std::string &  strAltText, const std::string &  strToolTip = ""  )

virtual

Add a button with an image to window button menu.

If the image fails to load, the alternate text is display instead.

Parameters

nBttnId	Window unique button id.
eAlign	Menu item icon alignment. See rnmpwin_align
strIconPath	Path to icon image file.
strAltText	Button alternate text.
strToolTip	Optional button tool tip text.

Returns

Returns true on success, false otherwise.

Implements rnr::Win.

Referenced by show(), and wait().

virtual bool rnr::WinGtk::addImageButton ( int  nBttnId, AlignOp  eAlign, void *  wBttnImg, const std::string &  strAltText, const std::string &  strToolTip = ""  )

virtual

Add a button with a GTK image widget to window button menu.

Parameters

nBttnId	Window unique button id.
eAlign	Menu item icon alignment. See rnmpwin_align
wBttnImg	Button image widget (GtkWidget *).
strAltText	Button alternate text.
strToolTip	Optional button tool tip text.

Returns

Returns true on success, false otherwise.

Implements rnr::Win.

bool WinGtk::addLabelButton ( int  nBttnId, AlignOp  eAlign, const std::string &  strLabel, const std::string &  strToolTip = ""  )

virtual

Add a button with a label to window button menu.

Parameters

nBttnId	Window unique button id.
eAlign	Menu item icon alignment. See rnmpwin_align
strLabel	Button text label.
strToolTip	Optional button tool tip text.

Returns

Returns true on success, false otherwise.

Implements rnr::Win.

Definition at line 539 of file WinGtk.cxx.

References addButton(), and m_mapColors.

Referenced by show(), and wait().

{
  GtkWidget  *wBttn;

  if( !strLabel.empty() )
  {
    wBttn = gtk_button_new_with_label(strLabel.c_str());
  }
  else
  {
    char buf[16];
    snprintf(buf, sizeof(buf), "Bttn %d", nBttnId);
    buf[sizeof(buf)-1] = 0;
    wBttn = gtk_button_new_with_label(buf);
  }

  gtk_widget_modify_bg(wBttn, GTK_STATE_NORMAL,
      &m_mapColors["color_button_bg"]);
  gtk_widget_modify_bg(wBttn, GTK_STATE_INSENSITIVE,
      &m_mapColors["color_button_bg"]);
  gtk_widget_set_tooltip_text(wBttn,
                              strToolTip.empty()? NULL: strToolTip.c_str());

  return addButton(nBttnId, eAlign, wBttn);
}

uint_t WinGtk::addWorkspaceCvImageDisplay ( void *  wContainer )

virtual

Add an OpenCV display widget to the container widget.

The container widget must be added to the window workspace by the application to keep the widget control correct.

Parameters

wContainer

Pointer to (derived) GTK_BOX container widget.

Returns

On success, returns index (handle) to CvImage instance.
On failure, returns -1.

Implements rnr::Win.

Definition at line 880 of file WinGtk.cxx.

References configureCvImage(), m_ptCvImageOrig, m_sizeCvImage, m_wCvImage, m_wCvImageBox, and rnr::Win::MaxCvImages.

Referenced by initWorkspace().

{
  GtkWidget *wBox = (GtkWidget *)wContainer;
  uint_t     i;

  for(i=0; i<MaxCvImages; ++i)
  {
    if( m_wCvImage[i] == NULL )
    {
      break;
    }
  }

  if( i >= MaxCvImages )
  {
    LOGERROR("No more CvImage displays available.");
    return -1;
  }

  // new CvImage widget
  m_wCvImage[i] = cvImageWidgetNew(CV_WINDOW_AUTOSIZE);

  // CvImage container box widget
  m_wCvImageBox[i] = wBox;

  // initial size of widget is unknown
  m_sizeCvImage[i] = cvSize(0, 0);
  m_ptCvImageOrig[i] = cvPoint(0, 0);

  // pack at the start of the container widget
  gtk_box_pack_start(GTK_BOX(m_wCvImageBox[i]), m_wCvImage[i], TRUE, TRUE, 0);

  // configure the CvImage widget
  configureCvImage(i);

  return i;
}

void WinGtk::configureCvImage ( uint_t  uImgIndex )

protectedvirtual

Configure OpenCV image widget.

Parameters

uImgIndex

Image instance.

Definition at line 971 of file WinGtk.cxx.

References m_mapColors, m_wCvImage, m_wMain, and onMouseCvImage().

Referenced by addWorkspaceCvImageDisplay(), findBttn(), and initWorkspaceAsCvImage().

{
  uint_t      i = uImgIndex;

  gtk_widget_modify_bg(m_wCvImage[i], GTK_STATE_NORMAL,
      &m_mapColors["color_image_bg"]);

  gtk_signal_connect(GTK_OBJECT(m_wCvImage[i]), "button-press-event",
                        GTK_SIGNAL_FUNC(WinGtk::onMouseCvImage), this);
  gtk_signal_connect(GTK_OBJECT(m_wCvImage[i]), "button-release-event",
                        GTK_SIGNAL_FUNC(WinGtk::onMouseCvImage), this);
  gtk_signal_connect(GTK_OBJECT(m_wCvImage[i]), "motion-notify-event",
                        GTK_SIGNAL_FUNC(WinGtk::onMouseCvImage), this);

  gtk_widget_show(m_wCvImage[i]);
  gtk_widget_show(m_wMain);
  gtk_widget_queue_draw(GTK_WIDGET(m_wCvImage[i]));
}

void WinGtk::eraseWorkspace ( )

virtual

Remove all widgets contained in the window's workspace container.

Note

A widget is actually destroyed iff there are no references to the widget.

Implements rnr::Win.

Definition at line 930 of file WinGtk.cxx.

References m_wCvImage, m_wCvImageBox, m_wWorkspace, rnr::Win::MaxCvImages, and onRemoveWidget().

Referenced by initWorkspaceAsCvImage(), initWorkspaceAsGstWin(), initWorkspaceAsGtk(), and showWorkspace().

{
  int   i;

  gtk_container_foreach(GTK_CONTAINER(m_wWorkspace),
                        WinGtk::onRemoveWidget,
                        m_wWorkspace);

  for(i=0; i<MaxCvImages; ++i)
  {
    m_wCvImage[i]     = NULL;
    m_wCvImageBox[i]  = NULL;
  }
}

bool rnr::WinGtk::findBttn ( int  nBttnId, MapBttns_T::iterator &  pos  )

inlineprotected

Find button.

Parameters

nBttnId	Unique button id.
pos	Position iterator. Set to end(), if no button found.

Returns

Returns true if button found, false otherwise.

Definition at line 578 of file WinGtk.h.

References configureCvImage(), convertLookAndFeelDefaults(), onAlarm(), onButtonClick(), onKeyPress(), onMouseCvImage(), onRealizeGstWin(), and onRemoveWidget().

Referenced by addButton(), replaceButtonLabel(), and showButtonState().

    {
      if( (pos = m_mapBttns[0].find(nBttnId)) == m_mapBttns[0].end() )
      {
        if( (pos = m_mapBttns[1].find(nBttnId)) == m_mapBttns[1].end() )
        {
          return false;
        }
      }
      return true;
    }

int rnr::WinGtk::getBttnMenuIdx ( AlignOp  eAlign )

inlineprotected

Get button menu index from alignment enum.

Parameters

eAlign

Alignment enumuration.

Returns

Menu index.

Definition at line 565 of file WinGtk.h.

References rnr::AlignOpRight.

Referenced by addButton(), and WinGtk().

    {
      return eAlign == AlignOpRight? 1: 0;
    }

GtkWidget* rnr::WinGtk::getExtraVBox ( )

inline

Get the window's workspace extra vertical box container widget.

This widget is between the worksapce vertical box and the status line and is contained within the workspace. It is only visible if the application adds gui elements to it.

Returns

Pointer to GtkVBox widget.

Definition at line 500 of file WinGtk.h.

References m_wExtraVBox.

    {
      return m_wExtraVBox;
    }

GtkWidget* rnr::WinGtk::getGstWin ( )

inline

Get GStreamer X-Window widget.

Returns

Pointer to GStreamer bound widget.

Definition at line 510 of file WinGtk.h.

References m_wGstWin.

    {
      return m_wGstWin;
    }

virtual const char* rnr::WinGtk::getGuiToolkitName ( )

inlinevirtual

Get GUI toolkit name.

Returns

GUI toolkit identifier string.

Reimplemented from rnr::Win.

Definition at line 116 of file WinGtk.h.

References setLookAndFeel().

    {
      return "gtk+";
    }

virtual PangoFontDescription* rnr::WinGtk::getLookAndFeelFont ( const std::string &  strKey )

inlinevirtual

Get the GUI look and feel Pango font description.

Parameters

strKey

Key.

Returns

Pointer to pango font description value.

Definition at line 156 of file WinGtk.h.

References m_mapFonts.

    {
      if( m_mapFonts.find(strKey) != m_mapFonts.end() )
      {
        return m_mapFonts[strKey];
      }
      else
      {
        return m_mapFonts["color_rn_black"];
      }
    }

virtual GdkColor* rnr::WinGtk::getLookAndFeelGdkColor ( const std::string &  strKey )

inlinevirtual

Get the GUI look and feel GDK color.

Parameters

strKey

Key.

Returns

Pointer to GDK color value.

Definition at line 137 of file WinGtk.h.

References m_mapColors.

    {
      if( m_mapColors.find(strKey) != m_mapColors.end() )
      {
        return &m_mapColors[strKey];
      }
      else
      {
        return &m_mapColors["color_rn_black"];
      }
    }

GtkWidget* rnr::WinGtk::getMainWidget ( )

inline

Get the top-level main widget.

Returns

Pointer to widget.

Definition at line 466 of file WinGtk.h.

References m_wMain.

    {
      return m_wMain;
    }

GtkWindow* rnr::WinGtk::getMainWindowWidget ( )

inline

Get the top-level main window.

Returns

Pointer to window widget.

Definition at line 476 of file WinGtk.h.

References m_wWindowMain.

    {
      return m_wWindowMain;
    }

GtkWidget* rnr::WinGtk::getWorkspaceVBox ( )

inline

Get the window's workspace top vertical box container widget.

Returns

Pointer to GtkVBox widget.

Definition at line 486 of file WinGtk.h.

References m_wWorkspace.

    {
      return m_wWorkspace;
    }

virtual void rnr::WinGtk::initWorkspace ( )

inlinevirtual

Initialize window's workspace to hold a GTK toolkit widget tree.

All previous gui elements are erased.

Implements rnr::Win.

Definition at line 377 of file WinGtk.h.

References addWorkspaceCvImageDisplay(), initWorkspaceAsCvImage(), initWorkspaceAsGstWin(), initWorkspaceAsGtk(), and removeWorkspaceCvImageDisplay().

    {
      initWorkspaceAsGtk();
    }

uint_t WinGtk::initWorkspaceAsCvImage ( )

virtual

Initialize the workspace as a display to show OpenCV images.

This is a convinience function to use if only one image widget is contained in the workspace.

Alternately, for a mixed workspace of GTK widgets and up to MaxCvImages(4) OpenCV images, the follow functions are available:

initWorkspace() or initWorkSpaceAsGtk()
addWorkspaceCvImageDisplay()

Use

showCvImage() 

to display an OpenCv image.

All previous gui elements are erased.

Returns

Index (handle) to CvImage widget instance.

Implements rnr::Win.

Definition at line 800 of file WinGtk.cxx.

References configureCvImage(), eraseWorkspace(), m_ptCvImageOrig, rnr::Win::m_rectWorkspace, m_sizeCvImage, m_wCvImage, m_wCvImageBox, and m_wWorkspace.

Referenced by initWorkspace().

{
  GtkWidget        *wAlign;
  
  // remove any old workspace widgets
  eraseWorkspace();

  // new CvImage widget
  m_wCvImage[0] = cvImageWidgetNew(CV_WINDOW_AUTOSIZE);

  // CvImage container box widget
  m_wCvImageBox[0] = m_wWorkspace;

  // center-top alignment
  wAlign = gtk_alignment_new(0.5, 0.0, 0, 0);
  gtk_box_pack_start(GTK_BOX(m_wWorkspace), wAlign, TRUE, TRUE, 0);
  
  // CvImage container box widget
  m_wCvImageBox[0] = gtk_hbox_new(FALSE, 0);
  gtk_container_add(GTK_CONTAINER(wAlign), m_wCvImageBox[0]);
  
  // initial size of widget is the size of the workspace
  m_sizeCvImage[0] = cvSize(m_rectWorkspace.width, m_rectWorkspace.height);

  // initial origin
  m_ptCvImageOrig[0] = cvPoint(0, 0);

  // pack at the start of the container widget
  gtk_box_pack_start(GTK_BOX(m_wCvImageBox[0]), m_wCvImage[0], TRUE, TRUE, 0);

  // configure the CvImage widget
  configureCvImage(0);

  // force show
  gtk_widget_show_all(m_wWorkspace);

  return 0;
}

void WinGtk::initWorkspaceAsGstWin ( const cv::Size &  sizeVidWin )

virtual

Initialize the workspace as a window display to show GStreamer video/images.

GStreamer automatically displays video/images via the GTK callback mechanism, so no show function is required.

This is a convinience function to use if only one stream is contained in the workspace.

All previous gui elements are erased.

Implements rnr::Win.

Definition at line 839 of file WinGtk.cxx.

References eraseWorkspace(), m_mapColors, rnr::Win::m_uGstWinXid, m_wGstWin, m_wWorkspace, onRealizeGstWin(), and showWorkspace().

Referenced by initWorkspace().

{
  // remove any old workspace widgets
  eraseWorkspace();

  //---
  // Video window
  //---
  m_wGstWin = gtk_drawing_area_new();
  g_object_set(G_OBJECT(m_wGstWin),
      "width-request",  sizeVidWin.width,
      "height-request", sizeVidWin.height,
      NULL);
  gtk_widget_modify_bg(m_wGstWin, GTK_STATE_NORMAL,
      &m_mapColors["color_win_bg"]);
  gtk_widget_modify_bg(m_wGstWin, GTK_STATE_ACTIVE,
      &m_mapColors["color_win_bg"]);
  gtk_widget_modify_bg(m_wGstWin, GTK_STATE_SELECTED,
      &m_mapColors["color_win_bg"]);
  g_signal_connect(m_wGstWin, "realize", G_CALLBACK(onRealizeGstWin), this);
  gtk_widget_set_double_buffered(m_wGstWin, FALSE);
  gtk_box_pack_start(GTK_BOX(m_wWorkspace), m_wGstWin, FALSE, FALSE, 0);

  //---
  // Show
  //---
  showWorkspace();

  //
  // Realize the window now so that the video window gets created and we can
  // obtain its XID before the pipeline is started up and the videosink
  // asks for the XID of the window to render onto.
  //
  gtk_widget_realize(m_wGstWin);

  if( m_uGstWinXid == 0 )
  {
    LOGERROR("Cannot determine xid.");
  }
}

void WinGtk::initWorkspaceAsGtk ( )

virtual

Initialize window's workspace to hold a GTK widget tree.

All previous gui elements are erased.

Definition at line 794 of file WinGtk.cxx.

References eraseWorkspace().

Referenced by initWorkspace().

{
  // remove all workspace widgets - nothing else required
  eraseWorkspace();
}

gboolean WinGtk::onAlarm ( gpointer  user_data )

staticprotected

Timeout expiry callback handler.

The supplied user data is set to 1 (true).

Parameters

user_data

Pointer to user supplied expiry flag.

Returns

Returns FALSE.

Definition at line 996 of file WinGtk.cxx.

Referenced by findBttn(), wait(), waitKey(), and waitMouse().

{
  *(int *)user_data = 1;
  return FALSE;
}

void WinGtk::onButtonClick ( GtkWidget *  w, gpointer *  user_data  )

staticprotected

Button press event handler.

If registered, the application callback function will be called.

Parameters

w	Button widget.
user_data	Button information

Definition at line 1127 of file WinGtk.cxx.

References rnr::Win::m_bMouseEvent, rnr::Win::m_dataBttnCb, rnr::Win::m_funcBttnCb, rnr::WinGtk::BttnInfo_T::m_nBttnId, and rnr::WinGtk::BttnInfo_T::m_pWin.

Referenced by addButton(), and findBttn().

{
  WinGtk::BttnInfo_T *pInfo = (WinGtk::BttnInfo_T *)user_data;

  if( pInfo->m_pWin->m_funcBttnCb != NULL )
  {
    pInfo->m_pWin->m_bMouseEvent = true;
    pInfo->m_pWin->m_funcBttnCb(pInfo->m_nBttnId, pInfo->m_pWin->m_dataBttnCb);
  }
}

gboolean WinGtk::onKeyPress ( GtkWidget *  w, GdkEventKey *  event, gpointer *  user_data  )

staticprotected

Keyboard press event callback handler.

If registered, the application callback function will be called.

Parameters

w	Widget where keyboard event occurred.
event	Keyboard event.
user_data	Supplied user data (this).

Returns

Returns FALSE.

Definition at line 1002 of file WinGtk.cxx.

References rnr::Win::m_dataKeyCb, rnr::Win::m_funcKeyCb, and rnr::Win::m_uLastKey.

Referenced by findBttn(), and WinGtk().

{
  WinGtk *pWin = (WinGtk *)user_data;

  int code = 0;

  switch( event->keyval )
  {
    case GDK_Escape:
      code = 27;
      break;
    case GDK_Return:
    case GDK_Linefeed:
      code = '\n';
      break;
    case GDK_Tab:
      code = '\t';
      break;
    default:
      code = event->keyval;
      break;
  }

  pWin->m_uLastKey = (code & 0xffff) | (event->state << 16);

  if( pWin->m_funcKeyCb )
  {
    pWin->m_funcKeyCb(code, event->state, pWin->m_dataKeyCb);
  }

  return FALSE;
}

gboolean WinGtk::onMouseCvImage ( GtkWidget *  w, GdkEventKey *  event, gpointer *  user_data  )

staticprotected

Mouse event on OpenCV Image widget workspace callback handler.

The workspace must be set as an CvImage workspace.

If registered, the application callback function will be called.

The pixel coordinates are contrained to any shown OpenCv image with the origin at the image origin. Mouse events outside the image return nopoint().

Parameters

w	CvImage widget where mouse event occurred.
event	Mouse event.
user_data	Supplied user data (this).

Returns

Returns FALSE.

Definition at line 1037 of file WinGtk.cxx.

References rnr::Win::m_bMouseEvent, rnr::Win::m_dataMouseCb, rnr::Win::m_funcMouseCb, m_sizeCvImage, m_wCvImage, and rnr::Win::MaxCvImages.

Referenced by configureCvImage(), and findBttn().

{
  WinGtk *pWin = (WinGtk *)user_data;

  CvPoint2D32f  pt32f = {-1., -1.};
  CvPoint       pt = {-1,-1};
  int           cv_event = -1;
  int           state = 0;
  uint_t        i;

  if( event->type == GDK_MOTION_NOTIFY )
  {
    GdkEventMotion* event_motion = (GdkEventMotion*)event;

    cv_event = CV_EVENT_MOUSEMOVE;
    pt32f.x = cvRound(event_motion->x);
    pt32f.y = cvRound(event_motion->y);
    state = event_motion->state;
  }

  else if( event->type == GDK_BUTTON_PRESS ||
           event->type == GDK_BUTTON_RELEASE ||
           event->type == GDK_2BUTTON_PRESS )
  {
    GdkEventButton* event_button = (GdkEventButton*)event;

    pt32f.x = cvRound(event_button->x);
    pt32f.y = cvRound(event_button->y);

    if( event_button->type == GDK_BUTTON_PRESS )
    {
      cv_event = event_button->button == 1 ? CV_EVENT_LBUTTONDOWN :
                 event_button->button == 2 ? CV_EVENT_MBUTTONDOWN :
                 event_button->button == 3 ? CV_EVENT_RBUTTONDOWN : 0;
    }
    else if( event_button->type == GDK_BUTTON_RELEASE )
    {
      cv_event = event_button->button == 1 ? CV_EVENT_LBUTTONUP :
                 event_button->button == 2 ? CV_EVENT_MBUTTONUP :
                 event_button->button == 3 ? CV_EVENT_RBUTTONUP : 0;
    }
    else if( event_button->type == GDK_2BUTTON_PRESS )
    {
      cv_event = event_button->button == 1 ? CV_EVENT_LBUTTONDBLCLK :
                 event_button->button == 2 ? CV_EVENT_MBUTTONDBLCLK :
                 event_button->button == 3 ? CV_EVENT_RBUTTONDBLCLK : 0;
    }

    state = event_button->state;
  }

  if( cv_event >= 0 )
  {
    pt = cvPointFrom32f(pt32f);

    //dbgpoint("mouse", pt);
    
    int flags = (state & GDK_SHIFT_MASK ? CV_EVENT_FLAG_SHIFTKEY : 0) |
        (state & GDK_CONTROL_MASK ? CV_EVENT_FLAG_CTRLKEY : 0) |
        (state & (GDK_MOD1_MASK|GDK_MOD2_MASK) ? CV_EVENT_FLAG_ALTKEY : 0) |
        (state & GDK_BUTTON1_MASK ? CV_EVENT_FLAG_LBUTTON : 0) |
        (state & GDK_BUTTON2_MASK ? CV_EVENT_FLAG_MBUTTON : 0) |
        (state & GDK_BUTTON3_MASK ? CV_EVENT_FLAG_RBUTTON : 0);

    for(i=0; i<MaxCvImages; ++i)
    {
      if( (pWin->m_wCvImage[i] == NULL) || (pWin->m_funcMouseCb[i] == NULL) )
      {
        continue;
      }

      //pt.x -= pWin->m_ptCvImageOrig[i].x;
      //pt.y -= pWin->m_ptCvImageOrig[i].y;
      
      if( (pt.x >= 0) && (pt.x < pWin->m_sizeCvImage[i].width) ||
          (pt.y >= 0) && (pt.y < pWin->m_sizeCvImage[i].height) )
      {
        pWin->m_bMouseEvent = true;
        pWin->m_funcMouseCb[i](cv_event, pt.x, pt.y, flags,
                                pWin->m_dataMouseCb[i]);
        break;
      }
    }
  }

  return FALSE;
}

void WinGtk::onRealizeGstWin ( GtkWidget *  w, gpointer  user_data  )

staticprotected

Realize GStreamer video window callback.

Once the window has been realized, the X-Window id can be obtained. The id is critical for rendering gst video and images to the gtk widget.

Parameters

w	Gtk draw widget where video will be overlaied.
user_data	Supplied user data (this).

Definition at line 1138 of file WinGtk.cxx.

References rnr::Win::m_uGstWinXid, and m_wGstWin.

Referenced by findBttn(), and initWorkspaceAsGstWin().

{
  WinGtk *pWin = (WinGtk *)user_data;

#if GTK_CHECK_VERSION(2,18,0)
  //
  // I copied this code. Kept it for meta-pedagogical reasons.
  //
  // This is here just for pedagogical purposes, GDK_WINDOW_XID will call
  // it as well in newer Gtk versions.
  //
  if( !gdk_window_ensure_native(w->window) )
  {
    LOGERROR("Couldn't create native window needed for GstXOverlay!");
  }
#endif

#ifdef GDK_WINDOWING_X11
  pWin->m_uGstWinXid = GDK_WINDOW_XID(gtk_widget_get_window(pWin->m_wGstWin));
#endif
}

void WinGtk::onRemoveWidget ( GtkWidget *  w, gpointer  user_data  )

staticprotected

Remove widget callback handler.

Parameters

w	Widget to be removed.
user_data	Any supplied callback data (parent container widget).

Definition at line 990 of file WinGtk.cxx.

Referenced by eraseWorkspace(), and findBttn().

{
  GtkWidget *wContainer = (GtkWidget *)user_data;
  gtk_container_remove(GTK_CONTAINER(wContainer), w);
}

bool WinGtk::removeButton ( int  nBttnId )

virtual

Remove a button from a menu.

Parameters

nBttnId

Unique button id.

Returns

Returns true if button is removed, false otherwise.

Implements rnr::Win.

Definition at line 696 of file WinGtk.cxx.

References m_mapBttns, m_wBttnMenu, and m_wMain.

Referenced by show().

{
  MapBttns_T::iterator  pos;
  int                   n;
  GtkWidget            *wBttn;

  if( (pos = m_mapBttns[0].find(nBttnId)) != m_mapBttns[0].end() )
  {
    n = 0;
  }
  else if( (pos = m_mapBttns[1].find(nBttnId)) != m_mapBttns[1].end() )
  {
    n = 1;
  }
  else
  {
    return false;
  }

  wBttn = pos->second.m_wBttn;

  // 
  // Replace any exiting button image with NULL or the image widget is hosed
  // for reuse.
  //
  gtk_button_set_image(GTK_BUTTON(wBttn), NULL);

  // remove widget from gui
  gtk_container_remove(GTK_CONTAINER(m_wBttnMenu[n]), wBttn);

  // remove widget from map
  m_mapBttns[n].erase(pos);

  // redraw
  gtk_widget_show(m_wMain);

  return true;
}

void WinGtk::removeWorkspaceCvImageDisplay ( uint_t  uImgIndex )

virtual

Remove OpenCV display widget from workspace.

Parameters

uImgIndex

Image instance.

Implements rnr::Win.

Definition at line 918 of file WinGtk.cxx.

References m_wCvImage, m_wCvImageBox, and rnr::Win::MaxCvImages.

Referenced by initWorkspace().

{
  // remove (and destroy) old CvImage widget
  if( (uImgIndex < MaxCvImages) && (m_wCvImage[uImgIndex] != NULL) )
  {
    gtk_container_remove(GTK_CONTAINER(m_wCvImageBox[uImgIndex]),
                                      m_wCvImage[uImgIndex]);
    m_wCvImage[uImgIndex]     = NULL;
    m_wCvImageBox[uImgIndex]  = NULL;
  }
}

virtual bool rnr::WinGtk::replaceButtonImage ( int  nBttnId, const std::string &  strIconPath, const std::string &  strToolTip = ""  )

virtual

Replace existing button image with new image.

Parameters

nBttnId	Unique button id.
strIconPath	Path to icon image file.
strToolTip	Optional button tool tip text. If empty, then the current tooltip, if any, is used.

Returns

Returns true if button image is replaced, false otherwise.

Implements rnr::Win.

Referenced by addButton(), and show().

virtual bool rnr::WinGtk::replaceButtonImage ( int  nBttnId, void *  wBttnImg, const std::string &  strToolTip = ""  )

virtual

Replace existing button image with new GTK image widget.

Parameters

nBttnId	Unique button id.
wBttnImg	New button image widget (GtkWidget *).
strToolTip	Optional button tool tip text. If empty, then the current tooltip, if any, is used.

Returns

Returns true if button image is replaced, false otherwise.

Implements rnr::Win.

bool WinGtk::replaceButtonLabel ( int  nBttnId, const std::string &  strLabel, const std::string &  strToolTip = ""  )

virtual

Replace existing button label with new label.

Parameters

nBttnId	Unique button id.
strLabel	Button text label.
strToolTip	Optional button tooltip text. If empty, then the current tooltip, if any, is used.

Returns

Returns true if button label is replaced, false otherwise.

Implements rnr::Win.

Definition at line 670 of file WinGtk.cxx.

References findBttn(), and m_wMain.

Referenced by show().

{
  MapBttns_T::iterator  pos;
  GtkWidget            *wBttn;

  if( !findBttn(nBttnId, pos) )
  {
    return false;
  }

  wBttn = pos->second.m_wBttn;

  gtk_button_set_label(GTK_BUTTON(wBttn), strLabel.c_str());

  gtk_widget_set_tooltip_text(wBttn,
                              strToolTip.empty()? NULL: strToolTip.c_str());

  // redraw
  gtk_widget_show(wBttn);
  gtk_widget_show(m_wMain);

  return true;
}

void WinGtk::setLookAndFeel ( const std::string &  strKey, const std::string &  strVal  )

virtual

Set GUI look and feel value.

Parameters

strKey	Key.
strVal	Value.

Reimplemented from rnr::Win.

Definition at line 276 of file WinGtk.cxx.

References m_mapBttns, m_mapColors, m_mapFonts, m_wMain, m_wPageRef, m_wStatusBar, m_wStatusFrame, m_wWorkspace, rnr::Win::NumOfButtonMenus, rnr::Win::setLookAndFeel(), and showWorkspace().

Referenced by getGuiToolkitName().

{
  GdkColor              color;
  PangoFontDescription *pFont;

  Win::setLookAndFeel(strKey, strVal);

  if( strKey.find("color") == 0 )
  {
    gdk_color_parse(strVal.c_str(), &color);
    m_mapColors[strKey] = color;

    if( strKey == "color_win_bg" )
    {
      gtk_widget_modify_bg(m_wMain, GTK_STATE_NORMAL, &color);
      gtk_widget_modify_base(m_wMain, GTK_STATE_NORMAL, &color);
      gtk_widget_modify_bg(m_wWorkspace, GTK_STATE_NORMAL, &color);
    }
    else if( strKey == "color_status_fg" )
    {
      gtk_widget_modify_fg(m_wPageRef, GTK_STATE_NORMAL, &color);
      gtk_widget_modify_fg(m_wStatusBar, GTK_STATE_NORMAL, &color);
    }
    else if( strKey == "color_status_bg" )
    {
    }
    else if( strKey == "color_status_border" )
    {
      gtk_widget_modify_bg(m_wStatusFrame, GTK_STATE_NORMAL, &color);
    }
    else if( strKey == "color_button_bg" )
    {
      for(size_t i=0; i<NumOfButtonMenus; ++i)
      {
        for(size_t j=0; j<m_mapBttns[i].size(); ++i)
        {
          gtk_widget_modify_bg(m_mapBttns[i][j].m_wBttn, GTK_STATE_NORMAL,
              &color);
          gtk_widget_modify_bg(m_mapBttns[i][j].m_wBttn, GTK_STATE_INSENSITIVE,
              &color);
        }
      }
    }
  }

  else if( strKey.find("font") == 0 )
  {
    pFont = pango_font_description_from_string(strVal.c_str());
    m_mapFonts[strKey] = pFont;
  }

  showWorkspace();
}

bool WinGtk::showButtonState ( int  nBttnId, WidgetState  eBttnState  )

virtual

Show a button's widget state.

Parameters

nBttnId	Unique button id.
eBttnState	New button state. See rnmpwin_itemstate.

Returns

Returns true if button state set, false otherwise.

Implements rnr::Win.

Definition at line 763 of file WinGtk.cxx.

References findBttn(), rnr::WidgetStateActive, rnr::WidgetStateDisabled, and rnr::WidgetStateNormal.

Referenced by show().

{
  MapBttns_T::iterator  pos;

  if( !findBttn(nBttnId, pos) )
  {
    return false;
  }

  switch( eBttnState )
  {
    case WidgetStateNormal:
      gtk_widget_set_sensitive(pos->second.m_wBttn, TRUE);
      gtk_widget_set_state(pos->second.m_wBttn, GTK_STATE_NORMAL);
      break;
    case WidgetStateActive:
      gtk_widget_set_sensitive(pos->second.m_wBttn, TRUE);
      gtk_widget_set_state(pos->second.m_wBttn, GTK_STATE_ACTIVE);
      break;
    case WidgetStateDisabled:
      gtk_widget_set_sensitive(pos->second.m_wBttn, FALSE);
      break;
    default:
      return false;
  }

  gtk_widget_show_all(pos->second.m_wBttn);

  return true;
}

void WinGtk::showCvImage ( cv::Mat &  img, uint_t  uImgIndex = 0  )

virtual

Show a OpenCV image on the workspace.

The workspace must contain a CvImage prior to calling this function.

Parameters

pImg	Pointer to image.
uImgIndex	Image instance.

Implements rnr::Win.

Definition at line 331 of file WinGtk.cxx.

References m_ptCvImageOrig, rnr::Win::m_rectWorkspace, m_sizeCvImage, m_wCvImage, and rnr::Win::MaxCvImages.

Referenced by show().

{
  if( (uImgIndex < MaxCvImages) && (m_wCvImage[uImgIndex] != NULL) )
  {
    uint_t  i = uImgIndex;

    cvImageWidgetSetImage((CvImageWidget *)m_wCvImage[i], &img);
    m_sizeCvImage[i] = Size(img.cols, img.rows);
    m_ptCvImageOrig[i].x = (m_rectWorkspace.width - m_sizeCvImage[i].width) / 2;
    m_ptCvImageOrig[i].y = (m_rectWorkspace.height - m_sizeCvImage[i].height)/2;
    if( m_ptCvImageOrig[i].x < 0 )
    {
      m_ptCvImageOrig[i].x = 0;
    }
    if( m_ptCvImageOrig[i].y < 0 )
    {
      m_ptCvImageOrig[i].y = 0;
    }
    gtk_widget_show(m_wCvImage[i]);
  }
  else
  {
    LOGERROR("Workspace has no CvImage[%u] widget.", uImgIndex);
  }
}

void WinGtk::showPageRef ( int  nPageId )

virtual

Show page reference number.

Parameters

nPageRef

Page reference number.

Implements rnr::Win.

Definition at line 357 of file WinGtk.cxx.

References m_wPageRef.

Referenced by show().

{
  char        buf[16];

  // format status text
  snprintf(buf, sizeof(buf), "%d", nPageRef);
  buf[sizeof(buf)-1] = 0;

  gtk_label_set_text(GTK_LABEL(m_wPageRef), buf);
  gtk_widget_show(m_wPageRef);
}

virtual void rnr::WinGtk::showPageRef ( const std::string &  strPageRef )

virtual

Show page reference.

Parameters

strPageRef

Page reference string.

Implements rnr::Win.

void WinGtk::showStatus ( const char *  sFmt,   ...  )

virtual

Show status message.

Parameters

sFmt	Format string.
...	Variable arguments.

Implements rnr::Win.

Definition at line 378 of file WinGtk.cxx.

References m_wStatusBar.

Referenced by show().

{
  char        buf[256];
  va_list     ap;  

  // format status text
  va_start(ap, sFmt);
  vsnprintf(buf, sizeof(buf), sFmt, ap);
  buf[sizeof(buf)-1] = 0;
  va_end(ap);

  gtk_label_set_text(GTK_LABEL(m_wStatusBar), buf);
  gtk_widget_show(m_wStatusBar);
}

void WinGtk::wait ( int  delay )

virtual

Wait for timeout.

GTK widgets can be updated during this wait.

Parameters

delay

Timeout delay in millseconds > 0.

Implements rnr::Win.

Definition at line 464 of file WinGtk.cxx.

References addButton(), addImageButton(), addLabelButton(), m_mapColors, and onAlarm().

Referenced by show().

{
  int expired = 0;
  guint timer = 0;

  // causes an infinite block
  if( delay <= 0 )
  {
    return;
  }

  timer = g_timeout_add(delay, WinGtk::onAlarm, &expired);

  while( gtk_main_iteration_do(FALSE) && !expired );
}

int WinGtk::waitKey ( int  delay )

virtual

Wait for keypress or timeout.

GTK widgets can be updated during this wait.

Parameters

delay

Timeout delay in millseconds. Set to 0 for no timeout.

Returns

Returns code of last key pressed or -1 if timed out.

Implements rnr::Win.

Definition at line 402 of file WinGtk.cxx.

References rnr::Win::m_uLastKey, and onAlarm().

Referenced by show().

{
  int     expired = 0;
  guint   timer = 0;
  int     key;

  // set alarm timer
  if( delay > 0 )
  {
    timer = g_timeout_add(delay, WinGtk::onAlarm, &expired);
  }

  // wait for keyboard press
  while( gtk_main_iteration_do(FALSE) &&
         (m_uLastKey == 0) &&
         !expired );

  // got a keyboard press
  if( !expired )
  {
    // cancel timer
    if( delay > 0 )
    {
      g_source_remove(timer);
    }
    key = (int)m_uLastKey;
    m_uLastKey = 0;
  }

  // expired without keyboard event
  else
  {
    key = -1;
  }

  return key;
}

void WinGtk::waitMouse ( int  delay )

virtual

Wait for timeout or registered mouse event.

Window widgets can be updated during this wait.

Parameters

delay

Timeout delay in millseconds > 0.

Implements rnr::Win.

Definition at line 440 of file WinGtk.cxx.

References rnr::Win::m_bMouseEvent, and onAlarm().

Referenced by show().

{
  int expired = 0;
  guint timer = 0;

  // causes an infinite block
  if( delay <= 0 )
  {
    return;
  }

  timer = g_timeout_add(delay, WinGtk::onAlarm, &expired);

  m_bMouseEvent = false;

  while( gtk_main_iteration_do(FALSE) && !expired && !m_bMouseEvent );

  if( !expired )
  {
    m_bMouseEvent = false;
    g_source_remove(timer);
  }
}

---

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

• include/rnr/appkit/WinGtk.h
• sw/librnr_wingtk/WinGtk.cxx