PDDR/2 - Printer Test Tool (PTT)

Printer Device Driver Reference
About this Book & Introduction Generic Printer Library 32-Bit PostScript Driver 32-Bit Plotter Presentation Driver The 42XX Rasterizing Driver 32-bit Omni Presentation Driver Printer Bidirectional Communications Font Test 32-Bit Printing Utility Printer Test Tool (PTT) Importing PostScript Printer Description files Notices Glossary

Reprint Courtesy of International Business Machines Corporation, © International Business Machines Corporation

Printer Test Tool (PTT)

The Printer Test Tool (PTT) is a Presentation Manager application that enables the user to select one or more tests and execute them.

Overview

The PTT provides a mechanism for testing s by calling graphics programming interface (GPI) functions. Each call, on execution, produces quantifiable output by which the test can be measured. As each test is run, the PTT monitors the return codes from the GRE calls and writes the results to a log file. The current log file can be displayed at any time during manual testing.

PTT Architecture

The PTT is comprised of two major components:

• A PM master program (PTT.EXE) that provides the user interface for test selection and execution.
• Test-case dynamic-link libraries (DLLs) that contain the actual test-case executable code.

PTT Master Program

PTT.EXE enables the user to do the following:

• Select one or more tests from the test cases available.
• Execute the selected test cases on demand.
• Specify a test-case PM environment (PS units, PS types, and so forth).
• Display the PTT test log.
• Set the PTT test-logging level.
• Display the PTT release level.
• Exit PTT.

Command-line options enable the user to specify the following:

• Output log file name
• Level of logging to capture
• Search patterns for DLLs to be preloaded.

Test-Case DLLs

Each test-case DLL contains tests for a family of GPI calls. See #GPI Function Tests (32-Bit) for descriptions of the supplied test-case DLLs and the GPI functions called.

Note: The test-case DLLs must reside in the same directory as the PTT executable.

Operating PTT

The PTT can be started from the command line in either an OS/2 window or a full-screen session. The PTT can also be started from the OS/2 Desktop or any other folder by using its icon. When using an icon, command-line options are specified in the Optional Parameters field of the Settings menu for the icon.

Specifying Command Options

All command-line options are specified with a hyphen (-), followed by a case-sensitive alphabetic character. The alpha character is followed immediately by the parameter value, if any, with no intervening spaces. Following are examples of PTT command lines.

Load all DLLs in the current directory and set the logging level to 8:

PTT -T*.DLL -L8

Preload the GRELINE DLL. (Search LIBPATH to locate the DLLs.)

PTT -Tgreline.dll

Executing PTT with the -? command-line option displays a list of the valid command-line options.

PTT -?

Menu Selections

The following options are available on the PTT menu:

Testcases
Test Groups	Lists all DLLs loaded.
Test Cases	Lists all test cases available for the selected Test Groups.
Add Match	Adds the selected match pattern from the chosen list.
Save	Saves the entries selected.
Cancel	Cancels this action and returns to the main options.
Delete Match	Deletes the selected match pattern from the test case list.
Help	Not available.
Actions
Display to Screen	Displays the output of the test case to the screen.
Start Printing	Prints the test case to an attached printer.
Options
Configuration	Configures printer, DC, data type, PS Units, PS type. See "Configuring the Device Context and Presentation Space" for more information about configuring PTT DLLs.
Display Log Window	Displays PASS/FAIL logging window.
Change Log Window	Selects a level (1 - 9).
Help
Help	Not available.
About	Displays an application message and version number. There is no on-line Help with PTT.
Exit
(No drop-down)	Exits PTT. (Available only when using a mouse.) Use the accelerator key, Alt+F4.

Locating, Preloading, and Loading Test-Case DLLs

Each test case DLL passes a list of its test cases to PTT when PTT initializes the DLL after loading. A test-case index file associates each test-case name with the DLL that contains it. When duplicate test cases are encountered while loading DLLs and test-case index files, only the first instance of a test case is retained.

PTT locates the test cases using the following sequence:

1. DLLs specified using the -T command-line option are preloaded during PTT startup. Preloaded DLLs remain resident for the duration of the PTT session.

The -T command-line option specifies a search pattern for locating the test -case DLLs to be preloaded. The -T option value can contain global file-name characters (wildcards) in the file name. Following is an example of the command used to preload DLLs:

Preload all DLLs in the PTT\DLL directory on the current drive.

PTT -T\PTT\DLL\*.DLL

The -T command-line option can be specified multiple times (on the command line) with different paths to the DLLs.

2. At this point, if no test cases have been identified to PTT, PTT attempts to preload all the test-case DLLs it can locate using a *.DLL search pattern. This searches the current directory.

3. If PTT fails to locate any test-case DLLs in the current directory, a message to that effect is issued.

An OK check box in the informational window permits the user to continue bringing up PTT.

PTT Log File

PTT writes information to a log file. The information to be logged is determined by the current logging level, which is hierarchical. At any given logging level, all information at that level and below is logged.

Specifying the PTT Log File Name

A path and file name for the PTT log file can be specified on the PTT command line using the -F option. If no log file name option is given on the command line, the default file name, PTT_LOG in the current directory, is used. If a log file does not exist when PTT is started, the log file is created automatically. If the log file does exist, the new log is appended to the existing log file.

Specifying the PTT Logging Levels

The PTT logging level can be specified on the PTT command line or changed from the Options pull-down menu after PTT has started. To set the logging level on the command line, specify a -Lxoption, where xis the desired logging level, using a number in the range 1-9. To change the logging level after PTT has started, select Change logging levelfrom the Options pull-down menu or use the accelerator key, Alt+L. The default PTT logging level is 1, L_HDR.

The following table describes the logging levels supported by PTT:

Level	Level Name	Description
1	L_HDR	Test Pass/Fail logging only.
2	L_ABORT	Test case failed. Test is incomplete.
3	Reserved.	Do not use.
4	L_FAIL	Internal test-case failure. An interface other than the call currently being tested has experienced a functional or other type of failure.
5	Reserved	Do not use.
6	L_WARN	Warning The presentation space is improperly configured for the test case (or a similar error).
7	L_TRACE	Trace commands, incorrect values, or other unexpected results.
8	L_LOTRACE	Location trace. Log entries and exits of internal test-case routines.
9	L_DEBUG	Debugging. Test-case debugging information, internal test-case results, errors, and other information.

Displaying the PTT Log File

To display the PTT log file for the current session, select Display log window from the Options menu or use Alt+D.

Configuring the Device Context and Presentation Space

PTT enables you to specify the device context, presentation-space type, and presentation-space units to use when executing test cases. These parameters can be changed during testing. To change the configuration manually, select Configuration from the Options pull-down menu or use Alt+C.

Setting the Device Driver

To set or change the device driver, select one of the optional s available in the Printer Queue, Printer Name, and Printer Port window by clicking the mouse on the desired driver. If a device driver is installed after PTT is initiated, the user can select Refresh Printer Driver List to list the other optional device drivers.

Setting the Device Context

To set or change the device context, select one of the following options from the Device Context section of the PTT Configuration dialog panel:

OD_QUEUED

Output is to be queued. (This is the default.) This option is for hardcopy drivers only. The driver opens a spool file and uses the spooler's Spl interface to send output to that file. The driver must consider the data type if this option is chosen. The following data types are available:

PM_Q_STD

The hardcopy driver uses the spooler to create a device-independent spool file using the Spl interfaces. See #Setting the Data Type.

PM_Q_RAW

The hardcopy driver processes the GRE functions to generate device-specific output data. This data is written to a spool file using the spooler Spl interfaces. See #Setting the Data Type.

OD_DIRECT

