Depth Cueing Test Descriptions

13

This chapter describes the Depth Cueing 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

· dcue_fat_line

Test Types:	INDEX, SM
Description:	Draws fat lines and checks for simple depth-cueing

Attributes Tested: XGL_CTX_LINE_WIDTH_SCALE_FACTOR

XGL_PT_F3D

Operators Tested: xgl_multipolyline

Output:· line on the front plane· dcue_fat_line_rgb	Fat lines displayed in depth cue colors black and yellow
Test Types:	RGB, SM
Description:	Draws fat RGB lines and checks for simple depth cue

Attributes Tested: XGL_CTX_LINE_WIDTH_SCALE_FACTOR

                    XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)
                    XGL_3D_CTX_DEPTH_CUE_MODE
                    (XGL_DEPTH_CUE_LINEAR)
                    XGL_3D_CTX_DEPTH_CUE_COLOR
                    XGL_CTX_LINE_COLOR
                    XGL_PT_F3D
Operators Tested:   xgl_multipolyline
Output:             Fat lines displayed in depth cue colors black and yellow:
                    · line on the front plane
                    · line on the back plane
                    · line lies on the plane in between the front and the back,
                        const. color
                    · line with z1 > z2
                    · line with z1 < z2
                    · line with multiple segments in between the planes
                    · line with multiple polylines in between the planes

· dcue_line

Test Types:	INDEX, SM
Description:	Draws lines and checks simple depth-cueing

Attributes Tested: XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)

XGL_3D_CTX_DEPTH_CUE_MODE
(XGL_DEPTH_CUE_LINEAR)

                    XGL_3D_CTX_DEPTH_CUE_COLOR
                    XGL_CTX_LINE_COLOR
                    XGL_PT_F3D
Operators Tested:   xgl_multipolyline
Output:             Lines displayed in depth cue colors black and yellow:
                    · line on the front plane
                    · line on the back plane
                    · line lies on the plane in between the front and the back,
                        const. color
                    · line with z1 > z2
                    · line with z1 < z2
                    · line with multiple segments in between the planes
                    · line with multiple polylines in between the planes

· dcue_line_rgb

Test Types:	RGB, SM
Description:	Draws RGB lines and checks simple depth-cueing

Attributes Tested: XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)

                    XGL_3D_CTX_DEPTH_CUE_MODE
                    (XGL_DEPTH_CUE_LINEAR)
                    XGL_3D_CTX_DEPTH_CUE_COLOR
                    XGL_CTX_LINE_COLOR
                    XGL_PT_F3D
Operators Tested:   xgl_multipolyline
Output:             Lines displayed in depth cue colors black and yellow:
                    · line on the front plane
                    · line on the back plane
                    · line lies on the plane in between the front and the back,
                        const. color
                    · line with z1 > z2
                    · line with z1 < z2
                    · line with multiple segments in between the planes
                    · line with multiple polylines in between the planes

· dcue_quadmesh

Test Types:	INDEX, SM
Description:	Renders depth-cued quadmeshes on different planes with front and back facing

Attributes Tested: XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)

                    XGL_3D_CTX_DEPTH_CUE_COLOR
                    XGL_3D_CTX_DEPTH_CUE_MODE
                    (XGL_DEPTH_CUE_LINEAR)
                    XGL_3D_CTX_SURF_FACE_DISTINGUISH
                    XGL_CTX_SURF_FRONT_FILL_STYLE
                    XGL_CTX_SURF_FRONT_COLOR
                    XGL_3D_CTX_SURF_BACK_COLOR
                    XGL_PT_F3D
Operators Tested:   xgl_quadrilateral_mesh
Output:             Red quadmeshes with depth cue color black:
                    · quadmesh on front plane
                    · quadmesh on back plane
                    · quadmesh lies on plane between the front and the back

planes, z constant quadmesh lies between the front and the back planes, z variable

• quadmesh on front plane, back-facing
• quadmesh with two facets between the front and back planes

· dcue_quadmesh_rgb

Test Types:	RGB, SM
Description:	Renders depth-cued quadmeshes on different planes with front and back facing

Attributes Tested: XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)

XGL_PT_F3D

Operators Tested: xgl_quadrilateral_mesh

Output:.....Red quadmeshes with depth cue color black:

• quadmesh on front plane
• quadmesh on back plane
• quadmesh lies on plane between the front and the back planes, z constant

• quadmesh lies between the front and the back planes, z variable
• quadmesh on front plane, back-facing
• quadmesh with two facets between the front and back planes

· dcue_scaled_line

Test Types:

INDEX, CM

Description:

Tests scaled depth-cueing of multipolylines with some clipped. Sets variant reference planes' depths and various scale factors. Since this is an index cmap test for depth cueing, a color ramp is set up and 3D polyline point lists are defined with constant z and varying z values. Some of the lines are outside of the viewport to test clipping. Reference planes are default shallow, and deep (0, 1) (.4, .6) (.1, .9); scale factors are default (1.0, 0), (.4, .5), and (.1, .9).

Attributes Tested: XGL_3D_CTX_DEPTH_CUE_MODE

                    XGL_DEPTH_CUE_SCALED
                    XGL_3D_CTX_DEPTH_CUE_REF_PLANES
                    XGL_3D_CTX_DEPTH_CUE_SCALE_FACTORS
