Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

class Enlighten::EnlightenProfile

A container for Enlighten runtime profile statistics.

It defines the interface used by the HLRT to record statistics. A pointer to an EnlightenProfile is a member of UpdateManagerProperties. If non-NULL upon creation of an update manager, the HLRT will push real time stats to the EnlightenProfile object.

Functions

NameDescription
DumpCubeMapStatsToStream(Geo::IGeoStream &)

Writes some summary stats (average etc.) for all Enlighten cube maps.

DumpCurrentStatsToStream(Geo::IGeoStream &)

Writes the set of most recently recorded stats.

DumpHeaderToStream(Geo::IGeoStream &)

Writes a small header containing the description (see SetDescription).

DumpProbeSetStatsToStream(Geo::IGeoStream &)

Writes some summary stats (average etc.) for all Enlighten probe sets.

DumpSystemStatsToStream(Geo::IGeoStream &)

Writes some summary stats (average etc.) for all Enlighten systems.

DumpToStream(Geo::IGeoStream &)

Writes the header, current stats and system stats to the given stream.

GetAggregateProfile()

Read-only access to profile data.

GetCubeMapProfileAtIdx(Geo::s32)

Get a cube map at the specified index.

GetCubeMapProfileAtIdx(Geo::s32)

Get a cube map at the specified index.

GetCubeMapProfileFromGuid(const Geo::GeoGuid &)

Get a cube map from a given guid.

GetDescription()

Gets/sets the profile description which is written in the header in DumpHeaderToStream.

GetNumCubeMaps()

Get number of recorded cube maps Calls to this should be surrounded in a Lock/Unlock pair.

GetNumProbeSets()

Get number of recorded probe sets.

GetNumSystems()

Get number of recorded systems.

GetProbeSetProfileAtIdx(Geo::s32)

Get a probe set at the specified index.

GetProbeSetProfileAtIdx(Geo::s32)

Get a probe set at the specified index.

GetProbeSetProfileFromGuid(const Geo::GeoGuid &)

Get a probe set from a given guid.

GetSystemProfileAtIdx(Geo::s32)

Get a system at the specified index.

GetSystemProfileAtIdx(Geo::s32)

Read-only access to profile data.

GetSystemProfileFromGuid(const Geo::GeoGuid &)

Get a system from a given guid.

Lock()

Multi-threaded access controls.

RecordAggregateProfileItem(AggregateProfileItem, double)

Record aggregate profile items.

RecordAggregateProfileItemUnsafe(AggregateProfileItem, double)

Record aggregate profile items.

RecordCubeMapItem(const Geo::GeoGuid &, CubeMapProfileItem, double)

Record a stat item for cube maps.

RecordEnlightenCpuTime(double)

Record a stat item for total enlighten cpu time.

RecordEnlightenCpuTimeUnsafe(double)

Record a stat item for total enlighten cpu time.

RecordEnlightenCubeMapTime(double)

Record a stat item for total enlighten cube map time.

RecordEnlightenCubeMapTimeUnsafe(double)

Record a stat item for total enlighten cube map time.

RecordEnlightenGpuTime(double)

Record a stat item for total enlighten gpu time.

RecordEnlightenGpuTimeUnsafe(double)

Record a stat item for total enlighten gpu time.

RecordEnlightenProbeInterpolationTime(double)

Record a stat item for total enlighten light probe interpolation time.

RecordEnlightenProbeInterpolationTimeUnsafe(double)

Record a stat item for total enlighten light probe interpolation time.

RecordEnlightenProbeSetTime(double)

Record a stat item for total enlighten light probe time (either cpu or gpu)

RecordEnlightenProbeSetTimeUnsafe(double)

Record a stat item for total enlighten light probe time (either cpu or gpu)

RecordProbeSetItem(const Geo::GeoGuid &, ProbeSetProfileItem, double)

Record a stat item for probes sets.

RecordSystemItem(const Geo::GeoGuid &, SystemProfileItem, double)

Stat recording functions.

RegisterCubeMap(const Geo::GeoGuid &)

Register HLRT objects with the profiler and returns their respective index.

RegisterProbeSet(const Geo::GeoGuid &)

Register HLRT objects with the profiler and returns their respective index.