Output is not queued. The presentation driver processes the GRE routines to generate device-specific data. Hardcopy drivers use the Prt interface routines to pass the output to the physical device driver.

OD_INFO

The presentation driver does not generate any output. The information device context is used only to retrieve information.

OD_METAFILE

The device context is used to write a metafile. The option is handled by PMGPI and never is passed to the device driver.

OD_METAFILE_NOQUERY

This is the same as OD_METAFILE, except querying of attributes is not permitted. The option is handled by PMGPI and never is passed to the device driver.

OD_MEMORY

This is a device context that is used to contain a bit map. The device driver processes the output data the same as for an OD_DIRECT device type, except the output is written to a bit map that is compatible with the physical device. (PTT creates the bit map and associates it with the device context.)

Setting the Queue Processor

To select the data type to be used when executing test cases, use the mouse to click on the queue processor that is available in the window.

Setting the Data Type

To select the data type to be used when executing test cases, select one of the following options in the Data Type check box of the PTT Configuration dialog panel:

• PM_Q_RAW Raw data.
• PM_Q_STD Metafile-formatted data. (This is the default.)

Setting the Presentation-Space Type

To select the presentation-space type to be used when executing test cases, choose one of the following options from the PS Type section of the PTT Configuration dialog panel:

• GPIT_MICRO Micro-presentation space.
• GPIT_NORMAL Normal presentation space. (This is the default.)

Setting Presentation-Space Units

To set the presentation page-size units for test-case execution, select one of the following from the PS Units section of the PTT Configuration dialog panel:

• PU_ARBITRARY Application-convenient units.
• PU_PELS Pel coordinates. (This is the default.)
• PU_LOMETRIC Units of 0.1 mm.
• PU_HIMETRIC Units of 0.01 mm.
• PU_LOENGLISH Units of 0.01 inch.
• PU_HIENGLISH Units of 0.001 inch.
• PU_TWIPS Units of 1/1440 inch.

Selecting and Executing Test Groups and Test Cases

The test cases to be executed are selected from the Test Case Selection dialog panel. Select Testcase from the PTT menu bar or use ALT+T. One or more test cases can be selected for execution during manual operation.

Test Group Selection

There is a 1:n relationship between test groups and test-case DLLs. Each test group represents a specific DLL. Before a test case can be selected, the test group containing the test case must be selected from the Test Groups section of the PTT Test Case Selection dialog panel. When you select a test group, the list of test cases it contains is added to the Test Cases section of the dialog panel. De-selecting a test group removes the list of test cases it contains from the Test Cases section.

Note: Test groups must be de-selected specifically. PTT never de-selects a test group automatically.

Test Case Selection

Once the test groups are selected, the individual test cases can be selected from the Test Cases section of the PTT Test Case Selection dialog panel. Test cases can be selected and de-selected individually, or groups of test cases can be selected with the match patterns provided using the Add Match and Delete Match push buttons.

Note: Test cases must be de-selected specifically unless the user's test group is de-selected. When that happens, all test cases are de-selected and made unavailable. The PTT never de-selects a test case automatically.

Saving Selected Test Cases

After selecting one or more test cases, use the Save push button or Alt+S to close the Test Case Selection dialog panel.

Executing Test Cases

After selecting and saving one or more test cases, select Display to Screen from the Action topic of the PTT menu bar, or use Alt+S to begin test-case execution to the monitor or display output device. To send the output of the test case to the printer, select Start Printing from the Action topic of the PTT menu bar. Each test case selected is executed in the order it appeared in the Test Cases section of the Test Case Selection dialog panel.

During test execution, ***** Printer Test Tool: Test Running ***** appears in the PTT window title bar. When the test is complete, the name of the individual test selected reappears in the title bar if a single test was selected. Printer Test Tool: MULTIPLE TESTS SELECTED appears if more than one test is selected.

Displaying the PTT Release and Revision Levels

To display the current PTT release and revision levels, select About from the PTT menu bar or use ALT+A.

Exiting PTT

To terminate PTT, select Exit from the PTT menu bar or use ALT+F4 from the keyboard.

GPI Function Tests (32-Bit)

This section shows the GPI calls made by the Printer Test Tool's test groups. The following tables are organized by test group. Each table lists the test cases in the group and the functions tested by each test case. Configuration Settings describes settings that must be selected in the Configuration dialog box to run the test. If no Configurations Settings are specified, use the default settings of OD_QUEUED, PM_Q_STD, GPIT_MICRO, and PU_PELS.

Note: These tables represent GPI calls for the 32-bit PTT.

GPIARC Test Group

The GpiArc test case verifies printer drivers' arc-related functionality. This test case consists of precision, functionality, and exhaustive tests.

The precision tests verify the GPI Arc APIs for page positioning and different arc shapes sizing. The functionality test verifies the GPI Arc APIs as they function together and with other GPI APIs such as GpiBeginPath and GpiEndPath. Exhaustive testing of the GPI Arc APIs involves verifying the functionality of a given API with respect to the print driver.

This table lists the test cases and the functions called by each test case in the GpiArc test group. The GpiArc test group is found in GPIARC.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiArcPre1	GpiFullArc GpiMove GpiPartialArc GpiPointArc GpiSetArcParams
GpiArcPre2	GpiMarker GpiMove GpiPolyFillet GpiPolyFilletSharp GpiPolySpline GpiSetArcParams
GpiArcApp	GpiMove GpiPartialArc GpiPointArc GpiPolyFillet GpiPolyFilletSharp GpiPolySpline GpiQueryCurrentPosition GpiSetArcParams GpiSetPattern
GpiSetArcParamsExh1	GpiFullArc GpiMove GpiPartialArc GpiPointArc GpiQueryArcParams GpiSetArcParams
GpiSetArcParamsExh2	GpiBeginArea GpiBeginArea GpiEndArea GpiFullArc GpiLine GpiMove GpiPartialArc GpiQueryArcParams GpiSetArcParams GpiSetPattern
GpiSetDefArcParamsExh1	GpiFullArc GpiMove GpiPartialArc GpiPointArc GpiQueryDefArcParams GpiResetPS GpiSetDefArcParams
GpiSetDefArcParamsExh2	GpiBeginArea GpiEndArea GpiFullArc GpiMove GpiPartialArc GpiQueryDefArcParams GpiResetPS GpiSetArcParams GpiSetDefArcParams GpiSetPa
GpiFullArcExh	GpiFullArc GpiMove GpiSetArcParams GpiSetPattern
GpiPartialArcExh	GpiMove GpiPartialArc GpiSetArcParams GpiSetPattern
GpiPointArcExh	GpiMove GpiPointArc
GpiPolyFilletExh	GpiMove GpiPolyFillet
GpiPolyFilletSharpExh	GpiMove GpiPolyFilletSharp
GpiPolySplineExh	GpiMarker GpiMove GpiPolySpline

GpiArea Test Group

The GpiArea test group tests area manipulation functions. All tests include a basic functionality test and an exhaustive (test all return codes at the lowest level) test.

