xref: /aosp_15_r20/external/deqp/doc/testspecs/GLES3/functional.fence_sync.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	Fence sync tests
20*35238bceSAndroid Build Coastguard Worker
21*35238bceSAndroid Build Coastguard WorkerTests:
22*35238bceSAndroid Build Coastguard Worker + dEQP-GLES3.functional.fence_sync.*
23*35238bceSAndroid Build Coastguard Worker
24*35238bceSAndroid Build Coastguard WorkerIncludes:
25*35238bceSAndroid Build Coastguard Worker + Creating and deleting sync objects
26*35238bceSAndroid Build Coastguard Worker + Calling glWaitSync
27*35238bceSAndroid Build Coastguard Worker	- With varying number of primitive draws
28*35238bceSAndroid Build Coastguard Worker + Calling glClientWaitSync and verifying return values
29*35238bceSAndroid Build Coastguard Worker	- With varying number of primitive draws
30*35238bceSAndroid Build Coastguard Worker	- With varying timeouts
31*35238bceSAndroid Build Coastguard Worker	- Flushing or finishing before wait
32*35238bceSAndroid Build Coastguard Worker
33*35238bceSAndroid Build Coastguard WorkerDescription:
34*35238bceSAndroid Build Coastguard Worker
35*35238bceSAndroid Build Coastguard WorkerFence sync functionality is tested by drawing a small or large number of
36*35238bceSAndroid Build Coastguard Workerprimitives with glDrawArrays(). Then a sync object is created, and
37*35238bceSAndroid Build Coastguard Workeroptionally glFlush() or glFinish() are called.
38*35238bceSAndroid Build Coastguard Worker
39*35238bceSAndroid Build Coastguard WorkerWait is then performed with either glWaitSync() or glClientWaitSync(), and
40*35238bceSAndroid Build Coastguard Workerdifferent timeout values as well as the flag GL_SYNC_FLUSH_COMMANDS_BIT
41*35238bceSAndroid Build Coastguard Workerare tested. Finally, errors are checked and the return value of
42*35238bceSAndroid Build Coastguard WorkerglClientWaitSync() is verified.
43*35238bceSAndroid Build Coastguard Worker
44*35238bceSAndroid Build Coastguard WorkerThe testcase fails if errors are created or if glClientWaitSync() returns
45*35238bceSAndroid Build Coastguard WorkerGL_WAIT_FAILED. Additionally, if glFinish() was called before wait, return
46*35238bceSAndroid Build Coastguard Workervalue is required to be GL_ALREADY_SIGNALED.
47