RegisterSystem(const Geo::GeoGuid &)

Register HLRT objects with the profiler and returns their respective index.

Reset()

Reset all recorded stats. Also empties the arrays.

ResetHistory()

Reset the recorded stats.

SetDescription(ProfileDescription)

Gets/sets the profile description which is written in the header in DumpHeaderToStream.

Unlock()

Unlock access to the profile records.


Anchor
aba5e3a406e454c88d8e0fa140d5f6e22
aba5e3a406e454c88d8e0fa140d5f6e22

void Enlighten::EnlightenProfile::DumpCubeMapStatsToStream

...

public: void DumpCubeMapStatsToStream
(
    Geo::IGeoStream & stream
) const

...

Writes some summary stats (average etc.) for all Enlighten cube maps.


Anchor
af9a9857ee2988e4be0a674a4bedd83f0
af9a9857ee2988e4be0a674a4bedd83f0

void Enlighten::EnlightenProfile::DumpCurrentStatsToStream

...

public: void DumpCurrentStatsToStream
(
    Geo::IGeoStream & stream
) const

...

Writes the set of most recently recorded stats.


Anchor
a0d5b794cacec2c7486fa75885ed74753
a0d5b794cacec2c7486fa75885ed74753

void Enlighten::EnlightenProfile::DumpHeaderToStream

...

public: void DumpHeaderToStream
(
    Geo::IGeoStream & stream
) const

...

Writes a small header containing the description (see SetDescription).


Anchor
a71eccec58029ae951a4dc9d90715f940
a71eccec58029ae951a4dc9d90715f940

void Enlighten::EnlightenProfile::DumpProbeSetStatsToStream

...

public: void DumpProbeSetStatsToStream
(
    Geo::IGeoStream & stream
) const

...

Writes some summary stats (average etc.) for all Enlighten probe sets.


Anchor
ab99d8e15cf56c836bfdaad1b93558e09
ab99d8e15cf56c836bfdaad1b93558e09

void Enlighten::EnlightenProfile::DumpSystemStatsToStream

...

public: void DumpSystemStatsToStream
(
    Geo::IGeoStream & stream
) const

...

Writes some summary stats (average etc.) for all Enlighten systems.


Anchor
a860e9b98b526cc7374ed4b4d417562b4
a860e9b98b526cc7374ed4b4d417562b4

void Enlighten::EnlightenProfile::DumpToStream

...

public: void DumpToStream
(
    Geo::IGeoStream & stream
) const

...

Writes the header, current stats and system stats to the given stream.


Anchor
a7627e289ba5eb20dd566f6342af6695a
a7627e289ba5eb20dd566f6342af6695a

const EnlightenAggregateProfile* Enlighten::EnlightenProfile::GetAggregateProfile

...

public: const EnlightenAggregateProfile * GetAggregateProfile() const

...

Read-only access to profile data.

Warning
titleWarning

All of these functions should be surrounded in a Lock/Unlock pair.Get the aggregate profile history


Anchor
a4f905499b3b592ac34837111dc7e22ef
a4f905499b3b592ac34837111dc7e22ef

EnlightenCubeMapProfile* Enlighten::EnlightenProfile::GetCubeMapProfileAtIdx

...

public: EnlightenCubeMapProfile * GetCubeMapProfileAtIdx
(
    Geo::s32 idx
)

...

Get a cube map at the specified index.

Calls to this and all access to the returned pointer should be surrounded in a Lock/Unlock pair.


Anchor
aa0a0d34690394aeb1539ebe92219666b
aa0a0d34690394aeb1539ebe92219666b

const EnlightenCubeMapProfile* Enlighten::EnlightenProfile::GetCubeMapProfileAtIdx

...

public: const EnlightenCubeMapProfile * GetCubeMapProfileAtIdx
(
    Geo::s32 idx
) const

...

Get a cube map at the specified index.

Calls to this and all access to the returned pointer should be surrounded in a Lock/Unlock pair.


Anchor
a3b3e9adcce96a7b86e62175533764ea8
a3b3e9adcce96a7b86e62175533764ea8

Geo::s32 Enlighten::EnlightenProfile::GetCubeMapProfileFromGuid

...