This table lists the test cases and the functions called by each test case in the GpiArea test group. The GpiArc test group is found in GPIAREA.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiAreaApp	GpiBox GpiMove GpiSetPattern
GpiBeginAreaExh	GpiBeginArea GpiEndArea GpiMove GpiPolyLine GpiSetPattern
GpiSetAndQryPatternExh	GpiBox GpiCharStringAt GpiEndArea GpiFullArc GpiMove GpiPolyLine GpiQueryPattern GpiSetArcParams GpiSetPattern
GpiSetAndQryPatternSetExh	GpiBeginArea GpiBox GpiDeleteSetId GpiEndArea GpiFullArc GpiMove GpiPolyLine GpiQueryBitmapParameters GpiQueryPatternSet GpiSetArcParams GpiSetBitmapId GpiSetCharSet GpiSetPatternSet	Direct and Standard or Queued and Raw
GpiSetAndQryPatternRefPointExh	GpiBeginArea GpiBox GpiEndArea GpiFullArc GpiMove GpiPolyLine GpiQueryPatternRefPoint GpiSetArcParams GpiSetAttrMode GpiSetPattern GpiSetPatternRefPoint
GpiPaintRegionExh	GpiBeginPath GpiCreateRegion GpiDestroyRegion GpiEndPath GpiMove GpiPaintRegion GpiPolyFillet GpiPolyLine GpiSetColor GpiSetLineWidthGeom GpiSetPattern GpiStrokePath

GpiBitmaps Test Group

The GpiBitmaps test group tests bit map manipulation functions. These functions include creating, deleting, querying, selecting, and manipulating bit maps.

All tests include a basic functionality test and an exhaustive (test all return codes at the lowest level) test.

Limitations: All hard-copy vector devices will fail on all bit map operation since it is impossible to translate bit maps to vectors.

This table lists the test cases and the functions called by each test case in the GpiBitmaps test group. The GpiBitmaps test group is found in GPIBTMP.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiBitPre1	GpiDeleteBitmap GpiDestroyPS GpiSetColor GpiWCBitBlt
GpiBitPre2	GpiBitBlt GpiBitBlt GpiConvert GpiConvert GpiCreateBitmap GpiCreatePS GpiDeleteBitmap GpiDestroyPS GpiQueryDevice GpiSetBitmap GpiSetColor	Direct
GpiBitApp1	GpoBitmapFormats GpiBeginArea GpiBitBlt GpiBox GpiCreateBitmap GpiCreatePS GpiDeleteBitmap GpiDestroyPS GpiEndArea GpiErase GpiMove GpiPolyLine GpiQueryBitmapParameters GpiQueryDevice GpiSetBitmap GpiSetBitmapBits GpiSetColor GpiSetPattern	Direct
GpiBitApp2	GpiPtVisible GpiQueryPel GpiSetColor GpiSetPel
GpiBitApp3	GpiBox GpiCreateBitmap GpiDeleteBitmap GpiDeleteSetId GpiMove GpiQueryBitmapHandle GpiSetBackMix GpiSetBitmapId GpiSetColor GpiSetPatternSet GpiSetPatternSet	Direct
GpiBitApp4	GpiDeleteBitmap GpiLoadBitmap GpiQueryBitmapParameters GpiWCBitBlt	Direct
GpiSetPelExh	GpiPtVisible GpiQueryPel GpiSetColor GpiSetPel
GpiBitBltExh	GpiBitBlt GpiCreateBitmap GpiCreatePS GpiDeleteBitmap GpiDestroyPS GpiQueryDevice GpiSetBitmap GpiSetBitmapBits	Direct
GpiSetBitmapBitsExh	GpiBitBlt GpiCreatePS GpiDeleteBitmap GpiDestroyPS GpiQueryBitmapBits GpiQueryDevice GpiSetBitmap GpiSetBitmapBits	Direct
GpiSetBitmapIdExh	GpiBox GpiCreateBitmap GpiDeleteBitmap GpiDeleteSetId GpiMove GpiQueryBitmapHandle GpiSetBitmapId GpiSetColor GpiSetPatternSet	Direct
GpiWCBitBltExh	GpiCreateBitmap GpiDeleteBitmap GpiSetColor GpiWCBitBlt
GpiSetBitmapDimensionExh	GpiDeleteBitmap GpiQueryBitmapDimension GpiSetBitmapDimension
GpiLoadBitmapExh	GpiBitBlt GpiCreatePS GpiDeleteBitmap GpiDestroyPS GpiLoadBitmap GpiQueryBitmapParameters GpiQueryDevice GpiSetBitmap	Direct
GpiQueryDeviceBitmapFormatsExh	GpiQueryDeviceBitmapFormats
GpiQueryBitmapParametersExh	GpiCreateBitmap GpiDeleteBitmap GpiQueryBitmapParameters

GpiChar Test Group

The GpiChar test group tests GPI text functions that:

• Set and query the current value of the baseline angle.
• Set and query the current value of the character box attribute.
• Set and query the current value of the character direction attribute.
• Set and query the current value of the character-mode attribute.
• Set and query the current value of the character-shear angle.
• Draw a character string at the current character position.
• Draw a character string at a specified character position.
• Set and query the position at which each character in a string is drawn with positioning controls.
• Set and query the position at which each character in a positioned string is drawn with positioning controls.
• Query the size of the default graphics character box.
• Query the relative coordinates of the four corners of a text box.

This testcase includes application tests that test the behavior of these character functions with other GPIs.

This table lists the test cases and the functions called by each test case in the GpiChar test group. The GpiChar test group is found in GPICHAR.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiCharTestPre1	GpiCharStringPos GpiCharStringPosAt GpiDeleteSetId GpiMove GpiSetCharAngle GpiSetCharMode GpiSetCharSet
GpiCharTestPre2	GpiCharStringAt GpiDeleteSetId GpiSetCharSet
GpiCharTestApp1	GpiCharString GpiCharStringAt GpiDeleteSetId GpiMove GpiPolyLine GpiQueryFontMetrics GpiSetCharAngle GpiSetCharBox GpiSetCharDirection GpiSetCharMode GpiSetCharSet GpiSetCharShear
GpiSetAndQryCharAngleExh	GpiCharStringAt GpiDeleteSetId GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiSetAndQryCharBoxExh	GpiCharString GpiCharStringAt GpiDeleteSetId GpiMove GpiQueryCharBox GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiSetAndQryCharDirExh	GpiCharStringAt GpiDeleteSetId GpiQueryCharDirection GpiQueryCharDirection GpiSetCharBox GpiSetCharDirection GpiSetCharMode GpiSetCharSet
GpiSetAndQryCharModeExh	GpiCharStringAt GpiCharStringAt GpiDeleteSetId GpiQueryCharMode GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiSetAndQryCharShearExh	GpiCharStringAt GpiDeleteSetId GpiQueryCharShear GpiQueryDefCharBox GpiSetCharBox GpiSetCharMode GpiSetCharSet GpiSetCharShear
GpiCharStringExh	GpiCharString GpiDeleteSetId GpiMove GpiQueryDefCharBox GpiQueryDevice GpiQueryFontMetrics GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiCharStringAtExh	GpiCharString GpiCharStringAt GpiDeleteSetId GpiMove GpiQueryDefCharBox GpiQueryDevice GpiQueryFontMetrics GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiCharStringPosAndQryExh	GpiCharString GpiCharStringPos GpiDeleteSetId GpiMove GpiQueryDefCharBox GpiQueryDevice GpiQueryFontMetrics GpiQueryTextBox GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiCharStringPosAndQryShadeExh	GpiCharString GpiCharStringPos GpiDeleteSetId GpiMove GpiQueryDefCharBox GpiQueryDevice GpiQueryFontMetrics GpiQueryTextBox GpiSetBackColor GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiCharStringPosAndQryBoxExh	GpiCharString GpiCharStringPos GpiDeleteSetId GpiLine GpiMove GpiQueryDefCharBox GpiQueryFontMetrics GpiQueryTextBox GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiCharStringPosAtAndQryExh	GpiCharString GpiCharStringPos GpiCharStringPosAt GpiDeleteSetId GpiMove GpiQueryDefCharBox GpiQueryDevice GpiQueryFontMetrics GpiQueryTextBox GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiCharStringPosAtAndQryShdExh	GpiCharString GpiCharStringPos GpiCharStringPosAt GpiDeleteSetId GpiMove GpiQueryDefCharBox GpiQueryDevice GpiQueryFontMetrics GpiQueryTextBox GpiSetBackColor GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiCharStringPosAtAndQryBoxExh	GpiCharString GpiCharStringPos GpiCharStringPosAt GpiDeleteSetId GpiLine GpiMove GpiQueryDefCharBox GpiQueryDevice GpiQueryFontMetrics GpiQueryTextBox GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet
GpiQryDefCharBoxExh	GpiCharStringAt GpiQueryCharBox GpiQueryDefCharBox GpiSetCharBox
GpiQryTextBoxExh	GpiCharStringAt GpiDeleteSetId GpiMove GpiPolyLine GpiQueryTextBox GpiSetCharAngle GpiSetCharBox GpiSetCharMode GpiSetCharSet

