Version: 2021.2
LanguageEnglish
  • C#

QualitySettings

class in UnityEngine

/

Inherits from:Object

/

Implemented in:UnityEngine.CoreModule

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Manual

Description

Script interface for Quality Settings.

There can be an arbitrary number of quality settings. The details of each are set up in the project's Quality Settings. At run time, the current quality level can be changed using this class.

Static Properties

activeColorSpaceActive color space (Read Only).
anisotropicFilteringGlobal anisotropic filtering mode.
antiAliasingChoose the level of Multi-Sample Anti-aliasing (MSAA) that the GPU performs.
asyncUploadBufferSizeAsynchronous texture and mesh data upload provides timesliced async texture and mesh data upload on the render thread with tight control over memory and timeslicing. There are no allocations except for the ones which driver has to do. To read data and upload texture and mesh data, Unity re-uses a ringbuffer whose size can be controlled.Use asyncUploadBufferSize to set the buffer size for asynchronous texture and mesh data uploads. The size is in megabytes. The minimum value is 2 and the maximum value is 512. The buffer resizes automatically to fit the largest texture currently loading. To avoid re-sizing of the buffer, which can incur performance cost, set the value approximately to the size of biggest texture used in the Scene.
asyncUploadPersistentBufferThis flag controls if the async upload pipeline's ring buffer remains allocated when there are no active loading operations. Set this to true, to make the ring buffer allocation persist after all upload operations have completed. If you have issues with excessive memory usage, you can set this to false. This means you reduce the runtime memory footprint, but memory fragmentation can occur. The default value is true.
asyncUploadTimeSliceAsync texture upload provides timesliced async texture upload on the render thread with tight control over memory and timeslicing. There are no allocations except for the ones which driver has to do. To read data and upload texture data a ringbuffer whose size can be controlled is re-used.Use asyncUploadTimeSlice to set the time-slice in milliseconds for asynchronous texture uploads per frame. Minimum value is 1 and maximum is 33.
billboardsFaceCameraPositionIf enabled, billboards will face towards camera position rather than camera orientation.
desiredColorSpaceDesired color space (Read Only).
lodBiasGlobal multiplier for the LOD's switching distance.
masterTextureLimitA texture size limit applied to most textures.
maximumLODLevelA maximum LOD level. All LOD groups.
maxQueuedFramesMaximum number of frames queued up by graphics driver.
namesThe indexed list of available Quality Settings.
particleRaycastBudgetBudget for how many ray casts can be performed per frame for approximate collision testing.
pixelLightCountThe maximum number of pixel lights that should affect any object.
realtimeReflectionProbesEnables real-time reflection probes.
renderPipelineThe RenderPipelineAsset that defines the override render pipeline for the current quality level.
resolutionScalingFixedDPIFactorIn resolution scaling mode, this factor is used to multiply with the target Fixed DPI specified to get the actual Fixed DPI to use for this quality setting.
shadowCascade2SplitThe normalized cascade distribution for a 2 cascade setup. The value defines the position of the cascade with respect to Zero.
shadowCascade4SplitThe normalized cascade start position for a 4 cascade setup. Each member of the vector defines the normalized position of the coresponding cascade with respect to Zero.
shadowCascadesNumber of cascades to use for directional light shadows.
shadowDistanceShadow drawing distance.
shadowmaskModeThe rendering mode of Shadowmask.
shadowNearPlaneOffsetOffset shadow frustum near plane.
shadowProjectionDirectional light shadow projection.
shadowResolutionThe default resolution of the shadow maps.
shadowsReal-time Shadows type to be used.
skinWeightsThe maximum number of bones per vertex that are taken into account during skinning, for all meshes in the project.
softParticlesShould soft blending be used for particles?
softVegetationUse a two-pass shader for the vegetation in the terrain engine.
streamingMipmapsActiveEnable automatic streaming of texture mipmap levels based on their distance from all active cameras.
streamingMipmapsAddAllCamerasProcess all enabled Cameras for texture streaming (rather than just those with StreamingController components).
streamingMipmapsMaxFileIORequestsThe maximum number of active texture file IO requests from the texture streaming system.
streamingMipmapsMaxLevelReductionThe maximum number of mipmap levels to discard for each texture.
streamingMipmapsMemoryBudgetThe total amount of memory to be used by streaming and non-streaming textures.
streamingMipmapsRenderersPerFrameThe number of renderer instances that are processed each frame when calculating which texture mipmap levels should be streamed.
vSyncCountThe number of vertical syncs that should pass between each frame.

Static Methods

DecreaseLevelDecrease the current quality level.
GetQualityLevelReturns the current graphics quality level.
GetQualitySettingsProvides a reference to the QualitySettings object.
GetRenderPipelineAssetAtProvides a reference to the RenderPipelineAsset that defines the override render pipeline for a given quality level.
IncreaseLevelIncrease the current quality level.
SetLODSettingsSets the lodBias and maximumLODLevel at the same time.
SetQualityLevelSets a new graphics quality level.

Inherited Members

Properties

hideFlagsShould the object be hidden, saved with the Scene or modifiable by the user?
nameThe name of the object.

Public Methods

GetInstanceIDGets the instance ID of the object.
ToStringReturns the name of the object.

Static Methods

DestroyRemoves a GameObject, component or asset.
DestroyImmediateDestroys the object obj immediately. You are strongly recommended to use Destroy instead.
DontDestroyOnLoadDo not destroy the target Object when loading a new Scene.
FindObjectOfTypeReturns the first active loaded object of Type type.
FindObjectsOfTypeGets a list of all loaded objects of Type type.
InstantiateClones the object original and returns the clone.

Operators

boolDoes the object exist?
operator !=Compares if two objects refer to a different object.
operator ==Compares two object references to see if they refer to the same object.