Version: 2021.3
LanguageEnglish
  • C#

EditorUserBuildSettings.overrideTextureCompression

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

public static Build.OverrideTextureCompression overrideTextureCompression;

Description

The asset importing override of texture compression.

This setting lets you override the texture compression settings that Unity uses when it imports assets. This is mostly useful for local development, to speed up texture importing or build target switching.

This setting affects all textures in your project, and overrides the import settings for individual textures. For example, if a texture's import settings indicate that a "Normal" compressor quality should be used, but overrideTextureCompression is set to OverrideTextureCompression.ForceFastCompressor, the texture will be compressed with "Fast" compressor quality setting.

Overriding the texture compression format can increase the speed of the import process considerably, but it is important to understand the implications. For information on the effects of the different values, see the documentation for the OverrideTextureCompression enum.

The Unity editor command line argument -overrideTextureCompression can also be used to set this.

See Also: OverrideTextureCompression, EditorUserBuildSettings.overrideMaxTextureSize, Texture Importer, command line arguments.

using UnityEngine;
using UnityEditor;
using UnityEditor.Build;

public class ExampleScript : MonoBehaviour { [MenuItem("Example/Switch textures to import with Fast compressor")] public static void OverrideToFastCompressor() { EditorUserBuildSettings.overrideTextureCompression = OverrideTextureCompression.ForceFastCompressor; AssetDatabase.Refresh(); } }
Copyright © 2023 Unity Technologies
优美缔软件(上海)有限公司 版权所有
"Unity"、Unity 徽标及其他 Unity 商标是 Unity Technologies 或其附属机构在美国及其他地区的商标或注册商标。其他名称或品牌是其各自所有者的商标。
公安部备案号:
31010902002961