GpiClip Test Group

The GpiClip test group tests the GPI clipping visible APIs. The following APIs are tested:

• GpiExcludeClipRectangle
• GpiIntersectClipRectangle
• GpiOffsetClipRegion
• GpiSetClipRegion
• GpiSetClipPath
• GpiQueryClipBox
• GpiQueryClipRegion
• GpiPtVisible
• GpiRectVisible

This table lists the test cases and the functions called by each test case in the GpiClip test group. The GpiClip test group is found in GPICLIP.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiClipPre	GpiCreateRegion GpiDestroyRegion GpiSetClipRegion	Direct
GpiClipApp	GpiCreateRegion GpiDestroyRegion GpiExcludeClipRectangle GpiIntersectClipRectangle GpiOffsetClipRegion GpiPtVisible GpiQueryClipBox GpiSetClipRegion	Direct
GpiPtVisibleExh	GpiCreateRegion GpiDestroyRegion GpiPtVisible GpiSetClipRegion	Direct
GpiRectVisibleExh	GpiCreateRegion GpiDestroyRegion GpiRectVisible GpiSetClipRegion	Direct
GpiQueryClipBoxExh	GpiCreateRegion GpiDestroyRegion GpiQueryClipBox GpiSetClipRegion	Direct
GpiQueryClipRegionExh	GpiCombineRegion GpiCreateRegion GpiDestroyRegion GpiPaintRegion GpiQueryClipRegion GpiSetClipRegion GpiSetPattern	Direct
GpiSetClipPathExh	GpiCreateRegion GpiDestroyRegion GpiQueryClipBox GpiSetClipRegion	Queued
GpiExcludeClipRectExh	GpiCreateRegion GpiDestroyRegion GpiExcludeClipRectangle GpiSetClipRegion	Direct
GpiIntersectClipRectExh	GpiCreateRegion GpiDestroyRegion GpiIntersectClipRectangle GpiSetClipRegion	Direct
GpiOffsetClipRegionExh	GpiCreateRegion GpiDestroyRegion GpiOffsetClipRegion GpiSetClipRegion	Direct

GpiColor Test Group

The GpiColor test group tests the GPI Color API, GpiSetColor.

This table lists the test cases and the functions called by each test case in the GpiColor test group. The GpiColor test group is found in GPICOLOR. DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiColorApp1	GpiSetColor GpiSetPattern
GpiColorApp2	GpiSetColor
GpiColorApp3	GpiBeginArea GpiBox GpiEndArea GpiFullArc GpiLine GpiMove GpiPointArc GpiSetArcParams GpiSetBackMix GpiSetColor
GpiSetColorExh	GpiLine GpiMove GpiSetColor
GpiSetMixExh1	GpiBeginArea GpiEndArea GpiMove GpiPolyLine GpiQueryDevice GpiQueryMix GpiSetColor GpiSetMix GpiSetPattern
GpiSetMixExh2	GpiBeginArea GpiEndArea GpiMove GpiPolyLine GpiQueryDevice GpiQueryMix GpiSetColor GpiSetMix GpiSetPattern
GpiSetMixExh3	GpiBeginArea GpiEndArea GpiMove GpiPolyLine GpiQueryDevice GpiQueryMix GpiSetColor GpiSetMix GpiSetPattern
GpiSetMixExh4	GpiBeginArea GpiEndArea GpiMove GpiPolyLine GpiQueryDevice GpiQueryMix GpiSetColor GpiSetMix GpiSetPattern
GpiSetBackColorExh	GpiBox GpiMove GpiQueryBackColor GpiSetBackColor GpiSetBackMix GpiSetColor GpiSetPattern
GpiSetBackMixExh	GpiBeginArea GpiEndArea GpiMove GpiPolyLine GpiQueryBackMix GpiQueryDevice GpiSetBackColor GpiSetBackMix GpiSetColor GpiSetMixExh1 GpiSetPattern
GpiCreateLogColorTableExh1	GpiBox GpiCreateLogColorTable GpiLine GpiMove GpiQueryDevice GpiQueryLogColorTable GpiSetColor GpiSetPattern GpiSetPatternSet GpiUnrealizeColorTable
GpiCreateLogColorTableExh2	GpiBox GpiCreateLogColorTable GpiLine GpiMove GpiQueryDevice GpiSetColor GpiSetPattern
GpiQueryColorDataExh	GpiCreateLogColorTable GpiLine GpiMove GpiQueryColorData GpiSetColor GpiSetPattern
GpiQueryColorIndexExh	GpiBox GpiCreateLogColorTable GpiLine GpiMove GpiQueryColorIndex GpiQueryDevice GpiSetColor
GpiQueryNearestColorExh	GpiBox GpiCreateLogColorTable GpiLine GpiMove GpiQueryDevice GpiQueryNearestColor GpiSetColor GpiSetPattern
GpiQueryRealColorsExh	GpiBox GpiCreateLogColorTable GpiLine GpiMove GpiQueryDevice GpiQueryRealColors GpiSetColor GpiSetPattern
GpiQueryRGBColorExh	GpiBox GpiLine GpiMove GpiQueryDevice GpiQueryRGBColor GpiSetColor GpiSetPattern

GpiElement Test Group

This testcase is designed to test the GPI element functions that:

• Open an element bracket.
• Close an element bracket.
• Delete the element referenced by the current value of the element pointer.
• Delete a section of elements inclusively delimited by element pointer values.
• Delete a section of elements exclusively delimited by labels.
• Add a single element to the current segment.
• Query the graphics orders for a single element.
• Get the graphics orders for a specified segment.
• Add a buffer of graphics orders to the current segment.
• Insert a label into the current segment.
• Move the element pointer by a specified increment.
• Query information associated with the current element.
• Set the current edit mode to either insert or replace.
• Query the current edit mode setting.
• Set the value of the element pointer.
• Query the value of the element pointer.
• Set the value of the element pointer to point at a specified label.

This testcase includes application tests that are designed to test the behavior of these character functions with other GPIs.

Limitations: All exhaustive element functions must be executed within a normal PS.

