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

1. 项目背景与需求解析

在游戏开发或多媒体应用制作过程中，美术资源处理往往是最耗时的环节之一。最近接手的一个手游项目需要处理上千张UI贴图，每张都需要统一调整为特定像素规格。如果手动一张张处理，不仅效率低下还容易出错。于是研究了一套Unity批量处理图片像素的自动化方案，在这里把完整实现过程和踩坑经验分享给大家。

这个方案特别适合以下场景：

• 需要批量调整大量图片尺寸规格
• 要求保持原始图片的宽高比
• 需要自动处理透明通道
• 要求输出格式统一（如全部转为PNG）

2. 核心实现方案设计

2.1 技术选型分析

Unity本身提供了Texture2D类来处理图片数据，配合Editor脚本可以实现自动化处理。相比使用外部工具（如Photoshop脚本），直接在Unity中处理的优势在于：

• 无需额外软件依赖
• 可以完美兼容Unity的纹理导入设置
• 能直接处理工程中的原始文件
• 方便集成到现有工作流

核心用到的API包括：

• Texture2D.LoadImage() - 加载原始图片数据
• Texture2D.GetPixels() - 获取像素数据
• Texture2D.SetPixels() - 修改像素数据
• Texture2D.Apply() - 应用修改
• System.IO.File - 文件读写操作

2.2 处理流程设计

完整的批量处理流程分为四个阶段：

1. 资源收集阶段

   • 指定待处理文件夹路径
   • 递归查找所有图片文件
   • 过滤支持的文件格式（.png/.jpg/.tga等）

2. 像素处理阶段

   • 加载原始纹理
   • 创建目标尺寸的Texture2D
   • 像素采样与重映射
   • 处理透明通道

3. 输出保存阶段

   • 编码为指定格式
   • 保存到输出目录
   • 保留原始文件结构

4. 后处理阶段

   • 自动刷新Unity工程
   • 生成处理报告
   • 错误文件记录

3. 详细实现步骤

3.1 基础环境准备

首先创建一个Editor文件夹下的C#脚本，继承自EditorWindow：

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

public class BatchTextureProcessor : EditorWindow
{
    [MenuItem("Tools/Batch Process Textures")]
    static void Init()
    {
        var window = GetWindow<BatchTextureProcessor>();
        window.titleContent = new GUIContent("Texture Processor");
        window.Show();
    }
    
    // 后续代码将在这里添加
}

3.2 核心处理函数实现

关键的重采样函数实现如下：

csharp复制Texture2D ResizeTexture(Texture2D source, int targetWidth, int targetHeight)
{
    // 创建目标纹理
    Texture2D result = new Texture2D(targetWidth, targetHeight, source.format, false);
    
    // 计算缩放比例
    float scaleX = (float)source.width / targetWidth;
    float scaleY = (float)source.height / targetHeight;
    
    // 逐像素处理
    for(int y = 0; y < result.height; y++)
    {
        for(int x = 0; x < result.width; x++)
        {
            // 双线性采样
            Color pixel = source.GetPixelBilinear(
                (float)x / result.width * scaleX, 
                (float)y / result.height * scaleY);
            result.SetPixel(x, y, pixel);
        }
    }
    result.Apply();
    return result;
}

3.3 批量处理逻辑

添加目录遍历和处理逻辑：

csharp复制void ProcessDirectory(string inputPath, string outputPath, int width, int height)
{
    // 确保输出目录存在
    if(!Directory.Exists(outputPath))
        Directory.CreateDirectory(outputPath);
    
    // 获取所有图片文件
    string[] files = Directory.GetFiles(inputPath, "*.*", SearchOption.AllDirectories)
        .Where(f => f.EndsWith(".png") || f.EndsWith(".jpg") || f.EndsWith(".tga")).ToArray();
    
    // 进度显示
    EditorUtility.DisplayProgressBar("Processing", "Starting...", 0);
    
    for(int i = 0; i < files.Length; i++)
    {
        string relativePath = files[i].Substring(inputPath.Length);
        string outputFile = Path.Combine(outputPath, relativePath);
        
        // 更新进度
        EditorUtility.DisplayProgressBar(
            "Processing Textures", 
            $"Processing {Path.GetFileName(files[i])}",
            (float)i / files.Length);
        
        try 
        {
            // 加载原始文件
            byte[] bytes = File.ReadAllBytes(files[i]);
            Texture2D srcTex = new Texture2D(2, 2);
            srcTex.LoadImage(bytes);
            
            // 调整尺寸
            Texture2D dstTex = ResizeTexture(srcTex, width, height);
            
            // 保存处理结果
            byte[] pngData = dstTex.EncodeToPNG();
            Directory.CreateDirectory(Path.GetDirectoryName(outputFile));
            File.WriteAllBytes(outputFile, pngData);
        }
        catch(System.Exception e)
        {
            Debug.LogError($"Failed to process {files[i]}: {e.Message}");
        }
    }
    
    EditorUtility.ClearProgressBar();
    AssetDatabase.Refresh();
}

