NVIDIA Ansel Console Variable Reference

Reference of the configuration variables available for the NVIDIA Ansel Photography Plugin

Choose your operating system:

Windows

macOS

Linux

The following console variables are available for configuring the behavior of the NVIDIA Ansel Photography Plugin and can be set manually from the console, through your .ini files, or dynamically by a Blueprint. Most of them should be configured during development instead of at runtime, though r.Photography.Allow is useful to set dynamically.

[REGION:note]
These values may be set by Blueprint actions instead of directly setting the console variables; see the **NVIDIA Ansel Blueprint Node Reference**
[/REGION]


Variable	Default	Description
`r.Photography.Available`	1	(Read-only) If 1, the photography system is potentially available to the user. Otherwise, a functioning back-end is not available. This is set to 1 when the plugin is enabled.
`r.Photography.Allow`	1	If 1, allows a photography session to potentially be started by the player. Set this dynamically to permit or forbid photography per-level, per-cutscene, etc.
`r.Photography.AllowHighQuality`	1	If 1, Ansel is permitted to temporarily raise quality levels during photography (if also requested by the player from the Ansel UI via the 'High Quality' setting).
`r.Photography.EnableMultipart`	1	If 1, allow the photography system to take high-resolution shots that need to be rendered in tiles which are later stitched together.
`r.Photography.SettleFrames`	10	The number of frames to let the rendering 'settle' before taking a photo. Useful to allow temporal AA/smoothing to work well; if not using any temporal effects, can be lowered for faster capture.
`r.Photography.TranslationSpeed`	100.0	Normal speed (in Unreal units per second) at which to move the roaming photography camera.
`r.Photography.Constrain.CameraSize`	14.0	Radius (in Unreal Units) of sphere around the camera; used to prevent the camera clipping into nearby geometry when constraining camera with collision. <0 disables camera collision.
`r.Photography.Constrain.CameraDistance`	2500.0	Maximum distance (in Unreal Units) which camera is allowed to wander from its initial position when constraining camera by distance. <0 disables distance constraint.
`r.Photography.AutoPostprocess`	1	If 1, the photography system will attempt to automatically disable HUD, subtitles, and some standard postprocessing effects during photography sessions/captures which are known to give poor photography results. Set to 0 to manage all postprocessing tweaks manually from the PlayerCameraManager Blueprint callbacks. Blueprint callbacks will be called regardless of AutoPostprocess value.
`r.Photography.AutoPause`	1	If 1, the photography system will attempt to ensure that the level is paused while in photography mode. Set to 0 to manage pausing and unpausing manually from the PlayerCameraManager Blueprint callbacks. Blueprint callbacks will be called regardless of AutoPause value.