This table lists the test cases and the functions called by each test case in the GpiElement test group. The GpiElement test group is found in GPIELMNT.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiElementTestApp1	GpiDrawSegment GpiQueryPS GpiSetDrawControl GpiSetDrawingMode	Normal
GpiElementTestApp2	GpiDrawSegment GpiQueryPS GpiSetDrawControl GpiSetDrawingMode	Normal
GpiBeginAndEndElementExh	GpiBeginElement GpiCloseSegment GpiDrawSegment GpiEndElement GpiLine GpiMove GpiOpenSegment GpiQueryPS GpiSetColor GpiSetDrawControl GpiSetDrawingMode	Normal
GpiDeleteElementExh	GpiCloseSegment GpiDeleteElement GpiOffsetElementPointer GpiOpenSegment GpiQueryPS GpiSetDrawControl GpiSetDrawingMode GpiSetElementPointerAtLabel	Normal
GpiDeleteElementRangeExh	GpiCloseSegment GpiDeleteElementRange GpiDrawSegment GpiOpenSegment GpiQueryElementPointer GpiQueryPS GpiSetDrawControl GpiSetDrawingMode GpiSetElementPointerAtLabel	Normal
GpiDeleteElmntsBetweenLabelsExh	GpiCloseSegment GpiDeleteElement GpiDeleteElementsBetweenLabels GpiDrawSegment GpiOpenSegment GpiQueryPS GpiSetDrawControl GpiSetDrawingMode	Normal
GpiElementAndQryExh	GpiBeginElement GpiCloseSegment GpiComment GpiDrawSegment GpiElement GpiEndElement GpiMove GpiOpenSegment GpiPolyLine GpiQueryElement GpiQueryElementType GpiQueryPS GpiSetDrawControl GpiSetDrawingMode GpiSetModelTransformMatrix	Normal
GpiGetAndPutDataExh	GpiCloseSegment GpiDrawSegment GpiGetData GpiLabel GpiOpenSegment GpiPutData GpiQueryPS GpiSetDrawControl GpiSetDrawingMode	Normal
GpiLabelAndSetElmtPtrAtLabelExh	GpiCloseSegment GpiLabel GpiOpenSegment GpiQueryElementPointer GpiQueryPS GpiSetDrawingMode GpiSetElementPointer GpiSetElementPointerAtLabel	Normal
GpiOffsetElementPointerExh	GpiCloseSegment GpiLabel GpiOffsetElementPointer GpiOpenSegment GpiQueryElementPointer GpiQueryPS GpiSetDrawingMode GpiSetElementPointer	Normal
GpiQueryElementTypeExh	GpiCallSegmentMatrix GpiCharString GpiCharStringAt GpiCloseSegment GpiElement GpiFullArc GpiImage GpiLine GpiMove GpiOffsetElementPointer GpiOpenSegment GpiPolyFillet GpiPolyFilletSharp GpiPolyMarker GpiPolySpline GpiQueryDefAttrs GpiQueryElement GpiQueryElementType GpiQueryPS GpiSetAttrs GpiSetDrawingMode GpiSetElementPointer GpiSetSegmentAttrs	Normal
GpiSetAndQryEditModeExh	GpiCloseSegment GpiDrawSegment GpiLabel GpiOffsetElementPointer GpiOpenSegment GpiQueryEditMode GpiQueryPS GpiRotate GpiSetDrawControl GpiSetDrawingMode GpiSetEditMode GpiSetElementPointerAtLabel GpiSetModelTransformMatrix	Normal
GpiSetAndQryElementPointerExh	GpiCloseSegment GpiLabel GpiOpenSegment GpiQueryPS GpiSetDrawingMode GpiSetElementPointer	Normal

GpiFont Test Group

The GpiFont test group tests GPI text functions including:

• Determine whether a given file is a font resource file.
• Query the font metrics for the current logical font.
• Query the font metrics for all available fonts, or for the fonts specified by facename.
• Load one or more fonts from the specified resource file.
• Unload fonts previously loaded from the resource file.
• Create a logical definition of a font that an application requires to use.
• Query kerning pair information for the logical font identified by the current value of the character set attribute.
• Set the current value of the character-set attribute.
• Query the character-set lcid.
• Sets the code page ID for graphics characters for the default font.
• Query the currently selected graphics code page.
• Query the fonts that have been created by GpiCreateLogFont, and tagged bit maps.
• Query the number of local identifiers currently in use, referring to fonts or bit maps.
• Delete a logical font or bit-map tag.
• Query width table information for the logical font identified by the value of the character-set attribute.
• Query the device characteristics.

This table lists the test cases and the functions called by each test case in the GpiFont test group. The GpiFont test group is found in GPIFONT.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiFontApp1	GpiCharStringAt GpiCreateLogFont GpiDeleteSetId GpiQueryCharSet GpiQueryDevice GpiQueryFontFileDescriptions GpiQueryFonts GpiQueryNumberSetIds GpiQueryWidthTable GpiSetCharSet
GpiFontApp2	GpiQueryDevice GpiQueryFontMetrics GpiSetCharSet
GpiQueryFontFileDescriptionsExh	GpiDeleteSetId GpiQueryDevice GpiQueryFontFileDescriptions GpiSetCharSet
GpiQueryFontMetricsExh	GpiDeleteSetId GpiQueryFontMetrics GpiSetCharSet
GpiQueryFontsExh	GpiDeleteSetId GpiLoadFonts GpiQueryFonts GpiSetCharSet GpiUnloadFonts
GpiCreateLogFontExh	GpiDeleteSetId GpiResetPS GpiSetCharSet
GpiQueryKerningPairsExh	GpiDeleteSetId GpiQueryDevice GpiQueryFontMetrics GpiQueryKerningPairs GpiSetCharSet
GpiSetAndQueryCpExh	GpiCharString GpiMove GpiQueryCp GpiQueryCp GpiSetCp
GpiSetAndQueryCharSetExh	GpiDeleteSetId GpiQueryCharSet GpiSetCharSet
GpiQueryNumberSetIdsExh	GpiDeleteSetId GpiQueryNumberSetIds GpiSetCharSet
GpiDeleteSetIdExh	GpiDeleteSetId GpiSetCharSet
GpiQueryWidthTableExh	GpiDeleteSetId GpiQueryDevice GpiQueryFontMetrics GpiQueryWidthTable GpiSetCharSet
GpiLoadFontsExh	GpiLoadFonts GpiQueryFonts GpiUnloadFonts
GpiUnloadFontsExh	GpiLoadFonts GpiQueryFonts GpiUnloadFonts

GpiImage Test Group

This module is called by PTT to test the GPI Image APIs. This GPI is used to display raster (bit map) images. The functionality of this GPI and all the error codes that may be returned by this GPI will be tested.

Limitations: GpiImage cannot be used to load bitmaps that a pixel is represented by more than one bit.

This table lists the test cases and the functions called by each test case in the GpiImage test group. The GpiImage test group is found in GPIIMAGE.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiImagePre	GpiImage GpiMove GpiSetColor
GpiImageApp	GpiBox GpiImage GpiMove GpiRestorePS GpiSetColor GpiSetPattern
GpiImageExh	GpiImage GpiMove GpiSetColor

GpiLine Test Group

The GpiLine test group tests the line and polyline APIs with respect to line characteristics and precision.

This table lists the test cases and the functions called by each test case in the GpiLine test group. The GpiLine Test Group is found in GPILINE.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiLinePre	GpiBeginPath GpiBox GpiCloseFigure GpiEndPath GpiFillPath GpiLine GpiMove GpiPolyLine GpiSetPattern
GpiLineApp	GpiBeginPath GpiBox GpiCloseFigure GpiEndPath GpiFillPath GpiLine GpiMove GpiPolyLine GpiSetPattern
GpiBoxExh	GpiBox GpiMove GpiQueryCurrentPosition GpiSetPattern
GpiLineExh	GpiLine GpiQueryLineType GpiSetCurrentPosition GpiSetLineType
GpiPolyLineExh	GpiMove GpiPolyLine

GpiMarker Test Group

The GpiMarker test group covers the GPI Marker APIs with respect to precision, size, and variation.

