This option specifies how often (in seconds) you want to get a new
copy of the window youre watching. It is in effect a sample rate.
By default, xwatchwin updates your copy of the window as often
as it can. The time it takes to actually do the update is dependent
on the speed of the X server on both machines, the speed of the
intervening network, and other factors.
This option specifies the window you want to watch by number, for
example, "0x50000b". Use the xlswins(1) command to get a list of
window ids and possibly their names on the remote server.
You must specify a window to watch either by name or by id. Specifying a window to watch by name is usually easier if you know what youre looking for.
If there is an X server on the remote machine "crow" and if on that server there is a window called "X Terminal Emulator", you can watch that window by typing
xwatchwin crow X Terminal Emulator
If there is a window on "crow" that has no name but has a window id of "0x50000b", you can watch it by typing
xwatchwin -w 0x50000b crow
If you want to get new copies of a window only every 30 seconds, you can do so by typing
xwatchwin -u 30 -w 0x50000b crow
xwatchwin doesnt support the -display option. You must set the display on which the xwatchwin window is created by changing your DISPLAY environment variable.
If the window youre watching is resized while xwatchwin is getting a new copy of that window, the program will crash. The smaller your update interval, the more likely you are to experience this bug (although it hasnt happened all that often to me).
xwatchwin can now deal with two displays of different depths. There is special-case code for the conversions between 1-bit displays and 8-bit displays (either direction) which may garble the image on some machines. The general case code should work on anything, albeit somewhat more slowly. One note: ABSOLUTELY no attempt is made to make the colors match up. If youre on a 5-bit display, and youre monitoring someone elses 8-bit display, the conversion just takes his 8 bits and chops the top 3 bits off, and puts it on the screen. Maybe in the next version...
Copyright 1992 - 1995, Q. Alex Zhao
Copyright 1989, George D. Drapeau
Light-weight version by Q. Alex Zhao email@example.com.
Display depth conversion code added by John Bradley firstname.lastname@example.org.
Original version by George D. Drapeau, Stanford University, Academic Information Resources / Systems Development, email@example.com.
|Georgia Tech||XWATCHWIN (1)||28 Dec 1995|