public: Geo::s32 GetCubeMapProfileFromGuid
(
    const Geo::GeoGuid & guid
) const

...

Get a cube map from a given guid.

Calls to this and all access to the returned pointer should be surrounded in a Lock/Unlock pair.

Returns

-1 if guid does not exit.


Anchor
a4e3de780d328815de698ddb5dc6542ad
a4e3de780d328815de698ddb5dc6542ad

ProfileDescription Enlighten::EnlightenProfile::GetDescription

...

public: ProfileDescription GetDescription()

...

Gets/sets the profile description which is written in the header in DumpHeaderToStream.


Anchor
a151bfdc2caa41bcf0b9742b407c26300
a151bfdc2caa41bcf0b9742b407c26300

Geo::s32 Enlighten::EnlightenProfile::GetNumCubeMaps

...

public: Geo::s32 GetNumCubeMaps() const

...

Get number of recorded cube maps Calls to this should be surrounded in a Lock/Unlock pair.


Anchor
a4ab201ab5e2334e1ecde9830874d12a4
a4ab201ab5e2334e1ecde9830874d12a4

Geo::s32 Enlighten::EnlightenProfile::GetNumProbeSets

...

public: Geo::s32 GetNumProbeSets() const

...

Get number of recorded probe sets.

Calls to this should be surrounded in a Lock/Unlock pair


Anchor
a9d738c445efb155c6b330064c5a31109
a9d738c445efb155c6b330064c5a31109

Geo::s32 Enlighten::EnlightenProfile::GetNumSystems

...

public: Geo::s32 GetNumSystems() const

...

Get number of recorded systems.

Calls to this should be surrounded in a Lock/Unlock pair


Anchor
aecd1175bb5571c1d2941b7c035e0b3b2
aecd1175bb5571c1d2941b7c035e0b3b2

const EnlightenProbeSetProfile* Enlighten::EnlightenProfile::GetProbeSetProfileAtIdx

...

public: const EnlightenProbeSetProfile * GetProbeSetProfileAtIdx
(
    Geo::s32 idx
) const

...

Get a probe set at the specified index.

Calls to this and all access to the returned pointer should be surrounded in a Lock/Unlock pair.


Anchor
a5698435ca9e5264dd3ff678458481458
a5698435ca9e5264dd3ff678458481458

EnlightenProbeSetProfile* Enlighten::EnlightenProfile::GetProbeSetProfileAtIdx

...

public: EnlightenProbeSetProfile * GetProbeSetProfileAtIdx
(
    Geo::s32 idx
)

...

Get a probe set at the specified index.

Calls to this and all access to the returned pointer should be surrounded in a Lock/Unlock pair.


Anchor
a27f5aa091cf4b91c3a6cd559f512302e
a27f5aa091cf4b91c3a6cd559f512302e

Geo::s32 Enlighten::EnlightenProfile::GetProbeSetProfileFromGuid

...

public: Geo::s32 GetProbeSetProfileFromGuid
(
    const Geo::GeoGuid & guid
) const

...

Get a probe set from a given guid.

Calls to this and all access to the returned pointer should be surrounded in a Lock/Unlock pair.

Returns

-1 if guid does not exit.


Anchor
aa88287f4343c62615d71ff6695ea0f54
aa88287f4343c62615d71ff6695ea0f54

const EnlightenSystemProfile* Enlighten::EnlightenProfile::GetSystemProfileAtIdx

...

public: const EnlightenSystemProfile * GetSystemProfileAtIdx
(
    Geo::s32 idx
) const

...

Get a system at the specified index.

Calls to this and all access to the returned pointer should be surrounded in a Lock/Unlock pair.


Anchor
a1a7766e750bac701ff10568a1252396e
a1a7766e750bac701ff10568a1252396e

EnlightenSystemProfile* Enlighten::EnlightenProfile::GetSystemProfileAtIdx

...

public: EnlightenSystemProfile * GetSystemProfileAtIdx
(
    Geo::s32 idx
)

...

Read-only access to profile data.

Warning
titleWarning

All of these functions should be surrounded in a Lock/Unlock pair.Get the aggregate profile history


Anchor
aace2b1c60493b1f7c540443b521ad055
aace2b1c60493b1f7c540443b521ad055

