mirror/RetroArch
1
0
Fork 0
mirror of https://github.com/libretro/RetroArch synced 2025-02-10 12:40:03 +00:00
Code Issues Packages Projects Releases Wiki Activity

Start adding documentation for performance.c

Browse Source
This commit is contained in:
twinaphex 2015-01-09 02:37:46 +01:00
parent 953120e5ab
commit 886e6f3f1e
2 changed files with 96 additions and 21 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
performance.c
View File

@ -141,6 +141,13 @@ void retro_perf_log(void)
log_counters(perf_counters_libretro, perf_ptr_libretro); log_counters(perf_counters_libretro, perf_ptr_libretro);
} }
/**
* rarch_get_perf_counter:
*
* Gets performance counter.
*
* Returns: performance counter.
**/
retro_perf_tick_t rarch_get_perf_counter(void) retro_perf_tick_t rarch_get_perf_counter(void)
{ {
retro_perf_tick_t time_ticks = 0; retro_perf_tick_t time_ticks = 0;
@ -193,6 +200,13 @@ retro_perf_tick_t rarch_get_perf_counter(void)
return time_ticks; return time_ticks;
} }
/**
* rarch_get_time_usec:
*
* Gets time in microseconds.
*
* Returns: time in microseconds.
**/
retro_time_t rarch_get_time_usec(void) retro_time_t rarch_get_time_usec(void)
{ {
#if defined(_WIN32) #if defined(_WIN32)
@ -311,6 +325,13 @@ static void arm_enable_runfast_mode(void)
} }
#endif #endif
/**
* rarch_get_cpu_cores:
*
* Gets the amount of available CPU cores.
*
* Returns: amount of CPU cores available.
**/
unsigned rarch_get_cpu_cores(void) unsigned rarch_get_cpu_cores(void)
{ {
#if defined(_WIN32) && !defined(_XBOX) #if defined(_WIN32) && !defined(_XBOX)
@ -354,6 +375,13 @@ unsigned rarch_get_cpu_cores(void)
#endif #endif
} }
/**
* rarch_get_cpu_features:
*
* Gets CPU features..
*
* Returns: bitmask of all CPU features available.
**/
uint64_t rarch_get_cpu_features(void) uint64_t rarch_get_cpu_features(void)
{ {
uint64_t cpu = 0; uint64_t cpu = 0;

83
performance.h
View File

@ -17,27 +17,55 @@
#ifndef _RARCH_PERF_H #ifndef _RARCH_PERF_H
#define _RARCH_PERF_H #define _RARCH_PERF_H
#include "general.h"
#ifdef __cplusplus
extern "C" {
#endif
#ifdef _WIN32 #ifdef _WIN32
#define PERF_LOG_FMT "[PERF]: Avg (%s): %I64u ticks, %I64u runs.\n" #define PERF_LOG_FMT "[PERF]: Avg (%s): %I64u ticks, %I64u runs.\n"
#else #else
#define PERF_LOG_FMT "[PERF]: Avg (%s): %llu ticks, %llu runs.\n" #define PERF_LOG_FMT "[PERF]: Avg (%s): %llu ticks, %llu runs.\n"
#endif #endif
#ifdef __cplusplus /* Used internally by RetroArch. */
extern "C" { #define RARCH_PERFORMANCE_INIT(X) \
#endif static struct retro_perf_counter X = {#X}; \
do { \
if (!(X).registered) \
rarch_perf_register(&(X)); \
} while(0)
#include "general.h" #define RARCH_PERFORMANCE_START(X) rarch_perf_start(&(X))
#define RARCH_PERFORMANCE_STOP(X) rarch_perf_stop(&(X))
#ifndef MAX_COUNTERS
#define MAX_COUNTERS 64 #define MAX_COUNTERS 64
#endif
extern const struct retro_perf_counter *perf_counters_rarch[MAX_COUNTERS]; extern const struct retro_perf_counter *perf_counters_rarch[MAX_COUNTERS];
extern const struct retro_perf_counter *perf_counters_libretro[MAX_COUNTERS]; extern const struct retro_perf_counter *perf_counters_libretro[MAX_COUNTERS];
extern unsigned perf_ptr_rarch; extern unsigned perf_ptr_rarch;
extern unsigned perf_ptr_libretro; extern unsigned perf_ptr_libretro;
/**
* rarch_get_perf_counter:
*
* Gets performance counter.
*
* Returns: performance counter.
**/
retro_perf_tick_t rarch_get_perf_counter(void); retro_perf_tick_t rarch_get_perf_counter(void);
/**
* rarch_get_time_usec:
*
* Gets time in microseconds.
*
* Returns: time in microseconds.
**/
retro_time_t rarch_get_time_usec(void); retro_time_t rarch_get_time_usec(void);
void rarch_perf_register(struct retro_perf_counter *perf); void rarch_perf_register(struct retro_perf_counter *perf);
@ -51,34 +79,53 @@ void rarch_perf_log(void);
void retro_perf_log(void); void retro_perf_log(void);
/**
* rarch_perf_start:
* @perf : pointer to performance counter
*
* Start performance counter.
**/
static inline void rarch_perf_start(struct retro_perf_counter *perf) static inline void rarch_perf_start(struct retro_perf_counter *perf)
{ {
if (g_extern.perfcnt_enable) if (!g_extern.perfcnt_enable || !perf)
{ return;
perf->call_cnt++; perf->call_cnt++;
perf->start = rarch_get_perf_counter(); perf->start = rarch_get_perf_counter();
}
} }
/**
* rarch_perf_stop:
* @perf : pointer to performance counter
*
* Stop performance counter.
**/
static inline void rarch_perf_stop(struct retro_perf_counter *perf) static inline void rarch_perf_stop(struct retro_perf_counter *perf)
{ {
if (g_extern.perfcnt_enable) if (!g_extern.perfcnt_enable || !perf)
return;
perf->total += rarch_get_perf_counter() - perf->start; perf->total += rarch_get_perf_counter() - perf->start;
} }
/**
* rarch_get_cpu_features:
*
* Gets CPU features..
*
* Returns: bitmask of all CPU features available.
**/
uint64_t rarch_get_cpu_features(void); uint64_t rarch_get_cpu_features(void);
/**
* rarch_get_cpu_cores:
*
* Gets the amount of available CPU cores.
*
* Returns: amount of CPU cores available.
**/
unsigned rarch_get_cpu_cores(void); unsigned rarch_get_cpu_cores(void);
/* Used internally by RetroArch. */
#define RARCH_PERFORMANCE_INIT(X) \
static struct retro_perf_counter X = {#X}; \
do { \
if (!(X).registered) \
rarch_perf_register(&(X)); \
} while(0)
#define RARCH_PERFORMANCE_START(X) rarch_perf_start(&(X))
#define RARCH_PERFORMANCE_STOP(X) rarch_perf_stop(&(X))
#ifdef __cplusplus #ifdef __cplusplus
} }