Version: 2023.1
LanguageEnglish
  • C#

QualitySettings.globalTextureMipmapLimit

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
public static int globalTextureMipmapLimit;

Description

Indicates how many of the highest-resolution mips of each texture Unity does not upload at the given quality level. To set more specific mipmap limits, you can flag textures to ignore mipmap limits or assign them to mipmap limit groups.

Set this value to 1 to use the second mip of each texture, so all textures are half size. Set this value to 2 to use the third mip of each texture, so all textures are quarter size. This trend remains consistent as values increase. The default value is zero.

You can use this limit to decrease video memory requirements for running your content on low-end devices.

At run time, if you set globalTextureMipmapLimit to a mipmap value that has been stripped, Unity sets the value to the closest mipmap value that has not been stripped. For additional information regarding mipmap stripping, see PlayerSettings.mipStripping.

The Global Texture Mipmap Limit only works on 2D textures. It cannot adjust other texture types such as cubemaps or array textures. This setting has no effect on non-mipmapped textures. Also, note that the Virtual Texturing system does not consider mipmap limits either. For textures with mixed usage (see Texture2D.vtOnly), mipmap limits, streaming and stripping are only active for those instances that aren't rendered using Virtual Texturing. Similar to how the GPU load for regular textures can be managed by setting mipmap limits (or using Texture Streaming), the GPU load for the VT system can be managed by updating the GPU cache sizes (see GPUCacheSetting).

The global texture mipmap limit does not affect the following types of 2D textures: * Built-in editor resources such as UI icons and elements * Textures created at run time which are not readable, for example, after calling Apply with makeNoLongerReadable set to true * Non persistent textures, when EditorUtility.IsPersistent returns false * Rendertargets * Terrain masks

Queries for the width and height of the texture object return the original, non-limited sizes. You may have to take this into account if you perform special sampling or processing with textures subject to the global limit and you use globalTextureMipmapLimit > 1.

When the globalTextureMipmapLimit changes, Unity synchronously re-uploads all loaded textures affected by the global texture mipmap limit.

At the same time, Unity requests an asynchronous re-upload for textures that are using the Texture Streaming system and affected by the global texture mipmap limit.

Be aware: the system may take a few frames to apply a new globalTextureMipmapLimit value to textures that already had an upload request running before the change.

using UnityEngine;

public class Example : MonoBehaviour { void Start() { // Use half-size textures. QualitySettings.globalTextureMipmapLimit = 1; } }
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961