Differences

This shows you the differences between two versions of the page.

Link to this comparison view

dev:dgreftest [2016/05/26 19:31] (current)
deva created
Line 1: Line 1:
 +======DGRefTest======
 +It is located in test/​dgreftest folder.
 +It is only compiled if configure was run with smf support (implicit in cli) and unittests.
  
 +
 +This is the output when run with no arguments:
 +<​code>​
 +$ ./​dgreftest ​
 +Usage: ./dgreftest testname drumkit midimap [seed]
 +</​code>​
 +
 +''​testname''​ is the //​basename//​ used to create two files: //​testname//​.mid and //​testname//​.wav,​ ie. testname = "​foo"​ will look for the files ''​foo.mid''​ and ''​foo.wav''​.
 +
 +Drumkit and midimap are the usual arguments as known from the drumgizmo command line interface.
 +
 +The //seed// is an integer used to seed the Random engines. It is optional, and will efault to 0 if omittted.
 +
 +=====Run test=====
 +To run the dgreftest on an existing set of files it is important to use the same drumkit, midimap and seed as was originally used.
 +
 +A couple of test can be downloaded here: [[http://​www.aasimon.org/​public/​reftest]]
 +
 +They can be run with the following two commandlines:​
 +<​code>​
 +$ ./dgreftest test-aasimonster /​your/​path/​to/​aasimonster/​{aasimonster,​midimap}.xml 42
 +$ ./dgreftest test-aasimonster2 /​your/​path/​to/​aasimonster2/​{aasimonster,​midimap}.xml 42
 +</​code>​
 +
 +At the end of the test a diff value is being printet. It is the difference sum of all samples in the output compared to the reference file. If it is 0 the test tells us that the code did not change compared to when the reference file was generated.
 +<​code>​
 +diff_samples:​ 0
 +</​code>​
 +
 +Be aware that a result not 0 is not nessecarily an error, it just signifies that //​something//​ changed //​somewhere//​ but it might have changed into something else that is also correct.
 +
 +If there is a change it is however important to put some thought into why there is a change and whether it is actually a good thing ;)
 +
 +=====Create test=====
 +To create a test, simply run the application only with the .mid file. This will make dgreftest create the .wav file.
dev/dgreftest.txt ยท Last modified: 2016/05/26 19:31 by deva
Trace:
GNU Free Documentation License 1.3
Valid CSS Driven by DokuWiki Recent changes RSS feed Valid XHTML 1.0