Unreal Engine 4.27 Documentation

Unreal Engine 4.26 Documentation

Unreal Engine 4.27 Documentation

Unreal Engine 5.0 Documentation

Unreal Engine 5.1 Documentation

Unreal Engine 5.2 Documentation

Unreal Engine 5.3 Documentation

> Unreal Engine API Reference > Runtime > Engine > GameFramework > UGameUserSettings

Light Theme

Dark Theme

UGameUserSettings

Stores user settings for a game (for example graphics and sound settings), with the ability to save and load to and from a file.

Abgeändertes Beispiel für die Fachhochschule Wedel.

Inheritance Hierarchy

UObjectBase

UObjectBaseUtility

UObject

UGameUserSettings

References

Module	Engine
Header	/Engine/Source/Runtime/Engine/Classes/GameFramework/GameUserSettings.h
Implementation	/Engine/Source/Runtime/Engine/Classes/GameFramework/GameUserSettings.cpp
Include	#include "GameFramework/GameUserSettings.h"

Syntax

class UGameUserSettings : public UObject

Remarks

Stores user settings for a game (for example graphics and sound settings), with the ability to save and load to and from a file.

Constructors

	Name	Description
	UGameUserSettings ( const FObjectInitializer& ObjectIn... )

Functions

	Name	Description
void	ApplyHardwareBenchmarkResults()
void	ApplyNonResolutionSettings()
void	ApplyResolutionSettings ( bool bCheckForCommandLineOverrides )
void	ApplySettings ( bool bCheckForCommandLineOverrides )
void	ConfirmVideoMode()	Mark current video mode settings (fullscreenmode/resolution) as being confirmed by the user
void	EnableHDRDisplayOutput ( bool bEnable, int32 DisplayNits )
float	FindResolutionQualityForScreenSize ( float Width, float Height )
int32	GetAntiAliasingQuality()
int32	GetAudioQualityLevel()
FString	GetConfigDir()
int32	GetCurrentHDRDisplayNits()	Returns 0 if HDR isn't supported or is turned off
FIntPoint	GetDefaultResolution()	Returns the default resolution when no resolution is set
float	GetDefaultResolutionScale()	Gets the desired resolution quality based on DesiredScreenWidth/Height and the current screen resolution
EWindowMode:...	GetDefaultWindowMode()	Returns the default window mode when no mode is set
FIntPoint	GetDefaultWindowPosition()	Returns the default window position when no position is set
FIntPoint	GetDesktopResolution()	Returns user's desktop resolution, in pixels.
float	GetEffectiveFrameRateLimit()	Returns the effective frame rate limit (by default it returns the FrameRateLimit member)
int32	GetFoliageQuality()	Returns the foliage quality (0..4, higher is better)
int32	GetFramePace()	Gets the current frame pacing frame rate in fps, or 0 if none
float	GetFrameRateLimit()	Gets the user's frame rate limit (0 indiciates the frame rate limit is disabled)
EWindowMode:...	GetFullscreenMode()	Returns the user setting for game window fullscreen mode.
UGameUserSet...	GetGameUserSettings()	Returns the game local machine settings (resolution, windowing mode, scalability settings, etc...)
EWindowMode:...	GetLastConfirmedFullscreenMode()	Returns the last confirmed user setting for game window fullscreen mode.
FIntPoint	GetLastConfirmedScreenResolution()	Returns the last confirmed user setting for game screen resolution, in pixels.
float	GetLastCPUBenchmarkResult()	Returns the last CPU benchmark result (set by RunHardwareBenchmark)
TArray< floa...	GetLastCPUBenchmarkSteps()	Returns each individual step of the last CPU benchmark result (set by RunHardwareBenchmark)
float	GetLastGPUBenchmarkResult()	Returns the last GPU benchmark result (set by RunHardwareBenchmark)
TArray< floa...	GetLastGPUBenchmarkSteps()	Returns each individual step of the last GPU benchmark result (set by RunHardwareBenchmark)
int32	GetOverallScalabilityLevel()	Returns the overall scalability level (can return -1 if the settings are custom)
int32	GetPostProcessingQuality()	Returns the post-processing quality (0..4, higher is better)
EWindowMode:...	GetPreferredFullscreenMode()	Returns the user setting for game window fullscreen mode.
float	GetRecommendedResolutionScale()	Gets the recommended resolution quality based on LastRecommendedScreenWidth/Height and the current screen resolution
void	GetResolutionScaleInformationEx ( float& CurrentScaleNormalized, float& CurrentScaleValue, float& MinScaleValue, float& MaxScaleValue )	Returns the current resolution scale and the range.
float	GetResolutionScaleNormalized()	Gets the current resolution scale as a normalized 0..1 value between MinScaleValue and MaxScaleValue.
FIntPoint	GetScreenResolution()	Returns the user setting for game screen resolution, in pixels.
int32	GetShadingQuality()	Returns the shading quality (0..4, higher is better)
int32	GetShadowQuality()	Returns the shadow quality (0..4, higher is better)
int32	GetTextureQuality()	Returns the texture quality (0..4, higher is better)
int32	GetViewDistanceQuality()	Returns the view distance quality (0..4, higher is better)
int32	GetVisualEffectQuality()	Returns the visual effects quality (0..4, higher is better)
FIntPoint	GetWindowPosition()
bool	IsDirty()	Checks if any user settings is different from current
bool	IsDynamicResolutionDirty()	Checks if the dynamic resolution user setting is different from current system setting
bool	IsDynamicResolutionEnabled()	Returns the user setting for dynamic resolution.
bool	IsFullscreenModeDirty()	Checks if the FullscreenMode user setting is different from current
bool	IsHDREnabled()
bool	IsScreenResolutionDirty()	Checks if the Screen Resolution user setting is different from current
bool	IsVersionValid()	Check if the current version of the game user settings is valid.
bool	IsVSyncDirty()	Checks if the vsync user setting is different from current system setting
bool	IsVSyncEnabled()	Returns the user setting for vsync.
void	LoadConfigIni ( bool bForceReload )	Loads the user .ini settings into GConfig
void	LoadSettings ( bool bForceReload )	Loads the user settings from persistent storage
void	PreloadResolutionSettings ( bool bAllowCmdLineOverrides )	Loads the resolution settings before is object is available
void	RequestResolutionChange ( int32 InResolutionX, int32 InResolutionY, EWindowMode::Type InWindowMode, bool bInDoOverrides )	Request a change to the specified resolution and window mode. Optionally apply cmd line overrides.
void	RequestUIUpdate()
void	ResetToCurrentSettings()	This function resets all settings to the current system settings
void	RevertVideoMode()	Revert video mode (fullscreenmode/resolution) back to the last user confirmed values
void	RunHardwareBenchmark ( int32 WorkScale, float CPUMultiplier, float GPUMultiplier )	Runs the hardware benchmark and populates ScalabilityQuality as well as the last benchmark results config members, but does not apply the settings it determines.
void	SaveSettings()	Save the user settings to persistent storage (automatically happens as part of ApplySettings)
void	SetAntiAliasingQuality ( int32 Value )	Sets the anti-aliasing quality (0..4, higher is better)
void	SetAudioQualityLevel ( int32 QualityLevel )	Sets the user's audio quality level setting
void	SetBenchmarkFallbackValues()	Set scalability settings to sensible fallback values, for use when the benchmark fails or potentially causes a crash
void	SetDynamicResolutionEnabled ( bool bEnable )	Sets the user setting for dynamic resolution.
void	SetFoliageQuality ( int32 Value )	Sets the foliage quality (0..4, higher is better)
void	SetFrameRateLimit ( float NewLimit )	Sets the user's frame rate limit (0 will disable frame rate limiting)
void	SetFrameRateLimitCVar ( float InLimit )	Sets the frame rate limit CVar to the passed in value, 0.0 indicates no limit
void	SetFullscreenMode ( EWindowMode::Type InFullscreenMode )	Sets the user setting for the game window fullscreen mode.
void	SetOverallScalabilityLevel ( int32 Value )	Changes all scalability settings at once based on a single overall quality level
void	SetPostProcessingQuality ( int32 Value )	Sets the post-processing quality (0..4, higher is better)
void	SetResolutionScaleNormalized ( float NewScaleNormalized )	Sets the current resolution scale as a normalized 0..1 value between MinScaleValue and MaxScaleValue.
void	SetResolutionScaleValueEx ( float NewScaleValue )	Sets the current resolution scale.
void	SetScreenResolution ( FIntPoint Resolution )	Sets the user setting for game screen resolution, in pixels.
void	SetShadingQuality ( int32 Value )	Sets the shading quality (0..4, higher is better)
void	SetShadowQuality ( int32 Value )	Sets the shadow quality (0..4, higher is better)
void	SetSyncTypeCVar ( int32 InInterval )	Sets the input latency mode 0 and 2
void	SetTextureQuality ( int32 Value )	Sets the texture quality (0..4, higher is better)
void	SetToDefaults()
void	SetViewDistanceQuality ( int32 Value )	Sets the view distance quality (0..4, higher is better)
void	SetVisualEffectQuality ( int32 Value )	Sets the visual effects quality (0..4, higher is better)
void	SetVSyncEnabled ( bool bEnable )	Sets the user setting for vsync.
void	SetWindowPosition ( int32 WindowPosX, int32 WindowPosY )
bool	SupportsHDRDisplayOutput()	Whether the curently running system supports HDR display output
void	UpdateResolutionQuality()
void	UpdateVersion()	Update the version of the game user settings to the current version
void	ValidateSettings()	Validates and resets bad user settings to default. Deletes stale user settings file if necessary.

