WoW:API GetFrameCPUUsage: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(initial commit)
 
m (Move page script moved page API GetFrameCPUUsage to API GetFrameCPUUsage without leaving a redirect)
 
(No difference)

Latest revision as of 04:45, 15 August 2023

WoW API < GetFrameCPUUsage

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

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

Arguments[edit]

(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[edit]

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[edit]

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 OnUpdate handler is used by two frames A and B, and, say, B:OnUpdate() 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.