ArmaScriptProfiler
Jump to navigation
Jump to search
General
Arma Script Profiler is a Mod that provides the ability to profile unscheduled SQF Scripts just like how Performance_Profiling does it for Engine internals.
Once you Capture a Frame the data is put into your Clipboard. To display it properly you need the Profiling build of Arma.
When one or multiple Frames were Captured it automatically opens the captureFrame UI and you have to click on "PASTE ALL" to paste your clipboard content and display the data.
File:ArmaScriptProfiler profilerLogExample.png
Commands
createProfileScope
- Description:
- This creates a new scope. Store it in a a private local variable. Don't store it in a Global Variable!
Syntax
- Syntax:
- createProfileScope scopeName
- Parameters:
- scopeName : String - The name of your scope. This will be displayed in the output.
- Return Value:
- ProfileScope - a proprietary variable Type. This value going out of scope defines the end of the current Scope. So you have to store the result in a local variable.
Examples
- Example 1:
private _scope = createProfileScope "testScope";File:ArmaScriptProfiler profilerLogExample.pngexample output
profilerBlockingSleep
- Description:
- This freezes the engine for 17ms. Used for testing.
Syntax
- Syntax:
- profilerBlockingSleep
- Return Value:
- Nothing
profilerCaptureFrame
- Description:
- Captures the next Frame.
Syntax
- Syntax:
- profilerCaptureFrame
- Return Value:
- Nothing
Examples
- Example 1:
profilerCaptureFrame
Additional Information
- See also:
- diag_captureFrame
profilerCaptureFrames
- Description:
- Captures N Frames.
Syntax
- Syntax:
- profilerCaptureFrames NumberOfFrames
- Parameters:
- NumberOfFrames : Number - The Number of Frames to capture.
- Return Value:
- ProfileScope - a proprietary variable Type. This value going out of scope defines the end of the current Scope. So you have to store the result in a local variable.
Examples
- Example 1:
profilerCaptureFrames 10;
Additional Information
- See also:
- diag_captureFrame
profilerCaptureSlowFrame
- Description:
-
Captures the first frame that hits the threshold.
The runtime of all scripts in the current Frame are summed up. And if they hit the threshold it triggers a Capture.
Syntax
- Syntax:
- profilerCaptureSlowFrame threshold
- Parameters:
- threshold : Number - Threshold in milliseconds
- Return Value:
- Nothing
Examples
- Example 1:
profilerCaptureSlowFrame 2;
Additional Information
- See also:
- diag_captureSlowFrame
profilerCaptureTrigger
- Description:
- Captures the first frame that contains a Trigger.
Syntax
- Syntax:
- profilerCaptureTrigger
- Return Value:
- Nothing
profilerTrigger
- Description:
- A Trigger for profilerCaptureTrigger.
Syntax
- Syntax:
- profilerTrigger
- Return Value:
- Nothing
profilerLog
- Description:
-
Adds a log message to the current Scope.
File:ArmaScriptProfiler profilerLogExample.pngprofilerLog example output
Syntax
- Syntax:
- profilerLog message
- Parameters:
- message : String - The message to add.
- Return Value:
- Nothing
Examples
- Example 1:
profilerLog "testLog";