xref: /aosp_15_r20/external/deqp/doc/testspecs/GLES3/functional.shaders.matrix.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    Matrix tests
20*35238bceSAndroid Build Coastguard Worker
21*35238bceSAndroid Build Coastguard WorkerTests:
22*35238bceSAndroid Build Coastguard Worker + dEQP-GLES3.functional.shaders.matrix.*
23*35238bceSAndroid Build Coastguard Worker + dEQP-GLES3.functional.shaders.conversions.scalar_to_matrix.*
24*35238bceSAndroid Build Coastguard Worker + dEQP-GLES3.functional.shaders.conversions.matrix_to_matrix.*
25*35238bceSAndroid Build Coastguard Worker + dEQP-GLES3.functional.shaders.conversions.matrix_combine.*
26*35238bceSAndroid Build Coastguard Worker + dEQP-GLES3.functional.shaders.conversions.matrix_illegal.*
27*35238bceSAndroid Build Coastguard Worker + dEQP-GLES3.functional.shaders.indexing.matrix_subscript.*
28*35238bceSAndroid Build Coastguard Worker
29*35238bceSAndroid Build Coastguard WorkerIncludes:
30*35238bceSAndroid Build Coastguard Worker + matN and matNxM (rectangular) matrix types
31*35238bceSAndroid Build Coastguard Worker + Matrix-Matrix and Matrix-Vector arithmetic
32*35238bceSAndroid Build Coastguard Worker   - Constant, uniform and shader in inputs
33*35238bceSAndroid Build Coastguard Worker + Matrix constructors
34*35238bceSAndroid Build Coastguard Worker   - From scalar(s)
35*35238bceSAndroid Build Coastguard Worker   - From other matrices
36*35238bceSAndroid Build Coastguard Worker   - From mixed inputs
37*35238bceSAndroid Build Coastguard Worker + Negative tests for illegal matrix constructor usage
38*35238bceSAndroid Build Coastguard Worker + Matrix static and dynamic indexing
39*35238bceSAndroid Build Coastguard Worker
40*35238bceSAndroid Build Coastguard WorkerExcludes:
41*35238bceSAndroid Build Coastguard Worker + Matrices in uniform blocks
42*35238bceSAndroid Build Coastguard Worker   - Covered in separate UBO tests
43*35238bceSAndroid Build Coastguard Worker
44*35238bceSAndroid Build Coastguard WorkerDescription:
45*35238bceSAndroid Build Coastguard Worker
46*35238bceSAndroid Build Coastguard WorkerMatrix arithmetic tests operate like other shader rendering tests.
47*35238bceSAndroid Build Coastguard WorkerInput matrices and vectors are read from uniforms, shader inputs
48*35238bceSAndroid Build Coastguard Workeror constructed as constant values. Operation is performed in shader
49*35238bceSAndroid Build Coastguard Workerbody and the final result is reduced to vec3 that is assigned to
50*35238bceSAndroid Build Coastguard Workervertex or fragment color. Rendered image is compared against a
51*35238bceSAndroid Build Coastguard Workerreference image computed using same algorithm written in C.
52*35238bceSAndroid Build Coastguard Worker
53*35238bceSAndroid Build Coastguard WorkerMatrix constructor and coversion tests compare results against
54*35238bceSAndroid Build Coastguard Workerpre-computed reference value in fragment shader. Fragment color
55*35238bceSAndroid Build Coastguard Workeris either white or black depending on whether the result were
56*35238bceSAndroid Build Coastguard Workercorrect or not.
57*35238bceSAndroid Build Coastguard Worker
58*35238bceSAndroid Build Coastguard WorkerUniform buffer object tests are described in a separate test
59*35238bceSAndroid Build Coastguard Workerspecification document.
60