Geo::s32 Enlighten::EnlightenProfile::GetSystemProfileFromGuid

...

public: Geo::s32 GetSystemProfileFromGuid
(
    const Geo::GeoGuid & guid
) const

...

Get a system from a given guid.

Calls to this and all access to the returned pointer should be surrounded in a Lock/Unlock pair.

Returns

-1 if guid does not exit.


Anchor
a1bdb85d0acc520e036881d7273afddb0
a1bdb85d0acc520e036881d7273afddb0

void Enlighten::EnlightenProfile::Lock

...

public: void Lock() const

...

Multi-threaded access controls.

Lock access to the profile records.


Anchor
a519846723e06fec1e2bb06f0c37d461c
a519846723e06fec1e2bb06f0c37d461c

void Enlighten::EnlightenProfile::RecordAggregateProfileItem

...

public: void RecordAggregateProfileItem
(
    AggregateProfileItem item,
    double value
)

...

Record aggregate profile items.


Anchor
ad8fba3edfc20bf9545cee45c0aeb113f
ad8fba3edfc20bf9545cee45c0aeb113f

void Enlighten::EnlightenProfile::RecordAggregateProfileItemUnsafe

...

public: void RecordAggregateProfileItemUnsafe
(
    AggregateProfileItem item,
    double value
)

...

Record aggregate profile items.


Anchor
a11dd4f363779755cdd1f03f34df904c8
a11dd4f363779755cdd1f03f34df904c8

void Enlighten::EnlightenProfile::RecordCubeMapItem

...

public: void RecordCubeMapItem
(
    const Geo::GeoGuid & cubeMapGuid,
    CubeMapProfileItem profileType,
    double value
)

...

Record a stat item for cube maps.


Anchor
a54964958eefec198354479b1ae10d705
a54964958eefec198354479b1ae10d705

void Enlighten::EnlightenProfile::RecordEnlightenCpuTime

...

public: void RecordEnlightenCpuTime
(
    double value
)

...

Record a stat item for total enlighten cpu time.


Anchor
a36f2426945b0a9432b919046fb61e5f3
a36f2426945b0a9432b919046fb61e5f3

void Enlighten::EnlightenProfile::RecordEnlightenCpuTimeUnsafe

...

public: void RecordEnlightenCpuTimeUnsafe
(
    double value
)

...

Record a stat item for total enlighten cpu time.


Anchor
a0f71d14a0583a26bb2eb5cab8ddd77e1
a0f71d14a0583a26bb2eb5cab8ddd77e1

void Enlighten::EnlightenProfile::RecordEnlightenCubeMapTime

...

public: void RecordEnlightenCubeMapTime
(
    double value
)

...

Record a stat item for total enlighten cube map time.


Anchor
a7c7fc478b25ac1f04878cf949e8ea508
a7c7fc478b25ac1f04878cf949e8ea508

void Enlighten::EnlightenProfile::RecordEnlightenCubeMapTimeUnsafe

...

public: void RecordEnlightenCubeMapTimeUnsafe
(
    double value
)

...

Record a stat item for total enlighten cube map time.


Anchor
ae7eeefecd98664823b25c1627d7c6b50
ae7eeefecd98664823b25c1627d7c6b50

void Enlighten::EnlightenProfile::RecordEnlightenGpuTime

...

public: void RecordEnlightenGpuTime
(
    double value
)

...

Record a stat item for total enlighten gpu time.


Anchor
a329b1f59e30db90eaa0bd63b5900d345
a329b1f59e30db90eaa0bd63b5900d345

void Enlighten::EnlightenProfile::RecordEnlightenGpuTimeUnsafe

...

public: void RecordEnlightenGpuTimeUnsafe
(
    double value
)

...

Record a stat item for total enlighten gpu time.


Anchor
ae798f7cdba50146a8484090430b5a0a1
ae798f7cdba50146a8484090430b5a0a1

void Enlighten::EnlightenProfile::RecordEnlightenProbeInterpolationTime

...

public: void RecordEnlightenProbeInterpolationTime
(
    double value
)

...

Record a stat item for total enlighten light probe interpolation time.


