40/* Set up for C function definitions, even when using C++ */
41#ifdef __cplusplus
42extern"C" {
43#endif
44
45/**
46 * Compares a surface and with reference image data for equality
47 *
48 * \param surface Surface used in comparison
49 * \param referenceSurface Test Surface used in comparison
50 * \param allowable_error Allowable difference (=sum of squared difference for each RGB component) in blending accuracy.
51 *
52 * \returns 0 if comparison succeeded, >0 (=number of pixels for which the comparison failed) if comparison failed, -1 if any of the surfaces were NULL, -2 if the surface sizes differ.