16#if defined(JPH_EXTERNAL_PROFILE)
20#ifdef JPH_SHARED_LIBRARY
22using ProfileStartMeasurementFunction = void (*)(
const char *inName,
uint32 inColor,
uint8 *ioUserData);
23using ProfileEndMeasurementFunction = void (*)(
uint8 *ioUserData);
25JPH_EXPORT extern ProfileStartMeasurementFunction ProfileStartMeasurement;
26JPH_EXPORT extern ProfileEndMeasurementFunction ProfileEndMeasurement;
34class alignas(16) ExternalProfileMeasurement :
public NonCopyable
38#ifdef JPH_SHARED_LIBRARY
39 JPH_INLINE ExternalProfileMeasurement(
const char *inName,
uint32 inColor = 0) { ProfileStartMeasurement(inName, inColor, mUserData); }
40 JPH_INLINE ~ExternalProfileMeasurement() { ProfileEndMeasurement(mUserData); }
42 ExternalProfileMeasurement(
const char *inName,
uint32 inColor = 0);
43 ~ExternalProfileMeasurement();
56JPH_SUPPRESS_WARNING_PUSH
60#define JPH_PROFILE_START(name)
61#define JPH_PROFILE_END()
62#define JPH_PROFILE_THREAD_START(name)
63#define JPH_PROFILE_THREAD_END()
64#define JPH_PROFILE_NEXTFRAME()
65#define JPH_PROFILE_DUMP(...)
68#define JPH_PROFILE_TAG2(line) profile##line
69#define JPH_PROFILE_TAG(line) JPH_PROFILE_TAG2(line)
80#define JPH_PROFILE(...) ExternalProfileMeasurement JPH_PROFILE_TAG(__LINE__)(__VA_ARGS__)
83#define JPH_PROFILE_FUNCTION() JPH_PROFILE(JPH_FUNCTION_NAME)
85JPH_SUPPRESS_WARNING_POP
87#elif defined(JPH_PROFILE_ENABLED)
108 void Dump(
const string_view &inTag = string_view());
133 Aggregator(
const char *inName) : mName(inName) { }
136 void AccumulateMeasurement(
uint64 inCyclesInCallWithChildren)
139 mTotalCyclesInCallWithChildren += inCyclesInCallWithChildren;
140 mMinCyclesInCallWithChildren = min(inCyclesInCallWithChildren, mMinCyclesInCallWithChildren);
141 mMaxCyclesInCallWithChildren = max(inCyclesInCallWithChildren, mMaxCyclesInCallWithChildren);
145 bool operator < (
const Aggregator &inRHS)
const
147 return mTotalCyclesInCallWithChildren > inRHS.mTotalCyclesInCallWithChildren;
155 uint64 mTotalCyclesInCallWithChildren = 0;
156 uint64 mMinCyclesInCallWithChildren = 0xffffffffffffffffUL;
157 uint64 mMaxCyclesInCallWithChildren = 0;
165 static void sAggregate(
int inDepth,
uint32 inColor,
ProfileSample *&ioSample,
const ProfileSample *inEnd, Aggregators &ioAggregators, KeyToAggregator &ioKeyToAggregator);
168 void UpdateReferenceTime();
171 uint64 GetProcessorTicksPerSecond()
const;
175 void DumpChart(
const char *inTag,
const Threads &inThreads,
const KeyToAggregator &inKeyToAggregators,
const Aggregators &inAggregators);
179 std::chrono::high_resolution_clock::time_point mReferenceTime;
215#ifdef JPH_SHARED_LIBRARY
239 static bool sOutOfSamplesReported;
250JPH_SUPPRESS_WARNING_PUSH
254#define JPH_PROFILE_START(name) do { Profiler::sInstance = new Profiler; JPH_PROFILE_THREAD_START(name); } while (false)
257#define JPH_PROFILE_END() do { JPH_PROFILE_THREAD_END(); delete Profiler::sInstance; Profiler::sInstance = nullptr; } while (false)
260#define JPH_PROFILE_THREAD_START(name) do { if (Profiler::sInstance) ProfileThread::sSetInstance(new ProfileThread(name)); } while (false)
263#define JPH_PROFILE_THREAD_END() do { delete ProfileThread::sGetInstance(); ProfileThread::sSetInstance(nullptr); } while (false)
266#define JPH_PROFILE_TAG2(line) profile##line
267#define JPH_PROFILE_TAG(line) JPH_PROFILE_TAG2(line)
268#define JPH_PROFILE(...) ProfileMeasurement JPH_PROFILE_TAG(__LINE__)(__VA_ARGS__)
271#define JPH_PROFILE_FUNCTION() JPH_PROFILE(JPH_FUNCTION_NAME)
274#define JPH_PROFILE_NEXTFRAME() Profiler::sInstance->NextFrame()
277#define JPH_PROFILE_DUMP(...) Profiler::sInstance->Dump(__VA_ARGS__)
279JPH_SUPPRESS_WARNING_POP
287JPH_SUPPRESS_WARNING_PUSH
290#define JPH_PROFILE_START(name)
291#define JPH_PROFILE_END()
292#define JPH_PROFILE_THREAD_START(name)
293#define JPH_PROFILE_THREAD_END()
294#define JPH_PROFILE(...)
295#define JPH_PROFILE_FUNCTION()
296#define JPH_PROFILE_NEXTFRAME()
297#define JPH_PROFILE_DUMP(...)
299JPH_SUPPRESS_WARNING_POP
std::uint8_t uint8
Definition Core.h:482
#define JPH_EXPORT
Definition Core.h:271
#define JPH_SUPPRESS_WARNINGS_STD_BEGIN
Definition Core.h:419
#define JPH_SUPPRESS_WARNINGS_STD_END
Definition Core.h:431
std::uint64_t uint64
Definition Core.h:485
unsigned int uint
Definition Core.h:481
#define JPH_NAMESPACE_END
Definition Core.h:414
#define JPH_CLANG_SUPPRESS_WARNING(w)
Definition Core.h:298
std::uint32_t uint32
Definition Core.h:484
#define JPH_EXPORT_GCC_BUG_WORKAROUND
Definition Core.h:275
#define JPH_NAMESPACE_BEGIN
Definition Core.h:408
#define JPH_OVERRIDE_NEW_DELETE
Macro to override the new and delete functions.
Definition Memory.h:31
std::basic_string< char, std::char_traits< char >, STLAllocator< char > > String
Definition STLAllocator.h:107
Class that makes another class non-copyable. Usage: Inherit from NonCopyable.
Definition NonCopyable.h:11
Create this class on the stack to start sampling timing information of a particular scope.
Definition Profiler.h:229
Definition Profiler.h:187
uint32 mColor
Color to use for this sample.
Definition Profiler.h:192
uint64 mEndCycle
Cycle counter at end of measurement.
Definition Profiler.h:196
JPH_OVERRIDE_NEW_DELETE const char * mName
User defined name of this item.
Definition Profiler.h:191
uint8 mDepth
Calculated depth.
Definition Profiler.h:193
uint64 mStartCycle
Cycle counter at start of measurement.
Definition Profiler.h:195
Collects all samples of a single thread.
Definition Profiler.h:201
ProfileSample mSamples[cMaxSamples]
Buffer of samples.
Definition Profiler.h:212
uint mCurrentSample
Next position to write a sample to.
Definition Profiler.h:213
~ProfileThread()
Definition Profiler.inl:17
static ProfileThread * sGetInstance()
Definition Profiler.h:220
String mThreadName
Name of the thread that we're collecting information for.
Definition Profiler.h:211
static void sSetInstance(ProfileThread *inInstance)
Definition Profiler.h:219
static const uint cMaxSamples
Definition Profiler.h:209
Singleton class for managing profiling information.
Definition Profiler.h:96
JPH_OVERRIDE_NEW_DELETE Profiler()
Constructor.
Definition Profiler.h:101
static Profiler * sInstance
Singleton instance.
Definition Profiler.h:117
Definition UnorderedMap.h:30