R3vo/Sandbox – User

From Bohemia Interactive Community
Jump to navigation Jump to search
mNo edit summary
 
(30 intermediate revisions by the same user not shown)
Line 1: Line 1:
{{TOC|side}}
{{TOC|side}}
The effect objects added by [[Spearhead 1944]] allow scenario creators to add special effects, such as fire, sounds, smoke and light effects, to there scenarios without the need of scripting.
If you have ever wondered why you scenario is running so badly, performance profiling is the way to find it out. It allows you to find bottlenecks and slow code by capturing a "slow" frame.
The captured data can then be viewed and analysed.


= Ambient Light Effects =
== Getting the correct Version ==
== Light 100 m Illumination ==
Profiling is enabled in the following {{arma3}} versions
Creates a light source with a slightly concentrated light source.
* arma3profiling_x64.exe - '''Part of the Performance Profiling Build'''
* arma3diag_x64.exe - '''Part of the Development Build'''


[[File: land_spe_fx_light_100.png|500px]]
Read [[Arma_3: Steam Branches]] for a guide on how to access these branches.


== Light 300 m Illumination ==
{{Feature|informative|It is recommended to use the '''Performance Profiling Build''' (arma3profiling_x64.exe) for performance profiling because:
Creates a light source, illumination is uniform within 300 m, useful when you want to have visibility during night time.
* Has tools that might not make it into development build
* Has all the profiling related commands that ''arma3diag_x64.exe'' has
* Its performance is closer to the default ''arma3_x64.exe''}}


