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 Mar 25 11:24:01 2008 for LibMB by  doxygen 1.5.5