PDDR/2 - Printer Test Tool (PTT)
Reprint Courtesy of International Business Machines Corporation, © International Business Machines Corporation
Contents
- 1 Printer Test Tool (PTT)
- 1.1 Overview
- 1.2 PTT Architecture
- 1.3 Operating PTT
- 1.4 PTT Log File
- 1.5 Configuring the Device Context and Presentation Space
- 1.6 Selecting and Executing Test Groups and Test Cases
- 1.7 Displaying the PTT Release and Revision Levels
- 1.8 GPI Function Tests (32-Bit)
- 1.8.1 GPIARC Test Group
- 1.8.2 GpiArea Test Group
- 1.8.3 GpiBitmaps Test Group
- 1.8.4 GpiChar Test Group
- 1.8.5 GpiClip Test Group
- 1.8.6 GpiColor Test Group
- 1.8.7 GpiElement Test Group
- 1.8.8 GpiFont Test Group
- 1.8.9 GpiImage Test Group
- 1.8.10 GpiLine Test Group
- 1.8.11 GpiMarker Test Group
- 1.8.12 GpiMeta Test Group
- 1.8.13 GpiPath Test Group
- 1.8.14 GpiPathclip Test Group
- 1.8.15 GpiRegion Test Group
- 1.8.16 GpiSegment Test Group
- 1.8.17 GpiShade Test Group
- 1.8.18 GpiStandard Test Group
- 1.8.19 GpiTransform Test Group
- 1.8.20 GpiView Test Group
- 1.8.21 STRESS Test Group
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 |