Deprecated Functions

	Name	Description
void	GetResolutionScaleInformation ( float& CurrentScaleNormalized, int32& CurrentScaleValue, int32& MinScaleValue, int32& MaxScaleValue )	Please call GetResolutionScaleInformationEx
int32	GetSyncInterval()	Please use GetFramePace to get the paced frame rate
void	SetResolutionScaleValue ( int32 NewScaleValue )	Please call SetResolutionScaleValueEx
void	SetSyncIntervalCVar ( int32 InInterval )	Please use FPlatformRHIFramePacer::SetFramePace to set the desired frame rate

UGameUserSettings

Stores user settings for a game (for example graphics and sound settings), with the ability to save and load to and from a file.

Abgeändertes Beispiel für die Fachhochschule Wedel.

Your Privacy

Your Privacy

Strictly Necessary Cookies

Strictly Necessary Cookies

Performance Cookies

Performance Cookies

Functional Cookies

Functional Cookies

Targeting Cookies

Targeting Cookies

33Across

33Across

33Across

33Across

UGameUserSettings

Stores user settings for a game (for example graphics and sound settings), with the ability to save and load to and from a file. Abgeändertes Beispiel für die Fachhochschule Wedel.

Stores user settings for a game (for example graphics and sound settings), with the ability to save and load to and from a file.

Abgeändertes Beispiel für die Fachhochschule Wedel.