|
3754
|
1
|
|
|
2
|
|
|
3 SDL Automated Testing Framework User Documentation
|
|
|
4 by Edgar Simo Serra
|
|
|
5
|
|
|
6
|
|
|
7
|
|
|
8 Abstract
|
|
|
9
|
|
|
10 The SDL Automated Testing Framework, hereby after called SDL_AT, is a meant
|
|
|
11 to test the SDL code for regressions and other possible failures. It can also
|
|
|
12 be used to display what your SDL set up supports.
|
|
|
13
|
|
|
14
|
|
|
15
|
|
|
16 Basics
|
|
|
17
|
|
|
18 The main way to use the framework is to compile it and run it, that can be
|
|
|
19 done with the following command:
|
|
|
20
|
|
|
21 $> make test
|
|
|
22
|
|
|
23 It should then display something like:
|
|
|
24
|
|
|
25 Platform : All tests successful (2)
|
|
|
26 SDL_RWops : All tests successful (5)
|
|
|
27 SDL_Surface : All tests successful (6)
|
|
|
28 Rendering with x11 driver : All tests successful (4)
|
|
|
29
|
|
|
30 Indicating that all tests were successful. If however a test fails output it
|
|
|
31 will report the failure to stderr indicating where and why it happened. This
|
|
|
32 output can then be sent to the developers so they can attempt to fix the
|
|
|
33 problem.
|
|
|
34
|
|
|
35
|
|
|
36
|
|
|
37 Advanced
|
|
|
38
|
|
3755
|
39 By passing the "-h" or "--help" parameter to testsdl you can get an overview
|
|
|
40 of all the possible options you can set to furthur tweak the testing. A sample
|
|
|
41 of the options would be the following:
|
|
|
42
|
|
3754
|
43 Usage: ./testsdl [OPTIONS]
|
|
|
44 Options are:
|
|
|
45 -m, --manual enables tests that require user interaction
|
|
|
46 --noplatform do not run the platform tests
|
|
|
47 --norwops do not run the rwops tests
|
|
|
48 --nosurface do not run the surface tests
|
|
|
49 --norender do not run the render tests
|
|
|
50 -v, --verbose increases verbosity level by 1 for each -v
|
|
|
51 -q, --quiet only displays errors
|
|
|
52 -h, --help display this message and exit
|
|
|
53
|
|
3755
|
54
|
|
|
55
|
|
|
56 Developers
|
|
|
57
|
|
|
58 See SDL_at.h for developer information.
|
|
|
59
|
