Colormap Test Descriptions

9

This chapter describes the Colormap test programs. The following is defined for each test program:

• Name of the test program
• Test types (See the section, "Denizen Test Types" on page 2 for the different test types.)
• Description of the test program
• Attributes tested by the program
• Operators tested by the program
• Output from the test program

· colormap0

Test Types:	INDEX, SM
Description:	Creates a colormap, attaches to a raster and draws a circle. Sets background colors and verifies colors in map.

Attributes Tested: See Table 9-1, Column A at the end of this chapter.

Operators Tested: xgl_multicircle

Output:.....First the background changes from black through grays to white, then a circle appears that changes color to white as it is continuously scaled larger.

· colormap1

Test Types:	INDEX, SM
Description:	Creates colormaps, attaches to a raster, and draws a circle, line, and rectangle. Interchanges maps, draws, and verifies that correct images are drawn.

Attributes Tested: XGL_CTX_LINE_COLOR

                    XGL_CTX_NURBS_CURVE_APPROX
                    XGL_CTX_NURBS_CURVE_APPROX_VAL
                    XGL_CTX_SURF_EDGE_FLAG
                    XGL_CTX_SURF_FRONT_COLOR
                    XGL_CURVE_METRIC_VDC
                    XGL_PT_I2D
Operators Tested:   xgl_multicircle
                    xgl_multipolyline
                    xgl_multirectangle
Output:             A circle, a line, and then a rectangle. Renders first time

with red background, and each element grows as its color changes. The second sequence has a blue background, and again the primitives change color as they expand.

· colormap2

Test Types:	INDEX, SM
Description:	Creates colormaps, attaches to a raster, and draws a circle, line, and rectangle. Verifies background colors. Clears screen and verifies the cleared image.

Attributes Tested: XGL_CTX_LINE_COLOR

and Table 9-1, Column A at the end of this chapter

Operators Tested: xgl_multicircle

Output:.....First a circle, then a line, and finally a rectangle. Renders each on top of the previous. Each expands as its color changes from black to white.

· colormap3

Test Types:	INDEX, SM
Description:	Creates colormaps, attaches one to a raster, and draws a circle, line, and rectangle. Creates/destroys to check for memory leaks. Pushes context, destroys the colormap, and reattaches new map and looks for results. Creates another raster, switches colormaps, and verifies proper attachment. Checks compatibility of the colormap size.

Attributes Tested: XGL_CTX_LINE_COLOR

                    XGL_DEV_COLOR_MAP
                    XGL_MULTIRECT_I2D
                    XGL_PT_I2D
                    and Table 9-1, Column A at the end of this chapter
Operators Tested:   xgl_multicircle
                    xgl_multipolyline
                    xgl_multirectangle
Output:             A circle, a line, and then a rectangle

· colormap4

Test Types:	INDEX, SM
Description:	Verifies that the colormap can be any size within the maximum and also checks for maximum colormap size.

Attributes Tested: XGL_CMAP_COLOR_TABLE_SIZE

                    XGL_CMAP_MAX_COLOR_TABLE_SIZE
                    XGL_COLOR_INDEX
                    XGL_CTX_BACKGROUND_COLOR
                    XGL_RAS_DEPTH
Operators Tested:   xgl_object_set
                    xgl_object_get
Output:             None

· colormap5

Test Types:	RGB, SM
Description:	RGB line drawing

Attributes Tested: XGL_COLOR_RGB

                    XGL_CTX_BACKGROUND_COLOR
                    XGL_CTX_LINE_COLOR
                    XGL_PT_I2D
Operators Tested:   xgl_multipolyline
Output:             Green line on a red background

· colormap6

Test Types:	INDEX, SM
Description:	Like colormap0, but uses window system colormap; tests XGL_CMAP_NAME and pixel mapping array

Attributes Tested: XGL_CMAP_NAME

                    XGL_COLOR_INDEX
                    XGL_WIN_RAS_DESCRIPTOR
                    and Table 9-1, Column A at the end of this chapter
Operators Tested:   xgl_multicircle
Output:             Renders multiple frames of an expanding circle that
                    changes color

· cmap_ramp

Test Types:	CM, INDEX
Description:	Indexes the test for color ramps. Four 16-element ramps are built; first red, then green, blue, and grayscale. Then renders four polygons, one per ramp with different z (depth) values, and depth cueing is turned on.

Attributes Tested: See Table 9-1, Column B at the end of this chapter.

Operators Tested: xgl_polygon

Output:.....Draws four polygons of varying shapes and colors. Polygons are depth cued to show their color ramps.

· xcolor_mapping

Test Types:	CM, INDEX
Description:	Creates an X colormap with 64 entries and attaches to a raster with WIN_RAS_PIXEL_MAPPING and CMAP_NAME. This is appropriate only for Pseudocolor (8-bit index) visuals, so the test aborts if it can't get the right visual.

Attributes Tested: See Table 9-1, Column C at the end of this chapter.

Operators Tested: xgl_polygon

Output:· cmapper	Draws 64 polygons in eight rows of eight, using the consecutive indexes of the X colormap, used by setting Xgl_color.index(es)
Test Types:	SM, INDEX
Description:	Creates an X colormap with eight entries and attaches to an RGB raster with WIN_RAS_PIXEL_MAPPING, then uses it with COLOR_MAPPER to return the index to the color table, given an RGB style color value (xgl_color.rgb.r, for example). This is appropriate only for Pseudocolor (8-bit index) visuals, so it will exit if it can't get the right visual.

Attributes Tested: XGL_CMAP_COLOR_MAPPER

Operators Tested: xgl_polygon

Output:.....Draws eight rows of eight polygons using the indexes from the X colormap; our cmapper function reverses the indexes. The background is yellow with various color polygons.

Table 9-1

Column A	Column B	Column C
XGL_CMAP_COLOR_TABLE	XGL_CMAP_NAME	XGL_CMAP_MAX_COLOR_TABLE_ SIZE
XGL_CMAP_COLOR_TABLE_SIZE	XGL_3D_CTX_DEPTH_CUE_MODE	XGL_CMAP_NAME
XGL_CTX_BACKGROUND_COLOR	XGL_DEPTH_CUE_LINEAR	XGL_COLOR_INDEX
XGL_CTX_NURBS_CURVE_APPROX	XGL_3D_CTX_SURF_FACE_ DISTINGUISH	XGL_CTX_DEFERRAL_MODE
XGL_CTX_NURBS_CURVE_ APPROX_VAL	XGL_CMAP_COLOR_TABLE	XGL_CTX_SURF_FRONT_COLOR
XGL_CTX_SURF_EDGE_FLAG	XGL_CMAP_COLOR_TABLE_SIZE	XGL_DEFER_ASAP
XGL_CTX_SURF_FRONT_COLOR	XGL_CMAP_RAMP_LIST	XGL_DEV_COLOR_MAP
XGL_CURVE_METRIC_VDC	XGL_CMAP_RAMP_NUM	XGL_FACET_NONE
XGL_MULTICIRCLE_I2D	XGL_CTX_SURF_FRONT_COLOR	XGL_PT_I2D
	XGL_CTX_VDC_MAP	XGL_DEV_COLOR_TYPE
	XGL_PT_F3D XGL_VDC_MAP_ASPECT	XGL_WIN_RAS_PIXEL_MAPPING