添加图片素材读取流程

2026-08-31 10:22:59 +08:00
parent 816335b894
commit fce331da84
42 changed files with 19608 additions and 4003 deletions
@@ -0,0 +1,178 @@
+using System;
+using System.Collections.Generic;
+using System.Threading.Tasks;
+using Cysharp.Threading.Tasks;
+using SepCore.Definition;
+using SepCore.Utility;
+using UnityEngine;
+using UnityGameFramework.Runtime;
+
+namespace SepCore.AsyncTask
+{
+    /// <summary>
+    /// 图集 Sprite 加载器，通过图集名 + 序号定位 Sprite。
+    /// 序号 -1 表示图集本身就是一张完整 Sprite，不需要切分。
+    /// </summary>
+    public static class SpriteLoader
+    {
+        private const float DefaultPixelsPerUnit = 32f;
+
+        private static readonly Dictionary<string, Texture2D> _textureCache = new();
+        private static readonly Dictionary<string, Task<Texture2D>> _loadingTextures = new();
+        private static readonly Dictionary<string, Dictionary<int, Sprite>> _spriteCache = new();
+
+        /// <summary>
+        /// 异步加载图集 Sprite
+        /// </summary>
+        /// <param name="config">Sprite 配置</param>
+        /// <param name="tileSize">切分块尺寸（像素），默认 32</param>
+        /// <param name="pixelsPerUnit">Sprite 像素单位比，默认 32</param>
+        /// <param name="timeout">超时时间（秒），0 表示不超时</param>
+        /// <returns>加载的 Sprite，失败时返回 null</returns>
+        public static UniTask<Sprite> LoadSpriteAsync(SpriteConfig config, int tileSize = 32,
+            float pixelsPerUnit = DefaultPixelsPerUnit, float timeout = 0f)
+        {
+            return LoadSpriteAsync(config.AtlasPath, config.SpriteIndex, tileSize, pixelsPerUnit, timeout);
+        }
+
+        /// <summary>
+        /// 异步加载图集 Sprite
+        /// </summary>
+        /// <param name="atlasName">图集名称（相对 Assets/GameMain/Textures 的路径，含扩展名，如 32rogues/monsters.png）</param>
+        /// <param name="index">序号，-1 表示整张图集作为一张 Sprite</param>
+        /// <param name="tileSize">切分块尺寸（像素），默认 32</param>
+        /// <param name="pixelsPerUnit">Sprite 像素单位比，默认 32</param>
+        /// <param name="timeout">超时时间（秒），0 表示不超时</param>
+        /// <returns>加载的 Sprite，失败时返回 null</returns>
+        public static async UniTask<Sprite> LoadSpriteAsync(string atlasName, int index, int tileSize = 32,
+            float pixelsPerUnit = DefaultPixelsPerUnit, float timeout = 0f)
+        {
+            Texture2D texture = await GetTextureAsync(atlasName, timeout);
+            if (texture == null)
+            {
+                return null;
+            }
+
+            int cacheKey = index < 0 ? -1 : index;
+            if (!_spriteCache.TryGetValue(atlasName, out Dictionary<int, Sprite> sprites))
+            {
+                sprites = new Dictionary<int, Sprite>();
+                _spriteCache[atlasName] = sprites;
+            }
+
+            if (sprites.TryGetValue(cacheKey, out Sprite cached))
+            {
+                return cached;
+            }
+
+            Sprite sprite = CreateSprite(texture, cacheKey, tileSize, pixelsPerUnit);
+            if (sprite != null)
+            {
+                sprites[cacheKey] = sprite;
+            }
+            return sprite;
+        }
+
+        /// <summary>
+        /// 释放指定图集的所有 Sprite 和纹理引用
+        /// </summary>
+        public static void Release(string atlasName)
+        {
+            if (_spriteCache.TryGetValue(atlasName, out Dictionary<int, Sprite> sprites))
+            {
+                foreach (Sprite sprite in sprites.Values)
+                {
+                    if (sprite != null)
+                    {
+                        UnityEngine.Object.Destroy(sprite);
+                    }
+                }
+                sprites.Clear();
+                _spriteCache.Remove(atlasName);
+            }
+
+            if (_textureCache.TryGetValue(atlasName, out Texture2D texture))
+            {
+                global::GameEntry.Resource.UnloadAsset(texture);
+                _textureCache.Remove(atlasName);
+            }
+        }
+
+        /// <summary>
+        /// 释放所有图集的 Sprite 和纹理引用
+        /// </summary>
+        public static void ReleaseAll()
+        {
+            List<string> atlasNames = new List<string>(_textureCache.Keys);
+            foreach (string atlasName in atlasNames)
+            {
+                Release(atlasName);
+            }
+        }
+
+        private static async UniTask<Texture2D> GetTextureAsync(string atlasName, float timeout)
+        {
+            if (_textureCache.TryGetValue(atlasName, out Texture2D cached))
+            {
+                return cached;
+            }
+
+            if (_loadingTextures.TryGetValue(atlasName, out Task<Texture2D> loading))
+            {
+                return await loading;
+            }
+
+            Task<Texture2D> task = LoadTextureAsync(atlasName, timeout).AsTask();
+            _loadingTextures[atlasName] = task;
+            try
+            {
+                Texture2D texture = await task;
+                if (texture != null)
+                {
+                    _textureCache[atlasName] = texture;
+                }
+                return texture;
+            }
+            finally
+            {
+                _loadingTextures.Remove(atlasName);
+            }
+        }
+
+        private static async UniTask<Texture2D> LoadTextureAsync(string atlasName, float timeout)
+        {
+            try
+            {
+                return await global::GameEntry.Resource.LoadAssetAsync<Texture2D>(
+                    AssetUtility.GetSpriteAsset(atlasName), Constant.AssetPriority.SpriteAsset, timeout: timeout);
+            }
+            catch (Exception e)
+            {
+                Log.Error("加载图集失败: {0}, error: {1}", atlasName, e);
+                return null;
+            }
+        }
+
+        private static Sprite CreateSprite(Texture2D texture, int index, int tileSize, float pixelsPerUnit)
+        {
+            if (index < 0)
+            {
+                return Sprite.Create(texture, new Rect(0f, 0f, texture.width, texture.height), new Vector2(0.5f, 0.5f), pixelsPerUnit);
+            }
+
+            int columns = Mathf.Max(1, texture.width / tileSize);
+            int rows = Mathf.Max(1, texture.height / tileSize);
+            int column = index % columns;
+            int row = index / columns;
+            if (row >= rows)
+            {
+                Log.Error("图集 {0} 序号 {1} 超出范围 (cols: {2}, rows: {3})", texture.name, index, columns, rows);
+                return null;
+            }
+
+            float x = column * tileSize;
+            float y = texture.height - (row + 1) * tileSize;
+            return Sprite.Create(texture, new Rect(x, y, tileSize, tileSize), new Vector2(0.5f, 0.5f), pixelsPerUnit);
+        }
+    }
+}
@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: b27858426f6b44b718b0279bdff6bc1e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 
@@ -35,12 +35,14 @@ namespace SepCore.CustomComponent
            "tbsoundconfig",
            "tbuiformconfig",
            "tbuisoundconfig",
