dvander@914: /**
dvander@914:  * vim: set ts=4 :
ds@1330:  * =============================================================================
ds@1947:  * SourceMod (C)2004-2008 AlliedModders LLC.  All rights reserved.
ds@1330:  * =============================================================================
ds@1330:  *
ds@1330:  * This file is part of the SourceMod/SourcePawn SDK.
dvander@914:  *
ds@1330:  * This program is free software; you can redistribute it and/or modify it under
ds@1330:  * the terms of the GNU General Public License, version 3.0, as published by the
ds@1330:  * Free Software Foundation.
ds@1330:  * 
ds@1330:  * This program is distributed in the hope that it will be useful, but WITHOUT
ds@1330:  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
ds@1330:  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
ds@1330:  * details.
ds@1330:  *
ds@1330:  * You should have received a copy of the GNU General Public License along with
ds@1330:  * this program.  If not, see <http://www.gnu.org/licenses/>.
ds@1330:  *
ds@1330:  * As a special exception, AlliedModders LLC gives you permission to link the
ds@1330:  * code of this program (as well as its derivative works) to "Half-Life 2," the
ds@1330:  * "Source Engine," the "SourcePawn JIT," and any Game MODs that run on software
ds@1330:  * by the Valve Corporation.  You must obey the GNU General Public License in
ds@1330:  * all respects for all other code used.  Additionally, AlliedModders LLC grants
ds@1330:  * this exception to all derivative works.  AlliedModders LLC defines further
ds@1330:  * exceptions, found in LICENSE.txt (as of this writing, version JULY-31-2007),
ds@1330:  * or <http://www.sourcemod.net/license.php>.
dvander@914:  *
dvander@914:  * Version: $Id$
dvander@914:  */
dvander@914: 
dvander@914: #if defined _profiler_included
dvander@914:  #endinput
dvander@914: #endif
dvander@914: #define _profiler_included
dvander@914: 
dvander@914: /**
dvander@914:  * ONLY AVAILABLE ON WINDOWS RIGHT NOW K.
dvander@914:  */
dvander@914:  
dvander@914: /**
dvander@914:  * Creates a new profile object.  The Handle must be freed
dvander@914:  * using CloseHandle().
dvander@914:  *
dvander@914:  * @return			Handle to the profiler object.
dvander@914:  */
dvander@914: native Handle:CreateProfiler();
dvander@914: 
dvander@914: /**
dvander@914:  * Starts profiling.
dvander@914:  *
dvander@914:  * @param prof		Profiling object.
dvander@914:  * @noreturn
dvander@914:  * @error			Invalid Handle.
dvander@914:  */
dvander@914: native StartProfiling(Handle:prof);
dvander@914: 
dvander@914: /**
dvander@914:  * Stops profiling.
dvander@914:  *
dvander@914:  * @param prof		Profiling object.
dvander@914:  * @noreturn
dvander@914:  * @error			Invalid Handle or profiling was never started.
dvander@914:  */
dvander@914: native StopProfiling(Handle:prof);
dvander@914: 
dvander@914: /**
dvander@914:  * Returns the amount of high-precision time in seconds
dvander@914:  * that passed during the profiler's last start/stop 
dvander@914:  * cycle.
dvander@914:  *
dvander@914:  * @param prof		Profiling object.
dvander@914:  * @return			Time elapsed in seconds.
dvander@914:  * @error			Invalid Handle.
dvander@914:  */
dvander@914: native Float:GetProfilerTime(Handle:prof);