sdl-ios-xcode: test/automated/SDL

annotate test/automated/SDL_at.h @ 3466:a288892cd24c

SDL_RenderReadPixels() needs to flush asynchronous operations before it reads. The semantics are that it reads the back buffer, and those pixels may not be available once SDL_RenderPresent() has happened.

author	Sam Lantinga <slouken@libsdl.org>
date	Sat, 21 Nov 2009 05:05:19 +0000
parents	22ac66da0765
children	78db4f7ae2f3

rev	line source
3259 22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	1 /*
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	2 * Common code for automated test suite.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	3 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	4 * Written by Edgar Simo "bobbens"
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	5 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	6 * Released under Public Domain.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	7 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	8
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	9
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	10 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	11 * @file SDL_at.h
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	12 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	13 * @brief Handles automatic testing functionality.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	14 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	15 * The basic approach with SDL_AT is to divide the tests into what are called
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	16 * test suites and test cases. Each test suite should have multiple test
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	17 * cases, each test case can have multiple asserts.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	18 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	19 * To actually test for conditions within the testcase you check asserts, if
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	20 * the asserts fail the failures will be logged in the testsuite and
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	21 * displayed.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	22 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	23 * Syntax is similar to OpenGL. An example would be:
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	24 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	25 * @code
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	26 * int f; // Number failed
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	27 * SDL_ATinit( "My testsuite" );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	28 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	29 * SDL_ATbegin( "My first testcase" );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	30 * if (!SDL_ATassert( (1+1)==2, "Trying '1+1=2'."))
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	31 * return; // Implicitly calls SDL_ATend if assert fails
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	32 * SDL_ATend(); // Finish testcase
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	33 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	34 * SDL_ATbegin( "My second testcase" );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	35 * if (!SDL_ATassert( (4/2)==2, "Trying '4/2=2'."))
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	36 * return; // Implicitly calls SDL_ATend if assert fails
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	37 * SDL_ATend(); // Finish testcase
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	38 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	39 * f = SDL_ATfinish();
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	40 * @endcode
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	41 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	42 * @author Edgar Simo "bobbens"
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	43 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	44
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	45
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	46 #ifndef _SDL_AT_H
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	47 # define _SDL_AT_H
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	48
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	49
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	50
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	51 enum {
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	52 SDL_AT_VERBOSE, /*< Sets the verbose level. /
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	53 SDL_AT_QUIET /*< Sets quietness. /
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	54 };
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	55
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	56
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	57 /*
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	58 * Suite level actions.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	59 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	60 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	61 * @brief Starts the testsuite.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	62 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	63 * @param suite Name of the suite to start testing.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	64 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	65 void SDL_ATinit( const char *suite );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	66 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	67 * @brief Finishes the testsuite printing out global results if verbose.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	68 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	69 * @return 0 if no errors occurred, otherwise number of failures.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	70 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	71 int SDL_ATfinish (void);
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	72 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	73 * @brief Sets a global property value.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	74 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	75 * @param property Property to set.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	76 * @param value Value to set property to.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	77 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	78 void SDL_ATseti( int property, int value );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	79 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	80 * @brief Gets a global property value.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	81 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	82 * @param property Property to get.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	83 * @param[out] value Value of the property.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	84 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	85 void SDL_ATgeti( int property, int *value );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	86
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	87
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	88 /*
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	89 * Testcase level actions.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	90 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	91 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	92 * @brief Begins a testcase.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	93 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	94 * @param testcase Name of the testcase to begin.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	95 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	96 void SDL_ATbegin( const char *testcase );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	97 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	98 * @brief Checks a condition in the testcase.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	99 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	100 * Will automatically call SDL_ATend if the condition isn't met.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	101 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	102 * @param condition Condition to make sure is true.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	103 * @param msg Message to display for failure.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	104 * @return Returns 1 if the condition isn't met.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	105 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	106 int SDL_ATassert( const char *msg, int condition );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	107 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	108 * @brief Checks a condition in the testcase.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	109 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	110 * Will automatically call SDL_ATend if the condition isn't met.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	111 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	112 * @param condition Condition to make sure is true.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	113 * @param msg Message to display for failure with printf style formatting.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	114 * @return Returns 1 if the condition isn't met.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	115 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	116 int SDL_ATvassert( int condition, const char *msg, ... );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	117 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	118 * @brief Ends a testcase.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	119 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	120 void SDL_ATend (void);
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	121
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	122
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	123 /*
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	124 * Misc functions.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	125 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	126 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	127 * @brief Prints an error.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	128 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	129 * @param msg printf formatted string to display.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	130 * @return Number of character printed.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	131 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	132 int SDL_ATprintErr( const char *msg, ... );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	133 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	134 * @brief Prints some text.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	135 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	136 * @param msg printf formatted string to display.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	137 * @return Number of character printed.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	138 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	139 #define SDL_ATprint(msg, args...) \
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	140 SDL_ATprintVerbose( 0, msg, ## args)
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	141 /**
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	142 * @brief Prints some verbose text.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	143 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	144 * Verbosity levels are as follows:
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	145 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	146 * - 0 standard stdout, enabled by default
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	147 * - 1 additional information
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	148 * - 2 detailed information (spammy)
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	149 *
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	150 * @param level Level of verbosity to print at.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	151 * @param msg printf formatted string to display.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	152 * @return Number of character printed.
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	153 */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	154 int SDL_ATprintVerbose( int level, const char *msg, ... );
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	155
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	156
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	157 #endif /* _SDL_AT_H */
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	158
22ac66da0765 Merged Edgar's code changes from Google Summer of Code 2009 Sam Lantinga <slouken@libsdl.org> parents: diff changeset	159

Mercurial > sdl-ios-xcode

annotate test/automated/SDL_at.h @ 3466:a288892cd24c