-            "tbformattext"
+            "tbformattext",
+            "tbspriteconfig"
        };

        private sealed class TableAccessor
        {
            public Func<Tables, int, object> RowGetter;
+            public Func<Tables, string, object> StringRowGetter;
            public Func<Tables, object> ListGetter;
        }

@@ -127,6 +129,11 @@ namespace SepCore.CustomComponent
                    Accessor(tables => id => tables.TbUISoundConfig.GetOrDefault(id),
                        tables => tables.TbUISoundConfig.DataList)
                },
+                {
+                    typeof(SpriteConfig),
+                    StringAccessor(tables => key => tables.TbSpriteConfig.GetOrDefault(key),
+                        tables => tables.TbSpriteConfig.DataList)
+                },
            };

        private static TableAccessor Accessor<TValue>(Func<Tables, Func<int, object>> rowGetterFactory,
@@ -139,6 +146,16 @@ namespace SepCore.CustomComponent
            };
        }

+        private static TableAccessor StringAccessor<TValue>(Func<Tables, Func<string, object>> rowGetterFactory,
+            Func<Tables, List<TValue>> listGetter) where TValue : BeanBase
+        {
+            return new TableAccessor
+            {
+                StringRowGetter = (tables, key) => rowGetterFactory(tables)(key),
+                ListGetter = tables => listGetter(tables)
+            };
+        }
+
        private Dictionary<string, byte[]> _tableBytes = null;
        private int _remainCount = 0;
        private Action _onLoadSuccess = null;
@@ -178,6 +195,33 @@ namespace SepCore.CustomComponent
            return (T)accessor.RowGetter(Tables, id);
        }

+        /// <summary>
+        /// 按字符串主键获取数据行，未找到时返回 null。
+        /// </summary>
+        /// <typeparam name="T">数据行类型（对应生成的 xxxConfig 类）。</typeparam>
+        /// <param name="key">数据行字符串主键。</param>
+        /// <returns>数据行，未找到时返回 null。</returns>
+        public T Get<T>(string key) where T : class
+        {
+            if (Tables == null)
+            {
+                throw new InvalidOperationException("Luban data tables are not loaded yet.");
+            }
+
+            TableAccessor accessor;
+            if (!TableAccessors.TryGetValue(typeof(T), out accessor))
+            {
+                throw new NotSupportedException("No table getter is registered for type '" + typeof(T).FullName + "'.");
+            }
+
+            if (accessor.StringRowGetter == null)
+            {
+                throw new NotSupportedException("Table for type '" + typeof(T).FullName + "' does not use a string key.");
+            }
+
+            return (T)accessor.StringRowGetter(Tables, key);
+        }
+
        /// <summary>
        /// 获取整个表的所有数据行。
        /// </summary>