Subversion Repositories planix.SVN

#pragma src "/sys/src/libcontrol"

#pragma lib "libcontrol.a"

#pragma	varargck	argpos	ctlprint	2

#pragma varargck	argpos	_ctlprint	2

typedef struct Control Control;

typedef struct Controlset Controlset;

typedef struct CParse CParse;

typedef struct CCache CCache;

typedef struct CCache CImage;

typedef struct CCache CFont;

enum	/* types */

{

	Ctlunknown,

	Ctlbox,

	Ctlbutton,

	Ctlentry,

	Ctlkeyboard,

	Ctllabel,

	Ctlmenu,

	Ctlradio,

	Ctlscribble,

	Ctlslider,

	Ctltabs,

	Ctltext,

	Ctltextbutton,

	Ctltextbutton3,

	Ctlgroup,		/* divider between controls and metacontrols */

	Ctlboxbox,

	Ctlcolumn,

	Ctlrow,

	Ctlstack,

	Ctltab,

	Ntypes,

};

struct Controlset

{

	Control		*controls;

	Image		*screen;

	Control		*actives;

	Control		*focus;

	Channel		*ctl;

	Channel		*data;		/* currently only for sync */

	Channel		*kbdc;

	Channel		*mousec;

	Channel		*resizec;

	Channel		*resizeexitc;

	Channel		*csexitc;

	Keyboardctl	*keyboardctl;	/* will be nil if user supplied keyboard */

	Mousectl	*mousectl;	/* will be nil if user supplied mouse */

	int		clicktotype;	/* flag */

};

struct Control

{

	/* known to client */

	char		*name;

	Rectangle	rect;

	Rectangle	size;		/* minimum/maximum Dx, Dy (not a rect) */

	Channel		*event;		/* chan(char*) to client */

	Channel		*data;		/* chan(char*) to client */

	/* internal to control set */

	int		type;

	int		hidden;		/* hide hides, show unhides (and redraws) */

	Controlset	*controlset;

	Image		*screen;	/* where Control appears */

	char		*format;	/* used to generate events */

	char		wevent;		/* event channel rewired */

	char		wdata;		/* data channel rewired */

	/* method table */

	void		(*ctl)(Control*, CParse*);

	void		(*mouse)(Control*, Mouse*);

	void		(*key)(Control*, Rune*);

	void		(*exit)(Control*);

	void		(*setsize)(Control*);

	void		(*activate)(Control*, int);

	Control		*nextactive;

	Control		*next;

};

struct CCache

{

	union{

		Image	*image;

		Font	*font;

	};

	char		*name;

	int		index;		/* entry number in cache */

	int		ref;		/* one for client, plus one for each use */

};

struct CParse

{

	char	str[256];

	char	*sender;

	char	*receiver;

	int	cmd;

	char	*pargs[32];

	int	iargs[32];

	char	**args;

	int	nargs;

};

enum	/* alignments */

{

	Aupperleft = 0,

	Auppercenter,

	Aupperright,

	Acenterleft,

	Acenter,

	Acenterright,

	Alowerleft,

	Alowercenter,

	Alowerright,

	Nalignments

};

enum

{

	_Ctlmaxsize = 10000,

};

extern char *ctltypenames[];

/* Functions used internally */

void		_ctladdgroup(Control*, Control*);

void		_ctlargcount(Control*, CParse*, int);

Control*	_createctl(Controlset*, char*, uint, char*);

Rune*		_ctlrunestr(char*);

char*		_ctlstrrune(Rune*);

void		_ctlputsnarf(Rune*);

Rune*		_ctlgetsnarf(void);

int		_ctlalignment(char*);

Point		_ctlalignpoint(Rectangle, int, int, int);

void		_ctlfocus(Control*, int);

void		_activategroup(Control*);

void		_deactivategroup(Control*);

int		_ctllookup(char *s, char *tab[], int ntab);

void		_ctlprint(Control *c, char *fmt, ...);

/* images */

CImage*		_getctlimage(char*);

void		_setctlimage(Control*, CImage**, char*);

void		_putctlimage(CImage*);

CFont*		_getctlfont(char*);

void		_putctlfont(CFont*);

/* fonts */

CImage*		_getctlfont(char*);

void		_setctlfont(Control*, CImage**, char*);

void		_putctlfont(CImage*);

CFont*		_getctlfont(char*);

void		_putctlfont(CFont*);

/* Public functions */

/* images */

int		namectlimage(Image*, char*);

int		freectlimage(char*);

/* fonts */

int		namectlfont(Font*, char*);

int		freectlfont(char*);

/* commands */

int		ctlprint(Control*, char*, ...);

/* general */

void		initcontrols(void);

Controlset*	newcontrolset(Image*, Channel*, Channel*, Channel*);

void		closecontrolset(Controlset*);

void		closecontrol(Control*);

void		ctlerror(char*, ...);

Control*	controlcalled(char*);

/* publicly visible error-checking allocation routines */

void*		ctlmalloc(uint);

void*		ctlrealloc(void*, uint);

char*		ctlstrdup(char*);

/* creation */

void		controlwire(Control*, char*, Channel*);

void		activate(Control*);

void		deactivate(Control*);

Control*	createbox(Controlset*, char*);

Control*	createbutton(Controlset*, char*);

Control*	createcolumn(Controlset*, char*);

Control*	createboxbox(Controlset*, char*);

Control*	createentry(Controlset*, char*);

Control*	createkeyboard(Controlset*, char*);

Control*	createlabel(Controlset*, char*);

Control*	createmenu(Controlset*, char*);

Control*	createradiobutton(Controlset*, char*);

Control*	createrow(Controlset*, char*);

Control*	createscribble(Controlset*, char*);

Control*	createslider(Controlset*, char*);

Control*	createstack(Controlset*, char*);

Control*	createtab(Controlset*, char*);

Control*	createtext(Controlset*, char*);

Control*	createtextbutton(Controlset*, char*);

Control*	createtextbutton3(Controlset*, char*);

/* user-supplied */

void		resizecontrolset(Controlset*);

int		_ctlsnarffd;

char		*alignnames[];

int		ctldeletequits;