1 #ifndef _GLSRASTERIZATIONTESTUTIL_HPP
2 #define _GLSRASTERIZATIONTESTUTIL_HPP
3 /*-------------------------------------------------------------------------
4  * drawElements Quality Program OpenGL (ES) Module
5  * -----------------------------------------------
6  *
7  * Copyright 2014 The Android Open Source Project
8  *
9  * Licensed under the Apache License, Version 2.0 (the "License");
10  * you may not use this file except in compliance with the License.
11  * You may obtain a copy of the License at
12  *
13  *      http://www.apache.org/licenses/LICENSE-2.0
14  *
15  * Unless required by applicable law or agreed to in writing, software
16  * distributed under the License is distributed on an "AS IS" BASIS,
17  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
18  * See the License for the specific language governing permissions and
19  * limitations under the License.
20  *
21  *//*!
22  * \file
23  * \brief rasterization test utils.
24  *//*--------------------------------------------------------------------*/
25 
26 #include "deMath.h"
27 #include "tcuDefs.hpp"
28 #include "tcuTestLog.hpp"
29 
30 #include <vector>
31 
32 namespace deqp
33 {
34 namespace gls
35 {
36 namespace RasterizationTestUtil
37 {
38 
39 enum CoverageType
40 {
41 	COVERAGE_FULL = 0,		// !< primitive fully covers the queried area
42 	COVERAGE_PARTIAL,		// !< primitive coverage is either partial, or could be full, partial or none depending on rounding and/or fill rules
43 	COVERAGE_NONE,			// !< primitive does not cover area at all
44 
45 	COVERAGE_LAST
46 };
47 
48 enum VerificationMode
49 {
50 	VERIFICATIONMODE_STRICT = 0,	// !< do not allow even a single bad pixel
51 	VERIFICATIONMODE_WEAK,			// !< allow some bad pixels
52 
53 	VERIFICATIONMODE_LAST
54 };
55 
56 enum LineInterpolationMethod
57 {
58 	LINEINTERPOLATION_STRICTLY_CORRECT = 0,	// !< line interpolation matches the specification
59 	LINEINTERPOLATION_PROJECTED,			// !< line interpolation weights are otherwise correct, but they are projected onto major axis
60 	LINEINTERPOLATION_INCORRECT				// !< line interpolation is incorrect
61 };
62 
63 struct TriangleSceneSpec
64 {
65 	struct SceneTriangle
66 	{
67 		tcu::Vec4	positions[3];
68 		tcu::Vec4	colors[3];
69 		bool		sharedEdge[3]; // !< is the edge i -> i+1 shared with another scene triangle
70 	};
71 
72 	std::vector<SceneTriangle> triangles;
73 };
74 
75 struct LineSceneSpec
76 {
77 	struct SceneLine
78 	{
79 		tcu::Vec4	positions[2];
80 		tcu::Vec4	colors[2];
81 	};
82 
83 	std::vector<SceneLine>	lines;
84 	float					lineWidth;
85 };
86 
87 struct PointSceneSpec
88 {
89 	struct ScenePoint
90 	{
91 		tcu::Vec4	position;
92 		tcu::Vec4	color;
93 		float		pointSize;
94 	};
95 
96 	std::vector<ScenePoint> points;
97 };
98 
99 struct RasterizationArguments
100 {
101 	int numSamples;
102 	int subpixelBits;
103 	int redBits;
104 	int greenBits;
105 	int blueBits;
106 };
107 
108 /*--------------------------------------------------------------------*//*!
109  * \brief Calculates triangle coverage at given pixel
110  * Calculates the coverage of a triangle given by three vertices. The
111  * triangle should not be z-clipped. If multisample is false, the pixel
112  * center is compared against the triangle. If multisample is true, the
113  * whole pixel area is compared.
114  *//*--------------------------------------------------------------------*/
115 CoverageType calculateTriangleCoverage (const tcu::Vec4& p0, const tcu::Vec4& p1, const tcu::Vec4& p2, const tcu::IVec2& pixel, const tcu::IVec2& viewportSize, int subpixelBits, bool multisample);
116 
117 /*--------------------------------------------------------------------*//*!
118  * \brief Verify triangle rasterization result
119  * Verifies pixels in the surface are rasterized within the bounds given
120  * by RasterizationArguments. Triangles should not be z-clipped.
121  *
122  * Triangle colors are not used. The triangle is expected to be white.
123  *
124  * Returns false if invalid rasterization is found.
125  *//*--------------------------------------------------------------------*/
126 bool verifyTriangleGroupRasterization (const tcu::Surface& surface, const TriangleSceneSpec& scene, const RasterizationArguments& args, tcu::TestLog& log, VerificationMode mode = VERIFICATIONMODE_STRICT);
127 
128 /*--------------------------------------------------------------------*//*!
129  * \brief Verify line rasterization result
130  * Verifies pixels in the surface are rasterized within the bounds given
131  * by RasterizationArguments. Lines should not be z-clipped.
132  *
133  * Line colors are not used. The line is expected to be white.
134  *
135  * Returns false if invalid rasterization is found.
136  *//*--------------------------------------------------------------------*/
137 bool verifyLineGroupRasterization (const tcu::Surface& surface, const LineSceneSpec& scene, const RasterizationArguments& args, tcu::TestLog& log);
138 
139 /*--------------------------------------------------------------------*//*!
140  * \brief Verify point rasterization result
141  * Verifies points in the surface are rasterized within the bounds given
142  * by RasterizationArguments. Points should not be z-clipped.
143  *
144  * Point colors are not used. The point is expected to be white.
145  *
146  * Returns false if invalid rasterization is found.
147  *//*--------------------------------------------------------------------*/
148 bool verifyPointGroupRasterization (const tcu::Surface& surface, const PointSceneSpec& scene, const RasterizationArguments& args, tcu::TestLog& log);
149 
150 /*--------------------------------------------------------------------*//*!
151  * \brief Verify triangle color interpolation is valid
152  * Verifies the color of a fragments of a colored triangle is in the
153  * valid range. Triangles should not be z-clipped.
154  *
155  * The background is expected to be black.
156  *
157  * Returns false if invalid rasterization interpolation is found.
158  *//*--------------------------------------------------------------------*/
159 bool verifyTriangleGroupInterpolation (const tcu::Surface& surface, const TriangleSceneSpec& scene, const RasterizationArguments& args, tcu::TestLog& log);
160 
161 /*--------------------------------------------------------------------*//*!
162  * \brief Verify line color interpolation is valid
163  * Verifies the color of a fragments of a colored line is in the
164  * valid range. Lines should not be z-clipped.
165  *
166  * The background is expected to be black.
167  *
168  * Returns the detected interpolation method of the input image.
169  *//*--------------------------------------------------------------------*/
170 LineInterpolationMethod verifyLineGroupInterpolation (const tcu::Surface& surface, const LineSceneSpec& scene, const RasterizationArguments& args, tcu::TestLog& log);
171 
172 } // StateQueryUtil
173 } // gls
174 } // deqp
175 
176 #endif // _GLSRASTERIZATIONTESTUTIL_HPP
177