Texture2D.ignoreMipmapLimit

描述

This property causes a texture to ignore all texture mipmap limit settings.

When this property is true, Unity always uploads the texture to the GPU at full resolution, disregarding the active quality setting's global texture mipmap limit and texture mipmap limit group settings, even if this texture has a texture mipmap limit group set.

When this property is false, the texture respects the active quality setting's global texture mipmap limit, unless the texture is part of a mipmapLimitGroup.

When changing this property at runtime: if this causes the actual mipmap limit for this texture to change, then the texture will be reuploaded to the GPU. For an optimal workflow, set this property in the constructor or in the texture importer to immediately upload the texture with the currently active mipmap limits properly applied or ignored. If the texture has no mipmaps, this property has no effect. Note that this can only be toggled at runtime if the Texture is readable.

This code example demonstrates how to set this property to true in both the Texture2D constructor and AssetPostprocessor.

using UnityEngine;
using UnityEngine.Experimental.Rendering;
#if UNITY_EDITOR
using UnityEditor;
#endif

public class ExampleScript : MonoBehaviour
{
    void Start()
    {
        const int size = 32;
        Texture2D scriptTexture = new Texture2D(size, size, GraphicsFormat.R8G8B8A8_SRGB, Texture.GenerateAllMips, "MyGroup", TextureCreationFlags.MipChain | TextureCreationFlags.IgnoreMipmapLimit);
        Debug.Log($"ignoreMipmapLimit has been set to '{scriptTexture.ignoreMipmapLimit}' on the script texture!");
    }
}

#if UNITY_EDITOR
public class ExampleImporter : AssetPostprocessor
{
    void OnPreprocessTexture()
    {
        if (assetPath.Contains("_IgnoreMipmapLimit"))
        {
            TextureImporter textureImporter = (TextureImporter)assetImporter;
            textureImporter.ignoreMipmapLimit = true;
        }
    }
}
#endif

See Also: TextureCreationFlags.IgnoreMipmapLimit, TextureImporter.ignoreMipmapLimit, QualitySettings.globalTextureMipmapLimit.