doc/testspecs/GLES31/functional.compute.shared_var.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     Shader Shared Variable Tests
  20
  21 Tests:
  22  + dEQP-GLES31.functional.compute.shared_var.*
  23
  24 Includes:
  25  + All basic types, all precisions
  26  + Single shared variable
  27  + Various work group sizes
  28    - 2x1x3 in basic type cases
  29    - 1x1x1, 64x1x1, 1x64x1, 1x1x64, 256x1x1, 1x256x1, 17x5x9 for selected types
  30  + All built-in atomic operation functions
  31    + int, uint types
  32    + all precisions
  33  + Multiple work groups for atomic function cases
  34
  35 Excludes:
  36  + Multiple shared variables
  37  + Complex types (arrays, structures)
  38  + Negative tests
  39
  40 Description:
  41
  42 Basic type test cases declare a single shared variable of the appropriate
  43 type. In addition following input/output variables are used:
  44  + buffer block containing an array of booleans, one for each item in work group
  45  + u_val[], u_ref[] uniform arrays, filled with identical values
  46  + u_numIters iteration count uniform, initialized with work group size
  47
  48 The compute shader contains a loop that is limited by the u_numIters uniform.
  49 In each iteration one of the work items writes a value from u_val to the
  50 shared variable. A shared memory barrier is issued, and after that all work
  51 items read and compare shared var value to u_ref. If comparison passed for all
  52 iterations, true is set to appropriate element of the output array. Test case
  53 then maps the output SSBO and checks that all elements are true, meaning that
  54 all shader invocations passed the test.
  55
  56
  57 Atomic operation test cases issue multiple work groups of size 3x2x1. In each
  58 work group first invocation initializes shared variable to a certain value.
  59 Barrier is issued and after that each invocation issues atomic operation with
  60 per-invocation value. Resulting values are written out into SSBO. Finally, one
  61 invocation per work group writes out the final shared variable value.
  62
  63 Resulting values from SSBO are read using buffer mapping and verified. The
  64 input values and validation logic depends on the type of the atomic operation.