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; } }
See Also: TextureMipmapLimitGroups.
Did you find this page useful? Please give it a rating:
Thanks for rating this page!
What kind of problem would you like to report?
Thanks for letting us know! This page has been marked for review based on your feedback.
If you have time, you can provide more information to help us fix the problem faster.
Provide more information
You've told us this page needs code samples. If you'd like to help us further, you could provide a code sample, or tell us about what kind of code sample you'd like to see:
You've told us there are code samples on this page which don't work. If you know how to fix it, or have something better we could use instead, please let us know:
You've told us there is information missing from this page. Please tell us more about what's missing:
You've told us there is incorrect information on this page. If you know what we should change to make it correct, please tell us:
You've told us this page has unclear or confusing information. Please tell us more about what you found unclear or confusing, or let us know how we could make it clearer:
You've told us there is a spelling or grammar error on this page. Please tell us what's wrong:
You've told us this page has a problem. Please tell us more about what's wrong:
Thank you for helping to make the Unity documentation better!
Your feedback has been submitted as a ticket for our documentation team to review.
We are not able to reply to every ticket submitted.