ArmaScriptProfiler

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.

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.png

example 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.png

profilerLog example output

Syntax

Syntax:

profilerLog message

Parameters:

message : String - The message to add.

Return Value:

Nothing

Examples

Example 1:

profilerLog "testLog";