doc/testspecs/GL3/functional.conditional_render.txt

   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 3 conditional render
  20
  21 Tests:
  22  + dEQP-GL3.functional.conditional_render.*
  23
  24 Includes:
  25  + All valid rendering commands included/excluded by query
  26    - DrawArrays
  27    - DrawArraysInstanced
  28    - MultiDrawArrays
  29
  30    - DrawElements
  31    - DrawElementsInstanced
  32    - DrawElementsInstancedBaseVertex
  33    - DrawElementsBaseVertex
  34    - DrawRangeElements
  35    - DrawRangeElementsBaseVertex
  36    - MultiDrawElements
  37    - MultiDrawElementsBaseVertex
  38    - Clear
  39    - ClearBuffer*
  40  + All depth comparison modes
  41  + Framebuffer swap between query & render
  42    - Excluding BY_REGION query modes
  43  + All modes
  44    - QUERY_(BY_REGION_)(NO_)WAIT
  45  + Dependent queries
  46
  47 Excludes:
  48  + Immediate mode rendering
  49  + Primitives other than triangles
  50  + Negative tests
  51  + Tests for NO_WAIT and BY_REGION modes are very limited
  52
  53 Description:
  54
  55 Conditional rendering is tested with various depth function/primitive
  56 overlap conditions. Each query test renders a scene with one conditional
  57 render call and verifies the result against the same scene with the
  58 previously GL controlled conditional render call controlled by the test.
  59
  60 Draw calls (excluding clears) are tested with the same method, with the
  61 conditional call indicated by the test name. The occlusion query used in
  62 these tests is trivially true/false.
  63
  64 Clears are tested by rendering some geometry for an occlusion query and then
  65 conditionally clearing the framebuffer. The verification used depends on the
  66 expected result of the occlusion query. If the query is expected to pass, the
  67 framebuffer is verified to contain only the color it was cleared to.
  68 Otherwise the contents of the framebuffer are verified to match its contents
  69 before the conditional clear.
  70
  71 Depth/stencil clear tests unconditionally clear the color buffer after
  72 rendering the occlusion geometry. After the conditional depth/stencil clear
  73 a full framebuffer triangle is rendered with depth/stencil tests setup
  74 to pass if the clear took place. The resulting framebuffer is read out and
  75 compared to the color of the intermediate clear or the filling triangle as
  76 appropriate for the expected occlusion query result.
  77
  78 All clear tests use non-default framebuffers, all others use the default.
  79
  80 Framebuffer swap cases use a trivial occlusion query but change the bound
  81 (read & write) FBO between the occludion query and the conditional rendering.
  82 The occlusion query is performed with the default framebuffer.
  83
  84 Wait mode test render geometry that is not dependent on the result of the
  85 occlusion queries. These tests thus only test for false positive occlusion
  86 query results.
  87
  88 Dependent queries render a number of primitives where each conditionally
  89 rendered primitive (excluding the first) is also used for an occlusion query
  90 that controls the rendering of the next primitive, which in turn is used for
  91 the next occlusion query and so on. In some of these test one primitive in
  92 this chain is placed in an occluded location, starting a cascade of failing
  93 occlusion queries.