XnProfiling.h File Reference

#include <XnOS.h>

Go to the source code of this file.

Defines

#define INVALID_PROFILING_HANDLE   -1
#define XN_PROFILING_START_SECTION(name)   _XN_PROFILING_START_SECTION(name, FALSE)
#define XN_PROFILING_START_MT_SECTION(name)   _XN_PROFILING_START_SECTION(name, TRUE)
#define XN_PROFILING_END_SECTION
#define XN_PROFILING_START_FUNCTION   XN_PROFILING_START_SECTION(__FUNCTION__)
#define XN_PROFILING_END_FUNCTION   XN_PROFILING_END_SECTION

Typedefs

typedef XnInt32 XnProfilingHandle

Functions

XN_C_API XnStatus XN_C_DECL xnProfilingInit (XnUInt32 nProfilingInterval=0)
XN_C_API XnStatus XN_C_DECL xnProfilingInitFromINI (const XnChar *cpINIFileName, const XnChar *cpSectionName)
XN_C_API XnStatus XN_C_DECL xnProfilingShutdown ()
XN_C_API XnBool XN_C_DECL xnProfilingIsActive ()
XN_C_API XnStatus XN_C_DECL xnProfilingSectionStart (const char *csSectionName, XnBool bMT, XnProfilingHandle *pHandle)
XN_C_API XnStatus XN_C_DECL xnProfilingSectionEnd (XnProfilingHandle *pHandle)

Define Documentation

#define INVALID_PROFILING_HANDLE   -1
#define XN_PROFILING_END_FUNCTION   XN_PROFILING_END_SECTION

Ends a profiled function.

#define XN_PROFILING_END_SECTION
Value:
if (__profiling != INVALID_PROFILING_HANDLE)        \
        {                                                   \
            xnProfilingSectionEnd(&__profiling);            \
        }                                                   \
    }

Ends a profiled section.

#define XN_PROFILING_START_FUNCTION   XN_PROFILING_START_SECTION(__FUNCTION__)

Starts a profiled section, giving it the name of the current function. The code section between this declaration and the following XN_PROFILING_END_FUNCTION declaration will be time-measured.

Parameters:
name [in] The name of the section (for printing purposes).
#define XN_PROFILING_START_MT_SECTION ( name   )     _XN_PROFILING_START_SECTION(name, TRUE)
#define XN_PROFILING_START_SECTION ( name   )     _XN_PROFILING_START_SECTION(name, FALSE)

Typedef Documentation

typedef XnInt32 XnProfilingHandle

Function Documentation

XN_C_API XnStatus XN_C_DECL xnProfilingInit ( XnUInt32  nProfilingInterval = 0  ) 

Initializes profiling.

Parameters:
nProfilingInterval [in] The number of milliseconds between profiler printings. A value of zero means profiling is off.
XN_C_API XnStatus XN_C_DECL xnProfilingInitFromINI ( const XnChar *  cpINIFileName,
const XnChar *  cpSectionName 
)

Initializes using INI file.

Parameters:
cpINIFileName [in] Name of INI file.
cpSectionName [in] Name of section in INI file.
XN_C_API XnBool XN_C_DECL xnProfilingIsActive (  ) 

Returns TRUE if profiling is active, or FALSE otherwise.

XN_C_API XnStatus XN_C_DECL xnProfilingSectionEnd ( XnProfilingHandle pHandle  ) 

Ends a profiled section. This function is not meant to be used directly. Please use the XN_PROFILING_END_SECTION macro.

Parameters:
pHandle [in] A handle returned from xnProfilingSectionStart.
XN_C_API XnStatus XN_C_DECL xnProfilingSectionStart ( const char *  csSectionName,
XnBool  bMT,
XnProfilingHandle pHandle 
)

Start a profiled section. This function is not meant to be used directly. Please use the XN_PROFILING_START_SECTION macro.

Parameters:
csSectionName [in] The name of the profiled section.
bMT [in] TRUE if this section is multi-threaded, FALSE otherwise.
pHandle [out] A handle to be used each time this section executes again.
XN_C_API XnStatus XN_C_DECL xnProfilingShutdown (  ) 

Shuts down profiling.

Generated on Fri Nov 9 22:59:08 2012 for OpenNI 1.3.2 by  doxygen 1.6.3