recorder(n)		     Ck Built-In Commands		   recorder(n)



______________________________________________________________________________

NAME
       recorder - Simple event recorder/player

SYNOPSIS
       recorder replay fileName
       recorder start ?-withdelay? fileName
       recorder stop
_________________________________________________________________


DESCRIPTION
       This  command  provides	a  simple recorder/player for certain kinds of
       events. The recorder start form arranges for recording  events  to  the
       event log file fileName. If the -withdelay switch is specified, the de-
       lays between events are also recorded.  The event log file may  be  re-
       played  using  the recorder replay command form. With recorder stop all
       recording/playing activity is stopped  and  all	event  log  files  are
       closed.

       Each  event takes up one line in an event log file. Event types are the
       first word in angle brackets in the line. They are followed by  parame-
       ters for the event:

       <ButtonPress> window button x y rootX rooty
	      Mouse  button  button  (1,  2, or 3) pressed in window window at
	      window coordinate x, y. Root coordinates are in rootX, rootY.

       <ButtonRelease> window button x y rootX rooty
	      Mouse button released, analogous to <ButtonPress>.

       <Delay> milliseconds
	      Delay replay for milliseconds.

       <Key> window keysym
	      Key pressed in window. Keysym is the symbolic name of  the  key,
	      e.g.  ``Linefeed'',  ``Return'', ``Control-A'', or a hexadecimal
	      key code like 0xc3.  Note that  hexadecimal  key	codes  greater
	      than 0x7f are not portable accross different systems.

       Lines  starting	with  a	 hash are treated as comments. All other lines
       whose first word does not start with an open angle bracket  are	evalu-
       ated  as normal Tcl commands. As in Tcl source files, newline-backslash
       sequences are treated as continuation lines.

       Errors occuring during replay are reported using the  background	 error
       mechanism. Upon error, the replay event log file is closed.


KEYWORDS
       event, recorder



Ck				      8.0			   recorder(n)