[[File: land_spe_fx_light_300.png|500px]]
== Frame Capturing ==
There are several commands that allow you to capture a frame.
* [[diag_captureFrame]]
* [[diag_captureSlowFrame]]
* [[diag_logSlowFrame]] - not available in Arma 3 :(
* [[diag_captureFrameToFile]]
In most cases you do not want to capture any or all frames, you just want to capture "slow" frames. A slow frame is a frame that takes longer than the average frame and slows down the game.


== Artillery Ground Lights ==
== How to Use ==  
Simulates light casted by distant explosions. Can be used either to create the atmosphere of a battle or as a way to illuminate the area around the player from time to time.
# Run a mission
# Execute a scripted command <sqf inline>diag_captureSlowFrame ["total", 0.3];</sqf> using any means ([[Arma 3: Debug Console|Debug Console]], mission radio trigger...)
# Once a slow frame is detected, a window will open
# In the window you will be able to browse a lot of performance-related data, which can be interesting
# To export the gathered information for sharing with others:
## Select Main Thread (if not selected yet)
## Press the Copy button
## Open an external text editor
## Paste the text into a new file
## Save the file


[[File: land_spe_fx_artillery_ground_lights.png|500px]]
== Capture Frame UI ==
[[File: arma3-capture frame ui overview.png]]


== Artillery Sky Lights ==
# {{Wiki|TODO}}
Simulates the light of explosions reflected by clouds or particles in the air.
# {{Wiki|TODO}}
# {{Wiki|TODO}}
# {{Wiki|TODO}}
# {{Wiki|TODO}}
# {{Wiki|TODO}}
# {{Wiki|TODO}}
# {{Wiki|TODO}}
# {{Wiki|TODO}}


[[File: land_spe_fx_artillery_sky_lights.png|500px]]
== External Viewer ==
* chrome://tracing
* https://ui.perfetto.dev/


= Ambient Misc Effects =
[[File:Performance_Profiling_04.png|thumb|diag_captureFrame sample output with custom subtree]]
== Ground Fog linked to player ==
== Creating Your Own Subtree ==
Creates fog out of particles around the player, in principle to be used in conjunction with vanilla fog for a more dramatic effect.


[[File: land_spe_fx_player_fog.png|500px]]
When Profiling Per-Frame Eventhandlers (PFH), [[diag_captureFrame]] only shows one blob called siFEH that contains all PFH's so you can't see what part of that is caused by your PFH.<br>
You can create your own subtree inside siFEH by wrapping your function call inside a [[isNil]] CODE statement like this:<br>
Turn your old call which may look like this:
<sqf>
addMissionEventHandler ["EachFrame", {
call myPFHFunction
}];
</sqf>


== Low Fog ==
Into something like this:
Creates rectangular patches of fog, to be placed over puddles, lakes, river beds etc. It can be rotated to fit the area better.
<sqf>
addMissionEventHandler ["EachFrame", {
isNil { call myPFHFunction } // isNil creates the subtree
}];
</sqf>


[[File: land_spe_fx_low_fog.png|500px]]
Now when you run [[diag_captureFrame]] inside of siPFH you will have a subtree called gsEva and behind that you can see the first line of code inside the isNil statement.<br>
It will only show a part of the first line of that code so you should put something descriptive into the [[isNil]] statement.<br>
You can use the same to create a subtree for any function you like. This will also work inside [[Scheduler#Scheduled_Environment|Scheduled]] ([[spawn]]ed) scripts. <br>
But using this method to "subtree" a function with return values requires a little bit of trickery to get the return value out.


== Night Clouds linked to Player ==
Simulates night clouds during night time made out of particles. Useful when you want to benefit from the lighting of a full moon without using vanilla overcast and still have clouds.


[[File: land_spe_fx_night_clouds.png|500px]]
== Notes ==


= Ambient Sound Effects =
* 0.3 is a time in second used to determine what duration of a frame you consider abnormal, and first such frame will be captured.
== Big Fire Burning Sound ==
* 0.3 is definitely something you should not see in a normal game.
Creates a sound source of a burning place.
* If you do not capture any frames with 0.3, try lowering it to 0.2 or 0.1.
* If it triggers too early, before the main slowdown happens, increase it to a higher value, e.g. 1.0.


== Binaural Battle Sounds ==
== Scopes ==
Plays sounds of distant explosions and shots straight into the headset using binaural sounds. Useful when you want to create a battle environment.
{| class="wikitable sortable"
 
|-
= Fire Effects =
! Technical Name !! Descriptive Name !! Description
== Big Fire ==
|-
Creates a relatively big fire, with its own light source and sound. Does damage to players and AI.
| Main
 
|
[[File: land_spe_fx_big_fire.png|500px]]
|
 
|-
== Fire Burst ==
| total
Creates a fire, with its own light source and sound. Does not do damage and its direction can be tweaked by rotating the object.
|
 
|
[[File: land_spe_fx_fire_burst.png|500px]]
|-
 
| fsPHa
== Line of Fire ==
|
Generates a 1 meter line of fire effect. Does not have its own light or sound source, does not do damage. Its direction can be tweaked by rotating the object.
|
 
|-
[[File: land_spe_fx_line_of_fire.png|500px]]
| winMs
 
|
== Roof Fire ==
|
Creates fire effect which sticks to the highest point in the vicinity either is a roof or floor. Does not have its own light source, though it has a sound and it does not do damage.
|-
 
| dlcSim
[[File: land_spe_fx_roof_fire.png|500px]]
|
 
|
== Small Area Fire ==
|-
Creates a fire effect covering a small area on ground, it has no light source of its own and does not do damage.
| steamCbk
 
|
[[File: land_spe_fx_area_fire.png|500px]]
|
<!--
|-
== Small Area Fire TEST ==
| input
Creates the same effect as Small area fire from above, however its behavior was altered so the effect is active only if the player is in range of 55 meters in order to save performance when many effects are active at the same time.
|
This effect is subject of change, the activation distance can be tweaked based on performance and the mission editor should consider the visibility so the effect does not go on and off for no apparent reason.
|
-->
|-
== Small Flame ==
| wSimu
Creates a fire effect in a column. Does not have its own light source, it has a burning sound and does not do damage.
|
 
|
[[File: land_spe_fx_small_flame_01.png|500px]]
|-
 
| docSim
== Small East-West Flame ==
|
Creates a 1 meter line of fire on the east-west axis, it has a sound, the orientation of the effect/object is not tweakable as for the line of fire effect from above.
|
 
|-
[[File: land_spe_fx_east_west_flames.png|500px]]
| wSimDisp
 
|
== Small North-South Flame ==
|
Same effect as above only that is generated on north-south axis.
|-
 
| MFDManager
== Smog Big ==
|
Creates a plume of smoke above an area.
|
 
|-
[[File: land_spe_fx_smog_big.png|500px]]
| wDisp
 
|
== Smog Night ==
|
Creates a smoke effect which is visible during night time and simulates distant fires or smoking area. Does not have a light or sound source.
|-
 
| EventPrcs
[[File: land_spe_fx_smog_night.png|500px]]
|
 
|
== Smoke Medium ==
|-
Creates a smoke effect, when you want to make a fire more “smoky”, it has no sound or a light source of its own.
| gsEva
 
|
[[File: land_spe_fx_smoke_medium.png|500px]]
|
 
|-
== Wreck Fire ==
| gbFrm
Creates the wreck on fire effect, uses less particles than vanilla one, it has some randomization built in so the same effect may differ in appearance when used more times. It does damage to units and it has a light and sound source.
|
 
|
[[File: land_spe_fx_wreck_fire.png|500px]]
|-
 
| memLo
= Technical Description =
|
All visual special effects are executed on the client side of our game hosting system. Currently we don’t have SFX executed on the server. They are not synchronized across clients per se but they behave like they are (with some delays which should not impact gameplay). If it is needed we can have scripts executed on the server and synchronized.
|
 
|-
Visual appearance of the special effects in [[Eden Editor]] will be different most of the time from what you see in the mission. That is why you should inspect them while running the mission to see the final outcome. In [[Eden Editor]], for example, you might notice lights flickering when placing objects that have a light source. Also, some sounds might be muted, with the exception of the SFX objects which are sounds only.
| siScr
 
|
SFX objects are dependent on player distance to those objects, so make sure your character is close enough to see the SFX in action. The “activation” distance may differ in the future but for now, most object’s triggering distance is set to style="text-align:right;" | 500 m meters.
|
 
|-
There are a series of objects that will not be executed in [[Eden Editor]] because they are not dependent on distance to the player or position on the map, and this will save performance. Also these objects can be placed anywhere on the map. You only need to place one to get the desired effect. Any additional object of those types will be auto-deleted.
| scrVM
 
|
So far in this list of objects we have:
|
 
|-
*night_clouds
| wsSet
*fog_around_player
|
*artillery_sky_lights
|
*artillery_ground_lights
|-
*binaural_battle_sounds
| sLand
 
|
{{Feature|informative|
|
*All objects can be created using [[createVehicle]] command and deleted using [[deleteVehicle]].
|-
*All objects are available for [[Arma 3: Curator|Zeus]].}}
| simSW
 
|
Some effects depend visually on the direction of the object set in [[Eden Editor]], e.g. fire burst. Some effects are calibrated for usage during night time, usually the name of the object will provide a hint, e.g. Smog Night. Not all fire SFX have a light source or a burning sound. For saving performance you can use only one light source and/or one sound source in case you have a group of fire effects in a relatively small area.
|
(Sound source can be found in assets under SPE effects in [[Eden Editor]] as objects)
|-
 
| cLWObj
== Related Functions ==
|
The following functions handle the SFX objects.
|
{|
|-
| oTemp
|
|
|-
| FPres
|
|
|-
| waitSnd
|
|
|-
| job
|
|
|-
| sound
|
|
|-
| ssAdv
|
|
|-
| snCmt
|
|
|-
| play
|
|
|-
| ARTCpl
|
|
|-
| rendr
|
|
|-
| drwVi
|
|
|-
| txHLi
|
|
|-
| txPMM
|
|
|-
| dsr2t
|
|
|-
| wPrep
|
|
|-
| dPr
|
|
|-
| fmiRun
|
|
|-
| fmiWait
|
|
|-
| fmiMDrw
|
|
|-
| fmiSIns
|
|
|-
| wPrepFtr
|
|
|-
| clPrp
|
|
|-
| oPrep
|
|
|-
| sceAC
|
|
|-
| oSplt
|
|
|-
| sceACTA
|
|
|-
| sceACPrx
|
|
|-
| lodUL
|
|
|-
| PrxObj
|
|
|-
| manAn
|
|
|-
| ppdOT
|
|
|-
| flProx
|
|
|-
| PrxObjTransport
|
|
|-
| oSoSL
|
|
|-
| oSoJE
|
|
|-
| oSoJE1
|
|
|-
| oSoJE2
|
|
|-
| oSo1OFOv
|
|
|-
| oSo1ON
|
|
|-
| sceCLsHSH
|
|
|-
| prpAMCt
|
|
|-
| oSoJEw
|
|
|-
| pDrwFNP
|
|
|-
| oSoSLu
|
|
|-
| lPGCl
|
|
|-
| pdDrw
|
|
|-
| lDGnd
|
|
|-
| lGSMM
|
|
|-
| recCB
|
|
|-
| mtPmj
|
|
|-
| cuDrw
|
|
|-
| prepT
|
|
|-
| drwCB
|
|
|-
| oPasD
|
|
|-
| o1Drw
|
|
|-
| lckDnBf
|
|
|-
| prpTx
|
|
|-
| inst
|
|
|-
| stpSctnTL
|
|
|-
| o1ShV
|
|
|-
| scSVI
|
|
|-
| oPas3
|
|
|-
| sssmC
|
|
|-
| sbDrw
|
|
|-
| aniMt
|
|
|-
| ppSSSM
|
|
|-
| drwROM
|
|
|-
| drwIn
|
|
|-
| wDraw
|
|
|-
| lDPGT
|
|
|-
| oSDrw
|
|
|-
| oPasO
|
|
|-
| lDSky
|
|
|-
| swRdr
|
|
|-
| ppSWDD
|
|
|-
| swRdGeom
|
|
|-
| swRdGeomVB
|
|
|-
| swFillV
|
|
|-
| oPasA
|
|
|-
| ppShrpn
|
|
|-
| lDWat
|
|
|-
| oPas2
|
|
|-
| o2Drw
|
|
|-
| oPas5
|
|
|-
| o5Drw
|
|
|-
| EDraw3D
|
|
|-
| MEventPrcs
|
|
|-
| cLGSY
|
|
|-
| stpAll
|
|
|-
| stpCB
|
|
|-
| stpTxtCS
|
|
|-
| stpUAVsCS
|
|
|-
| ppHDRCL
|
|
|-
| ppGSB
|
|
|-
| ppDOF
|
|
|-
| ppGlwNw
|
|
|-
| ppGLu
|
|
|-
| stpCBUpd
|
|
|-
| ppQWt
|
|
|-
| ppCMAA
|
|
|-
| hudDr
|  
|
|-
| 3DEN_UI_OnDraw
|
|  
|-
| 3DEN_PrepareDraw
|
|
|-
| clObL
|
|
|-
| 3DEN_Drawing
|
|
|-
| stpTxtGS
|
|
|-
| txt2D
|
|
|-
| mapDr
|  
|
|-
| mapSeaAndNormal
|
|
|-
| mapPM
|  
|
|-
| lndPM
|
|
|-
| MapObjectsPrepTask
|
|
|-
| mapSeaAndNormalDraw
|  
|
|-
| mapCntDraw
|
|  
|-
| mapObjectsDraw
|
|
|-
| mapForestShape
|
|
|-
| mapGrid
|
|
|-
| drwFn
|
|
|-
| dtTot
|  
|
|-
| wFram
|
|
|-
| 3dSwp
|
|
|-
| preLd
|
|
|-
| preLV
|  
|
|-
| actObjPrld
|
|
|-
| hashChk
|
|  
|-
|-
| SPE_fnc_initObjectFX || {{hl|\WW2\SPE_Core_f\FX_ParticleEffects_f\FX_System\fn_initObjectFX.sqf}}
| sSim
|  
|  
|-
|-
| SPE_fnc_isObjectFXActiv || {{hl|\WW2\SPE_Core_f\FX_ParticleEffects_f\FX_System\fn_isObjectFXActiv.sqf}}
| enfWorkShort
|  
|  
|-
|-
| SPE_fnc_ObjectFXHandler || {{hl|\WW2\SPE_Core_f\FX_ParticleEffects_f\FX_System\fn_ObjectFXHandler.sqf}}
| updAttPos
|  
|  
|-
|-
| SPE_fnc_setObjectFX || {{hl|\WW2\SPE_Core_f\FX_ParticleEffects_f\FX_System\fn_setObjectFX.sqf}}
| oSo1AN
|}
|  
 
|  
= SFX Entities in [[Eden Editor]] =
{| class="wikitable sortable"
|-
|-
! Display Name !! Class Name !! Activation Distance !! Multiple allowed !! style="text-align:center" | Direction has Effect
| prpAMCf
|
|
|-
|-
| Small Column Flame || {{hl|Land_SPE_FX_small_flame_01}} || style="text-align:right;" | 200 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| prpAMCSlt
|  
|  
|-
|-
| Small East-West flame || {{hl|Land_SPE_FX_East_West_Flames}} || style="text-align:right;" | 200 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| prpSDM
|  
|  
|-
|-
| Small North-South flame || {{hl|Land_SPE_FX_North_South_Flames}} || style="text-align:right;" | 200 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| locL
|  
|  
|-
|-
| Small Area Fire || {{hl|Land_SPE_FX_Area_Fire}} || style="text-align:right;" | 200 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| mapSeaAndNormalWork
|  
|  
|-
|-
| Roof Fire || {{hl|Land_SPE_FX_Roof_Fire}} || style="text-align:right;" | 200 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| mapObjectsPrepWork
|  
|  
|-
|-
| Smoke Medium || {{hl|Land_SPE_FX_Smoke_Medium}} || style="text-align:right;" | 500 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| drwIdxPrm
|  
|  
|-
|-
| Fire Burst || {{hl|Land_SPE_FX_Fire_Burst}} || style="text-align:right;" | 200 m  || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Checked}}
| oSo3
|  
|  
|-
|-
| Smog Big || {{hl|Land_SPE_FX_Smog_Big}} || style="text-align:right;" | 2000 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| lsCVB
|  
|  
|-
|-
| Smog Night || {{hl|Land_SPE_FX_Smog_Night}} || style="text-align:right;" | 2000 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| oSo5
|  
|  
|-
|-
| Big Fire || {{hl|Land_SPE_FX_Big_Fire}} || style="text-align:right;" | 500 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| oSo2CL
|  
|  
|-
|-
| Small Flame || {{hl|Land_SPE_FX_small_flame_02}} || style="text-align:right;" | 200 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| oSo1AF
|  
|  
|-
|-
| Light 100 m Illumination || {{hl|Land_SPE_FX_light_100}} || style="text-align:right;" | 500 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| Visualize
|  
|  
|-
|-
| Light 300 m Illumination || {{hl|Land_SPE_FX_light_300}} || style="text-align:right;" | 500 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| visul
|  
|  
|-
|-
| Big Fire Burning Sound || {{hl|Land_SPE_FX_burning_sound_big}} || style="text-align:right;" | 200 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| txMLo
|  
|  
|-
|-
| Night Clouds linked to Player || {{hl|Land_SPE_FX_night_clouds}} || style="text-align:right;" | 20000 m || style="text-align:center;" | {{Icon|Unchecked}} || style="text-align:center;" | {{Icon|Unchecked}}
| oSo2Srt
|  
|  
|-
|-
| Artillery Sky Lights || {{hl|Land_SPE_FX_artillery_sky_lights}} || style="text-align:right;" | 20000 m || style="text-align:center;" | {{Icon|Unchecked}} || style="text-align:center;" | {{Icon|Unchecked}}
| oSoSdw
|  
|  
|-
|-
| Artillery Ground Lights || {{hl|Land_SPE_FX_artillery_ground_lights}} || style="text-align:right;" | 550 m || style="text-align:center;" | {{Icon|Unchecked}} || style="text-align:center;" | {{Icon|Unchecked}}
| prpAMCbsi
|  
|  
|-
|-
| Binaural Battle Sounds || {{hl|Land_SPE_FX_binaural_battle_sounds}}|| style="text-align:right;" | 20000 m || style="text-align:center;" | {{Icon|Unchecked}} || style="text-align:center;" | {{Icon|Unchecked}}
| prpAMCp
|  
|  
|-
|-
| Low Fog || {{hl|Land_SPE_FX_low_fog}} || style="text-align:right;" | 2000 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Checked}}
| Render
|  
|  
|-
|-
| Ground Fog linked to Player || {{hl|Land_SPE_FX_player_fog}} || style="text-align:right;" | 20000 m || style="text-align:center;" | {{Icon|Unchecked}} || style="text-align:center;" | {{Icon|Unchecked}}
| bgD3D
|  
|  
|-
|-
| Line of Fire || {{hl|Land_SPE_FX_line_of_fire}} || style="text-align:right;" | 1000 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Checked}}
| stpTxtVS
|  
|  
|-
|-
| Wreck Fire || {{hl|Land_SPE_FX_wreck_fire}} || style="text-align:right;" | 200 m || style="text-align:center;" | {{Icon|Checked}} || style="text-align:center;" | {{Icon|Unchecked}}
| ppHBAOPlus
|  
|  
|}
|}


