doc/testspecs/GLES3/functional.rasterizer_discard.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     Rasterizer discard tests
  20
  21 Tests:
  22  + dEQP-GLES3.functional.rasterizer_discard.*
  23
  24 Includes:
  25  + Correct discarding of following operations are tested:
  26         - All primitive draw modes
  27         - Color clears & writes
  28         - Depth clears & writes
  29         - Stencil clears & writes
  30  + Following test cases are created:
  31         - Discard test for default framebuffer
  32         - Discard test for default framebuffer with scissor test enabled
  33         - Discard test for a framebuffer object
  34
  35 Excludes:
  36
  37 Description:
  38
  39 Rasterizer discard functionality is tested by first clearing color, depth
  40 and stencil buffers to initial values. Next, rasterizer discarding is
  41 enabled, and an operation is performed. Rasterizer discarding is disabled
  42 afterwards. For depth and stencil clears, series of primitives are drawn
  43 to make sure that the buffer clear operations were ignored.
  44
  45 Finally, framebuffer pixels are read. If red color is present or blue
  46 color is not present, the performed operation was not discarded according
  47 to specification and the test fails.
  48
  49 This procedure is performed for both the default framebuffer and an FBO
  50 with color, depth and stencil attachments. Additionally, default
  51 framebuffer discards are tested with scissor test enabled.