添加图片素材读取流程
This commit is contained in:
huangjun
@@ -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);
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user