summaryrefslogtreecommitdiff
path: root/README
blob: 501aa10a6c95fe901f6e9a8690b8e7485f5b2f52 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
xresponse
====

'xresponse' is a simple tool for meassuring UI response times to a
full mouse click event. It requires the Xtest, to 'fake' the mouse
event, and XDamage, to report areas of the display that have changed.


Building
====

Its recommended you have the freedesktop.org autotooled xlibs
installed with pkg-config (.pc ) files for xlibs, xext, xtst and
xdamage. Then it should be a case of the usual ./configure, make and
make install.


Usage
===

xresponse <-o|--logfile output> [commands..]

Commands are any combination/order of;

-c|--click <XxY>                Send click and await damage response
-d|--drag <XxY,XxY,XxY,XxY..>   Simulate mouse drag and collect damage
-m|--monitor <WIDTHxHEIGHT+X+Y> Watch area for damage ( default fullscreen )
-w|--wait <seconds>             Max time to wait for damage, set to 0 to
                                monitor for ever. 
                                ( default 5 secs)
-s|--stamp <string>             Write 'string' to log file

-i|--inspect                    Just display damage events


Examples
===

Click mouse at 100,100 and collect max 5 seconds of damage events;

% xresponse -c 100x100

Click and hold mouse at 100,100, then move to 101,100, then 105,100,
then 110,100 and finally release mouse. Damage is collected between
each point with max 5 seconds.

% xresponse -d 100x100,101x100,105x100,110x100

Click the mouse at 100x100, 100x150 and 200x200 colecting a max second
of damage for each only in 240x320+0+0;

% xresponse -w 1  -m 240x320+0+0 -c 100x100 -c 100x150 -c 200x200

Monitor all damage for ever;

% xresponse -w 0 -i

Monitor only top corner of screen for 10 seconds, then send a click collecting
5 seconds of damage

% xresponse -w 10 -m 240x320+0+0 -i -w 5 -c 100x100

Tips
===

- you can use 'xmag' to figure out screen co-ords for window clicks.