= [[Eden Editor]] Attributes =
<sqf>
The following attribute can be used to turn off all effects without the need to remove carefully placed objects from the scenario.
private _ctrlTV = ctrlparent (_this select 0) displayCtrl 101;
 
private _export = "{| class=""wikitable sortable"""  + endl + "|-" + endl;
_export = _export + "! Technical Name !! Descriptive Name !! Description";
 
private _fnc_logChilden =
{
    params ["_path"];
 
    for "_i" from 0 to ((_ctrlTV tvCount _path) - 1) do
    {
        private _text = _ctrlTV tvText (_path + [_i]);
        _text = _text splitString " " select 0;
 
        if !(_text in _export) then
        {
            _export = _export + endl + "|-" + endl + "| " + _text + endl + "| " + endl + "| ";
        };
 
        if (_ctrlTV tvCount (_path + [_i]) > 0 ) then
        {
            [_path + [_i]] call _fnc_logChilden;
        };
    };
};
 
[[]] call _fnc_logChilden;
 
copyToClipboard (_export + endl + "|}" + endl);
</sqf>


[[Eden Editor]] >> {{hl|Attributes}} >> {{hl|General...}} >> {{hl|[SPE] Effects}} >> {{hl|Enable Objects Effects}}
== See Also ==


In order to only turn off a specific effect use the attribute found in the object specific attributes.
* [[Code Optimisation]]
* [[Mission Optimisation]]




