xref: /aosp_15_r20/external/deqp/doc/testspecs/GLES3/functional.occlusion_query.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    Occlusion query tests
20*35238bceSAndroid Build Coastguard Worker
21*35238bceSAndroid Build Coastguard WorkerTests:
22*35238bceSAndroid Build Coastguard Worker + dEQP-GLES3.functional.occlusion_query.*
23*35238bceSAndroid Build Coastguard Worker
24*35238bceSAndroid Build Coastguard WorkerIncludes:
25*35238bceSAndroid Build Coastguard Worker + Following occluder types are tested:
26*35238bceSAndroid Build Coastguard Worker	- Scissor boxes
27*35238bceSAndroid Build Coastguard Worker	- Depth writes and clears
28*35238bceSAndroid Build Coastguard Worker	- Stencil writes and clears
29*35238bceSAndroid Build Coastguard Worker + Exact occlusion query result verification
30*35238bceSAndroid Build Coastguard Worker	- For query target ANY_SAMPLES_PASSED
31*35238bceSAndroid Build Coastguard Worker + Conservative occlusion query result verification
32*35238bceSAndroid Build Coastguard Worker	- For query target ANY_SAMPLES_PASSED_CONSERVATIVE
33*35238bceSAndroid Build Coastguard Worker
34*35238bceSAndroid Build Coastguard WorkerExcludes:
35*35238bceSAndroid Build Coastguard Worker
36*35238bceSAndroid Build Coastguard WorkerDescription:
37*35238bceSAndroid Build Coastguard Worker
38*35238bceSAndroid Build Coastguard WorkerOcclusion query tests operate using the following steps. First, a number
39*35238bceSAndroid Build Coastguard Workerof occluders are drawn on screen. Occluders can be areas around scissor
40*35238bceSAndroid Build Coastguard Workerboxes, depth writes/clears or stencil writes/clears. Second, a number of
41*35238bceSAndroid Build Coastguard Workertarget primitives are drawn in red. If any target is visible, i.e. red
42*35238bceSAndroid Build Coastguard Workercolor appears in the framebuffer, the occlusion query should return true.
43*35238bceSAndroid Build Coastguard WorkerIf targets are invisible, i.e. red color does not appear in the
44*35238bceSAndroid Build Coastguard Workerframebuffer, the  occlusion query should return false. If these conditions
45*35238bceSAndroid Build Coastguard Workerare not met, the test fails.
46*35238bceSAndroid Build Coastguard Worker
47*35238bceSAndroid Build Coastguard WorkerIf the occlusion query target is ANY_SAMPLES_PASSED_CONSERVATIVE, the test
48*35238bceSAndroid Build Coastguard Workerallows false positives, i.e. the occlusion query can return true even if
49*35238bceSAndroid Build Coastguard Workerred color is not present in the framebuffer. The converse is not allowed:
50*35238bceSAndroid Build Coastguard Workerif red color is present in the framebuffer, the query must return true.
51