

                  PC Magazine Labs

             Laboratory Benchmark Series
   Software and documentation (c) 1989,90 PC Magazine


          =================================
          GRAPHICS PERFORMANCE TESTS
          OS/2 Presentation Manager version
          Release 1.0  --  November 1989
          =================================



Installation notes:

The PC Labs Graphics Performance Tests for OS/2 Presentation Manager
(Release 1.0) is distributed on one low density floppy (5.25"
360K diskette version also includes the Graphics Performance
Tests for Microsoft Windows; 3.5" 720K diskette version
incorporates the Hardware Performance Tests Release 5.5) or as
an archived file on PC MagNet, our on-line service associated
with CompuServe. The following three files are located on this
diskette in a directory named "PMBENCH":

README.PM - This file: a text file containing documentation.
PMBENCH.EXE - The Graphics Performance Tests benchmark program
REGISTER.PM - Form to send in to register or to make comments

In order to install the test simply copy the PMBENCH.EXE file
to the directory of your choice. The program can be executed
from within any current version of OS/2 Presentation Manager.
We also recommend that you keep a copy of this file along with
the test program.


The OS/2 Presentation Manager and Microsoft Windows versions of the
Graphics Performance Tests (which are both included on this diskette)
are quite similar in design and implementation in order to provide
comparative tests for the two environments. However, there are some
tests that are implemented slightly differently under each environment;
also, the Presentation Manager version contains some tests that are not
included in the Windows version. The differences exist because there are
graphics functions in Presentation Manager that are not available in
Windows, and therefor cannot be tested. For the specific details read
this README.PM file and the README.WIN file in the WINBENCH directory on
this diskette; these text files contain documentation about each of the
features of the two versions.




                        - Page 1 -


                           TABLE OF CONTENTS


Installation notes . . . . . . . . . . . . . . . . . . . . . . . . .   1

Introduction . . . . . . . . . . . . . . . . . . . . . . . . . . . .   4

BitBlt . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
       Alignment . . . . . . . . . . . . . . . . . . . . . . . . . .   5
       Overlap . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
       ROP's . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5
       Screen/Memory . . . . . . . . . . . . . . . . . . . . . . . .   5
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   5

Curves . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6
       Partial Arcs. . . . . . . . . . . . . . . . . . . . . . . . .   6
       Full Arcs . . . . . . . . . . . . . . . . . . . . . . . . . .   6
       PolySpline. . . . . . . . . . . . . . . . . . . . . . . . . .   6
       PolyFillet. . . . . . . . . . . . . . . . . . . . . . . . . .   6
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   6

Lines  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7
       Single Lines. . . . . . . . . . . . . . . . . . . . . . . . .   7
       Polylines . . . . . . . . . . . . . . . . . . . . . . . . . .   7
       All Directions. . . . . . . . . . . . . . . . . . . . . . . .   7
       Wide Lines. . . . . . . . . . . . . . . . . . . . . . . . . .   7
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   7

Polygons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8
       Alternate Fill. . . . . . . . . . . . . . . . . . . . . . . .   8
       Winding Fill. . . . . . . . . . . . . . . . . . . . . . . . .   8
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   8

Rectangles . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
       Boxes . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
       Random. . . . . . . . . . . . . . . . . . . . . . . . . . . .   9
       Patterns. . . . . . . . . . . . . . . . . . . . . . . . . . .   9
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .   9




                        - Page 2 -



Text . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  10
       Image Fonts . . . . . . . . . . . . . . . . . . . . . . . . .  10
       Background Mix. . . . . . . . . . . . . . . . . . . . . . . .  10
       Extended Text . . . . . . . . . . . . . . . . . . . . . . . .  10
       Greyed Text . . . . . . . . . . . . . . . . . . . . . . . . .  10
       Mixed Fonts . . . . . . . . . . . . . . . . . . . . . . . . .  11
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  11