[[Category: Spearhead 1944]]
[[Category:Arma Scripting Tutorials]]

Latest revision as of 18:23, 4 November 2024

If you have ever wondered why you scenario is running so badly, performance profiling is the way to find it out. It allows you to find bottlenecks and slow code by capturing a "slow" frame. The captured data can then be viewed and analysed.

Getting the correct Version

Profiling is enabled in the following Arma 3 versions

  • arma3profiling_x64.exe - Part of the Performance Profiling Build
  • arma3diag_x64.exe - Part of the Development Build

Read Arma_3: Steam Branches for a guide on how to access these branches.

ⓘ
It is recommended to use the Performance Profiling Build (arma3profiling_x64.exe) for performance profiling because:
  • Has tools that might not make it into development build
  • Has all the profiling related commands that arma3diag_x64.exe has
  • Its performance is closer to the default arma3_x64.exe

Frame Capturing

There are several commands that allow you to capture a frame.

In most cases you do not want to capture any or all frames, you just want to capture "slow" frames. A slow frame is a frame that takes longer than the average frame and slows down the game.

How to Use

  1. Run a mission
  2. Execute a scripted command diag_captureSlowFrame ["total", 0.3]; using any means (Debug Console, mission radio trigger...)
  3. Once a slow frame is detected, a window will open
  4. In the window you will be able to browse a lot of performance-related data, which can be interesting
  5. To export the gathered information for sharing with others:
    1. Select Main Thread (if not selected yet)
    2. Press the Copy button
    3. Open an external text editor
    4. Paste the text into a new file
    5. Save the file