4. 图形界面实现

为了让工具更易用，添加一个简单的GUI：

csharp复制Vector2Int targetSize = new Vector2Int(512, 512);
string inputFolder = "Assets/Textures";
string outputFolder = "Assets/Textures_Processed";

void OnGUI()
{
    GUILayout.Label("Batch Texture Processor", EditorStyles.boldLabel);
    
    EditorGUILayout.Space();
    targetSize = EditorGUILayout.Vector2IntField("Target Size", targetSize);
    
    EditorGUILayout.Space();
    GUILayout.Label("Input Folder:");
    inputFolder = EditorGUILayout.TextField(inputFolder);
    
    EditorGUILayout.Space();
    GUILayout.Label("Output Folder:");
    outputFolder = EditorGUILayout.TextField(outputFolder);
    
    EditorGUILayout.Space();
    if(GUILayout.Button("Process Textures"))
    {
        if(Directory.Exists(inputFolder))
        {
            ProcessDirectory(inputFolder, outputFolder, targetSize.x, targetSize.y);
            EditorUtility.DisplayDialog("Complete", 
                $"Processed all textures in {inputFolder}", "OK");
        }
        else
        {
            EditorUtility.DisplayDialog("Error", 
                "Input directory does not exist", "OK");
        }
    }
}

5. 高级功能扩展

5.1 保持宽高比处理

修改ResizeTexture函数，添加保持宽高比的逻辑：

csharp复制Texture2D ResizeTexture(Texture2D source, int targetWidth, int targetHeight, bool keepAspect)
{
    if(keepAspect)
    {
        float aspect = (float)source.width / source.height;
        if(targetWidth / aspect <= targetHeight)
        {
            targetHeight = Mathf.RoundToInt(targetWidth / aspect);
        }
        else
        {
            targetWidth = Mathf.RoundToInt(targetHeight * aspect);
        }
    }
    // ...原有处理逻辑
}

5.2 批量重命名功能

添加按规则自动重命名的支持：

csharp复制string GenerateOutputPath(string inputPath, string outputRoot, string prefix, string suffix)
{
    string dir = Path.GetDirectoryName(inputPath);
    string filename = Path.GetFileNameWithoutExtension(inputPath);
    string ext = Path.GetExtension(inputPath);
    
    string relativeDir = dir.Substring(inputFolder.Length);
    string newFilename = $"{prefix}{filename}{suffix}{ext}";
    
    return Path.Combine(outputRoot, relativeDir, newFilename);
}

6. 性能优化技巧

处理大量图片时需要注意：

1. 内存管理：

   • 及时销毁临时创建的Texture2D对象
   • 使用using语句确保文件流正确关闭
   • 分批处理超大文件夹

2. 多线程处理：

   csharp复制ThreadPool.QueueUserWorkItem(state => {
       // 处理逻辑
       EditorApplication.delayCall += () => {
           // 回到主线程更新UI
       };
   });
   

3. 进度反馈优化：

   • 每处理10个文件更新一次进度
   • 显示当前处理速度和剩余时间预估

7. 常见问题与解决方案

问题1：处理后的图片颜色异常

• 检查原图是否包含alpha通道
• 确认TextureFormat设置正确
• 测试不同压缩格式的影响

问题2：内存不足崩溃

• 实现分块处理逻辑
• 增加System.GC.Collect()调用
• 限制同时处理的文件数量

问题3：边缘像素模糊

• 改用高质量的双三次采样算法
• 预处理时关闭mipmap
• 后期使用锐化滤镜补偿

8. 实际应用案例

最近一个卡牌游戏项目需要：

• 将500+张角色立绘从2048x2048统一调整为512x512
• 保持宽高比
• 添加"_small"后缀
• 输出到Resized文件夹

使用这个工具后：

• 处理时间从预估8小时缩短到15分钟
• 零错误率
• 自动生成处理报告
• 可随时重新运行调整参数