docs: fixup heading-levels
[mesa.git] / docs / conform.rst
1 Conformance Testing
2 ===================
3
4 The SGI OpenGL conformance tests verify correct operation of OpenGL
5 implementations. I, Brian Paul, have been given a copy of the tests for
6 testing Mesa. The tests are not publicly available.
7
8 This file has the latest results of testing Mesa with the OpenGL 1.2
9 conformance tests. Testing with the preliminary OpenGL 1.3 tests has
10 also been done. Mesa passes all the 1.3 tests.
11
12 The tests were run using the software X11 device driver on 24-bpp and
13 16-bpp displays.
14
15 Mesa 4.0 and later pass all conformance tests at all path levels. Note
16 that this says nothing about the conformance of hardware drivers based
17 upon Mesa.
18
19 ::
20
21 COVERAGE TESTS
22 --------------
23
24 Test that all API functions accept the legal parameters and reject
25 illegal parameters. The result of each test is either pass or fail.
26
27 % covgl
28 OpenGL Coverage Test.
29 Version 1.2
30
31 covgl passed.
32
33 covgl passed at 1.1 level.
34
35 covgl passed at 1.2 level.
36
37 covgl passed for ARB_multitexture.
38
39
40 % covglu
41 OpenGL GLU Coverage Test.
42 Version 1.3
43
44 covglu passed.
45
46 covglu passed at 1.1 level.
47
48
49 % covglx
50 OpenGL X Coverage Test.
51 Version 1.1.1
52
53 covglx passed.
54
55
56 % primtest -v
57 Open GL Primitives Test.
58 Version 1.2
59
60 [lots of output deleted]
61
62 292159 Combinations.
63 primtest passed.
64
65
66
67
68 GL CONFORMANCE TEST
69 ===================
70
71 Render test images, read them back, then test for expected results.
72
73
74 ----------------------------------------------------------------------
75 % conform -v 2
76
77 OpenGL Conformance Test
78 Version 1.2
79
80 Setup Report.
81 Verbose level = 2.
82 Random number seed = 1.
83 Path inactive.
84
85 Visual Report.
86 Display ID = 35. Indirect Rendering.
87 Double Buffered.
88 RGBA (5, 6, 5, 0).
89 Stencil (8).
90 Depth (16).
91 Accumulation (16, 16, 16, 16).
92
93 Epsilon Report.
94 zero error epsilon = 0.000122.
95 RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
96 Depth buffer error epsilon = 0.000137.
97 Stencil plane error epsilon = 0.00404.
98 Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
99
100 Default State test passed.
101 Must Pass test passed.
102 Divide By Zero test passed.
103 Viewport Clamp test passed.
104 Matrix Stack test passed.
105 Matrix Stack Mixing test passed.
106 Vertex Order test passed.
107 Transformations test passed.
108 Transformation Normal test passed.
109 Viewport Transformation test passed.
110 Buffer Clear test passed.
111 Buffer Corners test passed.
112 Buffer Color test passed.
113 Color Ramp test passed.
114 Mask test passed.
115 Buffer Invariance test passed.
116 Accumulation Buffer test passed.
117 Select test passed.
118 Feedback test passed.
119 Scissor test passed.
120 Alpha Plane Function test passed.
121 Stencil Plane Clear test passed.
122 Stencil Plane Corners test passed.
123 Stencil Plane Operation test passed.
124 Stencil Plane Function test passed.
125 Depth Buffer Clear test passed.
126 Depth Buffer Function test passed.
127 Blend test passed.
128 Dither test passed.
129 LogicOp Function test does not exist for an RGB visual.
130 DrawPixels test passed.
131 CopyPixels test passed.
132 Bitmap Rasterization test passed.
133 Point Rasterization test passed.
134 Anti-aliased Point test passed.
135 Line Rasterization test passed.
136 Line Stipple test passed.
137 Anti-aliased Line test passed.
138 Horizontal and Vertical Line test passed.
139 Triangle Rasterization test passed.
140 Triangle Tile test passed.
141 Triangle Stipple test passed.
142 Anti-aliased Triangles test passed.
143 Quad Rasterization test passed.
144 Polygon Face test passed.
145 Polygon Cull test passed.
146 Polygon Stipple test passed.
147 Polygon Edge test passed.
148 Ambient Material test passed.
149 Ambient Scene test passed.
150 Attenuation Position test passed.
151 Diffuse Light test passed.
152 Diffuse Material test passed.
153 Diffuse Material Normal test passed.
154 Diffuse Material Positioning test passed.
155 Emissive Material test passed.
156 Specular Exponent test passed.
157 Specular Exponent Normal test passed.
158 Specular Local Eye Half Angle test passed.
159 Specular Light test passed.
160 Specular Material test passed.
161 Specular Normal test passed.
162 Spot Positioning test passed.
163 Spot Exponent and Positioning test passed.
164 Spot Exponent and Direction test passed.
165 Fog Exponential test passed.
166 Fog Linear test passed.
167 Texture Decal test passed.
168 Texture Border test passed.
169 Mipmaps Selection test passed.
170 Mipmaps Interpolation test passed.
171 Display Lists test passed.
172 Evaluator test passed.
173 Evaluator Color test passed.
174 Texture Edge Clamp test passed.
175 Packed Pixels test passed.
176 Texture LOD test passed.
177 Rescale Normal test passed.
178 Color Table test passed.
179 Convolution test passed.
180 Convolution Border test passed.
181 Histogram test passed.
182 MinMax test passed.
183 MultiTexture test passed.
184
185 Conform passed.
186
187 ----------------------------------------------------------------------
188 % conform -v 2 -p 1
189
190 OpenGL Conformance Test
191 Version 1.2
192
193 Setup Report.
194 Verbose level = 2.
195 Random number seed = 1.
196 Path level = 1.
197
198 Visual Report.
199 Display ID = 35. Indirect Rendering.
200 Double Buffered.
201 RGBA (5, 6, 5, 0).
202 Stencil (8).
203 Depth (16).
204 Accumulation (16, 16, 16, 16).
205
206 Epsilon Report.
207 zero error epsilon = 0.000122.
208 RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
209 Depth buffer error epsilon = 0.000137.
210 Stencil plane error epsilon = 0.00404.
211 Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
212
213 Default State test passed.
214 Must Pass test passed.
215 Divide By Zero test passed.
216 Viewport Clamp test passed.
217 Matrix Stack test passed.
218 Matrix Stack Mixing test passed.
219 Vertex Order test passed.
220 Transformations test passed.
221 Transformation Normal test passed.
222 Viewport Transformation test passed.
223 Buffer Clear test passed.
224 Buffer Corners test passed.
225 Buffer Color test passed.
226 Color Ramp test passed.
227 Mask test passed.
228 Buffer Invariance test passed.
229 Accumulation Buffer test passed.
230 Select test passed.
231 Feedback test passed.
232 Scissor test passed.
233 Alpha Plane Function test passed.
234 Stencil Plane Clear test passed.
235 Stencil Plane Corners test passed.
236 Stencil Plane Operation test passed.
237 Stencil Plane Function test passed.
238 Depth Buffer Clear test passed.
239 Depth Buffer Function test passed.
240 Blend test passed.
241 Dither test passed.
242 LogicOp Function test does not exist for an RGB visual.
243 DrawPixels test passed.
244 CopyPixels test passed.
245 Bitmap Rasterization test passed.
246 Point Rasterization test passed.
247 Anti-aliased Point test passed.
248 Line Rasterization test passed.
249 Line Stipple test passed.
250 Anti-aliased Line test passed.
251 Horizontal and Vertical Line test passed.
252 Triangle Rasterization test passed.
253 Triangle Tile test passed.
254 Triangle Stipple test passed.
255 Anti-aliased Triangles test passed.
256 Quad Rasterization test passed.
257 Polygon Face test passed.
258 Polygon Cull test passed.
259 Polygon Stipple test passed.
260 Polygon Edge test passed.
261 Ambient Material test passed.
262 Ambient Scene test passed.
263 Attenuation Position test passed.
264 Diffuse Light test passed.
265 Diffuse Material test passed.
266 Diffuse Material Normal test passed.
267 Diffuse Material Positioning test passed.
268 Emissive Material test passed.
269 Specular Exponent test passed.
270 Specular Exponent Normal test passed.
271 Specular Local Eye Half Angle test passed.
272 Specular Light test passed.
273 Specular Material test passed.
274 Specular Normal test passed.
275 Spot Positioning test passed.
276 Spot Exponent and Positioning test passed.
277 Spot Exponent and Direction test passed.
278 Fog Exponential test passed.
279 Fog Linear test passed.
280 Texture Decal test passed.
281 Texture Border test passed.
282 Mipmaps Selection test passed.
283 Mipmaps Interpolation test passed.
284 Display Lists test passed.
285 Evaluator test passed.
286 Evaluator Color test passed.
287 Texture Edge Clamp test passed.
288 Packed Pixels test passed.
289 Texture LOD test passed.
290 Rescale Normal test passed.
291 Color Table test passed.
292 Convolution test passed.
293 Convolution Border test passed.
294 Histogram test passed.
295 MinMax test passed.
296 MultiTexture test passed.
297
298 Conform passed.
299
300 ----------------------------------------------------------------------
301 % conform -v 2 -p 2
302
303 OpenGL Conformance Test
304 Version 1.2
305
306 Setup Report.
307 Verbose level = 2.
308 Random number seed = 1.
309 Path level = 2.
310
311 Visual Report.
312 Display ID = 35. Indirect Rendering.
313 Double Buffered.
314 RGBA (5, 6, 5, 0).
315 Stencil (8).
316 Depth (16).
317 Accumulation (16, 16, 16, 16).
318
319 Epsilon Report.
320 zero error epsilon = 0.000122.
321 RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
322 Depth buffer error epsilon = 0.000137.
323 Stencil plane error epsilon = 0.00404.
324 Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
325
326 Default State test passed.
327 Must Pass test passed.
328 Divide By Zero test passed.
329 Viewport Clamp test passed.
330 Matrix Stack test passed.
331 Matrix Stack Mixing test passed.
332 Vertex Order test passed.
333 Transformations test passed.
334 Transformation Normal test passed.
335 Viewport Transformation test passed.
336 Buffer Clear test passed.
337 Buffer Corners test passed.
338 Buffer Color test passed.
339 Color Ramp test passed.
340 Mask test passed.
341 Buffer Invariance test passed.
342 Accumulation Buffer test passed.
343 Select test passed.
344 Feedback test passed.
345 Scissor test passed.
346 Alpha Plane Function test passed.
347 Stencil Plane Clear test passed.
348 Stencil Plane Corners test passed.
349 Stencil Plane Operation test passed.
350 Stencil Plane Function test passed.
351 Depth Buffer Clear test passed.
352 Depth Buffer Function test passed.
353 Blend test passed.
354 Dither test passed.
355 LogicOp Function test does not exist for an RGB visual.
356 DrawPixels test passed.
357 CopyPixels test passed.
358 Bitmap Rasterization test passed.
359 Point Rasterization test passed.
360 Anti-aliased Point test passed.
361 Line Rasterization test passed.
362 Line Stipple test passed.
363 Anti-aliased Line test passed.
364 Horizontal and Vertical Line test passed.
365 Triangle Rasterization test passed.
366 Triangle Tile test passed.
367 Triangle Stipple test passed.
368 Anti-aliased Triangles test passed.
369 Quad Rasterization test passed.
370 Polygon Face test passed.
371 Polygon Cull test passed.
372 Polygon Stipple test passed.
373 Polygon Edge test passed.
374 Ambient Material test passed.
375 Ambient Scene test passed.
376 Attenuation Position test passed.
377 Diffuse Light test passed.
378 Diffuse Material test passed.
379 Diffuse Material Normal test passed.
380 Diffuse Material Positioning test passed.
381 Emissive Material test passed.
382 Specular Exponent test passed.
383 Specular Exponent Normal test passed.
384 Specular Local Eye Half Angle test passed.
385 Specular Light test passed.
386 Specular Material test passed.
387 Specular Normal test passed.
388 Spot Positioning test passed.
389 Spot Exponent and Positioning test passed.
390 Spot Exponent and Direction test passed.
391 Fog Exponential test passed.
392 Fog Linear test passed.
393 Texture Decal test passed.
394 Texture Border test passed.
395 Mipmaps Selection test passed.
396 Mipmaps Interpolation test passed.
397 Display Lists test passed.
398 Evaluator test passed.
399 Evaluator Color test passed.
400 Texture Edge Clamp test passed.
401 Packed Pixels test passed.
402 Texture LOD test passed.
403 Rescale Normal test passed.
404 Color Table test passed.
405 Convolution test passed.
406 Convolution Border test passed.
407 Histogram test passed.
408 MinMax test passed.
409 MultiTexture test passed.
410
411 Conform passed.
412
413 ----------------------------------------------------------------------
414 % conform -v 2 -p 3
415
416 OpenGL Conformance Test
417 Version 1.2
418
419 Setup Report.
420 Verbose level = 2.
421 Random number seed = 1.
422 Path level = 3.
423
424 Visual Report.
425 Display ID = 35. Indirect Rendering.
426 Double Buffered.
427 RGBA (5, 6, 5, 0).
428 Stencil (8).
429 Depth (16).
430 Accumulation (16, 16, 16, 16).
431
432 Epsilon Report.
433 zero error epsilon = 0.000122.
434 RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
435 Depth buffer error epsilon = 0.000137.
436 Stencil plane error epsilon = 0.00404.
437 Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
438
439 Default State test passed.
440 Must Pass test passed.
441 Divide By Zero test passed.
442 Viewport Clamp test passed.
443 Matrix Stack test passed.
444 Matrix Stack Mixing test passed.
445 Vertex Order test passed.
446 Transformations test passed.
447 Transformation Normal test passed.
448 Viewport Transformation test passed.
449 Buffer Clear test passed.
450 Buffer Corners test passed.
451 Buffer Color test passed.
452 Color Ramp test passed.
453 Mask test passed.
454 Buffer Invariance test passed.
455 Accumulation Buffer test passed.
456 Select test passed.
457 Feedback test passed.
458 Scissor test passed.
459 Alpha Plane Function test passed.
460 Stencil Plane Clear test passed.
461 Stencil Plane Corners test passed.
462 Stencil Plane Operation test passed.
463 Stencil Plane Function test passed.
464 Depth Buffer Clear test passed.
465 Depth Buffer Function test passed.
466 Blend test passed.
467 Dither test passed.
468 LogicOp Function test does not exist for an RGB visual.
469 DrawPixels test passed.
470 CopyPixels test passed.
471 Bitmap Rasterization test passed.
472 Point Rasterization test passed.
473 Anti-aliased Point test passed.
474 Line Rasterization test passed.
475 Line Stipple test passed.
476 Anti-aliased Line test passed.
477 Horizontal and Vertical Line test passed.
478 Triangle Rasterization test passed.
479 Triangle Tile test passed.
480 Triangle Stipple test passed.
481 Anti-aliased Triangles test passed.
482 Quad Rasterization test passed.
483 Polygon Face test passed.
484 Polygon Cull test passed.
485 Polygon Stipple test passed.
486 Polygon Edge test passed.
487 Ambient Material test passed.
488 Ambient Scene test passed.
489 Attenuation Position test passed.
490 Diffuse Light test passed.
491 Diffuse Material test passed.
492 Diffuse Material Normal test passed.
493 Diffuse Material Positioning test passed.
494 Emissive Material test passed.
495 Specular Exponent test passed.
496 Specular Exponent Normal test passed.
497 Specular Local Eye Half Angle test passed.
498 Specular Light test passed.
499 Specular Material test passed.
500 Specular Normal test passed.
501 Spot Positioning test passed.
502 Spot Exponent and Positioning test passed.
503 Spot Exponent and Direction test passed.
504 Fog Exponential test passed.
505 Fog Linear test passed.
506 Texture Decal test passed.
507 Texture Border test passed.
508 Mipmaps Selection test passed.
509 Mipmaps Interpolation test passed.
510 Display Lists test passed.
511 Evaluator test passed.
512 Evaluator Color test passed.
513 Texture Edge Clamp test passed.
514 Packed Pixels test passed.
515 Texture LOD test passed.
516 Rescale Normal test passed.
517 Color Table test passed.
518 Convolution test passed.
519 Convolution Border test passed.
520 Histogram test passed.
521 MinMax test passed.
522 MultiTexture test passed.
523
524 Conform passed.
525
526 ----------------------------------------------------------------------
527 % conform -v 2 -p 4
528
529 OpenGL Conformance Test
530 Version 1.2
531
532 Setup Report.
533 Verbose level = 2.
534 Random number seed = 1.
535 Path level = 4.
536
537 Visual Report.
538 Display ID = 35. Indirect Rendering.
539 Double Buffered.
540 RGBA (5, 6, 5, 0).
541 Stencil (8).
542 Depth (16).
543 Accumulation (16, 16, 16, 16).
544
545 Epsilon Report.
546 zero error epsilon = 0.000122.
547 RGBA error epsilon = 0.0324, 0.016, 0.0324, 0.000122.
548 Depth buffer error epsilon = 0.000137.
549 Stencil plane error epsilon = 0.00404.
550 Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
551
552 Default State test passed.
553 Must Pass test passed.
554 Divide By Zero test passed.
555 Viewport Clamp test passed.
556 Matrix Stack test passed.
557 Matrix Stack Mixing test passed.
558 Vertex Order test passed.
559 Transformations test passed.
560 Transformation Normal test passed.
561 Viewport Transformation test passed.
562 Buffer Clear test passed.
563 Buffer Corners test passed.
564 Buffer Color test passed.
565 Color Ramp test passed.
566 Mask test passed.
567 Buffer Invariance test passed.
568 Accumulation Buffer test passed.
569 Select test passed.
570 Feedback test passed.
571 Scissor test passed.
572 Alpha Plane Function test passed.
573 Stencil Plane Clear test passed.
574 Stencil Plane Corners test passed.
575 Stencil Plane Operation test passed.
576 Stencil Plane Function test passed.
577 Depth Buffer Clear test passed.
578 Depth Buffer Function test passed.
579 Blend test passed.
580 Dither test passed.
581 LogicOp Function test does not exist for an RGB visual.
582 DrawPixels test passed.
583 CopyPixels test passed.
584 Bitmap Rasterization test passed.
585 Point Rasterization test passed.
586 Anti-aliased Point test passed.
587 Line Rasterization test passed.
588 Line Stipple test passed.
589 Anti-aliased Line test passed.
590 Horizontal and Vertical Line test passed.
591 Triangle Rasterization test passed.
592 Triangle Tile test passed.
593 Triangle Stipple test passed.
594 Anti-aliased Triangles test passed.
595 Quad Rasterization test passed.
596 Polygon Face test passed.
597 Polygon Cull test passed.
598 Polygon Stipple test passed.
599 Polygon Edge test passed.
600 Ambient Material test passed.
601 Ambient Scene test passed.
602 Attenuation Position test passed.
603 Diffuse Light test passed.
604 Diffuse Material test passed.
605 Diffuse Material Normal test passed.
606 Diffuse Material Positioning test passed.
607 Emissive Material test passed.
608 Specular Exponent test passed.
609 Specular Exponent Normal test passed.
610 Specular Local Eye Half Angle test passed.
611 Specular Light test passed.
612 Specular Material test passed.
613 Specular Normal test passed.
614 Spot Positioning test passed.
615 Spot Exponent and Positioning test passed.
616 Spot Exponent and Direction test passed.
617 Fog Exponential test passed.
618 Fog Linear test passed.
619 Texture Decal test passed.
620 Texture Border test passed.
621 Mipmaps Selection test passed.
622 Mipmaps Interpolation test passed.
623 Display Lists test passed.
624 Evaluator test passed.
625 Evaluator Color test passed.
626 Texture Edge Clamp test passed.
627 Packed Pixels test passed.
628 Texture LOD test passed.
629 Rescale Normal test passed.
630 Color Table test passed.
631 Convolution test passed.
632 Convolution Border test passed.
633 Histogram test passed.
634 MinMax test passed.
635 MultiTexture test passed.
636
637 Conform passed.
638
639
640
641 GLX CONFORMANCE TEST
642 ====================
643
644 % conformx -v 2
645
646 OpenGL X Conformance Test
647 Version 1.1.1
648
649 Setup Report.
650 Verbose level = 2.
651 Random number seed = 1.
652 Path inactive.
653
654 Visual Report.
655 Display ID = 34. Direct Rendering.
656 Double Buffered.
657 RGBA (8, 8, 8, 0).
658 Stencil (8).
659 Depth (16).
660 Accumulation (16, 16, 16, 16).
661
662 Epsilon Report.
663 zero error epsilon = 0.000122.
664 RGBA error epsilon = 0.00404, 0.00404, 0.00404, 0.000122.
665 Depth buffer error epsilon = 0.000137.
666 Stencil plane error epsilon = 0.00404.
667 Accumulation error epsilon = 0.000137, 0.000137, 0.000137, 0.000137.
668
669 Default State test passed.
670 glReadPixels() test passed.
671 Font test passed.
672
673 Conformx passed.
674
675 NOTE: conformx passes for all machine path levels (-p option).