This table lists the test cases and the functions called by each test case in the GpiMarker test group. The GpiMarker test group is found in GPIMARKER.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiMarkerPre	GpiMarker GpiPolyMarker GpiSetMarker
GpiMarkerApp	GpiDeleteSetId GpiMarker GpiPolyMarker GpiQueryMarker GpiQueryMarkerBox GpiQueryMarkerSet GpiSetMarker GpiSetMarkerBox GpiSetMarkerSet	Direct and Standard or Queued and Raw
GpiMarkerExh	GpiMarker GpiQueryMarker GpiQueryMarkerBox GpiQueryMarkerSet GpiSetMarker GpiSetMarkerBox GpiSetMarkerSet	Direct and Standard or Queued and Raw
GpiPolyMarkerExh	GpiPolyMarker GpiQueryMarker GpiQueryMarkerBox GpiQueryMarkerSet GpiSetCharDirection GpiSetMarker GpiSetMarkerBox GpiSetMarkerSet

GpiMeta Test Group

The GpiMeta test group covers the GPI Meta APIs and tests the loading, copying, playing, deletion, and querying of meta files.

This table lists the test cases and the functions called by each test case in the GpiMeta test group. The GpiMeta test group is found in GPIMETA.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiMetaApp1	GpiLoadMetaFile GpiPlayMetaFile	Raw
GpiMetaApp2	GpiLoadMetaFile GpiPlayMetaFile	Raw
GpiCopyMetaFileExh	GpiAssociate GpiCharString GpiCopyMetaFile GpiCreatePS GpiDestroyPS GpiLoadMetaFile GpiMove GpiPlayMetaFile GpiSaveMetaFile	Raw
GpiDeleteMetaFileExh	GpiAssociate GpiCharString GpiCreatePS GpiDeleteMetaFile GpiDestroyPS GpiLoadMetaFile GpiMove GpiPlayMetaFile GpiSaveMetaFile	Raw
GpiLoadPlayMetaFileExh1	GpiLoadMetaFile GpiPlayMetaFile	Raw
GpiLoadPlayMetaFileExh2	GpiCharString GpiLoadMetaFile GpiMove GpiPlayMetaFile	Raw
GpiLoadPlayMetaFileExh3	GpiCharString GpiLoadMetaFile GpiMove GpiPlayMetaFile	Raw
GpiQueryMetaFileLengthExh	GpiCharString GpiLoadMetaFile GpiMove GpiQueryMetaFileLength	Raw
GpiQuerySetMetaFileBitsExh	GpiLoadMetaFile GpiPlayMetaFile GpiQueryMetaFileBits GpiQueryMetaFileLength GpiSetMetaFileBits	Raw
GpiSaveMetaFileExh	GpiAssociate GpiCharString GpiCharString GpiCreatePS GpiDestroyPS GpiLoadMetaFile GpiMove GpiSaveMetaFile	Raw

GpiPath Test Group

Paths are used to draw and fill lines and non-rectangular areas. This testcase covers the accuracy of the path limits, the basic functionality of path GPIs and each of the path drawing functions in detail.

Limitations: This testcase does not cover the use of paths for clipping purposes. See the test group GpiClip.

This table lists the test cases and the functions called by each test case in the GpiPath test group. The GpiPath test group is found in GPIPATH.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiPathPre	GpiBeginPath GpiCloseFigure GpiEndPath GpiFillPath GpiMove GpiOutlinePath GpiPolyLine GpiSetLineWidthGeom GpiSetPattern GpiStrokePath
GpiPathApp	GpiBeginPath GpiEndPath GpiFillPath GpiFullArc GpiModifyPath GpiMove GpiOutlinePath GpiPointArc GpiPolyFillet GpiPolyLine GpiSetLineEnd GpiSetLineJoin GpiSetLineWidthGeom GpiSetPattern GpiStrokePath
GpiFillPathExh	GpiBeginPath GpiEndPath GpiFillPath GpiModifyPath GpiMove GpiPolyLine GpiSetLineWidthGeom GpiSetPattern
GpiOutlinePathExh	GpiBeginPath GpiCloseFigure GpiEndPath GpiMove GpiOutlinePath GpiPolyLine GpiSetLineWidth
GpiStrokePathExh	GpiBeginPath GpiCloseFigure GpiEndPath GpiMove GpiPolyLine GpiSetLineWidthGeom GpiSetPattern GpiStrokePath
GpiSetLineExh	GpiBeginPath GpiEndPath GpiMove GpiPolyLine GpiQueryLineJoin GpiQueryLineWidthGeom GpiSetLineEnd GpiSetLineJoin GpiSetLineWidthGeom GpiSetPattern GpiStrokePath

GpiPathclip Test Group

The GpiPathClip test group exhaustively tests the GPI Set Clip Path API.

This table lists the test cases and the functions called by each test case in the GpiPathclip test group. The GpiPathclip test group is found in GPIPATH.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiSetClipPathPre	GpiBeginPath GpiBox GpiCharStringAt GpiEndPath GpiMove GpiSetClipPath
GpiSetClipPathApp1	GpiBeginPath GpiCharStringAt GpiCreateLogFont GpiEndPath GpiQueryFonts GpiSetCharBox GpiSetCharSet GpiSetClipPath
GpiSetClipPathApp2	GpiBeginPath GpiBox GpiEndPath GpiMove GpiPolySpline GpiSetClipPath GpiSetPattern
GpiSetClipPathApp3	GpiBeginPath GpiCharStringAt GpiCreateLogFont GpiEndPath GpiQueryFonts GpiSetCharSet GpiSetClipPath
GpiSetClipPathExh1	GpiBeginPath GpiCharStringAt GpiEndPath GpiSetClipPath
GpiSetClipPathExh2	GpiBeginPath GpiCharStringAt GpiEndPath GpiSetClipPath
GpiSetClipPathExh3	GpiBeginPath GpiCharStringAt GpiEndPath GpiSetClipPath
GpiSetClipPathExh4	GpiBeginPath GpiCharStringAt GpiEndPath GpiSetClipPath
GpiSetClipPathExh5	GpiBeginPath GpiCharStringAt GpiEndPath GpiSetClipPath
GpiSetClipPathExh6	GpiBeginPath GpiCharStringAt GpiEndPath GpiSetClipPath

GpiRegion Test Group

The GpiRegion test case tests the GPI Region APIs.

This table lists the test cases and the functions called by each test case in the GpiRegion test group. The GpiRegion test group is found in GPIREGN.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiRegionApp1	GpiBox GpiCharStringAt GpiCombineRegion GpiCreateRegion GpiMove GpiPaintRegion GpiPtInRegion GpiRectInRegion GpiSetPattern	Direct
GpiCombineRegionExh1	GpiBox GpiCombineRegion GpiCreateRegion GpiDestroyRegion GpiMove GpiPaintRegion GpiSetPattern	Direct
GpiCombineRegionExh2	GpiCombineRegion GpiCreateRegion GpiDestroyRegion GpiPaintRegion GpiSetPattern
GpiCreateRegionExh
GpiEqualRegionExh	GpiCreateRegion GpiDestroyRegion GpiEqualRegion GpiPaintRegion GpiSetPattern
GpiOffsetRegionExh	GpiCreateRegion GpiDestroyRegion GpiOffsetRegion GpiPaintRegion GpiSetPattern
GpiPtInRegionExh	GpiCharStringAt GpiCreateRegion GpiDestroyRegion GpiPaintRegion GpiPtInRegion GpiSetPattern
GpiRectInRegionExh	GpiBox GpiCreateRegion GpiDestroyRegion GpiMove GpiPaintRegion GpiRectInRegion GpiSetPattern
GpiSetRegionExh	GpiCreateRegion GpiDestroyRegion GpiPaintRegion GpiSetPattern GpiSetRegion
GpiQueryRegionBoxExh	GpiCreateRegion GpiPaintRegion GpiQueryRegionBox GpiSetPattern

