SoProfilingReportGenerator (3)

#include <Profiler/tools/SoProfilingReportGenerator.h>

Public Types

enum Column { NAME, TYPE, COUNT, TIME_SECS, TIME_SECS_MAX, TIME_SECS_AVG, TIME_MSECS, TIME_MSECS_MAX, TIME_MSECS_AVG, TIME_PERCENT, TIME_PERCENT_MAX, TIME_PERCENT_AVG, MEM_BYTES, MEM_KILOBYTES, GFX_MEM_BYTES, GFX_MEM_KILOBYTES }

enum SortOrder { TIME_ASC, TIME_DES, TIME_MAX_ASC, TIME_MAX_DES, TIME_AVG_ASC, TIME_AVG_DES, COUNT_ASC, COUNT_DES, ALPHANUMERIC_ASC, ALPHANUMERIC_DES, MEM_ASC, MEM_DES, GFX_MEM_ASC, GFX_MEM_DES }

enum DataCategorization { TYPES, NAMES, NODES }

enum CallbackResponse { CONTINUE, STOP }

typedef CallbackResponse ReportCB (void *userdata, int entrynum, const char *text)

Static Public Member Functions

static void init (void)

static

SbProfilingReportSortCriteria * getReportSortCriteria (const SbList< SortOrder > &order)"

static

SbProfilingReportSortCriteria * getDefaultReportSortCriteria (DataCategorization category)"

static

SbProfilingReportPrintCriteria * getReportPrintCriteria (const SbList< Column > &order)"

static

SbProfilingReportPrintCriteria * getDefaultReportPrintCriteria (DataCategorization category)"

static void freeCriteria (SbProfilingReportSortCriteria *criteria)

static void freeCriteria (SbProfilingReportPrintCriteria *criteria)

static void generate (const SbProfilingData &data, DataCategorization categorization, SbProfilingReportSortCriteria *sort, SbProfilingReportPrintCriteria *print, int count, SbBool addheader, ReportCB *reportcallback, void *userdata)

static CallbackResponse stdoutCB (void *userdata, int entrynum, const char *text)

static CallbackResponse stderrCB (void *userdata, int entrynum, const char *text)

Convenience report generator functionality.

With this static class, you can conveniently produce a profiling data report from an SbProfilingData object.

Since:

Coin 3.0

void SoProfilingReportGenerator::init (void)\fC [static]\fP

Allocate mutexes and other such infrastructure constructs needed by the report generator.

SbProfilingReportSortCriteria * SoProfilingReportGenerator::getReportSortCriteria (const \fBSbList\fP< SortOrder > &order)\fC [static]\fP

Returns a sorting criteria setting object that will make generate() sort the results based on the given argument list in that left-to-right priority order.

Always end the argument list with TERMINATE_ARGLIST.

See also:

freeCriteria

SbProfilingReportSortCriteria * SoProfilingReportGenerator::getDefaultReportSortCriteria (DataCategorizationcategory)\fC [static]\fP

Returns a sensible default that can be used for a given profiling data categorization.

SbProfilingReportPrintCriteria * SoProfilingReportGenerator::getReportPrintCriteria (const \fBSbList\fP< Column > &order)\fC [static]\fP

Returns a printing criteria setting object that will make generate() send a formatted string as the text argument based on the given argument list. If you force TERMINATE_ARGLIST into the first argument, the text string will be empty.

Always end the argument list with TERMINATE_ARGLIST.

See also:

freeCriteria

SbProfilingReportPrintCriteria * SoProfilingReportGenerator::getDefaultReportPrintCriteria (DataCategorizationcategory)\fC [static]\fP

Returns a default printing criteria object that can be used sensibly with the given profiling data categorization.

void SoProfilingReportGenerator::generate (const \fBSbProfilingData\fP &data, DataCategorizationcategorization, SbProfilingReportSortCriteria *sort, SbProfilingReportPrintCriteria *print, intcount, SbBooladdheader, ReportCB *reportcallback, void *userdata)\fC [static]\fP

Generate a sorted, formatted report, by calling a callback until the number of entries are exhausted or the callback returns STOP.

SoProfilingReportGenerator::CallbackResponse SoProfilingReportGenerator::stdoutCB (void *userdata, intentrynum, const char *text)\fC [static]\fP

Ready-made callback that can be used with generate() to print to stdout.

See also:

generate

SoProfilingReportGenerator::CallbackResponse SoProfilingReportGenerator::stderrCB (void *userdata, intentrynum, const char *text)\fC [static]\fP

Ready-made callback that can be used with generate() to print to stderr.

See also:

generate

Generated automatically by Doxygen for Coin from the source code.