summaryrefslogtreecommitdiff
path: root/x11perf.h
diff options
context:
space:
mode:
authorKaleb Keithley <kaleb@freedesktop.org>2003-11-14 15:54:53 +0000
committerKaleb Keithley <kaleb@freedesktop.org>2003-11-14 15:54:53 +0000
commitd7d99c8433b3bd35c8bad352ebd1fc49cff45264 (patch)
tree83c0e24403636a9a639ebf5c2fcd4e3b7efecef7 /x11perf.h
R6.6 is the Xorg base-lineXORG-MAIN
Diffstat (limited to 'x11perf.h')
-rw-r--r--x11perf.h173
1 files changed, 173 insertions, 0 deletions
diff --git a/x11perf.h b/x11perf.h
new file mode 100644
index 0000000..b2a415c
--- /dev/null
+++ b/x11perf.h
@@ -0,0 +1,173 @@
+/* $Xorg: x11perf.h,v 1.3 2000/08/17 19:54:10 cpqbld Exp $ */
+/*****************************************************************************
+Copyright 1988, 1989 by Digital Equipment Corporation, Maynard, Massachusetts.
+
+ All Rights Reserved
+
+Permission to use, copy, modify, and distribute this software and its
+documentation for any purpose and without fee is hereby granted,
+provided that the above copyright notice appear in all copies and that
+both that copyright notice and this permission notice appear in
+supporting documentation, and that the name of Digital not be
+used in advertising or publicity pertaining to distribution of the
+software without specific, written prior permission.
+
+DIGITAL DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
+ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
+DIGITAL BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
+ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
+WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
+ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
+SOFTWARE.
+
+******************************************************************************/
+
+#ifndef VMS
+#include <X11/Xlib.h>
+#include <X11/Xutil.h>
+#else
+#include <decw$include/Xlib.h>
+#include <decw$include/Xutil.h>
+#endif
+#if defined(XlibSpecificationRelease) && XlibSpecificationRelease >= 5
+#include <X11/Xfuncs.h>
+#endif
+#ifndef NULL
+#define NULL 0
+#endif
+
+#define POLY 1000 /* # (small) items in poly calls */
+#define MAXROWS 40 /* Max rows of items in poly calls */
+#define MAXCOLS 25 /* Max columns of items */
+
+#define WIDTH 600 /* Size of large window to work within */
+#define HEIGHT 600
+
+#define CHILDSIZE 8 /* Size of children on windowing tests */
+#define CHILDSPACE 4 /* Space between children */
+
+#define BigTile ((char *)2) /* Big tile/stipple */
+#define OddTile ((char *)1) /* Odd sized tile/stipple */
+
+typedef Bool (*InitProc) (/* XParms xp; Parms p */);
+typedef void (*Proc) (/* XParms xp; Parms p */);
+
+extern void NullProc (/* XParms xp; Parms p */);
+extern Bool NullInitProc (/* XParms xp; Parms p */);
+
+typedef unsigned char Version;
+
+#define VERSION1_2 ((Version)(1 << 0))
+#define VERSION1_3 ((Version)(1 << 1))
+#define VERSION1_4 ((Version)(1 << 2))
+#define VERSION1_5 ((Version)(1 << 3))
+#define V1_2ONLY VERSION1_2
+#define V1_2FEATURE (VERSION1_2 | VERSION1_3 | VERSION1_4 | VERSION1_5)
+#define V1_3FEATURE (VERSION1_3 | VERSION1_4 | VERSION1_5)
+#define V1_4FEATURE (VERSION1_4 | VERSION1_5)
+#define V1_5FEATURE (VERSION1_5)
+
+typedef struct _Parms {
+ /* Required fields */
+ int objects; /* Number of objects to process in one X call */
+
+ /* Optional fields. (Wouldn't object-oriented programming be nice ?) */
+ int special; /* Usually size of objects to paint */
+ char *font, *bfont;
+ int fillStyle; /* Solid, transparent stipple, opaque stipple, tile */
+} ParmRec, *Parms;
+
+typedef struct _XParms {
+ Display *d;
+ Window w;
+ Pixmap p;
+ GC fggc;
+ GC bggc;
+ GC ddfggc;
+ GC ddbggc;
+ unsigned long foreground;
+ unsigned long background;
+ unsigned long ddbackground;
+ XVisualInfo vinfo;
+ Bool pack;
+ Version version;
+ Bool save_under;
+ int backing_store;
+ unsigned long planemask;
+} XParmRec, *XParms;
+
+typedef enum {
+ WINDOW, /* Windowing test, rop, planemask have no affect */
+ ROP, /* Graphics test, rop, planemask has some affect */
+ PLANEMASK, /* Graphics test, rop no affect, planemask some affect */
+ NONROP /* Graphics or overhead test, rop has no affect */
+} TestType;
+
+typedef struct _Test {
+ char *option; /* Name to use in prompt line */
+ char *label; /* Fuller description of test */
+ char *label14; /* Labels that are different in Version 1.4 */
+ InitProc init; /* Initialization procedure */
+ Proc proc; /* Timed benchmark procedure */
+ Proc passCleanup;/* Cleanup between repetitions of same test */
+ Proc cleanup; /* Cleanup after test */
+ Version versions; /* Test in 1.2 only, 1.3 only, or both */
+ TestType testType; /* Windowing, graphics rop, graphics non-rop */
+ int clips; /* Number of obscuring windows to force clipping*/
+ ParmRec parms; /* Parameters passed to test procedures */
+} Test;
+
+extern Test test[];
+
+#define ForEachTest(x) for (x = 0; test[x].option != NULL; x++)
+
+
+/*****************************************************************************
+
+About x11perf:
+
+Many graphics benchmarks assume that the graphics device is used to display the
+output of a single fancy graphics application, and that the user gets his work
+done on some other device, like a terminal. Such benchmarks usually measure
+drawing speed for lines, polygons, text, etc.
+
+Since workstations are not used as standalone graphics engines, but as
+super-terminals, x11perf measures window management performance as well as
+traditional graphics performace. x11perf includes benchmarks for the time it
+takes to create and map windows (as when you start up an application); to map a
+pre-existing set of windows onto the screen (as when you deiconify an
+application or pop up a menu); and to rearrange windows (as when you slosh
+windows to and fro trying to find the one you want).
+
+x11perf also measures graphics performance for operations not normally used in
+standalone graphics displays, but are nonetheless used frequently by X
+applications. Such operations include CopyPlane (used by the PostScript
+previewer), scrolling (used in text windows), and various stipples and tiles
+(used for CAD and half-toning, respectively).
+
+x11perf DOES NOT attempt to whittle down measurements to a single ``HeXStones''
+number. We consider such numbers to be uninformative at best and misleading at
+worst. x11perf should be used to analyze particular strengths and weaknesses
+of servers, and is most useful when used by a server writer who wants to
+analyze and improve a server.
+
+For repeatable results, x11perf should be run using a local connection on a
+freshly-started server. The default configuration runs each test 5 times, in
+order to see if each trial takes approximately the same amount of time.
+Strange glitches should be examined; if non-repeatable I chalk them up to
+daemons and network traffic. Each trial is run for 5 seconds, in order to
+reduce random time differences. The number of objects processed per second is
+displayed to 3 significant digits, but you'll be lucky on most UNIX system if
+the numbers are actually consistent to 2 digits.
+
+The current program is mostly the responsibility of Joel McCormack. It is
+based upon the x11perf developed by Phil Karlton, Susan Angebranndt, and Chris
+Kent, who wanted to assess performance differences between various servers.
+Mary Walker, Todd Newman, and I added several tests in order to write and tune
+the pmax (DECStation 3100) servers. For a general release to the world, I've
+basically rewritten x11perf to ease making comparisons between widely varying
+machines, to cover most important X functionality (the notable exception being
+wide lines), and to exercise graphics operations in as many different
+orientations and alignments as possible.
+
+******************************************************************************/