GpiSegment Test Group

The GpiSegment test case tests the GPI functions associated with segments, including: opening, drawing, deleting, and closing.

This table lists the test cases and the functions called by each test case in the GpiSegment test group. The GpiSegment test group is found in GPISEG.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiOpenSegmentExh	GpiDeleteSegments GpiDrawChain GpiQueryDrawingMode GpiQueryPS GpiQuerySegmentNames GpiResetPS GpiSetColor GpiSetDrawingMode	Normal
GpiDeleteSegmentExh	GpiCharStringAt GpiCloseSegment GpiDeleteSegment GpiDeleteSegments GpiDrawChain GpiDrawSegment GpiOpenSegment GpiQueryPS GpiResetPS GpiSetDrawingMode GpiSetInitialSegmentAttrs	Normal
GpiDeleteSegmentsExh	GpiDeleteSegments GpiDrawSegment GpiQueryPS GpiSetDrawingMode	Normal
GpiDrawChainExh1	GpiBeginArea GpiCallSegmentMatrix GpiCharStringAt GpiCloseSegment GpiDeleteSegments GpiDrawChain GpiEndArea GpiMove GpiOpenSegment GpiPolyFillet GpiPolyLine GpiQueryPS GpiSetColor GpiSetDrawingMode GpiSetPattern	Direct and Normal
GpiDrawChainExh2	GpiQueryPS	Normal
GpiDrawAndRemoveDynamicsExh	GpiDrawChain GpiDrawDynamics GpiQueryPS GpiRemoveDynamics GpiResetPS GpiSetSegmentTransformMatrix	Normal
GpiDrawFromExh1	GpiCharStringAt GpiCloseSegment GpiDeleteSegment GpiDeleteSegments GpiDrawChain GpiDrawForm GpiDrawSegment GpiDrawSegments GpiLine GpiMove GpiOpenSegment GpiQueryPS GpiResetPS GpiSetColor GpiSetDrawingMode	Direct and Normal
GpiDrawFromExh2	GpiBeginArea GpiCloseSegment GpiDeleteSegment GpiDeleteSegments GpiDrawChain GpiDrawSegment GpiDrawSegments GpiEndArea GpiMove GpiPolyLine GpiQueryPS GpiSetAttrMode GpiSetColor GpiSetDrawControl GpiSetDrawingMode GpiSetPattern	Normal
GpiDrawSegmentExh	GpiBeginArea GpiCloseSegment GpiDeleteSegment GpiDeleteSegments GpiDrawSegment GpiDrawSegments GpiEndArea GpiMove GpiPolyLine GpiQueryPS GpiSetDrawControl GpiSetPattern	Normal
GpiEraseExh	GpiBeginPath GpiCloseSegment GpiCreateRegion GpiDrawSegment GpiEndPath GpiErase GpiFullArc GpiMove GpiOpenSegment GpiQueryPS GpiSetArcParams GpiSetClipPath GpiSetClipRegion GpiSetDefaultViewMatrix GpiSetDrawingMode GpiSetGraphicsField GpiSetModelTransformMatrix GpiSetPageViewport GpiSetViewingLimits	Direct, Standard, and Normal or Queued, Raw, and Normal
GpiResetAndQryBoundaryDataExh	GpiBox GpiCharStringAt GpiConvert GpiDrawFrom GpiMove GpiQueryBoundaryData GpiQueryPS GpiResetBoundaryData GpiResetPS GpiSetDrawControl	Normal
GpiSetAndQryInitSegmentAttrsExh	GpiQueryInitialSegmentAttrs GpiQueryPS GpiQuerySegmentAttrs GpiSetInitialSegmentAttrs GpiSetSegmentAttrs	Normal
GpiSetAndQrySegmentAttrsExh	GpiCloseSegment GpiDeleteSegment GpiDrawChain GpiOpenSegment GpiQueryPS GpiQuerySegmentAttrs GpiSetDrawingMode GpiSetSegmentAttrs	Normal
GpiQuerySegmentNamesExh	GpiCloseSegment GpiDeleteSegments GpiOpenSegment GpiQueryPS GpiQuerySegmentNames GpiSetDrawingMode	Normal
GpiSetAndQrySegmentPriorityExh	GpiDrawChain GpiQueryPS GpiQuerySegmentPriority GpiResetPS GpiSetSegmentPriority	Normal
GpiSetAndQryStopDrawExh	GpiQueryPS GpiQueryStopDraw GpiSetSegmentAttrs GpiSetStopDraw	Normal

GpiShade Test Group

The GpiShade test group tests Pel spacing and shading, vertical box overlapping in Overpaint mode, circle shading in Fill and Outline mode, and FM_OR shading against the color table.

This table lists the test cases and the functions called by each test case in the GpiShade test group. The GpiShade test group is found in GPISHADE.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiShadePelSpace	GpiBox GpiCharString GpiMove GpiSetColor
GpiShadeOverlapBox	GpiBox GpiCharString GpiMove GpiSetColor
GpiShadeOverlapCircle1	GpiFullArc GpiMove GpiSetArcParams GpiSetColor
GpiShadeORing-1	GpiBox GpiCharString GpiMove GpiSetColor GpiSetColor GpiSetMix
GpiShadeORing-2	GpiBox GpiCharString GpiMove GpiSetColor GpiSetMix
GpiShadeORing-3	GpiBox GpiCharString GpiMove GpiSetColor GpiSetMix
GpiShadeORing-4	GpiBox GpiCharString GpiFullArc GpiMove GpiSetArcParams GpiSetColor GpiSetMix
GpiShadeBlue	GpiBox GpiCharStringAt GpiCreateLogColorTable GpiMove GpiSetColor
GpiShadeGreen	GpiBox GpiCharStringAt GpiCreateLogColorTable GpiMove GpiSetColor
GpiShadeRed	GpiBox GpiCharStringAt GpiCreateLogColorTable GpiMove GpiSetColor
GpiShadeGray	GpiBox GpiCharStringAt GpiCreateLogColorTable GpiMove GpiSetColor
GpiShadeAll	GpiBox GpiCharStringAt GpiCreateLogColorTable GpiMove GpiSetColor
GpiShadeOverlapCircle2	GpiFullArc GpiMove GpiSetArcParams GpiSetColor
GpiShadeOverlapBox2	GpiBox GpiCharString GpiMove GpiSetColor

GpiStandard Test Group

This module is called by the PTT to test GPI Standard Precision.

This testcase consists of the drawing of a set of grids, using GPI functions, and measuring their accuracy in printed form. This is a visual test; therefore, logging is minimal.

Limitations: The GPI APIs used to draw the grids are not tested for functionality and exhaustive return codes in this testcase. They are covered in the GpiLine test group.

This table lists the test cases and the functions called by each test case in the GpiStandard test group. The GpiStandard test group is found in GPISTD.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiStandardPre1	GpiCharStringAt GpiLine GpiSetCurrentPosition
GpiStandardPre2	GpiLine GpiSetCurrentPosition
GpiStandardPre3	GpiLine GpiSetCurrentPosition

GpiTransform Test Group

The GpiTransform test group tests:

• The Page Viewpoint functions
• Common support functions to set up a transform matrix
• That all transform GPI work together.
• Manipulates the transform GPI relationships and combination possibilities
• Modal transforms
• Segment transforms
• The Default View Matrix
• The Viewing transform GPIs

