修正文字说明

CHANGELOG.md

@@ -1,5 +1,43 @@
 # CHANGELOG
 
+## v0.12.2
+
+- 模型参数分标签显示
+- 皮肤/动画列表使用右键菜单进行增删
+- 标题栏显示版本号
+- 增加 webp 和 avif 动图格式
+- 增加导出参数缓存
+- 动图默认帧率修改为 24 帧
+- 增加保留最后一帧参数
+
+## v0.12.1
+
+- 优化使用体验, 提供初始皮肤/动画空位
+- 修复预览画面分辨率调整时父容器尺寸获取错误
+
+## v0.12.0
+
+- 支持皮肤列表 (仅 3.8.x 及以上支持)
+- 支持多轨道动画
+- 动画和皮肤列表多选时改为取并集
+- 修复导出时没有正确处理预乘像素的问题
+
+## v0.11.5
+
+- 导出格式全面支持
+- 修复预览图不显示的问题
+- 优化列表卡顿问题
+- 模型列表增加数量显示
+
+## v0.11.4
+
+- 增加 MP4 导出格式
+- 增加导出背景颜色参数
+- 增加日志输出 FFMpeg 参数字符串
+- 增加导出时任务栏图标执行动效
+- 修复预览面板移动模型时物理效果不同步的问题
+- 优化部分使用体验
+
 ## v0.11.3
 
 - 增加模型隐藏设置属性

README.en.md

@@ -1,88 +1,97 @@
 # [SpineViewer](https://github.com/ww-rm/SpineViewer)
 
 [![Build and Release](https://github.com/ww-rm/SpineViewer/actions/workflows/dotnet-desktop.yml/badge.svg)](https://github.com/ww-rm/SpineViewer/actions/workflows/dotnet-desktop.yml)
+[![GitHub Release](https://img.shields.io/github/v/release/ww-rm/SpineViewer?logo=github&logoColor=959da5&label=Release&labelColor=3f4850)](https://github.com/ww-rm/SpineViewer/releases)
+[![Downloads](https://img.shields.io/github/downloads/ww-rm/SpineViewer/total?logo=github&logoColor=959da5&label=Downloads&labelColor=3f4850)](https://github.com/ww-rm/SpineViewer/releases)
 
 [中文](README.md) | [English](README.en.md)
 
-A *WYSIWYG* Spine file viewer and exporter.
+*A WYSIWYG Spine file viewer and exporter.*
 
 ![previewer](img/preview.webp)
 
 ---
 
+:sparkles: v0.12.x New Feature: Support for multi-track animations and multi-skin list management :sparkles:
+
+---
+
 ## Installation
 
-Go to the [Release](https://github.com/ww-rm/SpineViewer/releases) page to download the zip package.
+Head over to the [Release](https://github.com/ww-rm/SpineViewer/releases) page to download the zip package.
 
-The software requires the dependency framework [.NET Desktop Runtime 8.0.x](https://dotnet.microsoft.com/zh-cn/download/dotnet/8.0).
+The software requires the dependency framework [.NET Desktop Runtime 8.0.x](https://dotnet.microsoft.com/en-us/download/dotnet/8.0).
 
-You can also download the zip package with the `SelfContained` suffix, which can run independently.
+Alternatively, you can download the package with the `SelfContained` suffix, which can run independently.
+
+Exporting video formats such as GIF requires that ffmpeg is installed locally and added to your system’s PATH. You can [click here to go to the FFmpeg-Windows download page](https://ffmpeg.org/download.html#build-windows) or directly download the latest version [ffmpeg-release-full.7z](https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-full.7z).
 
 ## Supported Export Formats
 
-- [x] Single Frame Image
-- [x] Frame Sequence
-- [x] Animated GIF
-- [ ] MKV
-- [ ] MP4
-- [ ] MOV
-- [ ] WebM
-
-More formats are under development :rocket::rocket::rocket:
+| Export Format  | Suitable for Scenario                                                                 |
+| ------------ | ------------------------------------------------------------------------------------|
+| Single Frame   | Supports generating high-definition model snapshots; you can manually adjust the frame. |
+| Frame Sequence | Supports png sequence output with transparency and lossless compression.              |
+| GIF            | Ideal for generating preview animations.                                              |
+| MP4            | The most common video format with the best compatibility.                             |
+| WebM           | Suitable for browser-based playback and supports transparent backgrounds.             |
+| MKV            | For more experimental use.                                                              |
+| MOV            | For more experimental use.                                                              |
+| Custom Export  | In addition to the above presets, you can provide any FFmpeg parameters to meet complex custom needs. |
 
 ## Supported Spine Versions
 
-| Version   | View & Export | Format Conversion | Version Conversion |
-| :-------: | :-----------: | :---------------: | :----------------: |
-| `2.1.x`   | :white_check_mark: |               |                    |
-| `3.1.x`   |             |               |                    |
-| `3.4.x`   |             |               |                    |
-| `3.5.x`   |             |               |                    |
-| `3.6.x`   | :white_check_mark: |               |                    |
-| `3.7.x`   | :white_check_mark: |               |                    |
-| `3.8.x`   | :white_check_mark: | :white_check_mark: |               |
-| `4.1.x`   | :white_check_mark: |               |                    |
-| `4.2.x`   | :white_check_mark: |               |                    |
-| `4.3.x`   |             |               |                    |
+| Version  | View & Export         | Format Conversion    | Version Conversion  |
+| :------: | :-------------------: | :------------------: | :-----------------: |
+| `2.1.x`  | :white_check_mark:    |                      |                     |
+| `3.1.x`  |                       |                      |                     |
+| `3.4.x`  |                       |                      |                     |
+| `3.5.x`  |                       |                      |                     |
+| `3.6.x`  | :white_check_mark:    |                      |                     |
+| `3.7.x`  | :white_check_mark:    |                      |                     |
+| `3.8.x`  | :white_check_mark:    | :white_check_mark:   |                     |
+| `4.1.x`  | :white_check_mark:    |                      |                     |
+| `4.2.x`  | :white_check_mark:    |                      |                     |
+| `4.3.x`  |                       |                      |                     |
 
-More versions are under development :rocket::rocket::rocket:
+More versions are under development :rocket: :rocket: :rocket:
 
-## Usage
+## How to Use
 
-### Importing Skeletons
+### Importing Skeleton Files
 
 There are three ways to import skeleton files:
 
 - Drag and drop or paste the skeleton file/directory into the model list.
-- Open skeleton files in batch from the File menu.
+- Batch open skeleton files from the File menu.
 - Select a single model to open from the File menu.
 
-### Adjusting Preview Content
+### Adjusting the Preview
 
-The model list supports right-click menus and several hotkeys, and multiple models can be selected for batch adjustments of model parameters.
+The model list supports context menus and some shortcuts, and you can multi-select to adjust parameters in bulk.
 
-In addition to using the control panel for parameter settings, the preview window supports the following mouse actions:
+In addition to using the panel for parameter settings, the preview screen supports several mouse actions:
 
-- Left-click to select and drag models. Hold the `Ctrl` key to enable multi-selection, which is synchronized with the model list on the left.
+- Left-click to select and drag models; hold the `Ctrl` key for multi-selection (which is synchronized with the list on the left).
 - Right-click to drag the overall view.
-- Use the scroll wheel to zoom in/out.
-- "Render selected only" mode, in which the preview only includes selected models and the selection can only be changed via the model list on the left.
+- Use the mouse wheel to zoom in and out.
+- “Render Selected” mode: in this mode, the preview screen only shows the selected models and the selection state can only be changed from the list on the left.
 
-The buttons below the preview window allow you to adjust the timeline, effectively serving as a simple player.
+The buttons below the preview allow you to adjust the timeline, acting as a simple media player.
 
-### Exporting Preview Content
+### Exporting the Preview
 
-Export follows the "What You See Is What You Get" principle—what you see in the live preview is exactly what gets exported.
+Exporting follows the “What You See Is What You Get” principle – the preview exactly reflects the output.
 
-There are a few key parameters for exporting:
+There are several key parameters for export:
 
-- Render Selected Only: This option not only affects the preview mode but also the export; if enabled, only the selected models will be considered, and all other models will be ignored during export.
-- Output Folder: This parameter is optional in some cases. If not provided, the output will be saved in each model's own directory. Otherwise, all output files will be saved to the specified folder.
-- Single Export: By default, each model is exported individually in batch mode. If "Single Export" is selected, all exported models will be rendered on a single canvas, resulting in only one output file.
+- Render Selected Only: This option affects both the preview and export. If enabled, only the selected models will be considered during export while ignoring the others.
+- Output Folder: This parameter is optional in some cases. If not provided, the output files will be saved in each model’s own folder; otherwise, all outputs will be saved to the specified folder.
+- Single Export: By default, each model is exported separately (i.e., batch operation on the model list). If “Single Export” is selected, all the exported models will be rendered on the same canvas, producing only one output file.
 
 ### More Information
 
-For more detailed instructions and usage, please refer to the [Wiki](https://github.com/ww-rm/SpineViewer/wiki). If you encounter any issues or bugs, please open an [Issue](https://github.com/ww-rm/SpineViewer/issues).
+For detailed instructions and usage notes, please see the [Wiki](https://github.com/ww-rm/SpineViewer/wiki). If you encounter any issues or bugs, feel free to open an [Issue](https://github.com/ww-rm/SpineViewer/issues).
 
 ## Acknowledgements
 
@@ -92,6 +101,6 @@ For more detailed instructions and usage, please refer to the [Wiki](https://git
 
 ---
 
-*If you like this project, please give it a :star: and share it with others! :)*
+*If you like this project, please give it a :star: and share it with others!*  
 
-[![Stargazers over time](https://starchart.cc/ww-rm/SpineViewer.svg?variant=adaptive)](https://starchart.cc/ww-rm/SpineViewer)
+[![Stargazers over time](https://starchart.cc/ww-rm/SpineViewer.svg?variant=adaptive)](https://starchart.cc/ww-rm/SpineViewer)

README.md

@@ -1,6 +1,8 @@
 # [SpineViewer](https://github.com/ww-rm/SpineViewer)
 
 [![Build and Release](https://github.com/ww-rm/SpineViewer/actions/workflows/dotnet-desktop.yml/badge.svg)](https://github.com/ww-rm/SpineViewer/actions/workflows/dotnet-desktop.yml)
+[![GitHub Release](https://img.shields.io/github/v/release/ww-rm/SpineViewer?logo=github&logoColor=959da5&label=Release&labelColor=3f4850)](https://github.com/ww-rm/SpineViewer/releases)
+[![Downloads](https://img.shields.io/github/downloads/ww-rm/SpineViewer/total?logo=github&logoColor=959da5&label=Downloads&labelColor=3f4850)](https://github.com/ww-rm/SpineViewer/releases)
 
 [中文](README.md) | [English](README.en.md)
 
@@ -10,6 +12,10 @@
 
 ---
 
+:sparkles: v0.12.x 新增功能: 支持多轨道动画以及多皮肤列表管理 :sparkles:
+
+---
+
 ## 安装
 
 前往 [Release](https://github.com/ww-rm/SpineViewer/releases) 界面下载压缩包.
@@ -18,17 +24,19 @@
 
 也可以下载带有 `SelfContained` 后缀的压缩包, 可以独立运行.
 
+导出 GIF 等视频格式需要在本地安装 ffmpeg 命令行, 并且添加至环境变量, [点击前往 FFmpeg-Windows 下载页面](https://ffmpeg.org/download.html#build-windows), 也可以点这个下载最新版本 [ffmpeg-release-full.7z](https://www.gyan.dev/ffmpeg/builds/ffmpeg-release-full.7z).
+
 ## 导出格式支持
 
-- [x] 单帧画面
-- [x] 帧序列
-- [x] GIF 动图
-- [ ] MKV
-- [ ] MP4
-- [ ] MOV
-- [ ] WebM
-
-更多格式正在施工 :rocket::rocket::rocket:
+| 导出格式 | 适用场景 |
+| --- | --- |
+| 单帧画面 | 支持生成高清模型画面图像, 可手动调节需要的一帧. |
+| 帧序列 | 支持 PNG 格式帧序列, 可保留透明通道且无损压缩. |
+| GIF/WebP/AVIF | 适合生成预览动图. |
+| MP4 | 最常见的视频格式, 兼容性最好. |
+| WebM | 适合浏览器在线播放格式, 支持透明背景. |
+| MKV/MOV | 适合折腾. |
+| 自定义导出 | 除上述预设方案, 支持提供任意 FFmpeg 参数进行导出, 满足自定义复杂需求. |
 
 ## Spine 版本支持
 
@@ -45,7 +53,7 @@
 | `4.2.x` | :white_check_mark: |  |  |
 | `4.3.x` |  |  |  |
 
-更多版本正在施工 :rocket::rocket::rocket:
+更多版本正在施工 :rocket: :rocket: :rocket:
 
 ## 使用方法
 

SpineRuntimes/SpineRuntime21/AnimationState.cs

@@ -41,8 +41,9 @@ namespace SpineRuntime21 {
 
 		public AnimationStateData Data { get { return data; } }
 		public float TimeScale { get { return timeScale; } set { timeScale = value; } }
+		public List<TrackEntry> Tracks => tracks;
 
-		public delegate void StartEndDelegate(AnimationState state, int trackIndex);
+        public delegate void StartEndDelegate(AnimationState state, int trackIndex);
 		public event StartEndDelegate Start;
 		public event StartEndDelegate End;
 

SpineRuntimes/SpineRuntime21/SpineRuntime21.csproj

@@ -5,7 +5,6 @@
         <Nullable>enable</Nullable>
         <Platforms>x64</Platforms>
         <TargetFramework>net8.0-windows</TargetFramework>
-        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
         <Version>2.1.25</Version>

SpineRuntimes/SpineRuntime36/SpineRuntime36.csproj

@@ -5,7 +5,6 @@
         <Nullable>enable</Nullable>
         <Platforms>x64</Platforms>
         <TargetFramework>net8.0-windows</TargetFramework>
-        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
         <Version>3.6.53</Version>

SpineRuntimes/SpineRuntime37/SpineRuntime37.csproj

@@ -5,7 +5,6 @@
         <Nullable>enable</Nullable>
         <Platforms>x64</Platforms>
         <TargetFramework>net8.0-windows</TargetFramework>
-        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
         <Version>3.7.94</Version>

SpineRuntimes/SpineRuntime38/SpineRuntime38.csproj

@@ -5,7 +5,6 @@
         <Nullable>enable</Nullable>
         <Platforms>x64</Platforms>
         <TargetFramework>net8.0-windows</TargetFramework>
-        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
         <Version>3.8.99</Version>

SpineRuntimes/SpineRuntime40/SpineRuntime40.csproj

@@ -5,7 +5,6 @@
         <Nullable>enable</Nullable>
         <Platforms>x64</Platforms>
         <TargetFramework>net8.0-windows</TargetFramework>
-        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
         <Version>4.0.64</Version>

SpineRuntimes/SpineRuntime41/SpineRuntime41.csproj

@@ -5,7 +5,6 @@
         <Nullable>enable</Nullable>
         <Platforms>x64</Platforms>
         <TargetFramework>net8.0-windows</TargetFramework>
-        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
         <Version>4.1.54</Version>

SpineRuntimes/SpineRuntime42/SpineRuntime42.csproj

@@ -5,7 +5,6 @@
         <Nullable>enable</Nullable>
         <Platforms>x64</Platforms>
         <TargetFramework>net8.0-windows</TargetFramework>
-        <RuntimeIdentifier>win-x64</RuntimeIdentifier>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
         <Version>4.2.74</Version>

SpineViewer/Controls/SkelFileListBox.cs

@@ -8,6 +8,7 @@ using System.Text;
 using System.Threading.Tasks;
 using System.Windows.Forms;
 using System.IO;
+using SpineViewer.Spine;
 
 namespace SpineViewer.Controls
 {
@@ -33,14 +34,14 @@ namespace SpineViewer.Controls
             {
                 if (File.Exists(path))
                 {
-                    if (Spine.Spine.CommonSkelSuffix.Contains(Path.GetExtension(path).ToLower()))
+                    if (SpineHelper.CommonSkelSuffix.Contains(Path.GetExtension(path).ToLower()))
                         listBox.Items.Add(Path.GetFullPath(path));
                 }
                 else if (Directory.Exists(path))
                 {
                     foreach (var file in Directory.EnumerateFiles(path, "*.*", SearchOption.AllDirectories))
                     {
-                        if (Spine.Spine.CommonSkelSuffix.Contains(Path.GetExtension(file).ToLower()))
+                        if (SpineHelper.CommonSkelSuffix.Contains(Path.GetExtension(file).ToLower()))
                             listBox.Items.Add(file);
                     }
                 }
@@ -57,7 +58,7 @@ namespace SpineViewer.Controls
             {
                 foreach (var file in Directory.EnumerateFiles(path, "*.*", SearchOption.AllDirectories))
                 {
-                    if (Spine.Spine.CommonSkelSuffix.Contains(Path.GetExtension(file).ToLower()))
+                    if (SpineHelper.CommonSkelSuffix.Contains(Path.GetExtension(file).ToLower()))
                         listBox.Items.Add(file);
                 }
             }

SpineViewer/Controls/SpineListView.Designer.cs

@@ -44,8 +44,9 @@
             toolStripMenuItem_MoveTop = new ToolStripMenuItem();
             toolStripMenuItem_MoveBottom = new ToolStripMenuItem();
             toolStripSeparator3 = new ToolStripSeparator();
-            toolStripMenuItem_SelectAll = new ToolStripMenuItem();
             toolStripMenuItem_CopyPreview = new ToolStripMenuItem();
+            toolStripMenuItem_AddFromClipboard = new ToolStripMenuItem();
+            toolStripMenuItem_SelectAll = new ToolStripMenuItem();
             toolStripSeparator4 = new ToolStripSeparator();
             toolStripMenuItem_ChangeView = new ToolStripMenuItem();
             toolStripMenuItem_LargeIconView = new ToolStripMenuItem();
@@ -53,8 +54,13 @@
             toolStripMenuItem_DetailsView = new ToolStripMenuItem();
             imageList_LargeIcon = new ImageList(components);
             imageList_SmallIcon = new ImageList(components);
-            toolStripMenuItem_AddFromClipboard = new ToolStripMenuItem();
+            timer_SelectedIndexChangedDebounce = new System.Windows.Forms.Timer(components);
+            statusStrip = new StatusStrip();
+            toolStripStatusLabel_CountInfo = new ToolStripStatusLabel();
+            tableLayoutPanel = new TableLayoutPanel();
             contextMenuStrip.SuspendLayout();
+            statusStrip.SuspendLayout();
+            tableLayoutPanel.SuspendLayout();
             SuspendLayout();
             // 
             // listView
@@ -68,9 +74,10 @@
             listView.GridLines = true;
             listView.LargeImageList = imageList_LargeIcon;
             listView.Location = new Point(0, 0);
+            listView.Margin = new Padding(0);
             listView.Name = "listView";
             listView.ShowItemToolTips = true;
-            listView.Size = new Size(336, 445);
+            listView.Size = new Size(336, 414);
             listView.SmallImageList = imageList_SmallIcon;
             listView.TabIndex = 1;
             listView.UseCompatibleStateImageBehavior = false;
@@ -84,14 +91,14 @@
             // columnHeader_Name
             // 
             columnHeader_Name.Text = "名称";
-            columnHeader_Name.Width = 220;
+            columnHeader_Name.Width = 300;
             // 
             // contextMenuStrip
             // 
             contextMenuStrip.ImageScalingSize = new Size(24, 24);
             contextMenuStrip.Items.AddRange(new ToolStripItem[] { toolStripMenuItem_Add, toolStripMenuItem_Insert, toolStripMenuItem_Remove, toolStripSeparator1, toolStripMenuItem_BatchAdd, toolStripMenuItem_RemoveAll, toolStripSeparator2, toolStripMenuItem_MoveUp, toolStripMenuItem_MoveDown, toolStripMenuItem_MoveTop, toolStripMenuItem_MoveBottom, toolStripSeparator3, toolStripMenuItem_CopyPreview, toolStripMenuItem_AddFromClipboard, toolStripMenuItem_SelectAll, toolStripSeparator4, toolStripMenuItem_ChangeView });
             contextMenuStrip.Name = "contextMenuStrip";
-            contextMenuStrip.Size = new Size(329, 451);
+            contextMenuStrip.Size = new Size(329, 418);
             contextMenuStrip.Closed += contextMenuStrip_Closed;
             contextMenuStrip.Opening += contextMenuStrip_Opening;
             // 
@@ -178,14 +185,6 @@
             toolStripSeparator3.Name = "toolStripSeparator3";
             toolStripSeparator3.Size = new Size(325, 6);
             // 
-            // toolStripMenuItem_SelectAll
-            // 
-            toolStripMenuItem_SelectAll.Name = "toolStripMenuItem_SelectAll";
-            toolStripMenuItem_SelectAll.ShortcutKeys = Keys.Control | Keys.A;
-            toolStripMenuItem_SelectAll.Size = new Size(328, 30);
-            toolStripMenuItem_SelectAll.Text = "全选";
-            toolStripMenuItem_SelectAll.Click += toolStripMenuItem_SelectAll_Click;
-            // 
             // toolStripMenuItem_CopyPreview
             // 
             toolStripMenuItem_CopyPreview.Name = "toolStripMenuItem_CopyPreview";
@@ -194,6 +193,22 @@
             toolStripMenuItem_CopyPreview.Text = "复制预览图 (256x256)";
             toolStripMenuItem_CopyPreview.Click += toolStripMenuItem_CopyPreview_Click;
             // 
+            // toolStripMenuItem_AddFromClipboard
+            // 
+            toolStripMenuItem_AddFromClipboard.Name = "toolStripMenuItem_AddFromClipboard";
+            toolStripMenuItem_AddFromClipboard.ShortcutKeys = Keys.Control | Keys.V;
+            toolStripMenuItem_AddFromClipboard.Size = new Size(328, 30);
+            toolStripMenuItem_AddFromClipboard.Text = "从剪贴板添加";
+            toolStripMenuItem_AddFromClipboard.Click += toolStripMenuItem_AddFromClipboard_Click;
+            // 
+            // toolStripMenuItem_SelectAll
+            // 
+            toolStripMenuItem_SelectAll.Name = "toolStripMenuItem_SelectAll";
+            toolStripMenuItem_SelectAll.ShortcutKeys = Keys.Control | Keys.A;
+            toolStripMenuItem_SelectAll.Size = new Size(328, 30);
+            toolStripMenuItem_SelectAll.Text = "全选";
+            toolStripMenuItem_SelectAll.Click += toolStripMenuItem_SelectAll_Click;
+            // 
             // toolStripSeparator4
             // 
             toolStripSeparator4.Name = "toolStripSeparator4";
@@ -242,22 +257,56 @@
             imageList_SmallIcon.ImageSize = new Size(48, 48);
             imageList_SmallIcon.TransparentColor = Color.Transparent;
             // 
-            // toolStripMenuItem_AddFromClipboard
+            // timer_SelectedIndexChangedDebounce
             // 
-            toolStripMenuItem_AddFromClipboard.Name = "toolStripMenuItem_AddFromClipboard";
-            toolStripMenuItem_AddFromClipboard.ShortcutKeys = Keys.Control | Keys.V;
-            toolStripMenuItem_AddFromClipboard.Size = new Size(328, 30);
-            toolStripMenuItem_AddFromClipboard.Text = "从剪贴板添加";
-            toolStripMenuItem_AddFromClipboard.Click += toolStripMenuItem_AddFromClipboard_Click;
+            timer_SelectedIndexChangedDebounce.Interval = 30;
+            timer_SelectedIndexChangedDebounce.Tick += timer_SelectedIndexChangedDebounce_Tick;
+            // 
+            // statusStrip
+            // 
+            statusStrip.Dock = DockStyle.Fill;
+            statusStrip.ImageScalingSize = new Size(24, 24);
+            statusStrip.Items.AddRange(new ToolStripItem[] { toolStripStatusLabel_CountInfo });
+            statusStrip.Location = new Point(0, 414);
+            statusStrip.Name = "statusStrip";
+            statusStrip.Size = new Size(336, 31);
+            statusStrip.SizingGrip = false;
+            statusStrip.TabIndex = 2;
+            statusStrip.Text = "statusStrip1";
+            // 
+            // toolStripStatusLabel_CountInfo
+            // 
+            toolStripStatusLabel_CountInfo.Name = "toolStripStatusLabel_CountInfo";
+            toolStripStatusLabel_CountInfo.Size = new Size(178, 24);
+            toolStripStatusLabel_CountInfo.Text = "已选择 0 项，共 0 项";
+            // 
+            // tableLayoutPanel
+            // 
+            tableLayoutPanel.ColumnCount = 1;
+            tableLayoutPanel.ColumnStyles.Add(new ColumnStyle(SizeType.Percent, 100F));
+            tableLayoutPanel.Controls.Add(listView, 0, 0);
+            tableLayoutPanel.Controls.Add(statusStrip, 0, 1);
+            tableLayoutPanel.Dock = DockStyle.Fill;
+            tableLayoutPanel.Location = new Point(0, 0);
+            tableLayoutPanel.Name = "tableLayoutPanel";
+            tableLayoutPanel.RowCount = 2;
+            tableLayoutPanel.RowStyles.Add(new RowStyle(SizeType.Percent, 100F));
+            tableLayoutPanel.RowStyles.Add(new RowStyle());
+            tableLayoutPanel.Size = new Size(336, 445);
+            tableLayoutPanel.TabIndex = 3;
             // 
             // SpineListView
             // 
             AutoScaleDimensions = new SizeF(11F, 24F);
             AutoScaleMode = AutoScaleMode.Font;
-            Controls.Add(listView);
+            Controls.Add(tableLayoutPanel);
             Name = "SpineListView";
             Size = new Size(336, 445);
             contextMenuStrip.ResumeLayout(false);
+            statusStrip.ResumeLayout(false);
+            statusStrip.PerformLayout();
+            tableLayoutPanel.ResumeLayout(false);
+            tableLayoutPanel.PerformLayout();
             ResumeLayout(false);
         }
 
@@ -287,5 +336,9 @@
         private ToolStripMenuItem toolStripMenuItem_SelectAll;
         private ToolStripSeparator toolStripSeparator4;
         private ToolStripMenuItem toolStripMenuItem_AddFromClipboard;
+        private System.Windows.Forms.Timer timer_SelectedIndexChangedDebounce;
+        private StatusStrip statusStrip;
+        private ToolStripStatusLabel toolStripStatusLabel_CountInfo;
+        private TableLayoutPanel tableLayoutPanel;
     }
 }

SpineViewer/Controls/SpineListView.cs

@@ -12,15 +12,19 @@ using SpineViewer.Spine;
 using System.Reflection;
 using System.Diagnostics;
 using System.Collections.Specialized;
+using NLog;
+using SpineViewer.Extensions;
+using SpineViewer.PropertyGridWrappers.Spine;
+using SpineViewer.Utilities;
+
 namespace SpineViewer.Controls
 {
     public partial class SpineListView : UserControl
     {
         /// <summary>
-        /// 显示骨骼信息的属性面板
+        /// 日志器
         /// </summary>
-        [Category("自定义"), Description("用于显示骨骼属性的属性页")]
-        public PropertyGrid? PropertyGrid { get; set; }
+        private readonly Logger logger = LogManager.GetCurrentClassLogger();
 
         /// <summary>
         /// Spine 列表只读视图, 访问时必须使用 lock 语句锁定视图本身
@@ -32,12 +36,23 @@ namespace SpineViewer.Controls
         /// </summary>
         private readonly List<Spine.Spine> spines = [];
 
+        /// <summary>
+        /// 用于属性页显示模型参数的包装类
+        /// </summary>
+        private readonly Dictionary<string, SpineWrapper> spinePropertyWrappers = [];
+
         public SpineListView()
         {
             InitializeComponent();
             Spines = spines.AsReadOnly();
         }
 
+        /// <summary>
+        /// 显示骨骼信息的属性面板
+        /// </summary>
+        [Category("自定义"), Description("用于显示模型属性的组合属性页")]
+        public SpinePropertyGrid? SpinePropertyGrid { get; set; }
+
         /// <summary>
         /// 选中的索引
         /// </summary>
@@ -54,8 +69,7 @@ namespace SpineViewer.Controls
         private void Insert(int index = -1)
         {
             var dialog = new Dialogs.OpenSpineDialog();
-            if (dialog.ShowDialog() != DialogResult.OK)
-                return;
+            if (dialog.ShowDialog() != DialogResult.OK) return;
             Insert(dialog.Result, index);
         }
 
@@ -73,12 +87,10 @@ namespace SpineViewer.Controls
                     index = listView.Items.Count;
 
                 // 锁定外部的读操作
-                lock (Spines)
-                {
-                    spines.Insert(index, spine);
-                    listView.SmallImageList.Images.Add(spine.ID, spine.Preview);
-                    listView.LargeImageList.Images.Add(spine.ID, spine.Preview);
-                }
+                lock (Spines) { spines.Insert(index, spine); }
+                spinePropertyWrappers[spine.ID] = new(spine);
+                listView.SmallImageList.Images.Add(spine.ID, spine.Preview);
+                listView.LargeImageList.Images.Add(spine.ID, spine.Preview);
                 listView.Items.Insert(index, new ListViewItem(spine.Name, spine.ID) { ToolTipText = spine.SkelPath });
 
                 // 选中新增项
@@ -87,12 +99,12 @@ namespace SpineViewer.Controls
             }
             catch (Exception ex)
             {
-                Program.Logger.Error(ex.ToString());
-                Program.Logger.Error("Failed to load {} {}", result.SkelPath, result.AtlasPath);
-                MessageBox.Error(ex.ToString(), "骨骼加载失败");
+                logger.Error(ex.ToString());
+                logger.Error("Failed to load {} {}", result.SkelPath, result.AtlasPath);
+                MessagePopup.Error(ex.ToString(), "骨骼加载失败");
             }
 
-            Program.LogCurrentMemoryUsage();
+            logger.LogCurrentProcessMemoryUsage();
         }
 
         /// <summary>
@@ -101,15 +113,14 @@ namespace SpineViewer.Controls
         public void BatchAdd()
         {
             var openDialog = new Dialogs.BatchOpenSpineDialog();
-            if (openDialog.ShowDialog() != DialogResult.OK)
-                return;
+            if (openDialog.ShowDialog() != DialogResult.OK) return;
             BatchAdd(openDialog.Result);
         }
 
         /// <summary>
         /// 从结果批量添加
         /// </summary>
-        public void BatchAdd(Dialogs.BatchOpenSpineDialogResult result)
+        private void BatchAdd(Dialogs.BatchOpenSpineDialogResult result)
         {
             var progressDialog = new Dialogs.ProgressDialog();
             progressDialog.DoWork += BatchAdd_Work;
@@ -147,6 +158,7 @@ namespace SpineViewer.Controls
                     var spine = Spine.Spine.New(version, skelPath);
                     var preview = spine.Preview;
                     lock (Spines) { spines.Add(spine); }
+                    spinePropertyWrappers[spine.ID] = new(spine);
                     listView.Invoke(() =>
                     {
                         listView.SmallImageList.Images.Add(spine.ID, preview);
@@ -157,8 +169,8 @@ namespace SpineViewer.Controls
                 }
                 catch (Exception ex)
                 {
-                    Program.Logger.Error(ex.ToString());
-                    Program.Logger.Error("Failed to load {}", skelPath);
+                    logger.Error(ex.ToString());
+                    logger.Error("Failed to load {}", skelPath);
                     error++;
                 }
 
@@ -176,11 +188,11 @@ namespace SpineViewer.Controls
             });
 
             if (error > 0)
-                Program.Logger.Warn("Batch load {} successfully, {} failed", success, error);
+                logger.Warn("Batch load {} successfully, {} failed", success, error);
             else
-                Program.Logger.Info("{} skel loaded successfully", success);
+                logger.Info("{} skel loaded successfully", success);
 
-            Program.LogCurrentMemoryUsage();
+            logger.LogCurrentProcessMemoryUsage();
         }
 
         /// <summary>
@@ -193,14 +205,14 @@ namespace SpineViewer.Controls
             {
                 if (File.Exists(path))
                 {
-                    if (Spine.Spine.CommonSkelSuffix.Contains(Path.GetExtension(path).ToLower()))
+                    if (SpineHelper.CommonSkelSuffix.Contains(Path.GetExtension(path).ToLower()))
                         validPaths.Add(path);
                 }
                 else if (Directory.Exists(path))
                 {
                     foreach (var file in Directory.EnumerateFiles(path, "*.*", SearchOption.AllDirectories))
                     {
-                        if (Spine.Spine.CommonSkelSuffix.Contains(Path.GetExtension(file).ToLower()))
+                        if (SpineHelper.CommonSkelSuffix.Contains(Path.GetExtension(file).ToLower()))
                             validPaths.Add(file);
                     }
                 }
@@ -210,29 +222,41 @@ namespace SpineViewer.Controls
             {
                 if (validPaths.Count > 100)
                 {
-                    if (MessageBox.Quest($"共发现 {validPaths.Count} 个可加载骨骼，数量较多，是否一次性全部加载？") == DialogResult.Cancel)
+                    if (MessagePopup.Quest($"共发现 {validPaths.Count} 个可加载骨骼，数量较多，是否一次性全部加载？") == DialogResult.Cancel)
                         return;
                 }
-                BatchAdd(new Dialogs.BatchOpenSpineDialogResult(Spine.Version.Auto, validPaths.ToArray()));
+                BatchAdd(new Dialogs.BatchOpenSpineDialogResult(SpineVersion.Auto, validPaths.ToArray()));
             }
             else if (validPaths.Count > 0)
             {
-                Insert(new Dialogs.OpenSpineDialogResult(Spine.Version.Auto, validPaths[0]));
+                Insert(new Dialogs.OpenSpineDialogResult(SpineVersion.Auto, validPaths[0]));
             }
         }
 
         private void listView_SelectedIndexChanged(object sender, EventArgs e)
+        {
+            timer_SelectedIndexChangedDebounce.Stop();
+            timer_SelectedIndexChangedDebounce.Start();
+        }
+
+        private void timer_SelectedIndexChangedDebounce_Tick(object sender, EventArgs e)
+        {
+            timer_SelectedIndexChangedDebounce.Stop();
+            _listView_SelectedIndexChanged(listView, EventArgs.Empty);
+        }
+
+        private void _listView_SelectedIndexChanged(object sender, EventArgs e)
         {
             lock (Spines)
             {
-                if (PropertyGrid is not null)
+                if (SpinePropertyGrid is not null)
                 {
                     if (listView.SelectedIndices.Count <= 0)
-                        PropertyGrid.SelectedObject = null;
+                        SpinePropertyGrid.SelectedSpines = null;
                     else if (listView.SelectedIndices.Count <= 1)
-                        PropertyGrid.SelectedObject = spines[listView.SelectedIndices[0]];
+                        SpinePropertyGrid.SelectedSpines = [spinePropertyWrappers[spines[listView.SelectedIndices[0]].ID]];
                     else
-                        PropertyGrid.SelectedObjects = listView.SelectedIndices.Cast<int>().Select(index => spines[index]).ToArray();
+                        SpinePropertyGrid.SelectedSpines = listView.SelectedIndices.Cast<int>().Select(index => spinePropertyWrappers[spines[index].ID]).ToArray();
                 }
 
                 // 标记选中的 Spine
@@ -251,6 +275,8 @@ namespace SpineViewer.Controls
 
             if (listView.SelectedItems.Count > 0)
                 listView.SelectedItems[0].EnsureVisible();
+
+            toolStripStatusLabel_CountInfo.Text = $"已选择 {listView.SelectedItems.Count} 项，共 {listView.Items.Count} 项";
         }
 
         private void listView_ItemDrag(object sender, ItemDragEventArgs e)
@@ -385,21 +411,24 @@ namespace SpineViewer.Controls
 
             if (listView.SelectedIndices.Count > 1)
             {
-                if (MessageBox.Quest($"确定移除所选 {listView.SelectedIndices.Count} 项吗？") != DialogResult.OK)
+                if (MessagePopup.Quest($"确定移除所选 {listView.SelectedIndices.Count} 项吗？") != DialogResult.OK)
                     return;
             }
 
-            foreach (var i in listView.SelectedIndices.Cast<int>().OrderByDescending(x => x))
+            lock (Spines)
             {
-                listView.Items.RemoveAt(i);
-                lock (Spines)
+                listView.BeginUpdate();
+                foreach (var i in listView.SelectedIndices.Cast<int>().OrderByDescending(x => x))
                 {
+                    listView.Items.RemoveAt(i);
                     var spine = spines[i];
                     spines.RemoveAt(i);
+                    spinePropertyWrappers.Remove(spine.ID);
                     listView.SmallImageList.Images.RemoveByKey(spine.ID);
                     listView.LargeImageList.Images.RemoveByKey(spine.ID);
                     spine.Dispose();
                 }
+                listView.EndUpdate();
             }
         }
 
@@ -482,7 +511,7 @@ namespace SpineViewer.Controls
             if (listView.Items.Count <= 0)
                 return;
 
-            if (MessageBox.Quest($"确认移除所有 {listView.Items.Count} 项吗？") != DialogResult.OK)
+            if (MessagePopup.Quest($"确认移除所有 {listView.Items.Count} 项吗？") != DialogResult.OK)
                 return;
 
             listView.Items.Clear();
@@ -490,23 +519,27 @@ namespace SpineViewer.Controls
             {
                 foreach (var spine in spines) spine.Dispose();
                 spines.Clear();
+                spinePropertyWrappers.Clear();
                 listView.SmallImageList.Images.Clear();
                 listView.LargeImageList.Images.Clear();
             }
-            if (PropertyGrid is not null)
-                PropertyGrid.SelectedObject = null;
+            if (SpinePropertyGrid is not null)
+                SpinePropertyGrid.SelectedSpines = null;
         }
 
         private void toolStripMenuItem_CopyPreview_Click(object sender, EventArgs e)
         {
             var fileDropList = new StringCollection();
+            var tempDir = Path.Combine(Path.GetTempPath(), Process.GetCurrentProcess().ProcessName);
+            Directory.CreateDirectory(tempDir);
 
             lock (Spines)
             {
                 foreach (int i in listView.SelectedIndices)
                 {
+                    var a = Process.GetCurrentProcess();
                     var spine = spines[i];
-                    var path = Path.Combine(Program.TempDir, $"{spine.ID}.png");
+                    var path = Path.Combine(tempDir, $"{spine.ID}.png");
                     spine.Preview.Save(path);
                     fileDropList.Add(path);
                 }
@@ -549,4 +582,9 @@ namespace SpineViewer.Controls
             listView.View = View.Details;
         }
     }
+
+    public class DefaultSpineConfig
+    {
+
+    }
 }

SpineViewer/Controls/SpineListView.resx

@@ -126,4 +126,10 @@
   <metadata name="imageList_SmallIcon.TrayLocation" type="System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
     <value>252, 19</value>
   </metadata>
+  <metadata name="timer_SelectedIndexChangedDebounce.TrayLocation" type="System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
+    <value>771, 24</value>
+  </metadata>
+  <metadata name="statusStrip.TrayLocation" type="System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
+    <value>1176, 24</value>
+  </metadata>
 </root>

SpineViewer/Controls/SpinePreviewer.cs

@@ -9,11 +9,31 @@ using System.Threading.Tasks;
 using System.Windows.Forms;
 using System.Security.Policy;
 using System.Diagnostics;
+using NLog;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Controls
 {
     public partial class SpinePreviewer : UserControl
     {
+        /// <summary>
+        /// 日志器
+        /// </summary>
+        private readonly Logger logger = LogManager.GetCurrentClassLogger();
+
+        public SpinePreviewer()
+        {
+            InitializeComponent();
+            RenderWindow = new(panel.Handle);
+            RenderWindow.SetActive(false);
+
+            // 设置默认参数
+            Resolution = new(2048, 2048);
+            Center = new(0, 0);
+            FlipY = true;
+            MaxFps = 30;
+        }
+
         /// <summary>
         /// 要绑定的 Spine 列表控件
         /// </summary>
@@ -31,57 +51,12 @@ namespace SpineViewer.Controls
             {
                 propertyGrid = value;
                 if (propertyGrid is not null)
-                    propertyGrid.SelectedObject = new PreviewerProperty(this);
+                    propertyGrid.SelectedObject = new PropertyGridWrappers.SpinePreviewerWrapper(this);
             }
         }
         private PropertyGrid? propertyGrid;
 
-        #region 画面参数
-
-        /// <summary>
-        /// 画面缩放最大值
-        /// </summary>
-        public const float ZOOM_MAX = 1000f;
-
-        /// <summary>
-        /// 画面缩放最小值
-        /// </summary>
-        public const float ZOOM_MIN = 0.001f;
-
-        /// <summary>
-        /// 包装类, 用于属性面板显示
-        /// </summary>
-        private class PreviewerProperty(SpinePreviewer previewer)
-        {
-            [TypeConverter(typeof(SizeConverter))]
-            [Category("[0] 导出"), DisplayName("分辨率")]
-            public Size Resolution { get => previewer.Resolution; set => previewer.Resolution = value; }
-
-            [TypeConverter(typeof(PointFConverter))]
-            [Category("[0] 导出"), DisplayName("画面中心点")]
-            public PointF Center { get => previewer.Center; set => previewer.Center = value; }
-
-            [Category("[0] 导出"), DisplayName("缩放")]
-            public float Zoom { get => previewer.Zoom; set => previewer.Zoom = value; }
-
-            [Category("[0] 导出"), DisplayName("旋转")]
-            public float Rotation { get => previewer.Rotation; set => previewer.Rotation = value; }
-
-            [Category("[0] 导出"), DisplayName("水平翻转")]
-            public bool FlipX { get => previewer.FlipX; set => previewer.FlipX = value; }
-
-            [Category("[0] 导出"), DisplayName("垂直翻转")]
-            public bool FlipY { get => previewer.FlipY; set => previewer.FlipY = value; }
-
-            [Category("[0] 导出"), DisplayName("仅渲染选中")]
-            public bool RenderSelectedOnly { get => previewer.RenderSelectedOnly; set => previewer.RenderSelectedOnly = value; }
-
-            [Category("[1] 预览"), DisplayName("显示坐标轴")]
-            public bool ShowAxis { get => previewer.ShowAxis; set => previewer.ShowAxis = value; }
-
-            [Category("[1] 预览"), DisplayName("最大帧率")]
-            public uint MaxFps { get => previewer.MaxFps; set => previewer.MaxFps = value; }
-        }
+        #region 参数属性
 
         /// <summary>
         /// 分辨率
@@ -96,8 +71,8 @@ namespace SpineViewer.Controls
                 if (value.Width <= 0) value.Width = 100;
                 if (value.Height <= 0) value.Height = 100;
 
-                float parentX = Width;
-                float parentY = Height;
+                float parentX = panel.Parent.Width;
+                float parentY = panel.Parent.Height;
                 float sizeX = value.Width;
                 float sizeY = value.Height;
 
@@ -119,7 +94,7 @@ namespace SpineViewer.Controls
                 RenderWindow.Size = new((uint)sizeX, (uint)sizeY);
 
                 // 将 view 的大小设置成于 resolution 相同的大小, 其余属性都不变
-                var view = RenderWindow.GetView();
+                using var view = RenderWindow.GetView();
                 var signX = Math.Sign(view.Size.X);
                 var signY = Math.Sign(view.Size.Y);
                 view.Size = new(value.Width * signX, value.Height * signY);
@@ -139,12 +114,13 @@ namespace SpineViewer.Controls
         {
             get
             {
-                var center = RenderWindow.GetView().Center;
+                using var view = RenderWindow.GetView();
+                var center = view.Center;
                 return new(center.X, center.Y);
             }
             set
             {
-                var view = RenderWindow.GetView();
+                using var view = RenderWindow.GetView();
                 view.Center = new(value.X, value.Y);
                 RenderWindow.SetView(view);
             }
@@ -157,11 +133,15 @@ namespace SpineViewer.Controls
         [Browsable(false)]
         public float Zoom
         {
-            get => resolution.Width / Math.Abs(RenderWindow.GetView().Size.X);
+            get
+            {
+                using var view = RenderWindow.GetView();
+                return resolution.Width / Math.Abs(view.Size.X);
+            }
             set
             {
-                value = Math.Clamp(value, ZOOM_MIN, ZOOM_MAX);
-                var view = RenderWindow.GetView();
+                value = Math.Clamp(value, 0.001f, 1000f);
+                using var view = RenderWindow.GetView();
                 var signX = Math.Sign(view.Size.X);
                 var signY = Math.Sign(view.Size.Y);
                 view.Size = new(resolution.Width / value * signX, resolution.Height / value * signY);
@@ -176,10 +156,14 @@ namespace SpineViewer.Controls
         [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
         public float Rotation
         {
-            get => RenderWindow.GetView().Rotation;
+            get
+            {
+                using var view = RenderWindow.GetView();
+                return view.Rotation;
+            }
             set
             {
-                var view = RenderWindow.GetView();
+                using var view = RenderWindow.GetView();
                 view.Rotation = value;
                 RenderWindow.SetView(view);
             }
@@ -192,10 +176,14 @@ namespace SpineViewer.Controls
         [Browsable(false)]
         public bool FlipX
         {
-            get => RenderWindow.GetView().Size.X < 0;
+            get
+            {
+                using var view = RenderWindow.GetView();
+                return view.Size.X < 0;
+            }
             set
             {
-                var view = RenderWindow.GetView();
+                using var view = RenderWindow.GetView();
                 var size = view.Size;
                 if (size.X > 0 && value || size.X < 0 && !value)
                     size.X *= -1;
@@ -211,10 +199,14 @@ namespace SpineViewer.Controls
         [Browsable(false)]
         public bool FlipY
         {
-            get => RenderWindow.GetView().Size.Y < 0;
+            get
+            {
+                using var view = RenderWindow.GetView();
+                return view.Size.Y < 0;
+            }
             set
             {
-                var view = RenderWindow.GetView();
+                using var view = RenderWindow.GetView();
                 var size = view.Size;
                 if (size.Y > 0 && value || size.Y < 0 && !value)
                     size.Y *= -1;
@@ -252,65 +244,44 @@ namespace SpineViewer.Controls
 
         #endregion
 
-        public SpinePreviewer()
-        {
-            InitializeComponent();
-            RenderWindow = new(panel.Handle);
-            RenderWindow.SetActive(false);
+        #region 渲染管理
 
-            // 设置默认参数
-            Resolution = new(2048, 2048);
-            Center = new(0, 0);
-            FlipY = true;
-            MaxFps = 30;
-        }
+        /// <summary>
+        /// 预览画面背景色
+        /// </summary>
+        private static readonly SFML.Graphics.Color BackgroundColor = new(105, 105, 105);
 
-        #region 渲染线程管理
+        /// <summary>
+        /// 预览画面坐标轴颜色
+        /// </summary>
+        private static readonly SFML.Graphics.Color AxisColor = new(220, 220, 220);
+
+        /// <summary>
+        /// 坐标轴顶点缓冲区
+        /// </summary>
+        private readonly SFML.Graphics.VertexArray AxisVertex = new(SFML.Graphics.PrimitiveType.Lines, 2);
 
         /// <summary>
         /// 渲染窗口
         /// </summary>
         private readonly SFML.Graphics.RenderWindow RenderWindow;
 
+        /// <summary>
+        /// 帧间隔计时器
+        /// </summary>
+        private readonly SFML.System.Clock Clock = new();
+
         /// <summary>
         /// 渲染任务
         /// </summary>
         private Task? task = null;
         private CancellationTokenSource? cancelToken = null;
 
-        /// <summary>
-        /// 开始渲染
-        /// </summary>
-        public void StartRender()
-        {
-            if (task is not null)
-                return;
-            cancelToken = new();
-            task = Task.Run(RenderTask, cancelToken.Token);
-            IsUpdating = true;
-        }
-
-        /// <summary>
-        /// 停止渲染
-        /// </summary>
-        public void StopRender()
-        {
-            IsUpdating = false;
-            if (task is null || cancelToken is null)
-                return;
-            cancelToken.Cancel();
-            task.Wait();
-            cancelToken = null;
-            task = null;
-        }
-
-        #endregion
-
-        #region 渲染更新管理
-
         /// <summary>
         /// 是否更新画面
         /// </summary>
+        [DesignerSerializationVisibility(DesignerSerializationVisibility.Hidden)]
+        [Browsable(false)]
         public bool IsUpdating
         {
             get => isUpdating;
@@ -337,24 +308,30 @@ namespace SpineViewer.Controls
         private object _forwardDeltaLock = new();
 
         /// <summary>
-        /// 预览画面背景色
+        /// 开始渲染
         /// </summary>
-        private static readonly SFML.Graphics.Color BackgroundColor = new(105, 105, 105);
+        public void StartRender()
+        {
+            if (task is not null)
+                return;
+            cancelToken = new();
+            task = Task.Run(RenderTask, cancelToken.Token);
+            IsUpdating = true;
+        }
 
         /// <summary>
-        /// 预览画面坐标轴颜色
+        /// 停止渲染
         /// </summary>
-        private static readonly SFML.Graphics.Color AxisColor = new(220, 220, 220);
-
-        /// <summary>
-        /// 坐标轴顶点缓冲区
-        /// </summary>
-        private readonly SFML.Graphics.VertexArray AxisVertex = new(SFML.Graphics.PrimitiveType.Lines, 2);
-
-        /// <summary>
-        /// 帧间隔计时器
-        /// </summary>
-        private readonly SFML.System.Clock Clock = new();
+        public void StopRender()
+        {
+            IsUpdating = false;
+            if (task is null || cancelToken is null)
+                return;
+            cancelToken.Cancel();
+            task.Wait();
+            cancelToken = null;
+            task = null;
+        }
 
         /// <summary>
         /// 渲染任务
@@ -422,6 +399,12 @@ namespace SpineViewer.Controls
                     RenderWindow.Display();
                 }
             }
+            catch (Exception ex)
+            {
+                logger.Fatal(ex);
+                logger.Fatal("Render task stopped");
+                MessagePopup.Error(ex.ToString(), "预览画面已停止渲染");
+            }
             finally
             {
                 RenderWindow.SetActive(false);
@@ -579,7 +562,7 @@ namespace SpineViewer.Controls
             // 右键高优先级, 结束画面拖动模式
             if ((e.Button & MouseButtons.Right) != 0)
             {
-                SpineListView?.PropertyGrid?.Refresh();
+                SpineListView?.SpinePropertyGrid?.Refresh();
 
                 draggingSrc = null;
                 Cursor = Cursors.Default;
@@ -589,7 +572,7 @@ namespace SpineViewer.Controls
             else if ((e.Button & MouseButtons.Left) != 0 && (MouseButtons & MouseButtons.Right) == 0)
             {
                 draggingSrc = null;
-                SpineListView?.PropertyGrid?.Refresh();
+                SpineListView?.SpinePropertyGrid?.Refresh();
             }
         }
 
@@ -607,7 +590,7 @@ namespace SpineViewer.Controls
                 lock (SpineListView.Spines)
                 {
                     foreach (var spine in SpineListView.Spines)
-                        spine.CurrentAnimation = spine.CurrentAnimation;
+                        spine.ResetAnimationsTime();
                 }
             }
         }
@@ -619,7 +602,7 @@ namespace SpineViewer.Controls
                 lock (SpineListView.Spines)
                 {
                     foreach (var spine in SpineListView.Spines)
-                        spine.CurrentAnimation = spine.CurrentAnimation;
+                        spine.ResetAnimationsTime();
                 }
             }
             IsUpdating = true;

SpineViewer/Controls/SpinePropertyGrid.Designer.cs

@@ -0,0 +1,300 @@
+namespace SpineViewer.Controls
+{
+    partial class SpinePropertyGrid
+    {
+        /// <summary> 
+        /// 必需的设计器变量。
+        /// </summary>
+        private System.ComponentModel.IContainer components = null;
+
+        /// <summary> 
+        /// 清理所有正在使用的资源。
+        /// </summary>
+        /// <param name="disposing">如果应释放托管资源，为 true；否则为 false。</param>
+        protected override void Dispose(bool disposing)
+        {
+            if (disposing && (components != null))
+            {
+                components.Dispose();
+            }
+            base.Dispose(disposing);
+        }
+
+        #region 组件设计器生成的代码
+
+        /// <summary> 
+        /// 设计器支持所需的方法 - 不要修改
+        /// 使用代码编辑器修改此方法的内容。
+        /// </summary>
+        private void InitializeComponent()
+        {
+            components = new System.ComponentModel.Container();
+            tabControl = new TabControl();
+            tabPage_BaseInfo = new TabPage();
+            propertyGrid_BaseInfo = new PropertyGrid();
+            tabPage_Render = new TabPage();
+            propertyGrid_Render = new PropertyGrid();
+            tabPage_Transform = new TabPage();
+            propertyGrid_Transform = new PropertyGrid();
+            tabPage_Skin = new TabPage();
+            propertyGrid_Skin = new PropertyGrid();
+            contextMenuStrip_Skin = new ContextMenuStrip(components);
+            toolStripMenuItem_AddSkin = new ToolStripMenuItem();
+            toolStripMenuItem_RemoveSkin = new ToolStripMenuItem();
+            tabPage_Animation = new TabPage();
+            propertyGrid_Animation = new PropertyGrid();
+            contextMenuStrip_Animation = new ContextMenuStrip(components);
+            toolStripMenuItem_AddAnimation = new ToolStripMenuItem();
+            toolStripMenuItem_RemoveAnimation = new ToolStripMenuItem();
+            tabPage_Debug = new TabPage();
+            propertyGrid_Debug = new PropertyGrid();
+            tabControl.SuspendLayout();
+            tabPage_BaseInfo.SuspendLayout();
+            tabPage_Render.SuspendLayout();
+            tabPage_Transform.SuspendLayout();
+            tabPage_Skin.SuspendLayout();
+            contextMenuStrip_Skin.SuspendLayout();
+            tabPage_Animation.SuspendLayout();
+            contextMenuStrip_Animation.SuspendLayout();
+            tabPage_Debug.SuspendLayout();
+            SuspendLayout();
+            // 
+            // tabControl
+            // 
+            tabControl.Alignment = TabAlignment.Bottom;
+            tabControl.Controls.Add(tabPage_BaseInfo);
+            tabControl.Controls.Add(tabPage_Render);
+            tabControl.Controls.Add(tabPage_Transform);
+            tabControl.Controls.Add(tabPage_Skin);
+            tabControl.Controls.Add(tabPage_Animation);
+            tabControl.Controls.Add(tabPage_Debug);
+            tabControl.Dock = DockStyle.Fill;
+            tabControl.ItemSize = new Size(100, 35);
+            tabControl.Location = new Point(0, 0);
+            tabControl.Multiline = true;
+            tabControl.Name = "tabControl";
+            tabControl.Padding = new Point(0, 0);
+            tabControl.SelectedIndex = 0;
+            tabControl.Size = new Size(372, 448);
+            tabControl.SizeMode = TabSizeMode.FillToRight;
+            tabControl.TabIndex = 0;
+            // 
+            // tabPage_BaseInfo
+            // 
+            tabPage_BaseInfo.BackColor = SystemColors.Control;
+            tabPage_BaseInfo.Controls.Add(propertyGrid_BaseInfo);
+            tabPage_BaseInfo.Location = new Point(4, 4);
+            tabPage_BaseInfo.Margin = new Padding(0);
+            tabPage_BaseInfo.Name = "tabPage_BaseInfo";
+            tabPage_BaseInfo.Size = new Size(364, 370);
+            tabPage_BaseInfo.TabIndex = 0;
+            tabPage_BaseInfo.Text = "基本信息";
+            // 
+            // propertyGrid_BaseInfo
+            // 
+            propertyGrid_BaseInfo.Dock = DockStyle.Fill;
+            propertyGrid_BaseInfo.HelpVisible = false;
+            propertyGrid_BaseInfo.Location = new Point(0, 0);
+            propertyGrid_BaseInfo.Name = "propertyGrid_BaseInfo";
+            propertyGrid_BaseInfo.PropertySort = PropertySort.Alphabetical;
+            propertyGrid_BaseInfo.Size = new Size(364, 370);
+            propertyGrid_BaseInfo.TabIndex = 0;
+            propertyGrid_BaseInfo.ToolbarVisible = false;
+            // 
+            // tabPage_Render
+            // 
+            tabPage_Render.BackColor = SystemColors.Control;
+            tabPage_Render.Controls.Add(propertyGrid_Render);
+            tabPage_Render.Location = new Point(4, 4);
+            tabPage_Render.Margin = new Padding(0);
+            tabPage_Render.Name = "tabPage_Render";
+            tabPage_Render.Size = new Size(437, 405);
+            tabPage_Render.TabIndex = 1;
+            tabPage_Render.Text = "渲染";
+            // 
+            // propertyGrid_Render
+            // 
+            propertyGrid_Render.Dock = DockStyle.Fill;
+            propertyGrid_Render.HelpVisible = false;
+            propertyGrid_Render.Location = new Point(0, 0);
+            propertyGrid_Render.Name = "propertyGrid_Render";
+            propertyGrid_Render.PropertySort = PropertySort.Alphabetical;
+            propertyGrid_Render.Size = new Size(437, 405);
+            propertyGrid_Render.TabIndex = 1;
+            propertyGrid_Render.ToolbarVisible = false;
+            // 
+            // tabPage_Transform
+            // 
+            tabPage_Transform.BackColor = SystemColors.Control;
+            tabPage_Transform.Controls.Add(propertyGrid_Transform);
+            tabPage_Transform.Location = new Point(4, 4);
+            tabPage_Transform.Margin = new Padding(0);
+            tabPage_Transform.Name = "tabPage_Transform";
+            tabPage_Transform.Size = new Size(437, 405);
+            tabPage_Transform.TabIndex = 2;
+            tabPage_Transform.Text = "变换";
+            // 
+            // propertyGrid_Transform
+            // 
+            propertyGrid_Transform.Dock = DockStyle.Fill;
+            propertyGrid_Transform.HelpVisible = false;
+            propertyGrid_Transform.Location = new Point(0, 0);
+            propertyGrid_Transform.Name = "propertyGrid_Transform";
+            propertyGrid_Transform.PropertySort = PropertySort.Alphabetical;
+            propertyGrid_Transform.Size = new Size(437, 405);
+            propertyGrid_Transform.TabIndex = 1;
+            propertyGrid_Transform.ToolbarVisible = false;
+            // 
+            // tabPage_Skin
+            // 
+            tabPage_Skin.BackColor = SystemColors.Control;
+            tabPage_Skin.Controls.Add(propertyGrid_Skin);
+            tabPage_Skin.Location = new Point(4, 4);
+            tabPage_Skin.Margin = new Padding(0);
+            tabPage_Skin.Name = "tabPage_Skin";
+            tabPage_Skin.Size = new Size(437, 405);
+            tabPage_Skin.TabIndex = 3;
+            tabPage_Skin.Text = "皮肤";
+            // 
+            // propertyGrid_Skin
+            // 
+            propertyGrid_Skin.ContextMenuStrip = contextMenuStrip_Skin;
+            propertyGrid_Skin.Dock = DockStyle.Fill;
+            propertyGrid_Skin.HelpVisible = false;
+            propertyGrid_Skin.Location = new Point(0, 0);
+            propertyGrid_Skin.Name = "propertyGrid_Skin";
+            propertyGrid_Skin.PropertySort = PropertySort.NoSort;
+            propertyGrid_Skin.Size = new Size(437, 405);
+            propertyGrid_Skin.TabIndex = 1;
+            propertyGrid_Skin.ToolbarVisible = false;
+            // 
+            // contextMenuStrip_Skin
+            // 
+            contextMenuStrip_Skin.ImageScalingSize = new Size(24, 24);
+            contextMenuStrip_Skin.Items.AddRange(new ToolStripItem[] { toolStripMenuItem_AddSkin, toolStripMenuItem_RemoveSkin });
+            contextMenuStrip_Skin.Name = "contextMenuStrip1";
+            contextMenuStrip_Skin.Size = new Size(117, 64);
+            contextMenuStrip_Skin.Opening += contextMenuStrip_Skin_Opening;
+            // 
+            // toolStripMenuItem_AddSkin
+            // 
+            toolStripMenuItem_AddSkin.Name = "toolStripMenuItem_AddSkin";
+            toolStripMenuItem_AddSkin.Size = new Size(116, 30);
+            toolStripMenuItem_AddSkin.Text = "添加";
+            toolStripMenuItem_AddSkin.Click += toolStripMenuItem_AddSkin_Click;
+            // 
+            // toolStripMenuItem_RemoveSkin
+            // 
+            toolStripMenuItem_RemoveSkin.Name = "toolStripMenuItem_RemoveSkin";
+            toolStripMenuItem_RemoveSkin.Size = new Size(116, 30);
+            toolStripMenuItem_RemoveSkin.Text = "移除";
+            toolStripMenuItem_RemoveSkin.Click += toolStripMenuItem_RemoveSkin_Click;
+            // 
+            // tabPage_Animation
+            // 
+            tabPage_Animation.BackColor = SystemColors.Control;
+            tabPage_Animation.Controls.Add(propertyGrid_Animation);
+            tabPage_Animation.Location = new Point(4, 4);
+            tabPage_Animation.Margin = new Padding(0);
+            tabPage_Animation.Name = "tabPage_Animation";
+            tabPage_Animation.Size = new Size(437, 405);
+            tabPage_Animation.TabIndex = 4;
+            tabPage_Animation.Text = "动画";
+            // 
+            // propertyGrid_Animation
+            // 
+            propertyGrid_Animation.ContextMenuStrip = contextMenuStrip_Animation;
+            propertyGrid_Animation.Dock = DockStyle.Fill;
+            propertyGrid_Animation.HelpVisible = false;
+            propertyGrid_Animation.Location = new Point(0, 0);
+            propertyGrid_Animation.Name = "propertyGrid_Animation";
+            propertyGrid_Animation.PropertySort = PropertySort.NoSort;
+            propertyGrid_Animation.Size = new Size(437, 405);
+            propertyGrid_Animation.TabIndex = 1;
+            propertyGrid_Animation.ToolbarVisible = false;
+            // 
+            // contextMenuStrip_Animation
+            // 
+            contextMenuStrip_Animation.ImageScalingSize = new Size(24, 24);
+            contextMenuStrip_Animation.Items.AddRange(new ToolStripItem[] { toolStripMenuItem_AddAnimation, toolStripMenuItem_RemoveAnimation });
+            contextMenuStrip_Animation.Name = "contextMenuStrip1";
+            contextMenuStrip_Animation.Size = new Size(117, 64);
+            contextMenuStrip_Animation.Opening += contextMenuStrip_Animation_Opening;
+            // 
+            // toolStripMenuItem_AddAnimation
+            // 
+            toolStripMenuItem_AddAnimation.Name = "toolStripMenuItem_AddAnimation";
+            toolStripMenuItem_AddAnimation.Size = new Size(116, 30);
+            toolStripMenuItem_AddAnimation.Text = "添加";
+            toolStripMenuItem_AddAnimation.Click += toolStripMenuItem_AddAnimation_Click;
+            // 
+            // toolStripMenuItem_RemoveAnimation
+            // 
+            toolStripMenuItem_RemoveAnimation.Name = "toolStripMenuItem_RemoveAnimation";
+            toolStripMenuItem_RemoveAnimation.Size = new Size(116, 30);
+            toolStripMenuItem_RemoveAnimation.Text = "移除";
+            toolStripMenuItem_RemoveAnimation.Click += toolStripMenuItem_RemoveAnimation_Click;
+            // 
+            // tabPage_Debug
+            // 
+            tabPage_Debug.BackColor = SystemColors.Control;
+            tabPage_Debug.Controls.Add(propertyGrid_Debug);
+            tabPage_Debug.Location = new Point(4, 4);
+            tabPage_Debug.Name = "tabPage_Debug";
+            tabPage_Debug.Size = new Size(437, 405);
+            tabPage_Debug.TabIndex = 5;
+            tabPage_Debug.Text = "调试";
+            // 
+            // propertyGrid_Debug
+            // 
+            propertyGrid_Debug.Dock = DockStyle.Fill;
+            propertyGrid_Debug.HelpVisible = false;
+            propertyGrid_Debug.Location = new Point(0, 0);
+            propertyGrid_Debug.Name = "propertyGrid_Debug";
+            propertyGrid_Debug.PropertySort = PropertySort.NoSort;
+            propertyGrid_Debug.Size = new Size(437, 405);
+            propertyGrid_Debug.TabIndex = 2;
+            propertyGrid_Debug.ToolbarVisible = false;
+            // 
+            // SpinePropertyGrid
+            // 
+            AutoScaleDimensions = new SizeF(11F, 24F);
+            AutoScaleMode = AutoScaleMode.Font;
+            Controls.Add(tabControl);
+            Name = "SpinePropertyGrid";
+            Size = new Size(372, 448);
+            tabControl.ResumeLayout(false);
+            tabPage_BaseInfo.ResumeLayout(false);
+            tabPage_Render.ResumeLayout(false);
+            tabPage_Transform.ResumeLayout(false);
+            tabPage_Skin.ResumeLayout(false);
+            contextMenuStrip_Skin.ResumeLayout(false);
+            tabPage_Animation.ResumeLayout(false);
+            contextMenuStrip_Animation.ResumeLayout(false);
+            tabPage_Debug.ResumeLayout(false);
+            ResumeLayout(false);
+        }
+
+        #endregion
+
+        private TabControl tabControl;
+        private TabPage tabPage_BaseInfo;
+        private TabPage tabPage_Render;
+        private TabPage tabPage_Transform;
+        private TabPage tabPage_Skin;
+        private TabPage tabPage_Animation;
+        private PropertyGrid propertyGrid_BaseInfo;
+        private PropertyGrid propertyGrid_Render;
+        private PropertyGrid propertyGrid_Transform;
+        private PropertyGrid propertyGrid_Skin;
+        private PropertyGrid propertyGrid_Animation;
+        private ContextMenuStrip contextMenuStrip_Skin;
+        private ContextMenuStrip contextMenuStrip_Animation;
+        private ToolStripMenuItem toolStripMenuItem_AddSkin;
+        private ToolStripMenuItem toolStripMenuItem_RemoveSkin;
+        private ToolStripMenuItem toolStripMenuItem_AddAnimation;
+        private ToolStripMenuItem toolStripMenuItem_RemoveAnimation;
+        private TabPage tabPage_Debug;
+        private PropertyGrid propertyGrid_Debug;
+    }
+}

SpineViewer/Controls/SpinePropertyGrid.cs

@@ -0,0 +1,129 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Drawing;
+using System.Data;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Windows.Forms;
+using SpineViewer.PropertyGridWrappers.Spine;
+using SpineViewer.Utilities;
+
+namespace SpineViewer.Controls
+{
+    public partial class SpinePropertyGrid : UserControl
+    {
+        public SpinePropertyGrid()
+        {
+            InitializeComponent();
+        }
+
+        /// <summary>
+        /// 设置选中的对象列表, 可以赋值 null 来清空选中, 行为与 PropertyGrid.SelectedObjects 类似
+        /// </summary>
+        public SpineWrapper[] SelectedSpines
+        {
+            get => selectedSpines ?? [];
+            set
+            {
+                if (value is null || value.Length <= 0)
+                {
+                    selectedSpines = null;
+                    propertyGrid_BaseInfo.SelectedObject = null;
+                    propertyGrid_Render.SelectedObject = null;
+                    propertyGrid_Transform.SelectedObject = null;
+                    propertyGrid_Skin.SelectedObject = null;
+                    propertyGrid_Animation.SelectedObject = null;
+                    propertyGrid_Debug.SelectedObject = null;
+                }
+                else
+                {
+                    selectedSpines = value;
+                    propertyGrid_BaseInfo.SelectedObjects = value.Select(e => e.BaseInfo).ToArray();
+                    propertyGrid_Render.SelectedObjects = value.Select(e => e.Render).ToArray();
+                    propertyGrid_Transform.SelectedObjects = value.Select(e => e.Transform).ToArray();
+                    propertyGrid_Skin.SelectedObjects = value.Select(e => e.Skin).ToArray();
+                    propertyGrid_Animation.SelectedObjects = value.Select(e => e.Animation).ToArray();
+                    propertyGrid_Debug.SelectedObjects = value.Select(e => e.Debug).ToArray();
+                }
+            }
+        }
+        private SpineWrapper[]? selectedSpines = null;
+
+        private void contextMenuStrip_Skin_Opening(object sender, CancelEventArgs e)
+        {
+            if (selectedSpines?.Length == 1)
+            {
+                toolStripMenuItem_AddSkin.Enabled = true;
+                toolStripMenuItem_RemoveSkin.Enabled = propertyGrid_Skin.SelectedGridItem.Value is SkinWrapper;
+            }
+            else
+            {
+                toolStripMenuItem_AddSkin.Enabled = false;
+                toolStripMenuItem_RemoveSkin.Enabled = false;
+            }
+        }
+
+        private void contextMenuStrip_Animation_Opening(object sender, CancelEventArgs e)
+        {
+            if (selectedSpines?.Length == 1)
+            {
+                toolStripMenuItem_AddAnimation.Enabled = true;
+                toolStripMenuItem_RemoveAnimation.Enabled = propertyGrid_Animation.SelectedGridItem.Value is TrackWrapper;
+            }
+            else
+            {
+                toolStripMenuItem_AddAnimation.Enabled = false;
+                toolStripMenuItem_RemoveAnimation.Enabled = false;
+            }
+        }
+
+        private void toolStripMenuItem_AddSkin_Click(object sender, EventArgs e)
+        {
+            if (selectedSpines?.Length != 1) return;
+
+            var spine = selectedSpines[0].Skin.Spine;
+
+            if (spine.SkinNames.Count <= 0)
+            {
+                MessagePopup.Info("没有可用的皮肤");
+                return;
+            }
+
+            spine.LoadSkin(spine.SkinNames[0]);
+            propertyGrid_Skin.Refresh();
+        }
+
+        private void toolStripMenuItem_RemoveSkin_Click(object sender, EventArgs e)
+        {
+            if (selectedSpines?.Length != 1) return;
+
+            if (propertyGrid_Skin.SelectedGridItem.Value is SkinWrapper wrapper)
+            {
+                selectedSpines[0].Skin.Spine.UnloadSkin(wrapper.Index);
+                propertyGrid_Skin.Refresh();
+            }
+        }
+
+        private void toolStripMenuItem_AddAnimation_Click(object sender, EventArgs e)
+        {
+            if (selectedSpines?.Length != 1) return;
+
+            var spine = selectedSpines[0].Animation.Spine;
+            spine.SetAnimation(spine.GetTrackIndices().Max() + 1, spine.AnimationNames[0]);
+            propertyGrid_Animation.Refresh();
+        }
+
+        private void toolStripMenuItem_RemoveAnimation_Click(object sender, EventArgs e)
+        {
+            if (selectedSpines?.Length != 1) return;
+
+            if (propertyGrid_Animation.SelectedGridItem.Value is TrackWrapper wrapper)
+            {
+                selectedSpines[0].Animation.Spine.ClearTrack(wrapper.Index);
+                propertyGrid_Animation.Refresh();
+            }
+        }
+    }
+}

SpineViewer/Controls/SpinePropertyGrid.resx

@@ -0,0 +1,126 @@
+<?xml version="1.0" encoding="utf-8"?>
+<root>
+  <!--
+    Microsoft ResX Schema
+
+    Version 2.0
+
+    The primary goals of this format is to allow a simple XML format
+    that is mostly human readable. The generation and parsing of the
+    various data types are done through the TypeConverter classes
+    associated with the data types.
+
+    Example:
+
+    ... ado.net/XML headers & schema ...
+    <resheader name="resmimetype">text/microsoft-resx</resheader>
+    <resheader name="version">2.0</resheader>
+    <resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader>
+    <resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader>
+    <data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data>
+    <data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data>
+    <data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64">
+        <value>[base64 mime encoded serialized .NET Framework object]</value>
+    </data>
+    <data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
+        <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
+        <comment>This is a comment</comment>
+    </data>
+
+    There are any number of "resheader" rows that contain simple
+    name/value pairs.
+
+    Each data row contains a name, and value. The row also contains a
+    type or mimetype. Type corresponds to a .NET class that support
+    text/value conversion through the TypeConverter architecture.
+    Classes that don't support this are serialized and stored with the
+    mimetype set.
+
+    The mimetype is used for serialized objects, and tells the
+    ResXResourceReader how to depersist the object. This is currently not
+    extensible. For a given mimetype the value must be set accordingly:
+
+    Note - application/x-microsoft.net.object.binary.base64 is the format
+    that the ResXResourceWriter will generate, however the reader can
+    read any of the formats listed below.
+
+    mimetype: application/x-microsoft.net.object.binary.base64
+    value   : The object must be serialized with
+            : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.soap.base64
+    value   : The object must be serialized with
+            : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.bytearray.base64
+    value   : The object must be serialized into a byte array
+            : using a System.ComponentModel.TypeConverter
+            : and then encoded with base64 encoding.
+    -->
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <metadata name="contextMenuStrip_Skin.TrayLocation" type="System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
+    <value>29, 26</value>
+  </metadata>
+  <metadata name="contextMenuStrip_Animation.TrayLocation" type="System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
+    <value>318, 25</value>
+  </metadata>
+</root>

SpineViewer/Dialogs/AboutDialog.cs

@@ -1,4 +1,5 @@
-using System;
+using SpineViewer.Utilities;
+using System;
 using System.Collections.Generic;
 using System.ComponentModel;
 using System.Diagnostics;
@@ -15,12 +16,20 @@ namespace SpineViewer.Dialogs
         public AboutDialog()
         {
             InitializeComponent();
-            Text = $"关于 {Program.Name}";
+            Text = $"关于 {ProgramName}";
             label_Version.Text = $"v{InformationalVersion}";
         }
 
-        public string InformationalVersion => 
-            Assembly.GetExecutingAssembly().GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+        public string ProgramName => Process.GetCurrentProcess().ProcessName;
+
+        public string InformationalVersion
+            => Assembly.GetExecutingAssembly().GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+
+        public string ProgramUrl
+        {
+            get => linkLabel_RepoUrl.Text;
+            set => linkLabel_RepoUrl.Text = value;
+        }
 
         private void linkLabel_RepoUrl_LinkClicked(object sender, LinkLabelLinkClickedEventArgs e)
         {
@@ -32,7 +41,7 @@ namespace SpineViewer.Dialogs
             else
             {
                 Clipboard.SetText(url);
-                MessageBox.Info("链接已复制到剪贴板，请前往浏览器进行访问");
+                MessagePopup.Info("链接已复制到剪贴板，请前往浏览器进行访问");
             }
         }
     }

SpineViewer/Dialogs/BatchOpenSpineDialog.cs

@@ -1,4 +1,5 @@
 using SpineViewer.Spine;
+using SpineViewer.Utilities;
 using System;
 using System.Collections.Generic;
 using System.ComponentModel;
@@ -21,21 +22,21 @@ namespace SpineViewer.Dialogs
         public BatchOpenSpineDialog()
         {
             InitializeComponent();
-            comboBox_Version.DataSource = VersionHelper.Names.ToList();
+            comboBox_Version.DataSource = SpineHelper.Names.ToList();
             comboBox_Version.DisplayMember = "Value";
             comboBox_Version.ValueMember = "Key";
-            comboBox_Version.SelectedValue = Spine.Version.Auto;
+            comboBox_Version.SelectedValue = SpineVersion.Auto;
         }
 
         private void button_Ok_Click(object sender, EventArgs e)
         {
-            var version = (Spine.Version)comboBox_Version.SelectedValue;
+            var version = (SpineVersion)comboBox_Version.SelectedValue;
 
             var items = skelFileListBox.Items;
 
             if (items.Count <= 0)
             {
-                MessageBox.Info("未选择任何文件");
+                MessagePopup.Info("未选择任何文件");
                 return;
             }
 
@@ -43,14 +44,14 @@ namespace SpineViewer.Dialogs
             {
                 if (!File.Exists(p))
                 {
-                    MessageBox.Info($"{p}", "skel文件不存在");
+                    MessagePopup.Info($"{p}", "skel文件不存在");
                     return;
                 }
             }
 
-            if (version != Spine.Version.Auto && !Spine.Spine.ImplementedVersions.Contains(version))
+            if (version != SpineVersion.Auto && !Spine.Spine.HasImplementation(version))
             {
-                MessageBox.Info($"{version.GetName()} 版本尚未实现（咕咕咕~）");
+                MessagePopup.Info($"{version.GetName()} 版本尚未实现（咕咕咕~）");
                 return;
             }
 
@@ -67,12 +68,12 @@ namespace SpineViewer.Dialogs
     /// <summary>
     /// 批量打开对话框结果
     /// </summary>
-    public class BatchOpenSpineDialogResult(Spine.Version version, string[] skelPaths)
+    public class BatchOpenSpineDialogResult(SpineVersion version, string[] skelPaths)
     {
         /// <summary>
         /// 版本
         /// </summary>
-        public Spine.Version Version => version;
+        public SpineVersion Version => version;
 
         /// <summary>
         /// 路径列表

SpineViewer/Dialogs/ConvertFileFormatDialog.Designer.cs

@@ -44,7 +44,6 @@
             button_Cancel = new Button();
             label2 = new Label();
             skelFileListBox = new SpineViewer.Controls.SkelFileListBox();
-            openFileDialog_Skel = new OpenFileDialog();
             panel.SuspendLayout();
             tableLayoutPanel1.SuspendLayout();
             flowLayoutPanel_TargetFormat.SuspendLayout();
@@ -238,14 +237,6 @@
             skelFileListBox.Size = new Size(945, 264);
             skelFileListBox.TabIndex = 20;
             // 
-            // openFileDialog_Skel
-            // 
-            openFileDialog_Skel.AddExtension = false;
-            openFileDialog_Skel.AddToRecent = false;
-            openFileDialog_Skel.Filter = "skel 文件 (*.skel; *.json)|*.skel;*.json|二进制文件 (*.skel)|*.skel|文本文件 (*.json)|*.json|所有文件 (*.*)|*.*";
-            openFileDialog_Skel.Multiselect = true;
-            openFileDialog_Skel.Title = "批量选择skel文件";
-            // 
             // ConvertFileFormatDialog
             // 
             AcceptButton = button_Ok;
@@ -281,7 +272,6 @@
         private TableLayoutPanel tableLayoutPanel2;
         private Button button_Ok;
         private Button button_Cancel;
-        private OpenFileDialog openFileDialog_Skel;
         private Label label1;
         private Label label2;
         private FlowLayoutPanel flowLayoutPanel_TargetFormat;

SpineViewer/Dialogs/ConvertFileFormatDialog.cs

@@ -1,4 +1,5 @@
 using SpineViewer.Spine;
+using SpineViewer.Utilities;
 using System;
 using System.Collections.Generic;
 using System.ComponentModel;
@@ -22,31 +23,31 @@ namespace SpineViewer.Dialogs
         {
             InitializeComponent();
 
-            comboBox_SourceVersion.DataSource = VersionHelper.Names.ToList();
+            comboBox_SourceVersion.DataSource = SpineHelper.Names.ToList();
             comboBox_SourceVersion.DisplayMember = "Value";
             comboBox_SourceVersion.ValueMember = "Key";
-            comboBox_SourceVersion.SelectedValue = Spine.Version.Auto;
+            comboBox_SourceVersion.SelectedValue = SpineVersion.Auto;
 
             // 目标版本不包含自动
-            var versionsWithoutAuto = VersionHelper.Names.ToDictionary();
-            versionsWithoutAuto.Remove(Spine.Version.Auto);
+            var versionsWithoutAuto = SpineHelper.Names.ToDictionary();
+            versionsWithoutAuto.Remove(SpineVersion.Auto);
             comboBox_TargetVersion.DataSource = versionsWithoutAuto.ToList();
             comboBox_TargetVersion.DisplayMember = "Value";
             comboBox_TargetVersion.ValueMember = "Key";
-            comboBox_TargetVersion.SelectedValue = Spine.Version.V38;
+            comboBox_TargetVersion.SelectedValue = SpineVersion.V38;
         }
 
         private void button_Ok_Click(object sender, EventArgs e)
         {
-            var sourceVersion = (Spine.Version)comboBox_SourceVersion.SelectedValue;
-            var targetVersion = (Spine.Version)comboBox_TargetVersion.SelectedValue;
+            var sourceVersion = (SpineVersion)comboBox_SourceVersion.SelectedValue;
+            var targetVersion = (SpineVersion)comboBox_TargetVersion.SelectedValue;
             var jsonTarget = radioButton_JsonTarget.Checked;
 
             var items = skelFileListBox.Items;
 
             if (items.Count <= 0)
             {
-                MessageBox.Info("未选择任何文件");
+                MessagePopup.Info("未选择任何文件");
                 return;
             }
 
@@ -54,20 +55,20 @@ namespace SpineViewer.Dialogs
             {
                 if (!File.Exists(p))
                 {
-                    MessageBox.Info($"{p}", "skel文件不存在");
+                    MessagePopup.Info($"{p}", "skel文件不存在");
                     return;
                 }
             }
 
-            if (sourceVersion != Spine.Version.Auto && !SkeletonConverter.ImplementedVersions.Contains(sourceVersion))
+            if (sourceVersion != SpineVersion.Auto && !SkeletonConverter.HasImplementation(sourceVersion))
             {
-                MessageBox.Info($"{sourceVersion.GetName()} 版本尚未实现（咕咕咕~）");
+                MessagePopup.Info($"{sourceVersion.GetName()} 版本尚未实现（咕咕咕~）");
                 return;
             }
 
-            if (!SkeletonConverter.ImplementedVersions.Contains(targetVersion))
+            if (!SkeletonConverter.HasImplementation(targetVersion))
             {
-                MessageBox.Info($"{targetVersion.GetName()} 版本尚未实现（咕咕咕~）");
+                MessagePopup.Info($"{targetVersion.GetName()} 版本尚未实现（咕咕咕~）");
                 return;
             }
 
@@ -84,7 +85,7 @@ namespace SpineViewer.Dialogs
     /// <summary>
     /// 文件格式转换对话框结果包装类
     /// </summary>
-    public class ConvertFileFormatDialogResult(string[] skelPaths, Spine.Version sourceVersion, Spine.Version targetVersion, bool jsonTarget)
+    public class ConvertFileFormatDialogResult(string[] skelPaths, SpineVersion sourceVersion, SpineVersion targetVersion, bool jsonTarget)
     {
         /// <summary>
         /// 骨骼文件路径列表
@@ -94,12 +95,12 @@ namespace SpineViewer.Dialogs
         /// <summary>
         /// 源版本
         /// </summary>
-        public Spine.Version SourceVersion => sourceVersion;
+        public SpineVersion SourceVersion => sourceVersion;
 
         /// <summary>
         /// 目标版本
         /// </summary>
-        public Spine.Version TargetVersion => targetVersion;
+        public SpineVersion TargetVersion => targetVersion;
 
         /// <summary>
         /// 目标格式是否为 Json

SpineViewer/Dialogs/ConvertFileFormatDialog.resx

@@ -117,9 +117,6 @@
   <resheader name="writer">
     <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
   </resheader>
-  <metadata name="openFileDialog_Skel.TrayLocation" type="System.Drawing.Point, System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a">
-    <value>92, 26</value>
-  </metadata>
   <assembly alias="System.Drawing" name="System.Drawing, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b03f5f7f11d50a3a" />
   <data name="$this.Icon" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
     <value>

SpineViewer/Dialogs/DiagnosticsDialog.cs

@@ -1,4 +1,5 @@
 using Microsoft.Win32;
+using SpineViewer.Utilities;
 using System;
 using System.Collections.Generic;
 using System.ComponentModel;
@@ -26,7 +27,29 @@ namespace SpineViewer.Dialogs
 
         private class DiagnosticsInformation
         {
-            [Category("Versions")]
+            [Category("Hardware")]
+            public string CPU
+            {
+                get => Registry.GetValue(@"HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0", "ProcessorNameString", "Unknown").ToString();
+            }
+
+            [Category("Hardware")]
+            public string Memory
+            {
+                get => $"{new Microsoft.VisualBasic.Devices.ComputerInfo().TotalPhysicalMemory / 1024f / 1024f / 1024f:F1} GB";
+            }
+
+            [Category("Hardware")]
+            public string GPU
+            {
+                get
+                {
+                    var searcher = new ManagementObjectSearcher("SELECT Name FROM Win32_VideoController");
+                    return string.Join("; ", searcher.Get().Cast<ManagementObject>().Select(mo => mo["Name"].ToString()));
+                }
+            }
+
+            [Category("Software")]
             public string WindowsVersion
             {
                 get
@@ -39,44 +62,28 @@ namespace SpineViewer.Dialogs
                 }
             }
 
-            [Category("Versions")]
+            [Category("Software")]
             public string Version
             {
                 get => Assembly.GetExecutingAssembly().GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
             }
 
-            [Category("Versions")]
+            [Category("Software")]
             public string DotNetVersion
             {
                 get => Environment.Version.ToString();
             }
 
-            [Category("Versions")]
+            [Category("Software")]
             public string SFMLVersion
             {
                 get => typeof(SFML.ObjectBase).Assembly.GetName().Version.ToString();
             }
 
-            [Category("Hardwares")]
-            public string CPU
+            [Category("Software")]
+            public string FFMpegCoreVersion
             {
-                get => Registry.GetValue(@"HKEY_LOCAL_MACHINE\HARDWARE\DESCRIPTION\System\CentralProcessor\0", "ProcessorNameString", "Unknown").ToString();
-            }
-
-            [Category("Hardwares")]
-            public string Memory
-            {
-                get => $"{new Microsoft.VisualBasic.Devices.ComputerInfo().TotalPhysicalMemory / 1024f / 1024f / 1024f:F1} GB";
-            }
-
-            [Category("Hardwares")]
-            public string GPU
-            {
-                get
-                {
-                    var searcher = new ManagementObjectSearcher("SELECT Name FROM Win32_VideoController");
-                    return string.Join("; ", searcher.Get().Cast<ManagementObject>().Select(mo => mo["Name"].ToString()));
-                }
+                get => typeof(FFMpegCore.FFMpeg).Assembly.GetName().Version.ToString();
             }
         }
 
@@ -86,7 +93,7 @@ namespace SpineViewer.Dialogs
             var properties = selectedObject.GetType().GetProperties();
             var result = string.Join(Environment.NewLine, properties.Select(p => $"{p.Name}\t{p.GetValue(selectedObject)?.ToString()}"));
             Clipboard.SetText(result);
-            MessageBox.Info("已复制");
+            MessagePopup.Info("已复制");
         }
     }
 }

SpineViewer/Dialogs/ExportDialog.Designer.cs

@@ -47,7 +47,7 @@
             panel1.Location = new Point(0, 0);
             panel1.Name = "panel1";
             panel1.Padding = new Padding(50, 15, 50, 10);
-            panel1.Size = new Size(710, 698);
+            panel1.Size = new Size(793, 754);
             panel1.TabIndex = 2;
             // 
             // tableLayoutPanel1
@@ -65,7 +65,7 @@
             tableLayoutPanel1.RowStyles.Add(new RowStyle());
             tableLayoutPanel1.RowStyles.Add(new RowStyle(SizeType.Absolute, 20F));
             tableLayoutPanel1.RowStyles.Add(new RowStyle(SizeType.Absolute, 20F));
-            tableLayoutPanel1.Size = new Size(610, 673);
+            tableLayoutPanel1.Size = new Size(693, 729);
             tableLayoutPanel1.TabIndex = 0;
             // 
             // propertyGrid_ExportArgs
@@ -74,7 +74,7 @@
             propertyGrid_ExportArgs.Location = new Point(3, 3);
             propertyGrid_ExportArgs.Name = "propertyGrid_ExportArgs";
             propertyGrid_ExportArgs.PropertySort = PropertySort.Categorized;
-            propertyGrid_ExportArgs.Size = new Size(604, 594);
+            propertyGrid_ExportArgs.Size = new Size(687, 650);
             propertyGrid_ExportArgs.TabIndex = 1;
             propertyGrid_ExportArgs.ToolbarVisible = false;
             // 
@@ -88,18 +88,18 @@
             tableLayoutPanel2.Controls.Add(button_Ok, 0, 0);
             tableLayoutPanel2.Controls.Add(button_Cancel, 1, 0);
             tableLayoutPanel2.Dock = DockStyle.Bottom;
-            tableLayoutPanel2.Location = new Point(3, 630);
+            tableLayoutPanel2.Location = new Point(3, 686);
             tableLayoutPanel2.Margin = new Padding(3, 30, 3, 3);
             tableLayoutPanel2.Name = "tableLayoutPanel2";
             tableLayoutPanel2.RowCount = 1;
             tableLayoutPanel2.RowStyles.Add(new RowStyle());
-            tableLayoutPanel2.Size = new Size(604, 40);
+            tableLayoutPanel2.Size = new Size(687, 40);
             tableLayoutPanel2.TabIndex = 10;
             // 
             // button_Ok
             // 
             button_Ok.Anchor = AnchorStyles.Bottom | AnchorStyles.Right;
-            button_Ok.Location = new Point(160, 3);
+            button_Ok.Location = new Point(201, 3);
             button_Ok.Margin = new Padding(3, 3, 30, 3);
             button_Ok.Name = "button_Ok";
             button_Ok.Size = new Size(112, 34);
@@ -111,7 +111,7 @@
             // button_Cancel
             // 
             button_Cancel.Anchor = AnchorStyles.Bottom | AnchorStyles.Left;
-            button_Cancel.Location = new Point(332, 3);
+            button_Cancel.Location = new Point(373, 3);
             button_Cancel.Margin = new Padding(30, 3, 3, 3);
             button_Cancel.Name = "button_Cancel";
             button_Cancel.Size = new Size(112, 34);
@@ -126,9 +126,8 @@
             AutoScaleDimensions = new SizeF(11F, 24F);
             AutoScaleMode = AutoScaleMode.Font;
             CancelButton = button_Cancel;
-            ClientSize = new Size(710, 698);
+            ClientSize = new Size(793, 754);
             Controls.Add(panel1);
-            FormBorderStyle = FormBorderStyle.FixedDialog;
             Icon = (Icon)resources.GetObject("$this.Icon");
             MaximizeBox = false;
             MinimizeBox = false;

SpineViewer/Dialogs/ExportDialog.cs

@@ -1,84 +1,71 @@
-using SpineViewer.Exporter;
+using SpineViewer.PropertyGridWrappers.Exporter;
+using SpineViewer.Utilities;
 using System;
 using System.Collections;
 using System.Collections.Generic;
 using System.ComponentModel;
 using System.Data;
 using System.Diagnostics;
-using System.Drawing;
-using System.Drawing.Design;
-using System.Drawing.Imaging;
 using System.Linq;
 using System.Reflection;
-using System.Text;
-using System.Threading.Tasks;
-using System.Windows.Forms;
 
 namespace SpineViewer.Dialogs
 {
-    public partial class ExportDialog: Form
+    public partial class ExportDialog : Form
     {
-        /// <summary>
-        /// 要绑定的导出参数
-        /// </summary>
-        public required ExportArgs ExportArgs
-        {
-            get => propertyGrid_ExportArgs.SelectedObject as ExportArgs;
-            init
-            {
-                propertyGrid_ExportArgs.SelectedObject = value;
+        private readonly ExporterWrapper wrapper;
 
-                #region XXX: 通过反射默认高亮指定的项
-                var categories = propertyGrid_ExportArgs.SelectedGridItem?.Parent?.Parent?.GridItems;
-                if (categories is null) return;
-
-                foreach (var category in categories)
-                {
-                    // 查找 "导出" 分组
-                    if (category == null) continue;
-                    PropertyInfo? labelProp = category.GetType().GetProperty("Label", BindingFlags.Instance | BindingFlags.Public);
-                    if (labelProp == null) continue;
-                    string? label = labelProp.GetValue(category) as string;
-                    if (label != "[0] 导出") continue;
-
-                    // 获取该分组下的所有属性项
-                    PropertyInfo? gridItemsProp = category.GetType().GetProperty("GridItems", BindingFlags.Instance | BindingFlags.Public);
-                    if (gridItemsProp == null) continue;
-                    var gridItemsObj = gridItemsProp.GetValue(category);
-                    if (gridItemsObj is not IEnumerable gridItems) continue;
-
-                    foreach (object item in gridItems)
-                    {
-                        if (item == null) continue;
-                        PropertyInfo? propDescProp = item.GetType().GetProperty("PropertyDescriptor", BindingFlags.Instance | BindingFlags.Public);
-                        if (propDescProp == null) continue;
-                        var propDesc = propDescProp.GetValue(item) as PropertyDescriptor;
-                        if (propDesc == null) continue;
-                        if (propDesc.Name == "OutputDir")
-                        {
-
-                            if (item is GridItem gridItem)
-                                propertyGrid_ExportArgs.SelectedGridItem = gridItem; // 找到后，将此项设为选中项
-                            else
-                                propertyGrid_ExportArgs.SelectedGridItem = (GridItem)item; // 如果转换失败，则尝试直接赋值
-                        }
-                        return; // 设置成功后退出
-                    }
-                }
-                #endregion
-            }
-        }
-
-        public ExportDialog()
+        public ExportDialog(ExporterWrapper wrapper)
         {
             InitializeComponent();
+            this.wrapper = wrapper;
+            propertyGrid_ExportArgs.SelectedObject = wrapper;
+
+            #region XXX: 通过反射默认高亮指定的项
+            var categories = propertyGrid_ExportArgs.SelectedGridItem?.Parent?.Parent?.GridItems;
+            if (categories is null) return;
+
+            foreach (var category in categories)
+            {
+                // 查找 "导出" 分组
+                if (category == null) continue;
+                PropertyInfo? labelProp = category.GetType().GetProperty("Label", BindingFlags.Instance | BindingFlags.Public);
+                if (labelProp == null) continue;
+                string? label = labelProp.GetValue(category) as string;
+                if (label != "[0] 导出") continue;
+
+                // 获取该分组下的所有属性项
+                PropertyInfo? gridItemsProp = category.GetType().GetProperty("GridItems", BindingFlags.Instance | BindingFlags.Public);
+                if (gridItemsProp == null) continue;
+                var gridItemsObj = gridItemsProp.GetValue(category);
+                if (gridItemsObj is not IEnumerable gridItems) continue;
+
+                foreach (object item in gridItems)
+                {
+                    if (item == null) continue;
+                    PropertyInfo? propDescProp = item.GetType().GetProperty("PropertyDescriptor", BindingFlags.Instance | BindingFlags.Public);
+                    if (propDescProp == null) continue;
+                    var propDesc = propDescProp.GetValue(item) as PropertyDescriptor;
+                    if (propDesc == null) continue;
+                    if (propDesc.Name == "OutputDir")
+                    {
+
+                        if (item is GridItem gridItem)
+                            propertyGrid_ExportArgs.SelectedGridItem = gridItem; // 找到后，将此项设为选中项
+                        else
+                            propertyGrid_ExportArgs.SelectedGridItem = (GridItem)item; // 如果转换失败，则尝试直接赋值
+                    }
+                    return; // 设置成功后退出
+                }
+            }
+            #endregion
         }
 
         private void button_Ok_Click(object sender, EventArgs e)
         {
-            if (ExportArgs.Validate() is string error)
-            { 
-                MessageBox.Info(error, "参数错误");
+            if (wrapper.Exporter.Validate() is string error)
+            {
+                MessagePopup.Info(error, "参数错误");
                 return;
             }
             DialogResult = DialogResult.OK;

SpineViewer/Dialogs/OpenSpineDialog.cs

@@ -1,4 +1,5 @@
 using SpineViewer.Spine;
+using SpineViewer.Utilities;
 using System;
 using System.Collections.Generic;
 using System.ComponentModel;
@@ -20,10 +21,10 @@ namespace SpineViewer.Dialogs
         public OpenSpineDialog()
         {
             InitializeComponent();
-            comboBox_Version.DataSource = VersionHelper.Names.ToList();
+            comboBox_Version.DataSource = SpineHelper.Names.ToList();
             comboBox_Version.DisplayMember = "Value";
             comboBox_Version.ValueMember = "Key";
-            comboBox_Version.SelectedValue = Spine.Version.Auto;
+            comboBox_Version.SelectedValue = SpineVersion.Auto;
         }
 
         private void OpenSpineDialog_Load(object sender, EventArgs e)
@@ -53,11 +54,11 @@ namespace SpineViewer.Dialogs
         {
             var skelPath = textBox_SkelPath.Text;
             var atlasPath = textBox_AtlasPath.Text;
-            var version = (Spine.Version)comboBox_Version.SelectedValue;
+            var version = (SpineVersion)comboBox_Version.SelectedValue;
 
             if (!File.Exists(skelPath))
             {
-                MessageBox.Info($"{skelPath}", "skel文件不存在");
+                MessagePopup.Info($"{skelPath}", "skel文件不存在");
                 return;
             }
             else
@@ -65,13 +66,13 @@ namespace SpineViewer.Dialogs
                 skelPath = Path.GetFullPath(skelPath);
             }
 
-            if (string.IsNullOrEmpty(atlasPath))
+            if (string.IsNullOrWhiteSpace(atlasPath))
             {
                 atlasPath = null;
             }
             else if (!File.Exists(atlasPath))
             {
-                MessageBox.Info($"{atlasPath}", "atlas文件不存在");
+                MessagePopup.Info($"{atlasPath}", "atlas文件不存在");
                 return;
             }
             else
@@ -79,9 +80,9 @@ namespace SpineViewer.Dialogs
                 atlasPath = Path.GetFullPath(atlasPath);
             }
 
-            if (version != Spine.Version.Auto && !Spine.Spine.ImplementedVersions.Contains(version))
+            if (version != SpineVersion.Auto && !Spine.Spine.HasImplementation(version))
             {
-                MessageBox.Info($"{version.GetName()} 版本尚未实现（咕咕咕~）");
+                MessagePopup.Info($"{version.GetName()} 版本尚未实现（咕咕咕~）");
                 return;
             }
 
@@ -98,12 +99,12 @@ namespace SpineViewer.Dialogs
     /// <summary>
     /// 打开骨骼对话框结果
     /// </summary>
-    public class OpenSpineDialogResult(Spine.Version version, string skelPath, string? atlasPath = null)
+    public class OpenSpineDialogResult(SpineVersion version, string skelPath, string? atlasPath = null)
     {
         /// <summary>
         /// 版本
         /// </summary>
-        public Spine.Version Version => version;
+        public SpineVersion Version => version;
 
         /// <summary>
         /// skel 文件路径

SpineViewer/Dialogs/ProgressDialog.cs

@@ -1,4 +1,6 @@
-using System;
+using NLog;
+using SpineViewer.Utilities;
+using System;
 using System.Collections.Generic;
 using System.ComponentModel;
 using System.Data;
@@ -12,6 +14,13 @@ namespace SpineViewer.Dialogs
 {
     public partial class ProgressDialog : Form
     {
+        private readonly Logger logger = LogManager.GetCurrentClassLogger();
+
+        public ProgressDialog()
+        {
+            InitializeComponent();
+        }
+
         /// <summary>
         /// BackgroundWorker.DoWork 接口暴露
         /// </summary>
@@ -32,11 +41,6 @@ namespace SpineViewer.Dialogs
         /// </summary>
         public void RunWorkerAsync(object? argument) => backgroundWorker.RunWorkerAsync(argument);
 
-        public ProgressDialog()
-        {
-            InitializeComponent();
-        }
-
         private void backgroundWorker_ProgressChanged(object sender, ProgressChangedEventArgs e)
         {
             label_Tip.Text = e.UserState as string;
@@ -47,8 +51,8 @@ namespace SpineViewer.Dialogs
         {
             if (e.Error != null)
             {
-                Program.Logger.Error(e.Error.ToString());
-                MessageBox.Error(e.Error.ToString(), "执行出错");
+                logger.Error(e.Error.ToString());
+                MessagePopup.Error(e.Error.ToString(), "执行出错");
                 DialogResult = DialogResult.Abort;
             }
             else if (e.Cancelled)

SpineViewer/Exporter/AvifExporter.cs

@@ -0,0 +1,55 @@
+using FFMpegCore;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// MP4 导出参数
+    /// </summary>
+    public class AvifExporter : FFmpegVideoExporter
+    {
+        public AvifExporter()
+        {
+            FPS = 24;
+        }
+
+        public override string Format => "avif";
+
+        public override string Suffix => ".avif";
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        public string Codec { get; set; } = "av1_nvenc";
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        public int CRF { get => crf; set => crf = Math.Clamp(value, 0, 63); }
+        private int crf = 23;
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        public string PixelFormat { get; set; } = "yuv420p";
+
+        /// <summary>
+        /// 循环次数, 0 无限循环, 取值范围 [0, 65535]
+        /// </summary>
+        public int Loop { get => loop; set => loop = Math.Clamp(value, 0, 65535); }
+        private int loop = 0;
+
+        public override string FileNameNoteSuffix => $"{Codec}_{CRF}_{PixelFormat}";
+
+        public override void SetOutputOptions(FFMpegArgumentOptions options)
+        {
+            base.SetOutputOptions(options);
+            options.WithVideoCodec(Codec).WithConstantRateFactor(CRF).WithCustomArgument($"-loop {Loop}");
+        }
+    }
+}

SpineViewer/Exporter/CustomExporter.cs

@@ -0,0 +1,36 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// FFmpeg 自定义视频导出参数
+    /// </summary>
+    public class CustomExporter : FFmpegVideoExporter
+    {
+        public CustomExporter() 
+        {
+            CustomArgument = "-c:v libx264 -crf 23 -pix_fmt yuv420p"; // 提供一个示例参数
+        }
+
+        public override string Format => CustomFormat;
+
+        public override string Suffix => CustomSuffix;
+
+        public override string FileNameNoteSuffix => string.Empty;
+
+        /// <summary>
+        /// 文件格式
+        /// </summary>
+        public string CustomFormat { get; set; } = "mp4";
+
+        /// <summary>
+        /// 文件名后缀
+        /// </summary>
+        public string CustomSuffix { get; set; } = ".mp4";
+    }
+}

SpineViewer/Exporter/ExportArgs.cs

@@ -1,107 +0,0 @@
-using SpineViewer.Spine;
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Drawing.Design;
-using System.Drawing.Imaging;
-using System.Linq;
-using System.Reflection;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Exporter
-{
-    /// <summary>
-    /// 导出参数基类
-    /// </summary>
-    public abstract class ExportArgs
-    {
-        /// <summary>
-        /// 实现类缓存
-        /// </summary>
-        private static readonly Dictionary<ExportType, Type> ImplementationTypes = [];
-
-        static ExportArgs()
-        {
-            var impTypes = Assembly.GetExecutingAssembly().GetTypes().Where(t => typeof(ExportArgs).IsAssignableFrom(t) && !t.IsAbstract);
-            foreach (var type in impTypes)
-            {
-                var attr = type.GetCustomAttribute<ExportImplementationAttribute>();
-                if (attr is not null)
-                {
-                    if (ImplementationTypes.ContainsKey(attr.ExportType))
-                        throw new InvalidOperationException($"Multiple implementations found: {attr.ExportType}");
-                    ImplementationTypes[attr.ExportType] = type;
-                }
-            }
-            Program.Logger.Debug("Find export args implementations: [{}]", string.Join(", ", ImplementationTypes.Keys));
-        }
-
-        /// <summary>
-        /// 创建指定类型导出参数
-        /// </summary>
-        public static ExportArgs New(ExportType exportType, Size resolution, SFML.Graphics.View view, bool renderSelectedOnly)
-        {
-            if (!ImplementationTypes.TryGetValue(exportType, out var type))
-            {
-                throw new NotImplementedException($"Not implemented type: {exportType}");
-            }
-            return (ExportArgs)Activator.CreateInstance(type, resolution, view, renderSelectedOnly);
-        }
-
-        public ExportArgs(Size resolution, SFML.Graphics.View view, bool renderSelectedOnly)
-        {
-            Resolution = resolution;
-            View = view;
-            RenderSelectedOnly = renderSelectedOnly;
-        }
-
-        /// <summary>
-        /// 输出文件夹
-        /// </summary>
-        [Editor(typeof(FolderNameEditor), typeof(UITypeEditor))]
-        [Category("[0] 导出"), DisplayName("输出文件夹"), Description("逐个导出时可以留空，将逐个导出到模型自身所在目录")]
-        public string? OutputDir { get; set; } = null;
-
-        /// <summary>
-        /// 导出单个
-        /// </summary>
-        [Category("[0] 导出"), DisplayName("导出单个"), Description("是否将模型在同一个画面上导出单个文件，否则逐个导出模型")]
-        public bool ExportSingle { get; set; } = false;
-
-        /// <summary>
-        /// 画面分辨率
-        /// </summary>
-        [TypeConverter(typeof(SizeConverter))]
-        [Category("[0] 导出"), DisplayName("分辨率"), Description("画面的宽高像素大小，请在预览画面参数面板进行调整")]
-        public Size Resolution { get; }
-
-        /// <summary>
-        /// 渲染视窗
-        /// </summary>
-        [Category("[0] 导出"), DisplayName("视图"), Description("画面的视图参数，请在预览画面参数面板进行调整")]
-        public SFML.Graphics.View View { get; }
-
-        /// <summary>
-        /// 是否仅渲染选中
-        /// </summary>
-        [Category("[0] 导出"), DisplayName("仅渲染选中"), Description("是否仅导出选中的模型，请在预览画面参数面板进行调整")]
-        public bool RenderSelectedOnly { get; }
-
-        /// <summary>
-        /// 检查参数是否合法并规范化参数值, 否则返回用户错误原因
-        /// </summary>
-        public virtual string? Validate()
-        {
-            if (!string.IsNullOrEmpty(OutputDir) && File.Exists(OutputDir))
-                return "输出文件夹无效";
-            if (!string.IsNullOrEmpty(OutputDir) && !Directory.Exists(OutputDir))
-                return $"文件夹 {OutputDir} 不存在";
-            if (ExportSingle && string.IsNullOrEmpty(OutputDir))
-                return "导出单个时必须提供输出文件夹";
-
-            OutputDir = string.IsNullOrEmpty(OutputDir) ? null : Path.GetFullPath(OutputDir);
-            return null;
-        }
-    }
-}

SpineViewer/Exporter/ExportHelper.cs

@@ -1,43 +1,15 @@
 using FFMpegCore.Pipes;
+using SpineViewer.Extensions;
 using System;
 using System.Collections.Generic;
 using System.Drawing.Imaging;
 using System.Linq;
 using System.Text;
-using System.Threading.Tasks;
 
 namespace SpineViewer.Exporter
 {
     /// <summary>
-    /// 导出类型
-    /// </summary>
-    public enum ExportType
-    {
-        Frame,
-        FrameSequence,
-        GIF,
-        MKV,
-        MP4,
-        MOV,
-        WebM
-    }
-
-    /// <summary>
-    /// 导出实现类标记
-    /// </summary>
-    [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false)]
-    public class ExportImplementationAttribute : Attribute
-    {
-        public ExportType ExportType { get; }
-
-        public ExportImplementationAttribute(ExportType exportType)
-        {
-            ExportType = exportType;
-        }
-    }
-
-    /// <summary>
-    /// SFML.Graphics.Image 帧对象包装类
+    /// SFML.Graphics.Image 帧对象包装类, 将接管给定的 image 对象生命周期
     /// </summary>
     public class SFMLImageVideoFrame(SFML.Graphics.Image image) : IVideoFrame, IDisposable
     {
@@ -68,12 +40,7 @@ namespace SpineViewer.Exporter
         /// <summary>
         /// 获取 Winforms Bitmap 对象
         /// </summary>
-        public Bitmap CopyToBitmap()
-        {
-            image.SaveToMemory(out var imgBuffer, "bmp");
-            using var stream = new MemoryStream(imgBuffer);
-            return new(new Bitmap(stream)); // 必须重复构造一个副本才能摆脱对流的依赖, 否则之后使用会报错
-        }
+        public Bitmap CopyToBitmap() => image.CopyToBitmap();
     }
 
     /// <summary>
@@ -90,51 +57,5 @@ namespace SpineViewer.Exporter
             else if (imageFormat == ImageFormat.Exif) return ".jpeg";
             else return $".{imageFormat.ToString().ToLower()}";
         }
-
-        #region 包围盒辅助函数
-
-        /// <summary>
-        /// 获取某个包围盒下合适的视图
-        /// </summary>
-        public static SFML.Graphics.View GetView(this RectangleF bounds, Size resolution, Padding padding)
-            => bounds.GetView((uint)resolution.Width, (uint)resolution.Height, (uint)padding.Left, (uint)padding.Right, (uint)padding.Top, (uint)padding.Bottom);
-
-        /// <summary>
-        /// 获取某个包围盒下合适的视图
-        /// </summary>
-        public static SFML.Graphics.View GetView(this RectangleF bounds, uint width, uint height, Padding padding)
-            => bounds.GetView(width, height, (uint)padding.Left, (uint)padding.Right, (uint)padding.Top, (uint)padding.Bottom);
-
-        /// <summary>
-        /// 获取某个包围盒下合适的视图
-        /// </summary>
-        public static SFML.Graphics.View GetView(this RectangleF bounds, Size resolution, uint paddingL = 1, uint paddingR = 1, uint paddingT = 1, uint paddingB = 1)
-            => bounds.GetView((uint)resolution.Width, (uint)resolution.Height, paddingL, paddingR, paddingT, paddingB);
-
-        /// <summary>
-        /// 获取某个包围盒下合适的视图
-        /// </summary>
-        public static SFML.Graphics.View GetView(this RectangleF bounds, uint width, uint height, uint paddingL = 1, uint paddingR = 1, uint paddingT = 1, uint paddingB = 1)
-        {
-            float sizeX = bounds.Width;
-            float sizeY = bounds.Height;
-            float innerW = width - paddingL - paddingR;
-            float innerH = height - paddingT - paddingB;
-
-            float scale = 1;
-            if (sizeY / sizeX < innerH / innerW)
-                scale = sizeX / innerW; // 相同的 X, 视窗 Y 更大
-            else
-                scale = sizeY / innerH; // 相同的 Y, 视窗 X 更大
-
-            var x = bounds.X + bounds.Width / 2 + (paddingL - (float)paddingR) * scale;
-            var y = bounds.Y + bounds.Height / 2 + (paddingT - (float)paddingB) * scale;
-            var viewX = width * scale;
-            var viewY = height * scale;
-
-            return new(new(x, y), new(viewX, -viewY));
-        }
-
-        #endregion
     }
 }

SpineViewer/Exporter/Exporter.cs

@@ -1,104 +1,149 @@
-using SpineViewer.Spine;
+using NLog;
+using SpineViewer.Extensions;
+using SpineViewer.PropertyGridWrappers;
+using SpineViewer.Utilities;
 using System;
 using System.Collections.Generic;
 using System.ComponentModel;
+using System.Drawing.Design;
 using System.Linq;
 using System.Reflection;
 using System.Text;
 using System.Threading.Tasks;
-using static System.Windows.Forms.VisualStyles.VisualStyleElement.StartPanel;
 
 namespace SpineViewer.Exporter
 {
     /// <summary>
     /// 导出器基类
     /// </summary>
-    public abstract class Exporter
+    public abstract class Exporter : IDisposable
     {
         /// <summary>
-        /// 实现类缓存
+        /// 日志器
         /// </summary>
-        private static readonly Dictionary<ExportType, Type> ImplementationTypes = [];
-
-        static Exporter()
-        {
-            var impTypes = Assembly.GetExecutingAssembly().GetTypes().Where(t => typeof(Exporter).IsAssignableFrom(t) && !t.IsAbstract);
-            foreach (var type in impTypes)
-            {
-                var attr = type.GetCustomAttribute<ExportImplementationAttribute>();
-                if (attr is not null)
-                {
-                    if (ImplementationTypes.ContainsKey(attr.ExportType))
-                        throw new InvalidOperationException($"Multiple implementations found: {attr.ExportType}");
-                    ImplementationTypes[attr.ExportType] = type;
-                }
-            }
-            Program.Logger.Debug("Find exporter implementations: [{}]", string.Join(", ", ImplementationTypes.Keys));
-        }
-
-        /// <summary>
-        /// 创建指定类型导出参数
-        /// </summary>
-        public static Exporter New(ExportType exportType, ExportArgs exportArgs)
-        {
-            if (!ImplementationTypes.TryGetValue(exportType, out var type))
-            {
-                throw new NotImplementedException($"Not implemented type: {exportType}");
-            }
-            return (Exporter)Activator.CreateInstance(type, exportArgs);
-        }
-
-        /// <summary>
-        /// 导出参数
-        /// </summary>
-        public ExportArgs ExportArgs { get; }
+        protected readonly Logger logger = LogManager.GetCurrentClassLogger();
 
         /// <summary>
         /// 可用于文件名的时间戳字符串
         /// </summary>
-        protected readonly string timestamp;
+        protected readonly string timestamp = DateTime.Now.ToString("yyMMddHHmmss");
 
-        public Exporter(ExportArgs exportArgs)
+        ~Exporter() { Dispose(false); }
+        public void Dispose() { Dispose(true); GC.SuppressFinalize(this); }
+        protected virtual void Dispose(bool disposing) { View.Dispose(); }
+
+        /// <summary>
+        /// 输出文件夹
+        /// </summary>
+        public string? OutputDir { get; set; } = null;
+
+        /// <summary>
+        /// 导出单个
+        /// </summary>
+        public bool IsExportSingle { get; set; } = false;
+
+        /// <summary>
+        /// 画面分辨率
+        /// </summary>
+        public Size Resolution { get; set; } = new(100, 100);
+
+        /// <summary>
+        /// 渲染视窗, 接管对象生命周期
+        /// </summary>
+        public SFML.Graphics.View View { get => view; set { view.Dispose(); view = value; } }
+        private SFML.Graphics.View view = new();
+
+        /// <summary>
+        /// 是否仅渲染选中
+        /// </summary>
+        public bool RenderSelectedOnly { get; set; } = false;
+
+        /// <summary>
+        /// 背景颜色
+        /// </summary>
+        public SFML.Graphics.Color BackgroundColor
         {
-            ExportArgs = exportArgs;
-            timestamp = DateTime.Now.ToString("yyMMddHHmmss");
+            get => backgroundColor;
+            set
+            {
+                backgroundColor = value;
+                var bcPma = value;
+                var a = bcPma.A / 255f;
+                bcPma.R = (byte)(bcPma.R * a);
+                bcPma.G = (byte)(bcPma.G * a);
+                bcPma.B = (byte)(bcPma.B * a);
+                BackgroundColorPma = bcPma;
+            }
         }
+        private SFML.Graphics.Color backgroundColor = SFML.Graphics.Color.Transparent;
+
+        /// <summary>
+        /// 预乘后的背景颜色
+        /// </summary>
+        public SFML.Graphics.Color BackgroundColorPma { get; private set; } = SFML.Graphics.Color.Transparent;
 
         /// <summary>
         /// 获取供渲染的 SFML.Graphics.RenderTexture
         /// </summary>
         private SFML.Graphics.RenderTexture GetRenderTexture()
         {
-            var tex = new SFML.Graphics.RenderTexture((uint)ExportArgs.Resolution.Width, (uint)ExportArgs.Resolution.Height);
+            var tex = new SFML.Graphics.RenderTexture((uint)Resolution.Width, (uint)Resolution.Height);
             tex.Clear(SFML.Graphics.Color.Transparent);
-            tex.SetView(ExportArgs.View);
+            tex.SetView(View);
             return tex;
         }
 
         /// <summary>
         /// 获取单个模型的单帧画面
         /// </summary>
-        protected SFMLImageVideoFrame GetFrame(Spine.Spine spine)
-        {
-            // tex 必须临时创建, 随用随取, 防止出现跨线程的情况
-            using var tex = GetRenderTexture();
-            tex.Clear(SFML.Graphics.Color.Transparent);
-            tex.Draw(spine);
-            tex.Display();
-            return new(tex.Texture.CopyToImage());
-        }
+        protected SFMLImageVideoFrame GetFrame(Spine.Spine spine) => GetFrame([spine]);
 
         /// <summary>
         /// 获取模型列表的单帧画面
         /// </summary>
         protected SFMLImageVideoFrame GetFrame(Spine.Spine[] spinesToRender)
         {
-            // tex 必须临时创建, 随用随取, 防止出现跨线程的情况
-            using var tex = GetRenderTexture();
-            tex.Clear(SFML.Graphics.Color.Transparent);
-            foreach (var spine in spinesToRender) tex.Draw(spine);
-            tex.Display();
-            return new(tex.Texture.CopyToImage());
+            // RenderTexture 必须临时创建, 随用随取, 防止出现跨线程的情况
+            using var texPma = GetRenderTexture();
+
+            // 先将预乘结果准确绘制出来, 注意背景色也应当是预乘的
+            texPma.Clear(BackgroundColorPma);
+            foreach (var spine in spinesToRender) texPma.Draw(spine);
+            texPma.Display();
+
+            // 背景色透明度不为 1 时需要处理反预乘, 否则直接就是结果
+            if (BackgroundColor.A < 255)
+            {
+                // 从预乘结果构造渲染对象, 并正确设置变换
+                using var view = texPma.GetView();
+                using var img = texPma.Texture.CopyToImage();
+                using var texSprite = new SFML.Graphics.Texture(img);
+                using var sp = new SFML.Graphics.Sprite(texSprite)
+                {
+                    Origin = new(texPma.Size.X / 2f, texPma.Size.Y / 2f),
+                    Position = new(view.Center.X, view.Center.Y),
+                    Scale = new(view.Size.X / texPma.Size.X, view.Size.Y / texPma.Size.Y),
+                    Rotation = view.Rotation
+                };
+
+                // 混合模式用直接覆盖的方式, 保证得到的图像区域是反预乘的颜色和透明度, 同时使用反预乘着色器
+                var st = SFML.Graphics.RenderStates.Default;
+                st.BlendMode = SFMLBlendMode.SourceOnly;
+                st.Shader = SFMLShader.InversePma;
+
+                // 在最终结果上二次渲染非预乘画面
+                using var tex = GetRenderTexture();
+
+                // 将非预乘结果覆盖式绘制在目标对象上, 注意背景色应该用非预乘的
+                tex.Clear(BackgroundColor);
+                tex.Draw(sp, st);
+                tex.Display();
+                return new(tex.Texture.CopyToImage());
+            }
+            else
+            {
+                return new(texPma.Texture.CopyToImage());
+            }
         }
 
         /// <summary>
@@ -111,19 +156,39 @@ namespace SpineViewer.Exporter
         /// </summary>
         protected abstract void ExportIndividual(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null);
 
+        /// <summary>
+        /// 检查参数是否合法并规范化参数值, 否则返回用户错误原因
+        /// </summary>
+        public virtual string? Validate()
+        {
+            if (!string.IsNullOrWhiteSpace(OutputDir) && File.Exists(OutputDir))
+                return "输出文件夹无效";
+            if (!string.IsNullOrWhiteSpace(OutputDir) && !Directory.Exists(OutputDir))
+                return $"文件夹 {OutputDir} 不存在";
+            if (IsExportSingle && string.IsNullOrWhiteSpace(OutputDir))
+                return "导出单个时必须提供输出文件夹";
+
+            OutputDir = string.IsNullOrWhiteSpace(OutputDir) ? null : Path.GetFullPath(OutputDir);
+            return null;
+        }
+
         /// <summary>
         /// 执行导出
         /// </summary>
         /// <param name="spines">要进行导出的 Spine 列表</param>
         /// <param name="worker">用来执行该函数的 worker</param>
+        /// <exception cref="ArgumentException"></exception>
         public virtual void Export(Spine.Spine[] spines, BackgroundWorker? worker = null)
         {
-            var spinesToRender = spines.Where(sp => !ExportArgs.RenderSelectedOnly || sp.IsSelected).Reverse().ToArray();
+            if (Validate() is string err) 
+                throw new ArgumentException(err);
 
-            if (ExportArgs.ExportSingle) ExportSingle(spinesToRender, worker);
+            var spinesToRender = spines.Where(sp => !RenderSelectedOnly || sp.IsSelected).Reverse().ToArray();
+
+            if (IsExportSingle) ExportSingle(spinesToRender, worker);
             else ExportIndividual(spinesToRender, worker);
 
-            Program.LogCurrentMemoryUsage();
+            logger.LogCurrentProcessMemoryUsage();
         }
     }
 }

SpineViewer/Exporter/FFmpegVideoExporter.cs

@@ -0,0 +1,111 @@
+using FFMpegCore.Pipes;
+using FFMpegCore;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Diagnostics;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// 使用 FFmpeg 的视频导出器
+    /// </summary>
+    public abstract class FFmpegVideoExporter : VideoExporter
+    {
+        /// <summary>
+        /// 文件格式
+        /// </summary>
+        public abstract string Format { get; }
+
+        /// <summary>
+        /// 文件名后缀
+        /// </summary>
+        public abstract string Suffix { get; }
+
+        /// <summary>
+        /// 文件名后缀
+        /// </summary>
+        public string CustomArgument { get; set; }
+
+        /// <summary>
+        /// 要追加在文件名末尾的信息字串, 首尾不需要提供额外分隔符
+        /// </summary>
+        public abstract string FileNameNoteSuffix { get; }
+
+        /// <summary>
+        /// 获取输出附加选项
+        /// </summary>
+        public virtual void SetOutputOptions(FFMpegArgumentOptions options) => options.ForceFormat(Format).WithCustomArgument(CustomArgument);
+
+        public override string? Validate()
+        {
+            if (base.Validate() is string error)
+                return error;
+            if (string.IsNullOrWhiteSpace(Format))
+                return "需要提供有效的格式";
+            if (string.IsNullOrWhiteSpace(Suffix))
+                return "需要提供有效的文件名后缀";
+            return null;
+        }
+
+        protected override void ExportSingle(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
+        {
+            var noteSuffix = FileNameNoteSuffix;
+            if (!string.IsNullOrWhiteSpace(noteSuffix)) noteSuffix = $"_{noteSuffix}";
+
+            var filename = $"ffmpeg_{timestamp}_{FPS:f0}{noteSuffix}{Suffix}";
+
+            // 导出单个时必定提供输出文件夹
+            var savePath = Path.Combine(OutputDir, filename);
+
+            var videoFramesSource = new RawVideoPipeSource(GetFrames(spinesToRender, worker)) { FrameRate = FPS };
+            try
+            {
+                var ffmpegArgs = FFMpegArguments.FromPipeInput(videoFramesSource).OutputToFile(savePath, true, SetOutputOptions);
+
+                logger.Info("FFmpeg arguments: {}", ffmpegArgs.Arguments);
+                ffmpegArgs.ProcessSynchronously();
+            }
+            catch (Exception ex)
+            {
+                logger.Error(ex.ToString());
+                logger.Error("Failed to export {} {}", Format, savePath);
+            }
+        }
+
+        protected override void ExportIndividual(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
+        {
+            var noteSuffix = FileNameNoteSuffix;
+            if (!string.IsNullOrWhiteSpace(noteSuffix)) noteSuffix = $"_{noteSuffix}";
+
+            foreach (var spine in spinesToRender)
+            {
+                if (worker?.CancellationPending == true) break; // 取消的日志在 GetFrames 里输出
+
+                var filename = $"{spine.Name}_{timestamp}_{FPS:f0}{noteSuffix}{Suffix}";
+
+                // 如果提供了输出文件夹, 则全部导出到输出文件夹, 否则导出到各自的文件夹下
+                var savePath = Path.Combine(OutputDir ?? spine.AssetsDir, filename);
+
+                var videoFramesSource = new RawVideoPipeSource(GetFrames(spine, worker)) { FrameRate = FPS };
+                try
+                {
+                    var ffmpegArgs = FFMpegArguments
+                    .FromPipeInput(videoFramesSource)
+                    .OutputToFile(savePath, true, SetOutputOptions);
+
+                    logger.Info("FFmpeg arguments: {}", ffmpegArgs.Arguments);
+                    ffmpegArgs.ProcessSynchronously();
+                }
+                catch (Exception ex)
+                {
+                    logger.Error(ex.ToString());
+                    logger.Error("Failed to export {} {} {}", Format, savePath, spine.SkelPath);
+                }
+            }
+        }
+    }
+}

SpineViewer/Exporter/FrameExporter.cs

@@ -0,0 +1,107 @@
+using SpineViewer.Spine;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Drawing.Imaging;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// 单帧画面导出器
+    /// </summary>
+    public class FrameExporter : Exporter
+    {
+        /// <summary>
+        /// 单帧画面格式
+        /// </summary>
+        public ImageFormat ImageFormat
+        {
+            get => imageFormat;
+            set
+            {
+                if (value == ImageFormat.MemoryBmp) value = ImageFormat.Bmp;
+                imageFormat = value;
+            }
+        }
+        private ImageFormat imageFormat = ImageFormat.Png;
+
+        /// <summary>
+        /// DPI
+        /// </summary>
+        public SizeF DPI
+        {
+            get => dpi;
+            set
+            {
+                if (value.Width <= 0) value.Width = 144;
+                if (value.Height <= 0) value.Height = 144;
+                dpi = value;
+            }
+        }
+        private SizeF dpi = new(144, 144);
+
+        protected override void ExportSingle(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
+        {
+            // 导出单个时必定提供输出文件夹
+            var filename = $"frame_{timestamp}{ImageFormat.GetSuffix()}";
+            var savePath = Path.Combine(OutputDir, filename);
+
+            worker?.ReportProgress(0, $"已处理 0/1");
+            try
+            {
+                using var frame = GetFrame(spinesToRender);
+                using var img = frame.CopyToBitmap();
+                img.SetResolution(DPI.Width, DPI.Height);
+                img.Save(savePath, ImageFormat);
+            }
+            catch (Exception ex)
+            {
+                logger.Error(ex.ToString());
+                logger.Error("Failed to save single frame");
+            }
+            worker?.ReportProgress(100, $"已处理 1/1");
+        }
+
+        protected override void ExportIndividual(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
+        {
+            int total = spinesToRender.Length;
+            int success = 0;
+            int error = 0;
+
+            worker?.ReportProgress(0, $"已处理 0/{total}");
+            for (int i = 0; i < total; i++)
+            {
+                var spine = spinesToRender[i];
+
+                // 逐个导出时如果提供了输出文件夹, 则全部导出到输出文件夹, 否则输出到各自的文件夹
+                var filename = $"{spine.Name}_{timestamp}{ImageFormat.GetSuffix()}";
+                var savePath = Path.Combine(OutputDir ?? spine.AssetsDir, filename);
+
+                try
+                {
+                    using var frame = GetFrame(spine);
+                    using var img = frame.CopyToBitmap();
+                    img.SetResolution(DPI.Width, DPI.Height);
+                    img.Save(savePath, ImageFormat);
+                    success++;
+                }
+                catch (Exception ex)
+                {
+                    logger.Error(ex.ToString());
+                    logger.Error("Failed to save single frame {} {}", savePath, spine.SkelPath);
+                    error++;
+                }
+
+                worker?.ReportProgress((int)((i + 1) * 100.0) / total, $"已处理 {i + 1}/{total}");
+            }
+
+            if (error > 0)
+                logger.Warn("Frames save {} successfully, {} failed", success, error);
+            else
+                logger.Info("{} frames saved successfully", success);
+        }
+    }
+}

SpineViewer/Exporter/FrameSequenceExporter.cs

@@ -1,5 +1,4 @@
-using SpineViewer.Exporter.Implementations.ExportArgs;
-using SpineViewer.Spine;
+using SpineViewer.Spine;
 using System;
 using System.Collections.Generic;
 using System.ComponentModel;
@@ -7,28 +6,28 @@ using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 
-namespace SpineViewer.Exporter.Implementations.Exporter
+namespace SpineViewer.Exporter
 {
     /// <summary>
     /// 帧序列导出器
     /// </summary>
-    [ExportImplementation(ExportType.FrameSequence)]
     public class FrameSequenceExporter : VideoExporter
     {
-        public FrameSequenceExporter(FrameSequenceExportArgs exportArgs) : base(exportArgs) { }
+        /// <summary>
+        /// 文件名后缀, 同时决定帧图像格式, 支持的格式为 <c>".png", ".jpg", ".tga", ".bmp"</c>
+        /// </summary>
+        public string Suffix { get; set; } = ".png";
 
         protected override void ExportSingle(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
         {
-            var args = (FrameSequenceExportArgs)ExportArgs;
-
             // 导出单个时必定提供输出文件夹, 
-            var saveDir = Path.Combine(args.OutputDir, $"frames_{timestamp}_{args.FPS:f0}");
+            var saveDir = Path.Combine(OutputDir, $"frames_{timestamp}_{FPS:f0}");
             Directory.CreateDirectory(saveDir);
 
             int frameIdx = 0;
             foreach (var frame in GetFrames(spinesToRender, worker))
             {
-                var filename = $"frames_{timestamp}_{args.FPS:f0}_{frameIdx:d6}{args.FileSuffix}";
+                var filename = $"frames_{timestamp}_{FPS:f0}_{frameIdx:d6}{Suffix}";
                 var savePath = Path.Combine(saveDir, filename);
 
                 try
@@ -37,8 +36,8 @@ namespace SpineViewer.Exporter.Implementations.Exporter
                 }
                 catch (Exception ex)
                 {
-                    Program.Logger.Error(ex.ToString());
-                    Program.Logger.Error("Failed to save frame {}", savePath);
+                    logger.Error(ex.ToString());
+                    logger.Error("Failed to save frame {}", savePath);
                 }
                 finally
                 {
@@ -50,20 +49,19 @@ namespace SpineViewer.Exporter.Implementations.Exporter
 
         protected override void ExportIndividual(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
         {
-            var args = (FrameSequenceExportArgs)ExportArgs;
             foreach (var spine in spinesToRender)
             {
                 if (worker?.CancellationPending == true) break; // 取消的日志在 GetFrames 里输出
 
                 // 如果提供了输出文件夹, 则全部导出到输出文件夹, 否则导出到各自的文件夹下
-                var subDir = $"{spine.Name}_{timestamp}_{args.FPS:f0}";
-                var saveDir = args.OutputDir is null ? Path.Combine(spine.AssetsDir, subDir) : Path.Combine(args.OutputDir, subDir);
+                var subDir = $"{spine.Name}_{timestamp}_{FPS:f0}";
+                var saveDir = Path.Combine(OutputDir ?? spine.AssetsDir, subDir);
                 Directory.CreateDirectory(saveDir);
 
                 int frameIdx = 0;
                 foreach (var frame in GetFrames(spine, worker))
                 {
-                    var filename = $"{spine.Name}_{timestamp}_{args.FPS:f0}_{frameIdx:d6}{args.FileSuffix}";
+                    var filename = $"{spine.Name}_{timestamp}_{FPS:f0}_{frameIdx:d6}{Suffix}";
                     var savePath = Path.Combine(saveDir, filename);
 
                     try
@@ -72,8 +70,8 @@ namespace SpineViewer.Exporter.Implementations.Exporter
                     }
                     catch (Exception ex)
                     {
-                        Program.Logger.Error(ex.ToString());
-                        Program.Logger.Error("Failed to save frame {} {}", savePath, spine.SkelPath);
+                        logger.Error(ex.ToString());
+                        logger.Error("Failed to save frame {} {}", savePath, spine.SkelPath);
                     }
                     finally
                     {

SpineViewer/Exporter/GifExporter.cs

@@ -0,0 +1,55 @@
+using FFMpegCore;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// GIF 导出参数
+    /// </summary>
+    public class GifExporter : FFmpegVideoExporter
+    {
+        public GifExporter()
+        {
+            FPS = 24;
+        }
+
+        public override string Format => "gif";
+
+        public override string Suffix => ".gif";
+
+        /// <summary>
+        /// 调色板最大颜色数量
+        /// </summary>
+        public uint MaxColors { get => maxColors; set => maxColors = Math.Clamp(value, 2, 256); }
+        private uint maxColors = 256;
+
+        /// <summary>
+        /// 透明度阈值
+        /// </summary>
+        public byte AlphaThreshold { get => alphaThreshold; set => alphaThreshold = value; }
+        private byte alphaThreshold = 128;
+
+        /// <summary>
+        /// 循环次数, -1 不循环, 0 无限循环, 取值范围 [-1, 65535]
+        /// </summary>
+        public int Loop { get => loop; set => loop = Math.Clamp(value, -1, 65535); }
+        private int loop = 0;
+
+        public override string FileNameNoteSuffix => $"{MaxColors}_{AlphaThreshold}";
+
+        public override void SetOutputOptions(FFMpegArgumentOptions options)
+        {
+            base.SetOutputOptions(options);
+            var v = $"[0:v] split [s0][s1]";
+            var s0 = $"[s0] palettegen=reserve_transparent=1:max_colors={MaxColors} [p]";
+            var s1 = $"[s1][p] paletteuse=dither=bayer:alpha_threshold={AlphaThreshold}";
+            var customArgs = $"-filter_complex \"{v};{s0};{s1}\" -loop {Loop}";
+            options.WithCustomArgument(customArgs);
+        }
+    }
+}

SpineViewer/Exporter/Implementations/ExportArgs/FrameExportArgs.cs

@@ -1,58 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Drawing.Imaging;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Exporter.Implementations.ExportArgs
-{
-    /// <summary>
-    /// 单帧画面导出参数
-    /// </summary>
-    [ExportImplementation(ExportType.Frame)]
-    public class FrameExportArgs : SpineViewer.Exporter.ExportArgs
-    {
-        public FrameExportArgs(Size resolution, SFML.Graphics.View view, bool renderSelectedOnly) : base(resolution, view, renderSelectedOnly) { }
-
-        /// <summary>
-        /// 单帧画面格式
-        /// </summary>
-        [TypeConverter(typeof(ImageFormatConverter))]
-        [Category("[1] 单帧画面"), DisplayName("图像格式")]
-        public ImageFormat ImageFormat
-        {
-            get => imageFormat;
-            set
-            {
-                if (value == ImageFormat.MemoryBmp) value = ImageFormat.Bmp;
-                imageFormat = value;
-            }
-        }
-        private ImageFormat imageFormat = ImageFormat.Png;
-
-        /// <summary>
-        /// 文件名后缀
-        /// </summary>
-        [Category("[1] 单帧画面"), DisplayName("文件名后缀"), Description("与图像格式匹配的文件名后缀")]
-        public string FileSuffix { get => imageFormat.GetSuffix(); }
-
-        /// <summary>
-        /// DPI
-        /// </summary>
-        [TypeConverter(typeof(SizeFConverter))]
-        [Category("[1] 单帧画面"), DisplayName("DPI"), Description("导出图像的每英寸像素数，用于调整图像的物理尺寸")]
-        public SizeF DPI
-        {
-            get => dpi;
-            set
-            {
-                if (value.Width <= 0) value.Width = 144;
-                if (value.Height <= 0) value.Height = 144;
-                dpi = value;
-            }
-        }
-        private SizeF dpi = new(144, 144);
-    }
-}

SpineViewer/Exporter/Implementations/ExportArgs/FrameSequenceExportArgs.cs

@@ -1,26 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Drawing.Imaging;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Exporter.Implementations.ExportArgs
-{
-    /// <summary>
-    /// 帧序列导出参数
-    /// </summary>
-    [ExportImplementation(ExportType.FrameSequence)]
-    public class FrameSequenceExportArgs : VideoExportArgs
-    {
-        public FrameSequenceExportArgs(Size resolution, SFML.Graphics.View view, bool renderSelectedOnly) : base(resolution, view, renderSelectedOnly) { }
-
-        /// <summary>
-        /// 文件名后缀
-        /// </summary>
-        [TypeConverter(typeof(SFMLImageFileSuffixConverter))]
-        [Category("[2] 帧序列参数"), DisplayName("文件名后缀"), Description("帧文件的后缀，同时决定帧图像格式")]
-        public string FileSuffix { get; set; } = ".png";
-    }
-}

SpineViewer/Exporter/Implementations/ExportArgs/GifExportArgs.cs

@@ -1,51 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Exporter.Implementations.ExportArgs
-{
-    /// <summary>
-    /// GIF 导出参数
-    /// </summary>
-    [ExportImplementation(ExportType.GIF)]
-    public class GifExportArgs : VideoExportArgs
-    {
-        public GifExportArgs(Size resolution, SFML.Graphics.View view, bool renderSelectedOnly) : base(resolution, view, renderSelectedOnly) 
-        {
-            // GIF 的帧率不能太高, 超过 50 帧反而会变慢
-            FPS = 25;
-        }
-
-        /// <summary>
-        /// 调色板最大颜色数量
-        /// </summary>
-        [Category("[2] GIF 参数"), DisplayName("调色板最大颜色数量"), Description("设置调色板使用的最大颜色数量, 越多则色彩保留程度越高")]
-        public uint MaxColors { get => maxColors; set => maxColors = Math.Clamp(value, 2, 256); }
-        private uint maxColors = 256;
-
-        /// <summary>
-        /// 透明度阈值
-        /// </summary>
-        [Category("[2] GIF 参数"), DisplayName("透明度阈值"), Description("小于该值的像素点会被认为是透明像素")]
-        public byte AlphaThreshold { get => alphaThreshold; set => alphaThreshold = value; }
-        private byte alphaThreshold = 128;
-
-        /// <summary>
-        /// 获取构造好的 FFMpegCore 自定义参数
-        /// </summary>
-        [Browsable(false)]
-        public string FFMpegCoreCustomArguments
-        {
-            get
-            {
-                var v = $"[0:v] split [s0][s1]";
-                var s0 = $"[s0] palettegen=reserve_transparent=1:max_colors={MaxColors} [p]";
-                var s1 = $"[s1][p] paletteuse=dither=bayer:alpha_threshold={AlphaThreshold}";
-                return $"-filter_complex \"{v};{s0};{s1}\"";
-            }
-        }
-    }
-}

SpineViewer/Exporter/Implementations/ExportArgs/VideoExportArgs.cs

@@ -1,43 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Exporter.Implementations.ExportArgs
-{
-    /// <summary>
-    /// 视频导出参数基类
-    /// </summary>
-    public abstract class VideoExportArgs : SpineViewer.Exporter.ExportArgs
-    {
-        public VideoExportArgs(Size resolution, SFML.Graphics.View view, bool renderSelectedOnly) : base(resolution, view, renderSelectedOnly) { }
-
-        /// <summary>
-        /// 导出时长
-        /// </summary>
-        [Category("[1] 视频参数"), DisplayName("时长"), Description("可以从模型列表查看动画时长, 如果小于 0, 则在逐个导出时每个模型使用各自的当前动画时长")]
-        public float Duration 
-        { 
-            get => duration;
-            set => duration = value < 0 ? -1 : value;
-        }
-        private float duration = -1;
-
-        /// <summary>
-        /// 帧率
-        /// </summary>
-        [Category("[1] 视频参数"), DisplayName("帧率"), Description("每秒画面数")]
-        public float FPS { get; set; } = 60;
-
-        public override string? Validate()
-        {
-            if (base.Validate() is string error)
-                return error;
-            if (ExportSingle && Duration < 0)
-                return "导出单个时导出时长不能为负数";
-            return null;
-        }
-    }
-}

SpineViewer/Exporter/Implementations/Exporter/FrameExporter.cs

@@ -1,86 +0,0 @@
-using SpineViewer.Exporter.Implementations.ExportArgs;
-using SpineViewer.Spine;
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Exporter.Implementations.Exporter
-{
-    /// <summary>
-    /// 单帧画面导出器
-    /// </summary>
-    [ExportImplementation(ExportType.Frame)]
-    public class FrameExporter : SpineViewer.Exporter.Exporter
-    {
-        public FrameExporter(FrameExportArgs exportArgs) : base(exportArgs) { }
-
-        protected override void ExportSingle(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
-        {
-            var args = (FrameExportArgs)ExportArgs;
-
-            // 导出单个时必定提供输出文件夹
-            var filename = $"frame_{timestamp}{args.FileSuffix}";
-            var savePath = Path.Combine(args.OutputDir, filename);
-
-            worker?.ReportProgress(0, $"已处理 0/1");
-            try
-            {
-                using var frame = GetFrame(spinesToRender);
-                using var img = frame.CopyToBitmap();
-                img.SetResolution(args.DPI.Width, args.DPI.Height);
-                img.Save(savePath, args.ImageFormat);
-            }
-            catch (Exception ex)
-            {
-                Program.Logger.Error(ex.ToString());
-                Program.Logger.Error("Failed to save single frame");
-            }
-            worker?.ReportProgress(100, $"已处理 1/1");
-        }
-
-        protected override void ExportIndividual(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
-        {
-            var args = (FrameExportArgs)ExportArgs;
-
-            int total = spinesToRender.Length;
-            int success = 0;
-            int error = 0;
-
-            worker?.ReportProgress(0, $"已处理 0/{total}");
-            for (int i = 0; i < total; i++)
-            {
-                var spine = spinesToRender[i];
-
-                // 逐个导出时如果提供了输出文件夹, 则全部导出到输出文件夹, 否则输出到各自的文件夹
-                var filename = $"{spine.Name}_{timestamp}{args.FileSuffix}";
-                var savePath = args.OutputDir is null ? Path.Combine(spine.AssetsDir, filename) : Path.Combine(args.OutputDir, filename);
-
-                try
-                {
-                    using var frame = GetFrame(spine);
-                    using var img = frame.CopyToBitmap();
-                    img.SetResolution(args.DPI.Width, args.DPI.Height);
-                    img.Save(savePath, args.ImageFormat);
-                    success++;
-                }
-                catch (Exception ex)
-                {
-                    Program.Logger.Error(ex.ToString());
-                    Program.Logger.Error("Failed to save frame {} {}", savePath, spine.SkelPath);
-                    error++;
-                }
-
-                worker?.ReportProgress((int)((i + 1) * 100.0) / total, $"已处理 {i + 1}/{total}");
-            }
-
-            if (error > 0)
-                Program.Logger.Warn("Frames save {} successfully, {} failed", success, error);
-            else
-                Program.Logger.Info("{} frames saved successfully", success);
-        }
-    }
-
-}

SpineViewer/Exporter/Implementations/Exporter/GifExporter.cs

@@ -1,76 +0,0 @@
-using FFMpegCore.Pipes;
-using FFMpegCore;
-using SpineViewer.Exporter.Implementations.ExportArgs;
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using FFMpegCore.Arguments;
-
-namespace SpineViewer.Exporter.Implementations.Exporter
-{
-    /// <summary>
-    /// GIF 动图导出器
-    /// </summary>
-    [ExportImplementation(ExportType.GIF)]
-    public class GifExporter : VideoExporter
-    {
-        public GifExporter(GifExportArgs exportArgs) : base(exportArgs) { }
-
-        protected override void ExportSingle(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
-        {
-            var args = (GifExportArgs)ExportArgs;
-
-            // 导出单个时必定提供输出文件夹
-            var filename = $"{timestamp}_{args.FPS:f0}_{args.MaxColors}_{args.AlphaThreshold}.gif";
-            var savePath = Path.Combine(args.OutputDir, filename);
-
-            var videoFramesSource = new RawVideoPipeSource(GetFrames(spinesToRender, worker)) { FrameRate = args.FPS };
-            try
-            {
-                FFMpegArguments
-                .FromPipeInput(videoFramesSource)
-                .OutputToFile(savePath, true, options => options
-                .ForceFormat("gif")
-                .WithCustomArgument(args.FFMpegCoreCustomArguments))
-                .ProcessSynchronously();
-            }
-            catch (Exception ex)
-            {
-                Program.Logger.Error(ex.ToString());
-                Program.Logger.Error("Failed to export gif {}", savePath);
-            }
-        }
-
-        protected override void ExportIndividual(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
-        {
-            var args = (GifExportArgs)ExportArgs;
-            foreach (var spine in spinesToRender)
-            {
-                if (worker?.CancellationPending == true) break; // 取消的日志在 GetFrames 里输出
-
-                // 如果提供了输出文件夹, 则全部导出到输出文件夹, 否则导出到各自的文件夹下
-                var filename = $"{spine.Name}_{timestamp}_{args.FPS:f0}_{args.MaxColors}_{args.AlphaThreshold}.gif";
-                var savePath = Path.Combine(args.OutputDir ?? spine.AssetsDir, filename);
-
-                var videoFramesSource = new RawVideoPipeSource(GetFrames(spine, worker)) { FrameRate = args.FPS };
-                try
-                {
-                    FFMpegArguments
-                    .FromPipeInput(videoFramesSource)
-                    .OutputToFile(savePath, true, options => options
-                    .ForceFormat("gif")
-                    .WithCustomArgument(args.FFMpegCoreCustomArguments))
-                    .ProcessSynchronously();
-                }
-                catch (Exception ex)
-                {
-                    Program.Logger.Error(ex.ToString());
-                    Program.Logger.Error("Failed to export gif {} {}", savePath, spine.SkelPath);
-                }
-            }
-        }
-    }
-}

SpineViewer/Exporter/Implementations/Exporter/VideoExporter.cs

@@ -1,82 +0,0 @@
-using SpineViewer.Exporter.Implementations.ExportArgs;
-using SpineViewer.Spine;
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Exporter.Implementations.Exporter
-{
-    /// <summary>
-    /// 视频导出基类
-    /// </summary>
-    public abstract class VideoExporter : SpineViewer.Exporter.Exporter
-    {
-        public VideoExporter(VideoExportArgs exportArgs) : base(exportArgs) { }
-
-        /// <summary>
-        /// 生成单个模型的帧序列
-        /// </summary>
-        protected IEnumerable<SFMLImageVideoFrame> GetFrames(Spine.Spine spine, BackgroundWorker? worker = null)
-        {
-            var args = (VideoExportArgs)ExportArgs;
-
-            // 独立导出时如果 args.Duration 小于 0 则使用自己的动画时长
-            var duration = args.Duration;
-            if (duration < 0) duration = spine.CurrentAnimationDuration;
-
-            float delta = 1f / args.FPS;
-            int total = Math.Max(1, (int)(duration * args.FPS)); // 至少导出 1 帧
-
-            worker?.ReportProgress(0, $"{spine.Name} 已处理 0/{total} 帧");
-            for (int i = 0; i < total; i++)
-            {
-                if (worker?.CancellationPending == true)
-                {
-                    Program.Logger.Info("Export cancelled");
-                    break;
-                }
-
-                var frame = GetFrame(spine);
-                spine.Update(delta);
-                worker?.ReportProgress((int)((i + 1) * 100.0) / total, $"{spine.Name} 已处理 {i + 1}/{total} 帧");
-                yield return frame;
-            }
-        }
-
-        /// <summary>
-        /// 生成多个模型的帧序列
-        /// </summary>
-        protected IEnumerable<SFMLImageVideoFrame> GetFrames(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
-        {
-            // 导出单个时必须根据 args.Duration 决定导出时长
-            var args = (VideoExportArgs)ExportArgs;
-            float delta = 1f / args.FPS;
-            int total = Math.Max(1, (int)(args.Duration * args.FPS)); // 至少导出 1 帧
-
-            worker?.ReportProgress(0, $"已处理 0/{total} 帧");
-            for (int i = 0; i < total; i++)
-            {
-                if (worker?.CancellationPending == true)
-                {
-                    Program.Logger.Info("Export cancelled");
-                    break;
-                }
-
-                var frame = GetFrame(spinesToRender);
-                foreach (var spine in spinesToRender) spine.Update(delta);
-                worker?.ReportProgress((int)((i + 1) * 100.0) / total, $"已处理 {i + 1}/{total} 帧");
-                yield return frame;
-            }
-        }
-
-        public override void Export(Spine.Spine[] spines, BackgroundWorker? worker = null)
-        {
-            // 导出视频格式需要把模型时间都重置到 0
-            foreach (var spine in spines) spine.CurrentAnimation = spine.CurrentAnimation;
-            base.Export(spines, worker);
-        }
-    }
-}

SpineViewer/Exporter/MkvExporter.cs

@@ -0,0 +1,49 @@
+using FFMpegCore;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// MKV 导出参数
+    /// </summary>
+    public class MkvExporter : FFmpegVideoExporter
+    {
+        public MkvExporter()
+        {
+            BackgroundColor = new(0, 255, 0);
+        }
+
+        public override string Format => "matroska";
+
+        public override string Suffix => ".mkv";
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        public string Codec { get; set; } = "libx265";
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        public int CRF { get => crf; set => crf = Math.Clamp(value, 0, 63); }
+        private int crf = 23;
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        public string PixelFormat { get; set; } = "yuv444p";
+
+        public override string FileNameNoteSuffix => $"{Codec}_{CRF}_{PixelFormat}";
+
+        public override void SetOutputOptions(FFMpegArgumentOptions options)
+        {
+            base.SetOutputOptions(options);
+            options.WithVideoCodec(Codec).WithConstantRateFactor(CRF).ForcePixelFormat(PixelFormat);
+        }
+    }
+}

SpineViewer/Exporter/MovExporter.cs

@@ -0,0 +1,48 @@
+using FFMpegCore;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// MOV 导出参数
+    /// </summary>
+    public class MovExporter : FFmpegVideoExporter
+    {
+        public MovExporter()
+        {
+            BackgroundColor = new(0, 255, 0);
+        }
+
+        public override string Format => "mov";
+
+        public override string Suffix => ".mov";
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        public string Codec { get; set; } = "prores_ks";
+
+        /// <summary>
+        /// 预设
+        /// </summary>
+        public string Profile { get; set; } = "auto";
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        public string PixelFormat { get; set; } = "yuva444p10le";
+
+        public override string FileNameNoteSuffix => $"{Codec}_{Profile}_{PixelFormat}";
+
+        public override void SetOutputOptions(FFMpegArgumentOptions options)
+        {
+            base.SetOutputOptions(options);
+            options.WithFastStart().WithVideoCodec(Codec).WithCustomArgument($"-profile {Profile}").ForcePixelFormat(PixelFormat);
+        }
+    }
+}

SpineViewer/Exporter/Mp4Exporter.cs

@@ -0,0 +1,49 @@
+using FFMpegCore;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// MP4 导出参数
+    /// </summary>
+    public class Mp4Exporter : FFmpegVideoExporter
+    {
+        public Mp4Exporter()
+        {
+            BackgroundColor = new(0, 255, 0);
+        }
+
+        public override string Format => "mp4";
+
+        public override string Suffix => ".mp4";
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        public string Codec { get; set; } = "libx264";
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        public int CRF { get => crf; set => crf = Math.Clamp(value, 0, 63); }
+        private int crf = 23;
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        public string PixelFormat { get; set; } = "yuv444p";
+
+        public override string FileNameNoteSuffix => $"{Codec}_{CRF}_{PixelFormat}";
+
+        public override void SetOutputOptions(FFMpegArgumentOptions options)
+        {
+            base.SetOutputOptions(options);
+            options.WithFastStart().WithVideoCodec(Codec).WithConstantRateFactor(CRF).ForcePixelFormat(PixelFormat);
+        }
+    }
+}

SpineViewer/Exporter/TypeConverter.cs

@@ -1,33 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Collections.ObjectModel;
-using System.ComponentModel;
-using System.Diagnostics.CodeAnalysis;
-using System.Globalization;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Exporter
-{
-    public class SFMLImageFileSuffixConverter : StringConverter
-    {
-        private readonly string[] supportedFileSuffix = [".png", ".jpg", ".tga", ".bmp"];
-        public override bool GetStandardValuesSupported(ITypeDescriptorContext? context)
-        {
-            // 支持标准值列表
-            return true;
-        }
-
-        public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context)
-        {
-            // 排他模式，只有下拉列表中的值可选
-            return true;
-        }
-
-        public override StandardValuesCollection? GetStandardValues(ITypeDescriptorContext? context)
-        {
-            return new StandardValuesCollection(supportedFileSuffix);
-        }
-    }
-}

SpineViewer/Exporter/VideoExporter.cs

@@ -0,0 +1,145 @@
+using SpineViewer.Spine;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// 视频导出基类
+    /// </summary>
+    public abstract class VideoExporter : Exporter
+    {
+        /// <summary>
+        /// 导出时长
+        /// </summary>
+        public float Duration { get => duration; set => duration = value < 0 ? -1 : value; }
+        private float duration = -1;
+
+        /// <summary>
+        /// 帧率
+        /// </summary>
+        public float FPS { get; set; } = 60;
+
+        /// <summary>
+        /// 是否保留最后一帧
+        /// </summary>
+        public bool KeepLast { get; set; } = true;
+
+        public override string? Validate()
+        {
+            if (base.Validate() is string error)
+                return error;
+            if (IsExportSingle && Duration < 0)
+                return "导出单个时导出时长不能为负数";
+            return null;
+        }
+
+        /// <summary>
+        /// 生成单个模型的帧序列
+        /// </summary>
+        protected IEnumerable<SFMLImageVideoFrame> GetFrames(Spine.Spine spine, BackgroundWorker? worker = null)
+        {
+            // 独立导出时如果 Duration 小于 0 则使用所有轨道上动画时长最大值
+            var duration = Duration;
+            if (duration < 0) duration = spine.GetTrackIndices().Select(i => spine.GetAnimationDuration(spine.GetAnimation(i))).Max();
+
+            float delta = 1f / FPS;
+            int total = (int)(duration * FPS); // 完整帧的数量
+
+            float deltaFinal = duration - delta * total; // 最后一帧时长
+            int final = (KeepLast && (deltaFinal > 1e-3)) ? 1 : 0;
+
+            int frameCount = 1 + total + final; // 所有帧的数量 = 起始帧 + 完整帧 + 最后一帧
+
+            worker?.ReportProgress(0, $"{spine.Name} 已处理 0/{frameCount} 帧");
+
+            // 导出首帧
+            var firstFrame = GetFrame(spine);
+            worker?.ReportProgress(1 * 100 / frameCount, $"{spine.Name} 已处理 1/{frameCount} 帧");
+            yield return firstFrame;
+
+            // 导出完整帧
+            for (int i = 0; i < total; i++)
+            {
+                if (worker?.CancellationPending == true)
+                {
+                    logger.Info("Export cancelled");
+                    break;
+                }
+
+                spine.Update(delta);
+                var frame = GetFrame(spine);
+                worker?.ReportProgress((1 + i + 1) * 100 / frameCount, $"{spine.Name} 已处理 {1 + i + 1}/{frameCount} 帧");
+                yield return frame;
+            }
+
+            // 导出最后一帧
+            if (final > 0)
+            {
+                spine.Update(deltaFinal);
+                var finalFrame = GetFrame(spine);
+                worker?.ReportProgress(100, $"{spine.Name} 已处理 {frameCount}/{frameCount} 帧");
+                yield return finalFrame;
+            }
+        }
+
+        /// <summary>
+        /// 生成多个模型的帧序列
+        /// </summary>
+        protected IEnumerable<SFMLImageVideoFrame> GetFrames(Spine.Spine[] spinesToRender, BackgroundWorker? worker = null)
+        {
+            // 导出单个时必须根据 Duration 决定导出时长
+            var duration = Duration;
+
+            float delta = 1f / FPS;
+            int total = (int)(duration * FPS); // 完整帧的数量
+
+            float deltaFinal = duration - delta * total; // 最后一帧时长
+            int final = (KeepLast && (deltaFinal > 1e-3)) ? 1 : 0;
+
+            int frameCount = 1 + total + final; // 所有帧的数量 = 起始帧 + 完整帧 + 最后一帧
+
+            worker?.ReportProgress(0, $"已处理 0/{frameCount} 帧");
+
+            // 导出首帧
+            var firstFrame = GetFrame(spinesToRender);
+            worker?.ReportProgress(1 * 100 / frameCount, $"已处理 1/{frameCount} 帧");
+            yield return firstFrame;
+
+            // 导出完整帧
+            for (int i = 0; i < total; i++)
+            {
+                if (worker?.CancellationPending == true)
+                {
+                    logger.Info("Export cancelled");
+                    break;
+                }
+
+                foreach (var spine in spinesToRender) spine.Update(delta);
+                var frame = GetFrame(spinesToRender);
+                worker?.ReportProgress((1 + i + 1) * 100 / frameCount, $"已处理 {1 + i + 1}/{frameCount} 帧");
+                yield return frame;
+            }
+
+            // 导出最后一帧
+            if (final > 0)
+            {
+                foreach (var spine in spinesToRender) spine.Update(delta);
+                var finalFrame = GetFrame(spinesToRender);
+                worker?.ReportProgress(100, $"已处理 {frameCount}/{frameCount} 帧");
+                yield return finalFrame;
+            }
+        }
+
+        public override void Export(Spine.Spine[] spines, BackgroundWorker? worker = null)
+        {
+            // 导出视频格式需要把模型时间都重置到 0
+            foreach (var spine in spines) spine.ResetAnimationsTime();
+            base.Export(spines, worker);
+        }
+    }
+}

SpineViewer/Exporter/WebmExporter.cs

@@ -0,0 +1,50 @@
+using FFMpegCore;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// WebM 导出参数
+    /// </summary>
+    public class WebmExporter : FFmpegVideoExporter
+    {
+        public WebmExporter()
+        {
+            // 默认用透明黑背景
+            BackgroundColor = new(0, 0, 0, 0);
+        }
+
+        public override string Format => "webm";
+
+        public override string Suffix => ".webm";
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        public string Codec { get; set; } = "libvpx-vp9";
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        public int CRF { get => crf; set => crf = Math.Clamp(value, 0, 63); }
+        private int crf = 23;
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        public string PixelFormat { get; set; } = "yuva420p";
+
+        public override string FileNameNoteSuffix => $"{Codec}_{CRF}_{PixelFormat}";
+
+        public override void SetOutputOptions(FFMpegArgumentOptions options)
+        {
+            base.SetOutputOptions(options);
+            options.WithVideoCodec(Codec).WithConstantRateFactor(CRF).ForcePixelFormat(PixelFormat);
+        }
+    }
+}

SpineViewer/Exporter/WebpExporter.cs

@@ -0,0 +1,60 @@
+using FFMpegCore;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Exporter
+{
+    /// <summary>
+    /// MP4 导出参数
+    /// </summary>
+    public class WebpExporter : FFmpegVideoExporter
+    {
+        public WebpExporter()
+        {
+            FPS = 24;
+        }
+
+        public override string Format => "webp";
+
+        public override string Suffix => ".webp";
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        public string Codec { get; set; } = "libwebp_anim";
+
+        /// <summary>
+        /// 是否无损
+        /// </summary>
+        public bool Lossless { get; set; } = false;
+
+        /// <summary>
+        /// 质量
+        /// </summary>
+        public int Quality { get => quality; set => quality = Math.Clamp(value, 0, 100); }
+        private int quality = 75;
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        public string PixelFormat { get; set; } = "yuva420p";
+
+        /// <summary>
+        /// 循环次数, 0 无限循环, 取值范围 [0, 65535]
+        /// </summary>
+        public int Loop { get => loop; set => loop = Math.Clamp(value, 0, 65535); }
+        private int loop = 0;
+
+        public override string FileNameNoteSuffix => $"{Codec}_{Quality}_{PixelFormat}";
+
+        public override void SetOutputOptions(FFMpegArgumentOptions options)
+        {
+            base.SetOutputOptions(options);
+            options.WithVideoCodec(Codec).WithCustomArgument($"-lossless {(Lossless ? 1 : 0)} -quality {Quality} -loop {Loop}");
+        }
+    }
+}

SpineViewer/Extensions/NLogExtension.cs

@@ -0,0 +1,21 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Extensions
+{
+    public static class NLogExtension
+    {
+        /// <summary>
+        /// 输出当前进程的内存占用
+        /// </summary>
+        public static void LogCurrentProcessMemoryUsage(this NLog.Logger logger)
+        {
+            var process = Process.GetCurrentProcess();
+            logger.Info("Current memory usage for {}: {:F2} MB", process.ProcessName, process.WorkingSet64 / 1024.0 / 1024.0);
+        }
+    }
+}

SpineViewer/Extensions/SFMLExtension.cs

@@ -0,0 +1,73 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Extensions
+{
+    public static class SFMLExtension
+    {
+        /// <summary>
+        /// 获取 Winforms Bitmap 对象, 需要使用 Dispose 释放对象
+        /// </summary>
+        public static Bitmap CopyToBitmap(this SFML.Graphics.Image image)
+        {
+            image.SaveToMemory(out var imgBuffer, "bmp");
+            using var stream = new MemoryStream(imgBuffer);
+            using var bitmap = new Bitmap(stream);
+            return new(bitmap); // 必须重复构造一个副本才能摆脱对流的依赖, 否则之后使用会报错
+        }
+
+        /// <summary>
+        /// 获取 Winforms Bitmap 对象, 需要使用 Dispose 释放对象
+        /// </summary>
+        public static Bitmap CopyToBitmap(this SFML.Graphics.Texture texture)
+        {
+            using var image = texture.CopyToImage();
+            return image.CopyToBitmap();
+        }
+
+        /// <summary>
+        /// 获取某个包围盒下合适的视图
+        /// </summary>
+        public static SFML.Graphics.View GetView(this RectangleF bounds, Size resolution, Padding padding)
+            => bounds.GetView((uint)resolution.Width, (uint)resolution.Height, (uint)padding.Left, (uint)padding.Right, (uint)padding.Top, (uint)padding.Bottom);
+
+        /// <summary>
+        /// 获取某个包围盒下合适的视图
+        /// </summary>
+        public static SFML.Graphics.View GetView(this RectangleF bounds, uint width, uint height, Padding padding)
+            => bounds.GetView(width, height, (uint)padding.Left, (uint)padding.Right, (uint)padding.Top, (uint)padding.Bottom);
+
+        /// <summary>
+        /// 获取某个包围盒下合适的视图
+        /// </summary>
+        public static SFML.Graphics.View GetView(this RectangleF bounds, Size resolution, uint paddingL = 1, uint paddingR = 1, uint paddingT = 1, uint paddingB = 1)
+            => bounds.GetView((uint)resolution.Width, (uint)resolution.Height, paddingL, paddingR, paddingT, paddingB);
+
+        /// <summary>
+        /// 获取某个包围盒下合适的视图
+        /// </summary>
+        public static SFML.Graphics.View GetView(this RectangleF bounds, uint width, uint height, uint paddingL = 1, uint paddingR = 1, uint paddingT = 1, uint paddingB = 1)
+        {
+            float sizeX = bounds.Width;
+            float sizeY = bounds.Height;
+            float innerW = width - paddingL - paddingR;
+            float innerH = height - paddingT - paddingB;
+
+            float scale = 1;
+            if (sizeY / sizeX < innerH / innerW)
+                scale = sizeX / innerW; // 相同的 X, 视窗 Y 更大
+            else
+                scale = sizeY / innerH; // 相同的 Y, 视窗 X 更大
+
+            var x = bounds.X + bounds.Width / 2 + (paddingL - (float)paddingR) * scale;
+            var y = bounds.Y + bounds.Height / 2 + (paddingT - (float)paddingB) * scale;
+            var viewX = width * scale;
+            var viewY = height * scale;
+
+            return new(new(x, y), new(viewX, -viewY));
+        }
+    }
+}

SpineViewer/Forms/PetForm.Designer.cs

@@ -0,0 +1,50 @@
+namespace SpineViewer
+{
+    partial class PetForm
+    {
+        /// <summary>
+        /// Required designer variable.
+        /// </summary>
+        private System.ComponentModel.IContainer components = null;
+
+        /// <summary>
+        /// Clean up any resources being used.
+        /// </summary>
+        /// <param name="disposing">true if managed resources should be disposed; otherwise, false.</param>
+        protected override void Dispose(bool disposing)
+        {
+            if (disposing && (components != null))
+            {
+                components.Dispose();
+            }
+            base.Dispose(disposing);
+        }
+
+        #region Windows Form Designer generated code
+
+        /// <summary>
+        /// Required method for Designer support - do not modify
+        /// the contents of this method with the code editor.
+        /// </summary>
+        private void InitializeComponent()
+        {
+            SuspendLayout();
+            // 
+            // PetForm
+            // 
+            AutoScaleMode = AutoScaleMode.None;
+            ClientSize = new Size(490, 456);
+            ControlBox = false;
+            MaximizeBox = false;
+            MinimizeBox = false;
+            Name = "PetForm";
+            ShowIcon = false;
+            ShowInTaskbar = false;
+            StartPosition = FormStartPosition.Manual;
+            Text = "PetForm";
+            ResumeLayout(false);
+        }
+
+        #endregion
+    }
+}

SpineViewer/Forms/PetForm.cs

@@ -0,0 +1,49 @@
+using SpineViewer.Natives;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Data;
+using System.Drawing;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Windows.Forms;
+
+namespace SpineViewer
+{
+    public partial class PetForm: Form
+    {
+        public PetForm()
+        {
+            InitializeComponent();
+        }
+
+        protected override CreateParams CreateParams
+        {
+            get
+            {
+                //var style = Win32.GetWindowLong(hWnd, Win32.GWL_STYLE) | Win32.WS_POPUP;
+                //var exStyle = Win32.GetWindowLong(hWnd, Win32.GWL_EXSTYLE) | Win32.WS_EX_LAYERED | Win32.WS_EX_TOOLWINDOW | Win32.WS_EX_TOPMOST;
+                //Win32.SetWindowLong(hWnd, Win32.GWL_STYLE, style);
+                //Win32.SetWindowLong(hWnd, Win32.GWL_EXSTYLE, exStyle);
+                //Win32.SetLayeredWindowAttributes(hWnd, crKey, 255, Win32.LWA_COLORKEY | Win32.LWA_ALPHA);
+                //Win32.SetWindowPos(hWnd, Win32.HWND_TOPMOST, 0, 0, 0, 0, Win32.SWP_NOMOVE | Win32.SWP_NOSIZE);
+                var cp = base.CreateParams;
+                cp.ExStyle = Win32.WS_EX_LAYERED | Win32.WS_EX_TOPMOST;
+                cp.Style = Win32.WS_POPUP;
+                //cp.ExStyle |= Win32.WS_EX_LAYERED | Win32.WS_EX_TOOLWINDOW | Win32.WS_EX_TOPMOST;
+                return cp;
+            }
+        }
+
+        protected override void OnPaint(PaintEventArgs e)
+        {
+            ;
+        }
+
+        protected override void OnPaintBackground(PaintEventArgs e)
+        {
+            ;
+        }
+    }
+}

SpineViewer/Forms/PetForm.resx

@@ -0,0 +1,120 @@
+<?xml version="1.0" encoding="utf-8"?>
+<root>
+  <!--
+    Microsoft ResX Schema
+
+    Version 2.0
+
+    The primary goals of this format is to allow a simple XML format
+    that is mostly human readable. The generation and parsing of the
+    various data types are done through the TypeConverter classes
+    associated with the data types.
+
+    Example:
+
+    ... ado.net/XML headers & schema ...
+    <resheader name="resmimetype">text/microsoft-resx</resheader>
+    <resheader name="version">2.0</resheader>
+    <resheader name="reader">System.Resources.ResXResourceReader, System.Windows.Forms, ...</resheader>
+    <resheader name="writer">System.Resources.ResXResourceWriter, System.Windows.Forms, ...</resheader>
+    <data name="Name1"><value>this is my long string</value><comment>this is a comment</comment></data>
+    <data name="Color1" type="System.Drawing.Color, System.Drawing">Blue</data>
+    <data name="Bitmap1" mimetype="application/x-microsoft.net.object.binary.base64">
+        <value>[base64 mime encoded serialized .NET Framework object]</value>
+    </data>
+    <data name="Icon1" type="System.Drawing.Icon, System.Drawing" mimetype="application/x-microsoft.net.object.bytearray.base64">
+        <value>[base64 mime encoded string representing a byte array form of the .NET Framework object]</value>
+        <comment>This is a comment</comment>
+    </data>
+
+    There are any number of "resheader" rows that contain simple
+    name/value pairs.
+
+    Each data row contains a name, and value. The row also contains a
+    type or mimetype. Type corresponds to a .NET class that support
+    text/value conversion through the TypeConverter architecture.
+    Classes that don't support this are serialized and stored with the
+    mimetype set.
+
+    The mimetype is used for serialized objects, and tells the
+    ResXResourceReader how to depersist the object. This is currently not
+    extensible. For a given mimetype the value must be set accordingly:
+
+    Note - application/x-microsoft.net.object.binary.base64 is the format
+    that the ResXResourceWriter will generate, however the reader can
+    read any of the formats listed below.
+
+    mimetype: application/x-microsoft.net.object.binary.base64
+    value   : The object must be serialized with
+            : System.Runtime.Serialization.Formatters.Binary.BinaryFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.soap.base64
+    value   : The object must be serialized with
+            : System.Runtime.Serialization.Formatters.Soap.SoapFormatter
+            : and then encoded with base64 encoding.
+
+    mimetype: application/x-microsoft.net.object.bytearray.base64
+    value   : The object must be serialized into a byte array
+            : using a System.ComponentModel.TypeConverter
+            : and then encoded with base64 encoding.
+    -->
+  <xsd:schema id="root" xmlns="" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:msdata="urn:schemas-microsoft-com:xml-msdata">
+    <xsd:import namespace="http://www.w3.org/XML/1998/namespace" />
+    <xsd:element name="root" msdata:IsDataSet="true">
+      <xsd:complexType>
+        <xsd:choice maxOccurs="unbounded">
+          <xsd:element name="metadata">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" />
+              </xsd:sequence>
+              <xsd:attribute name="name" use="required" type="xsd:string" />
+              <xsd:attribute name="type" type="xsd:string" />
+              <xsd:attribute name="mimetype" type="xsd:string" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="assembly">
+            <xsd:complexType>
+              <xsd:attribute name="alias" type="xsd:string" />
+              <xsd:attribute name="name" type="xsd:string" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="data">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+                <xsd:element name="comment" type="xsd:string" minOccurs="0" msdata:Ordinal="2" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" msdata:Ordinal="1" />
+              <xsd:attribute name="type" type="xsd:string" msdata:Ordinal="3" />
+              <xsd:attribute name="mimetype" type="xsd:string" msdata:Ordinal="4" />
+              <xsd:attribute ref="xml:space" />
+            </xsd:complexType>
+          </xsd:element>
+          <xsd:element name="resheader">
+            <xsd:complexType>
+              <xsd:sequence>
+                <xsd:element name="value" type="xsd:string" minOccurs="0" msdata:Ordinal="1" />
+              </xsd:sequence>
+              <xsd:attribute name="name" type="xsd:string" use="required" />
+            </xsd:complexType>
+          </xsd:element>
+        </xsd:choice>
+      </xsd:complexType>
+    </xsd:element>
+  </xsd:schema>
+  <resheader name="resmimetype">
+    <value>text/microsoft-resx</value>
+  </resheader>
+  <resheader name="version">
+    <value>2.0</value>
+  </resheader>
+  <resheader name="reader">
+    <value>System.Resources.ResXResourceReader, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+  <resheader name="writer">
+    <value>System.Resources.ResXResourceWriter, System.Windows.Forms, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089</value>
+  </resheader>
+</root>

SpineViewer/Forms/SpineViewerForm.Designer.cs

@@ -1,6 +1,6 @@
 namespace SpineViewer
 {
-    partial class MainForm
+    partial class SpineViewerForm
     {
         /// <summary>
         ///  Required designer variable.
@@ -29,7 +29,7 @@
         private void InitializeComponent()
         {
             components = new System.ComponentModel.Container();
-            System.ComponentModel.ComponentResourceManager resources = new System.ComponentModel.ComponentResourceManager(typeof(MainForm));
+            System.ComponentModel.ComponentResourceManager resources = new System.ComponentModel.ComponentResourceManager(typeof(SpineViewerForm));
             menuStrip = new MenuStrip();
             toolStripMenuItem_File = new ToolStripMenuItem();
             toolStripMenuItem_Open = new ToolStripMenuItem();
@@ -39,10 +39,11 @@
             toolStripMenuItem_ExportFrame = new ToolStripMenuItem();
             toolStripMenuItem_ExportFrameSequence = new ToolStripMenuItem();
             toolStripMenuItem_ExportGif = new ToolStripMenuItem();
-            toolStripMenuItem_ExportMkv = new ToolStripMenuItem();
             toolStripMenuItem_ExportMp4 = new ToolStripMenuItem();
-            toolStripMenuItem_ExportMov = new ToolStripMenuItem();
             toolStripMenuItem_ExportWebm = new ToolStripMenuItem();
+            toolStripMenuItem_ExportMkv = new ToolStripMenuItem();
+            toolStripMenuItem_ExportMov = new ToolStripMenuItem();
+            toolStripMenuItem_ExportCustom = new ToolStripMenuItem();
             toolStripSeparator2 = new ToolStripSeparator();
             toolStripMenuItem_Exit = new ToolStripMenuItem();
             toolStripMenuItem_Tool = new ToolStripMenuItem();
@@ -59,15 +60,22 @@
             splitContainer_Information = new SplitContainer();
             groupBox_SkelList = new GroupBox();
             spineListView = new SpineViewer.Controls.SpineListView();
-            propertyGrid_Spine = new PropertyGrid();
-            splitContainer_Config = new SplitContainer();
-            groupBox_SkelConfig = new GroupBox();
+            spinePropertyGrid = new SpineViewer.Controls.SpinePropertyGrid();
+            tabControl_Config = new TabControl();
+            tabPage_Previewer = new TabPage();
             groupBox_PreviewConfig = new GroupBox();
             propertyGrid_Previewer = new PropertyGrid();
+            tabPage_SpineProperty = new TabPage();
+            groupBox_SkelConfig = new GroupBox();
             groupBox_Preview = new GroupBox();
             spinePreviewer = new SpineViewer.Controls.SpinePreviewer();
             panel_MainForm = new Panel();
             toolTip = new ToolTip(components);
+            toolStripSeparator4 = new ToolStripSeparator();
+            toolStripSeparator5 = new ToolStripSeparator();
+            toolStripSeparator6 = new ToolStripSeparator();
+            toolStripMenuItem_ExportWebp = new ToolStripMenuItem();
+            toolStripMenuItem_ExportAvif = new ToolStripMenuItem();
             menuStrip.SuspendLayout();
             ((System.ComponentModel.ISupportInitialize)splitContainer_MainForm).BeginInit();
             splitContainer_MainForm.Panel1.SuspendLayout();
@@ -82,12 +90,11 @@
             splitContainer_Information.Panel2.SuspendLayout();
             splitContainer_Information.SuspendLayout();
             groupBox_SkelList.SuspendLayout();
-            ((System.ComponentModel.ISupportInitialize)splitContainer_Config).BeginInit();
-            splitContainer_Config.Panel1.SuspendLayout();
-            splitContainer_Config.Panel2.SuspendLayout();
-            splitContainer_Config.SuspendLayout();
-            groupBox_SkelConfig.SuspendLayout();
+            tabControl_Config.SuspendLayout();
+            tabPage_Previewer.SuspendLayout();
             groupBox_PreviewConfig.SuspendLayout();
+            tabPage_SpineProperty.SuspendLayout();
+            groupBox_SkelConfig.SuspendLayout();
             groupBox_Preview.SuspendLayout();
             panel_MainForm.SuspendLayout();
             SuspendLayout();
@@ -99,7 +106,7 @@
             menuStrip.Items.AddRange(new ToolStripItem[] { toolStripMenuItem_File, toolStripMenuItem_Tool, toolStripMenuItem_Download, toolStripMenuItem_Help });
             menuStrip.Location = new Point(0, 0);
             menuStrip.Name = "menuStrip";
-            menuStrip.Size = new Size(1748, 32);
+            menuStrip.Size = new Size(1778, 32);
             menuStrip.TabIndex = 0;
             menuStrip.Text = "菜单";
             // 
@@ -114,88 +121,95 @@
             // 
             toolStripMenuItem_Open.Name = "toolStripMenuItem_Open";
             toolStripMenuItem_Open.ShortcutKeys = Keys.Control | Keys.O;
-            toolStripMenuItem_Open.Size = new Size(254, 34);
+            toolStripMenuItem_Open.Size = new Size(270, 34);
             toolStripMenuItem_Open.Text = "打开(&O)...";
             toolStripMenuItem_Open.Click += toolStripMenuItem_Open_Click;
             // 
             // toolStripMenuItem_BatchOpen
             // 
             toolStripMenuItem_BatchOpen.Name = "toolStripMenuItem_BatchOpen";
-            toolStripMenuItem_BatchOpen.Size = new Size(254, 34);
+            toolStripMenuItem_BatchOpen.Size = new Size(270, 34);
             toolStripMenuItem_BatchOpen.Text = "批量打开(&B)...";
             toolStripMenuItem_BatchOpen.Click += toolStripMenuItem_BatchOpen_Click;
             // 
             // toolStripSeparator1
             // 
             toolStripSeparator1.Name = "toolStripSeparator1";
-            toolStripSeparator1.Size = new Size(251, 6);
+            toolStripSeparator1.Size = new Size(267, 6);
             // 
             // toolStripMenuItem_Export
             // 
-            toolStripMenuItem_Export.DropDownItems.AddRange(new ToolStripItem[] { toolStripMenuItem_ExportFrame, toolStripMenuItem_ExportFrameSequence, toolStripMenuItem_ExportGif, toolStripMenuItem_ExportMkv, toolStripMenuItem_ExportMp4, toolStripMenuItem_ExportMov, toolStripMenuItem_ExportWebm });
+            toolStripMenuItem_Export.DropDownItems.AddRange(new ToolStripItem[] { toolStripMenuItem_ExportFrame, toolStripMenuItem_ExportFrameSequence, toolStripSeparator4, toolStripMenuItem_ExportGif, toolStripMenuItem_ExportWebp, toolStripMenuItem_ExportAvif, toolStripSeparator5, toolStripMenuItem_ExportMp4, toolStripMenuItem_ExportWebm, toolStripMenuItem_ExportMkv, toolStripMenuItem_ExportMov, toolStripSeparator6, toolStripMenuItem_ExportCustom });
             toolStripMenuItem_Export.Name = "toolStripMenuItem_Export";
-            toolStripMenuItem_Export.Size = new Size(254, 34);
+            toolStripMenuItem_Export.Size = new Size(270, 34);
             toolStripMenuItem_Export.Text = "导出(&E)";
             // 
             // toolStripMenuItem_ExportFrame
             // 
             toolStripMenuItem_ExportFrame.Name = "toolStripMenuItem_ExportFrame";
-            toolStripMenuItem_ExportFrame.Size = new Size(194, 34);
+            toolStripMenuItem_ExportFrame.Size = new Size(288, 34);
             toolStripMenuItem_ExportFrame.Text = "单帧画面...";
-            toolStripMenuItem_ExportFrame.Click += toolStripMenuItem_Export_Click;
+            toolStripMenuItem_ExportFrame.Click += toolStripMenuItem_ExportFrame_Click;
             // 
             // toolStripMenuItem_ExportFrameSequence
             // 
             toolStripMenuItem_ExportFrameSequence.Name = "toolStripMenuItem_ExportFrameSequence";
-            toolStripMenuItem_ExportFrameSequence.Size = new Size(194, 34);
+            toolStripMenuItem_ExportFrameSequence.Size = new Size(288, 34);
             toolStripMenuItem_ExportFrameSequence.Text = "帧序列...";
-            toolStripMenuItem_ExportFrameSequence.Click += toolStripMenuItem_Export_Click;
+            toolStripMenuItem_ExportFrameSequence.Click += toolStripMenuItem_ExportFrameSequence_Click;
             // 
             // toolStripMenuItem_ExportGif
             // 
             toolStripMenuItem_ExportGif.Name = "toolStripMenuItem_ExportGif";
-            toolStripMenuItem_ExportGif.Size = new Size(194, 34);
+            toolStripMenuItem_ExportGif.Size = new Size(288, 34);
             toolStripMenuItem_ExportGif.Text = "GIF...";
-            toolStripMenuItem_ExportGif.Click += toolStripMenuItem_Export_Click;
-            // 
-            // toolStripMenuItem_ExportMkv
-            // 
-            toolStripMenuItem_ExportMkv.Name = "toolStripMenuItem_ExportMkv";
-            toolStripMenuItem_ExportMkv.Size = new Size(194, 34);
-            toolStripMenuItem_ExportMkv.Text = "MKV";
-            toolStripMenuItem_ExportMkv.Click += toolStripMenuItem_Export_Click;
+            toolStripMenuItem_ExportGif.Click += toolStripMenuItem_ExportGif_Click;
             // 
             // toolStripMenuItem_ExportMp4
             // 
             toolStripMenuItem_ExportMp4.Name = "toolStripMenuItem_ExportMp4";
-            toolStripMenuItem_ExportMp4.Size = new Size(194, 34);
+            toolStripMenuItem_ExportMp4.Size = new Size(288, 34);
             toolStripMenuItem_ExportMp4.Text = "MP4...";
-            toolStripMenuItem_ExportMp4.Click += toolStripMenuItem_Export_Click;
-            // 
-            // toolStripMenuItem_ExportMov
-            // 
-            toolStripMenuItem_ExportMov.Name = "toolStripMenuItem_ExportMov";
-            toolStripMenuItem_ExportMov.Size = new Size(194, 34);
-            toolStripMenuItem_ExportMov.Text = "MOV...";
-            toolStripMenuItem_ExportMov.Click += toolStripMenuItem_Export_Click;
+            toolStripMenuItem_ExportMp4.Click += toolStripMenuItem_ExportMp4_Click;
             // 
             // toolStripMenuItem_ExportWebm
             // 
             toolStripMenuItem_ExportWebm.Name = "toolStripMenuItem_ExportWebm";
-            toolStripMenuItem_ExportWebm.Size = new Size(194, 34);
+            toolStripMenuItem_ExportWebm.Size = new Size(288, 34);
             toolStripMenuItem_ExportWebm.Text = "WebM...";
-            toolStripMenuItem_ExportWebm.Click += toolStripMenuItem_Export_Click;
+            toolStripMenuItem_ExportWebm.Click += toolStripMenuItem_ExportWebm_Click;
+            // 
+            // toolStripMenuItem_ExportMkv
+            // 
+            toolStripMenuItem_ExportMkv.Name = "toolStripMenuItem_ExportMkv";
+            toolStripMenuItem_ExportMkv.Size = new Size(288, 34);
+            toolStripMenuItem_ExportMkv.Text = "MKV...";
+            toolStripMenuItem_ExportMkv.Click += toolStripMenuItem_ExportMkv_Click;
+            // 
+            // toolStripMenuItem_ExportMov
+            // 
+            toolStripMenuItem_ExportMov.Name = "toolStripMenuItem_ExportMov";
+            toolStripMenuItem_ExportMov.Size = new Size(288, 34);
+            toolStripMenuItem_ExportMov.Text = "MOV...";
+            toolStripMenuItem_ExportMov.Click += toolStripMenuItem_ExportMov_Click;
+            // 
+            // toolStripMenuItem_ExportCustom
+            // 
+            toolStripMenuItem_ExportCustom.Name = "toolStripMenuItem_ExportCustom";
+            toolStripMenuItem_ExportCustom.Size = new Size(288, 34);
+            toolStripMenuItem_ExportCustom.Text = "FFmpeg 自定义导出...";
+            toolStripMenuItem_ExportCustom.Click += toolStripMenuItem_ExportCustom_Click;
             // 
             // toolStripSeparator2
             // 
             toolStripSeparator2.Name = "toolStripSeparator2";
-            toolStripSeparator2.Size = new Size(251, 6);
+            toolStripSeparator2.Size = new Size(267, 6);
             // 
             // toolStripMenuItem_Exit
             // 
             toolStripMenuItem_Exit.Name = "toolStripMenuItem_Exit";
             toolStripMenuItem_Exit.ShortcutKeys = Keys.Alt | Keys.F4;
-            toolStripMenuItem_Exit.Size = new Size(254, 34);
+            toolStripMenuItem_Exit.Size = new Size(270, 34);
             toolStripMenuItem_Exit.Text = "退出(&X)";
             toolStripMenuItem_Exit.Click += toolStripMenuItem_Exit_Click;
             // 
@@ -263,7 +277,7 @@
             rtbLog.Margin = new Padding(3, 2, 3, 2);
             rtbLog.Name = "rtbLog";
             rtbLog.ReadOnly = true;
-            rtbLog.Size = new Size(1728, 110);
+            rtbLog.Size = new Size(1758, 172);
             rtbLog.TabIndex = 0;
             rtbLog.Text = "";
             rtbLog.WordWrap = false;
@@ -272,6 +286,7 @@
             // 
             splitContainer_MainForm.Cursor = Cursors.SizeNS;
             splitContainer_MainForm.Dock = DockStyle.Fill;
+            splitContainer_MainForm.FixedPanel = FixedPanel.Panel2;
             splitContainer_MainForm.Location = new Point(10, 5);
             splitContainer_MainForm.Name = "splitContainer_MainForm";
             splitContainer_MainForm.Orientation = Orientation.Horizontal;
@@ -285,8 +300,8 @@
             // 
             splitContainer_MainForm.Panel2.Controls.Add(rtbLog);
             splitContainer_MainForm.Panel2.Cursor = Cursors.Default;
-            splitContainer_MainForm.Size = new Size(1728, 997);
-            splitContainer_MainForm.SplitterDistance = 879;
+            splitContainer_MainForm.Size = new Size(1758, 1097);
+            splitContainer_MainForm.SplitterDistance = 917;
             splitContainer_MainForm.SplitterWidth = 8;
             splitContainer_MainForm.TabIndex = 3;
             splitContainer_MainForm.TabStop = false;
@@ -297,6 +312,7 @@
             // 
             splitContainer_Functional.Cursor = Cursors.SizeWE;
             splitContainer_Functional.Dock = DockStyle.Fill;
+            splitContainer_Functional.FixedPanel = FixedPanel.Panel1;
             splitContainer_Functional.Location = new Point(0, 0);
             splitContainer_Functional.Name = "splitContainer_Functional";
             // 
@@ -309,8 +325,8 @@
             // 
             splitContainer_Functional.Panel2.Controls.Add(groupBox_Preview);
             splitContainer_Functional.Panel2.Cursor = Cursors.Default;
-            splitContainer_Functional.Size = new Size(1728, 879);
-            splitContainer_Functional.SplitterDistance = 747;
+            splitContainer_Functional.Size = new Size(1758, 917);
+            splitContainer_Functional.SplitterDistance = 759;
             splitContainer_Functional.SplitterWidth = 8;
             splitContainer_Functional.TabIndex = 2;
             splitContainer_Functional.TabStop = false;
@@ -331,10 +347,10 @@
             // 
             // splitContainer_Information.Panel2
             // 
-            splitContainer_Information.Panel2.Controls.Add(splitContainer_Config);
+            splitContainer_Information.Panel2.Controls.Add(tabControl_Config);
             splitContainer_Information.Panel2.Cursor = Cursors.Default;
-            splitContainer_Information.Size = new Size(747, 879);
-            splitContainer_Information.SplitterDistance = 399;
+            splitContainer_Information.Size = new Size(759, 917);
+            splitContainer_Information.SplitterDistance = 354;
             splitContainer_Information.SplitterWidth = 8;
             splitContainer_Information.TabIndex = 1;
             splitContainer_Information.TabStop = false;
@@ -347,7 +363,7 @@
             groupBox_SkelList.Dock = DockStyle.Fill;
             groupBox_SkelList.Location = new Point(0, 0);
             groupBox_SkelList.Name = "groupBox_SkelList";
-            groupBox_SkelList.Size = new Size(399, 879);
+            groupBox_SkelList.Size = new Size(354, 917);
             groupBox_SkelList.TabIndex = 0;
             groupBox_SkelList.TabStop = false;
             groupBox_SkelList.Text = "模型列表";
@@ -357,64 +373,51 @@
             spineListView.Dock = DockStyle.Fill;
             spineListView.Location = new Point(3, 26);
             spineListView.Name = "spineListView";
-            spineListView.PropertyGrid = propertyGrid_Spine;
-            spineListView.Size = new Size(393, 850);
+            spineListView.Size = new Size(348, 888);
+            spineListView.SpinePropertyGrid = spinePropertyGrid;
             spineListView.TabIndex = 0;
             // 
-            // propertyGrid_Spine
+            // spinePropertyGrid
             // 
-            propertyGrid_Spine.Dock = DockStyle.Fill;
-            propertyGrid_Spine.HelpVisible = false;
-            propertyGrid_Spine.Location = new Point(3, 26);
-            propertyGrid_Spine.Name = "propertyGrid_Spine";
-            propertyGrid_Spine.Size = new Size(334, 509);
-            propertyGrid_Spine.TabIndex = 0;
-            propertyGrid_Spine.ToolbarVisible = false;
-            propertyGrid_Spine.PropertyValueChanged += propertyGrid_PropertyValueChanged;
+            spinePropertyGrid.Dock = DockStyle.Fill;
+            spinePropertyGrid.Location = new Point(3, 26);
+            spinePropertyGrid.Name = "spinePropertyGrid";
+            spinePropertyGrid.Size = new Size(383, 849);
+            spinePropertyGrid.TabIndex = 0;
             // 
-            // splitContainer_Config
+            // tabControl_Config
             // 
-            splitContainer_Config.Cursor = Cursors.SizeNS;
-            splitContainer_Config.Dock = DockStyle.Fill;
-            splitContainer_Config.Location = new Point(0, 0);
-            splitContainer_Config.Name = "splitContainer_Config";
-            splitContainer_Config.Orientation = Orientation.Horizontal;
+            tabControl_Config.Alignment = TabAlignment.Bottom;
+            tabControl_Config.Controls.Add(tabPage_Previewer);
+            tabControl_Config.Controls.Add(tabPage_SpineProperty);
+            tabControl_Config.Dock = DockStyle.Fill;
+            tabControl_Config.ItemSize = new Size(100, 35);
+            tabControl_Config.Location = new Point(0, 0);
+            tabControl_Config.Multiline = true;
+            tabControl_Config.Name = "tabControl_Config";
+            tabControl_Config.Padding = new Point(0, 0);
+            tabControl_Config.SelectedIndex = 0;
+            tabControl_Config.Size = new Size(397, 917);
+            tabControl_Config.TabIndex = 0;
             // 
-            // splitContainer_Config.Panel1
+            // tabPage_Previewer
             // 
-            splitContainer_Config.Panel1.Controls.Add(groupBox_PreviewConfig);
-            splitContainer_Config.Panel1.Cursor = Cursors.Default;
-            // 
-            // splitContainer_Config.Panel2
-            // 
-            splitContainer_Config.Panel2.Controls.Add(groupBox_SkelConfig);
-            splitContainer_Config.Panel2.Cursor = Cursors.Default;
-            splitContainer_Config.Size = new Size(340, 879);
-            splitContainer_Config.SplitterDistance = 333;
-            splitContainer_Config.SplitterWidth = 8;
-            splitContainer_Config.TabIndex = 0;
-            splitContainer_Config.TabStop = false;
-            splitContainer_Config.SplitterMoved += splitContainer_SplitterMoved;
-            splitContainer_Config.MouseUp += splitContainer_MouseUp;
-            // 
-            // groupBox_SkelConfig
-            // 
-            groupBox_SkelConfig.Controls.Add(propertyGrid_Spine);
-            groupBox_SkelConfig.Dock = DockStyle.Fill;
-            groupBox_SkelConfig.Location = new Point(0, 0);
-            groupBox_SkelConfig.Name = "groupBox_SkelConfig";
-            groupBox_SkelConfig.Size = new Size(340, 538);
-            groupBox_SkelConfig.TabIndex = 0;
-            groupBox_SkelConfig.TabStop = false;
-            groupBox_SkelConfig.Text = "模型参数";
+            tabPage_Previewer.Controls.Add(groupBox_PreviewConfig);
+            tabPage_Previewer.Location = new Point(4, 4);
+            tabPage_Previewer.Margin = new Padding(0);
+            tabPage_Previewer.Name = "tabPage_Previewer";
+            tabPage_Previewer.Size = new Size(389, 874);
+            tabPage_Previewer.TabIndex = 0;
+            tabPage_Previewer.Text = "画面参数";
             // 
             // groupBox_PreviewConfig
             // 
             groupBox_PreviewConfig.Controls.Add(propertyGrid_Previewer);
             groupBox_PreviewConfig.Dock = DockStyle.Fill;
             groupBox_PreviewConfig.Location = new Point(0, 0);
+            groupBox_PreviewConfig.Margin = new Padding(0);
             groupBox_PreviewConfig.Name = "groupBox_PreviewConfig";
-            groupBox_PreviewConfig.Size = new Size(340, 333);
+            groupBox_PreviewConfig.Size = new Size(389, 874);
             groupBox_PreviewConfig.TabIndex = 1;
             groupBox_PreviewConfig.TabStop = false;
             groupBox_PreviewConfig.Text = "画面参数";
@@ -425,18 +428,41 @@
             propertyGrid_Previewer.HelpVisible = false;
             propertyGrid_Previewer.Location = new Point(3, 26);
             propertyGrid_Previewer.Name = "propertyGrid_Previewer";
-            propertyGrid_Previewer.Size = new Size(334, 304);
+            propertyGrid_Previewer.Size = new Size(383, 845);
             propertyGrid_Previewer.TabIndex = 1;
             propertyGrid_Previewer.ToolbarVisible = false;
             propertyGrid_Previewer.PropertyValueChanged += propertyGrid_PropertyValueChanged;
             // 
+            // tabPage_SpineProperty
+            // 
+            tabPage_SpineProperty.BackColor = SystemColors.Control;
+            tabPage_SpineProperty.Controls.Add(groupBox_SkelConfig);
+            tabPage_SpineProperty.Location = new Point(4, 4);
+            tabPage_SpineProperty.Margin = new Padding(0);
+            tabPage_SpineProperty.Name = "tabPage_SpineProperty";
+            tabPage_SpineProperty.Size = new Size(389, 878);
+            tabPage_SpineProperty.TabIndex = 1;
+            tabPage_SpineProperty.Text = "模型参数";
+            // 
+            // groupBox_SkelConfig
+            // 
+            groupBox_SkelConfig.Controls.Add(spinePropertyGrid);
+            groupBox_SkelConfig.Dock = DockStyle.Fill;
+            groupBox_SkelConfig.Location = new Point(0, 0);
+            groupBox_SkelConfig.Margin = new Padding(0);
+            groupBox_SkelConfig.Name = "groupBox_SkelConfig";
+            groupBox_SkelConfig.Size = new Size(389, 878);
+            groupBox_SkelConfig.TabIndex = 0;
+            groupBox_SkelConfig.TabStop = false;
+            groupBox_SkelConfig.Text = "模型参数";
+            // 
             // groupBox_Preview
             // 
             groupBox_Preview.Controls.Add(spinePreviewer);
             groupBox_Preview.Dock = DockStyle.Fill;
             groupBox_Preview.Location = new Point(0, 0);
             groupBox_Preview.Name = "groupBox_Preview";
-            groupBox_Preview.Size = new Size(973, 879);
+            groupBox_Preview.Size = new Size(991, 917);
             groupBox_Preview.TabIndex = 1;
             groupBox_Preview.TabStop = false;
             groupBox_Preview.Text = "预览画面";
@@ -447,7 +473,7 @@
             spinePreviewer.Location = new Point(3, 26);
             spinePreviewer.Name = "spinePreviewer";
             spinePreviewer.PropertyGrid = propertyGrid_Previewer;
-            spinePreviewer.Size = new Size(967, 850);
+            spinePreviewer.Size = new Size(985, 888);
             spinePreviewer.SpineListView = spineListView;
             spinePreviewer.TabIndex = 0;
             // 
@@ -458,24 +484,53 @@
             panel_MainForm.Location = new Point(0, 32);
             panel_MainForm.Name = "panel_MainForm";
             panel_MainForm.Padding = new Padding(10, 5, 10, 10);
-            panel_MainForm.Size = new Size(1748, 1012);
+            panel_MainForm.Size = new Size(1778, 1112);
             panel_MainForm.TabIndex = 4;
             // 
             // toolTip
             // 
             toolTip.ShowAlways = true;
             // 
-            // MainForm
+            // toolStripSeparator4
+            // 
+            toolStripSeparator4.Name = "toolStripSeparator4";
+            toolStripSeparator4.Size = new Size(285, 6);
+            // 
+            // toolStripSeparator5
+            // 
+            toolStripSeparator5.Name = "toolStripSeparator5";
+            toolStripSeparator5.Size = new Size(285, 6);
+            // 
+            // toolStripSeparator6
+            // 
+            toolStripSeparator6.Name = "toolStripSeparator6";
+            toolStripSeparator6.Size = new Size(285, 6);
+            // 
+            // toolStripMenuItem_ExportWebp
+            // 
+            toolStripMenuItem_ExportWebp.Name = "toolStripMenuItem_ExportWebp";
+            toolStripMenuItem_ExportWebp.Size = new Size(288, 34);
+            toolStripMenuItem_ExportWebp.Text = "WebP...";
+            toolStripMenuItem_ExportWebp.Click += toolStripMenuItem_ExportWebp_Click;
+            // 
+            // toolStripMenuItem_ExportAvif
+            // 
+            toolStripMenuItem_ExportAvif.Name = "toolStripMenuItem_ExportAvif";
+            toolStripMenuItem_ExportAvif.Size = new Size(288, 34);
+            toolStripMenuItem_ExportAvif.Text = "AVIF...";
+            toolStripMenuItem_ExportAvif.Click += toolStripMenuItem_ExportAvif_Click;
+            // 
+            // SpineViewerForm
             // 
             AutoScaleDimensions = new SizeF(11F, 24F);
             AutoScaleMode = AutoScaleMode.Font;
-            ClientSize = new Size(1748, 1044);
+            ClientSize = new Size(1778, 1144);
             Controls.Add(panel_MainForm);
             Controls.Add(menuStrip);
             Icon = (Icon)resources.GetObject("$this.Icon");
             MainMenuStrip = menuStrip;
             Margin = new Padding(3, 2, 3, 2);
-            Name = "MainForm";
+            Name = "SpineViewerForm";
             StartPosition = FormStartPosition.CenterScreen;
             Text = "SpineViewer";
             FormClosing += MainForm_FormClosing;
@@ -495,12 +550,11 @@
             ((System.ComponentModel.ISupportInitialize)splitContainer_Information).EndInit();
             splitContainer_Information.ResumeLayout(false);
             groupBox_SkelList.ResumeLayout(false);
-            splitContainer_Config.Panel1.ResumeLayout(false);
-            splitContainer_Config.Panel2.ResumeLayout(false);
-            ((System.ComponentModel.ISupportInitialize)splitContainer_Config).EndInit();
-            splitContainer_Config.ResumeLayout(false);
-            groupBox_SkelConfig.ResumeLayout(false);
+            tabControl_Config.ResumeLayout(false);
+            tabPage_Previewer.ResumeLayout(false);
             groupBox_PreviewConfig.ResumeLayout(false);
+            tabPage_SpineProperty.ResumeLayout(false);
+            groupBox_SkelConfig.ResumeLayout(false);
             groupBox_Preview.ResumeLayout(false);
             panel_MainForm.ResumeLayout(false);
             ResumeLayout(false);
@@ -521,7 +575,6 @@
         private SplitContainer splitContainer_Information;
         private GroupBox groupBox_SkelList;
         private GroupBox groupBox_SkelConfig;
-        private SplitContainer splitContainer_Config;
         private GroupBox groupBox_PreviewConfig;
         private Panel panel_MainForm;
         private ToolStripMenuItem toolStripMenuItem_Help;
@@ -529,7 +582,6 @@
         private ToolStripMenuItem toolStripMenuItem_BatchOpen;
         private GroupBox groupBox_Preview;
         private ToolTip toolTip;
-        private PropertyGrid propertyGrid_Spine;
         private Controls.SpineListView spineListView;
         private PropertyGrid propertyGrid_Previewer;
         private Controls.SpinePreviewer spinePreviewer;
@@ -547,5 +599,15 @@
         private ToolStripMenuItem toolStripMenuItem_ExportMov;
         private ToolStripMenuItem toolStripMenuItem_ExportMkv;
         private ToolStripMenuItem toolStripMenuItem_ExportWebm;
+        private ToolStripMenuItem toolStripMenuItem_ExportCustom;
+        private Controls.SpinePropertyGrid spinePropertyGrid;
+        private TabControl tabControl_Config;
+        private TabPage tabPage_Previewer;
+        private TabPage tabPage_SpineProperty;
+        private ToolStripSeparator toolStripSeparator4;
+        private ToolStripMenuItem toolStripMenuItem_ExportWebp;
+        private ToolStripMenuItem toolStripMenuItem_ExportAvif;
+        private ToolStripSeparator toolStripSeparator5;
+        private ToolStripSeparator toolStripSeparator6;
     }
 }

SpineViewer/Forms/SpineViewerForm.cs

@@ -0,0 +1,482 @@
+using NLog;
+using SpineViewer.Spine;
+using System.ComponentModel;
+using System.Diagnostics;
+using SpineViewer.Exporter;
+using System.Reflection.Metadata;
+using SpineViewer.PropertyGridWrappers.Exporter;
+using SpineViewer.Utilities;
+using SpineViewer.Natives;
+
+namespace SpineViewer
+{
+    internal partial class SpineViewerForm : Form
+    {
+        private readonly Logger logger = LogManager.GetCurrentClassLogger();
+
+        private readonly Dictionary<string, Exporter.Exporter> exporterCache = [];
+
+        public SpineViewerForm()
+        {
+            InitializeComponent();
+            InitializeLogConfiguration();
+
+            // 执行一些初始化工作
+            try
+            {
+                SFMLShader.Init();
+            }
+            catch (Exception ex)
+            {
+                logger.Error(ex.ToString());
+                logger.Error("Failed to load fragment shader");
+                MessagePopup.Warn("Fragment shader 加载失败，预乘Alpha通道属性失效");
+            }
+
+        }
+
+        /// <summary>
+        /// 初始化窗口日志器
+        /// </summary>
+        private void InitializeLogConfiguration()
+        {
+            // 窗口日志
+            var rtbTarget = new NLog.Windows.Forms.RichTextBoxTarget
+            {
+                Name = "rtbTarget",
+                TargetForm = this,
+                TargetRichTextBox = rtbLog,
+                AutoScroll = true,
+                MaxLines = 3000,
+                SupportLinks = true,
+                Layout = "[${level:format=OneLetter}]${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${message}"
+            };
+
+            rtbTarget.WordColoringRules.Add(new("[D]", "Gray", "Empty", FontStyle.Bold));
+            rtbTarget.WordColoringRules.Add(new("[I]", "DimGray", "Empty", FontStyle.Bold));
+            rtbTarget.WordColoringRules.Add(new("[W]", "DarkOrange", "Empty", FontStyle.Bold));
+            rtbTarget.WordColoringRules.Add(new("[E]", "Red", "Empty", FontStyle.Bold));
+            rtbTarget.WordColoringRules.Add(new("[F]", "DarkRed", "Empty", FontStyle.Bold));
+
+            LogManager.Configuration.AddTarget(rtbTarget);
+            LogManager.Configuration.AddRule(LogLevel.Debug, LogLevel.Fatal, rtbTarget);
+            LogManager.ReconfigExistingLoggers();
+        }
+
+        private void MainForm_Load(object sender, EventArgs e)
+        {
+            spinePreviewer.StartRender();
+        }
+
+        private void MainForm_FormClosing(object sender, FormClosingEventArgs e)
+        {
+            spinePreviewer.StopRender();
+        }
+
+        private void toolStripMenuItem_Open_Click(object sender, EventArgs e)
+        {
+            spineListView.Add();
+        }
+
+        private void toolStripMenuItem_BatchOpen_Click(object sender, EventArgs e)
+        {
+            spineListView.BatchAdd();
+        }
+
+        #region private void toolStripMenuItem_ExportXXX_Click(object sender, EventArgs e)
+
+        private void toolStripMenuItem_ExportFrame_Click(object sender, EventArgs e)
+        {
+            if (spinePreviewer.IsUpdating && MessagePopup.Quest("画面仍在更新，建议手动暂停画面后导出固定的一帧，是否继续？") != DialogResult.OK)
+                return;
+
+            var k = nameof(toolStripMenuItem_ExportFrame);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new FrameExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new FrameExporterWrapper((FrameExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportFrameSequence_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportFrameSequence);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new FrameSequenceExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new FrameSequenceExporterWrapper((FrameSequenceExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportGif_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportGif);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new GifExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new GifExporterWrapper((GifExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportWebp_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportWebp);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new WebpExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new WebpExporterWrapper((WebpExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportAvif_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportAvif);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new AvifExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new AvifExporterWrapper((AvifExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportMp4_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportMp4);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new Mp4Exporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new Mp4ExporterWrapper((Mp4Exporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportWebm_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportWebm);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new WebmExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new WebmExporterWrapper((WebmExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportMkv_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportMkv);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new MkvExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new MkvExporterWrapper((MkvExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportMov_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportMov);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new MovExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new MovExporterWrapper((MovExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ExportCustom_Click(object sender, EventArgs e)
+        {
+            var k = nameof(toolStripMenuItem_ExportCustom);
+            if (!exporterCache.ContainsKey(k)) exporterCache[k] = new CustomExporter();
+
+            var exporter = exporterCache[k];
+            exporter.Resolution = spinePreviewer.Resolution;
+            exporter.View = spinePreviewer.GetView();
+            exporter.RenderSelectedOnly = spinePreviewer.RenderSelectedOnly;
+
+            var exportDialog = new Dialogs.ExportDialog(new CustomExporterWrapper((CustomExporter)exporter));
+            if (exportDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += Export_Work;
+            progressDialog.RunWorkerAsync(exporter);
+            progressDialog.ShowDialog();
+        }
+
+        #endregion
+
+        private void toolStripMenuItem_Exit_Click(object sender, EventArgs e)
+        {
+            Close();
+        }
+
+        private void toolStripMenuItem_ConvertFileFormat_Click(object sender, EventArgs e)
+        {
+            var openDialog = new Dialogs.ConvertFileFormatDialog();
+            if (openDialog.ShowDialog() != DialogResult.OK)
+                return;
+
+            var progressDialog = new Dialogs.ProgressDialog();
+            progressDialog.DoWork += ConvertFileFormat_Work;
+            progressDialog.RunWorkerAsync(openDialog.Result);
+            progressDialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_ManageResource_Click(object sender, EventArgs e)
+        {
+
+        }
+
+        private void toolStripMenuItem_About_Click(object sender, EventArgs e)
+        {
+            using var dialog = new Dialogs.AboutDialog();
+            dialog.ShowDialog();
+        }
+
+        private void toolStripMenuItem_Diagnostics_Click(object sender, EventArgs e)
+        {
+            using var dialog = new Dialogs.DiagnosticsDialog();
+            dialog.ShowDialog();
+        }
+
+        private void splitContainer_SplitterMoved(object sender, SplitterEventArgs e) => ActiveControl = null;
+
+        private void splitContainer_MouseUp(object sender, MouseEventArgs e) => ActiveControl = null;
+
+        private void propertyGrid_PropertyValueChanged(object sender, PropertyValueChangedEventArgs e)
+        {
+            // 用来解决对面板某些值修改之后, 其他被联动修改的值不会实时刷新的问题
+            (sender as PropertyGrid)?.Refresh();
+        }
+
+        private void Export_Work(object? sender, DoWorkEventArgs e)
+        {
+            var worker = (BackgroundWorker)sender;
+            var exporter = (Exporter.Exporter)e.Argument;
+            Invoke(() => TaskbarManager.SetProgressState(Handle, TBPFLAG.TBPF_INDETERMINATE));
+            spinePreviewer.StopRender();
+            lock (spineListView.Spines) { exporter.Export(spineListView.Spines.Where(sp => !sp.IsHidden).ToArray(), (BackgroundWorker)sender); }
+            e.Cancel = worker.CancellationPending;
+            spinePreviewer.StartRender();
+            Invoke(() => TaskbarManager.SetProgressState(Handle, TBPFLAG.TBPF_NOPROGRESS));
+        }
+
+        private void ConvertFileFormat_Work(object? sender, DoWorkEventArgs e)
+        {
+            var worker = sender as BackgroundWorker;
+            var arguments = e.Argument as Dialogs.ConvertFileFormatDialogResult;
+            var skelPaths = arguments.SkelPaths;
+            var srcVersion = arguments.SourceVersion;
+            var tgtVersion = arguments.TargetVersion;
+            var jsonTarget = arguments.JsonTarget;
+            var newSuffix = jsonTarget ? ".json" : ".skel";
+
+            int totalCount = skelPaths.Length;
+            int success = 0;
+            int error = 0;
+
+            SkeletonConverter srcCvter = srcVersion != SpineVersion.Auto ? SkeletonConverter.New(srcVersion) : null;
+            SkeletonConverter tgtCvter = SkeletonConverter.New(tgtVersion);
+
+            worker.ReportProgress(0, $"已处理 0/{totalCount}");
+            for (int i = 0; i < totalCount; i++)
+            {
+                if (worker.CancellationPending)
+                {
+                    e.Cancel = true;
+                    break;
+                }
+
+                var skelPath = skelPaths[i];
+                var newPath = Path.ChangeExtension(skelPath, newSuffix);
+
+                try
+                {
+                    if (srcVersion == SpineVersion.Auto)
+                    {
+                        try
+                        {
+                            srcCvter = SkeletonConverter.New(SpineHelper.GetVersion(skelPath));
+                        }
+                        catch (Exception ex)
+                        {
+                            throw new InvalidDataException($"Auto version detection failed for {skelPath}, try to use a specific version", ex);
+                        }
+                    }
+                    var root = srcCvter.Read(skelPath);
+                    root = srcCvter.ToVersion(root, tgtVersion);
+                    if (jsonTarget) tgtCvter.WriteJson(root, newPath); else tgtCvter.WriteBinary(root, newPath);
+                    success++;
+                }
+                catch (Exception ex)
+                {
+                    logger.Error(ex.ToString());
+                    logger.Error("Failed to convert {}", skelPath);
+                    error++;
+                }
+
+                worker.ReportProgress((int)((i + 1) * 100.0) / totalCount, $"已处理 {i + 1}/{totalCount}");
+            }
+
+            if (error > 0)
+            {
+                logger.Warn("Batch convert {} successfully, {} failed", success, error);
+            }
+            else
+            {
+                logger.Info("{} skel converted successfully", success);
+            }
+        }
+
+        //private System.Windows.Forms.Timer timer = new();
+        //private PetForm pet = new PetForm();
+        //private IntPtr screenDC;
+        //private IntPtr memDC;
+        //private void _Test()
+        //{
+        //    screenDC = Win32.GetDC(IntPtr.Zero);
+        //    memDC = Win32.CreateCompatibleDC(screenDC);
+        //    pet.Show();
+        //    timer.Tick += Timer_Tick;
+        //    timer.Enabled = true;
+        //    timer.Interval = 50;
+        //    timer.Start();
+        //}
+
+        //private void Timer_Tick(object? sender, EventArgs e)
+        //{
+        //    using var tex = new SFML.Graphics.RenderTexture((uint)pet.Width, (uint)pet.Height);
+        //    var v = spinePreviewer.GetView();
+        //    tex.SetView(v);
+        //    tex.Clear(new SFML.Graphics.Color(0, 0, 0, 0));
+        //    lock (spineListView.Spines)
+        //    {
+        //        foreach (var sp in spineListView.Spines)
+        //            tex.Draw(sp);
+        //    }
+        //    tex.Display();
+        //    using var frame = new SFMLImageVideoFrame(tex.Texture.CopyToImage());
+        //    using var bitmap = frame.CopyToBitmap();
+
+        //    var newBitmap = bitmap.GetHbitmap(Color.FromArgb(0));
+        //    var oldBitmap = Win32.SelectObject(memDC, newBitmap);
+
+        //    Win32.SIZE size = new Win32.SIZE { cx = pet.Width, cy = pet.Height };
+        //    Win32.POINT srcPos = new Win32.POINT { x = 0, y = 0 };
+        //    Win32.BLENDFUNCTION blend = new Win32.BLENDFUNCTION { BlendOp = 0, BlendFlags = 0, SourceConstantAlpha = 255, AlphaFormat = Win32.AC_SRC_ALPHA };
+
+        //    Win32.UpdateLayeredWindow(pet.Handle, screenDC, IntPtr.Zero, ref size, memDC, ref srcPos, 0, ref blend, Win32.ULW_ALPHA);
+
+        //    Win32.SelectObject(memDC, oldBitmap);
+        //    Win32.DeleteObject(newBitmap);
+        //}
+
+        //private void spinePreviewer_KeyDown(object sender, KeyEventArgs e)
+        //{
+        //    switch (e.KeyCode)
+        //    {
+        //        case Keys.Space:
+        //            if ((ModifierKeys & Keys.Alt) != 0)
+        //                spinePreviewer.ClickStopButton();
+        //            else
+        //                spinePreviewer.ClickStartButton();
+        //            break;
+        //        case Keys.Right:
+        //            if ((ModifierKeys & Keys.Alt) != 0)
+        //                spinePreviewer.ClickForwardFastButton();
+        //            else
+        //                spinePreviewer.ClickForwardStepButton();
+        //            break;
+        //        case Keys.Left:
+        //            if ((ModifierKeys & Keys.Alt) != 0)
+        //                spinePreviewer.ClickRestartButton();
+        //            break;
+        //    }
+        //}
+    }
+}

SpineViewer/MainForm.cs

@@ -1,241 +0,0 @@
-using FFMpegCore.Pipes;
-using FFMpegCore;
-using NLog;
-using SFML.System;
-using SpineViewer.Spine;
-using System.ComponentModel;
-using System.Diagnostics;
-using System.Text.Json;
-using System.Text.Json.Nodes;
-using FFMpegCore.Enums;
-using SpineViewer.Exporter;
-
-namespace SpineViewer
-{
-    public partial class MainForm : Form
-    {
-        public MainForm()
-        {
-            InitializeComponent();
-            InitializeLogConfiguration();
-
-            // 在此处将导出菜单需要的类绑定起来
-            toolStripMenuItem_ExportFrame.Tag = ExportType.Frame;
-            toolStripMenuItem_ExportFrameSequence.Tag = ExportType.FrameSequence;
-            toolStripMenuItem_ExportGif.Tag = ExportType.GIF;
-            toolStripMenuItem_ExportMkv.Tag = ExportType.MKV;
-            toolStripMenuItem_ExportMp4.Tag = ExportType.MP4;
-            toolStripMenuItem_ExportMov.Tag = ExportType.MOV;
-            toolStripMenuItem_ExportWebm.Tag = ExportType.WebM;
-        }
-
-        /// <summary>
-        /// 初始化窗口日志器
-        /// </summary>
-        private void InitializeLogConfiguration()
-        {
-            // 窗口日志
-            var rtbTarget = new NLog.Windows.Forms.RichTextBoxTarget
-            {
-                Name = "rtbTarget",
-                TargetForm = this,
-                TargetRichTextBox = rtbLog,
-                AutoScroll = true,
-                MaxLines = 3000,
-                SupportLinks = true,
-                Layout = "[${level:format=OneLetter}]${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${message}"
-            };
-
-            rtbTarget.WordColoringRules.Add(new("[D]", "Gray", "Empty", FontStyle.Bold));
-            rtbTarget.WordColoringRules.Add(new("[I]", "DimGray", "Empty", FontStyle.Bold));
-            rtbTarget.WordColoringRules.Add(new("[W]", "DarkOrange", "Empty", FontStyle.Bold));
-            rtbTarget.WordColoringRules.Add(new("[E]", "Red", "Empty", FontStyle.Bold));
-            rtbTarget.WordColoringRules.Add(new("[F]", "DarkRed", "Empty", FontStyle.Bold));
-
-            LogManager.Configuration.AddTarget(rtbTarget);
-            LogManager.Configuration.AddRule(LogLevel.Debug, LogLevel.Fatal, rtbTarget);
-            LogManager.ReconfigExistingLoggers();
-        }
-
-        private void MainForm_Load(object sender, EventArgs e)
-        {
-            spinePreviewer.StartRender();
-        }
-
-        private void MainForm_FormClosing(object sender, FormClosingEventArgs e)
-        {
-            spinePreviewer.StopRender();
-        }
-
-        private void toolStripMenuItem_Open_Click(object sender, EventArgs e)
-        {
-            spineListView.Add();
-        }
-
-        private void toolStripMenuItem_BatchOpen_Click(object sender, EventArgs e)
-        {
-            spineListView.BatchAdd();
-        }
-
-        private void toolStripMenuItem_Export_Click(object sender, EventArgs e)
-        {
-            ExportType type = (ExportType)((ToolStripMenuItem)sender).Tag;
-
-            if (type == ExportType.Frame && spinePreviewer.IsUpdating)
-            {
-                if (MessageBox.Quest("画面仍在更新，建议手动暂停画面后导出固定的一帧，是否继续？") != DialogResult.OK)
-                    return;
-            }
-
-            var exportArgs = ExportArgs.New(type, spinePreviewer.Resolution, spinePreviewer.GetView(), spinePreviewer.RenderSelectedOnly);
-            var exportDialog = new Dialogs.ExportDialog() { ExportArgs = exportArgs };
-            if (exportDialog.ShowDialog() != DialogResult.OK)
-                return;
-
-            var exporter = Exporter.Exporter.New(type, exportArgs);
-
-            var progressDialog = new Dialogs.ProgressDialog();
-            progressDialog.DoWork += Export_Work;
-            progressDialog.RunWorkerAsync(exporter);
-            progressDialog.ShowDialog();
-        }
-
-        private void toolStripMenuItem_Exit_Click(object sender, EventArgs e)
-        {
-            Close();
-        }
-
-        private void toolStripMenuItem_ConvertFileFormat_Click(object sender, EventArgs e)
-        {
-            var openDialog = new Dialogs.ConvertFileFormatDialog();
-            if (openDialog.ShowDialog() != DialogResult.OK)
-                return;
-
-            var progressDialog = new Dialogs.ProgressDialog();
-            progressDialog.DoWork += ConvertFileFormat_Work;
-            progressDialog.RunWorkerAsync(openDialog.Result);
-            progressDialog.ShowDialog();
-        }
-
-        private void toolStripMenuItem_ManageResource_Click(object sender, EventArgs e)
-        {
-
-        }
-
-        private void toolStripMenuItem_About_Click(object sender, EventArgs e)
-        {
-            (new Dialogs.AboutDialog()).ShowDialog();
-        }
-
-        private void toolStripMenuItem_Diagnostics_Click(object sender, EventArgs e)
-        {
-            (new Dialogs.DiagnosticsDialog()).ShowDialog();
-        }
-
-        private void splitContainer_SplitterMoved(object sender, SplitterEventArgs e) => ActiveControl = null;
-
-        private void splitContainer_MouseUp(object sender, MouseEventArgs e) => ActiveControl = null;
-
-        private void propertyGrid_PropertyValueChanged(object sender, PropertyValueChangedEventArgs e)
-        {
-            // 用来解决对面板某些值修改之后, 其他被联动修改的值不会实时刷新的问题
-            (sender as PropertyGrid)?.Refresh();
-        }
-
-        private void Export_Work(object? sender, DoWorkEventArgs e)
-        {
-            var worker = (BackgroundWorker)sender;
-            var exporter = (Exporter.Exporter)e.Argument;
-            spinePreviewer.StopRender();
-            lock (spineListView.Spines) { exporter.Export(spineListView.Spines.Where(sp => !sp.IsHidden).ToArray(), (BackgroundWorker)sender); }
-            e.Cancel = worker.CancellationPending;
-            spinePreviewer.StartRender();
-        }
-
-        private void ConvertFileFormat_Work(object? sender, DoWorkEventArgs e)
-        {
-            var worker = sender as BackgroundWorker;
-            var arguments = e.Argument as Dialogs.ConvertFileFormatDialogResult;
-            var skelPaths = arguments.SkelPaths;
-            var srcVersion = arguments.SourceVersion;
-            var tgtVersion = arguments.TargetVersion;
-            var jsonTarget = arguments.JsonTarget;
-            var newSuffix = jsonTarget ? ".json" : ".skel";
-
-            int totalCount = skelPaths.Length;
-            int success = 0;
-            int error = 0;
-
-            SkeletonConverter srcCvter = srcVersion != Spine.Version.Auto ? SkeletonConverter.New(srcVersion) : null;
-            SkeletonConverter tgtCvter = SkeletonConverter.New(tgtVersion);
-
-            worker.ReportProgress(0, $"已处理 0/{totalCount}");
-            for (int i = 0; i < totalCount; i++)
-            {
-                if (worker.CancellationPending)
-                {
-                    e.Cancel = true;
-                    break;
-                }
-
-                var skelPath = skelPaths[i];
-                var newPath = Path.ChangeExtension(skelPath, newSuffix);
-
-                try
-                {
-                    if (srcVersion == Spine.Version.Auto)
-                    {
-                        if (Spine.Spine.GetVersion(skelPath) is Spine.Version detectedSrcVersion)
-                            srcCvter = SkeletonConverter.New(detectedSrcVersion);
-                        else
-                            throw new InvalidDataException($"Auto version detection failed for {skelPath}, try to use a specific version");
-                    }
-                    var root = srcCvter.Read(skelPath);
-                    root = srcCvter.ToVersion(root, tgtVersion);
-                    if (jsonTarget) tgtCvter.WriteJson(root, newPath); else tgtCvter.WriteBinary(root, newPath);
-                    success++;
-                }
-                catch (Exception ex)
-                {
-                    Program.Logger.Error(ex.ToString());
-                    Program.Logger.Error("Failed to convert {}", skelPath);
-                    error++;
-                }
-
-                worker.ReportProgress((int)((i + 1) * 100.0) / totalCount, $"已处理 {i + 1}/{totalCount}");
-            }
-
-            if (error > 0)
-            {
-                Program.Logger.Warn("Batch convert {} successfully, {} failed", success, error);
-            }
-            else
-            {
-                Program.Logger.Info("{} skel converted successfully", success);
-            }
-        }
-
-        //private void spinePreviewer_KeyDown(object sender, KeyEventArgs e)
-        //{
-        //    switch (e.KeyCode)
-        //    {
-        //        case Keys.Space:
-        //            if ((ModifierKeys & Keys.Alt) != 0)
-        //                spinePreviewer.ClickStopButton();
-        //            else
-        //                spinePreviewer.ClickStartButton();
-        //            break;
-        //        case Keys.Right:
-        //            if ((ModifierKeys & Keys.Alt) != 0)
-        //                spinePreviewer.ClickForwardFastButton();
-        //            else
-        //                spinePreviewer.ClickForwardStepButton();
-        //            break;
-        //        case Keys.Left:
-        //            if ((ModifierKeys & Keys.Alt) != 0)
-        //                spinePreviewer.ClickRestartButton();
-        //            break;
-        //    }
-        //}
-    }
-}

SpineViewer/Natives/TaskbarManager.cs

@@ -0,0 +1,65 @@
+using System;
+using System.Runtime.InteropServices;
+using System.Windows.Forms;
+
+namespace SpineViewer.Natives
+{
+    internal enum TBPFLAG
+    {
+        TBPF_NOPROGRESS = 0,
+        TBPF_INDETERMINATE = 0x1,
+        TBPF_NORMAL = 0x2,
+        TBPF_ERROR = 0x4,
+        TBPF_PAUSED = 0x8
+    }
+
+    [InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
+    [ComImport, Guid("ea1afb91-9e28-4b86-90e9-9e9f8a5eefaf")]
+    internal interface ITaskbarList3
+    {
+        // ITaskbarList
+        void HrInit();
+        void AddTab(nint hwnd);
+        void DeleteTab(nint hwnd);
+        void ActivateTab(nint hwnd);
+        void SetActiveAlt(nint hwnd);
+        // ITaskbarList2
+        void MarkFullscreenWindow(nint hwnd, [MarshalAs(UnmanagedType.Bool)] bool fFullscreen);
+        // ITaskbarList3
+        void SetProgressValue(nint hwnd, ulong ullCompleted, ulong ullTotal);
+        void SetProgressState(nint hwnd, TBPFLAG tbpFlags);
+        //void RegisterTab(IntPtr hwndTab, IntPtr hwndMDI);
+        //void UnregisterTab(IntPtr hwndTab);
+        //void SetTabOrder(IntPtr hwndTab, IntPtr hwndInsertBefore);
+        //void SetTabActive(IntPtr hwndTab, IntPtr hwndMDI, uint dwReserved);
+        //void ThumbBarAddButtons(IntPtr hwnd, uint cButtons, THUMBBUTTON[] pButton);
+        //void ThumbBarUpdateButtons(IntPtr hwnd, uint cButtons, THUMBBUTTON[] pButton);
+        //void ThumbBarSetImageList(IntPtr hwnd, IntPtr himl);
+        //void SetOverlayIcon(IntPtr hwnd, IntPtr hIcon, string pszDescription);
+        //void SetThumbnailTooltip(IntPtr hwnd, string pszTip);
+        //void SetThumbnailClip(IntPtr hwnd, ref RECT prcClip);
+    }
+
+    [ComImport, Guid("56FDF344-FD6D-11d0-958A-006097C9A090")]
+    internal class TaskbarList { }
+
+    internal static class TaskbarManager
+    {
+        private static readonly ITaskbarList3 taskbarList = (ITaskbarList3)new TaskbarList();
+
+        static TaskbarManager()
+        {
+            taskbarList.HrInit();
+        }
+
+        public static void SetProgressState(nint windowHandle, TBPFLAG state)
+        {
+            taskbarList.SetProgressState(windowHandle, state);
+        }
+
+        public static void SetProgressValue(nint windowHandle, ulong completed, ulong total)
+        {
+            taskbarList.SetProgressValue(windowHandle, completed, total);
+        }
+    }
+}

SpineViewer/Natives/Win32.cs

@@ -0,0 +1,177 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Drawing;
+using System.Linq;
+using System.Runtime.InteropServices;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Natives
+{
+    /// <summary>
+    /// Win32 Sdk 包装类
+    /// </summary>
+    public static class Win32
+    {
+        public const int GWL_STYLE = -16;
+        public const int WS_SIZEBOX = 0x40000;
+        public const int WS_BORDER = 0x800000;
+        public const int WS_POPUP = unchecked((int)0x80000000);
+
+        public const int GWL_EXSTYLE = -20;
+        public const int WS_EX_TOPMOST = 0x8;
+        public const int WS_EX_TRANSPARENT = 0x20;
+        public const int WS_EX_TOOLWINDOW = 0x80;
+        public const int WS_EX_WINDOWEDGE = 0x100;
+        public const int WS_EX_CLIENTEDGE = 0x200;
+        public const int WS_EX_LAYERED = 0x80000;
+        public const int WS_EX_OVERLAPPEDWINDOW = WS_EX_WINDOWEDGE | WS_EX_CLIENTEDGE;
+
+        public const uint LWA_COLORKEY = 0x1;
+        public const uint LWA_ALPHA = 0x2;
+
+        public const byte AC_SRC_OVER = 0x00;
+        public const byte AC_SRC_ALPHA = 0x01;
+
+        public const int ULW_COLORKEY = 0x00000001;
+        public const int ULW_ALPHA = 0x00000002;
+        public const int ULW_OPAQUE = 0x00000004;
+
+        public const nint HWND_TOPMOST = -1;
+
+        public const uint SWP_NOSIZE = 0x0001;
+        public const uint SWP_NOMOVE = 0x0002;
+        public const uint SWP_NOZORDER = 0x0004;
+        public const uint SWP_FRAMECHANGED = 0x0020;
+        public const uint SWP_REFRESHLONG = SWP_NOSIZE | SWP_NOMOVE | SWP_NOZORDER | SWP_FRAMECHANGED;
+
+        public const int WM_SPAWN_WORKER = 0x052C; // 一个未公开的神秘消息
+
+        public const uint SMTO_NORMAL = 0x0000;
+        public const uint SMTO_BLOCK = 0x0001;
+        public const uint SMTO_ABORTIFHUNG = 0x0002;
+        public const uint SMTO_NOTIMEOUTIFNOTHUNG = 0x0008;
+
+        public const uint GA_PARENT = 1;
+        public const uint GW_OWNER = 4;
+
+        [StructLayout(LayoutKind.Sequential)]
+        public struct POINT
+        {
+            public int x;
+            public int y;
+        }
+
+        [StructLayout(LayoutKind.Sequential)]
+        public struct SIZE
+        {
+            public int cx;
+            public int cy;
+        }
+
+        [StructLayout(LayoutKind.Sequential, Pack = 1)]
+        public struct BLENDFUNCTION
+        {
+            public byte BlendOp;
+            public byte BlendFlags;
+            public byte SourceConstantAlpha;
+            public byte AlphaFormat;
+        }
+
+        [StructLayout(LayoutKind.Sequential)]
+        private struct LASTINPUTINFO
+        {
+            public uint cbSize;
+            public uint dwTime;
+        }
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern nint GetDC(nint hWnd);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern int ReleaseDC(nint hWnd, nint hDC);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern int SetWindowLong(nint hWnd, int nIndex, int dwNewLong);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern int GetWindowLong(nint hWnd, int nIndex);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern bool GetLayeredWindowAttributes(nint hWnd, ref uint crKey, ref byte bAlpha, ref uint dwFlags);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern bool SetLayeredWindowAttributes(nint hWnd, uint pcrKey, byte pbAlpha, uint pdwFlags);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern bool UpdateLayeredWindow(nint hWnd, nint hdcDst, nint pptDst, ref SIZE psize, nint hdcSrc, ref POINT pptSrc, int crKey, ref BLENDFUNCTION pblend, int dwFlags);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern bool SetWindowPos(nint hWnd, nint hWndInsertAfter, int X, int Y, int cx, int cy, uint uFlags);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern uint GetDoubleClickTime();
+
+        [DllImport("user32.dll", SetLastError = true)]
+        private static extern bool GetLastInputInfo(ref LASTINPUTINFO plii);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern nint FindWindow(string lpClassName, string lpWindowName);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern nint SendMessageTimeout(nint hWnd, uint Msg, nint wParam, nint lParam, uint fuFlags, uint uTimeout, out nint lpdwResult);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern nint FindWindowEx(nint parentHandle, nint childAfter, string className, string windowTitle);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern nint SetParent(nint hWndChild, nint hWndNewParent);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern nint GetParent(nint hWnd);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern nint GetAncestor(nint hWnd, uint gaFlags);
+
+        [DllImport("user32.dll", SetLastError = true)]
+        public static extern nint GetWindow(nint hWnd, uint uCmd);
+
+        [DllImport("gdi32.dll", SetLastError = true)]
+        public static extern nint CreateCompatibleDC(nint hdc);
+
+        [DllImport("gdi32.dll", SetLastError = true)]
+        public static extern bool DeleteDC(nint hdc);
+
+        [DllImport("gdi32.dll", SetLastError = true)]
+        public static extern nint SelectObject(nint hdc, nint hgdiobj);
+
+        [DllImport("gdi32.dll", SetLastError = true)]
+        public static extern bool DeleteObject(nint hObject);
+
+        public static TimeSpan GetLastInputElapsedTime()
+        {
+            LASTINPUTINFO lastInputInfo = new();
+            lastInputInfo.cbSize = (uint)Marshal.SizeOf(lastInputInfo);
+
+            uint idleTimeMillis = 1000;
+            if (GetLastInputInfo(ref lastInputInfo))
+            {
+                uint tickCount = (uint)Environment.TickCount;
+                uint lastInputTick = lastInputInfo.dwTime;
+                idleTimeMillis = tickCount - lastInputTick;
+            }
+            return TimeSpan.FromMilliseconds(idleTimeMillis);
+        }
+
+        public static nint GetWorkerW()
+        {
+            var progman = FindWindow("Progman", null);
+            if (progman == nint.Zero)
+                return nint.Zero;
+            nint hWnd = FindWindowEx(progman, 0, "WorkerW", null);
+            Debug.WriteLine($"{hWnd:x8}");
+            return hWnd;
+        }
+    }
+}

SpineViewer/Program.cs

@@ -1,39 +1,38 @@
 using NLog;
+using SpineViewer.Utilities;
 using System.Diagnostics;
+using System.Reflection;
 
 namespace SpineViewer
 {
     internal static class Program
     {
-        /// <summary>
-        /// 程序路径
-        /// </summary>
-        public static readonly string FilePath = Environment.ProcessPath;
+        ///// <summary>
+        ///// 程序路径
+        ///// </summary>
+        //public static readonly string FilePath = Environment.ProcessPath;
 
-        /// <summary>
-        /// 程序名
-        /// </summary>
-        public static readonly string Name = Path.GetFileNameWithoutExtension(FilePath);
+        ///// <summary>
+        ///// 程序名
+        ///// </summary>
+        //public static readonly string Name = Path.GetFileNameWithoutExtension(FilePath);
 
-        /// <summary>
-        /// 程序目录
-        /// </summary>
-        public static readonly string RootDir = Path.GetDirectoryName(FilePath);
+        ///// <summary>
+        ///// 程序目录
+        ///// </summary>
+        //public static readonly string RootDir = Path.GetDirectoryName(FilePath);
 
-        /// <summary>
-        /// 程序临时目录
-        /// </summary>
-        public static readonly string TempDir = Directory.CreateDirectory(Path.Combine(Path.GetTempPath(), Name)).FullName;
+        ///// <summary>
+        ///// 程序临时目录
+        ///// </summary>
+        //public static readonly string TempDir = Directory.CreateDirectory(Path.Combine(Path.GetTempPath(), Name)).FullName;
 
-        /// <summary>
-        /// 程序进程
-        /// </summary>
-        public static readonly Process Process = Process.GetCurrentProcess();
+        public static string Version => Assembly.GetExecutingAssembly().GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
 
         /// <summary>
         /// 程序日志器
         /// </summary>
-        public static readonly Logger Logger = LogManager.GetCurrentClassLogger();
+        private static readonly Logger logger = LogManager.GetCurrentClassLogger();
 
         /// <summary>
         /// 应用入口点
@@ -41,8 +40,9 @@ namespace SpineViewer
         [STAThread]
         static void Main()
         {
+            // 此处先初始化全局配置再触发静态字段 Logger 引用构造, 才能将配置应用到新的日志器上
             InitializeLogConfiguration();
-            Logger.Info("Program Started");
+            logger.Info("Program Started");
 
             // To customize application configuration such as set high DPI settings or default font,
             // see https://aka.ms/applicationconfiguration.
@@ -50,12 +50,12 @@ namespace SpineViewer
 
             try
             {
-                Application.Run(new MainForm());
+                Application.Run(new SpineViewerForm() { Text = $"SpineViewer - v{Version}"});
             }
             catch (Exception ex)
             {
-                Logger.Fatal(ex.ToString());
-                MessageBox.Error(ex.ToString(), "程序已崩溃");
+                logger.Fatal(ex.ToString());
+                MessagePopup.Error(ex.ToString(), "程序已崩溃");
             }
         }
 
@@ -82,10 +82,5 @@ namespace SpineViewer
             config.AddRule(LogLevel.Debug, LogLevel.Fatal, fileTarget);
             LogManager.Configuration = config;
         }
-
-        /// <summary>
-        /// 输出当前内存使用情况
-        /// </summary>
-        public static void LogCurrentMemoryUsage() => Logger.Info("Current memory usage: {:F2} MB", Process.WorkingSet64 / 1024.0 / 1024.0);
     }
 }

SpineViewer/PropertyGridWrappers/Exporter/AvifExporterWrapper.cs

@@ -0,0 +1,44 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class AvifExporterWrapper(AvifExporter exporter) : FFmpegVideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override AvifExporter Exporter => (AvifExporter)base.Exporter;
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        [StringEnumConverter.StandardValues("av1_nvenc", "av1_amf", "libaom-av1", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("编码器"), Description("-c:v, 要使用的编码器\n建议使用硬件加速, libaom-av1 速度非常非常非常慢")]
+        public string Codec { get => Exporter.Codec; set => Exporter.Codec = value; }
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("CRF"), Description("-crf, 取值范围 0-63, 建议范围 18-28, 默认取值 23, 数值越小则输出质量越高")]
+        public int CRF { get => Exporter.CRF; set => Exporter.CRF = value; }
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        [StringEnumConverter.StandardValues("yuv420p", "yuv422p", "yuv444p", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("像素格式"), Description("-pix_fmt, 要使用的像素格式")]
+        public string PixelFormat { get => Exporter.PixelFormat; set => Exporter.PixelFormat = value; }
+
+        /// <summary>
+        /// 循环次数
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("循环次数"), Description("-loop, 循环次数, 0 无限循环, 取值范围 [0, 65535]")]
+        public int Loop { get => Exporter.Loop; set => Exporter.Loop = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/CustomExporterWrapper.cs

@@ -0,0 +1,34 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class CustomExporterWrapper(CustomExporter exporter) : FFmpegVideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override CustomExporter Exporter => (CustomExporter)base.Exporter;
+
+        [Browsable(false)]
+        public override string Format => Exporter.Format;
+
+        [Browsable(false)]
+        public override string Suffix => Exporter.Suffix;
+
+        /// <summary>
+        /// 文件格式
+        /// </summary>
+        [Category("[2] FFmpeg 基本参数"), DisplayName("文件格式"), Description("-f, 文件格式")]
+        public string CustomFormat { get => Exporter.CustomFormat; set => Exporter.CustomFormat = value; }
+
+        /// <summary>
+        /// 文件名后缀
+        /// </summary>
+        [Category("[2] FFmpeg 基本参数"), DisplayName("文件名后缀"), Description("文件名后缀")]
+        public string CustomSuffix { get => Exporter.CustomSuffix; set => Exporter.CustomSuffix = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/ExporterWrapper.cs

@@ -0,0 +1,56 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Drawing.Design;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class ExporterWrapper(SpineViewer.Exporter.Exporter exporter)
+    {
+        [Browsable(false)]
+        public virtual SpineViewer.Exporter.Exporter Exporter { get; } = exporter;
+
+        /// <summary>
+        /// 输出文件夹
+        /// </summary>
+        [Editor(typeof(FolderNameEditor), typeof(UITypeEditor))]
+        [Category("[0] 导出"), DisplayName("输出文件夹"), Description("逐个导出时可以留空，将逐个导出到模型自身所在目录")]
+        public string? OutputDir { get => Exporter.OutputDir; set => Exporter.OutputDir = value; }
+
+        /// <summary>
+        /// 导出单个
+        /// </summary>
+        [Category("[0] 导出"), DisplayName("导出单个"), Description("是否将模型在同一个画面上导出单个文件，否则逐个导出模型")]
+        public bool IsExportSingle { get => Exporter.IsExportSingle; set => Exporter.IsExportSingle = value; }
+
+        /// <summary>
+        /// 画面分辨率
+        /// </summary>
+        [TypeConverter(typeof(SizeConverter))]
+        [Category("[0] 导出"), DisplayName("分辨率"), Description("画面的宽高像素大小，请在预览画面参数面板进行调整")]
+        public Size Resolution { get => Exporter.Resolution; }
+
+        /// <summary>
+        /// 渲染视窗
+        /// </summary>
+        [Category("[0] 导出"), DisplayName("视图"), Description("画面的视图参数，请在预览画面参数面板进行调整")]
+        public SFML.Graphics.View View { get => Exporter.View; }
+
+        /// <summary>
+        /// 是否仅渲染选中
+        /// </summary>
+        [Category("[0] 导出"), DisplayName("仅渲染选中"), Description("是否仅导出选中的模型，请在预览画面参数面板进行调整")]
+        public bool RenderSelectedOnly { get => Exporter.RenderSelectedOnly; }
+
+        /// <summary>
+        /// 背景颜色
+        /// </summary>
+        [Editor(typeof(SFMLColorEditor), typeof(UITypeEditor))]
+        [TypeConverter(typeof(SFMLColorConverter))]
+        [Category("[0] 导出"), DisplayName("背景颜色"), Description("要使用的背景色, 格式为 #RRGGBBAA")]
+        public SFML.Graphics.Color BackgroundColor { get => Exporter.BackgroundColor; set => Exporter.BackgroundColor = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/FFmpegVideoExporterWrapper.cs

@@ -0,0 +1,34 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class FFmpegVideoExporterWrapper(FFmpegVideoExporter exporter) : VideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override FFmpegVideoExporter Exporter => (FFmpegVideoExporter)base.Exporter;
+
+        /// <summary>
+        /// 文件格式
+        /// </summary>
+        [Category("[2] FFmpeg 基本参数"), DisplayName("文件格式"), Description("-f, 文件格式")]
+        public virtual string Format => Exporter.Format;
+
+        /// <summary>
+        /// 文件名后缀
+        /// </summary>
+        [Category("[2] FFmpeg 基本参数"), DisplayName("文件名后缀"), Description("文件名后缀")]
+        public virtual string Suffix => Exporter.Suffix;
+
+        /// <summary>
+        /// 文件名后缀
+        /// </summary>
+        [Category("[2] FFmpeg 基本参数"), DisplayName("自定义参数"), Description("使用 \"ffmpeg -h encoder=<编码器>\" 查看编码器支持的参数\n使用 \"ffmpeg -h muxer=<文件格式>\" 查看文件格式支持的参数")]
+        public string CustomArgument { get => Exporter.CustomArgument; set => Exporter.CustomArgument = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/FrameExporterWrapper.cs

@@ -0,0 +1,37 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Drawing.Imaging;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class FrameExporterWrapper(FrameExporter exporter) : ExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override FrameExporter Exporter => (FrameExporter)base.Exporter;
+
+        /// <summary>
+        /// 单帧画面格式
+        /// </summary>
+        [TypeConverter(typeof(ImageFormatConverter))]
+        [Category("[1] 单帧画面"), DisplayName("图像格式")]
+        public ImageFormat ImageFormat { get => Exporter.ImageFormat; set => Exporter.ImageFormat = value; }
+
+        /// <summary>
+        /// 文件名后缀
+        /// </summary>
+        [Category("[1] 单帧画面"), DisplayName("文件名后缀"), Description("与图像格式匹配的文件名后缀")]
+        public string Suffix { get => Exporter.ImageFormat.GetSuffix(); }
+
+        /// <summary>
+        /// DPI
+        /// </summary>
+        [TypeConverter(typeof(SizeFConverter))]
+        [Category("[1] 单帧画面"), DisplayName("DPI"), Description("导出图像的每英寸像素数，用于调整图像的物理尺寸")]
+        public SizeF DPI { get => Exporter.DPI; set => Exporter.DPI = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/FrameSequenceExporterWrapper.cs

@@ -0,0 +1,23 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class FrameSequenceExporterWrapper(VideoExporter exporter) : VideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override FrameSequenceExporter Exporter => (FrameSequenceExporter)base.Exporter;
+
+        /// <summary>
+        /// 文件名后缀
+        /// </summary>
+        [TypeConverter(typeof(StringEnumConverter)), StringEnumConverter.StandardValues(".png", ".jpg", ".tga", ".bmp")]
+        [Category("[2] 帧序列参数"), DisplayName("文件名后缀"), Description("帧文件的后缀，同时决定帧图像格式")]
+        public string Suffix { get => Exporter.Suffix; set => Exporter.Suffix = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/GifExporterWrapper.cs

@@ -0,0 +1,34 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    class GifExporterWrapper(FFmpegVideoExporter exporter) : FFmpegVideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override GifExporter Exporter => (GifExporter)base.Exporter;
+
+        /// <summary>
+        /// 调色板最大颜色数量
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("调色板最大颜色数量"), Description("设置调色板使用的最大颜色数量, 越多则色彩保留程度越高")]
+        public uint MaxColors { get => Exporter.MaxColors; set => Exporter.MaxColors = value; }
+
+        /// <summary>
+        /// 透明度阈值
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("透明度阈值"), Description("小于该值的像素点会被认为是透明像素")]
+        public byte AlphaThreshold { get => Exporter.AlphaThreshold; set => Exporter.AlphaThreshold = value; }
+
+        /// <summary>
+        /// 透明度阈值
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("循环次数"), Description("-loop, 循环次数, -1 不循环, 0 无限循环, 取值范围 [-1, 65535]")]
+        public int Loop { get => Exporter.Loop; set => Exporter.Loop = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/MkvExporterWrapper.cs

@@ -0,0 +1,38 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class MkvExporterWrapper(FFmpegVideoExporter exporter) : FFmpegVideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override MkvExporter Exporter => (MkvExporter)base.Exporter;
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        [StringEnumConverter.StandardValues("libx264", "libx265", "libvpx-vp9", "av1_nvenc", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("编码器"), Description("-c:v, 要使用的编码器")]
+        public string Codec { get => Exporter.Codec; set => Exporter.Codec = value; }
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("CRF"), Description("-crf, 取值范围 0-63, 建议范围 18-28, 默认取值 23, 数值越小则输出质量越高")]
+        public int CRF { get => Exporter.CRF; set => Exporter.CRF = value; }
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        [StringEnumConverter.StandardValues("yuv420p", "yuv422p", "yuv444p", "yuva420p", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("像素格式"), Description("-pix_fmt, 要使用的像素格式")]
+        public string PixelFormat { get => Exporter.PixelFormat; set => Exporter.PixelFormat = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/MovExporterWrapper.cs

@@ -0,0 +1,40 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class MovExporterWrapper(FFmpegVideoExporter exporter) : FFmpegVideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override MovExporter Exporter => (MovExporter)base.Exporter;
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        [StringEnumConverter.StandardValues("prores_ks", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("编码器"), Description("-c:v, 要使用的编码器")]
+        public string Codec { get => Exporter.Codec; set => Exporter.Codec = value; }
+
+        /// <summary>
+        /// 预设
+        /// </summary>
+        [StringEnumConverter.StandardValues("auto", "proxy", "lt", "standard", "hq", "4444", "4444xq")]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("预设"), Description("-profile, 预设配置")]
+        public string Profile { get => Exporter.Profile; set => Exporter.Profile = value; }
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        [StringEnumConverter.StandardValues("yuv422p10le", "yuv444p10le", "yuva444p10le", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("像素格式"), Description("-pix_fmt, 要使用的像素格式")]
+        public string PixelFormat { get => Exporter.PixelFormat; set => Exporter.PixelFormat = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/Mp4ExporterWrapper.cs

@@ -0,0 +1,38 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class Mp4ExporterWrapper(FFmpegVideoExporter exporter) : FFmpegVideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override Mp4Exporter Exporter => (Mp4Exporter)base.Exporter;
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        [StringEnumConverter.StandardValues("libx264", "libx265", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("编码器"), Description("-c:v, 要使用的编码器")]
+        public string Codec { get => Exporter.Codec; set => Exporter.Codec = value; }
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("CRF"), Description("-crf, 取值范围 0-63, 建议范围 18-28, 默认取值 23, 数值越小则输出质量越高")]
+        public int CRF { get => Exporter.CRF; set => Exporter.CRF = value; }
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        [StringEnumConverter.StandardValues("yuv420p", "yuv422p", "yuv444p", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("像素格式"), Description("-pix_fmt, 要使用的像素格式")]
+        public string PixelFormat { get => Exporter.PixelFormat; set => Exporter.PixelFormat = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/VideoExporterWrapper.cs

@@ -0,0 +1,34 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class VideoExporterWrapper(VideoExporter exporter) : ExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override VideoExporter Exporter => (VideoExporter)base.Exporter;
+
+        /// <summary>
+        /// 导出时长
+        /// </summary>
+        [Category("[1] 视频参数"), DisplayName("时长"), Description("可以从模型列表查看动画时长, 如果小于 0, 则在逐个导出时每个模型使用各自的所有轨道动画时长最大值")]
+        public float Duration { get => Exporter.Duration; set => Exporter.Duration = value; }
+
+        /// <summary>
+        /// 帧率
+        /// </summary>
+        [Category("[1] 视频参数"), DisplayName("帧率"), Description("每秒画面数")]
+        public float FPS { get => Exporter.FPS; set => Exporter.FPS = value; }
+
+        /// <summary>
+        /// 保留最后一帧
+        /// </summary>
+        [Category("[1] 视频参数"), DisplayName("保留最后一帧"), Description("当设置保留最后一帧时, 动图会更为连贯, 但是帧数可能比预期帧数多 1")]
+        public bool KeepLast { get => Exporter.KeepLast; set => Exporter.KeepLast = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/WebmExporterWrapper.cs

@@ -0,0 +1,38 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class WebmExporterWrapper(WebmExporter exporter) : FFmpegVideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override WebmExporter Exporter => (WebmExporter)base.Exporter;
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        [StringEnumConverter.StandardValues("libvpx-vp9", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("编码器"), Description("-c:v, 要使用的编码器")]
+        public string Codec { get => Exporter.Codec; set => Exporter.Codec = value; }
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("CRF"), Description("-crf, 取值范围 0-63, 建议范围 18-28, 默认取值 23, 数值越小则输出质量越高")]
+        public int CRF { get => Exporter.CRF; set => Exporter.CRF = value; }
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        [StringEnumConverter.StandardValues("yuv420p", "yuv422p", "yuv444p", "yuva420p", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("像素格式"), Description("-pix_fmt, 要使用的像素格式")]
+        public string PixelFormat { get => Exporter.PixelFormat; set => Exporter.PixelFormat = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Exporter/WebpExporterWrapper.cs

@@ -0,0 +1,50 @@
+using SpineViewer.Exporter;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Exporter
+{
+    public class WebpExporterWrapper(WebpExporter exporter) : FFmpegVideoExporterWrapper(exporter)
+    {
+        [Browsable(false)]
+        public override WebpExporter Exporter => (WebpExporter)base.Exporter;
+
+        /// <summary>
+        /// 编码器
+        /// </summary>
+        [StringEnumConverter.StandardValues("libwebp_anim", "libwebp", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("编码器"), Description("-c:v, 要使用的编码器")]
+        public string Codec { get => Exporter.Codec; set => Exporter.Codec = value; }
+
+        /// <summary>
+        /// 是否无损
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("无损"), Description("-lossless, 0 表示有损, 1 表示无损")]
+        public bool Lossless { get => Exporter.Lossless; set => Exporter.Lossless = value; }
+
+        /// <summary>
+        /// CRF
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("质量"), Description("-quality, 取值范围 0-100, 默认值 75")]
+        public int Quality { get => Exporter.Quality; set => Exporter.Quality = value; }
+
+        /// <summary>
+        /// 像素格式
+        /// </summary>
+        [StringEnumConverter.StandardValues("yuv420p", "yuva420p", Customizable = true)]
+        [TypeConverter(typeof(StringEnumConverter))]
+        [Category("[3] 格式参数"), DisplayName("像素格式"), Description("-pix_fmt, 要使用的像素格式")]
+        public string PixelFormat { get => Exporter.PixelFormat; set => Exporter.PixelFormat = value; }
+
+        /// <summary>
+        /// 透明度阈值
+        /// </summary>
+        [Category("[3] 格式参数"), DisplayName("循环次数"), Description("-loop, 循环次数, 0 无限循环, 取值范围 [0, 65535]")]
+        public int Loop { get => Exporter.Loop; set => Exporter.Loop = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Spine/SpineAnimationWrapper.cs

@@ -0,0 +1,170 @@
+using SpineViewer.Spine;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Spine
+{
+    /// <summary>
+    /// 对轨道索引属性的包装类, 能够在面板上显示例如时长的属性, 但是处理该属性时按字符串去处理, 例如 ToString 和判断对象相等都是用动画名称实现逻辑
+    /// </summary>
+    /// <param name="spine"></param>
+    /// <param name="i"></param>
+    [TypeConverter(typeof(TrackWrapperConverter))]
+    public class TrackWrapper(SpineViewer.Spine.Spine spine, int i)
+    {
+        private readonly SpineViewer.Spine.Spine spine = spine;
+
+        [Browsable(false)]
+        public int Index { get; } = i;
+
+        [DisplayName("时长")]
+        public float Duration => spine.GetAnimationDuration(spine.GetAnimation(Index));
+
+        /// <summary>
+        /// 实现了默认的转为字符串的方式
+        /// </summary>
+        public override string ToString() => spine.GetAnimation(Index);
+
+        /// <summary>
+        /// 影响了属性面板的判断, 当动画名称相同的时候认为两个对象是相同的, 这样属性面板可以在多选的时候正确显示相同取值的内容
+        /// </summary>
+        public override bool Equals(object? obj)
+        {
+            if (obj is TrackWrapper) return ToString() == obj.ToString();
+            return base.Equals(obj);
+        }
+
+        /// <summary>
+        /// 哈希码需要和 Equals 行为类似
+        /// </summary>
+        public override int GetHashCode() => HashCode.Combine(typeof(TrackWrapper).FullName.GetHashCode(), ToString().GetHashCode());
+    }
+
+    /// <summary>
+    /// 用于在 PropertyGrid 上显示 Spine 动画列表的包装类
+    /// </summary>
+    public class SpineAnimationWrapper(SpineViewer.Spine.Spine spine) : ICustomTypeDescriptor
+    {
+        /// <summary>
+        /// 轨道属性描述符, 实现对属性的读取和赋值
+        /// </summary>
+        /// <param name="i">轨道索引</param>
+        private class TrackWrapperPropertyDescriptor(int i, Attribute[]? attributes) : PropertyDescriptor($"Track{i}", attributes)
+        {
+            private readonly int idx = i;
+
+            public override Type ComponentType => typeof(SpineAnimationWrapper);
+            public override bool IsReadOnly => false;
+            public override Type PropertyType => typeof(TrackWrapper);
+            public override bool CanResetValue(object component) => false;
+            public override void ResetValue(object component) { }
+            public override bool ShouldSerializeValue(object component) => false;
+
+            /// <summary>
+            /// 得到一个轨道包装类, 允许用户查看或者修改具体的属性值, 这个地方决定了在面板上看到的是一个对象及其属性
+            /// </summary>
+            public override object? GetValue(object? component)
+            {
+                if (component is SpineAnimationWrapper tracks)
+                    return tracks.GetTrackWrapper(idx);
+                return null;
+            }
+
+            /// <summary>
+            /// 允许通过字符串赋值修改该轨道的动画, 这里决定了当其他地方的调用 (比如 Converter) 通过 value 来设置属性值的时候应该怎么处理
+            /// </summary>
+            public override void SetValue(object? component, object? value)
+            {
+                if (component is SpineAnimationWrapper tracks)
+                {
+                    if (value is string s)
+                        tracks.SetTrackWrapper(idx, s);
+                }
+            }
+        }
+
+        [Browsable(false)]
+        public SpineViewer.Spine.Spine Spine { get; } = spine;
+
+        /// <summary>
+        /// 全轨道动画最大时长
+        /// </summary>
+        [DisplayName("全轨道最大时长")]
+        public float AnimationTracksMaxDuration => Spine.GetTrackIndices().Select(i => Spine.GetAnimationDuration(Spine.GetAnimation(i))).Max();
+
+        /// <summary>
+        /// TrackWrapper 属性对象缓存
+        /// </summary>
+        private readonly Dictionary<int, TrackWrapper> trackWrapperProperties = [];
+
+        /// <summary>
+        /// 访问 TrackWrapper 属性 <c>AnimationTracks.Track{i}</c>
+        /// </summary>
+        public TrackWrapper GetTrackWrapper(int i)
+        {
+            if (!trackWrapperProperties.ContainsKey(i))
+                trackWrapperProperties[i] = new TrackWrapper(Spine, i);
+            return trackWrapperProperties[i];
+        }
+
+        /// <summary>
+        /// 设置 TrackWrapper 属性 <c>AnimationTracks.Track{i} = <paramref name="value"/></c>
+        /// </summary>
+        public void SetTrackWrapper(int i, string value)
+        {
+            Spine.SetAnimation(i, value);
+            TypeDescriptor.Refresh(this);
+        }
+
+        /// <summary>
+        /// 在属性面板悬停可以按轨道顺序显示动画名称
+        /// </summary>
+        public override string ToString() => $"[{string.Join(", ", Spine.GetTrackIndices().Select(Spine.GetAnimation))}]";
+
+        public override bool Equals(object? obj)
+        {
+            if (obj is SpineAnimationWrapper wrapper) return ToString() == wrapper.ToString();
+            return base.Equals(obj);
+        }
+
+        public override int GetHashCode() => HashCode.Combine(typeof(SpineAnimationWrapper).FullName.GetHashCode(), ToString().GetHashCode());
+
+        #region ICustomTypeDescriptor 接口实现
+
+        // XXX: 必须实现 ICustomTypeDescriptor 接口, 不能继承 CustomTypeDescriptor, 似乎继承下来的东西会有问题, 导致某些调用不正确
+
+        /// <summary>
+        /// 属性描述符缓存
+        /// </summary>
+        private static readonly Dictionary<int, TrackWrapperPropertyDescriptor> pdCache = [];
+
+        public AttributeCollection GetAttributes() => TypeDescriptor.GetAttributes(this, true);
+        public string? GetClassName() => TypeDescriptor.GetClassName(this, true);
+        public string? GetComponentName() => TypeDescriptor.GetComponentName(this, true);
+        public TypeConverter? GetConverter() => TypeDescriptor.GetConverter(this, true);
+        public EventDescriptor? GetDefaultEvent() => TypeDescriptor.GetDefaultEvent(this, true);
+        public PropertyDescriptor? GetDefaultProperty() => TypeDescriptor.GetDefaultProperty(this, true);
+        public object? GetEditor(Type editorBaseType) => TypeDescriptor.GetEditor(this, editorBaseType, true);
+        public EventDescriptorCollection GetEvents() => TypeDescriptor.GetEvents(this, true);
+        public EventDescriptorCollection GetEvents(Attribute[]? attributes) => TypeDescriptor.GetEvents(this, attributes, true);
+        public object? GetPropertyOwner(PropertyDescriptor? pd) => this;
+        public PropertyDescriptorCollection GetProperties() => GetProperties(null);
+        public PropertyDescriptorCollection GetProperties(Attribute[]? attributes)
+        {
+            var props = new PropertyDescriptorCollection(TypeDescriptor.GetProperties(this, attributes, true).Cast<PropertyDescriptor>().ToArray());
+            foreach (var i in Spine.GetTrackIndices())
+            {
+                if (!pdCache.ContainsKey(i))
+                    pdCache[i] = new TrackWrapperPropertyDescriptor(i, [new DisplayNameAttribute($"轨道 {i}")]);
+                props.Add(pdCache[i]);
+            }
+            return props;
+        }
+
+        #endregion
+    }
+}

SpineViewer/PropertyGridWrappers/Spine/SpineBaseInfoWrapper.cs

@@ -0,0 +1,56 @@
+using SpineViewer.Spine;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Spine
+{
+    /// <summary>
+    /// 用于在 PropertyGrid 上显示 Spine 基本信息的包装类
+    /// </summary>
+    public class SpineBaseInfoWrapper(SpineViewer.Spine.Spine spine)
+    {
+        [Browsable(false)]
+        public SpineViewer.Spine.Spine Spine { get; } = spine;
+
+        /// <summary>
+        /// 获取所属版本
+        /// </summary>
+        [TypeConverter(typeof(SpineVersionConverter))]
+        [DisplayName("运行时版本")]
+        public SpineVersion Version => Spine.Version;
+
+        /// <summary>
+        /// 资源所在完整目录
+        /// </summary>
+        [DisplayName("资源目录")]
+        public string AssetsDir => Spine.AssetsDir;
+
+        /// <summary>
+        /// skel 文件完整路径
+        /// </summary>
+        [DisplayName("skel文件路径")]
+        public string SkelPath => Spine.SkelPath;
+
+        /// <summary>
+        /// atlas 文件完整路径
+        /// </summary>
+        [DisplayName("atlas文件路径")]
+        public string AtlasPath => Spine.AtlasPath;
+
+        /// <summary>
+        /// 名称
+        /// </summary>
+        [DisplayName("名称")]
+        public string Name => Spine.Name;
+
+        /// <summary>
+        /// 获取所属文件版本
+        /// </summary>
+        [DisplayName("文件版本")]
+        public string FileVersion => Spine.FileVersion;
+    }
+}

SpineViewer/PropertyGridWrappers/Spine/SpineDebugWrapper.cs

@@ -0,0 +1,36 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Spine
+{
+    /// <summary>
+    /// 用于在 PropertyGrid 上显示 Spine 调试属性的包装类
+    /// </summary>
+    public class SpineDebugWrapper(SpineViewer.Spine.Spine spine)
+    {
+        [Browsable(false)]
+        public SpineViewer.Spine.Spine Spine { get; } = spine;
+
+        /// <summary>
+        /// 显示纹理
+        /// </summary>
+        [DisplayName("纹理")]
+        public bool DebugTexture { get => Spine.DebugTexture; set => Spine.DebugTexture = value; }
+
+        /// <summary>
+        /// 显示包围盒
+        /// </summary>
+        [DisplayName("包围盒")]
+        public bool DebugBounds { get => Spine.DebugBounds; set => Spine.DebugBounds = value; }
+
+        /// <summary>
+        /// 显示骨骼
+        /// </summary>
+        [DisplayName("骨架")]
+        public bool DebugBones { get => Spine.DebugBones; set => Spine.DebugBones = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Spine/SpineRenderWrapper.cs

@@ -0,0 +1,30 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Spine
+{
+    /// <summary>
+    /// 用于在 PropertyGrid 上显示 Spine 渲染设置的包装类
+    /// </summary>
+    public class SpineRenderWrapper(SpineViewer.Spine.Spine spine)
+    {
+        [Browsable(false)]
+        public SpineViewer.Spine.Spine Spine { get; } = spine;
+
+        /// <summary>
+        /// 是否被隐藏, 被隐藏的模型将仅仅在列表显示, 不参与其他行为
+        /// </summary>
+        [DisplayName("是否隐藏")]
+        public bool IsHidden { get => Spine.IsHidden; set => Spine.IsHidden = value; }
+
+        /// <summary>
+        /// 是否使用预乘Alpha
+        /// </summary>
+        [DisplayName("预乘Alpha通道")]
+        public bool UsePremultipliedAlpha { get => Spine.UsePma; set => Spine.UsePma = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Spine/SpineSkinWrapper.cs

@@ -0,0 +1,153 @@
+using SpineViewer.Spine;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Spine
+{
+    /// <summary>
+    /// 对皮肤属性的包装类
+    /// </summary>
+    [TypeConverter(typeof(SkinWrapperConverter))]
+    public class SkinWrapper(SpineViewer.Spine.Spine spine, int i)
+    {
+        private readonly SpineViewer.Spine.Spine spine = spine;
+
+        [Browsable(false)]
+        public int Index { get; } = i;
+
+        public override string ToString()
+        {
+            var loadedSkins = spine.GetLoadedSkins();
+            if (Index >= 0 && Index < loadedSkins.Length)
+                return loadedSkins[Index];
+            return "!NULL"; // XXX: 预期应该不会发生
+        }
+
+        public override bool Equals(object? obj)
+        {
+            if (obj is SkinWrapper) return ToString() == obj.ToString();
+            return base.Equals(obj);
+        }
+
+        public override int GetHashCode() => HashCode.Combine(typeof(SkinWrapper).FullName.GetHashCode(), ToString().GetHashCode());
+    }
+
+    /// <summary>
+    /// 皮肤列表动态类型包装类, 用于提供对 Spine 皮肤列表的管理能力
+    /// </summary>
+    /// <param name="spine">关联的 Spine 对象</param>
+    public class SpineSkinWrapper(SpineViewer.Spine.Spine spine) : ICustomTypeDescriptor
+    {
+        /// <summary>
+        /// 皮肤属性描述符, 实现对属性的读取和赋值
+        /// </summary>
+        private class SkinWrapperPropertyDescriptor(int i, Attribute[]? attributes) : PropertyDescriptor($"Skin{i}", attributes)
+        {
+            private readonly int idx = i;
+
+            public override Type ComponentType => typeof(SpineSkinWrapper);
+            public override bool IsReadOnly => false;
+            public override Type PropertyType => typeof(SkinWrapper);
+            public override bool CanResetValue(object component) => false;
+            public override void ResetValue(object component) { }
+            public override bool ShouldSerializeValue(object component) => false;
+
+            /// <summary>
+            /// 得到一个 SkinWrapper, 允许用户查看或者修改具体的属性值, 这个地方决定了在面板上看到的是一个对象及其属性
+            /// </summary>
+            public override object? GetValue(object? component)
+            {
+                if (component is SpineSkinWrapper manager)
+                    return manager.GetSkinWrapper(idx);
+                return null;
+            }
+
+            /// <summary>
+            /// 允许通过字符串赋值修改该位置的皮肤
+            /// </summary>
+            public override void SetValue(object? component, object? value)
+            {
+                if (component is SpineSkinWrapper manager)
+                {
+                    if (value is string s)
+                        manager.SetSkinWrapper(idx, s);
+                }
+            }
+        }
+
+        [Browsable(false)]
+        public SpineViewer.Spine.Spine Spine { get; } = spine;
+
+        /// <summary>
+        /// SkinWrapper 属性缓存
+        /// </summary>
+        private readonly Dictionary<int, SkinWrapper> skinWrapperProperties = [];
+
+        /// <summary>
+        /// 访问 SkinWrapper 属性 <c>SkinManager.Skin{i}</c>
+        /// </summary>
+        public SkinWrapper GetSkinWrapper(int i)
+        {
+            if (!skinWrapperProperties.ContainsKey(i))
+                skinWrapperProperties[i] = new SkinWrapper(Spine, i);
+            return skinWrapperProperties[i];
+        }
+
+        /// <summary>
+        /// 设置 SkinWrapper 属性 <c>SkinManager.Skin{i} = <paramref name="value"/></c>
+        /// </summary>
+        public void SetSkinWrapper(int i, string value)
+        {
+            Spine.ReplaceSkin(i, value);
+            TypeDescriptor.Refresh(this);
+        }
+
+        /// <summary>  
+        /// 在属性面板悬停可以显示已加载的皮肤列表  
+        /// </summary>  
+        public override string ToString() => $"[{string.Join(", ", Spine.GetLoadedSkins())}]";
+
+        public override bool Equals(object? obj)
+        {
+            if (obj is SpineSkinWrapper wrapper) return ToString() == wrapper.ToString();
+            return base.Equals(obj);
+        }
+
+        public override int GetHashCode() => HashCode.Combine(typeof(SpineSkinWrapper).FullName.GetHashCode(), ToString().GetHashCode());
+
+        #region ICustomTypeDescriptor 接口实现
+
+        // XXX: 必须实现 ICustomTypeDescriptor 接口, 不能继承 CustomTypeDescriptor, 似乎继承下来的东西会有问题, 导致某些调用不正确
+
+        private static readonly Dictionary<int, SkinWrapperPropertyDescriptor> pdCache = [];
+
+        public AttributeCollection GetAttributes() => TypeDescriptor.GetAttributes(this, true);
+        public string? GetClassName() => TypeDescriptor.GetClassName(this, true);
+        public string? GetComponentName() => TypeDescriptor.GetComponentName(this, true);
+        public TypeConverter? GetConverter() => TypeDescriptor.GetConverter(this, true);
+        public EventDescriptor? GetDefaultEvent() => TypeDescriptor.GetDefaultEvent(this, true);
+        public PropertyDescriptor? GetDefaultProperty() => TypeDescriptor.GetDefaultProperty(this, true);
+        public object? GetEditor(Type editorBaseType) => TypeDescriptor.GetEditor(this, editorBaseType, true);
+        public EventDescriptorCollection GetEvents() => TypeDescriptor.GetEvents(this, true);
+        public EventDescriptorCollection GetEvents(Attribute[]? attributes) => TypeDescriptor.GetEvents(this, attributes, true);
+        public object? GetPropertyOwner(PropertyDescriptor? pd) => this;
+        public PropertyDescriptorCollection GetProperties() => GetProperties(null);
+        public PropertyDescriptorCollection GetProperties(Attribute[]? attributes)
+        {
+            var props = new PropertyDescriptorCollection(TypeDescriptor.GetProperties(this, attributes, true).Cast<PropertyDescriptor>().ToArray());
+            for (var i = 0; i < Spine.GetLoadedSkins().Length; i++)
+            {
+                if (!pdCache.ContainsKey(i))
+                    pdCache[i] = new SkinWrapperPropertyDescriptor(i, [new DisplayNameAttribute($"皮肤 {i}")]);
+                props.Add(pdCache[i]);
+            }
+            return props;
+        }
+
+        #endregion
+    }
+}

SpineViewer/PropertyGridWrappers/Spine/SpineTransformWrapper.cs

@@ -0,0 +1,43 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Spine
+{
+    /// <summary>
+    /// 用于在 PropertyGrid 上显示 Spine 空间变换的包装类
+    /// </summary>
+    public class SpineTransformWrapper(SpineViewer.Spine.Spine spine)
+    {
+        [Browsable(false)]
+        public SpineViewer.Spine.Spine Spine { get; } = spine;
+
+        /// <summary>
+        /// 缩放比例
+        /// </summary>
+        [DisplayName("缩放比例")]
+        public float Scale { get => Spine.Scale; set => Spine.Scale = value; }
+
+        /// <summary>
+        /// 位置
+        /// </summary>
+        [TypeConverter(typeof(PointFConverter))]
+        [DisplayName("位置")]
+        public PointF Position { get => Spine.Position; set => Spine.Position = value; }
+
+        /// <summary>
+        /// 水平翻转
+        /// </summary>
+        [DisplayName("水平翻转")]
+        public bool FlipX { get => Spine.FlipX; set => Spine.FlipX = value; }
+
+        /// <summary>
+        /// 垂直翻转
+        /// </summary>
+        [DisplayName("垂直翻转")]
+        public bool FlipY { get => Spine.FlipY; set => Spine.FlipY = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/Spine/SpineWrapper.cs

@@ -0,0 +1,36 @@
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Drawing.Design;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers.Spine
+{
+    public class SpineWrapper(SpineViewer.Spine.Spine spine)
+    {
+        [Browsable(false)]
+        public SpineViewer.Spine.Spine Spine { get; } = spine;
+
+        [DisplayName("基本信息")]
+        public SpineBaseInfoWrapper BaseInfo { get; } = new(spine);
+
+        [DisplayName("渲染")]
+        public SpineRenderWrapper Render { get; } = new(spine);
+
+        [DisplayName("变换")]
+        public SpineTransformWrapper Transform { get; } = new(spine);
+
+        [TypeConverter(typeof(ExpandableObjectConverter))]
+        [DisplayName("皮肤")]
+        public SpineSkinWrapper Skin { get; } = new(spine);
+
+        [TypeConverter(typeof(ExpandableObjectConverter))]
+        [DisplayName("动画")]
+        public SpineAnimationWrapper Animation { get; } = new(spine);
+
+        [DisplayName("调试")]
+        public SpineDebugWrapper Debug { get; } = new(spine);
+    }
+}

SpineViewer/PropertyGridWrappers/SpinePreviewerWrapper.cs

@@ -0,0 +1,48 @@
+using SpineViewer.Controls;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers
+{
+    /// <summary>
+    /// 用于在 PropertyGrid 上显示 SpinePreviewe 属性的包装类
+    /// </summary>
+    public class SpinePreviewerWrapper(SpinePreviewer previewer)
+    {
+        [Browsable(false)]
+        public SpinePreviewer Previewer { get; } = previewer;
+
+        [TypeConverter(typeof(SizeConverter))]
+        [Category("[0] 导出"), DisplayName("分辨率")]
+        public Size Resolution { get => Previewer.Resolution; set => Previewer.Resolution = value; }
+
+        [TypeConverter(typeof(PointFConverter))]
+        [Category("[0] 导出"), DisplayName("画面中心点")]
+        public PointF Center { get => Previewer.Center; set => Previewer.Center = value; }
+
+        [Category("[0] 导出"), DisplayName("缩放")]
+        public float Zoom { get => Previewer.Zoom; set => Previewer.Zoom = value; }
+
+        [Category("[0] 导出"), DisplayName("旋转")]
+        public float Rotation { get => Previewer.Rotation; set => Previewer.Rotation = value; }
+
+        [Category("[0] 导出"), DisplayName("水平翻转")]
+        public bool FlipX { get => Previewer.FlipX; set => Previewer.FlipX = value; }
+
+        [Category("[0] 导出"), DisplayName("垂直翻转")]
+        public bool FlipY { get => Previewer.FlipY; set => Previewer.FlipY = value; }
+
+        [Category("[0] 导出"), DisplayName("仅渲染选中")]
+        public bool RenderSelectedOnly { get => Previewer.RenderSelectedOnly; set => Previewer.RenderSelectedOnly = value; }
+
+        [Category("[1] 预览"), DisplayName("显示坐标轴")]
+        public bool ShowAxis { get => Previewer.ShowAxis; set => Previewer.ShowAxis = value; }
+
+        [Category("[1] 预览"), DisplayName("最大帧率")]
+        public uint MaxFps { get => Previewer.MaxFps; set => Previewer.MaxFps = value; }
+    }
+}

SpineViewer/PropertyGridWrappers/TypeConverter.cs

@@ -0,0 +1,307 @@
+using SpineViewer.PropertyGridWrappers.Spine;
+using SpineViewer.Spine;
+using System;
+using System.Collections.Generic;
+using System.Collections.ObjectModel;
+using System.ComponentModel;
+using System.Diagnostics.CodeAnalysis;
+using System.Globalization;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace SpineViewer.PropertyGridWrappers
+{
+    public class PointFConverter : ExpandableObjectConverter
+    {
+        public override bool CanConvertTo(ITypeDescriptorContext? context, [NotNullWhen(true)] Type? destinationType)
+        {
+            return destinationType == typeof(string) || base.CanConvertTo(context, destinationType);
+        }
+
+        public override object? ConvertTo(ITypeDescriptorContext? context, CultureInfo? culture, object? value, Type destinationType)
+        {
+            if (destinationType == typeof(string) && value is PointF point)
+            {
+                return $"{point.X}, {point.Y}";
+            }
+            return base.ConvertTo(context, culture, value, destinationType);
+        }
+
+        public override bool CanConvertFrom(ITypeDescriptorContext? context, Type sourceType)
+        {
+            return sourceType == typeof(string) || base.CanConvertFrom(context, sourceType);
+        }
+
+        public override object? ConvertFrom(ITypeDescriptorContext? context, CultureInfo? culture, object value)
+        {
+            if (value is string str)
+            {
+                var parts = str.Split(',');
+                if (parts.Length == 2 &&
+                    float.TryParse(parts[0], out var x) &&
+                    float.TryParse(parts[1], out var y))
+                {
+                    return new PointF(x, y);
+                }
+            }
+            return base.ConvertFrom(context, culture, value);
+        }
+    }
+
+    public class StringEnumConverter : StringConverter
+    {
+        /// <summary>
+        /// 字符串标准值列表属性
+        /// </summary>
+        [AttributeUsage(AttributeTargets.Property, AllowMultiple = false, Inherited = false)]
+        public class StandardValuesAttribute : Attribute
+        {
+            /// <summary>
+            /// 标准值列表
+            /// </summary>
+            public ReadOnlyCollection<string> StandardValues { get; private set; }
+            private readonly List<string> standardValues = [];
+
+            /// <summary>
+            /// 是否允许用户自定义
+            /// </summary>
+            public bool Customizable { get; set; } = false;
+
+            /// <summary>
+            /// 字符串标准值列表
+            /// </summary>
+            /// <param name="values">允许的字符串标准值</param>
+            public StandardValuesAttribute(params string[] values)
+            {
+                standardValues.AddRange(values);
+                StandardValues = standardValues.AsReadOnly();
+            }
+        }
+
+        public override bool GetStandardValuesSupported(ITypeDescriptorContext? context) => true;
+
+        public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context)
+        {
+            var customizable = context?.PropertyDescriptor?.Attributes.OfType<StandardValuesAttribute>().FirstOrDefault()?.Customizable ?? false;
+            return !customizable;
+        }
+
+        public override StandardValuesCollection? GetStandardValues(ITypeDescriptorContext? context)
+        {
+            // 查找属性上的 StandardValuesAttribute
+            var attribute = context?.PropertyDescriptor?.Attributes.OfType<StandardValuesAttribute>().FirstOrDefault();
+            StandardValuesCollection result;
+            if (attribute != null)
+                result = new StandardValuesCollection(attribute.StandardValues);
+            else
+                result = new StandardValuesCollection(Array.Empty<string>());
+            return result;
+        }
+    }
+
+    public class SpineVersionConverter : EnumConverter
+    {
+        public SpineVersionConverter() : base(typeof(SpineVersion)) { }
+
+        public override object? ConvertTo(ITypeDescriptorContext? context, CultureInfo? culture, object? value, Type? destinationType)
+        {
+            if (destinationType == typeof(string) && value is SpineVersion version)
+                return version.GetName();
+            return base.ConvertTo(context, culture, value, destinationType);
+        }
+    }
+
+    public class SpineSkinNameConverter : StringConverter
+    {
+        public override bool GetStandardValuesSupported(ITypeDescriptorContext? context) => true;
+
+        public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context) => true;
+
+        public override StandardValuesCollection? GetStandardValues(ITypeDescriptorContext? context)
+        {
+            if (context?.Instance is SpineViewer.Spine.Spine obj)
+            {
+                return new StandardValuesCollection(obj.SkinNames);
+            }
+            else if (context?.Instance is SpineViewer.Spine.Spine[] spines)
+            {
+                if (spines.Length > 0)
+                {
+                    IEnumerable<string> common = spines[0].SkinNames;
+                    foreach (var spine in spines.Skip(1))
+                        common = common.Union(spine.SkinNames);
+                    return new StandardValuesCollection(common.ToArray());
+                }
+            }
+            return base.GetStandardValues(context);
+        }
+    }
+
+    public class SpineAnimationNameConverter : StringConverter
+    {
+        public override bool GetStandardValuesSupported(ITypeDescriptorContext? context) => true;
+
+        public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context) => true;
+
+        public override StandardValuesCollection? GetStandardValues(ITypeDescriptorContext? context)
+        {
+            if (context?.Instance is SpineViewer.Spine.Spine obj)
+            {
+                return new StandardValuesCollection(obj.AnimationNames);
+            }
+            else if (context?.Instance is SpineViewer.Spine.Spine[] spines)
+            {
+                if (spines.Length > 0)
+                {
+                    IEnumerable<string> common = spines[0].AnimationNames;
+                    foreach (var spine in spines.Skip(1))
+                        common = common.Union(spine.AnimationNames);
+                    return new StandardValuesCollection(common.ToArray());
+                }
+            }
+            return base.GetStandardValues(context);
+        }
+    }
+
+    /// <summary>
+    /// 皮肤位包装类转换器, 实现字符串和包装类的互相转换, 并且提供标准值列表对属性进行设置, 同时还提供在面板上显示包装类属性的能力
+    /// </summary>
+    public class SkinWrapperConverter : StringConverter
+    {
+        // NOTE: 可以不用实现 ConvertTo/ConvertFrom, 因为属性实现了与字符串之间的互转
+        // ToString 实现了 ConvertTo
+        // SetValue 实现了从字符串设置属性
+
+        public override bool GetStandardValuesSupported(ITypeDescriptorContext? context) => true;
+
+        public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context) => true;
+
+        public override StandardValuesCollection? GetStandardValues(ITypeDescriptorContext? context)
+        {
+            if (context?.Instance is SpineSkinWrapper manager)
+            {
+                return new StandardValuesCollection(manager.Spine.SkinNames);
+            }
+            else if (context?.Instance is object[] instances && instances.All(x => x is SpineSkinWrapper))
+            {
+                // XXX: 这里不知道为啥总是会得到 object[] 类型而不是具体的 SpineSkinWrapper[] 类型
+                var managers = instances.Cast<SpineSkinWrapper>().ToArray();
+                if (managers.Length > 0)
+                {
+                    IEnumerable<string> common = managers[0].Spine.SkinNames;
+                    foreach (var t in managers.Skip(1))
+                        common = common.Union(t.Spine.SkinNames);
+                    return new StandardValuesCollection(common.ToArray());
+                }
+            }
+            return base.GetStandardValues(context);
+        }
+    }
+
+    /// <summary>
+    /// 轨道索引包装类转换器, 实现字符串和包装类的互相转换, 并且提供标准值列表对属性进行设置, 同时还提供在面板上显示包装类属性的能力
+    /// </summary>
+    public class TrackWrapperConverter : ExpandableObjectConverter
+    {
+        // NOTE: 可以不用实现 ConvertTo/ConvertFrom, 因为属性实现了与字符串之间的互转
+        // ToString 实现了 ConvertTo
+        // SetValue 实现了从字符串设置属性
+
+        public override bool GetStandardValuesSupported(ITypeDescriptorContext? context) => true;
+
+        public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context) => true;
+
+        public override StandardValuesCollection? GetStandardValues(ITypeDescriptorContext? context)
+        {
+            if (context?.Instance is SpineAnimationWrapper tracks)
+            {
+                return new StandardValuesCollection(tracks.Spine.AnimationNames);
+            }
+            else if (context?.Instance is object[] instances && instances.All(x => x is SpineAnimationWrapper))
+            {
+                // XXX: 这里不知道为啥总是会得到 object[] 类型而不是具体的类型
+                var animTracks = instances.Cast<SpineAnimationWrapper>().ToArray();
+                if (animTracks.Length > 0)
+                {
+                    IEnumerable<string> common = animTracks[0].Spine.AnimationNames;
+                    foreach (var t in animTracks.Skip(1))
+                        common = common.Union(t.Spine.AnimationNames);
+                    return new StandardValuesCollection(common.ToArray());
+                }
+            }
+            return base.GetStandardValues(context);
+        }
+    }
+
+    public class SFMLColorConverter : ExpandableObjectConverter
+    {
+        private class SFMLColorPropertyDescriptor : SimplePropertyDescriptor
+        {
+            public SFMLColorPropertyDescriptor(Type componentType, string name, Type propertyType) : base(componentType, name, propertyType) { }
+
+            public override object? GetValue(object? component) => component?.GetType().GetField(Name)?.GetValue(component) ?? default;
+
+            public override void SetValue(object? component, object? value) => component?.GetType().GetField(Name)?.SetValue(component, value);
+        }
+
+        public override bool CanConvertFrom(ITypeDescriptorContext? context, Type sourceType)
+        {
+            return sourceType == typeof(string) || base.CanConvertFrom(context, sourceType);
+        }
+
+        public override object? ConvertFrom(ITypeDescriptorContext? context, CultureInfo? culture, object value)
+        {
+            if (value is string s)
+            {
+                s = s.Trim();
+                if (s.StartsWith("#") && s.Length == 9)
+                {
+                    try
+                    {
+                        // 解析 R, G, B, A 分量，注意16进制解析
+                        byte r = byte.Parse(s.Substring(1, 2), NumberStyles.HexNumber);
+                        byte g = byte.Parse(s.Substring(3, 2), NumberStyles.HexNumber);
+                        byte b = byte.Parse(s.Substring(5, 2), NumberStyles.HexNumber);
+                        byte a = byte.Parse(s.Substring(7, 2), NumberStyles.HexNumber);
+                        return new SFML.Graphics.Color(r, g, b, a);
+                    }
+                    catch (Exception ex)
+                    {
+                        throw new FormatException("无法解析颜色，确保格式为 #RRGGBBAA", ex);
+                    }
+                }
+                throw new FormatException("格式错误，正确格式为 #RRGGBBAA");
+            }
+            return base.ConvertFrom(context, culture, value);
+        }
+
+        public override bool CanConvertTo(ITypeDescriptorContext? context, Type? destinationType)
+        {
+            return destinationType == typeof(string) || base.CanConvertTo(context, destinationType);
+        }
+
+        public override object? ConvertTo(ITypeDescriptorContext? context, CultureInfo? culture, object? value, Type destinationType)
+        {
+            if (destinationType == typeof(string) && value is SFML.Graphics.Color color)
+                return $"#{color.R:X2}{color.G:X2}{color.B:X2}{color.A:X2}";
+            return base.ConvertTo(context, culture, value, destinationType);
+        }
+
+        public override PropertyDescriptorCollection GetProperties(ITypeDescriptorContext? context, object value, Attribute[]? attributes)
+        {
+            // 自定义属性集合
+            var properties = new List<PropertyDescriptor>
+            {
+                // 定义 R, G, B, A 四个字段的描述器
+                new SFMLColorPropertyDescriptor(typeof(SFML.Graphics.Color), "R", typeof(byte)),
+                new SFMLColorPropertyDescriptor(typeof(SFML.Graphics.Color), "G", typeof(byte)),
+                new SFMLColorPropertyDescriptor(typeof(SFML.Graphics.Color), "B", typeof(byte)),
+                new SFMLColorPropertyDescriptor(typeof(SFML.Graphics.Color), "A", typeof(byte))
+            };
+
+            // 返回自定义属性集合
+            return new PropertyDescriptorCollection(properties.ToArray());
+        }
+    }
+}

SpineViewer/PropertyGridWrappers/UITypeEditor.cs

@@ -0,0 +1,124 @@
+using SpineViewer.Dialogs;
+using SpineViewer.PropertyGridWrappers.Spine;
+using System;
+using System.Collections.Generic;
+using System.ComponentModel;
+using System.Drawing.Design;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using System.Windows.Forms.Design;
+
+namespace SpineViewer.PropertyGridWrappers
+{
+    /// <summary>
+    /// 使用 FolderBrowserDialog 的文件夹路径编辑器
+    /// </summary>
+    public class FolderNameEditor : UITypeEditor
+    {
+        public override UITypeEditorEditStyle GetEditStyle(ITypeDescriptorContext? context)
+        {
+            // 指定编辑风格为 Modal 对话框, 提供右边用来点击的按钮
+            return UITypeEditorEditStyle.Modal;
+        }
+
+        public override object? EditValue(ITypeDescriptorContext? context, IServiceProvider provider, object? value)
+        {
+            // 重写 EditValue 方法，提供自定义的文件夹选择对话框逻辑
+            using var dialog = new FolderBrowserDialog();
+
+            // 如果当前值为有效路径，则设置为初始选中路径
+            if (value is string currentPath && Directory.Exists(currentPath))
+                dialog.SelectedPath = currentPath;
+
+            if (dialog.ShowDialog() == DialogResult.OK)
+                value = dialog.SelectedPath;
+
+            return value;
+        }
+    }
+
+    /// <summary>
+    /// skel 文件路径编辑器
+    /// </summary>
+    public class SkelFileNameEditor : FileNameEditor
+    {
+        protected override void InitializeDialog(OpenFileDialog openFileDialog)
+        {
+            base.InitializeDialog(openFileDialog);
+            openFileDialog.Title = "选择 skel 文件";
+            openFileDialog.AddExtension = false;
+            openFileDialog.Filter = "skel 文件 (*.skel; *.json)|*.skel;*.json|二进制文件 (*.skel)|*.skel|文本文件 (*.json)|*.json|所有文件 (*.*)|*.*";
+        }
+    }
+
+    /// <summary>
+    /// atlas 文件路径编辑器
+    /// </summary>
+    public class AtlasFileNameEditor : FileNameEditor
+    {
+        protected override void InitializeDialog(OpenFileDialog openFileDialog)
+        {
+            base.InitializeDialog(openFileDialog);
+            openFileDialog.Title = "选择 atlas 文件";
+            openFileDialog.AddExtension = false;
+            openFileDialog.Filter = "atlas 文件 (*.atlas)|*.atlas|所有文件 (*.*)|*.*";
+        }
+    }
+
+    class SFMLColorEditor : UITypeEditor
+    {
+        public override bool GetPaintValueSupported(ITypeDescriptorContext? context) => true;
+
+        public override void PaintValue(PaintValueEventArgs e)
+        {
+            if (e.Value is SFML.Graphics.Color color)
+            {
+                // 定义颜色和透明度的绘制区域
+                var colorBox = new Rectangle(e.Bounds.X, e.Bounds.Y, e.Bounds.Width / 2, e.Bounds.Height);
+                var alphaBox = new Rectangle(e.Bounds.X + e.Bounds.Width / 2, e.Bounds.Y, e.Bounds.Width / 2, e.Bounds.Height);
+
+                // 转换为 System.Drawing.Color
+                var drawColor = Color.FromArgb(color.A, color.R, color.G, color.B);
+
+                // 绘制纯颜色（RGB 部分）
+                using (var brush = new SolidBrush(Color.FromArgb(color.R, color.G, color.B)))
+                {
+                    e.Graphics.FillRectangle(brush, colorBox);
+                    e.Graphics.DrawRectangle(Pens.Black, colorBox);
+                }
+
+                // 绘制带透明度效果的颜色
+                using (var checkerBrush = CreateTransparencyBrush())
+                {
+                    e.Graphics.FillRectangle(checkerBrush, alphaBox); // 背景棋盘格
+                }
+                using (var brush = new SolidBrush(drawColor))
+                {
+                    e.Graphics.FillRectangle(brush, alphaBox); // 叠加透明颜色
+                    e.Graphics.DrawRectangle(Pens.Black, alphaBox);
+                }
+            }
+            else
+            {
+                base.PaintValue(e);
+            }
+        }
+
+        // 创建一个透明背景的棋盘格图案画刷
+        private static TextureBrush CreateTransparencyBrush()
+        {
+            var bitmap = new Bitmap(8, 8);
+            using (var g = Graphics.FromImage(bitmap))
+            {
+                g.Clear(Color.White);
+                using (var grayBrush = new SolidBrush(Color.LightGray))
+                {
+                    g.FillRectangle(grayBrush, 0, 0, 4, 4);
+                    g.FillRectangle(grayBrush, 4, 4, 4, 4);
+                }
+            }
+            return new TextureBrush(bitmap);
+        }
+    }
+}

SpineViewer/Spine/BlendModeSFML.cs

@@ -1,64 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Spine
-{
-    /// <summary>
-    /// SFML 混合模式
-    /// </summary>
-    public static class BlendModeSFML
-    {
-        /// <summary>
-        /// Alpha Blend
-        /// <code>
-        /// res.c = src.c * src.a + dst.c * (1 - src.a)
-        /// res.a = src.a * 1     + dst.a * (1 - src.a)
-        /// </code>
-        /// </summary>
-        public static SFML.Graphics.BlendMode Normal = SFML.Graphics.BlendMode.Alpha;
-
-        /// <summary>
-        /// Additive Blend
-        /// <code>
-        /// res.c = src.c * src.a + dst.c * 1
-        /// res.a = src.a * 1     + dst.a * 1
-        /// </code>
-        /// </summary>
-        public static SFML.Graphics.BlendMode Additive = SFML.Graphics.BlendMode.Add;
-
-        /// <summary>
-        /// Multiply Blend (PremultipliedAlpha Only)
-        /// <code>
-        /// res.c = src.c * dst.c + dst.c * (1 - src.a)
-        /// res.a = src.a * 1     + dst.a * (1 - src.a)
-        /// </code>
-        /// </summary>
-        public static SFML.Graphics.BlendMode Multiply = new(
-            SFML.Graphics.BlendMode.Factor.DstColor,
-            SFML.Graphics.BlendMode.Factor.OneMinusSrcAlpha,
-            SFML.Graphics.BlendMode.Equation.Add,
-            SFML.Graphics.BlendMode.Factor.One,
-            SFML.Graphics.BlendMode.Factor.OneMinusSrcAlpha,
-            SFML.Graphics.BlendMode.Equation.Add
-        );
-
-        /// <summary>
-        /// Screen Blend (PremultipliedAlpha Only)
-        /// <code>
-        /// res.c = src.c * 1 + dst.c * (1 - src.c) = 1 - [(1 - src.c)(1 - dst.c)]
-        /// res.a = src.a * 1 + dst.a * (1 - src.a)
-        /// </code>
-        /// </summary>
-        public static SFML.Graphics.BlendMode Screen = new(
-            SFML.Graphics.BlendMode.Factor.One,
-            SFML.Graphics.BlendMode.Factor.OneMinusSrcColor,
-            SFML.Graphics.BlendMode.Equation.Add,
-            SFML.Graphics.BlendMode.Factor.One,
-            SFML.Graphics.BlendMode.Factor.OneMinusSrcAlpha,
-            SFML.Graphics.BlendMode.Equation.Add
-        );
-    }
-}

SpineViewer/Spine/Implementations/SkeletonConverter/SkeletonConverter38.cs

@@ -11,7 +11,7 @@ using System.Globalization;
 
 namespace SpineViewer.Spine.Implementations.SkeletonConverter
 {
-    [SpineImplementation(Version.V38)]
+    [SpineImplementation(SpineVersion.V38)]
     class SkeletonConverter38 : SpineViewer.Spine.SkeletonConverter
     {
         private BinaryReader reader = null;
@@ -1286,11 +1286,11 @@ namespace SpineViewer.Spine.Implementations.SkeletonConverter
             base.WriteJson(root, jsonPath);
         }
 
-        public override JsonObject ToVersion(JsonObject root, Version version)
+        public override JsonObject ToVersion(JsonObject root, SpineVersion version)
         {
             root = version switch
             {
-                Version.V38 => root.DeepClone().AsObject(),
+                SpineVersion.V38 => root.DeepClone().AsObject(),
                 _ => throw new NotImplementedException(),
             };
             return root;

SpineViewer/Spine/Implementations/Spine/Spine21.cs

@@ -7,10 +7,11 @@ using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 using SpineRuntime21;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine.Implementations.Spine
 {
-    [SpineImplementation(Version.V21)]
+    [SpineImplementation(SpineVersion.V21)]
     internal class Spine21 : SpineViewer.Spine.Spine
     {
         private static readonly Animation EmptyAnimation = new(EMPTY_ANIMATION, [], 0);
@@ -47,7 +48,7 @@ namespace SpineViewer.Spine.Implementations.Spine
         // 2.1.x 不支持剪裁
         //private SkeletonClipping clipping = new(); 
 
-        public Spine21(string skelPath, string? atlasPath = null) : base(skelPath, atlasPath)
+        public Spine21(string skelPath, string atlasPath) : base(skelPath, atlasPath)
         {
             atlas = new Atlas(AtlasPath, textureLoader);
             try
@@ -76,16 +77,12 @@ namespace SpineViewer.Spine.Implementations.Spine
             foreach (var skin in skeletonData.Skins)
                 skinNames.Add(skin.Name);
 
-            animationStateData = new AnimationStateData(skeletonData);
-            skeleton = new Skeleton(skeletonData);
-            animationState = new AnimationState(animationStateData);
-
             foreach (var anime in skeletonData.Animations)
                 animationNames.Add(anime.Name);
 
-            // 取最后一个作为初始, 尽可能去显示非默认的内容
-            CurrentAnimation = animationNames.Last();
-            CurrentSkin = skinNames.Last();
+            skeleton = new Skeleton(skeletonData);
+            animationStateData = new AnimationStateData(skeletonData);
+            animationState = new AnimationState(animationStateData);
         }
 
         protected override void Dispose(bool disposing)
@@ -96,7 +93,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         public override string FileVersion { get => skeletonData.Version; }
 
-        public override float Scale
+        protected override float scale
         {
             get
             {
@@ -110,21 +107,19 @@ namespace SpineViewer.Spine.Implementations.Spine
             set
             {
                 // 保存状态
-                var position = Position;
-                var flipX = FlipX;
-                var flipY = FlipY;
-                var animation = CurrentAnimation;
-                var skin = CurrentSkin;
+                var pos = position;
+                var fX = flipX;
+                var fY = flipY;
+                var animations = animationState.Tracks.Where(te => te is not null).Select(te => te.Animation.Name).ToArray();
 
-                var val = Math.Max(value, SCALE_MIN);
                 if (skeletonBinary is not null)
                 {
-                    skeletonBinary.Scale = val;
+                    skeletonBinary.Scale = value;
                     skeletonData = skeletonBinary.ReadSkeletonData(SkelPath);
                 }
                 else if (skeletonJson is not null)
                 {
-                    skeletonJson.Scale = val;
+                    skeletonJson.Scale = value;
                     skeletonData = skeletonJson.ReadSkeletonData(SkelPath);
                 }
 
@@ -134,62 +129,66 @@ namespace SpineViewer.Spine.Implementations.Spine
                 animationState = new AnimationState(animationStateData);
 
                 // 恢复状态
-                Position = position;
-                FlipX = flipX;
-                FlipY = flipY;
-                CurrentAnimation = animation;
-                CurrentSkin = skin;
+                position = pos;
+                flipX = fX;
+                flipY = fY;
+                foreach (var s in loadedSkins) addSkin(s);
+                for (int i = 0; i < animations.Length; i++) setAnimation(i, animations[i]);
             }
         }
 
-        public override PointF Position 
-        { 
-            get => new(skeleton.X, skeleton.Y); 
-            set 
-            { 
-                skeleton.X = value.X; 
-                skeleton.Y = value.Y; 
-            } 
+        protected override PointF position
+        {
+            get => new(skeleton.X, skeleton.Y);
+            set
+            {
+                skeleton.X = value.X;
+                skeleton.Y = value.Y;
+            }
         }
 
-        public override bool FlipX
+        protected override bool flipX
         {
             get => skeleton.FlipX;
             set => skeleton.FlipX = value;
         }
 
-        public override bool FlipY
+        protected override bool flipY
         {
             get => skeleton.FlipY;
             set => skeleton.FlipY = value;
         }
 
-        public override string CurrentAnimation
+        protected override void addSkin(string name)
         {
-            get => animationState.GetCurrent(0)?.Animation.Name ?? EMPTY_ANIMATION;
-            set
-            {
-                if (value == EMPTY_ANIMATION)
-                    animationState.SetAnimation(0, EmptyAnimation, false);
-                else if (animationNames.Contains(value))
-                    animationState.SetAnimation(0, value, true);
-                Update(0);
-            }
+            if (!skinNames.Contains(name)) return;
+            skeleton.SetSkin(name); // XXX: 3.7 及以下不支持 AddSkin
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override string CurrentSkin
+        protected override void clearSkin()
         {
-            get => skeleton.Skin?.Name ?? "default";
-            set
-            {
-                if (!skinNames.Contains(value)) return;
-                skeleton.SetSkin(value);
-                skeleton.SetToSetupPose();
-                Update(0);
-            }
+            skeleton.SetSkin(skeletonData.DefaultSkin);
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override RectangleF Bounds
+        protected override int[] getTrackIndices() => animationState.Tracks.Select((_, i) => i).Where(i => animationState.Tracks[i] is not null).ToArray();
+
+        protected override string getAnimation(int track) => animationState.GetCurrent(track)?.Animation.Name ?? EMPTY_ANIMATION;
+
+        protected override void setAnimation(int track, string name)
+        {
+            if (name == EMPTY_ANIMATION)
+                animationState.SetAnimation(track, EmptyAnimation, false);
+            else if (animationNames.Contains(name))
+                animationState.SetAnimation(track, name, true);
+        }
+
+        protected override void clearTrack(int i) => animationState.ClearTrack(i);
+
+        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
+
+        protected override RectangleF bounds
         {
             get
             {
@@ -239,9 +238,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
-
-        public override void Update(float delta)
+        protected override void update(float delta)
         {
             animationState.Update(delta);
             animationState.Apply(skeleton);
@@ -261,10 +258,11 @@ namespace SpineViewer.Spine.Implementations.Spine
         //    };
         //}
 
-        public override void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
+        protected override void draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
         {
             vertexArray.Clear();
             states.Texture = null;
+            states.Shader = SFMLShader.GetSpineShader(usePma);
 
             // 要用 DrawOrder 而不是 Slots
             foreach (var slot in skeleton.DrawOrder)
@@ -326,20 +324,15 @@ namespace SpineViewer.Spine.Implementations.Spine
                 }
 
                 // 似乎 2.1.x 也没有 BlendMode
-                SFML.Graphics.BlendMode blendMode = slot.Data.AdditiveBlending ? BlendModeSFML.Additive : BlendModeSFML.Normal;
+                SFML.Graphics.BlendMode blendMode = slot.Data.AdditiveBlending ? SFMLBlendMode.AdditivePma : SFMLBlendMode.NormalPma;
 
                 states.Texture ??= texture;
                 if (states.BlendMode != blendMode || states.Texture != texture)
                 {
                     if (vertexArray.VertexCount > 0)
                     {
-                        if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                            states.Shader = FragmentShader;
-                        else
-                            states.Shader = null;
-
                         // 调试纹理
-                        if (!IsDebug || DebugTexture)
+                        if (!isDebug || debugTexture)
                             target.Draw(vertexArray, states);
 
                         vertexArray.Clear();
@@ -381,25 +374,20 @@ namespace SpineViewer.Spine.Implementations.Spine
 
                 //clipping.ClipEnd(slot);
             }
-
-            if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                states.Shader = FragmentShader;
-            else
-                states.Shader = null;
             //clipping.ClipEnd();
 
             // 调试纹理
-            if (!IsDebug || DebugTexture)
+            if (!isDebug || debugTexture)
                 target.Draw(vertexArray, states);
 
             // 包围盒
-            if (IsDebug && IsSelected && DebugBounds)
+            if (isDebug && isSelected && debugBounds)
             {
-                var bounds = Bounds;
-                boundsVertices[0] = boundsVertices[4] = new(new(bounds.Left, bounds.Top), BoundsColor);
-                boundsVertices[1] = new(new(bounds.Right, bounds.Top), BoundsColor);
-                boundsVertices[2] = new(new(bounds.Right, bounds.Bottom), BoundsColor);
-                boundsVertices[3] = new(new(bounds.Left, bounds.Bottom), BoundsColor);
+                var b = bounds;
+                boundsVertices[0] = boundsVertices[4] = new(new(b.Left, b.Top), BoundsColor);
+                boundsVertices[1] = new(new(b.Right, b.Top), BoundsColor);
+                boundsVertices[2] = new(new(b.Right, b.Bottom), BoundsColor);
+                boundsVertices[3] = new(new(b.Left, b.Bottom), BoundsColor);
                 target.Draw(boundsVertices);
             }
         }

SpineViewer/Spine/Implementations/Spine/Spine36.cs

@@ -7,10 +7,11 @@ using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 using SpineRuntime36;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine.Implementations.Spine
 {
-    [SpineImplementation(Version.V36)]
+    [SpineImplementation(SpineVersion.V36)]
     internal class Spine36 : SpineViewer.Spine.Spine
     {
         private static readonly Animation EmptyAnimation = new(EMPTY_ANIMATION, [], 0);
@@ -46,7 +47,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         private SkeletonClipping clipping = new();
 
-        public Spine36(string skelPath, string? atlasPath = null) : base(skelPath, atlasPath)
+        public Spine36(string skelPath, string atlasPath) : base(skelPath, atlasPath)
         {
             atlas = new Atlas(AtlasPath, textureLoader);
             try
@@ -75,16 +76,12 @@ namespace SpineViewer.Spine.Implementations.Spine
             foreach (var skin in skeletonData.Skins)
                 skinNames.Add(skin.Name);
 
-            animationStateData = new AnimationStateData(skeletonData);
-            skeleton = new Skeleton(skeletonData);
-            animationState = new AnimationState(animationStateData);
-
             foreach (var anime in skeletonData.Animations)
                 animationNames.Add(anime.Name);
 
-            // 取最后一个作为初始, 尽可能去显示非默认的内容
-            CurrentAnimation = animationNames.Last();
-            CurrentSkin = skinNames.Last();
+            skeleton = new Skeleton(skeletonData);
+            animationStateData = new AnimationStateData(skeletonData);
+            animationState = new AnimationState(animationStateData);
         }
 
         protected override void Dispose(bool disposing)
@@ -95,7 +92,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         public override string FileVersion { get => skeletonData.Version; }
 
-        public override float Scale
+        protected override float scale
         {
             get
             {
@@ -109,21 +106,19 @@ namespace SpineViewer.Spine.Implementations.Spine
             set
             {
                 // 保存状态
-                var position = Position;
-                var flipX = FlipX;
-                var flipY = FlipY;
-                var animation = CurrentAnimation;
-                var skin = CurrentSkin;
+                var pos = position;
+                var fX = flipX;
+                var fY = flipY;
+                var animations = animationState.Tracks.Where(te => te is not null).Select(te => te.Animation.Name).ToArray();
 
-                var val = Math.Max(value, SCALE_MIN);
                 if (skeletonBinary is not null)
                 {
-                    skeletonBinary.Scale = val;
+                    skeletonBinary.Scale = value;
                     skeletonData = skeletonBinary.ReadSkeletonData(SkelPath);
                 }
                 else if (skeletonJson is not null)
                 {
-                    skeletonJson.Scale = val;
+                    skeletonJson.Scale = value;
                     skeletonData = skeletonJson.ReadSkeletonData(SkelPath);
                 }
 
@@ -133,62 +128,66 @@ namespace SpineViewer.Spine.Implementations.Spine
                 animationState = new AnimationState(animationStateData);
 
                 // 恢复状态
-                Position = position;
-                FlipX = flipX;
-                FlipY = flipY;
-                CurrentAnimation = animation;
-                CurrentSkin = skin;
+                position = pos;
+                flipX = fX;
+                flipY = fY;
+                foreach (var s in loadedSkins) addSkin(s);
+                for (int i = 0; i < animations.Length; i++) setAnimation(i, animations[i]);
             }
         }
 
-        public override PointF Position 
+        protected override PointF position 
         { 
             get => new(skeleton.X, skeleton.Y); 
             set 
             { 
                 skeleton.X = value.X; 
-                skeleton.Y = value.Y; 
+                skeleton.Y = value.Y;
             } 
         }
 
-        public override bool FlipX
+        protected override bool flipX
         {
             get => skeleton.FlipX;
             set => skeleton.FlipX = value;
         }
 
-        public override bool FlipY
+        protected override bool flipY
         {
             get => skeleton.FlipY;
             set => skeleton.FlipY = value;
         }
 
-        public override string CurrentAnimation
+        protected override void addSkin(string name)
         {
-            get => animationState.GetCurrent(0)?.Animation.Name ?? EMPTY_ANIMATION;
-            set
-            {
-                if (value == EMPTY_ANIMATION)
-                    animationState.SetAnimation(0, EmptyAnimation, false);
-                else if (animationNames.Contains(value))
-                    animationState.SetAnimation(0, value, true);
-                Update(0);
-            }
+            if (!skinNames.Contains(name)) return;
+            skeleton.SetSkin(name); // XXX: 3.7 及以下不支持 AddSkin
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override string CurrentSkin
+        protected override void clearSkin()
         {
-            get => skeleton.Skin?.Name ?? "default";
-            set
-            {
-                if (!skinNames.Contains(value)) return;
-                skeleton.SetSkin(value);
-                skeleton.SetToSetupPose();
-                Update(0);
-            }
+            skeleton.SetSkin(skeletonData.DefaultSkin);
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override RectangleF Bounds
+        protected override int[] getTrackIndices() => animationState.Tracks.Select((_, i) => i).Where(i => animationState.Tracks.Items[i] is not null).ToArray();
+
+        protected override string getAnimation(int track) => animationState.GetCurrent(track)?.Animation.Name ?? EMPTY_ANIMATION;
+
+        protected override void setAnimation(int track, string name)
+        {
+            if (name == EMPTY_ANIMATION)
+                animationState.SetAnimation(track, EmptyAnimation, false);
+            else if (animationNames.Contains(name))
+                animationState.SetAnimation(track, name, true);
+        }
+
+        protected override void clearTrack(int i) => animationState.ClearTrack(i);
+
+        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
+
+        protected override RectangleF bounds
         {
             get
             {
@@ -198,9 +197,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
-
-        public override void Update(float delta)
+        protected override void update(float delta)
         {
             animationState.Update(delta);
             animationState.Apply(skeleton);
@@ -212,18 +209,19 @@ namespace SpineViewer.Spine.Implementations.Spine
         {
             return spineBlendMode switch
             {
-                BlendMode.Normal => BlendModeSFML.Normal,
-                BlendMode.Additive => BlendModeSFML.Additive,
-                BlendMode.Multiply => BlendModeSFML.Multiply,
-                BlendMode.Screen => BlendModeSFML.Screen,
+                BlendMode.Normal => SFMLBlendMode.NormalPma,
+                BlendMode.Additive => SFMLBlendMode.AdditivePma,
+                BlendMode.Multiply => SFMLBlendMode.MultiplyPma,
+                BlendMode.Screen => SFMLBlendMode.ScreenPma,
                 _ => throw new NotImplementedException($"{spineBlendMode}"),
             };
         }
 
-        public override void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
+        protected override void draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
         {
             vertexArray.Clear();
             states.Texture = null;
+            states.Shader = SFMLShader.GetSpineShader(usePma);
 
             // 要用 DrawOrder 而不是 Slots
             foreach (var slot in skeleton.DrawOrder)
@@ -290,13 +288,8 @@ namespace SpineViewer.Spine.Implementations.Spine
                 {
                     if (vertexArray.VertexCount > 0)
                     {
-                        if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                            states.Shader = FragmentShader;
-                        else
-                            states.Shader = null;
-
                         // 调试纹理
-                        if (!IsDebug || DebugTexture)
+                        if (!isDebug || debugTexture)
                             target.Draw(vertexArray, states);
 
                         vertexArray.Clear();
@@ -340,23 +333,18 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
             clipping.ClipEnd();
 
-            if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                states.Shader = FragmentShader;
-            else
-                states.Shader = null;
-
             // 调试纹理
-            if (!IsDebug || DebugTexture)
+            if (!isDebug || debugTexture)
                 target.Draw(vertexArray, states);
 
             // 包围盒
-            if (IsDebug && IsSelected && DebugBounds)
+            if (isDebug && isSelected && debugBounds)
             {
-                var bounds = Bounds;
-                boundsVertices[0] = boundsVertices[4] = new(new(bounds.Left, bounds.Top), BoundsColor);
-                boundsVertices[1] = new(new(bounds.Right, bounds.Top), BoundsColor);
-                boundsVertices[2] = new(new(bounds.Right, bounds.Bottom), BoundsColor);
-                boundsVertices[3] = new(new(bounds.Left, bounds.Bottom), BoundsColor);
+                var b = bounds;
+                boundsVertices[0] = boundsVertices[4] = new(new(b.Left, b.Top), BoundsColor);
+                boundsVertices[1] = new(new(b.Right, b.Top), BoundsColor);
+                boundsVertices[2] = new(new(b.Right, b.Bottom), BoundsColor);
+                boundsVertices[3] = new(new(b.Left, b.Bottom), BoundsColor);
                 target.Draw(boundsVertices);
             }
         }

SpineViewer/Spine/Implementations/Spine/Spine37.cs

@@ -4,10 +4,11 @@ using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 using SpineRuntime37;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine.Implementations.Spine
 {
-    [SpineImplementation(Version.V37)]
+    [SpineImplementation(SpineVersion.V37)]
     internal class Spine37 : SpineViewer.Spine.Spine
     {
         private static readonly Animation EmptyAnimation = new(EMPTY_ANIMATION, [], 0);
@@ -44,7 +45,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         private SkeletonClipping clipping = new();
 
-        public Spine37(string skelPath, string? atlasPath = null) : base(skelPath, atlasPath)
+        public Spine37(string skelPath, string atlasPath) : base(skelPath, atlasPath)
         {
             atlas = new Atlas(AtlasPath, textureLoader);
             try
@@ -73,16 +74,12 @@ namespace SpineViewer.Spine.Implementations.Spine
             foreach (var skin in skeletonData.Skins)
                 skinNames.Add(skin.Name);
 
-            animationStateData = new AnimationStateData(skeletonData);
-            skeleton = new Skeleton(skeletonData);
-            animationState = new AnimationState(animationStateData);
-
             foreach (var anime in skeletonData.Animations)
                 animationNames.Add(anime.Name);
 
-            // 取最后一个作为初始, 尽可能去显示非默认的内容
-            CurrentAnimation = animationNames.Last();
-            CurrentSkin = skinNames.Last();
+            skeleton = new Skeleton(skeletonData);
+            animationStateData = new AnimationStateData(skeletonData);
+            animationState = new AnimationState(animationStateData);
         }
 
         protected override void Dispose(bool disposing)
@@ -93,64 +90,17 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         public override string FileVersion { get => skeletonData.Version; }
 
-        public override float Scale
+        protected override float scale
         {
-            get
-            {
-                if (skeletonBinary is not null)
-                    return skeletonBinary.Scale;
-                else if (skeletonJson is not null)
-                    return skeletonJson.Scale;
-                else
-                    return 1f;
-            }
+            get => Math.Abs(skeleton.ScaleX);
             set
             {
-                // 保存状态
-                var position = Position;
-                var flipX = FlipX;
-                var flipY = FlipY;
-                var savedTrack0 = animationState.GetCurrent(0);
-
-                var val = Math.Max(value, SCALE_MIN);
-                if (skeletonBinary is not null)
-                {
-                    skeletonBinary.Scale = val;
-                    skeletonData = skeletonBinary.ReadSkeletonData(SkelPath);
-                }
-                else if (skeletonJson is not null)
-                {
-                    skeletonJson.Scale = val;
-                    skeletonData = skeletonJson.ReadSkeletonData(SkelPath);
-                }
-
-                // reload skel-dependent data
-                animationStateData = new AnimationStateData(skeletonData) { DefaultMix = animationStateData.DefaultMix };
-                skeleton = new Skeleton(skeletonData);
-                animationState = new AnimationState(animationStateData);
-
-                // 恢复状态
-                Position = position;
-                FlipX = flipX;
-                FlipY = flipY;
-
-                // 恢复原本 Track0 上所有动画
-                if (savedTrack0 is not null)
-                {
-                    var entry = animationState.SetAnimation(0, savedTrack0.Animation.Name, true);
-                    entry.TrackTime = savedTrack0.TrackTime;
-                    var savedEntry = savedTrack0.Next;
-                    while (savedEntry is not null)
-                    {
-                        entry = animationState.AddAnimation(0, savedEntry.Animation.Name, true, 0);
-                        entry.TrackTime = savedEntry.TrackTime;
-                        savedEntry = savedEntry.Next;
-                    }
-                }
+                skeleton.ScaleX = Math.Sign(skeleton.ScaleX) * value;
+                skeleton.ScaleY = Math.Sign(skeleton.ScaleY) * value;
             }
         }
 
-        public override PointF Position
+        protected override PointF position
         {
             get => new(skeleton.X, skeleton.Y);
             set
@@ -160,7 +110,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipX
+        protected override bool flipX
         {
             get => skeleton.ScaleX < 0;
             set
@@ -170,7 +120,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipY
+        protected override bool flipY
         {
             get => skeleton.ScaleY < 0;
             set
@@ -180,32 +130,36 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override string CurrentAnimation
+        protected override void addSkin(string name)
         {
-            get => animationState.GetCurrent(0)?.Animation.Name ?? EMPTY_ANIMATION;
-            set
-            {
-                if (value == EMPTY_ANIMATION)
-                    animationState.SetAnimation(0, EmptyAnimation, false);
-                else if (animationNames.Contains(value))
-                    animationState.SetAnimation(0, value, true);
-                Update(0);
-            }
+            if (!skinNames.Contains(name)) return;
+            skeleton.SetSkin(name); // XXX: 3.7 及以下不支持 AddSkin
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override string CurrentSkin
+        protected override void clearSkin()
         {
-            get => skeleton.Skin?.Name ?? "default";
-            set
-            {
-                if (!skinNames.Contains(value)) return;
-                skeleton.SetSkin(value);
-                skeleton.SetToSetupPose();
-                Update(0);
-            }
+            skeleton.SetSkin(skeletonData.DefaultSkin);
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override RectangleF Bounds
+        protected override int[] getTrackIndices() => animationState.Tracks.Select((_, i) => i).Where(i => animationState.Tracks.Items[i] is not null).ToArray();
+
+        protected override string getAnimation(int track) => animationState.GetCurrent(track)?.Animation.Name ?? EMPTY_ANIMATION;
+
+        protected override void setAnimation(int track, string name)
+        {
+            if (name == EMPTY_ANIMATION)
+                animationState.SetAnimation(track, EmptyAnimation, false);
+            else if (animationNames.Contains(name))
+                animationState.SetAnimation(track, name, true);
+        }
+
+        protected override void clearTrack(int i) => animationState.ClearTrack(i);
+
+        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
+
+        protected override RectangleF bounds
         {
             get
             {
@@ -215,9 +169,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
-
-        public override void Update(float delta)
+        protected override void update(float delta)
         {
             animationState.Update(delta);
             animationState.Apply(skeleton);
@@ -229,18 +181,19 @@ namespace SpineViewer.Spine.Implementations.Spine
         {
             return spineBlendMode switch
             {
-                BlendMode.Normal => BlendModeSFML.Normal,
-                BlendMode.Additive => BlendModeSFML.Additive,
-                BlendMode.Multiply => BlendModeSFML.Multiply,
-                BlendMode.Screen => BlendModeSFML.Screen,
+                BlendMode.Normal => SFMLBlendMode.NormalPma,
+                BlendMode.Additive => SFMLBlendMode.AdditivePma,
+                BlendMode.Multiply => SFMLBlendMode.MultiplyPma,
+                BlendMode.Screen => SFMLBlendMode.ScreenPma,
                 _ => throw new NotImplementedException($"{spineBlendMode}"),
             };
         }
 
-        public override void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
+        protected override void draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
         {
             vertexArray.Clear();
             states.Texture = null;
+            states.Shader = SFMLShader.GetSpineShader(usePma);
 
             // 要用 DrawOrder 而不是 Slots
             foreach (var slot in skeleton.DrawOrder)
@@ -307,14 +260,8 @@ namespace SpineViewer.Spine.Implementations.Spine
                 {
                     if (vertexArray.VertexCount > 0)
                     {
-                        // XXX: 实测不用设置 sampler2D 的值也正确
-                        if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                            states.Shader = FragmentShader;
-                        else
-                            states.Shader = null;
-
                         // 调试纹理
-                        if (!IsDebug || DebugTexture)
+                        if (!isDebug || debugTexture)
                             target.Draw(vertexArray, states);
 
                         vertexArray.Clear();
@@ -358,23 +305,18 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
             clipping.ClipEnd();
 
-            if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                states.Shader = FragmentShader;
-            else
-                states.Shader = null;
-
             // 调试纹理
-            if (!IsDebug || DebugTexture)
+            if (!isDebug || debugTexture)
                 target.Draw(vertexArray, states);
 
             // 包围盒
-            if (IsDebug && IsSelected && DebugBounds)
+            if (isDebug && isSelected && debugBounds)
             {
-                var bounds = Bounds;
-                boundsVertices[0] = boundsVertices[4] = new(new(bounds.Left, bounds.Top), BoundsColor);
-                boundsVertices[1] = new(new(bounds.Right, bounds.Top), BoundsColor);
-                boundsVertices[2] = new(new(bounds.Right, bounds.Bottom), BoundsColor);
-                boundsVertices[3] = new(new(bounds.Left, bounds.Bottom), BoundsColor);
+                var b = bounds;
+                boundsVertices[0] = boundsVertices[4] = new(new(b.Left, b.Top), BoundsColor);
+                boundsVertices[1] = new(new(b.Right, b.Top), BoundsColor);
+                boundsVertices[2] = new(new(b.Right, b.Bottom), BoundsColor);
+                boundsVertices[3] = new(new(b.Left, b.Bottom), BoundsColor);
                 target.Draw(boundsVertices);
             }
         }

SpineViewer/Spine/Implementations/Spine/Spine38.cs

@@ -7,10 +7,11 @@ using System.Text;
 using System.Threading.Tasks;
 using SpineRuntime38;
 using SpineRuntime38.Attachments;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine.Implementations.Spine
 {
-    [SpineImplementation(Version.V38)]
+    [SpineImplementation(SpineVersion.V38)]
     internal class Spine38 : SpineViewer.Spine.Spine
     {
         private static readonly Animation EmptyAnimation = new(EMPTY_ANIMATION, [], 0);
@@ -50,7 +51,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         private SkeletonClipping clipping = new();
 
-        public Spine38(string skelPath, string? atlasPath = null) : base(skelPath, atlasPath)
+        public Spine38(string skelPath, string atlasPath) : base(skelPath, atlasPath)
         {
             atlas = new Atlas(AtlasPath, textureLoader);
             try
@@ -79,16 +80,12 @@ namespace SpineViewer.Spine.Implementations.Spine
             foreach (var skin in skeletonData.Skins)
                 skinNames.Add(skin.Name);
 
-            animationStateData = new AnimationStateData(skeletonData);
-            skeleton = new Skeleton(skeletonData);
-            animationState = new AnimationState(animationStateData);
-
             foreach (var anime in skeletonData.Animations)
                 animationNames.Add(anime.Name);
 
-            // 取最后一个作为初始, 尽可能去显示非默认的内容
-            CurrentAnimation = animationNames.Last();
-            CurrentSkin = skinNames.Last();
+            skeleton = new Skeleton(skeletonData) { Skin = new(Guid.NewGuid().ToString()) }; // 挂载一个空皮肤当作容器
+            animationStateData = new AnimationStateData(skeletonData);
+            animationState = new AnimationState(animationStateData);
         }
 
         protected override void Dispose(bool disposing)
@@ -99,7 +96,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         public override string FileVersion { get => skeletonData.Version; }
 
-        public override float Scale
+        protected override float scale
         {
             get => Math.Abs(skeleton.ScaleX);
             set
@@ -109,7 +106,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override PointF Position
+        protected override PointF position
         {
             get => new(skeleton.X, skeleton.Y);
             set
@@ -119,7 +116,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipX
+        protected override bool flipX
         {
             get => skeleton.ScaleX < 0;
             set
@@ -129,7 +126,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipY
+        protected override bool flipY
         {
             get => skeleton.ScaleY < 0;
             set
@@ -139,32 +136,38 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override string CurrentAnimation
+        protected override void addSkin(string name)
         {
-            get => animationState.GetCurrent(0)?.Animation.Name ?? EMPTY_ANIMATION;
-            set 
+            if (skeletonData.FindSkin(name) is Skin sk)
             {
-                if (value == EMPTY_ANIMATION)
-                    animationState.SetAnimation(0, EmptyAnimation, false);
-                else if (animationNames.Contains(value))
-                    animationState.SetAnimation(0, value, true);
-                Update(0);
+                skeleton.Skin.AddSkin(sk);
+                skeleton.SetSlotsToSetupPose();
             }
         }
 
-        public override string CurrentSkin
+        protected override void clearSkin()
         {
-            get => skeleton.Skin?.Name ?? "default";
-            set
-            {
-                if (!skinNames.Contains(value)) return;
-                skeleton.SetSkin(value);
-                skeleton.SetToSetupPose();
-                Update(0);
-            }
+            skeleton.Skin.Clear();
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override RectangleF Bounds
+        protected override int[] getTrackIndices() => animationState.Tracks.Select((_, i) => i).Where(i => animationState.Tracks.Items[i] is not null).ToArray();
+
+        protected override string getAnimation(int track) => animationState.GetCurrent(track)?.Animation.Name ?? EMPTY_ANIMATION;
+
+        protected override void setAnimation(int track, string name)
+        {
+            if (name == EMPTY_ANIMATION)
+                animationState.SetAnimation(track, EmptyAnimation, false);
+            else if (animationNames.Contains(name))
+                animationState.SetAnimation(track, name, true);
+        }
+
+        protected override void clearTrack(int i) => animationState.ClearTrack(i);
+
+        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
+
+        protected override RectangleF bounds
         {
             get
             {
@@ -174,9 +177,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
-
-        public override void Update(float delta)
+        protected override void update(float delta)
         {
             animationState.Update(delta);
             animationState.Apply(skeleton);
@@ -188,18 +189,19 @@ namespace SpineViewer.Spine.Implementations.Spine
         {
             return spineBlendMode switch
             {
-                BlendMode.Normal => BlendModeSFML.Normal,
-                BlendMode.Additive => BlendModeSFML.Additive,
-                BlendMode.Multiply => BlendModeSFML.Multiply,
-                BlendMode.Screen => BlendModeSFML.Screen,
+                BlendMode.Normal => SFMLBlendMode.NormalPma,
+                BlendMode.Additive => SFMLBlendMode.AdditivePma,
+                BlendMode.Multiply => SFMLBlendMode.MultiplyPma,
+                BlendMode.Screen => SFMLBlendMode.ScreenPma,
                 _ => throw new NotImplementedException($"{spineBlendMode}"),
             };
         }
 
-        public override void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
+        protected override void draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
         {
             vertexArray.Clear();
             states.Texture = null;
+            states.Shader = SFMLShader.GetSpineShader(usePma);
 
             // 要用 DrawOrder 而不是 Slots
             foreach (var slot in skeleton.DrawOrder)
@@ -266,14 +268,8 @@ namespace SpineViewer.Spine.Implementations.Spine
                 {
                     if (vertexArray.VertexCount > 0)
                     {
-                        // XXX: 实测不用设置 sampler2D 的值也正确
-                        if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                            states.Shader = FragmentShader;
-                        else
-                            states.Shader = null;
-
                         // 调试纹理
-                        if (!IsDebug || DebugTexture)
+                        if (!isDebug || debugTexture) 
                             target.Draw(vertexArray, states);
 
                         vertexArray.Clear();
@@ -317,23 +313,18 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
             clipping.ClipEnd();
 
-            if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                states.Shader = FragmentShader;
-            else
-                states.Shader = null;
-
             // 调试纹理
-            if (!IsDebug || DebugTexture)
+            if (!isDebug || debugTexture)
                 target.Draw(vertexArray, states);
 
             // 调试包围盒
-            if (IsDebug && IsSelected && DebugBounds)
+            if (isDebug && isSelected && debugBounds)
             {
-                var bounds = Bounds;
-                boundsVertices[0] = boundsVertices[4] = new(new(bounds.Left, bounds.Top), BoundsColor);
-                boundsVertices[1] = new(new(bounds.Right, bounds.Top), BoundsColor);
-                boundsVertices[2] = new(new(bounds.Right, bounds.Bottom), BoundsColor);
-                boundsVertices[3] = new(new(bounds.Left, bounds.Bottom), BoundsColor);
+                var b = bounds;
+                boundsVertices[0] = boundsVertices[4] = new(new(b.Left, b.Top), BoundsColor);
+                boundsVertices[1] = new(new(b.Right, b.Top), BoundsColor);
+                boundsVertices[2] = new(new(b.Right, b.Bottom), BoundsColor);
+                boundsVertices[3] = new(new(b.Left, b.Bottom), BoundsColor);
                 target.Draw(boundsVertices);
             }
         }

SpineViewer/Spine/Implementations/Spine/Spine40.cs

@@ -6,10 +6,11 @@ using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 using SpineRuntime40;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine.Implementations.Spine
 {
-    [SpineImplementation(Version.V40)]
+    [SpineImplementation(SpineVersion.V40)]
     internal class Spine40 : SpineViewer.Spine.Spine
     {
         private static readonly Animation EmptyAnimation = new(EMPTY_ANIMATION, [], 0);
@@ -46,7 +47,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         private SkeletonClipping clipping = new();
 
-        public Spine40(string skelPath, string? atlasPath = null) : base(skelPath, atlasPath)
+        public Spine40(string skelPath, string atlasPath) : base(skelPath, atlasPath)
         {
             atlas = new Atlas(AtlasPath, textureLoader);
             try
@@ -75,16 +76,12 @@ namespace SpineViewer.Spine.Implementations.Spine
             foreach (var skin in skeletonData.Skins)
                 skinNames.Add(skin.Name);
 
-            animationStateData = new AnimationStateData(skeletonData);
-            skeleton = new Skeleton(skeletonData);
-            animationState = new AnimationState(animationStateData);
-
             foreach (var anime in skeletonData.Animations)
                 animationNames.Add(anime.Name);
 
-            // 取最后一个作为初始, 尽可能去显示非默认的内容
-            CurrentAnimation = animationNames.Last();
-            CurrentSkin = skinNames.Last();
+            skeleton = new Skeleton(skeletonData) { Skin = new(Guid.NewGuid().ToString()) }; // 挂载一个空皮肤当作容器
+            animationStateData = new AnimationStateData(skeletonData);
+            animationState = new AnimationState(animationStateData);
         }
 
         protected override void Dispose(bool disposing)
@@ -95,7 +92,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         public override string FileVersion { get => skeletonData.Version; }
 
-        public override float Scale
+        protected override float scale
         {
             get => Math.Abs(skeleton.ScaleX);
             set
@@ -105,7 +102,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override PointF Position
+        protected override PointF position
         {
             get => new(skeleton.X, skeleton.Y);
             set
@@ -115,7 +112,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipX
+        protected override bool flipX
         {
             get => skeleton.ScaleX < 0;
             set
@@ -125,7 +122,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipY
+        protected override bool flipY
         {
             get => skeleton.ScaleY < 0;
             set
@@ -135,32 +132,38 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override string CurrentAnimation
+        protected override void addSkin(string name)
         {
-            get => animationState.GetCurrent(0)?.Animation.Name ?? EMPTY_ANIMATION;
-            set
+            if (skeletonData.FindSkin(name) is Skin sk)
             {
-                if (value == EMPTY_ANIMATION)
-                    animationState.SetAnimation(0, EmptyAnimation, false);
-                else if (animationNames.Contains(value))
-                    animationState.SetAnimation(0, value, true);
-                Update(0);
+                skeleton.Skin.AddSkin(sk);
+                skeleton.SetSlotsToSetupPose();
             }
         }
 
-        public override string CurrentSkin
+        protected override void clearSkin()
         {
-            get => skeleton.Skin?.Name ?? "default";
-            set
-            {
-                if (!skinNames.Contains(value)) return;
-                skeleton.SetSkin(value);
-                skeleton.SetToSetupPose();
-                Update(0);
-            }
+            skeleton.Skin.Clear();
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override RectangleF Bounds
+        protected override int[] getTrackIndices() => animationState.Tracks.Select((_, i) => i).Where(i => animationState.Tracks.Items[i] is not null).ToArray();
+
+        protected override string getAnimation(int track) => animationState.GetCurrent(track)?.Animation.Name ?? EMPTY_ANIMATION;
+
+        protected override void setAnimation(int track, string name)
+        {
+            if (name == EMPTY_ANIMATION)
+                animationState.SetAnimation(track, EmptyAnimation, false);
+            else if (animationNames.Contains(name))
+                animationState.SetAnimation(track, name, true);
+        }
+
+        protected override void clearTrack(int i) => animationState.ClearTrack(i);
+
+        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
+
+        protected override RectangleF bounds
         {
             get
             {
@@ -170,9 +173,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
-
-        public override void Update(float delta)
+        protected override void update(float delta)
         {
             animationState.Update(delta);
             animationState.Apply(skeleton);
@@ -184,18 +185,19 @@ namespace SpineViewer.Spine.Implementations.Spine
         {
             return spineBlendMode switch
             {
-                BlendMode.Normal => BlendModeSFML.Normal,
-                BlendMode.Additive => BlendModeSFML.Additive,
-                BlendMode.Multiply => BlendModeSFML.Multiply,
-                BlendMode.Screen => BlendModeSFML.Screen,
+                BlendMode.Normal => SFMLBlendMode.NormalPma,
+                BlendMode.Additive => SFMLBlendMode.AdditivePma,
+                BlendMode.Multiply => SFMLBlendMode.MultiplyPma,
+                BlendMode.Screen => SFMLBlendMode.ScreenPma,
                 _ => throw new NotImplementedException($"{spineBlendMode}"),
             };
         }
 
-        public override void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
+        protected override void draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
         {
             vertexArray.Clear();
             states.Texture = null;
+            states.Shader = SFMLShader.GetSpineShader(usePma);
 
             // 要用 DrawOrder 而不是 Slots
             foreach (var slot in skeleton.DrawOrder)
@@ -262,14 +264,8 @@ namespace SpineViewer.Spine.Implementations.Spine
                 {
                     if (vertexArray.VertexCount > 0)
                     {
-                        // XXX: 实测不用设置 sampler2D 的值也正确
-                        if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                            states.Shader = FragmentShader;
-                        else
-                            states.Shader = null;
-
                         // 调试纹理
-                        if (!IsDebug || DebugTexture)
+                        if (!isDebug || debugTexture)
                             target.Draw(vertexArray, states);
 
                         vertexArray.Clear();
@@ -313,23 +309,18 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
             clipping.ClipEnd();
 
-            if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                states.Shader = FragmentShader;
-            else
-                states.Shader = null;
-
             // 调试纹理
-            if (!IsDebug || DebugTexture)
+            if (!isDebug || debugTexture)
                 target.Draw(vertexArray, states);
 
             // 包围盒
-            if (IsDebug && IsSelected && DebugBounds)
+            if (isDebug && isSelected && debugBounds)
             {
-                var bounds = Bounds;
-                boundsVertices[0] = boundsVertices[4] = new(new(bounds.Left, bounds.Top), BoundsColor);
-                boundsVertices[1] = new(new(bounds.Right, bounds.Top), BoundsColor);
-                boundsVertices[2] = new(new(bounds.Right, bounds.Bottom), BoundsColor);
-                boundsVertices[3] = new(new(bounds.Left, bounds.Bottom), BoundsColor);
+                var b = bounds;
+                boundsVertices[0] = boundsVertices[4] = new(new(b.Left, b.Top), BoundsColor);
+                boundsVertices[1] = new(new(b.Right, b.Top), BoundsColor);
+                boundsVertices[2] = new(new(b.Right, b.Bottom), BoundsColor);
+                boundsVertices[3] = new(new(b.Left, b.Bottom), BoundsColor);
                 target.Draw(boundsVertices);
             }
         }

SpineViewer/Spine/Implementations/Spine/Spine41.cs

@@ -6,10 +6,11 @@ using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 using SpineRuntime41;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine.Implementations.Spine
 {
-    [SpineImplementation(Version.V41)]
+    [SpineImplementation(SpineVersion.V41)]
     internal class Spine41 : SpineViewer.Spine.Spine
     {
         private static readonly Animation EmptyAnimation = new(EMPTY_ANIMATION, [], 0);
@@ -46,7 +47,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         private SkeletonClipping clipping = new();
 
-        public Spine41(string skelPath, string? atlasPath = null) : base(skelPath, atlasPath)
+        public Spine41(string skelPath, string atlasPath) : base(skelPath, atlasPath)
         {
             atlas = new Atlas(AtlasPath, textureLoader);
             try
@@ -75,16 +76,12 @@ namespace SpineViewer.Spine.Implementations.Spine
             foreach (var skin in skeletonData.Skins)
                 skinNames.Add(skin.Name);
 
-            animationStateData = new AnimationStateData(skeletonData);
-            skeleton = new Skeleton(skeletonData);
-            animationState = new AnimationState(animationStateData);
-
             foreach (var anime in skeletonData.Animations)
                 animationNames.Add(anime.Name);
 
-            // 取最后一个作为初始, 尽可能去显示非默认的内容
-            CurrentAnimation = animationNames.Last();
-            CurrentSkin = skinNames.Last();
+            skeleton = new Skeleton(skeletonData) { Skin = new(Guid.NewGuid().ToString()) }; // 挂载一个空皮肤当作容器
+            animationStateData = new AnimationStateData(skeletonData);
+            animationState = new AnimationState(animationStateData);
         }
 
         protected override void Dispose(bool disposing)
@@ -95,7 +92,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         public override string FileVersion { get => skeletonData.Version; }
 
-        public override float Scale
+        protected override float scale
         {
             get => Math.Abs(skeleton.ScaleX);
             set
@@ -105,7 +102,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override PointF Position
+        protected override PointF position
         {
             get => new(skeleton.X, skeleton.Y);
             set
@@ -115,7 +112,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipX
+        protected override bool flipX
         {
             get => skeleton.ScaleX < 0;
             set
@@ -125,7 +122,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipY
+        protected override bool flipY
         {
             get => skeleton.ScaleY < 0;
             set
@@ -135,32 +132,38 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override string CurrentAnimation
+        protected override void addSkin(string name)
         {
-            get => animationState.GetCurrent(0)?.Animation.Name ?? EMPTY_ANIMATION;
-            set
+            if (skeletonData.FindSkin(name) is Skin sk)
             {
-                if (value == EMPTY_ANIMATION)
-                    animationState.SetAnimation(0, EmptyAnimation, false);
-                else if (animationNames.Contains(value))
-                    animationState.SetAnimation(0, value, true);
-                Update(0);
+                skeleton.Skin.AddSkin(sk);
+                skeleton.SetSlotsToSetupPose();
             }
         }
 
-        public override string CurrentSkin
+        protected override void clearSkin()
         {
-            get => skeleton.Skin?.Name ?? "default";
-            set
-            {
-                if (!skinNames.Contains(value)) return;
-                skeleton.SetSkin(value);
-                skeleton.SetToSetupPose();
-                Update(0);
-            }
+            skeleton.Skin.Clear();
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override RectangleF Bounds
+        protected override int[] getTrackIndices() => animationState.Tracks.Select((_, i) => i).Where(i => animationState.Tracks.Items[i] is not null).ToArray();
+
+        protected override string getAnimation(int track) => animationState.GetCurrent(track)?.Animation.Name ?? EMPTY_ANIMATION;
+
+        protected override void setAnimation(int track, string name)
+        {
+            if (name == EMPTY_ANIMATION)
+                animationState.SetAnimation(track, EmptyAnimation, false);
+            else if (animationNames.Contains(name))
+                animationState.SetAnimation(track, name, true);
+        }
+
+        protected override void clearTrack(int i) => animationState.ClearTrack(i);
+
+        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
+
+        protected override RectangleF bounds
         {
             get
             {
@@ -170,9 +173,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
-
-        public override void Update(float delta)
+        protected override void update(float delta)
         {
             animationState.Update(delta);
             animationState.Apply(skeleton);
@@ -184,18 +185,19 @@ namespace SpineViewer.Spine.Implementations.Spine
         {
             return spineBlendMode switch
             {
-                BlendMode.Normal => BlendModeSFML.Normal,
-                BlendMode.Additive => BlendModeSFML.Additive,
-                BlendMode.Multiply => BlendModeSFML.Multiply,
-                BlendMode.Screen => BlendModeSFML.Screen,
+                BlendMode.Normal => SFMLBlendMode.NormalPma,
+                BlendMode.Additive => SFMLBlendMode.AdditivePma,
+                BlendMode.Multiply => SFMLBlendMode.MultiplyPma,
+                BlendMode.Screen => SFMLBlendMode.ScreenPma,
                 _ => throw new NotImplementedException($"{spineBlendMode}"),
             };
         }
 
-        public override void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
+        protected override void draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
         {
             vertexArray.Clear();
             states.Texture = null;
+            states.Shader = SFMLShader.GetSpineShader(usePma);
 
             // 要用 DrawOrder 而不是 Slots
             foreach (var slot in skeleton.DrawOrder)
@@ -262,14 +264,8 @@ namespace SpineViewer.Spine.Implementations.Spine
                 {
                     if (vertexArray.VertexCount > 0)
                     {
-                        // XXX: 实测不用设置 sampler2D 的值也正确
-                        if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                            states.Shader = FragmentShader;
-                        else
-                            states.Shader = null;
-
                         // 调试纹理
-                        if (!IsDebug || DebugTexture)
+                        if (!isDebug || debugTexture)
                             target.Draw(vertexArray, states);
 
                         vertexArray.Clear();
@@ -313,23 +309,18 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
             clipping.ClipEnd();
 
-            if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                states.Shader = FragmentShader;
-            else
-                states.Shader = null;
-
             // 调试纹理
-            if (!IsDebug || DebugTexture)
+            if (!isDebug || debugTexture)
                 target.Draw(vertexArray, states);
 
             // 包围盒
-            if (IsDebug && IsSelected && DebugBounds)
+            if (isDebug && isSelected && debugBounds)
             {
-                var bounds = Bounds;
-                boundsVertices[0] = boundsVertices[4] = new(new(bounds.Left, bounds.Top), BoundsColor);
-                boundsVertices[1] = new(new(bounds.Right, bounds.Top), BoundsColor);
-                boundsVertices[2] = new(new(bounds.Right, bounds.Bottom), BoundsColor);
-                boundsVertices[3] = new(new(bounds.Left, bounds.Bottom), BoundsColor);
+                var b = bounds;
+                boundsVertices[0] = boundsVertices[4] = new(new(b.Left, b.Top), BoundsColor);
+                boundsVertices[1] = new(new(b.Right, b.Top), BoundsColor);
+                boundsVertices[2] = new(new(b.Right, b.Bottom), BoundsColor);
+                boundsVertices[3] = new(new(b.Left, b.Bottom), BoundsColor);
                 target.Draw(boundsVertices);
             }
         }

SpineViewer/Spine/Implementations/Spine/Spine42.cs

@@ -6,10 +6,11 @@ using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
 using SpineRuntime42;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine.Implementations.Spine
 {
-    [SpineImplementation(Version.V42)]
+    [SpineImplementation(SpineVersion.V42)]
     internal class Spine42 : SpineViewer.Spine.Spine
     {
         private static readonly Animation EmptyAnimation = new(EMPTY_ANIMATION, [], 0);
@@ -46,7 +47,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         private SkeletonClipping clipping = new();
 
-        public Spine42(string skelPath, string? atlasPath = null) : base(skelPath, atlasPath)
+        public Spine42(string skelPath, string atlasPath) : base(skelPath, atlasPath)
         {
             atlas = new Atlas(AtlasPath, textureLoader);
             try
@@ -75,16 +76,12 @@ namespace SpineViewer.Spine.Implementations.Spine
             foreach (var skin in skeletonData.Skins)
                 skinNames.Add(skin.Name);
 
-            animationStateData = new AnimationStateData(skeletonData);
-            skeleton = new Skeleton(skeletonData);
-            animationState = new AnimationState(animationStateData);
-
             foreach (var anime in skeletonData.Animations)
                 animationNames.Add(anime.Name);
 
-            // 取最后一个作为初始, 尽可能去显示非默认的内容
-            CurrentAnimation = animationNames.Last();
-            CurrentSkin = skinNames.Last();
+            skeleton = new Skeleton(skeletonData) { Skin = new(Guid.NewGuid().ToString()) }; // 挂载一个空皮肤当作容器
+            animationStateData = new AnimationStateData(skeletonData);
+            animationState = new AnimationState(animationStateData);
         }
 
         protected override void Dispose(bool disposing)
@@ -95,7 +92,7 @@ namespace SpineViewer.Spine.Implementations.Spine
 
         public override string FileVersion { get => skeletonData.Version; }
 
-        public override float Scale
+        protected override float scale
         {
             get => Math.Abs(skeleton.ScaleX);
             set
@@ -105,7 +102,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override PointF Position
+        protected override PointF position
         {
             get => new(skeleton.X, skeleton.Y);
             set
@@ -115,7 +112,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipX
+        protected override bool flipX
         {
             get => skeleton.ScaleX < 0;
             set
@@ -125,7 +122,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override bool FlipY
+        protected override bool flipY
         {
             get => skeleton.ScaleY < 0;
             set
@@ -135,32 +132,38 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override string CurrentAnimation
+        protected override void addSkin(string name)
         {
-            get => animationState.GetCurrent(0)?.Animation.Name ?? EMPTY_ANIMATION;
-            set
+            if (skeletonData.FindSkin(name) is Skin sk)
             {
-                if (value == EMPTY_ANIMATION)
-                    animationState.SetAnimation(0, EmptyAnimation, false);
-                else if (animationNames.Contains(value))
-                    animationState.SetAnimation(0, value, true);
-                Update(0);
+                skeleton.Skin.AddSkin(sk);
+                skeleton.SetSlotsToSetupPose();
             }
         }
 
-        public override string CurrentSkin
+        protected override void clearSkin()
         {
-            get => skeleton.Skin?.Name ?? "default";
-            set
-            {
-                if (!skinNames.Contains(value)) return;
-                skeleton.SetSkin(value);
-                skeleton.SetToSetupPose();
-                Update(0);
-            }
+            skeleton.Skin.Clear();
+            skeleton.SetSlotsToSetupPose();
         }
 
-        public override RectangleF Bounds
+        protected override int[] getTrackIndices() => animationState.Tracks.Select((_, i) => i).Where(i => animationState.Tracks.Items[i] is not null).ToArray();
+
+        protected override string getAnimation(int track) => animationState.GetCurrent(track)?.Animation.Name ?? EMPTY_ANIMATION;
+
+        protected override void setAnimation(int track, string name)
+        {
+            if (name == EMPTY_ANIMATION)
+                animationState.SetAnimation(track, EmptyAnimation, false);
+            else if (animationNames.Contains(name))
+                animationState.SetAnimation(track, name, true);
+        }
+
+        protected override void clearTrack(int i) => animationState.ClearTrack(i);
+
+        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
+
+        protected override RectangleF bounds
         {
             get
             {
@@ -170,9 +173,7 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
         }
 
-        public override float GetAnimationDuration(string name) { return skeletonData.FindAnimation(name)?.Duration ?? 0f; }
-
-        public override void Update(float delta)
+        protected override void update(float delta)
         {
             animationState.Update(delta);
             animationState.Apply(skeleton);
@@ -184,18 +185,19 @@ namespace SpineViewer.Spine.Implementations.Spine
         {
             return spineBlendMode switch
             {
-                BlendMode.Normal => BlendModeSFML.Normal,
-                BlendMode.Additive => BlendModeSFML.Additive,
-                BlendMode.Multiply => BlendModeSFML.Multiply,
-                BlendMode.Screen => BlendModeSFML.Screen,
+                BlendMode.Normal => SFMLBlendMode.NormalPma,
+                BlendMode.Additive => SFMLBlendMode.AdditivePma,
+                BlendMode.Multiply => SFMLBlendMode.MultiplyPma,
+                BlendMode.Screen => SFMLBlendMode.ScreenPma,
                 _ => throw new NotImplementedException($"{spineBlendMode}"),
             };
         }
 
-        public override void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
+        protected override void draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states)
         {
             vertexArray.Clear();
             states.Texture = null;
+            states.Shader = SFMLShader.GetSpineShader(usePma);
 
             // 要用 DrawOrder 而不是 Slots
             foreach (var slot in skeleton.DrawOrder)
@@ -262,14 +264,8 @@ namespace SpineViewer.Spine.Implementations.Spine
                 {
                     if (vertexArray.VertexCount > 0)
                     {
-                        // XXX: 实测不用设置 sampler2D 的值也正确
-                        if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                            states.Shader = FragmentShader;
-                        else
-                            states.Shader = null;
-
                         // 调试纹理
-                        if (!IsDebug || DebugTexture)
+                        if (!isDebug || debugTexture)
                             target.Draw(vertexArray, states);
 
                         vertexArray.Clear();
@@ -313,23 +309,18 @@ namespace SpineViewer.Spine.Implementations.Spine
             }
             clipping.ClipEnd();
 
-            if (UsePremultipliedAlpha && (states.BlendMode == BlendModeSFML.Normal || states.BlendMode == BlendModeSFML.Additive))
-                states.Shader = FragmentShader;
-            else
-                states.Shader = null;
-
             // 调试纹理
-            if (!IsDebug || DebugTexture)
+            if (!isDebug || debugTexture)
                 target.Draw(vertexArray, states);
 
             // 包围盒
-            if (IsDebug && IsSelected && DebugBounds)
+            if (isDebug && isSelected && debugBounds)
             {
-                var bounds = Bounds;
-                boundsVertices[0] = boundsVertices[4] = new(new(bounds.Left, bounds.Top), BoundsColor);
-                boundsVertices[1] = new(new(bounds.Right, bounds.Top), BoundsColor);
-                boundsVertices[2] = new(new(bounds.Right, bounds.Bottom), BoundsColor);
-                boundsVertices[3] = new(new(bounds.Left, bounds.Bottom), BoundsColor);
+                var b = bounds;
+                boundsVertices[0] = boundsVertices[4] = new(new(b.Left, b.Top), BoundsColor);
+                boundsVertices[1] = new(new(b.Right, b.Top), BoundsColor);
+                boundsVertices[2] = new(new(b.Right, b.Bottom), BoundsColor);
+                boundsVertices[3] = new(new(b.Left, b.Bottom), BoundsColor);
                 target.Draw(boundsVertices);
             }
         }

SpineViewer/Spine/SkeletonConverter.cs

@@ -9,52 +9,19 @@ using System.Text;
 using System.Text.Json;
 using System.Text.Json.Nodes;
 using System.Text.Encodings.Web;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine
 {
     /// <summary>
     /// SkeletonConverter 基类, 使用静态方法 New 来创建具体版本对象
     /// </summary>
-    public abstract class SkeletonConverter
+    public abstract class SkeletonConverter : ImplementationResolver<SkeletonConverter, SpineImplementationAttribute, SpineVersion>
     {
-        /// <summary>
-        /// 实现类缓存
-        /// </summary>
-        private static readonly Dictionary<Version, Type> ImplementationTypes = [];
-        public static readonly Dictionary<Version, Type>.KeyCollection ImplementedVersions;
-
-        /// <summary>
-        /// 静态构造函数
-        /// </summary>
-        static SkeletonConverter()
-        {
-            // 遍历并缓存标记了 SpineImplementationAttribute 的类型
-            var impTypes = Assembly.GetExecutingAssembly().GetTypes().Where(t => typeof(SkeletonConverter).IsAssignableFrom(t) && !t.IsAbstract);
-            foreach (var type in impTypes)
-            {
-                var attr = type.GetCustomAttribute<SpineImplementationAttribute>();
-                if (attr is not null)
-                {
-                    if (ImplementationTypes.ContainsKey(attr.Version))
-                        throw new InvalidOperationException($"Multiple implementations found: {attr.Version}");
-                    ImplementationTypes[attr.Version] = type;
-                }
-            }
-            Program.Logger.Debug("Find SkeletonConverter implementations: [{}]", string.Join(", ", ImplementationTypes.Keys));
-            ImplementedVersions = ImplementationTypes.Keys;
-        }
-
         /// <summary>
         /// 创建特定版本的 SkeletonConverter
         /// </summary>
-        public static SkeletonConverter New(Version version)
-        {
-            if (!ImplementationTypes.TryGetValue(version, out var cvterType))
-            {
-                throw new NotImplementedException($"Not implemented version: {version}");
-            }
-            return (SkeletonConverter)Activator.CreateInstance(cvterType);
-        }
+        public static SkeletonConverter New(SpineVersion version) => New(version, []);
 
         /// <summary>
         /// Json 格式控制
@@ -123,7 +90,7 @@ namespace SpineViewer.Spine
         /// <summary>
         /// 转换到目标版本
         /// </summary>
-        public abstract JsonObject ToVersion(JsonObject root, Version version);
+        public abstract JsonObject ToVersion(JsonObject root, SpineVersion version);
 
         /// <summary>
         /// 二进制骨骼文件读

SpineViewer/Spine/Spine.cs

@@ -1,459 +1,378 @@
 using System;
-using System.Collections.Generic;
-using System.IO;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-using System.Text.RegularExpressions;
-using System.Numerics;
-using System.Collections;
 using System.Collections.ObjectModel;
-using System.ComponentModel;
 using System.Reflection;
-using System.Diagnostics.CodeAnalysis;
-using System.Globalization;
-using System.Text.Json.Nodes;
-using System.Collections.Immutable;
-using SpineViewer.Exporter;
+using System.Drawing.Design;
+using NLog;
+using System.Xml.Linq;
+using SpineViewer.Extensions;
+using SpineViewer.Utilities;
 
 namespace SpineViewer.Spine
 {
     /// <summary>
-    /// Spine 基类, 使用静态方法 New 来创建具体版本对象
+    /// Spine 基类, 使用静态方法 New 来创建具体版本对象, 该类是线程安全的
     /// </summary>
-    public abstract class Spine : SFML.Graphics.Drawable, IDisposable
+    public abstract class Spine : ImplementationResolver<Spine, SpineImplementationAttribute, SpineVersion>, SFML.Graphics.Drawable, IDisposable
     {
-        /// <summary>
-        /// 常规骨骼文件后缀集合
-        /// </summary>
-        public static readonly ImmutableHashSet<string> CommonSkelSuffix = [".skel", ".json"];
-
         /// <summary>
         /// 空动画标记
         /// </summary>
-        public const string EMPTY_ANIMATION = "<Empty>";
+        protected const string EMPTY_ANIMATION = "<Empty>";
 
         /// <summary>
         /// 预览图宽
         /// </summary>
-        public const uint PREVIEW_WIDTH = 256;
+        protected const uint PREVIEW_WIDTH = 256;
 
         /// <summary>
         /// 预览图高
         /// </summary>
-        public const uint PREVIEW_HEIGHT = 256;
-
-        /// <summary>
-        /// 缩放最小值
-        /// </summary>
-        public const float SCALE_MIN = 0.001f;
-
-        /// <summary>
-        /// 实现类缓存
-        /// </summary>
-        private static readonly Dictionary<Version, Type> ImplementationTypes = [];
-        public static readonly Dictionary<Version, Type>.KeyCollection ImplementedVersions;
-
-        /// <summary>
-        /// 用于解决 PMA 和渐变动画问题的片段着色器
-        /// </summary>
-        private const string FRAGMENT_SHADER = (
-            "uniform sampler2D t;" +
-            "void main() { vec4 p = texture2D(t, gl_TexCoord[0].xy);" +
-            "if (p.a > 0) p.rgb /= max(max(max(p.r, p.g), p.b), p.a);" +
-            "gl_FragColor = gl_Color * p; }"
-        );
-
-        /// <summary>
-        /// 用于解决 PMA 和渐变动画问题的片段着色器
-        /// </summary>
-        protected static readonly SFML.Graphics.Shader? FragmentShader = null;
-
-        /// <summary>
-        /// 静态构造函数
-        /// </summary>
-        static Spine()
-        {
-            // 遍历并缓存标记了 SpineImplementationAttribute 的类型
-            var impTypes = Assembly.GetExecutingAssembly().GetTypes().Where(t => typeof(Spine).IsAssignableFrom(t) && !t.IsAbstract);
-            foreach (var type in impTypes)
-            {
-                var attr = type.GetCustomAttribute<SpineImplementationAttribute>();
-                if (attr is not null)
-                {
-                    if (ImplementationTypes.ContainsKey(attr.Version))
-                        throw new InvalidOperationException($"Multiple implementations found: {attr.Version}");
-                    ImplementationTypes[attr.Version] = type;
-                }
-            }
-            Program.Logger.Debug("Find Spine implementations: [{}]", string.Join(", ", ImplementationTypes.Keys));
-            ImplementedVersions = ImplementationTypes.Keys;
-
-            // 加载 FragmentShader
-            try
-            {
-                FragmentShader = SFML.Graphics.Shader.FromString(null, null, FRAGMENT_SHADER);
-            }
-            catch (Exception ex)
-            {
-                FragmentShader = null;
-                Program.Logger.Error(ex.ToString());
-                Program.Logger.Error("Failed to load fragment shader");
-                MessageBox.Warn("Fragment shader 加载失败，预乘Alpha通道属性失效");
-            }
-        }
-
-        /// <summary>
-        /// 尝试检测骨骼文件版本
-        /// </summary>
-        public static Version? GetVersion(string skelPath)
-        {
-            string versionString = null;
-            Version? version = null;
-            using var input = File.OpenRead(skelPath);
-            var reader = new SkeletonConverter.BinaryReader(input);
-
-            // try json format
-            try
-            {
-                if (JsonNode.Parse(input) is JsonObject root && root.TryGetPropertyValue("skeleton", out var node) &&
-                    node is JsonObject _skeleton && _skeleton.TryGetPropertyValue("spine", out var _version))
-                    versionString = (string)_version;
-            }
-            catch { }
-
-            // try v4 binary format
-            if (versionString is null)
-            {
-                try
-                {
-                    input.Position = 0;
-                    var hash = reader.ReadLong();
-                    var versionPosition = input.Position;
-                    var versionByteCount = reader.ReadVarInt();
-                    input.Position = versionPosition;
-                    if (versionByteCount <= 13)
-                        versionString = reader.ReadString();
-                }
-                catch { }
-            }
-
-            // try v3 binary format
-            if (versionString is null)
-            {
-                try
-                {
-                    input.Position = 0;
-                    var hash = reader.ReadString();
-                    versionString = reader.ReadString();
-                }
-                catch { }
-            }
-
-            if (versionString is not null)
-            {
-                if (versionString.StartsWith("2.1.")) version = Version.V21;
-                else if (versionString.StartsWith("3.6.")) version = Version.V36;
-                else if (versionString.StartsWith("3.7.")) version = Version.V37;
-                else if (versionString.StartsWith("3.8.")) version = Version.V38;
-                else if (versionString.StartsWith("4.0.")) version = Version.V40;
-                else if (versionString.StartsWith("4.1.")) version = Version.V41;
-                else if (versionString.StartsWith("4.2.")) version = Version.V42;
-                else if (versionString.StartsWith("4.3.")) version = Version.V43;
-                else Program.Logger.Error("Unknown verison: {}, {}", versionString, skelPath);
-            }
-
-            return version;
-        }
+        protected const uint PREVIEW_HEIGHT = 256;
 
         /// <summary>
         /// 创建特定版本的 Spine
         /// </summary>
-        public static Spine New(Version version, string skelPath, string? atlasPath = null)
+        public static Spine New(SpineVersion version, string skelPath, string? atlasPath = null)
         {
-            if (version == Version.Auto)
-            {
-                if (GetVersion(skelPath) is Version detectedVersion)
-                    version = detectedVersion;
-                else
-                    throw new InvalidDataException($"Auto version detection failed for {skelPath}, try to use a specific version");
-            }
-            if (!ImplementationTypes.TryGetValue(version, out var spineType))
-            {
-                throw new NotImplementedException($"Not implemented version: {version}");
-            }
-            return (Spine)Activator.CreateInstance(spineType, skelPath, atlasPath);
+            atlasPath ??= Path.ChangeExtension(skelPath, ".atlas");
+            skelPath = Path.GetFullPath(skelPath);
+            atlasPath = Path.GetFullPath(atlasPath);
+            
+            if (version == SpineVersion.Auto) version = SpineHelper.GetVersion(skelPath);
+            if (!File.Exists(atlasPath)) throw new FileNotFoundException($"atlas file {atlasPath} not found");
+            return New(version, [skelPath, atlasPath]).PostInit();
         }
 
+        /// <summary>
+        /// 数据锁
+        /// </summary>
+        private readonly object _lock = new();
+
+        private readonly Logger logger = LogManager.GetCurrentClassLogger();
+        private bool skinLoggerWarned = false;
+
         /// <summary>
         /// 构造函数
         /// </summary>
-        public Spine(string skelPath, string? atlasPath = null)
+        public Spine(string skelPath, string atlasPath)
         {
-            // 获取子类类型
-            var type = GetType();
-            var attr = type.GetCustomAttribute<SpineImplementationAttribute>();
-            if (attr is null)
-            {
-                throw new InvalidOperationException($"Class {type.Name} has no SpineImplementationAttribute");
-            }
-
-            atlasPath ??= Path.ChangeExtension(skelPath, ".atlas");
-
-            // 设置 Version
-            Version = attr.Version;
+            Version = GetType().GetCustomAttribute<SpineImplementationAttribute>().ImplementationKey;
             AssetsDir = Directory.GetParent(skelPath).FullName;
             SkelPath = Path.GetFullPath(skelPath);
             AtlasPath = Path.GetFullPath(atlasPath);
             Name = Path.GetFileNameWithoutExtension(skelPath);
         }
 
+        /// <summary>
+        /// 构造函数之后的初始化工作
+        /// </summary>
+        private Spine PostInit()
+        {
+            SkinNames = skinNames.AsReadOnly();
+            AnimationNames = animationNames.AsReadOnly();
+
+            // 必须 Update 一次否则包围盒还没有值
+            update(0);
+
+            // XXX: tex 没办法在这里主动 Dispose
+            // 批量添加在获取预览图的时候极大概率会和预览线程死锁
+            // 虽然两边不会同时调用 Draw, 但是死锁似乎和 Draw 函数有关
+            // 除此之外, 似乎还和 tex 的 Dispose 有关
+            // 如果不对 tex 进行 Dispose, 那么不管是否 Draw 都正常不会死锁
+            var tex = new SFML.Graphics.RenderTexture(PREVIEW_WIDTH, PREVIEW_HEIGHT);
+            using var view = bounds.GetView(PREVIEW_WIDTH, PREVIEW_HEIGHT);
+            tex.SetView(view);
+            tex.Clear(SFML.Graphics.Color.Transparent);
+            tex.Draw(this);
+            tex.Display();
+            Preview = tex.Texture.CopyToBitmap();
+
+            // 默认初始化10个空位
+            for (int i = 0; i < 10; i++)
+            {
+                setAnimation(i, AnimationNames.First());
+                loadedSkins.Add(SkinNames.First());
+            }
+            reloadSkins();
+
+            return this;
+        }
+
         ~Spine() { Dispose(false); }
         public void Dispose() { Dispose(true); GC.SuppressFinalize(this); }
-        protected virtual void Dispose(bool disposing) { preview?.Dispose(); }
+        protected virtual void Dispose(bool disposing) { Preview?.Dispose(); }
 
-        #region 属性 | [0] 基本信息
+        /// <summary>
+        /// 运行时唯一 ID
+        /// </summary>
+        public string ID { get; } = Guid.NewGuid().ToString();
+
+        /// <summary>
+        /// 骨骼预览图, 并没有去除预乘, 画面可能偏暗
+        /// </summary>
+        public Image Preview { get; private set; }
 
         /// <summary>
         /// 获取所属版本
         /// </summary>
-        [TypeConverter(typeof(VersionConverter))]
-        [Category("[0] 基本信息"), DisplayName("运行时版本")]
-        public Version Version { get; }
+        public SpineVersion Version { get; }
 
         /// <summary>
         /// 资源所在完整目录
         /// </summary>
-        [Category("[0] 基本信息"), DisplayName("资源目录")]
         public string AssetsDir { get; }
 
         /// <summary>
         /// skel 文件完整路径
         /// </summary>
-        [Category("[0] 基本信息"), DisplayName("skel文件路径")]
         public string SkelPath { get; }
 
         /// <summary>
         /// atlas 文件完整路径
         /// </summary>
-        [Category("[0] 基本信息"), DisplayName("atlas文件路径")]
         public string AtlasPath { get; }
 
         /// <summary>
         /// 名称
         /// </summary>
-        [Category("[0] 基本信息"), DisplayName("名称")]
         public string Name { get; }
 
         /// <summary>
         /// 获取所属文件版本
         /// </summary>
-        [Category("[0] 基本信息"), DisplayName("文件版本")]
         public abstract string FileVersion { get; }
 
-        #endregion
-
-        #region 属性 | [1] 设置
-
         /// <summary>
         /// 是否被隐藏, 被隐藏的模型将仅仅在列表显示, 不参与其他行为
         /// </summary>
-        [Category("[1] 设置"), DisplayName("是否隐藏")]
-        public bool IsHidden { get; set; } = false;
+        public bool IsHidden { get { lock (_lock) return isHidden; } set { lock (_lock) isHidden = value; } }
+        protected bool isHidden = false;
 
         /// <summary>
-        /// 是否使用预乘Alpha
+        /// 是否使用预乘 Alpha
         /// </summary>
-        [Category("[1] 设置"), DisplayName("预乘Alpha通道")]
-        public bool UsePremultipliedAlpha { get; set; } = true;
-
-        #endregion
-
-        #region 属性 | [2] 变换
-
-        /// <summary>
-        /// 缩放比例
-        /// </summary>
-        [Category("[2] 变换"), DisplayName("缩放比例")]
-        public abstract float Scale { get; set; }
-
-        /// <summary>
-        /// 位置
-        /// </summary>
-        [TypeConverter(typeof(PointFConverter))]
-        [Category("[2] 变换"), DisplayName("位置")]
-        public abstract PointF Position { get; set; }
-
-        /// <summary>
-        /// 水平翻转
-        /// </summary>
-        [Category("[2] 变换"), DisplayName("水平翻转")]
-        public abstract bool FlipX { get; set; }
-
-        /// <summary>
-        /// 垂直翻转
-        /// </summary>
-        [Category("[2] 变换"), DisplayName("垂直翻转")]
-        public abstract bool FlipY { get; set; }
-
-        #endregion
-
-        #region 属性 | [3] 动画
-
-        /// <summary>
-        /// 包含的所有动画名称
-        /// </summary>
-        [Browsable(false)]
-        public ReadOnlyCollection<string> AnimationNames { get => animationNames.AsReadOnly(); }
-        protected List<string> animationNames = [EMPTY_ANIMATION];
-
-        /// <summary>
-        /// 当前动画名称, 如果设置的动画不存在则忽略
-        /// </summary>
-        [TypeConverter(typeof(AnimationConverter))]
-        [Category("[3] 动画"), DisplayName("当前动画")]
-        public abstract string CurrentAnimation { get; set; }
-
-        /// <summary>
-        /// 当前动画时长
-        /// </summary>
-        [Category("[3] 动画"), DisplayName("当前动画时长")]
-        public float CurrentAnimationDuration { get => GetAnimationDuration(CurrentAnimation); }
-
-        /// <summary>
-        /// 包含的所有皮肤名称
-        /// </summary>
-        [Browsable(false)]
-        public ReadOnlyCollection<string> SkinNames { get => skinNames.AsReadOnly(); }
-        protected List<string> skinNames = [];
-
-        /// <summary>
-        /// 当前皮肤名称, 如果设置的皮肤不存在则忽略
-        /// </summary>
-        [TypeConverter(typeof(SkinConverter))]
-        [Category("[3] 动画"), DisplayName("当前皮肤")]
-        public abstract string CurrentSkin { get; set; }
-
-        #endregion
-
-        #region 属性 | [4] 调试
-
-        /// <summary>
-        /// 显示调试
-        /// </summary>
-        [Browsable(false)]
-        public bool IsDebug { get; set; } = false;
-
-        /// <summary>
-        /// 包围盒颜色
-        /// </summary>
-        protected static readonly SFML.Graphics.Color BoundsColor = new(120, 200, 0);
-
-        /// <summary>
-        /// 包围盒顶点数组
-        /// </summary>
-        protected readonly SFML.Graphics.VertexArray boundsVertices = new(SFML.Graphics.PrimitiveType.LineStrip, 5);
-
-        /// <summary>
-        /// 显示纹理
-        /// </summary>
-        [Category("[4] 调试"), DisplayName("显示纹理")]
-        public bool DebugTexture { get; set; } = true;
-
-        /// <summary>
-        /// 显示包围盒
-        /// </summary>
-        [Category("[4] 调试"), DisplayName("显示包围盒")]
-        public bool DebugBounds { get; set; } = true;
-
-        /// <summary>
-        /// 显示骨骼
-        /// </summary>
-        [Category("[4] 调试"), DisplayName("显示骨骼")]
-        public bool DebugBones { get; set; } = false;
-
-        #endregion
-
-        /// <summary>
-        /// 标识符
-        /// </summary>
-        public readonly string ID = Guid.NewGuid().ToString();
-
-        /// <summary>
-        /// 是否被选中
-        /// </summary>
-        [Browsable(false)]
-        public bool IsSelected { get; set; } = false;
+        public bool UsePma { get { lock (_lock) return usePma; } set { lock (_lock) usePma = value; } }
+        protected bool usePma = false;
 
         /// <summary>
         /// 骨骼包围盒
         /// </summary>
-        [Browsable(false)]
-        public abstract RectangleF Bounds { get; }
+        public RectangleF Bounds { get { lock (_lock) return bounds; } }
+        protected abstract RectangleF bounds { get; }
 
         /// <summary>
-        /// 初始状态下的骨骼包围盒
+        /// 缩放比例
         /// </summary>
-        [Browsable(false)]
-        public RectangleF InitBounds
+        public float Scale
         {
-            get
-            {
-                if (initBounds is null)
-                {
-                    var tmp = CurrentAnimation;
-                    CurrentAnimation = EMPTY_ANIMATION;
-                    initBounds = Bounds;
-                    CurrentAnimation = tmp;
-                }
-                return (RectangleF)initBounds;
-            }
+            get { lock (_lock) return scale; }
+            set { lock (_lock) { scale = Math.Max(value, 0.001f); update(0); } }
         }
-        private RectangleF? initBounds = null;
+        protected abstract float scale { get; set; }
 
         /// <summary>
-        /// 骨骼预览图
+        /// 位置
         /// </summary>
-        [Browsable(false)]
-        public Image Preview
+        public PointF Position
         {
-            get
-            {
-                if (preview is null)
-                {
-                    // XXX: tex 没办法在这里主动 Dispose
-                    // 批量添加在获取预览图的时候极大概率会和预览线程死锁
-                    // 虽然两边不会同时调用 Draw, 但是死锁似乎和 Draw 函数有关
-                    // 除此之外, 似乎还和 tex 的 Dispose 有关
-                    // 如果不对 tex 进行 Dispose, 那么不管是否 Draw 都正常不会死锁
-                    var tex = new SFML.Graphics.RenderTexture(PREVIEW_WIDTH, PREVIEW_HEIGHT);
-                    tex.SetView(InitBounds.GetView(PREVIEW_WIDTH, PREVIEW_HEIGHT));
-                    tex.Clear(SFML.Graphics.Color.Transparent);
-                    var tmp = CurrentAnimation;
-                    CurrentAnimation = EMPTY_ANIMATION;
-                    tex.Draw(this);
-                    CurrentAnimation = tmp;
-                    tex.Display();
+            get { lock (_lock) return position; }
+            set { lock (_lock) { position = value; update(0); } }
+        }
+        protected abstract PointF position { get; set; }
 
-                    using var img = tex.Texture.CopyToImage();
-                    img.SaveToMemory(out var imgBuffer, "bmp");
-                    using var stream = new MemoryStream(imgBuffer);
-                    preview = new Bitmap(new Bitmap(stream)); // 必须重复构造一个副本才能摆脱对流的依赖, 否则之后使用会报错
+        /// <summary>
+        /// 水平翻转
+        /// </summary>
+        public bool FlipX
+        {
+            get { lock (_lock) return flipX; }
+            set { lock (_lock) { flipX = value; update(0); } }
+        }
+        protected abstract bool flipX { get; set; }
+
+        /// <summary>
+        /// 垂直翻转
+        /// </summary>
+        public bool FlipY
+        {
+            get { lock (_lock) return flipY; }
+            set { lock (_lock) { flipY = value; update(0); } }
+        }
+        protected abstract bool flipY { get; set; }
+
+        /// <summary>
+        /// 包含的所有皮肤名称
+        /// </summary>
+        public ReadOnlyCollection<string> SkinNames { get; private set; }
+        protected readonly List<string> skinNames = [];
+
+        /// <summary>
+        /// 包含的所有动画名称
+        /// </summary>
+        public ReadOnlyCollection<string> AnimationNames { get; private set; }
+        protected readonly List<string> animationNames = [EMPTY_ANIMATION];
+
+        /// <summary>
+        /// 是否被选中
+        /// </summary>
+        public bool IsSelected
+        {
+            get { lock (_lock) return isSelected; }
+            set { lock (_lock) { isSelected = value; update(0); } }
+        }
+        protected bool isSelected = false;
+
+        /// <summary>
+        /// 显示调试
+        /// </summary>
+        public bool IsDebug
+        {
+            get { lock (_lock) return isDebug; }
+            set { lock (_lock) { isDebug = value; update(0); } }
+        }
+        protected bool isDebug = false;
+
+        /// <summary>
+        /// 显示纹理
+        /// </summary>
+        public bool DebugTexture
+        {
+            get { lock (_lock) return debugTexture; }
+            set { lock (_lock) { debugTexture = value; update(0); } }
+        }
+        protected bool debugTexture = true;
+
+        /// <summary>
+        /// 显示包围盒
+        /// </summary>
+        public bool DebugBounds
+        {
+            get { lock (_lock) return debugBounds; }
+            set { lock (_lock) { debugBounds = value; update(0); } }
+        }
+        protected bool debugBounds = true;
+
+        /// <summary>
+        /// 显示骨骼
+        /// </summary>
+        public bool DebugBones
+        {
+            get { lock (_lock) return debugBones; }
+            set { lock (_lock) { debugBones = value; update(0); } }
+        }
+        protected bool debugBones = false;
+
+        /// <summary>
+        /// 获取已加载的皮肤列表快照, 允许出现重复值
+        /// </summary>
+        public string[] GetLoadedSkins() { lock (_lock) return loadedSkins.ToArray(); }
+        protected readonly List<string> loadedSkins = [];
+
+        /// <summary>
+        /// 加载指定皮肤, 添加至列表末尾, 如果不存在则忽略, 允许加载重复的值
+        /// </summary>
+        public void LoadSkin(string name)
+        {
+            if (!skinNames.Contains(name)) return;
+            lock (_lock)
+            {
+                loadedSkins.Add(name);
+                reloadSkins();
+
+                if (!skinLoggerWarned && Version <= SpineVersion.V37 && loadedSkins.Count > 1)
+                {
+                    logger.Warn($"Multiplt skins not supported in SpineVersion {Version.GetName()}");
+                    skinLoggerWarned = true;
                 }
-                return preview;
             }
         }
-        private Image preview = null;
+
+        /// <summary>
+        /// 卸载列表指定位置皮肤, 如果超出范围则忽略
+        /// </summary>
+        public void UnloadSkin(int idx)
+        {
+            if (idx < 0 || idx >= loadedSkins.Count) return;
+            lock (_lock)
+            {
+                loadedSkins.RemoveAt(idx);
+                reloadSkins();
+            }
+        }
+
+        /// <summary>
+        /// 替换皮肤列表指定位置皮肤, 超出范围或者皮肤不存在则忽略
+        /// </summary>
+        public void ReplaceSkin(int idx, string name)
+        {
+            if (idx < 0 || idx >= loadedSkins.Count || !skinNames.Contains(name)) return;
+            lock (_lock)
+            {
+                loadedSkins[idx] = name;
+                reloadSkins();
+            }
+        }
+
+        /// <summary>
+        /// 重新加载现有皮肤列表, 用于刷新等操作
+        /// </summary>
+        public void ReloadSkins() { lock (_lock) reloadSkins(); }
+        private void reloadSkins()
+        {
+            clearSkin();
+            foreach (var s in loadedSkins.Distinct()) addSkin(s);
+            update(0);
+        }
+
+        /// <summary>
+        /// 加载皮肤, 如果不存在则忽略
+        /// </summary>
+        protected abstract void addSkin(string name);
+
+        /// <summary>
+        /// 清空加载的所有皮肤
+        /// </summary>
+        protected abstract void clearSkin();
+
+        /// <summary>
+        /// 获取所有非 null 的轨道索引快照
+        /// </summary>
+        public int[] GetTrackIndices() { lock (_lock) return getTrackIndices(); }
+        protected abstract int[] getTrackIndices();
+
+        /// <summary>
+        /// 获取指定轨道的当前动画, 如果没有, 应当返回空动画名称
+        /// </summary>
+        public string GetAnimation(int track) { lock (_lock) return getAnimation(track); }
+        protected abstract string getAnimation(int track);
+
+        /// <summary>
+        /// 设置某个轨道动画
+        /// </summary>
+        public void SetAnimation(int track, string name) { lock (_lock) { setAnimation(track, name); update(0); } }
+        protected abstract void setAnimation(int track, string name);
+
+        /// <summary>
+        /// 清除某个轨道, 与设置空动画不同, 是彻底删除轨道内的东西
+        /// </summary>
+        public void ClearTrack(int i) { lock (_lock) { clearTrack(i); update(0); } }
+        protected abstract void clearTrack(int i); // XXX: 清除轨道之后被加载的附件还是会保留, 不会自动卸下, 除非使用 SetSlotsToSetupPose
 
         /// <summary>
         /// 获取动画时长, 如果动画不存在则返回 0
         /// </summary>
         public abstract float GetAnimationDuration(string name);
 
+        /// <summary>
+        /// 重置所有轨道上的动画时间
+        /// </summary>
+        public void ResetAnimationsTime() { lock (_lock) { foreach (var i in getTrackIndices()) setAnimation(i, getAnimation(i)); update(0); } }
+
         /// <summary>
         /// 更新内部状态
         /// </summary>
-        public abstract void Update(float delta);
+        public void Update(float delta) { lock (_lock) update(delta); }
+        protected abstract void update(float delta);
 
         #region SFML.Graphics.Drawable 接口实现
 
@@ -468,10 +387,28 @@ namespace SpineViewer.Spine
         protected readonly SFML.Graphics.VertexArray vertexArray = new(SFML.Graphics.PrimitiveType.Triangles);
 
         /// <summary>
-        /// SFML.Graphics.Drawable 接口实现
+        /// 包围盒颜色
         /// </summary>
-        public abstract void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states);
+        protected static readonly SFML.Graphics.Color BoundsColor = new(120, 200, 0);
+
+        /// <summary>
+        /// 包围盒顶点数组
+        /// </summary>
+        protected readonly SFML.Graphics.VertexArray boundsVertices = new(SFML.Graphics.PrimitiveType.LineStrip, 5);
+
+        /// <summary>
+        /// SFML.Graphics.Drawable 接口实现
+        /// <para>这个渲染实现绘制出来的像素将是预乘的, 当渲染的背景透明度是 1 时, 则等价于非预乘的结果, 即正常画面, 否则画面偏暗</para>
+        /// <para>可以用于 <see cref="SFML.Graphics.RenderWindow"/> 的渲染, 因为直接在窗口上绘制时窗口始终是不透明的</para>
+        /// </summary>
+        public void Draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states) { lock (_lock) draw(target, states); }
+
+        /// <summary>
+        /// 这个渲染实现绘制出来的像素将是预乘的, 当渲染的背景透明度是 1 时, 则等价于非预乘的结果, 即正常画面, 否则画面偏暗
+        /// <para>可以用于 <see cref="SFML.Graphics.RenderWindow"/> 的渲染, 因为直接在窗口上绘制时窗口始终是不透明的</para>
+        /// </summary>
+        protected abstract void draw(SFML.Graphics.RenderTarget target, SFML.Graphics.RenderStates states);
 
         #endregion
     }
-}
+}

SpineViewer/Spine/SpineHelper.cs

@@ -0,0 +1,160 @@
+using SpineViewer.Utilities;
+using System;
+using System.Collections.Generic;
+using System.Collections.Immutable;
+using System.Collections.ObjectModel;
+using System.ComponentModel;
+using System.Linq;
+using System.Reflection;
+using System.Text;
+using System.Text.Json.Nodes;
+using System.Threading.Tasks;
+
+namespace SpineViewer.Spine
+{
+    /// <summary>
+    /// 支持的 Spine 版本
+    /// </summary>
+    public enum SpineVersion
+    {
+        [Description("<Auto>")] Auto = 0x0000,
+        [Description("2.1.x")] V21 = 0x0201,
+        [Description("3.6.x")] V36 = 0x0306,
+        [Description("3.7.x")] V37 = 0x0307,
+        [Description("3.8.x")] V38 = 0x0308,
+        [Description("4.0.x")] V40 = 0x0400,
+        [Description("4.1.x")] V41 = 0x0401,
+        [Description("4.2.x")] V42 = 0x0402,
+        [Description("4.3.x")] V43 = 0x0403,
+    }
+
+    /// <summary>
+    /// Spine 实现类标记
+    /// </summary>
+    [AttributeUsage(AttributeTargets.Class, AllowMultiple = false, Inherited = false)]
+    public class SpineImplementationAttribute(SpineVersion version) : Attribute, IImplementationKey<SpineVersion>
+    {
+        public SpineVersion ImplementationKey { get; private set; } = version;
+    }
+
+    /// <summary>
+    /// Spine 版本静态辅助类
+    /// </summary>
+    public static class SpineHelper
+    {
+        /// <summary>
+        /// 版本名称
+        /// </summary>
+        public static readonly ReadOnlyDictionary<SpineVersion, string> Names;
+        private static readonly Dictionary<SpineVersion, string> names = [];
+
+        /// <summary>
+        /// Runtime 版本字符串
+        /// </summary>
+        private static readonly Dictionary<SpineVersion, string> runtimes = [];
+
+        static SpineHelper()
+        {
+            // 初始化缓存
+            foreach (var value in Enum.GetValues(typeof(SpineVersion)))
+            {
+                var field = typeof(SpineVersion).GetField(value.ToString());
+                var attribute = field?.GetCustomAttribute<DescriptionAttribute>();
+                names[(SpineVersion)value] = attribute?.Description ?? value.ToString();
+            }
+            Names = names.AsReadOnly();
+
+            runtimes[SpineVersion.V21] = Assembly.GetAssembly(typeof(SpineRuntime21.Skeleton)).GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+            runtimes[SpineVersion.V36] = Assembly.GetAssembly(typeof(SpineRuntime36.Skeleton)).GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+            runtimes[SpineVersion.V37] = Assembly.GetAssembly(typeof(SpineRuntime37.Skeleton)).GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+            runtimes[SpineVersion.V38] = Assembly.GetAssembly(typeof(SpineRuntime38.Skeleton)).GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+            runtimes[SpineVersion.V40] = Assembly.GetAssembly(typeof(SpineRuntime40.Skeleton)).GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+            runtimes[SpineVersion.V41] = Assembly.GetAssembly(typeof(SpineRuntime41.Skeleton)).GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+            runtimes[SpineVersion.V42] = Assembly.GetAssembly(typeof(SpineRuntime42.Skeleton)).GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+        }
+
+        /// <summary>
+        /// 版本字符串名称
+        /// </summary>
+        public static string GetName(this SpineVersion version)
+        {
+            return Names.TryGetValue(version, out var val) ? val : version.ToString();
+        }
+
+        /// <summary>
+        /// Runtime 版本字符串名称
+        /// </summary>
+        public static string GetRuntime(this SpineVersion version)
+        {
+            return runtimes.TryGetValue(version, out var val) ? val : GetName(version);
+        }
+
+        /// <summary>
+        /// 常规骨骼文件后缀集合
+        /// </summary>
+        public static readonly ImmutableHashSet<string> CommonSkelSuffix = [".skel", ".json"];
+
+        /// <summary>
+        /// 尝试检测骨骼文件版本
+        /// </summary>
+        /// <param name="skelPath"></param>
+        /// <returns></returns>
+        /// <exception cref="InvalidDataException"></exception>
+        public static SpineVersion GetVersion(string skelPath)
+        {
+            string versionString = null;
+            using var input = File.OpenRead(skelPath);
+            var reader = new SkeletonConverter.BinaryReader(input);
+
+            // try json format
+            try
+            {
+                if (JsonNode.Parse(input) is JsonObject root && root.TryGetPropertyValue("skeleton", out var node) &&
+                    node is JsonObject _skeleton && _skeleton.TryGetPropertyValue("spine", out var _version))
+                    versionString = (string)_version;
+            }
+            catch { }
+
+            // try v4 binary format
+            if (versionString is null)
+            {
+                try
+                {
+                    input.Position = 0;
+                    var hash = reader.ReadLong();
+                    var versionPosition = input.Position;
+                    var versionByteCount = reader.ReadVarInt();
+                    input.Position = versionPosition;
+                    if (versionByteCount <= 13)
+                        versionString = reader.ReadString();
+                }
+                catch { }
+            }
+
+            // try v3 binary format
+            if (versionString is null)
+            {
+                try
+                {
+                    input.Position = 0;
+                    var hash = reader.ReadString();
+                    versionString = reader.ReadString();
+                }
+                catch { }
+            }
+
+            if (versionString is null)
+                throw new InvalidDataException($"No verison detected: {skelPath}");
+
+            if (versionString.StartsWith("2.1.")) return SpineVersion.V21;
+            else if (versionString.StartsWith("3.6.")) return SpineVersion.V36;
+            else if (versionString.StartsWith("3.7.")) return SpineVersion.V37;
+            else if (versionString.StartsWith("3.8.")) return SpineVersion.V38;
+            else if (versionString.StartsWith("4.0.")) return SpineVersion.V40;
+            else if (versionString.StartsWith("4.1.")) return SpineVersion.V41;
+            else if (versionString.StartsWith("4.2.")) return SpineVersion.V42;
+            else if (versionString.StartsWith("4.3.")) return SpineVersion.V43;
+            else throw new InvalidDataException($"Unknown verison: {versionString}");
+        }
+    }
+}

SpineViewer/Spine/TypeConverter.cs

@@ -1,95 +0,0 @@
-using System;
-using System.Collections.Generic;
-using System.ComponentModel;
-using System.Diagnostics.CodeAnalysis;
-using System.Globalization;
-using System.Linq;
-using System.Text;
-using System.Threading.Tasks;
-
-namespace SpineViewer.Spine
-{
-    public class VersionConverter : EnumConverter
-    {
-        public VersionConverter() : base(typeof(Version)) { }
-
-        public override object? ConvertTo(ITypeDescriptorContext? context, CultureInfo? culture, object? value, Type? destinationType)
-        {
-            if (destinationType == typeof(string) && value is Version version)
-            {
-                // 调用自定义的 String() 方法
-                return version.GetName();
-            }
-
-            return base.ConvertTo(context, culture, value, destinationType);
-        }
-    }
-
-    public class AnimationConverter : StringConverter
-    {
-        public override bool GetStandardValuesSupported(ITypeDescriptorContext? context)
-        {
-            // 支持标准值列表
-            return true;
-        }
-
-        public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context)
-        {
-            // 排他模式，只有下拉列表中的值可选
-            return true;
-        }
-
-        public override StandardValuesCollection? GetStandardValues(ITypeDescriptorContext? context)
-        {
-            if (context?.Instance is Spine obj)
-            {
-                return new StandardValuesCollection(obj.AnimationNames);
-            }
-            else if (context?.Instance is Spine[] spines)
-            {
-                if (spines.Length > 0)
-                {
-                    IEnumerable<string> common = spines[0].AnimationNames;
-                    foreach (var spine in spines.Skip(1))
-                        common = common.Intersect(spine.AnimationNames);
-                    return new StandardValuesCollection(common.ToArray());
-                }
-            }
-            return base.GetStandardValues(context);
-        }
-    }
-
-    public class SkinConverter : StringConverter
-    {
-        public override bool GetStandardValuesSupported(ITypeDescriptorContext? context)
-        {
-            // 支持标准值列表
-            return true;
-        }
-
-        public override bool GetStandardValuesExclusive(ITypeDescriptorContext? context)
-        {
-            // 排他模式，只有下拉列表中的值可选
-            return true;
-        }
-
-        public override StandardValuesCollection? GetStandardValues(ITypeDescriptorContext? context)
-        {
-            if (context?.Instance is Spine obj)
-            {
-                return new StandardValuesCollection(obj.SkinNames);
-            }
-            else if (context?.Instance is Spine[] spines)
-            {
-                if (spines.Length > 0)
-                {
-                    IEnumerable<string> common = spines[0].SkinNames;
-                    foreach (var spine in spines.Skip(1))
-                        common = common.Intersect(spine.SkinNames);
-                    return new StandardValuesCollection(common.ToArray());
-                }
-            }
-            return base.GetStandardValues(context);
-        }
-    }
-}