[Core][Asset] Add first character sprite set; Allow recolor tester to use builtin assets

Author: Shengjie Xu

assets/imagepack/charactersprite/A0-秋襟/DT1-短发女生/D1-眼泪.png

@@ -0,0 +1,72 @@
+选区:
+  M1-头发:
+    基础颜色: "#886F64"
+    适用于: L7-头发
+  M2-衣服:
+    基础颜色: "#8C6E5F"
+    适用于: ["L3-衣服","L5-裙蝴蝶结","L10-帽蝴蝶结"]
+  M3-裙子:
+    基础颜色: "#FCFAF9"
+    适用于: ["L2-裙子","L4-内搭","L6-衣扣蝴蝶结","L9-帽子"]
+  M4-围巾装饰:
+    基础颜色: "#FFBCC3"
+    适用于: L8-围巾装饰
+生成:
+  charactersprite_parts_based:
+    部件类型:
+      B1: preset_kind_base
+      B2: preset_kind_base
+      M: preset_kind_eyebrow
+      #Y: preset_kind_eye
+      K: preset_kind_mouth
+      #Q: preset_kind_fullface
+      DA: preset_kind_decoration
+      DB: preset_kind_decoration
+    标签:
+      通用: preset_tag_general
+      笑容: preset_tag_smile
+      愤怒: preset_tag_angry
+      悲伤: preset_tag_sad
+      惊讶: preset_tag_surprised
+      困惑: preset_tag_confused
+      害怕: preset_tag_scared
+      基底: preset_tag_base
+    部件:
+      B1:
+        L1-底图: 基底
+        L2-裙子: 基底
+        L3-衣服: 基底
+        L4-内搭: 基底
+        L5-裙蝴蝶结: 基底
+        L6-衣扣蝴蝶结: 基底
+      M:
+        M0-正常: ["通用", "笑容", "惊讶", "困惑", "害怕"]
+        M1-悲伤: 悲伤
+        M2-生气: 愤怒
+      K:
+        K0-正常: ["通用","害怕","愤怒","惊讶","困惑","笑容"]
+        K1-圆张嘴: ["通用","害怕","困惑","笑容"]
+        K2-闭嘴: ["通用","害怕","愤怒","困惑","笑容"]
+        K3-纠结: 害怕
+        K4-欢呼: 笑容
+        K5-撇嘴: 愤怒
+        K6-尴尬嘴: 害怕
+        K7-张嘴扁: 笑容
+        K8-悲伤嘴: 悲伤
+        K9-嘟嘴: ["通用","愤怒"]
+      B2:
+        L7-头发: 基底
+        L8-围巾装饰: 基底
+        L9-帽子: 基底
+        L10-帽蝴蝶结: 基底
+      DA:
+        D1-眼泪: {标签: ["害怕","悲伤"], 互斥: ["K0"], 依赖: ["K8"]}
+        D2-流汗: ["通用","害怕","笑容"]
+      DB:
+        D3-眼镜框: ["通用","害怕","愤怒","悲伤","惊讶","困惑","笑容"]
+    基底简写:
+      B0: L1L2L3L4L5L6L7L8L9L10
+元数据:
+    author: "秋襟"
+    overview_scale: 0.2
+    diff_croprect: [1885, 905, 2685, 1705]

assets/imagepack/charactersprite/A0-秋襟/DT1-短发女生/D2-流汗.png

@@ -0,0 +1,3 @@
+kind: CHARACTER
+reference:
+  en: "DT1"

assets/imagepack/charactersprite/A0-秋襟/DT1-短发女生/D3-眼镜框.png

@@ -0,0 +1,3 @@
+imagepack:
+  A0DT1:
+    yamlpath: "{srcpath}/A0-秋襟/DT1-短发女生/config.yml"

assets/imagepack/charactersprite/A0-秋襟/DT1-短发女生/K0-正常.png

@@ -1,4 +1,5 @@
 subdirs:
+  - imagepack/charactersprite/charactersprites.yml
   - imagepack/background/backgrounds.yml
   - thirdparty/thirdparty.yml
   - gui/gui.yml

assets/imagepack/charactersprite/A0-秋襟/DT1-短发女生/K1-圆张嘴.png

@@ -101,7 +101,7 @@ class ImagePack(NamedAssetClassBase):
 
   class MaskInfo:
     mask : ImageWrapper | None # 如果为 None 则表示该 mask 覆盖所有适用的基底图层
-    basename : str # 保存时使用的名称（不含后缀）
+    basename : str | None # 保存时使用的名称（不含后缀）
     offset_x : int
     offset_y : int
     width : int