Misc . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
       Set/Query Current Position. . . . . . . . . . . . . . . . . .  12
       Markers . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
       Stretch . . . . . . . . . . . . . . . . . . . . . . . . . . .  12
       Image Data. . . . . . . . . . . . . . . . . . . . . . . . . .  12
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  12

User Interface . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
       Menus . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13
       Dialog Boxes. . . . . . . . . . . . . . . . . . . . . . . . .  13
       Rubber Banding. . . . . . . . . . . . . . . . . . . . . . . .  13
       Scroll Window . . . . . . . . . . . . . . . . . . . . . . . .  13
       Clear Window. . . . . . . . . . . . . . . . . . . . . . . . .  13
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  13

Clipping . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14
       Complex Clipping. . . . . . . . . . . . . . . . . . . . . . .  14
       Region Clipping . . . . . . . . . . . . . . . . . . . . . . .  14
       All . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  14

Options  . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .  15
       System Information. . . . . . . . . . . . . . . . . . . . . .  15
       Modify Options. . . . . . . . . . . . . . . . . . . . . . . .  15
                   Display results . . . . . . . . . . . . . . . . .  15
                   Spreadsheet Output. . . . . . . . . . . . . . . .  15
                   Iteration Multiplier. . . . . . . . . . . . . . .  16
       Run All Tests . . . . . . . . . . . . . . . . . . . . . . . .  16
       Demo Mode . . . . . . . . . . . . . . . . . . . . . . . . . .  16



                        - Page 3 -

Introduction

This document describes the PC Magazine Labs Graphics Performance tests
for OS/2 Presentation Manager (Release 1.0  --  November 1989). The
Benchmark program provides a set of benchmark tests that determine
overall performance information for OS/2 Presentation Manager display
drivers and graphics display boards.

To run the benchmarks you may select each test separately, or you may run
a set of tests by selecting the "All" menu item from each of the function
menus on the menu bar.  You can run all the tests consecutively by selecting
"Run All Tests" from the "Options" menu or by pressing the "Ctrl+R" key
combination on the keyboard.  A Demo mode is also provided.  To start the
demo mode select the "Demo Mode" menu item under "Options" or press the
"Ctrl+D" keys.  To exit demo mode you must strike an ESCAPE, SPACEBAR
or ENTER key or terminate the timing dialog box using the keyboard or
mouse before it is destroyed.  If a key is struck to exit demo mode, the
current test will be finished before the benchmark actually terminates the
demo mode, however the timing dialog box for that test will not be displayed.
In demo mode, the timing dialog boxes will be displayed for about 5 seconds
and then will automatically be destroyed before proceeding to the next test.

Dialog boxes, which display timing information after each test, must be
cleared before executing subsequent tests.  Alternatively, you may turn off
these dialog boxes by selecting "Modify Options" under the "Options" menu.
Set the "No" radio button on "Display Results".  "Modify Options" may also be
reached by pressing the "Ctrl-M" key combination on the keyboard.

Timing results may be saved in a file.  To save the timings bring up the
"Modify Options" dialog box and set the "Yes" radio button for "File Output".
This will enable the "File Options" box and allow Text, Excel, or Lotus
compatible file output to be specified. If a file with the specified filename
already exists in the current directory (e.g. from a previous run of the
tests) the existing file will remain unchanged AND THE NEW FILE WILL NOT BE
SAVED. Note that a file name along with a 255 character file header can be
entered if the default name and header are not acceptable. Be sure to give
your files new names each time (or move the files to another directory) to
insure that the filename does not conflict with an existing file.

                        - Page 4 -


BitBlt

Description:

    These selections test the performance of GpiBitBlt using various
  alignments, 15 of the most common ROP operations, and random bitblts from
  memory to screen, screen to memory and memory to memory.

Menu Items:

Alignment
    This selection bitblts 32x32, 64x64, 128x128, and 256x256 rectangles from
  destination to source using the following alignments: Source Aligned
  Destination Aligned, Source Aligned Destination Not Aligned, Source Not
  Aligned Destination Aligned, and Source Not Aligned Destination Not Aligned.

