blender-archive/source/blender/blenlib/PIL_time.h

/*
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; either version 2
 * of the License, or (at your option) any later version.
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
 *
 * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
 * All rights reserved.
 *
 * The Original Code is: all of this file.
 *
 * Contributor(s): Campbell Barton
 *
 * ***** END GPL LICENSE BLOCK *****
 */

/** \file blender/blenlib/PIL_time.h
 *  \ingroup bli
 *  \brief Platform independent time functions.
 */

#ifndef __PIL_TIME_H__
#define __PIL_TIME_H__

#ifdef __cplusplus
extern "C" { 
#endif

extern 
/** Return an indication of time, expressed	as
 * seconds since some fixed point. Successive calls
 * are guaranteed to generate values greater than or
 * equal to the last call.
 */
double  PIL_check_seconds_timer(void);

/**
 * Platform-independent sleep function.
 * \param ms Number of milliseconds to sleep
 */
void    PIL_sleep_ms(int ms);

/** Utility defines for timing.
 * requires BLI_utildefines.h for 'AT'
 * TIMEIT_VALUE returns the time since TIMEIT_START was called.
 */
#define TIMEIT_START(var)                                                     \
	{                                                                         \
		double _timeit_##var = PIL_check_seconds_timer();                     \
		printf("time start (" #var "):  " AT "\n");                           \
		fflush(stdout);                                                       \
		{ (void)0

#define TIMEIT_VALUE(var) (float)(PIL_check_seconds_timer() - _timeit_##var)

#define TIMEIT_VALUE_PRINT(var)                                               \
	{                                                                         \
		printf("time update(" #var "): %.6f" "  " AT "\n", TIMEIT_VALUE(var));\
		fflush(stdout);                                                       \
	} (void)0

#define TIMEIT_END(var)                                                       \
	}                                                                         \
	printf("time end   (" #var "): %.6f" "  " AT "\n", TIMEIT_VALUE(var));    \
	fflush(stdout);                                                           \
} (void)0

/**
 * Given some function/expression:
 *   TIMEIT_BENCH(some_function(), some_unique_description);
 */
#define TIMEIT_BENCH(expr, id)                                                \
	{                                                                         \
		TIMEIT_START(id);                                                     \
		(expr);                                                               \
		TIMEIT_END(id);                                                       \
	} (void)0

#define TIMEIT_BLOCK_INIT(what) \
	double _timeit_var_##what = 0; \
	(void) 0

#define TIMEIT_BLOCK_BEGIN(what) \
	{ \
		double _timeit_block_start_##what = PIL_check_seconds_timer();  \
		{ (void)0

#define TIMEIT_BLOCK_END(what) \
		} \
		_timeit_var_##what += PIL_check_seconds_timer() - _timeit_block_start_##what; \
	} (void)0

#define TIMEIT_BLOCK_STATS(what) \
	{ \
		printf("%s time (in seconds): %f\n", #what, _timeit_var_##what); \
		fflush(stdout); \
	} (void)0

#ifdef __cplusplus
}
#endif

#endif  /* !__PIL_TIME_H__ */