Capture Frame UI

arma3-capture frame ui overview.png

  1. 🚧
    TODO: this must be updated.
  2. 🚧
    TODO: this must be updated.
  3. 🚧
    TODO: this must be updated.
  4. 🚧
    TODO: this must be updated.
  5. 🚧
    TODO: this must be updated.
  6. 🚧
    TODO: this must be updated.
  7. 🚧
    TODO: this must be updated.
  8. 🚧
    TODO: this must be updated.
  9. 🚧
    TODO: this must be updated.

External Viewer

diag_captureFrame sample output with custom subtree

Creating Your Own Subtree

When Profiling Per-Frame Eventhandlers (PFH), diag_captureFrame only shows one blob called siFEH that contains all PFH's so you can't see what part of that is caused by your PFH.
You can create your own subtree inside siFEH by wrapping your function call inside a isNil CODE statement like this:
Turn your old call which may look like this:

addMissionEventHandler ["EachFrame", { call myPFHFunction }];

Into something like this:

addMissionEventHandler ["EachFrame", { isNil { call myPFHFunction } // isNil creates the subtree }];

Now when you run diag_captureFrame inside of siPFH you will have a subtree called gsEva and behind that you can see the first line of code inside the isNil statement.
It will only show a part of the first line of that code so you should put something descriptive into the isNil statement.
You can use the same to create a subtree for any function you like. This will also work inside Scheduled (spawned) scripts.
But using this method to "subtree" a function with return values requires a little bit of trickery to get the return value out.


Notes

  • 0.3 is a time in second used to determine what duration of a frame you consider abnormal, and first such frame will be captured.
  • 0.3 is definitely something you should not see in a normal game.
  • If you do not capture any frames with 0.3, try lowering it to 0.2 or 0.1.
  • If it triggers too early, before the main slowdown happens, increase it to a higher value, e.g. 1.0.

Scopes

Technical Name Descriptive Name Description
Main
total
fsPHa
winMs
dlcSim
steamCbk
input
wSimu
docSim
wSimDisp
MFDManager
wDisp
EventPrcs
gsEva
gbFrm
memLo
siScr
scrVM
wsSet
sLand
simSW
cLWObj
oTemp
FPres
waitSnd
job
sound
ssAdv
snCmt
play
ARTCpl
rendr
drwVi
txHLi
txPMM
dsr2t
wPrep
dPr
fmiRun
fmiWait
fmiMDrw
fmiSIns
wPrepFtr
clPrp
oPrep
sceAC
oSplt
sceACTA
sceACPrx
lodUL
PrxObj
manAn
ppdOT
flProx
PrxObjTransport
oSoSL
oSoJE
oSoJE1
oSoJE2
oSo1OFOv
oSo1ON
sceCLsHSH
prpAMCt
oSoJEw
pDrwFNP
oSoSLu
lPGCl
pdDrw
lDGnd
lGSMM
recCB
mtPmj
cuDrw
prepT
drwCB
oPasD
o1Drw
lckDnBf
prpTx
inst
stpSctnTL
o1ShV
scSVI
oPas3
sssmC
sbDrw
aniMt
ppSSSM
drwROM
drwIn
wDraw
lDPGT
oSDrw
oPasO
lDSky
swRdr
ppSWDD
swRdGeom
swRdGeomVB
swFillV
oPasA
ppShrpn
lDWat
oPas2
o2Drw
oPas5
o5Drw
EDraw3D
MEventPrcs
cLGSY
stpAll
stpCB
stpTxtCS
stpUAVsCS
ppHDRCL
ppGSB
ppDOF
ppGlwNw
ppGLu
stpCBUpd
ppQWt
ppCMAA
hudDr
3DEN_UI_OnDraw
3DEN_PrepareDraw
clObL
3DEN_Drawing
stpTxtGS
txt2D
mapDr
mapSeaAndNormal
mapPM
lndPM
MapObjectsPrepTask
mapSeaAndNormalDraw
mapCntDraw
mapObjectsDraw
mapForestShape
mapGrid
drwFn
dtTot
wFram
3dSwp
preLd
preLV
actObjPrld
hashChk
sSim
enfWorkShort
updAttPos
oSo1AN
prpAMCf
prpAMCSlt
prpSDM
locL
mapSeaAndNormalWork
mapObjectsPrepWork
drwIdxPrm
oSo3
lsCVB
oSo5
oSo2CL
oSo1AF
Visualize
visul
txMLo
oSo2Srt
oSoSdw
prpAMCbsi
prpAMCp
Render
bgD3D
stpTxtVS
ppHBAOPlus

private _ctrlTV = ctrlparent (_this select 0) displayCtrl 101; private _export = "{| class=""wikitable sortable""" + endl + "|-" + endl; _export = _export + "! Technical Name !! Descriptive Name !! Description"; private _fnc_logChilden = { params ["_path"]; for "_i" from 0 to ((_ctrlTV tvCount _path) - 1) do { private _text = _ctrlTV tvText (_path + [_i]); _text = _text splitString " " select 0; if !(_text in _export) then { _export = _export + endl + "|-" + endl + "| " + _text + endl + "| " + endl + "| "; }; if (_ctrlTV tvCount (_path + [_i]) > 0 ) then { [_path + [_i]] call _fnc_logChilden; }; }; }; [[]] call _fnc_logChilden; copyToClipboard (_export + endl + "|}" + endl);

See Also

Retrieved from "https://community.bistudio.com/wiki?title=User:R3vo/Sandbox&oldid=370181"