API GetFrameCPUUsage

From Wowpedia
Jump to: navigation, search

Returns the total time used by and number of calls of a frame's event handlers.

time, count = GetFrameCPUUsage(frame[, includeChildren])

Arguments

(frame[, includeChildren])
frame 
Frame - Specifies the frame.
includeChildren 
Boolean - If false, only event handlers of the specified frame are considered. If true or omitted, the values returned will include the handlers for all of the frame's children as well.

Returns

time, count

time 
Number - The total time used by the specified event handlers, in milliseconds.
count 
Number - The total number of times the event handlers were called.


Details

The values returned are just the sum of the values returned by GetFunctionCPUUsage(handler) for all current handlers. Which means that it's not per-frame values, but per-function values. The difference is that if for example an OnEvent handler is used by two frames A and B, and, say, B:OnEvent() is called, both A and B get blamed for it.
It also means that if a frame's handlers change, the CPU used by the previous handlers is ignored, because only the current handlers are considered.
Note that OnUpdate CPU usage is NOT included at all (tested at 6.0.3)