Overlap
    Overlap tests the speed of blting overlapping rectangular bitmaps.  The
  test overlaps bitmaps by eight pixels in both horizontal and vertical
  directions.

ROP's
    ROP's tests 15 of the most common Raster Operations (ROP's) whose
  source and destination are Screen to Screen, Memory to Screen, and
  Memory to Memory. The ROP's tested are SRCCOPY, SRCPAINT, SRCAND,
  SRCINVERT, SRCERASE, NOTSRCOPY, NOTSRCERASE, MERGECOPY,
  MERGEPAINT, PATCOPY, PATPAINT, PATINVERT, DSTINVERT, ZERO, and ONE.

Screen/Memory
    This menu item bitblts randomly placed 64x64 monochrome bitmaps from
  screen to screen and from memory to screen.

All
    Selecting the "All" option will run each of the "Bitblt" menu items
  consecutively.



                        - Page 5 -


Curves


Description:

This menu selection tests output of partial and full arcs, polysplines and
polyfillets.



Menu Items:


Partial Arcs
    This benchmark test draws four sets of arcs.  Each set comprises of the
  default arc parameters (unit circle), major axis parallel to x axis, major
  axis parallel to the y axis, and tilted.  Eight 45 degree partial arcs at
  twelve different radii are drawn for each set.


Full Arcs
    Full arcs draws filled and outline arcs using the same arc parameters as
  Partial Arcs.  The routine draws eleven arcs with different radii.


PolySpline
    The polyspline test tests the output of GpiPolySpline.  It is called with
  10 splines per a call.  The output is a sine like wave across the middle of
  the display.


PolyFillet
    PolyFillet tests output of the GpiPolyFillet call.  PolyFillet outputs
  random fillets on the display.  There are 50 polyfillet calls made with
  five fillet points per call.


All
    Selecting the "All" option will run each of the "Curve" menu items
  consecutively.




                        - Page 6 -



Lines



Description:

Lines tests the drawing of single lines, polylines, single long lines drawn
in all directions, and wide lines.



Menu Items:


Single Lines
    Single Lines draws 100 horizontal, vertical and diagonal solid lines.
  All 100 lines of each type (horizontal, vertical, or diagonal) use the same
  beginning and end points.  Therefore, only a total of three lines will be
  visible in the window.


Polylines
    The polyline test look exactly like the single line test.  PolyLines,
  however, use the GpiPolyLine call to output 100 horizontal, vertical or
  diagonal solid lines for each polyline call.  Again you will only see three
  lines on the display.


All Directions
    This test draws lines in all directions.  A large box, centered in the
  middle of the display is filled by drawing radial lines around the
  perimeter of the box from its center.  For each box, the line colors are
  changed by alternating through the color table.


Wide Lines
    For each of line widths 3, 5, 10, 20 the wide line test draws 25 random
  lines. Each width is repeated twice.  The first time it uses a solid fill
  and the second time a DENSE3 pattern fill is used.


All
    Selecting the "All" option will run each of the "Line" menu items
  consecutively.




                        - Page 7 -



Polygons



Description:

This set of tests test the speed at which alternate and winding area fills
are done.



Menu Items:


Alternate Fill
    This test draws a hour glass shaped polygon and then fills it using
  Alternate fill attribute, repeating for ten iterations.



Winding Fill
    Winding fills draws two overlapping triangle polygon and then fills it
  using Winding fill attribute. Winding Fill also repeats ten iterations.



All
    Selecting the "All" option will run each of the "Polygon" menu items
  consecutively.









                        - Page 8 -



Rectangles


Description:

This menu selection benchmarks square and rounded cornered filled rectangles,
random sized rectangles and patterned filled rectangles.


Menu Items:


Boxes
    This item first draws fifty square rectangles, which are filled and
  outlined, from smaller to larger sizes.  Then repeats itself by drawing
  the rectangles from large to small.  The test then draws fifty rounded
  corner rectangles in a similar manner as the square cornered rectangles.


Random
    Random draws random sized rectangles randomly on the display in colors
  alternating between the colors of the color table.