Operators Tested:   xgl_multipolyline
Output:             Nine images are compared

· dcue_scaled_line_rgb

Test Types:

RGB, CM

Description:

Tests scaled depth-cueing of multipolylines with some clipped. Sets variant reference planes' depths and various scale factors. Since this is an index cmap test for depth cueing, a color ramp is set up and 3D polyline point lists are defined with constant z and varying z values. Some of the lines are outside of the viewport to test clipping. Reference planes are default shallow, and deep (0, 1) (.4, .6) (.1, .9); scale factors are default (1.0, 0), (.4, .5), and (.1, .9).

Attributes Tested: XGL_3D_CTX_DEPTH_CUE_MODE

                    XGL_DEPTH_CUE_SCALED
                    XGL_3D_CTX_DEPTH_CUE_REF_PLANES
                    XGL_3D_CTX_DEPTH_CUE_SCALE_FACTORS
Operators Tested:   xgl_multipolyline
Output:             Nine images are compared

· dcue_scaled_pg

Test Types:	INDEX, CM
Description:	Tests scaled depth-cueing of general polygons. Sets variant reference planes' depths and various scale factors. Since this is an index cmap test for depth cueing, a color ramp is set up and 3D polygons point lists are defined with constant z and varying z values. Reference planes are default shallow, and deep (0, 1) (.4, .6) (.1, .9); scale factors are default (1.0, 0), (.4, .5), and (.1, .9).

Attributes Tested: XGL_3D_CTX_DEPTH_CUE_MODE

                    XGL_3D_CTX_DEPTH_CUE_REF_PLANES
                    XGL_3D_CTX_DEPTH_CUE_SCALE_FACTORS
Operators Tested:   xgl_polygon
Output:             Nine images are compared

· dcue_scaled_pg_rgb

Test Types:

RGB, CM

Description:

Tests scaled depth-cueing of general polygons. Sets variant reference planes' depths and various scale factors. Since this is an rgb test for depth cueing, a depth cue color and a surface color are defined; as z increases, the higher percentage are defined with constant z and varying z values. Reference planes are default, shallow, and deep (0, 1) (.4, .6) (.1, .9); scale factors are default (1.0, 0), (.4, .5), and (.1, .9).

Attributes tested: XGL_3D_CTX_DEPTH_CUE_MODE

                    XGL_DEPTH_CUE_SCALED
                    XGL_3D_CTX_DEPTH_CUE_REF_PLANES
                    XGL_3D_CTX_DEPTH_CUE_SCALE_FACTORS
Operators Tested:   xgl_polygon
Output:             Nine images are compared

· dcue_simple

Test Types:	INDEX, SM
Description:	Draws a line and polygon and checks simple depth-cueing

Attributes Tested: XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)

                    XGL_3D_CTX_DEPTH_CUE_COLOR
                    XGL_3D_CTX_DEPTH_CUE_MODE
                    (XGL_DEPTH_CUE_LINEAR)
                    XGL_CTX_LINE_COLOR
                    XGL_CTX_LINE_WIDTH_SCALE_FACTOR
                    XGL_3D_CTX_LINE_COLOR_INTERP
                    XGL_CTX_SURF_FRONT_FILL_STYLE
                    XGL_CTX_SURF_FRONT_COLOR
                    XGL_PT_F3D
Operators Tested:   xgl_multipolyline
                    xgl_polygon
Output:             A red line and a red triangle displayed

· dcue_simple_rgb

Test Types:	RGB, SM
Description:	Draws a RGB line and polygon and checks simple depth-cueing

Attributes Tested: XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)

XGL_PT_F3D

Operators Tested: xgl_polygon

Output:.....A red line and a red triangle displayed

· dcue_triangle

Test Types:	INDEX, SM
Description:	Tests depth-cued triangles on different planes with front and back facing

Attributes Tested: XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)

XGL_PT_F3D

Operators Tested: xgl_triangle_strip

Output:· triangle on front plane· dcue_triangle_rgb	Red triangles with depth cue color black:
Test Types:	RGB, SM
Description:	Tests depth-cued triangles on different planes with front and back facing

Attributes Tested: XGL_CTX_VDC_MAP (XGL_VDC_MAP_ASPECT)

                    XGL_3D_CTX_DEPTH_CUE_COLOR
                    XGL_3D_CTX_DEPTH_CUE_MODE
                    (XGL_DEPTH_CUE_LINEAR)
                    XGL_3D_CTX_SURF_FACE_DISTINGUISH
                    XGL_CTX_SURF_FRONT_FILL_STYLE
                    XGL_CTX_SURF_FRONT_COLOR
                    XGL_3D_CTX_SURF_BACK_COLOR
                    XGL_PT_F3D
Operators Tested:   xgl_triangle_strip

Output:.....Red triangles with depth cue color black:

• triangle on front plane
• triangle on back plane
• triangle lies on plane between the front and the back planes, z constant triangle lies between the front and the back planes, z variable
• triangle on front plane, back-facing
• triangle strip with two facets between the front and back planes