Node: Other Functions, Previous: Gradient Functions, Up: Miscellaneous Functions



Other Functions

sync-server Function
Flush all pending X requests, don't wait for them to finish.

send-client-message window type data format Function
Send an X ClientMessage event to window (a window object, the symbol root or a numeric xid).

The event will be of the type type (a symbol), contain the array of integers data (i.e. a vector or a string), and will be transferred as format sized quantities (8, 16 or 32).

create-window parent x y width height Function
Create an unmapped window that is a child of parent (a window object, an integer window id, or the symbol root), with the specified dimensions.

Returns the window id of the new window.

exit-type Function
If Sawfish is shutting down, this function returns one of the strings "user-quit", "user-restart" or "session-quit". If Sawfish is not shutting down, it returns nil.

x-atom symbol Function
Return the integer identifying the X atom with the same name as symbol.

x-atom-name integer Function
Return the symbol with the same name as the X atom identified by the integer integer.

canonical-display-name Variable
A string containing the canonical name of the X display. This includes the full host name and the screen number. For example: "foo.bar.com:0.0".

display-name Variable
A string containing the name of the X display, exactly as passed to Sawfish. For example: ":0", or "foo:0.0".

saved-command-line-args Variable
Holds a list of all of the command line arguments (including the executable name).

sawfish-directory Variable
The home directory for Sawfish files. For example: "/usr/share/sawfish".

sawfish-exec-directory Variable
The directory for architechture-specific Sawfish executables. For example: "/usr/lib/sawfish/1.3/i386-pc-linux-gnu".

sawfish-lisp-lib-directory Variable
The top-level directory for Sawfish lisp files. For example: "/usr/share/sawfish/1.3/lisp".

sawfish-locale-directory Variable
The system directory where Sawfish can find locale files. This is not part of the Sawfish distribution. For example: "/usr/share/locale".

sawfish-site-lisp-directory Variable
The top-level directory for site-specific Sawfish lisp files. For example: "/usr/share/sawfish/site-lisp".

sawfish-version Variable
The version number of the running Sawfish.

primitive-play-sample filename Function
Plays the sound file filename (which must be a string).

call-with-error-handler thunk Function
Call the zero-parameter function thunk. If an error occurs, trap it and pass its car and cdr to error-handler-function.

load-module name Function
Ensure that module name has been loaded. This does not import its bindings or make them accessible.

eval-in form struct-name Function
Evaluates form in the structure named by struct-name. Compare this with eval, which takes a structure object as its second parameter, not a structure name.

*user-module* Variable
*user-module* is the default module for human interaction with Sawfish.

user-eval form Function
user-require feature Function
user-eval evaluates form in *user-module*. user-require evaluates (require feature) in *user-module*.

quote-menu-item string Function
Escape any _ characters in string such that the result can be used as the label of a menu item.

make-directory-recursively dir Function
Create directory dir. Any missing parent directories will also be created.

locate-file filename dirs Function
Search for a file filename in any of the directories named by the list of strings dirs.

clamp x lower upper Function
Return x clamped between lower and upper. If x is less than lower, return lower; if it is larger than upper return upper. Otherwise return x.

clamp* x y lower upper Function
Return the interval (x, x+w) clamped between lower and upper. If x is less than lower, return lower. If x+w is larger than upper, return upper-w; this is a value of x that satisfies the upper bound, although it may violate the lower bound. Otherwise return x.

uniquify-list lst Function
Remove all duplicates values from lst, using eq. The order of elements is not preserved.