home *** CD-ROM | disk | FTP | other *** search
/ The World of Computer Software / World_Of_Computer_Software-02-387-Vol-3of3.iso / x / x11p-13.zip / RCS / x11perf.man,v < prev    next >
Text File  |  1989-12-28  |  28KB  |  1,455 lines
  1. head     1.8;
  2. access   ;
  3. symbols  ;
  4. locks    ; strict;
  5. comment  @@;
  6.  
  7.  
  8. 1.8
  9. date     89.12.28.12.47.48;  author joel;  state Exp;
  10. branches ;
  11. next     1.7;
  12.  
  13. 1.7
  14. date     89.12.14.13.36.58;  author joel;  state Exp;
  15. branches ;
  16. next     1.6;
  17.  
  18. 1.6
  19. date     89.12.13.19.10.45;  author joel;  state Exp;
  20. branches ;
  21. next     1.5;
  22.  
  23. 1.5
  24. date     89.12.12.17.32.37;  author joel;  state Exp;
  25. branches ;
  26. next     1.4;
  27.  
  28. 1.4
  29. date     89.12.07.16.45.12;  author joel;  state Exp;
  30. branches ;
  31. next     1.3;
  32.  
  33. 1.3
  34. date     89.10.25.14.58.31;  author joel;  state Exp;
  35. branches ;
  36. next     1.2;
  37.  
  38. 1.2
  39. date     89.10.24.09.48.05;  author joel;  state Exp;
  40. branches ;
  41. next     1.1;
  42.  
  43. 1.1
  44. date     89.05.16.20.16.30;  author joel;  state Exp;
  45. branches ;
  46. next     ;
  47.  
  48.  
  49. desc
  50. @Man page courtesy of Jim Gettys
  51. @
  52.  
  53.  
  54. 1.8
  55. log
  56. @Bunches of updates
  57. @
  58. text
  59. @.TH x11perf 1 "27 Dec 1989" "X Version 11"
  60. .SH NAME
  61. x11perf - X11 server performance test program
  62. .SH SYTAX
  63. .B x11perf
  64. [-option ...]
  65. .SH DESCRIPTION
  66. The
  67. .I x11perf
  68. program runs one or more performance tests and reports how fast an X server can
  69. execute the tests.
  70. .PP
  71. Many graphics benchmarks assume that the graphics device is used to display the
  72. output of a single fancy graphics application, and that the user gets his work
  73. done on some other device, like a terminal.  Such benchmarks usually measure
  74. drawing speed for lines, polygons, text, etc.
  75. .PP
  76. Since workstations are not used as standalone graphics engines, but as
  77. super-terminals, 
  78. .I x11perf 
  79. measures window management performance as well as
  80. traditional graphics performace.  
  81. .I x11perf 
  82. includes benchmarks for the time it
  83. takes to create and map windows (as when you start up an application); to map a
  84. pre-existing set of windows onto the screen (as when you deiconify an
  85. application or pop up a menu); and to rearrange windows (as when you slosh
  86. windows to and fro trying to find the one you want).
  87. .PP
  88. .I x11perf 
  89. also measures graphics performance for operations not normally used in
  90. standalone graphics displays, but are nonetheless used frequently by X
  91. applications.  Such operations include CopyPlane (used to map bitmaps into
  92. pixels), scrolling (used in text windows), and various stipples and tiles
  93. (used for CAD and color half-toning, respectively).
  94. .PP
  95. .I x11perf 
  96. should be used to analyze particular strengths and weaknesses
  97. of servers, and is most useful to a server writer who wants to
  98. analyze and improve a server.
  99. .I x11perf
  100. is meant to comprehensively exercise just about every X11 operation you can
  101. perform; it does not purport to be a representative sample of the
  102. operations that X11 applications actually use.
  103. While it can be used as a benchmark, it was written and is intended as
  104. a performance testing tool.
  105. .PP
  106. As such,
  107. .I x11perf 
  108. DOES NOT whittle down measurements to a single ``HeXStones''
  109. or ``MeXops'' number.  We consider such numbers to be uninformative 
  110. at best and misleading at worst.  
  111. Some servers which are very fast for certain applications can be
  112. very slow for others.
  113. No single number or small set of numbers are sufficient to
  114. characterize how an X implementation will perform on all applications.
  115. However, by knowledge of your favorite application, you
  116. may be able to use the numbers
  117. .I x11perf
  118. reports to predict its performance on a given X implementation.
  119. .PP
  120. That said, you might also want to look at
  121. .I x11perfcomp(1),
  122. a program to compare the outputs of different 
  123. .I x11perf
  124. runs.  You provide a list of files containing results from
  125. .I x11perf,
  126. and it lays them out in a nice tabular format.
  127. .PP
  128. For repeatable results, 
  129. .I x11perf 
  130. should be run using a local connection on a
  131. freshly-started server.  The default configuration runs each test 5 times, in
  132. order to see if each trial takes approximately the same amount of time.
  133. Strange glitches should be examined; if non-repeatable one might
  134. chalk them up to
  135. daemons and network traffic.  Each trial is run for 5 seconds, in order to
  136. reduce random time differences.  The number of objects processed per second is
  137. displayed to 3 significant digits, but you'll be lucky on most UNIX system if
  138. the numbers are actually consistent to 2 digits.
  139. .I x11perf
  140. moves the cursor out of the test window; you should be careful not
  141. to bump the mouse and move it back into the window.
  142. (A prize to people who correctly explain why!!).
  143. .PP
  144. Before running a test,
  145. .I x11perf
  146. determines what the round trip time to the server is, and factors this out of
  147. the final timing reported.  It ensures that the server has actually performed
  148. the work requested by fetching a pixel back from the test window, which means
  149. that servers talking to graphics accelerators can't claim that they are done,
  150. while in the meantime the accelerator is painting madly.
  151. .PP
  152. By default 
  153. .I x11perf
  154. automatically calibrates the number of repetitions of each test,
  155. so that each should take approximately the same length of time to run across
  156. servers of widely differing speeds.  However, since each test must be run to
  157. completion at least once, some slow servers may take a very long time,
  158. particularly on the window moving and resizing tests, and on the arc drawing
  159. tests.
  160. .PP
  161. All timing reports are for the smallest object involved.  For example, the line
  162. tests use a PolyLine request to paint several lines at once, but report how
  163. many lines per second the server can paint, not how many PolyLine requests per
  164. second.  Text tests paint a line of characters, but report on the number of
  165. characters per second.  Some window tests map, unmap, or move a single parent
  166. window, but report on how many children windows per second the server can map,
  167. unmap, or move.
  168. .PP
  169. The current program is mostly the responsibility of Joel McCormack.  It is
  170. based upon the x11perf developed by Phil Karlton, Susan Angebranndt, and Chris
  171. Kent, who wanted to assess performance differences between various servers.
  172. Mary Walker, Todd Newman, and several tests were added 
  173. in order to write and tune
  174. the PMAX (DECStation 3100) servers.  
  175. For a general release to the world, 
  176. .I x11perf 
  177. was rewritten to ease making comparisons between widely varying
  178. machines, to cover most important (and unimportant) X functionality,
  179. and to exercise graphics operations in as many different
  180. orientations and alignments as possible.
  181. .SH OPTIONS
  182. .I x11perf 
  183. is solely Xlib based, and
  184. accepts the options listed below:
  185. .TP 14
  186. .B \-display host:dpy
  187. Specifies which display to use.
  188. .TP 14
  189. .B \-sync
  190. Runs the tests in synchronous mode.
  191. Normally only useful for debugging 
  192. .I x11perf .
  193. .TP 14
  194. .B \-pack
  195. Runs rectangle tests so that they pack rectangles right next to each other.
  196. This makes it easy to debug server code for stipples and tiles...if the
  197. pattern looks ugly, you've got alignment problems.
  198. .TP 14
  199. .B \-repeat \fI<n>\fP
  200. Repeats each test 
  201. .I n
  202. times (by default each test is run 5 times).
  203. .TP 14
  204. .B \-time \fI<s>\fP
  205. Specifies how long in seconds each test should be run (default 5 seconds).
  206. .TP 14
  207. .B \-all
  208. Runs all tests.  This may take a while.
  209. .TP 14
  210. .B \-range \fI<test1>\fP[,\fI<test2>\fP]
  211. Runs all the tests starting from the specified name \fItest1\fP until
  212. the name \fItest2\fP, including both the specified tests. The testnames
  213. should be one of the options starting from -dot. (eg) -range line100
  214. will peform the tests from the 100 pixel line test, and go on till the
  215. last test, -range line100,dline10 will do the tests from line100 to
  216. dline10.
  217. .TP 14
  218. .B \-labels
  219. Generates just the descriptive labels for each test specified.  See
  220. .I x11perfcomp
  221. for more details.
  222. .TP 14
  223. .B \-fg \fIcolor\fP
  224. Specifies the foreground color to use.
  225. .TP 14
  226. .B \-bg \fIcolor\fP
  227. Specifies the background color to use.
  228. .TP 14
  229. .B \-xor
  230. Use GXxor mode to draw, rather than GXcopy.
  231. This option only affects graphics
  232. benchmarks in which the graphics function is actually used.
  233. .TP 14
  234. .B \-both
  235. First use GXcopy, then use GXxor mode to draw.
  236. This option only affects graphics
  237. benchmarks in which the graphics function is actually used.
  238. .TP 14
  239. .B \-dot
  240. Dot.
  241. .TP 14
  242. .B \-rect1
  243. 1x1 solid-filled rectangle.
  244. .TP 14
  245. .B \-rect10
  246. 10x10 solid-filled rectangle.
  247. .TP 14
  248. .B \-rect100
  249. 100x100 solid-filled rectangle.
  250. .TP 14
  251. .B \-rect500
  252. 500x500 solid-filled rectangle.
  253. .TP 14
  254. .B \-srect1
  255. 1x1 transparent stippled rectangle, 8x8 stipple pattern.
  256. .TP 14
  257. .B \-srect10
  258. 10x10 transparent stippled rectangle, 8x8 stipple pattern.
  259. .TP 14
  260. .B \-srect100
  261. 100x100 transparent stippled rectangle, 8x8 stipple pattern.
  262. .TP 14
  263. .B \-srect500
  264. 500x500 transparent stippled rectangle, 8x8 stipple pattern.
  265. .TP 14
  266. .B \-osrect
  267. 1x1 opaque stippled rectangle, 8x8 stipple pattern.
  268. .TP 14
  269. .B \-osrect10
  270. 10x10 opaque stippled rectangle, 8x8 stipple pattern.
  271. .TP 14
  272. .B \-osrect100
  273. 100x100 opaque stippled rectangle, 8x8 stipple pattern.
  274. .TP 14
  275. .B \-osrect500
  276. 500x500 opaque stippled rectangle, 8x8 stipple pattern.
  277. .TP 14
  278. .B \-tilerect1
  279. 1x1 tiled rectangle, 4x4 tile pattern.
  280. .TP 14
  281. .B \-tilerect10
  282. 10x10 tiled rectangle, 4x4 tile pattern.
  283. .TP 14
  284. .B \-tilerect100
  285. 100x100 tiled rectangle, 4x4 tile pattern.
  286. .TP 14
  287. .B \-tilerect500
  288. 500x500 tiled rectangle, 4x4 tile pattern.
  289. .TP 14
  290. .B \-bigtilerect1
  291. 1x1 tiled rectangle, 161x145 tile pattern.
  292. .TP 14
  293. .B \-bigtilerect10
  294. 10x10 tiled rectangle, 161x145 tile pattern.
  295. .TP 14
  296. .B \-bigtilerect100
  297. 100x100 tiled rectangle, 161x145 tile pattern.
  298. .TP 14
  299. .B \-bigtilerect500
  300. 500x500 tiled rectangle, 161x145 tile pattern.
  301. .TP 14
  302. .B \-seg1
  303. 1-pixel thin line segment.
  304. .TP 14
  305. .B \-seg10
  306. 10-pixel thin line segment.
  307. .TP 14
  308. .B \-seg100
  309. 100-pixel thin line segment.
  310. .TP 14
  311. .B \-seg500
  312. 500-pixel thin line segment.
  313. .TP 14
  314. .B \-seg100c1
  315. 100-pixel thin line segment (1 obscuring rectangle).
  316. .TP 14
  317. .B \-seg100c2
  318. 100-pixel thin line segment (2 obscuring rectangles).
  319. .TP 14
  320. .B \-seg100c3
  321. 100-pixel thin line segment (3 obscuring rectangles).
  322. .TP 14
  323. .B \-dseg10
  324. 10-pixel thin dashed segment (3 on, 2 off).
  325. .TP 14
  326. .B \-dseg100
  327. 100-pixel thin dashed segment (3 on, 2 off).
  328. .TP 14
  329. .B \-ddseg100
  330. 100-pixel thin double-dashed segment (3 fg, 2 bg).
  331. .TP 14
  332. .B \-line1
  333. 1-pixel thin (width 0) line.
  334. .TP 14
  335. .B \-line10
  336. 10-pixel thin line.
  337. .TP 14
  338. .B \-line100
  339. 100-pixel thin line.
  340. .TP 14
  341. .B \-line500
  342. 500-pixel thin line.
  343. .TP 14
  344. .B \-dline10
  345. 10-pixel thin dashed line (3 on, 2 off).
  346. .TP 14
  347. .B \-dline100
  348. 100-pixel thin dashed line (3 on, 2 off).
  349. .TP 14
  350. .B \-ddline100
  351. 100-pixel thin double-dashed line (3 fg, 2 bg).
  352. .TP 14
  353. .B \-wline10
  354. 10-pixel line, line width 1.
  355. .TP 14
  356. .B \-wline100
  357. 100-pixel line, line width 10.
  358. .TP 14
  359. .B \-wline500
  360. 500-pixel line, line width 50.
  361. .TP 14
  362. .B \-wdline100
  363. 100-pixel dashed line, line width 10 (30 on, 20 off).
  364. .TP 14
  365. .B \-wddline100
  366. 100-pixel double-dashed line, line width 10 (30 fg, 20 bg).
  367. .TP 14
  368. .B \-circle1
  369. 1-pixel diameter thin (line width 0) circle.
  370. .TP 14
  371. .B \-circle10
  372. 10-pixel diameter thin circle.
  373. .TP 14
  374. .B \-circle100
  375. 100-pixel diameter thin circle.
  376. .TP 14
  377. .B \-circle500
  378. 500-pixel diameter thin circle.
  379. .TP 14
  380. .B \-dcircle100
  381. 100-pixel diameter thin dashed circle (3 on, 2 off).
  382. .TP 14
  383. .B \-ddcircle100
  384. 100-pixel diameter thin double-dashed circle (3 fg, 2 bg).
  385. .TP 14
  386. .B \-wcircle10
  387. 10-pixel diameter circle, line width 1.
  388. .TP 14
  389. .B \-wcircle100
  390. 100-pixel diameter circle, line width 10.
  391. .TP 14
  392. .B \-wcircle500
  393. 500-pixel diameter circle, line width 50.
  394. .TP 14
  395. .B \-wdcircle100
  396. 100-pixel diameter dashed circle, line width 10 (30 on, 20 off).
  397. .TP 14
  398. .B \-wddcircle100
  399. 100-pixel diameter double-dashed circle, line width 10 (30 fg, 20 bg).
  400. .TP 14
  401. .B \-pcircle10
  402. 10-pixel diameter thin partial circle,
  403. orientation and arc angle evenly distributed.
  404. .TP 14
  405. .B \-pcircle100
  406. 100-pixel diameter thin partial circle.
  407. .TP 14
  408. .B \-fcircle1
  409. 1-pixel diameter filled circle.
  410. .TP 14
  411. .B \-fcircle10
  412. 10-pixel diameter filled circle.
  413. .TP 14
  414. .B \-fcircle100
  415. 100-pixel diameter filled circle.
  416. .TP 14
  417. .B \-fcircle500
  418. 500-pixel diameter filled circle.
  419. .TP 14
  420. .B \-fcpcircle10
  421. 10-pixel diameter partial filled circle, chord fill,
  422. orientation and arc angle evenly distributed.
  423. .TP 14
  424. .B \-fcpcircle100
  425. 100-pixel diameter partial filled circle, chord fill.
  426. .TP 14
  427. .B \-fspcircle10
  428. 10-pixel diameter partial filled circle, pie slice fill,
  429. orientation and arc angle evenly distributed.
  430. .TP 14
  431. .B \-fspcircle100
  432. 100-pixel diameter partial filled circle, pie slice fill.
  433. .TP 14
  434. .B \-ellipse10
  435. 10-pixel diameter thin (line width 0) ellipse, major and
  436. minor axis sizes evenly distributed.
  437. .TP 14
  438. .B \-ellipse100
  439. 100-pixel diameter thin ellipse.
  440. .TP 14
  441. .B \-ellipse500
  442. 500-pixel diameter thin ellipse.
  443. .TP 14
  444. .B \-dellipse100
  445. 100-pixel diameter thin dashed ellipse (3 on, 2 off).
  446. .TP 14
  447. .B \-ddellipse100
  448. 100-pixel diameter thin double-dashed ellipse (3 fg, 2 bg).
  449. .TP 14
  450. .B \-wellipse10
  451. 10-pixel diameter ellipse, line width 1.
  452. .TP 14
  453. .B \-wellipse100
  454. 100-pixel diameter ellipse, line width 10.
  455. .TP 14
  456. .B \-wellipse500
  457. 500-pixel diameter ellipse, line width 50.
  458. .TP 14
  459. .B \-wdellipse100
  460. 100-pixel diameter dashed ellipse, line width 10 (30 on, 20 off).
  461. .TP 14
  462. .B \-wddellipse100
  463. 100-pixel diameter double-dashed ellipse, line width 10 (30 fg, 20 bg).
  464. .TP 14
  465. .B \-pellipse10
  466. 10-pixel diameter thin partial ellipse.
  467. .TP 14
  468. .B \-pellipse100
  469. 100-pixel diameter thin partial ellipse.
  470. .TP 14
  471. .B \-fellipse10
  472. 10-pixel diameter filled ellipse.
  473. .TP 14
  474. .B \-fellipse100
  475. 100-pixel diameter filled ellipse.
  476. .TP 14
  477. .B \-fellipse500
  478. 500-pixel diameter filled ellipse.
  479. .TP 14
  480. .B \-fcpellipse10
  481. 10-pixel diameter partial filled ellipse, chord fill.
  482. .TP 14
  483. .B \-fcpellipse100
  484. 100-pixel diameter partial filled ellipse, chord fill.
  485. .TP 14
  486. .B \-fspellipse10
  487. 10-pixel diameter partial filled ellipse, pie slice fill.
  488. .TP 14
  489. .B \-fspellipse100
  490. 100-pixel diameter partial filled ellipse, pie slice fill.
  491. .TP 14
  492. .B \-triangle1
  493. Fill 1-pixel/side triangle.
  494. .TP 14
  495. .B \-triangle10
  496. Fill 10-pixel/side triangle.
  497. .TP 14
  498. .B \-triangle100
  499. Fill 100-pixel/side triangle.
  500. .TP 14
  501. .B \-trap10
  502. Fill 10x10 trapezoid.
  503. .TP 14
  504. .B \-trap100
  505. Fill 100x100 trapezoid.
  506. .TP 14
  507. .B \-strap10
  508. Fill 10x10 transparent stippled trapezoid, 8x8 stipple pattern.
  509. .TP 14
  510. .B \-strap100
  511. Fill 100x100 transparent stippled trapezoid, 8x8 stipple pattern.
  512. .TP 14
  513. .B \-ostrap10
  514. Fill 10x10 opaque stippled trapezoid, 8x8 stipple pattern.
  515. .TP 14
  516. .B \-ostrap100
  517. Fill 100x100 opaque stippled trapezoid, 8x8 stipple pattern.
  518. .TP 14
  519. .B \-tiletrap10
  520. Fill 10x10 tiled trapezoid, 4x4 tile pattern.
  521. .TP 14
  522. .B \-tiletrap100
  523. Fill 100x100 tiled trapezoid, 4x4 tile pattern.
  524. .TP 14
  525. .B \-complex10
  526. Fill 10-pixel/side complex polygon.
  527. .TP 14
  528. .B \-complex100
  529. Fill 100-pixel/side complex polygon.
  530. .TP 14
  531. .B \-ftext
  532. Character in 80-char line (6x13).
  533. .TP 14
  534. .B \-tr10text
  535. Character in 80-char line (Times-Roman 10).
  536. .TP 14
  537. .B \-tr24text
  538. Character in 30-char line (Times-Roman 24).
  539. .TP 14
  540. .B \-polytext
  541. Character in 20/40/20 line (6x13, Times-Roman 10, 6x13).
  542. .TP 14
  543. .B \-fitext
  544. Character in 80-char image line (6x13).
  545. .TP 14
  546. .B \-tr10itext
  547. Character in 80-char image line (Times-Roman 10).
  548. .TP 14
  549. .B \-tr24itext
  550. Character in 30-char image line (Times-Roman 24).
  551. .TP 14
  552. .B \-scroll10
  553. Scroll 10x10 pixels vertically.
  554. .TP 14
  555. .B \-scroll100
  556. Scroll 100x100 pixels vertically.
  557. .TP 14
  558. .B \-scroll500
  559. Scroll 500x500 pixels vertically.
  560. .TP 14
  561. .B \-copywinwin10
  562. Copy 10x10 square from window to window.
  563. .TP 14
  564. .B \-copywinwin100
  565. Copy 100x100 square from window to window.
  566. .TP 14
  567. .B \-copywinwin500
  568. Copy 500x500 square from window to window.
  569. .TP 14
  570. .B \-copypixwin10
  571. Copy 10x10 square from pixmap to window.
  572. .TP 14
  573. .B \-copypixwin100
  574. Copy 100x100 square from pixmap to window.
  575. .TP 14
  576. .B \-copypixwin500
  577. Copy 500x500 square from pixmap to window.
  578. .TP 14
  579. .B \-copywinpix10
  580. Copy 10x10 square from window to pixmap.
  581. .TP 14
  582. .B \-copywinpix100
  583. Copy 100x100 square from window to pixmap.
  584. .TP 14
  585. .B \-copywinpix500
  586. Copy 500x500 square from window to pixmap.
  587. .TP 14
  588. .B \-copypixpix10
  589. Copy 10x10 square from pixmap to pixmap.
  590. .TP 14
  591. .B \-copypixpix100
  592. Copy 100x100 square from pixmap to pixmap.
  593. .TP 14
  594. .B \-copypixpix500
  595. Copy 500x500 square from pixmap to pixmap.
  596. .TP 14
  597. .B \-copyplane10
  598. Copy 10x10 1-bit deep plane.
  599. .TP 14
  600. .B \-copyplane100
  601. Copy 100x100 1-bit deep plane.
  602. .TP 14
  603. .B \-copyplane500
  604. Copy 500x500 1-bit deep plane.
  605. .TP 14
  606. .B \-putimage10
  607. PutImage 10x10 square.
  608. .TP 14
  609. .B \-putimage100
  610. PutImage 100x100 square.
  611. .TP 14
  612. .B \-putimage500
  613. PutImage 500x500 square.
  614. .TP 14
  615. .B \-shmput10
  616. PutImage 10x10 square, MIT shared memory extension.
  617. .TP 14
  618. .B \-shmput100
  619. PutImage 100x100 square, MIT shared memory extension.
  620. .TP 14
  621. .B \-shmput500
  622. PutImage 500x500 square, MIT shared memory extension.
  623. .TP 14
  624. .B \-getimage10
  625. GetImage 10x10 square.
  626. .TP 14
  627. .B \-getimage100
  628. GetImage 100x100 square.
  629. .TP 14
  630. .B \-getimage500
  631. GetImage 500x500 square.
  632. .TP 14
  633. .B \-noop
  634. X protocol NoOperation.
  635. .TP 14
  636. .B \-atom
  637. GetAtomName.
  638. .TP 14
  639. .B \-prop
  640. GetProperty.
  641. .TP 14
  642. .B \-gc
  643. Change graphics context.
  644. .TP 14
  645. .B \-create
  646. Create child window and map using MapSubwindows.
  647. .TP 14
  648. .B \-ucreate
  649. Create unmapped window.
  650. .TP 14
  651. .B \-map
  652. Map child window via MapWindow on parent.
  653. .TP 14
  654. .B \-unmap
  655. Unmap child window via UnmapWindow on parent.
  656. .TP 14
  657. .B \-destroy
  658. Destroy child window via DestroyWindow parent.
  659. .TP 14
  660. .B \-popup
  661. Hide/expose window via Map/Unmap popup window.
  662. .TP 14
  663. .B \-move
  664. Move window.
  665. .TP 14
  666. .B \-umove
  667. Moved unmapped window.
  668. .TP 14
  669. .B \-movetree
  670. Move window via MoveWindow on parent.
  671. .TP 14
  672. .B \-resize
  673. Resize window.
  674. .TP 14
  675. .B \-uresize
  676. Resize unmapped window.
  677. .TP 14
  678. .B \-circulate
  679. Circulate lowest window to top.
  680. .TP 14
  681. .B \-ucirculate
  682. Circulate unmapped window to top.
  683. .SH X DEFAULTS
  684. There are no X defaults used by this program.
  685. .SH "SEE ALSO"
  686. X(1), xbench(1), x11perfcomp(1)
  687. .SH BUGS
  688. We hope not.
  689. .SH COPYRIGHT
  690. Copyright 1988, 1989 Digital Equipment Corporation.
  691. .br
  692. See \fIX(1)\fP for a full statement of rights and permissions.
  693. .SH AUTHORS
  694. Joel McCormack
  695. .br
  696. Phil Karlton
  697. .br
  698. Susan Angebranndt
  699. .br
  700. Chris Kent
  701. @
  702.  
  703.  
  704. 1.7
  705. log
  706. @Added -pack option
  707. @
  708. text
  709. @d1 1
  710. a1 1
  711. .TH X11PERF 1 "23 Oct 1989" "X Version 11"
  712. d4 1
  713. a4 1
  714. .SH SYNOPSIS
  715. d10 2
  716. a11 2
  717. program runs one or more performance tests and reports timings of the
  718. operations.
  719. d33 3
  720. a35 3
  721. applications.  Such operations include CopyPlane (used by the DEC PostScript
  722. previewer), scrolling (used in text windows), and various stipples and tiles
  723. (used for CAD and half-toning, respectively).
  724. a37 5
  725. DOES NOT attempt to whittle down measurements to a single ``HeXStones''
  726. number.  
  727. We consider such numbers to be uninformative at best and misleading at
  728. worst.  
  729. .I x11perf 
  730. d39 1
  731. a39 1
  732. of servers, and is most useful when used by a server writer who wants to
  733. d41 4
  734. d47 6
  735. d62 8
  736. d81 3
  737. a83 2
  738. You should make sure the cursor is NOT in the test window during runs of
  739. .I x11perf .
  740. d86 25
  741. d120 2
  742. a121 2
  743. machines, to cover most important X functionality (the notable exception being
  744. wide lines), and to exercise graphics operations in as many different
  745. a122 9
  746. .PP
  747. Before running a test,
  748. .I x11perf
  749. determines what the round trip time to the server is.
  750. By default it automatically calibrates the number of repetitions of each test,
  751. so that each should take approximately the same length of time to run across
  752. servers of widely differing speeds.  However, since each test must be run to
  753. completion at least once, some slow servers may take a very long time,
  754. particularly on the window moving and resizing tests.
  755. d161 1
  756. a161 1
  757. Generates just the descriptive labels for each test.  See
  758. d245 1
  759. a245 1
  760. 1-pixel line segment.
  761. d248 1
  762. a248 1
  763. 10-pixel line segment.
  764. d251 1
  765. a251 1
  766. 100-pixel line segment.
  767. d254 1
  768. a254 1
  769. 500-pixel line segment.
  770. d257 1
  771. a257 1
  772. 100-pixel line segment (1 obscuring rectangle).
  773. d260 1
  774. a260 1
  775. 100-pixel line segment (2 obscuring rectangles).
  776. d263 1
  777. a263 1
  778. 100-pixel line segment (3 obscuring rectangles).
  779. d266 1
  780. a266 1
  781. 10-pixel dashed segment (3 on, 2 off).
  782. d269 1
  783. a269 1
  784. 100-pixel dashed segment (3 on, 2 off).
  785. d272 1
  786. a272 1
  787. 100-pixel double-dashed segment (3 fg, 2 bg).
  788. d275 1
  789. a275 1
  790. 1-pixel line.
  791. d278 1
  792. a278 1
  793. 10-pixel line.
  794. d281 1
  795. a281 1
  796. 100-pixel line.
  797. d284 1
  798. a284 1
  799. 500-pixel line.
  800. d287 1
  801. a287 1
  802. 10-pixel dashed line (3 on, 2 off).
  803. d290 1
  804. a290 1
  805. 100-pixel dashed line (3 on, 2 off).
  806. d293 1
  807. a293 1
  808. 100-pixel double-dashed line (3 fg, 2 bg).
  809. d311 1
  810. a311 1
  811. 1-pixel diameter circle.
  812. d314 1
  813. a314 1
  814. 10-pixel diameter circle.
  815. d317 1
  816. a317 1
  817. 100-pixel diameter circle.
  818. d320 1
  819. a320 1
  820. 500-pixel diameter circle.
  821. d323 1
  822. a323 1
  823. 100-pixel diameter dashed circle (3 on, 2 off).
  824. d325 2
  825. a326 2
  826. .B \-dcircle100
  827. 100-pixel diameter double-dashed circle (3 fg, 2 bg).
  828. d344 1
  829. a344 1
  830. 10-pixel diameter partial circle,
  831. d348 1
  832. a348 2
  833. 100-pixel diameter partial circle,
  834. orientation and arc angle evenly distributed.
  835. d363 2
  836. a364 1
  837. 10-pixel diameter partial filled circle, chord fill.
  838. d370 2
  839. a371 1
  840. 10-pixel diameter partial filled circle, pie slice fill.
  841. d377 2
  842. a378 1
  843. 10-pixel diameter ellipse.
  844. d381 1
  845. a381 1
  846. 100-pixel diameter ellipse.
  847. d384 1
  848. a384 1
  849. 500-pixel diameter ellipse.
  850. d387 1
  851. a387 1
  852. 100-pixel diameter dashed ellipse (3 on, 2 off).
  853. d390 1
  854. a390 1
  855. 100-pixel diameter double-dashed ellipse (3 fg, 2 bg).
  856. d406 1
  857. d408 1
  858. a408 1
  859. 10-pixel diameter partial ellipse.
  860. d411 1
  861. a411 1
  862. 100-pixel diameter partial ellipse.
  863. d471 1
  864. a471 1
  865. Fill 100-pixel/side complex polygons.
  866. d495 1
  867. a495 1
  868. Scroll 10x10 pixels.
  869. d498 1
  870. a498 1
  871. Scroll 100x100 pixels.
  872. d501 1
  873. a501 1
  874. Scroll 500x500 pixels.
  875. d503 2
  876. a504 2
  877. .B \-copyarea10
  878. Copy 10x10 square.
  879. d506 2
  880. a507 2
  881. .B \-copyarea100
  882. Copy 100x100 square.
  883. d509 2
  884. a510 2
  885. .B \-copyarea500
  886. Copy 500x500 square.
  887. d512 2
  888. a513 2
  889. .B \-copypix10
  890. Copy 10x10 square from pixmap.
  891. d515 2
  892. a516 2
  893. .B \-copypix100
  894. Copy 100x100 square from pixmap.
  895. d518 2
  896. a519 2
  897. .B \-copypix500
  898. Copy 500x500 square from pixmap.
  899. d521 18
  900. a555 1
  901. #ifdef MITSHM
  902. a564 1
  903. #endif
  904. d588 1
  905. a588 1
  906. Create and map subwindows.
  907. d594 1
  908. a594 1
  909. Map window via parent.
  910. d597 1
  911. a597 1
  912. Unmap window via parent.
  913. d600 1
  914. a600 1
  915. Destroy window via parent.
  916. d603 1
  917. a603 1
  918. Hide/expose window via popup.
  919. d612 1
  920. a612 1
  921. Move window via parent.
  922. d621 1
  923. a621 1
  924. Circulate window.
  925. d624 1
  926. a624 1
  927. Circulate Unmapped window.
  928. @
  929.  
  930.  
  931. 1.6
  932. log
  933. @Moved different fill style triangles to trapezoids
  934. @
  935. text
  936. @d106 5
  937. @
  938.  
  939.  
  940. 1.5
  941. log
  942. @Change -start to -range
  943. Added stippled, tiled triangles
  944. @
  945. text
  946. @d405 2
  947. a406 2
  948. .B \-striangle10
  949. Fill 10-pixel/side transparent stippled triangle, 8x8 stipple pattern.
  950. d408 2
  951. a409 2
  952. .B \-striangle100
  953. Fill 100-pixel/side transparent stippled triangle, 8x8 stipple pattern.
  954. d411 2
  955. a412 2
  956. .B \-ostriangle10
  957. Fill 10-pixel/side opaque stippled triangle, 8x8 stipple pattern.
  958. d414 2
  959. a415 2
  960. .B \-ostriangle100
  961. Fill 100-pixel/side opaque stippled triangle, 8x8 stipple pattern.
  962. d417 2
  963. a418 2
  964. .B \-tiletriangle10
  965. Fill 10-pixel/side tiled triangle, 4x4 tile pattern.
  966. d420 2
  967. a421 2
  968. .B \-tiletriangle100
  969. Fill 100-pixel/side tiled triangle, 4x4 tile pattern.
  970. d423 2
  971. a424 2
  972. .B \-trap10
  973. Fill 10x10 trapezoid.
  974. d426 2
  975. a427 2
  976. .B \-trap100
  977. Fill 100x100 trapezoid.
  978. @
  979.  
  980.  
  981. 1.4
  982. log
  983. @Added -both, partial arc options
  984. ,
  985. @
  986. text
  987. @d117 7
  988. a123 4
  989. .B \-start \fI<test>\fP
  990. Runs all tests starting at
  991. .I test.
  992. ``x11perf -start -dot'' is equivalent to ``x11perf -all''.
  993. d404 18
  994. @
  995.  
  996.  
  997. 1.3
  998. log
  999. @Added -start option
  1000. @
  1001. text
  1002. @d135 2
  1003. d138 5
  1004. d158 1
  1005. a158 1
  1006. .B \-tsrect1
  1007. d161 1
  1008. a161 1
  1009. .B \-tsrect10
  1010. d164 1
  1011. a164 1
  1012. .B \-tsrect100
  1013. d167 1
  1014. a167 1
  1015. .B \-tsrect500
  1016. d228 1
  1017. a228 1
  1018. 10-pixel dashed segment.
  1019. d231 1
  1020. a231 1
  1021. 100-pixel dashed segment.
  1022. d234 1
  1023. a234 1
  1024. 100-pixel double-dashed segment.
  1025. d249 1
  1026. a249 1
  1027. 10-pixel dashed line.
  1028. d252 1
  1029. a252 1
  1030. 100-pixel dashed line.
  1031. d255 1
  1032. a255 1
  1033. 100-pixel double-dashed line.
  1034. d267 1
  1035. a267 1
  1036. 100-pixel dashed line, line width 10.
  1037. d270 1
  1038. a270 1
  1039. 100-pixel double-dashed line, line width 10.
  1040. d285 1
  1041. a285 1
  1042. 100-pixel diameter dashed circle.
  1043. d288 1
  1044. a288 1
  1045. 100-pixel diameter double-dashed circle.
  1046. d300 1
  1047. a300 1
  1048. 100-pixel diameter dashed circle, line width 10.
  1049. d303 1
  1050. a303 1
  1051. 100-pixel diameter dashed circle, line width 10.
  1052. d305 8
  1053. d314 1
  1054. a314 1
  1055. 1-pixel diameter solid circle.
  1056. d317 1
  1057. a317 1
  1058. 10-pixel diameter solid circle.
  1059. d320 1
  1060. a320 1
  1061. 100-pixel diameter solid circle.
  1062. d323 1
  1063. a323 1
  1064. 500-pixel diameter solid circle.
  1065. d325 12
  1066. d347 1
  1067. a347 1
  1068. 100-pixel diameter dashed ellipse.
  1069. d350 1
  1070. a350 1
  1071. 100-pixel diameter double-dashed ellipse.
  1072. d362 1
  1073. a362 1
  1074. 100-pixel diameter dashed ellipse, line width 10.
  1075. d365 3
  1076. a367 1
  1077. 100-pixel diameter double-dashed ellipse, line width 10.
  1078. d369 3
  1079. d381 12
  1080. d418 1
  1081. a418 1
  1082. Character in 80-char line (TR 10).
  1083. d421 1
  1084. a421 1
  1085. Character in 30-char line (TR 24).
  1086. d424 1
  1087. a424 1
  1088. Character in 20/40/20 line (6x13, TR 10).
  1089. d430 1
  1090. a430 1
  1091. Character in 80-char image line (TR 10).
  1092. d433 1
  1093. a433 1
  1094. Character in 30-char image line (TR 24).
  1095. d510 1
  1096. a510 1
  1097. Graphics context validation.
  1098. @
  1099.  
  1100.  
  1101. 1.2
  1102. log
  1103. @Added new tests
  1104. @
  1105. text
  1106. @d117 5
  1107. @
  1108.  
  1109.  
  1110. 1.1
  1111. log
  1112. @Initial revision
  1113. @
  1114. text
  1115. @d1 1
  1116. a1 1
  1117. .TH X11PERF 1 "16 May 1989" "X Version 11"
  1118. d48 1
  1119. a48 1
  1120. Some servers which are very fast for certain applications, can be
  1121. d88 5
  1122. a92 6
  1123. By default it calibrates how long each test will take so that each test
  1124. will run approximately the same length of time on servers of quite different
  1125. speeds.
  1126. This can only be approximate as some tests, to be fair, must be run
  1127. completely at least once, and so may take a long time on some
  1128. implementations.
  1129. d97 1
  1130. a97 1
  1131. .TP 8
  1132. d100 1
  1133. a100 1
  1134. .TP 8
  1135. d102 1
  1136. a102 1
  1137. Specifies the tests should be run in synchronous mode.
  1138. d105 1
  1139. a105 1
  1140. .TP 8
  1141. d110 1
  1142. a110 1
  1143. .TP 8
  1144. d113 1
  1145. a113 1
  1146. .TP 8
  1147. d116 6
  1148. a121 1
  1149. .TP 8
  1150. d124 1
  1151. a124 1
  1152. .TP 8
  1153. d127 4
  1154. a130 1
  1155. .TP 8
  1156. d133 1
  1157. a133 1
  1158. .TP 8
  1159. d135 2
  1160. a136 2
  1161. 1x1 rectangle.
  1162. .TP 8
  1163. d138 2
  1164. a139 2
  1165. 10x10 rectangle.
  1166. .TP 8
  1167. d141 2
  1168. a142 2
  1169. 100x100 rectangle.
  1170. .TP 8
  1171. d144 2
  1172. a145 2
  1173. 500x500 rectangle.
  1174. .TP 8
  1175. d147 2
  1176. a148 2
  1177. 1x1 transparent stippled rectangle.
  1178. .TP 8
  1179. d150 2
  1180. a151 2
  1181. 10x10 transparent stippled rectangle.
  1182. .TP 8
  1183. d153 2
  1184. a154 2
  1185. 100x100 transparent stippled rectangle.
  1186. .TP 8
  1187. d156 2
  1188. a157 2
  1189. 500x500 transparent stippled rectangle.
  1190. .TP 8
  1191. d159 2
  1192. a160 2
  1193. 1x1 opaque stippled rectangle.
  1194. .TP 8
  1195. d162 2
  1196. a163 2
  1197. 10x10 opaque stippled rectangle.
  1198. .TP 8
  1199. d165 2
  1200. a166 2
  1201. 100x100 opaque stippled rectangle.
  1202. .TP 8
  1203. d168 2
  1204. a169 2
  1205. 500x500 opaque stippled rectangle.
  1206. .TP 8
  1207. d171 2
  1208. a172 2
  1209. 1x1 4x4 tiled rectangle.
  1210. .TP 8
  1211. d174 2
  1212. a175 2
  1213. 10x10 4x4 tiled rectangle.
  1214. .TP 8
  1215. d177 2
  1216. a178 2
  1217. 100x100 4x4 tiled rectangle.
  1218. .TP 8
  1219. d180 14
  1220. a193 2
  1221. 500x500 4x4 tiled rectangle.
  1222. .TP 8
  1223. d196 1
  1224. a196 1
  1225. .TP 8
  1226. d199 1
  1227. a199 1
  1228. .TP 8
  1229. d202 1
  1230. a202 1
  1231. .TP 8
  1232. d205 1
  1233. a205 1
  1234. .TP 8
  1235. d207 2
  1236. a208 2
  1237. 100-pixel line segment (1 clip rectangle).
  1238. .TP 8
  1239. d210 2
  1240. a211 2
  1241. 100-pixel line segment (2 clip rectangles).
  1242. .TP 8
  1243. d213 5
  1244. a217 2
  1245. 100-pixel line segment (3 clip rectangles).
  1246. .TP 8
  1247. d220 4
  1248. a223 1
  1249. .TP 8
  1250. d226 1
  1251. a226 1
  1252. .TP 8
  1253. d229 1
  1254. a229 1
  1255. .TP 8
  1256. d232 1
  1257. a232 1
  1258. .TP 8
  1259. d235 4
  1260. a238 1
  1261. .TP 8
  1262. d241 19
  1263. a259 1
  1264. .TP 8
  1265. d262 1
  1266. a262 1
  1267. .TP 8
  1268. d265 1
  1269. a265 1
  1270. .TP 8
  1271. d268 1
  1272. a268 1
  1273. .TP 8
  1274. d271 22
  1275. a292 1
  1276. .TP 8
  1277. d295 1
  1278. a295 1
  1279. .TP 8
  1280. d298 1
  1281. a298 1
  1282. .TP 8
  1283. d301 1
  1284. a301 1
  1285. .TP 8
  1286. d304 1
  1287. a304 1
  1288. .TP 8
  1289. d307 1
  1290. a307 1
  1291. .TP 8
  1292. d310 1
  1293. a310 1
  1294. .TP 8
  1295. d313 22
  1296. a334 1
  1297. .TP 8
  1298. d337 1
  1299. a337 1
  1300. .TP 8
  1301. d340 1
  1302. a340 1
  1303. .TP 8
  1304. d343 1
  1305. a343 1
  1306. .TP 8
  1307. d346 1
  1308. a346 1
  1309. .TP 8
  1310. d349 1
  1311. a349 1
  1312. .TP 8
  1313. d352 1
  1314. a352 1
  1315. .TP 8
  1316. d355 1
  1317. a355 1
  1318. .TP 8
  1319. d358 1
  1320. a358 1
  1321. .TP 8
  1322. d361 1
  1323. a361 1
  1324. .TP 8
  1325. d364 1
  1326. a364 1
  1327. .TP 8
  1328. d367 1
  1329. a367 1
  1330. .TP 8
  1331. d370 1
  1332. a370 1
  1333. .TP 8
  1334. d373 1
  1335. a373 1
  1336. .TP 8
  1337. d376 1
  1338. a376 1
  1339. .TP 8
  1340. d379 1
  1341. a379 1
  1342. .TP 8
  1343. d382 1
  1344. a382 1
  1345. .TP 8
  1346. d385 1
  1347. a385 1
  1348. .TP 8
  1349. d388 1
  1350. a388 1
  1351. .TP 8
  1352. d391 1
  1353. a391 1
  1354. .TP 8
  1355. d394 1
  1356. a394 1
  1357. .TP 8
  1358. d397 1
  1359. a397 1
  1360. .TP 8
  1361. d400 1
  1362. a400 1
  1363. .TP 8
  1364. d403 1
  1365. a403 1
  1366. .TP 8
  1367. d406 1
  1368. a406 1
  1369. .TP 8
  1370. d409 1
  1371. a409 1
  1372. .TP 8
  1373. d412 1
  1374. a412 1
  1375. .TP 8
  1376. d415 1
  1377. a415 1
  1378. .TP 8
  1379. d418 1
  1380. a418 1
  1381. .TP 8
  1382. d421 1
  1383. a421 1
  1384. .TP 8
  1385. d424 1
  1386. a424 1
  1387. .TP 8
  1388. d427 1
  1389. a427 1
  1390. .TP 8
  1391. d430 12
  1392. a441 1
  1393. .TP 8
  1394. d444 1
  1395. a444 1
  1396. .TP 8
  1397. d447 1
  1398. a447 1
  1399. .TP 8
  1400. d450 1
  1401. a450 1
  1402. .TP 8
  1403. d453 1
  1404. a453 1
  1405. .TP 8
  1406. d456 1
  1407. a456 1
  1408. .TP 8
  1409. d459 1
  1410. a459 1
  1411. .TP 8
  1412. d462 1
  1413. a462 1
  1414. .TP 8
  1415. d465 1
  1416. a465 1
  1417. .TP 8
  1418. d468 1
  1419. a468 1
  1420. .TP 8
  1421. d471 1
  1422. a471 1
  1423. .TP 8
  1424. d474 1
  1425. a474 1
  1426. .TP 8
  1427. d477 1
  1428. a477 1
  1429. .TP 8
  1430. d480 1
  1431. a480 1
  1432. .TP 8
  1433. d483 1
  1434. a483 1
  1435. .TP 8
  1436. d486 4
  1437. a489 1
  1438. .TP 8
  1439. d492 1
  1440. a492 1
  1441. .TP 8
  1442. d495 1
  1443. a495 1
  1444. .TP 8
  1445. d498 1
  1446. a498 1
  1447. .TP 8
  1448. d504 1
  1449. a504 1
  1450. X(1), xbench(1)
  1451. d508 1
  1452. a508 1
  1453. Copyright 1988, Digital Equipment Corporation.
  1454. @
  1455.