@@ -117,7 +117,7 @@ def __init__(self, mask : ImageWrapper | None, mask_color : Color,
                  offset_x : int = 0, offset_y : int = 0,
                  width : int = 0, height : int = 0,
                  projective_vertices : tuple[tuple[int,int],tuple[int,int],tuple[int,int],tuple[int,int]] | None = None,
-                 basename : str = '', applyon : typing.Iterable[int] | None = None) -> None:
+                 basename : str | None = None, applyon : typing.Iterable[int] | None = None) -> None:
       self.mask = mask
       self.mask_color = mask_color
       self.offset_x = offset_x
@@ -266,7 +266,7 @@ def check_filename(filename : str):
       json_masks = []
       for m in self.masks:
         basename = m.basename
-        if basename != "None":
+        if basename is not None:
           if len(basename) == 0:
             basename = 'm' + str(len(json_masks))
           filename = basename + ".png"
@@ -917,7 +917,7 @@ def check_base_cover(l : ImagePack.LayerInfo) -> bool:
               break
       if isFullyCovers:
         m.mask = None
-        m.basename = "None"
+        m.basename = None
 
   def get_summary_no_variations(self, descriptor : 'ImagePackDescriptor') -> 'ImagePackSummary':
     # 在该图片组没有使用基底图变体时生成 ImagePackSummary

assets/imagepack/charactersprite/A0-秋襟/DT1-短发女生/K2-闭嘴.png

@@ -23,6 +23,7 @@
 from ..language import *
 from ..tooldecl import ToolClassDecl
 from .imagepack import *
+from ..assets.assetmanager import AssetManager
 
 @ToolClassDecl("imagepackrecolortester")
 class ImagePackRecolorTester:
@@ -407,6 +408,7 @@ def tool_main(args : list[str] | None = None):
     parser.add_argument("--psd", type=str, help="PSD file to load")
     parser.add_argument("--loaddir", type=str, help="Directory to load images")
     parser.add_argument("--yaml", type=str, help="ImagePack YAML file to load")
+    parser.add_argument("--asset", type=str, help="Asset ID to load")
     parser.add_argument("--srcscale", type=float, default=1.0, help="Scale factor for source images")
     parser.add_argument("--mask", type=str, nargs="+", help="Layer names to use as masks")
     parser.add_argument("--minimal", action="store_true", help="Use narrow color range")
@@ -432,6 +434,20 @@ def tool_main(args : list[str] | None = None):
           basecolors[name] = Color.get(parts[1])
 
     imagepacks = []
+    def add_forkable_pack(pack : ImagePack):
+      nonlocal imagepacks
+      if len(pack.masks) > 1:
+        # 给每个选区都生成一个独立的图片包
+        nummasks = len(pack.masks)
+        fork_args = [None] * nummasks
+        for i in range(0, nummasks):
+          curpack = pack.fork_applying_mask(fork_args) # type: ignore
+          curpack.masks.append(pack.masks[i])
+          imagepacks.append(curpack)
+      elif len(pack.masks) == 1:
+        imagepacks.append(pack)
+      else:
+        raise ValueError("No mask found in ImagePack")
     if parsed_args.psd or parsed_args.loaddir:
       if len(baselayernames) == 0:
         raise ValueError("No mask layers specified")
@@ -474,18 +490,16 @@ def tool_main(args : list[str] | None = None):
         pack = pack.fork_and_shrink(decimal.Decimal(parsed_args.srcscale))
       else:
         pack = pack.shrink_for_overview()
-      if len(pack.masks) > 1:
-        # 给每个选区都生成一个独立的图片包
-        nummasks = len(pack.masks)
-        fork_args = [None] * nummasks
-        for i in range(0, nummasks):
-          curpack = pack.fork_applying_mask(fork_args) # type: ignore
-          curpack.masks.append(pack.masks[i])
-          imagepacks.append(curpack)
-      elif len(pack.masks) == 1:
-        imagepacks.append(pack)
+      add_forkable_pack(pack)
+    elif parsed_args.asset:
+      am = AssetManager.get_instance()
+      if pack := am.get_asset(parsed_args.asset):
+        add_forkable_pack(pack)
       else:
-        raise ValueError("No mask found in ImagePack")
+        am.load_all_assets()
+        json_dump = am.get_assets_json()
+        available_assets = [k for k in json_dump.keys() if k.startswith("imagepack")]
+        raise ValueError("Cannot find asset " + parsed_args.asset + ". Available assets: " + ", ".join(available_assets))
     else:
       size = (600, 200)
       for color in dest_colors: