1 ------------------------------------------------------------------------- 2 drawElements Quality Program Test Specification 3 ----------------------------------------------- 4 5 Copyright 2014 The Android Open Source Project 6 7 Licensed under the Apache License, Version 2.0 (the "License"); 8 you may not use this file except in compliance with the License. 9 You may obtain a copy of the License at 10 11 http://www.apache.org/licenses/LICENSE-2.0 12 13 Unless required by applicable law or agreed to in writing, software 14 distributed under the License is distributed on an "AS IS" BASIS, 15 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 16 See the License for the specific language governing permissions and 17 limitations under the License. 18 ------------------------------------------------------------------------- 19 GL_EXT_primitive_bounding_box extension tests 20 21 Tests: 22 + dEQP-GLES31.functional.primitive_bounding_box.* 23 24 Includes: 25 + State query tests 26 + Primitive render tests 27 - All basic primitives: triangles, (wide) lines, (wide) points 28 - Set bounding box with gl_BoundingBoxEXT and PrimitiveBoundingBoxEXT 29 - Rendering with and without tessellation and/or geometry stages 30 - Rendering with correct, too large, and too small bounding boxes 31 + Depth render tests 32 - Render pattern and hint the final depth range with bounding box 33 - Test with built-in depth and user defined (gl_FragDepth) depth 34 + Blit tests 35 - Blit should not be affected by the bounding box 36 + Clear tests 37 - Clears should not be affected by the bounding box 38 39 Excludes: 40 + Special floating point values (NaN, Inf, etc.) 41 + Rendering with separate shader pipelines 42 + Rendering discardable geometry with fragment shaders that have 43 side-effects (memory writes) 44 + Rendering discardable geometry with active transform feedback 45 46 Description: 47 48 state_query.* cases test the global PRIMITIVE_BOUNDING_BOX_EXT state. 49 Tests set the state to certain values and then query the state using 50 different methods. 51 52 triangles.*, (wide_)lines.*, (wide_)points.* cases set the primitive 53 bounding box and render a test pattern. Rendering results within the 54 bounding box are then verified. 55 56 "global_state.*" cases set the bounding box of the whole test pattern 57 using the PRIMITIVE_BOUNDING_BOX_EXT state. "tessellation_set_per_draw.*" 58 cases set the bounding box of the whole test pattern using 59 gl_BoundingBoxEXT output variable. "tessellation_set_per_draw.*" cases 60 set the bounding box for each (tessellation input) primitive separately. 61 62 "*_bbox_equal" cases set the bounding box to tightly cover the primitive 63 or the whole pattern. In "*_bbox_larger" cases, the bounding box is set 64 to be larger than the rendered pattern/primitive and in "*_bbox_smaller" 65 cases, the bounding box is set to cover only a subset of the pattern. 66 In these subset cases, only the area covered by the bounding box is 67 verified. 68 69 triangles.* cases render a grid with yellow and green cells. Cells are 70 in random order. Result image verification is done by simply checking 71 that the viewport does not contain any background-colored pixels within 72 the pattern area. 73 74 (wide_)points.* cases render a pattern of green and blue points. 75 Verification checks that no points within the bounding box area are 76 missing and have the correct size. Size test is intended to prevent 77 partially rendered points from passing the test. 78 79 (wide_)lines.* cases render a pattern of green and blue lines. 80 Verification checks the number and the width of separate lines within 81 bounding box area. Number-of-lines check prevents accepting rendering 82 results with missing lines and the line width check prevents accepting 83 partially rendered lines. 84 85 depth.* cases render multiple layers with varying depth values while 86 hint the resulting depth range with primitive bounding box. In 87 "builtin_depth.*" cases, depth is set by the rasterizer. In 88 "user_defined_depth.*" cases, depth is set in the fragment shader using 89 gl_FragDepth. Verification checks that only the topmost layer is visible. 90 91 blit_fbo.* cases do framebuffer blits with different bounding box values. 92 Bounding box values should not affect blitting. 93 94 clear.* cases do full and scissored framebuffer clears. Since clears are 95 not affected by the bounding box, verification is done by simply comparing 96 rendering result with bounding box set to cover full viewport and rendering 97 result with bounding box set to arbitrary values. In *_with_triangles cases, 98 some geometry is rendered between clears with properly set bounding box. 99 100 call_order.* cases render a scene with different relative order of 101 glViewport and glPrimitiveBoundingBox. Tests verify that the bounding box 102 for a draw command is calculated from the current state when draw command 103 is issued (i.e. changing call order of state setting functions does not 104 change ther result). 105
