Main Page | Modules | Directories | File List

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'


Generated on Tue Jan 11 08:51:10 2005 for LibMB by  doxygen 1.4.0