StartStackProfiling - Debug

Revision as of 15:51, 22 February 2024 by Xieve (talk | contribs) (→‎Notes: Added note concerning a visualizer)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

Member of: Debug Script

Starts profiling a single Papyrus stack until stopped or until the last function exits. The profile files are stored in "<game folder>/Logs/Script/Profiling". This will also cycle the older profiling logs (so log 0 becomes 1, 1 becomes 2, etc). If the stack is already profiled nothing will change. Profiling requests are not saved and will be reset if you load a save game.

SyntaxEdit

Function StartStackProfiling() native global

ParametersEdit

None.

Return ValueEdit

None.

ExamplesEdit

; Starts profiling this current stack
Debug.StartStackProfiling()
; Lots of slow script here

NotesEdit

Profiling requires the "bEnableProfiling" flag in the "[Papyrus]" section of the ini file to be set to 1. Consoles will never profile in release final builds. If you start profiling in a function that is called multiple times in the same stack and stop profiling at the end of the function, only the most recent calls are saved to disk as the logs will continue to cycle.

The flamegraph visualizer speedscope supports all kinds of profiles that Skyrim produces, including those produced by this function.

See AlsoEdit