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 Geometry shader tests 20 21 Tests: 22 + dEQP-GLES31.functional.geometry_shading.* 23 24 Includes: 25 + Basic tests: 26 - gl_PointSize, gl_PrimitiveID, gl_PrimitiveIDIn built-ins 27 - Constant and varying emit counts 28 - All input primitive types 29 - All output privitive types (point, line_strip, triangle_strip) 30 - Different number of varyings 31 + Non-sufficient vertex emit counts, superfluous EndPrimitives() 32 + Layered rendering 33 + Negative tests for input types 34 35 Excludes: 36 + Geometry shader transform feedback 37 + (Negative) tests for vertex-geo-frag shader varying linkage. 38 + Primitive render order with geometry shader instancing 39 40 Description: 41 42 Geometry shader tests test geometry shader functionality by rendering 43 a scene using geometry shaders and comparing the resulting image to 44 the output of a reference renderer. Layered rendering render tests 45 draw scene to a texture which is then read back layer by layer. Contents 46 of each layer is then verified. 47 48 query.* test group contains various query tests. max_geometry_* cases 49 verify that the implementation limit queried via API is equal to the 50 corresponding GLSL constant. geometry_* and max_geometry_* cases test 51 geometry shader related limits and states. primitives_generated_* cases 52 verify GL_PRIMITIVES_GENERATED query result in various scenarios. 53 max_framebuffer_* and framebuffer_* test verify layered fbo limits, states 54 and incompleteness conditions. 55 56 basic.* tests test basic geometry shader usage: output_* cases emit 57 a constant number of vertices. output_vary_by_* cases emit a varying 58 number of vertices, depending on a shader varying, uniform or a texture 59 lookup. basic.point_size, basic.primitive_id_in[_restarted] and 60 basic.primitive_id cases test functionality of a corresponding built-in 61 variable. *_restarted variant verifies that primitive restart index has 62 no effect to the corresponding variable. 63 64 input.* tests verify geometry shader behavior with different input types 65 by drawing a separate triangle for each geometry shader input vertex. 66 input.triangle_strip_adjacency.* cases verify correct behavior of 67 TRIANGLE_ADJACENCY primitive with different vertex counts. 68 69 conversion.* tests verify functionality of geometry shaders with different 70 input and output primitive types. 71 72 emit.* tests test geometry shaders with different number of EmitVertex() 73 and EndPrimitive() calls, ranging from too few to superfluous. A geometry 74 shader invocation with name *_emit_N_end_M calls EmitVertex() N times and 75 EndPrimitive() M times. 76 77 varying.* tests verify the functionality of vertex shader -> geometry shader 78 varyigns and geometry shader -> fragment shader varyings. 79 80 layered.* tests geometry shader layered rendering targeting a cubemap, 3D, 81 2D array, and 2D multisample array texture. Tests render to the default layers, 82 only to one layer, each layer separately, or to each layer with different 83 contents and verify the contents of each layer. fragment_layer_* cases verify 84 the fragment shader built-in variable gl_Layer by outputting different color to 85 each layer. layer_provoking_vertex_* cases verify implementation dependent value 86 GL_LAYER_PROVOKING_VERTEX by rendering two triangles with one vertex having a 87 different gl_Layer value. The actual provoking vertex is then verified by 88 checking the layer contents. 89 90 instanced.* tests geometry shader instancing functionality. 91 geometry[_output_different]_N_invocations cases test basic geometry shader 92 instancing by rendering primitives in a circle formation. Each output primitive 93 on the circle is generated by a single geometry shader invocation and each 94 circle is generated by a single input primitive. invocation_per_layer and 95 multiple_layers_per_invocation cases test geometry shader instancing with 96 layered rendering. In invocation_per_layer cases, shader invocation writes only 97 to a single layer and in multiple_layers_per_invocation cases to two layers. In 98 invocation_output_vary_by_* cases, invocations emit a varying number of 99 vertices, depending on a shader varying, uniform or a texture lookup. 100 draw_N_instances_geometry_M_invocations cases test geometry instancing in with 101 instanced drawing. As in the geometry_N_invocations, a group of primitives is 102 drawn around each input primitive instance. 103 104 negative.* cases create a geometry shader accepting a certain input 105 primitive type and then try to use the shader when drawing with an incompatible 106 primitive type. GL_INVALID_OPERATION is expected. 107 108 vertex_transform_feedback.* cases test transform feedback relaxations introduced 109 in the extension. Tests include all new render primitive modes and 110 draw{arrays,elements}{e,indirect,instanced} draw functions. 111 capture_vertex_draw_elements_overflow_single_buffer case tests that a 112 buffer-overflowing primitive feedback result is not partially written to the 113 feedback buffer. 114
