Unity批量处理像素图片的自动化方案

兔尾巴老李

1. 项目背景与需求解析

在游戏开发或UI设计过程中，我们经常需要处理大量图片资源。最近我在制作一个2D像素风游戏时，就遇到了一个典型问题：美术提供的原始素材尺寸和像素风格不统一，有的图片分辨率过高导致像素感不足，有的则存在边缘锯齿问题。手动一张张调整不仅效率低下，还容易出错。

Unity虽然内置了图片导入设置，但面对上百张素材时，逐个配置Texture Type、Filter Mode等参数依然是个体力活。更麻烦的是，不同用途的图片需要不同的压缩设置——角色精灵图需要保持锐利边缘，背景图则可以适当模糊。这时候就需要一套自动化方案来批量处理图片像素。

2. 核心解决方案设计

2.1 技术路线选择

经过对比测试，我最终确定了基于Unity Editor脚本的解决方案。相比外部工具（如Photoshop脚本），直接在Unity中处理有以下优势：

直接操作工程中的Texture2D对象，避免导入导出
可以复用Unity的图片处理管线
修改结果即时可见，方便调试
能与Unity的Asset Pipeline无缝集成

核心处理流程分为三个步骤：

遍历目标文件夹获取所有图片
根据规则批量修改导入设置
应用修改并自动重新导入

2.2 关键参数解析

在Unity中控制图片像素表现的核心参数包括：

Texture Type：Sprite(2D UI) / Default(3D纹理)
Filter Mode：Point(像素风) / Bilinear(平滑过渡)
Compression：None(无损) / Compressed(有损)
Max Size：限制最大分辨率
Format：RGBA32 / RGB24等

对于像素风游戏，通常建议配置：

csharp复制textureImporter.textureType = TextureImporterType.Sprite;
textureImporter.filterMode = FilterMode.Point; 
textureImporter.textureCompression = TextureImporterCompression.Uncompressed;

3. 完整实现步骤

3.1 创建Editor脚本

在Unity项目中创建Editor/PixelArtProcessor.cs：

csharp复制using UnityEditor;
using UnityEngine;
using System.IO;

public class PixelArtProcessor : EditorWindow
{
    [MenuItem("Tools/批量处理像素图片")]
    static void Init()
    {
        var window = GetWindow<PixelArtProcessor>();
        window.Show();
    }

    void OnGUI()
    {
        if (GUILayout.Button("处理选中文件夹"))
        {
            ProcessSelectedFolder();
        }
    }

    static void ProcessSelectedFolder()
    {
        // 获取选中的文件夹路径
        string folderPath = AssetDatabase.GetAssetPath(Selection.activeObject);
        if (!Directory.Exists(folderPath)) return;

        // 遍历所有图片文件
        string[] files = Directory.GetFiles(folderPath, "*.*", SearchOption.AllDirectories)
            .Where(f => f.EndsWith(".png") || f.EndsWith(".jpg")).ToArray();

        foreach (string file in files)
        {
            ProcessSingleTexture(file);
        }
        
        AssetDatabase.Refresh();
        Debug.Log($"处理完成，共修改{files.Length}张图片");
    }
}

3.2 单张图片处理方法

csharp复制static void ProcessSingleTexture(string path)
{
    TextureImporter importer = AssetImporter.GetAtPath(path) as TextureImporter;
    if (importer == null) return;

    // 基础设置
    importer.textureType = TextureImporterType.Sprite;
    importer.spriteImportMode = SpriteImportMode.Single;
    importer.mipmapEnabled = false;
    importer.filterMode = FilterMode.Point;
    importer.textureCompression = TextureImporterCompression.Uncompressed;
    
    // 根据用途设置不同参数
    if (path.Contains("/Characters/"))
    {
        importer.spritePixelsPerUnit = 32;
        importer.maxTextureSize = 512;
    }
    else if (path.Contains("/Backgrounds/"))
    {
        importer.spritePixelsPerUnit = 16;
        importer.maxTextureSize = 1024;
    }
    
    EditorUtility.SetDirty(importer);
    importer.SaveAndReimport();
}

4. 高级功能扩展

4.1 智能分辨率适配

对于像素风游戏，保持统一的像素密度至关重要。我们可以添加自动计算功能：

csharp复制int CalculateOptimalSize(Texture2D tex, int baseSize)
{
    // 取较小边作为基准
    int minSide = Mathf.Min(tex.width, tex.height);
    // 计算最接近baseSize的整数倍
    return Mathf.RoundToInt(minSide / (float)baseSize) * baseSize;
}

4.2 批量重采样

对于需要真正修改像素数据的场景（而不仅是导入设置），可以使用Texture2D的API：

csharp复制Texture2D ResampleTexture(Texture2D source, int newWidth, int newHeight)
{
    RenderTexture rt = RenderTexture.GetTemporary(newWidth, newHeight);
    Graphics.Blit(source, rt);
    Texture2D result = new Texture2D(newWidth, newHeight);
    RenderTexture.active = rt;
    result.ReadPixels(new Rect(0, 0, newWidth, newHeight), 0, 0);
    result.Apply();
    RenderTexture.ReleaseTemporary(rt);
    return result;
}

5. 实战经验与避坑指南

5.1 常见问题排查

修改未生效：
- 确保调用了SaveAndReimport()
- 检查是否有其他脚本在运行时修改设置
- 在Project窗口右键选择"Reimport"
内存不足：
- 分批处理大量图片（每次处理50-100张）
- 使用EditorUtility.UnloadUnusedAssetsImmediate()
边缘锯齿：
- 确保原始素材尺寸是目标尺寸的整数倍
- 关闭mipmap
- 检查图片的Wrap Mode是否为Clamp