r.CustomUnsafeZones

r.CustomUnsafeZones

#Overview

name: r.CustomUnsafeZones

The value of this variable can be defined or overridden in .ini config files. 7 .ini config files referencing this setting variable.

This variable is created as a Console Variable (cvar).

• type: Var
• help: Allows you to set custom unsafe zones. Define them based on Portrait (P) or Landscape (L) for a device oriented \'upright\'.Unsafe zones may be either fixed or free, depending on if they move along with the rotation of the device.Format is (P:fixed[x1, y1][width, height]), semicolon-separated for each custom unsafe zone. +Values add from 0, -Values subtract from Height or Width

It is referenced in 2 C++ source files.

#Summary

#Setting Variables

#References In INI files

Location: <Workspace>/Engine/Config/BaseDeviceProfiles.ini:391, section: [iPhoneX DeviceProfile]

• INI Section: iPhoneX DeviceProfile
• Raw value: "(L:free[0,-15][812,15]);(P:fixed[83,0][206,30])"
• Is Array: False

Location: <Workspace>/Engine/Config/BaseDeviceProfiles.ini:397, section: [iPhoneXS DeviceProfile]

• INI Section: iPhoneXS DeviceProfile
• Raw value: "(L:free[0,-15][812,15]);(P:fixed[83,0][206,30])"
• Is Array: False

Location: <Workspace>/Engine/Config/BaseDeviceProfiles.ini:403, section: [iPhoneXSMax DeviceProfile]

• INI Section: iPhoneXSMax DeviceProfile
• Raw value: "(L:free[0,-15][896,15]);(P:fixed[104,0][206,30])"
• Is Array: False

Location: <Workspace>/Engine/Config/BaseDeviceProfiles.ini:409, section: [iPhoneXR DeviceProfile]

• INI Section: iPhoneXR DeviceProfile
• Raw value: "(L:free[0,-15][896,15]);(P:fixed[104,0][206,30])"
• Is Array: False

Location: <Workspace>/Engine/Config/BaseDeviceProfiles.ini:415, section: [iPhone11 DeviceProfile]

• INI Section: iPhone11 DeviceProfile
• Raw value: "(L:free[0,-15][812,15]);(P:fixed[83,0][206,30])"
• Is Array: False

Location: <Workspace>/Engine/Config/BaseDeviceProfiles.ini:421, section: [iPhone11Pro DeviceProfile]

• INI Section: iPhone11Pro DeviceProfile
• Raw value: "(L:free[0,-15][812,15]);(P:fixed[83,0][206,30])"
• Is Array: False

Location: <Workspace>/Engine/Config/BaseDeviceProfiles.ini:427, section: [iPhone11ProMax DeviceProfile]

• INI Section: iPhone11ProMax DeviceProfile
• Raw value: "(L:free[0,-15][812,15]);(P:fixed[83,0][206,30])"
• Is Array: False

#References in C++ code

#Callsites

This variable is referenced in the following C++ source code:

#Loc: <Workspace>/Engine/Source/Runtime/Core/Private/HAL/ConsoleManager.cpp:4202

Scope: file

Source code excerpt:

static TAutoConsoleVariable<FString> CVarCustomUnsafeZones(
	TEXT("r.CustomUnsafeZones"),
	TEXT(""),
	TEXT("Allows you to set custom unsafe zones. Define them based on Portrait (P) or Landscape (L) for a device oriented 'upright'."
		 "Unsafe zones may be either fixed or free, depending on if they move along with the rotation of the device."
		 "Format is (P:fixed[x1, y1][width, height]), semicolon-separated for each custom unsafe zone. +Values add from 0, -Values subtract from Height or Width"),
	ECVF_Default);

#Loc: <Workspace>/Engine/Source/Editor/UnrealEd/Private/Settings/SettingsClasses.cpp:677

Scope (from outer to inner):

file
function     FMargin ULevelEditorPlaySettings::CalculateCustomUnsafeZones

Source code excerpt:

	{
		FString CVarUnsafeZonesString;
		if (DeviceProfile->GetConsolidatedCVarValue(TEXT("r.CustomUnsafeZones"), CVarUnsafeZonesString))
		{
			TArray<FString> UnsafeZones;
			CVarUnsafeZonesString.ParseIntoArray(UnsafeZones, TEXT(";"), true);
			for (FString UnsafeZone : UnsafeZones)
			{
				FString Orientation;