Anchor
ab7051251e70789d8ab308b6dc98555ac
ab7051251e70789d8ab308b6dc98555ac

void Enlighten::EnlightenProfile::RecordEnlightenProbeInterpolationTimeUnsafe

...

public: void RecordEnlightenProbeInterpolationTimeUnsafe
(
    double value
)

...

Record a stat item for total enlighten light probe interpolation time.


Anchor
abbf67dbd28e560bcee56202cedb5feb1
abbf67dbd28e560bcee56202cedb5feb1

void Enlighten::EnlightenProfile::RecordEnlightenProbeSetTime

...

public: void RecordEnlightenProbeSetTime
(
    double value
)

...

Record a stat item for total enlighten light probe time (either cpu or gpu)


Anchor
ac857dd6c48545d78ed803154ed0bb8c4
ac857dd6c48545d78ed803154ed0bb8c4

void Enlighten::EnlightenProfile::RecordEnlightenProbeSetTimeUnsafe

...

public: void RecordEnlightenProbeSetTimeUnsafe
(
    double value
)

...

Record a stat item for total enlighten light probe time (either cpu or gpu)


Anchor
a009271a32d8c198c9e860fad09bb39a5
a009271a32d8c198c9e860fad09bb39a5

void Enlighten::EnlightenProfile::RecordProbeSetItem

...

public: void RecordProbeSetItem
(
    const Geo::GeoGuid & probeSetGuid,
    ProbeSetProfileItem profileType,
    double value
)

...

Record a stat item for probes sets.


Anchor
a24bc75dcff3471250b6f8958ca7e0239
a24bc75dcff3471250b6f8958ca7e0239

void Enlighten::EnlightenProfile::RecordSystemItem

...

public: void RecordSystemItem
(
    const Geo::GeoGuid & systemGuid,
    SystemProfileItem profileType,
    double value
)

...

Stat recording functions.

Internally they Lock/Unlock this class and so will block if anther thread already has the lock.Record a stat item for systems.


Anchor
ab443a0fbd87d18cf12dd30103cb233b8
ab443a0fbd87d18cf12dd30103cb233b8

Geo::s32 Enlighten::EnlightenProfile::RegisterCubeMap

...

public: Geo::s32 RegisterCubeMap
(
    const Geo::GeoGuid & cubeMapGuid
)

...

Register HLRT objects with the profiler and returns their respective index.


Anchor
aa4cc724ec6729df0b099e8ec1d679881
aa4cc724ec6729df0b099e8ec1d679881

Geo::s32 Enlighten::EnlightenProfile::RegisterProbeSet

...

public: Geo::s32 RegisterProbeSet
(
    const Geo::GeoGuid & probeSetGuid
)

...

Register HLRT objects with the profiler and returns their respective index.


Anchor
ae2eb6aca245eaa8778003c1dab4cf45e
ae2eb6aca245eaa8778003c1dab4cf45e

Geo::s32 Enlighten::EnlightenProfile::RegisterSystem

...

public: Geo::s32 RegisterSystem
(
    const Geo::GeoGuid & systemGuid
)

...

Register HLRT objects with the profiler and returns their respective index.


Anchor
a5674ca135a544ddc97b675002798d10a
a5674ca135a544ddc97b675002798d10a

void Enlighten::EnlightenProfile::Reset

...

public: void Reset()

...

Reset all recorded stats. Also empties the arrays.


Anchor
a80f2dbc2051e34d5cffae1afa6e958cf
a80f2dbc2051e34d5cffae1afa6e958cf

void Enlighten::EnlightenProfile::ResetHistory

...

public: void ResetHistory()

...

Reset the recorded stats.


Anchor
a5379ab2bd01eb0641d5fc786d33fe99b
a5379ab2bd01eb0641d5fc786d33fe99b

void Enlighten::EnlightenProfile::SetDescription

...

public: void SetDescription
(
    ProfileDescription desc
)

...

Gets/sets the profile description which is written in the header in DumpHeaderToStream.


Anchor
a0bba6838fa58a4ed55c8ecea21b3eb51
a0bba6838fa58a4ed55c8ecea21b3eb51

void Enlighten::EnlightenProfile::Unlock

...

public: void Unlock() const

...

Unlock access to the profile records.