3 rio \- window system files
27 serves a variety of files for reading, writing, and controlling
29 Some of them are virtual versions of system files for dealing
30 with the display, keyboard, and mouse; others control operations
31 of the window system itself.
33 posts its service in the
36 name constructed from a catenation of the user ID
37 and a process id; the environment variable
39 is set to this service name within processes running under the control
44 posts a named pipe to access the window creation features
50 its name space; this is named in
61 to create a new window; the attach specifier in the
63 gives the coordinates of the created window.
64 The syntax of the specifier is the same as the arguments to
68 By default, the window is sized and placed automatically.
69 It is always necessary, however, to provide the process id of the
70 process to whom to deliver notes generated by DEL characters and hangups
72 That pid is specified by including the string
75 in the attach specifier. (See the Examples section
78 When a window is created either by
84 or by using the menu supplied by
86 this server is mounted on
90 the files mentioned here
91 appear in both those directories.
93 Some of these files supply virtual versions of services available from the underlying
94 environment, in particular the character terminal files
104 each specific to the window.
107 device multiplexes itself;
109 places windows but does not mediate programs' access to the display device.
111 Other files are unique to
116 a virtual version of the standard terminal file from
119 supplies extra editing features and a scroll bar
124 controls interpretation of console input.
125 Writing strings to it sets these modes:
134 Closing the file makes the window revert to default state
138 represents the raw keyboard events (see
140 for the corresponding window. While open,
141 navigation keys and input on the
149 a multiplexed version of the underlying device file, in this case representing the
150 appearance of the mouse cursor when the mouse is within the corresponding window.
153 initially contains a string with the process ID of the lead process
154 in the window and the command being executed there.
155 It may be written and is used as a tag when the window is hidden.
158 is a virtual version of the standard mouse file (see
160 Opening it turns off scrolling, editing, and
162 menus in the associated
164 In a standard mouse message, the first character is
168 will send an otherwise normal message with the first character
170 if the corresponding window has been resized.
171 The application must then call
175 to re-establish its state in the newly moved or changed window.
178 file blocks until the mouse moves or a button changes.
179 Mouse movements or button changes are invisible when the mouse cursor
180 is located outside the window, except that if the mouse leaves the window
181 while a button is pressed, it will continue receiving mouse data until the button is released.
184 is a read-only file reporting the depth, coordinates, and raster image corresponding to the entire
186 in the uncompressed format defined in
190 returns the string currently in the snarf buffer.
191 Writing this file sets the contents of the snarf buffer.
194 is run recursively, the inner instance uses the snarf buffer of the parent, rather than
198 returns the full contents of the window.
199 It may not be written.
202 may be read or written.
203 When read, it returns the location of the window as four decimal integers formatted
204 in the usual 12-character style: upper left
212 Following these numbers are strings describing the window's state:
219 A subsequent read will block until the window changes size, location, or state.
222 accepts messages to change the size or placement of the associated window,
223 and to create new windows.
224 The messages are in a command-line like format, with a command name,
225 possibly followed by options introduced by a minus sign.
226 The options must be separated by blanks, for example
233 (change the size and position of the window),
237 (enable scrolling in the window),
241 (change selected properties of the window),
243 (move the window to the `top', making it fully visible),
245 (move the window to the `bottom', perhaps partially or totally obscuring it),
249 (restore a hidden window),
251 (make the window the recipient of keyboard and mouse input),
259 commands do not change whether the window is current or not;
260 the others always make the affected window current.
282 options to set the position of the corresponding edge of the window.
283 They also accept an option
285 .I minx miny maxx maxy
286 to set all four at once.
297 to set the width and height of the window.
300 will choose a convenient geometry automatically.
304 command accepts an optional shell command and argument string,
305 given as plain strings after any standard options, to run in the window
306 instead of the default
318 of the process whose `note group' should receive interrupt
319 and hangup notes generated in the window.
320 The initial working directory of the new window may be set by a
326 option causes the window to be created off-screen, in the hidden state, while
330 set the initial scrolling state of the window; the default is that of the main program.
334 command accepts a set of parameters in the same style; only
339 So programs outside name spaces controlled by
344 messages may also be written to the named pipe identified by
348 is a read/write text file containing
350 idea of the current working directory of the process running in the window.
351 It is used to fill in the
359 menu item on button 2.
360 The file is writable so the program may update it;
362 is otherwise unaware of
364 calls its clients make.
374 returns the unique and unchangeable ID for the window;
375 it is a string of digits.
378 is the virtual version of
380 It contains the depth, coordinates, and
381 uncompressed raster image corresponding to the associated
385 is a directory containing a subdirectory for each window, named
386 by the unique ID for that window. Within each subdirectory
387 are entries corresponding to several of the special files associated
395 Cause a window to be created in the upper left corner,
401 mount $wsys /tmp 'new -r 0 0 128 64 -pid '$pid
407 in a large horizontal window.
410 echo new -dx 800 -dy 200 -cd /sys/src/cmd sam > /dev/wctl
413 Print the screen image of window with id 123.
416 lp /dev/wsys/123/window