trusty (3) SoProfilingReportGenerator.3.gz

Provided by: libcoin80-doc_3.1.4~abc9f50-4ubuntu2_all bug

NAME

       SoProfilingReportGenerator -

       Convenience report generator functionality.

SYNOPSIS

       #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)

Detailed Description

       Convenience report generator functionality.

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

       Since:
           Coin 3.0

Member Function Documentation

   void SoProfilingReportGenerator::init (void) [static]
       Allocate mutexes and other such infrastructure constructs needed by the report generator.

   SbProfilingReportSortCriteria * SoProfilingReportGenerator::getReportSortCriteria (const SbList< SortOrder >
       &order) [static]
       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) [static]
       Returns a sensible default that can be used for a given profiling data categorization.

   SbProfilingReportPrintCriteria * SoProfilingReportGenerator::getReportPrintCriteria (const SbList< Column >
       &order) [static]
       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) [static]
       Returns a default printing criteria object that can be used sensibly with the given profiling data
       categorization.

   void SoProfilingReportGenerator::generate (const SbProfilingData &data, DataCategorizationcategorization,
       SbProfilingReportSortCriteria *sort, SbProfilingReportPrintCriteria *print, intcount, SbBooladdheader,
       ReportCB *reportcallback, void *userdata) [static]
       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) [static]
       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) [static]
       Ready-made callback that can be used with generate() to print to stderr.

       See Also:
           generate

Author

       Generated automatically by Doxygen for Coin from the source code.