Various Utility functions

Misc useful functions used by various parts of matchbox. More...

Functions
int	mb_exec (const char *cmd)
	Exec a command similar to how a shell would, mainly passing quotes.
Window	mb_single_instance_get_window (Display *dpy, const char *bin_name)
	Get window ID of app with specified binary name.
Bool	mb_single_instance_is_starting (Display *dpy, const char *bin_name)
	Test to see if an app is in 'startup' phase.
char *	mb_util_get_homedir (void)
	Safely returns the current HOME directory or /tmp if not set.
void	mb_util_window_activate (Display *dpy, Window win)
	Raise/Activate an existing window.
Pixmap	mb_util_get_root_pixmap (Display *dpy)
	Get root pixmap if set.
char *	mb_util_get_theme_full_path (const char *theme_name)
	Get a full theme path from its name.
void	mb_util_animate_startup (Display *dpy, int x, int y, int width, int height)
	XXX To document XXX.

---

Detailed Description

Misc useful functions used by various parts of matchbox.

---

Function Documentation

int mb_exec (  const char *  cmd  )

Exec a command similar to how a shell would, mainly passing quotes. Parameters: cmd  command string. Returns: exec() result

Window mb_single_instance_get_window (  Display *  dpy, const char *  bin_name )

Get window ID of app with specified binary name. Parameters: dpy  X11 Display bin_name  name of executable ( argv[0] ) Returns: X11 window ID or None if not found.

Bool mb_single_instance_is_starting (  Display *  dpy, const char *  bin_name )

Test to see if an app is in 'startup' phase. Parameters: dpy  X11 Display bin_name  name of executable ( argv[0] ) Returns: True / False

char* mb_util_get_homedir (  void   )

Safely returns the current HOME directory or /tmp if not set. You should not free the value returned. Returns: home directory or /tmp if not set

Pixmap mb_util_get_root_pixmap (  Display *  dpy  )

Get root pixmap if set. Parameters: dpy  X11 Display Returns: Pixmap of root window or None if not set.

char* mb_util_get_theme_full_path (  const char *  theme_name  )

Get a full theme path from its name. The function allocates memory for the returned data, this should be freed by the caller. Parameters: theme_name  Theme name. Returns: full pull to theme directory or NULL

void mb_util_window_activate (  Display *  dpy, Window  win )

Raise/Activate an existing window. Parameters: dpy  X11 Display win  Window ID to 'activate'

---