xref: /aosp_15_r20/external/deqp/doc/testspecs/GLES2/functional.stencil.txt (revision 35238bce31c2a825756842865a792f8cf7f89930)
1*35238bceSAndroid Build Coastguard Worker-------------------------------------------------------------------------
2*35238bceSAndroid Build Coastguard WorkerdrawElements Quality Program Test Specification
3*35238bceSAndroid Build Coastguard Worker-----------------------------------------------
4*35238bceSAndroid Build Coastguard Worker
5*35238bceSAndroid Build Coastguard WorkerCopyright 2014 The Android Open Source Project
6*35238bceSAndroid Build Coastguard Worker
7*35238bceSAndroid Build Coastguard WorkerLicensed under the Apache License, Version 2.0 (the "License");
8*35238bceSAndroid Build Coastguard Workeryou may not use this file except in compliance with the License.
9*35238bceSAndroid Build Coastguard WorkerYou may obtain a copy of the License at
10*35238bceSAndroid Build Coastguard Worker
11*35238bceSAndroid Build Coastguard Worker     http://www.apache.org/licenses/LICENSE-2.0
12*35238bceSAndroid Build Coastguard Worker
13*35238bceSAndroid Build Coastguard WorkerUnless required by applicable law or agreed to in writing, software
14*35238bceSAndroid Build Coastguard Workerdistributed under the License is distributed on an "AS IS" BASIS,
15*35238bceSAndroid Build Coastguard WorkerWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
16*35238bceSAndroid Build Coastguard WorkerSee the License for the specific language governing permissions and
17*35238bceSAndroid Build Coastguard Workerlimitations under the License.
18*35238bceSAndroid Build Coastguard Worker-------------------------------------------------------------------------
19*35238bceSAndroid Build Coastguard Worker    Stencil test
20*35238bceSAndroid Build Coastguard Worker
21*35238bceSAndroid Build Coastguard WorkerTests:
22*35238bceSAndroid Build Coastguard Worker + dEQP-GLES2.functional.stencil.*
23*35238bceSAndroid Build Coastguard Worker
24*35238bceSAndroid Build Coastguard WorkerIncludes:
25*35238bceSAndroid Build Coastguard Worker + Stencil buffer clears
26*35238bceSAndroid Build Coastguard Worker + Stencil update with GL_REPLACE in stencil fail, depth fail and depth pass
27*35238bceSAndroid Build Coastguard Worker + All stencil update modes in stencil fail
28*35238bceSAndroid Build Coastguard Worker + All stencil comparison modes
29*35238bceSAndroid Build Coastguard Worker + Masked stencil comparison
30*35238bceSAndroid Build Coastguard Worker + Out-of-range stencil clear values
31*35238bceSAndroid Build Coastguard Worker + Out-of-range stencil update values
32*35238bceSAndroid Build Coastguard Worker
33*35238bceSAndroid Build Coastguard WorkerExcludes:
34*35238bceSAndroid Build Coastguard Worker + Stencil compare or update with points and lines
35*35238bceSAndroid Build Coastguard Worker + Exhaustive testing of all possible stencil test states
36*35238bceSAndroid Build Coastguard Worker
37*35238bceSAndroid Build Coastguard WorkerDescription:
38*35238bceSAndroid Build Coastguard Worker
39*35238bceSAndroid Build Coastguard WorkerThe viewport is divided into NxN cells, where each cell is assigned a target
40*35238bceSAndroid Build Coastguard Workerstencil value, choosen uniformly from available values. In addition there are
41*35238bceSAndroid Build Coastguard Workertwo cells that target out-of-range stencil values. The amount of cells is scaled
42*35238bceSAndroid Build Coastguard Workerbased on available stencil bits. For example with 8b there are 6x6 cells.
43*35238bceSAndroid Build Coastguard Worker
44*35238bceSAndroid Build Coastguard WorkerTest cases choose input parameters for operations based on target stencil value
45*35238bceSAndroid Build Coastguard Workerfor each cell. The parametrized operations are then executed and finally stencil
46*35238bceSAndroid Build Coastguard Workerbuffer contents are visualized by rendering full-screen quads with different
47*35238bceSAndroid Build Coastguard Workercolors that pass only where stencil value equals one of the target values.
48*35238bceSAndroid Build Coastguard Worker
49*35238bceSAndroid Build Coastguard WorkerThe rendered image is compared against reference image. The reference is
50*35238bceSAndroid Build Coastguard Workercomputed using a simplified model of the GL rendering pipe.
51