[Copyright status: this file is in the public domain.]

liblx provides various convenience routines.  This file describes those
which aren't documented elsewhere.

lx_lookup_color, lx_lookup_color_rgb
---------------  -------------------

LX_OP *lx_lookup_color(
	LX_CONN *conn, LX_XID cmap,
	const char *name, int len,
	unsigned int *rp, unsigned int *gp, unsigned int *bp,
	int *succp)
LX_OP *lx_lookup_color_rgb(
	LX_CONN *conn, LX_XID cmap,
	const char *name, int len,
	LX_RGB *rgp, int *succp)

lx_lookup_color() is just like lx_LookupColor, and
lx_lookup_color_rgb() is just like lx_LookupColor_rgb, except that (a)
they handle the #rgb, #rrggbb, #rrrgggbbb, and #rrrrggggbbbb syntaxes
internally rather than querying the server, (b) they don't take
arguments returning visual values (because a server roundtrip may not
happen), (c) they take an additional pointer-to-int (succp in the
descriptions above) which receives a success boolean (true for success,
false for failure), and (d) they trap Name errors (reflected to the API
as failure) from any LookupColor request they do.

lx_font_cursor, lx_font_cursor_rgb
--------------  ------------------

LX_XID lx_font_cursor(LX_CONN *xc, int cno,
	int fr, int fg, int fg, int br, int bg, int bb)
LX_XID lx_font_cursor_rgb(LX_CONN *xc, int cno,
	LX_RGB fg, LX_RGB bg)

These are wrappers around lx_CreateGlyphCursor, using the conventional
`cursor' font.  cno is the cursor index, one of the LX_FONT_CURSOR_*
values; later arguments specify the cursor colours, as for
lx_CreateGlyphCursor.