Patterns
    Patterns draws client window sized rectangles each filled with a default
  pattern. The patterns alternate between the first 16 pre-defined pattern
  choices.


All
    Selecting the "All" option will run each of the "Rectangle" menu items
  consecutively.




                        - Page 9 -



Text


Description:

The Text menu tests image fonts, background mix modes, text extension, greyed
text and mixed fonts output.



Menu Items:


Image Fonts
    Image fonts draws the string: "The quick brown fox jumped over the lazy
  sleeping dog's back then sat on a tack."  The text is first drawn in the
  system font and then is drawn using the first 15 non-vector fonts of the
  HELV.FON file.  This font is loaded by the benchmark program and must be
  available in the C:\OS2\DLL.


Background Mix
    Background mix draws the above text string in the system font using the
  background attributes of LEAVEALONE and then OVERPAINT.  The first test
  fills the entire client window with a pale gray color.  Then it sets the
  color back to default and mode to LEAVEALONE.  100 lines of text are output
  to the display.  The second test again fills the client window with pale
  gray but this time it changes the color to yellow instead of default and
  background mode to OVERPAINT.  One hundred lines of text are output.  The
  background of the text should be yellow.


Extended Text
    Extended text displays the string: "Extended Text Anyone" using different
  character width vectors.  The extended text function writes 24 lines of the
  extended text string.


Greyed Text
    The string "Grey text" is randomly placed on the display using a cyan
  background, a black foreground and the halftone attribute.



                        - Page 10 -



Mixed Fonts

    Mixed fonts writes the following four strings to the display:

          The quick brown fox jumped over the lazy sleeping dog
          The quick brown fox jumped over the lazy sleeping dog
          The quick brown fox jumped over the lazy sleeping dog
          The quick brown fox jumped over the lazy sleeping dog

    The first line is written in the default font.  The second line is
  written with the default font with some of the words underlined.  The third
  line has some words bolded and the fourth line has some italicized print.
  These four lines are repeated six times down the display.



All
    Selecting the "All" option will run each of the "Text" menu items
  consecutively.














                        - Page 11 -



Misc


Description:

Misc tests miscellaneous functions: set and query current position, drawing
markers, stretch/compress bitblt, and image data.


Menu Items:

Set/Query Current Position
    This test shows nothing on the window.  The test calls the
  GpiSetCurrentPosition and GpiQueryCurrentPosition 1000 times each.


Markers
    Markers draws 100 of each of the default following marker types:
  Default, Eight point star, Solid Diamond, Dot, and Small Circle.


Stretch
    Stretch test the speed of doing Bitblt compression and expansion.  A
  64x64 monochrome bitmap is loaded and then compress or stretch to the
  following sizes: 32x32, 48x48, 80x80, 96x96, 192x192, 32x48, 48x96, 48x32,
  108x96, 21x21, 105x105.


Image Data
    A bitmap is created in memory.  The image is then display on the screen
  in all combinations of foreground and background colors in a 16x16 matrix.


All
    Selecting the "All" option will run each of the "Misc" menu items
  consecutively.




                        - Page 12 -



User Interface


Description:

Special tests for pull-down menus, creating and deleting dialog boxes,
drawing rubberband lines, scrolling windows, and clearing windows.



Menu Items:


Menus
    Displays and removes the pull-down menus of the Benchmark menu bar.  It
  cycles through the entire menu bar 10 times.


Dialog Boxes
    Dialog boxes creates and kills a dialog box 10 times.


Rubber Banding
    Rubber banding draws a rectangular box and then rubberbands it across
  the window 100 times and then back again.


Scroll Window
    This test scrolls byte aligned and non-byte aligned text vertically
  through a rectangular region in the window.


Clear Window
    Clear window clears the display 50 times to a gray background color
  using GpiErase.


All
    Selecting the "All" option will run each of the "User Interface" menu
  items consecutively.




                        - Page 13 -


Clipping


Description:

Clipping test bitblt, line and text clipping using disjoint rectangular
and complex clip paths.


Menu Items:


