UDN
Search public documentation:

PerfDebug_FreezeAt
日本語訳
中国翻译
한국어

Interested in the Unreal Engine?
Visit the Unreal Technology site.

Looking for jobs and company info?
Check out the Epic games site.

Questions about support via UDN?
Contact the UDN Staff

UE3 Home > Technical & Programming Home > Performance and Memory > The FreezeAt console command

The FreezeAt console command

Document Summary: The FreezeAt console command and the FreezeAtConsole variable allow to lock the view to a given position. This is handy for more accurate render profiling.

The FreezeAt console command

In order to use the FreezeAt command you need a position and an orientation (6 numbers). This data can be generated by the BugIt console command (written to a file, along with the screenshot) or by using the FreezeAt command:

  FreezeAt here
  

The command will output the position to the console/log, freezes at the given position and copies a string to the clipboard. This string can be used to freeze the view at level startup. Fore more details on this look at the FreezeAtPosition console variable.

The command also modifies the state of some things (that might change):

  • "RenderTimeFrozen" console variable
  • Console command "Pause"

The console command help provides detailed info (use the ? parameter):

  This console command allows to lock the camera in order to provide more deterministic render profiling.
  The view position and rotation is stored in the console variable "FreezeAtPosition"
  "FreezeAt" without parameters toggle between frozen and not frozen.
  "FreezeAt here" returns the current position to allow to come back to this position.
  "FreezeAt x y z wx wy wz" directly freezes at the given position.
  See also "RenderTimeFrozen" CONSOLE variable help (this console variable is modified)
  Examples:
   FreezeAt
   FreezeAt here
   FreezeAt 2819.5520 416.2633 75.1500 65378 -25879 0
  

The FreezeAtPosition console variable

The FreezeAtPosition console variable stores the position that the FreezeAt command is using. Console variables can be loaded through the ConsoleVariables.ini file (in Engine/Config). Simply by adding a line like the following:

  FreezeAtPosition = 2819.5520 416.2633 75.1500 65378 -25879 0
  

If on engine startup the variable has a valid position the FreezeAt command is activated automatically.

The console variable help provides detailed info (use the ? parameter):

  This console variable stores the position and rotation for the FreezeAt command which allows
  to lock the camera in order to provide more deterministic render profiling.
  The FreezeAtPosition can be set in the ConsoleVariables.ini.
  The number syntax if the same as the one used by the BugIt command:
   The first three values define the position, the next three define the rotation.
  Example:
   FreezeAtPosition 2819.5520 416.2633 75.1500 65378 -25879 0