This table lists the test cases and the functions called by each test case in the GpiTransform test group. The GpiTransform test group is found in GPIXFORM.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiSetAndQryPageViewportPre	GpiBox GpiMove GpiQueryDevice GpiQueryPageViewport GpiQueryPS GpiSetPageViewport GpiSetPattern	Direct
GpiSetAndQryModelXformMatPre	GpiBox GpiMove GpiQueryModelTransformMatrix GpiSetModelTransformMatrix GpiSetPattern	Direct
GpiSetAndQrySegmentXformMatPre	GpiBox GpiCloseSegment GpiDrawSegment GpiMove GpiOpenSegment GpiQueryPS GpiQuerySegmentTransformMatrix GpiSetDrawingMode GpiSetInitialSegmentAttrs GpiSetPattern GpiSetSegmentTransformMatrix	Normal
GpiCallSegmentMatrixPre	GpiBox GpiCallSegmentMatrix GpiCloseSegment GpiMove GpiOpenSegment GpiQueryPS GpiSetDrawingMode GpiSetInitialSegmentAttrs GpiSetModelTransformMatrix GpiSetPattern	Direct and Normal
GpiSetAndQryDefViewMatrixPre	GpiBox GpiMove GpiQueryDefaultViewMatrix GpiSetDefaultViewMatrix GpiSetPattern
GpiSetAndQryViewingXformMatPre	GpiBox GpiCloseSegment GpiDrawSegment GpiMove GpiOpenSegment GpiQueryPS GpiQueryViewingTransformMatrix GpiSetDrawingMode GpiSetPattern GpiSetViewingTransformMatrix	Normal
GpiTransformApp	GpiBox GpiCallSegmentMatrix GpiCloseSegment GpiDrawSegment GpiMove GpiOpenSegment GpiQueryDefaultViewMatrix GpiQueryModelTransformMatrix GpiQueryPageViewport GpiQueryPS GpiQuerySegmentTransformMatrix GpiQueryViewingTransformMatrix GpiSetDefaultViewMatrix GpiSetDrawingMode GpiSetInitialSegmentAttrs GpiSetModelTransformMatrix GpiSetPageViewport GpiSetPattern GpiSetSegmentTransformMatrix GpiSetViewingTransformMatrix	Direct and Normal
GpiSetAndQryPageViewportExh	GpiBox GpiMove GpiQueryDevice GpiQueryPageViewport GpiSetPageViewport GpiSetPattern	Direct
GpiSetAndQryModelXformMatExh	GpiBox GpiMove GpiQueryModelTransformMatrix GpiSetModelTransformMatrix GpiSetPattern	Direct
GpiSetAndQrySegmentXformMatExh	GpiBox GpiCloseSegment GpiDrawSegment GpiMove GpiOpenSegment GpiQueryPS GpiQuerySegmentTransformMatrix GpiSetDrawingMode GpiSetInitialSegmentAttrs GpiSetPattern GpiSetSegmentTransformMatrix	Normal
GpiCallSegmentMatrixExh	GpiBox GpiCallSegmentMatrix GpiCloseSegment GpiMove GpiOpenSegment GpiQueryPS GpiSetDrawingMode GpiSetInitialSegmentAttrs GpiSetModelTransformMatrix GpiSetPattern	Direct and Normal
GpiSetAndQryDefViewMatrixExh	GpiBox GpiMove GpiQueryDefaultViewMatrix GpiSetDefaultViewMatrix GpiSetPattern
GpiSetAndQryViewingXformMatExh	GpiBox GpiCloseSegment GpiDrawSegment GpiMove GpiOpenSegment GpiQueryPS GpiQueryViewingTransformMatrix GpiSetDrawingMode GpiSetPattern GpiSetViewingTransformMatrix	Normal
GpiConvertExh	GpiConvert GpiQueryDevice GpiQueryPageViewport GpiQueryPS GpiSetDefaultViewMatrix GpiSetModelTransformMatrix GpiSetPageViewport

GpiView Test Group

The GpiView test group tests the following GPIs:

• GpiSetDefViewingLimits
• GpiSetGraphicsField
• GpiSetViewingLimits
• GpiSetPageViewport

This table lists the test cases and the functions called by each test case in the GpiView test group. The GpiView Test Group is found in GPIVIEW.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiSetDefViewingLimitsPre	GpiResetPS GpiSetDefViewingLimits
GpiSetGraphicsFieldPre	GpiSetGraphicsField
GpiSetViewingLimitsPre	GpiSetViewingLimits
GpiViewApp	GpiResetPS GpiSetDefViewingLimits GpiSetGraphicsField GpiSetViewingLimits
GpiSetDefViewingLimitsExh1	GpiAssociate GpiQueryDevice GpiSetDefViewingLimits	Direct and Normal
GpiSetDefViewingLimitsExh2	GpiBox GpiCloseSegment GpiDrawChain GpiMove GpiOpenSegment GpiSetDefViewingLimits GpiSetDrawingMode GpiSetInitialSegmentAttrs	Normal
GpiSetViewingLimitsExh1	GpiCallSegmentMatrix GpiCloseSegment GpiOpenSegment GpiSetDrawingMode GpiSetInitialSegmentAttrs GpiSetViewingLimits	Normal
GpiSetViewingLimitsExh2	GpiSetViewingLimits
GpiSetPageViewportExh	GpiSetPageViewport	Direct

STRESS Test Group

The STRESS test group uses GPI test cases which use a great deal of system resources, such as memory and swapper file space.

This table lists the test cases and the functions called by each test case in the STRESS test group. The STRESS Test Group is found in STRESS.DLL.

Test Case	GPI Functions Called	Configuration Settings
GpiClipFontExh	GpiDeleteSetId GpiResetPS GpiSetCharSet	Raw
GpiClipBitsExh	GpiBeginPath GpiEndPath GpiMove GpiPolyLine GpiSetClipPath GpiSetLineWidthGeom GpiSetPel	Raw
GpiClipColorExh	GpiBeginPath GpiEndPath GpiFullArc GpiMove GpiPartialArc GpiSetArcParams GpiSetClipPath GpiSetLineWidthGeom GpiStrokePath GpiSetColor	Raw
GpiMaxPolyLinesExh	GpiMove GpiPolyLine	Raw
GpiMaxPolySplinesExh	GpiMove GpiPolySpline	Raw
GpiCharBoxMetricsInteractive	GpiCharString GpiDeleteSetId GpiMove GpiPolyLine GpiQueryTextBox GpiSetCharSet	Raw
GpiCharBoxMetricsDefault	GpiCharString GpiMove GpiPolyLine GpiQueryDevice GpiQueryTextBox GpiSetCharSet	Raw
GpiSpaceInteractive	GpiCharString GpiDeleteSetId GpiMove GpiQueryDevice GpiQueryTextBox GpiSetCharSet	Raw
GpiBitMapClipExh	GpiBeginPath GpiDeleteBitmap GpiEndPath GpiFullArc GpiLoadBitmap GpiMove GpiQueryBitmapParameters GpiSetArcParams GpiSetClipPath GpiSetLineWidthGeom GpiStrokePath GpiWCBitBlt	Raw
GpiThinLinesInPath	GpiBeginPath GpiCharString GpiEndPath GpiLine GpiMove GpiSetLineWidthGeom GpiSetPattern GpiStrokePath	Normal
GpiThickLinesInPath	GpiBeginPath GpiCharString GpiEndPath GpiLine GpiMove GpiSetLineWidthGeom GpiSetPattern GpiStrokePath	Raw
GpiShadeCharactersInteractive	GpiCharString GpiDeleteSetId GpiMove GpiQueryTextBox GpiSetCharSet GpiSetColor	Raw
GpiShadeCharactersDefault	GpiCharString GpiDeleteSetId GpiMove GpiQueryTextBox GpiSetCharSet GpiSetColor	Raw