Complex Clipping
    Region Clipping tests Bitblt, Line and Text clipping in a oval complex
  clipping region.


Region Clipping
    Region Clipping tests Bitblt, Line and Text clipping in a clipping region
  comprising of 4 disjoint rectangles.


All
    Selecting the "All" option will run each of the "Clipping" menu items
  consecutively.








                        - Page 14 -


Options

Description:

The options menu item allows you to display system information, run the
benchmark in a demo mode or just run through all the tests once, as-well-as
configure the program to your particular needs.  The default configuration
options are Display Results, No Spreadsheet Output, and Iteration Multiplier
of 1.

Menu Items:

System Information
    Supplies the user with some system configuration information.  The
  following list shows what information is displayed:

                       Width and Height of the screen
                       Width and Height of the window
                       Width and Height of icons
                       Number of color planes
                       Number of bits per a pixel
                       Number of simultaneously useable colors
                       Number of device fonts
                       Aspect ratio

Modify Options
    Choosing this item will allow you to reconfigure the Benchmark program.
  You may reach this option by pressing the "Ctrl-M" key combination on the
  keyboard.

       Display results
          Enables the result dialog boxes to appear or not appear in the
          window. The default is Display Results enabled.

       Spreadsheet Output
          Enables timing results to be sent to a text file.  Text output is
          formatted to be ascii text, Microsoft EXCEL compatible or LOTUS 123
          compatible depending on which radio button is selected.  The
          default output format is ascii text.

          A file name and 255 character header may also be specified*.  The
          default file names are pmbench.txt for ascii text, pmbench.xls for
          EXCEL and pmbench.wks for LOTUS 123.  The default file header is
          "Benchmark Results".

*NOTE: If a file with the specified filename already exists in the current
directory (e.g. from a previous run of the tests) the existing file will
remain unchanged AND THE NEW FILE WILL NOT BE SAVED. Be sure to give your
files new names each time (or move the files to another directory) to insure
that the filename does not conflict with an existing file.

                        - Page 15 -



       Iteration Multiplier
           Allows you to increase the number of times Benchmark will execute
           each of the tests.  You may choose 1, 2, 3, 5, or 10. For EGA or
           VGA systems use 1 or 2. Settings of 5 and above are recommended
           for display adapters with graphics coprocessors. If you obtain a
           variation of more than 1 ms. between executions of any test,
           increase the iteration multiplier.

Run All Tests
    Picking this option will execute all of the available test in Benchmark
  using the choices supplied in the Option Menu or the defaults if Modify
  Options have not been changed.  You can choose this option by pressing
  the "Alt-R" key combination on the keyboard.



Demo Mode
    Choosing demo mode allows you to run the benchmark continuously.  To exit
  demo mode, enter a ESCAPE, SPACEBAR or ENTER key at any time while the
  test is running, or you may terminate the dialog box using the keyboard
  or mouse before it is destroyed.  Timing dialog boxes always display while
  in demo mode.  However, the dialog boxes are only displayed for 5 seconds
  and are destroyed automatically before subsequent tests are run.
  Spreadsheet output is disabled while running in demo mode.












                        - Page 16 -



Any comments about the tests should be submitted on the accompanying
registration form to the following address:

     PC Magazine Labs
     ATTN: Presentation Manager Benchmark Registration
     One Park Avenue
     New York, New York 10016

PC Magazine Labs retains all rights to these tests but we do grant you the
specific right to make an unlimited number of UNALTERED copies of
the tests provided you do not charge anything for them; these tests are
distributed as a public service of PC Magazine and are meant to be
widely distributed at no charge to the user. The PC Magazine Labs
Graphics Performance tests for OS/2 Presentation Manager (Release 1.0,
November 1989) were programmed according to PC Magazine Labs
specifications by Graphic Software Systems (GSS).

Thank you for your interest in the PC Magazine Labs Graphics
Performance tests for OS/2 Presentation Manager.


Sincerely,


Frederic E. Davis
Director, PC Magazine Labs






                        - Page 17 -
