Merge pull request #104 from ww-rm/dev/wpf

v0.15.18

CHANGELOG.md

@@ -1,5 +1,27 @@
 # CHANGELOG
 
+## v0.15.18
+
+- 完善窗口日志颜色标记
+- 修复预览图背景颜色为透明
+- 修复面板高度首次还原错误
+- 增加托盘图标
+- 增加可选预览背景画面和填充模式
+- 增强支持的纹理格式（例如 webp）
+
+## v0.15.17
+
+- 修改图标配色
+
+## v0.15.16
+
+- 修改模型添加顺序, 每次向顶层添加
+- 添加模型后自动选中最近添加的模型S
+- 点击预览画面或者选中项发生变化时转移焦点至列表
+- 增加移除全部菜单项
+- 增加单例模式和命令行文件参数
+- 增加文件关联设置
+
 ## v0.15.15
 
 - 增加报错信息

NLog.Windows.Wpf/NLog.Windows.Wpf.csproj

@@ -1,4 +1,4 @@
-<Project Sdk="Microsoft.NET.Sdk">
+<Project Sdk="Microsoft.NET.Sdk">
 
     <PropertyGroup>
         <ImplicitUsings>enable</ImplicitUsings>
@@ -7,7 +7,7 @@
         <TargetFramework>net8.0-windows</TargetFramework>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
-        <Version>0.15.4</Version>
+        <Version>0.15.18</Version>
         <UseWPF>true</UseWPF>
     </PropertyGroup>
 

NLog.Windows.Wpf/RichTextBoxRowColoringRule.cs

@@ -1,92 +1,53 @@
-// 
+using NLog;
-// Copyright (c) 2004-2011 Jaroslaw Kowalski <jaak@jkowalski.net>
-// 
-// All rights reserved.
-// 
-// Redistribution and use in source and binary forms, with or without 
-// modification, are permitted provided that the following conditions 
-// are met:
-// 
-// * Redistributions of source code must retain the above copyright notice, 
-//   this list of conditions and the following disclaimer. 
-// 
-// * Redistributions in binary form must reproduce the above copyright notice,
-//   this list of conditions and the following disclaimer in the documentation
-//   and/or other materials provided with the distribution. 
-// 
-// * Neither the name of Jaroslaw Kowalski nor the names of its 
-//   contributors may be used to endorse or promote products derived from this
-//   software without specific prior written permission. 
-// 
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
-// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
-// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
-// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
-// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
-// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
-// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
-// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 
-// THE POSSIBILITY OF SUCH DAMAGE.
-// 
-
 using NLog.Conditions;
 using NLog.Config;
-using NLog;
+using NLog.Layouts;
-using System.ComponentModel;
 using System.Windows;
+
 namespace NLog.Windows.Wpf
 {
     [NLogConfigurationItem]
     public class RichTextBoxRowColoringRule
     {
-        static RichTextBoxRowColoringRule()
-        {
-            Default = new RichTextBoxRowColoringRule();
-        }
-
-        public RichTextBoxRowColoringRule()
-            : this(null, "Empty", "Empty", FontStyles.Normal, FontWeights.Normal)
-        {
-        }
-
-        public RichTextBoxRowColoringRule(string condition, string fontColor, string backColor, FontStyle fontStyle, FontWeight fontWeight)
-        {
-            Condition = condition;
-            FontColor = fontColor;
-            BackgroundColor = backColor;
-            Style = fontStyle;
-            Weight = fontWeight;
-        }
-
-        public RichTextBoxRowColoringRule(string condition, string fontColor, string backColor)
-        {
-            Condition = condition;
-            FontColor = fontColor;
-            BackgroundColor = backColor;
-            Style = FontStyles.Normal;
-            Weight = FontWeights.Normal;
-        }
-
         public static RichTextBoxRowColoringRule Default { get; private set; }
 
         [RequiredParameter]
         public ConditionExpression Condition { get; set; }
 
-        [DefaultValue("Empty")]
+        public Layout FontColor { get; set; }
-        public string FontColor { get; set; }
+        public Layout BackgroundColor { get; set; }
 
-        [DefaultValue("Empty")]
+        public FontStyle FontStyle { get; set; }
-        public string BackgroundColor { get; set; }
+        public FontWeight FontWeight { get; set; }
 
-        public FontStyle Style { get; set; }
+        static RichTextBoxRowColoringRule()
+        {
+            RichTextBoxRowColoringRule.Default = new RichTextBoxRowColoringRule();
+        }
 
-        public FontWeight Weight { get; set; }
+        public RichTextBoxRowColoringRule() : this(null, "Empty", "Empty", FontStyles.Normal, FontWeights.Normal) { }
+
+        public RichTextBoxRowColoringRule(string condition, string fontColor, string backColor)
+        {
+            this.Condition = (ConditionExpression)condition;
+            this.FontColor = Layout.FromString(fontColor);
+            this.BackgroundColor = Layout.FromString(backColor);
+            this.FontStyle = FontStyles.Normal;
+            this.FontWeight = FontWeights.Normal;
+        }
+
+        public RichTextBoxRowColoringRule(string condition, string fontColor, string backColor, FontStyle fontStyle, FontWeight fontWeight)
+        {
+            this.Condition = (ConditionExpression)condition;
+            this.FontColor = Layout.FromString(fontColor);
+            this.BackgroundColor = Layout.FromString(backColor);
+            this.FontStyle = fontStyle;
+            this.FontWeight = fontWeight;
+        }
 
         public bool CheckCondition(LogEventInfo logEvent)
         {
-            return true.Equals(Condition.Evaluate(logEvent));
+            return true.Equals(this.Condition.Evaluate(logEvent));
         }
     }
 }

NLog.Windows.Wpf/RichTextBoxTarget.cs

@@ -1,34 +1,27 @@
-using NLog.Config;
+using NLog;
-using NLog.Layouts;
+using NLog.Common;
+using NLog.Config;
 using NLog.Targets;
-using NLog;
 using System;
 using System.Collections.Generic;
 using System.Collections.ObjectModel;
-using System.ComponentModel;
-using System.Diagnostics;
 using System.Linq;
-using System.Text;
+using System.Text.RegularExpressions;
-using System.Threading.Tasks;
+using System.Windows;
 using System.Windows.Controls;
 using System.Windows.Documents;
 using System.Windows.Media;
-using System.Windows;
 
 namespace NLog.Windows.Wpf
 {
-    // TODO: 完善日志实现
     [Target("RichTextBox")]
     public sealed class RichTextBoxTarget : TargetWithLayout
     {
-        private int lineCount;
+        public static ReadOnlyCollection<RichTextBoxRowColoringRule> DefaultRowColoringRules { get; } = CreateDefaultColoringRules();
-        private int _width = 500;
-        private int _height = 500;
-        private static readonly TypeConverter colorConverter = new ColorConverter();
 
-        static RichTextBoxTarget()
+        private static ReadOnlyCollection<RichTextBoxRowColoringRule> CreateDefaultColoringRules()
         {
-            var rules = new List<RichTextBoxRowColoringRule>()
+            return new List<RichTextBoxRowColoringRule>()
             {
                 new RichTextBoxRowColoringRule("level == LogLevel.Fatal", "White", "Red", FontStyles.Normal, FontWeights.Bold),
                 new RichTextBoxRowColoringRule("level == LogLevel.Error", "Red", "Empty", FontStyles.Italic, FontWeights.Bold),
@@ -36,220 +29,252 @@ namespace NLog.Windows.Wpf
                 new RichTextBoxRowColoringRule("level == LogLevel.Info", "Black", "Empty"),
                 new RichTextBoxRowColoringRule("level == LogLevel.Debug", "Gray", "Empty"),
                 new RichTextBoxRowColoringRule("level == LogLevel.Trace", "DarkGray", "Empty", FontStyles.Italic, FontWeights.Normal),
-            };
+            }.AsReadOnly();
-
-            DefaultRowColoringRules = rules.AsReadOnly();
         }
 
-        public RichTextBoxTarget()
+        public RichTextBoxTarget() { }
-        {
-            WordColoringRules = new List<RichTextBoxWordColoringRule>();
-            RowColoringRules = new List<RichTextBoxRowColoringRule>();
-            ToolWindow = true;
-        }
-
-        private delegate void DelSendTheMessageToRichTextBox(string logMessage, RichTextBoxRowColoringRule rule);
-
-        private delegate void FormCloseDelegate();
-
-        public static ReadOnlyCollection<RichTextBoxRowColoringRule> DefaultRowColoringRules { get; private set; }
 
         public string ControlName { get; set; }
 
-        public string FormName { get; set; }
+        public string WindowName { get; set; }
 
-        [DefaultValue(false)]
         public bool UseDefaultRowColoringRules { get; set; }
 
-        [ArrayParameter(typeof(RichTextBoxRowColoringRule), "row-coloring")]
-        public IList<RichTextBoxRowColoringRule> RowColoringRules { get; private set; }
-
-        [ArrayParameter(typeof(RichTextBoxWordColoringRule), "word-coloring")]
-        public IList<RichTextBoxWordColoringRule> WordColoringRules { get; private set; }
-
-        [DefaultValue(true)]
-        public bool ToolWindow { get; set; }
-
-        public bool ShowMinimized { get; set; }
-
-        public int Width
-        {
-            get { return _width; }
-            set { _width = value; }
-        }
-
-        public int Height
-        {
-            get { return _height; }
-            set { _height = value; }
-        }
-
         public bool AutoScroll { get; set; }
 
         public int MaxLines { get; set; }
 
-        internal Window TargetForm { get; set; }
+        [ArrayParameter(typeof(RichTextBoxRowColoringRule), "row-coloring")]
+        public IList<RichTextBoxRowColoringRule> RowColoringRules { get; } = new List<RichTextBoxRowColoringRule>();
 
-        internal RichTextBox TargetRichTextBox { get; set; }
+        [ArrayParameter(typeof(RichTextBoxWordColoringRule), "word-coloring")]
+        public IList<RichTextBoxWordColoringRule> WordColoringRules { get; } = new List<RichTextBoxWordColoringRule>();
 
-        internal bool CreatedForm { get; set; }
+        [NLogConfigurationIgnoreProperty]
+        public Window TargetWindow { get; set; }
+
+        [NLogConfigurationIgnoreProperty]
+        public RichTextBox TargetRichTextBox { get; set; }
 
         protected override void InitializeTarget()
         {
-            TargetRichTextBox = Application.Current.MainWindow.FindName(ControlName) as RichTextBox;
+            base.InitializeTarget();
+            if (TargetRichTextBox != null)
+                return;
 
-            if (TargetRichTextBox != null) return;
+            if (WindowName == null)
-            //this.TargetForm = FormHelper.CreateForm(this.FormName, this.Width, this.Height, false, this.ShowMinimized, this.ToolWindow);
-            //this.CreatedForm = true;
-
-            var openFormByName = Application.Current.Windows.Cast<Window>().FirstOrDefault(x => x.GetType().Name == FormName);
-            if (openFormByName != null)
             {
-                TargetForm = openFormByName;
+                HandleError("WindowName should be specified for {0}.{1}", GetType().Name, Name);
+                return;
+            }
+
             if (string.IsNullOrEmpty(ControlName))
             {
-                    // throw new NLogConfigurationException("Rich text box control name must be specified for " + GetType().Name + ".");
+                HandleError("Rich text box control name must be specified for {0}.{1}", GetType().Name, Name);
-                    Trace.WriteLine("Rich text box control name must be specified for " + GetType().Name + ".");
+                return;
             }
 
-                CreatedForm = false;
+            var targetWindow = Application.Current.Windows.OfType<Window>().FirstOrDefault(w => w.Name == WindowName);
-                TargetRichTextBox = TargetForm.FindName(ControlName) as RichTextBox;
+            if (targetWindow == null)
-
-                if (TargetRichTextBox == null)
             {
-                    // throw new NLogConfigurationException("Rich text box control '" + ControlName + "' cannot be found on form '" + FormName + "'.");
+                InternalLogger.Info("{0}: WindowName '{1}' not found", this, WindowName);
-                    Trace.WriteLine("Rich text box control '" + ControlName + "' cannot be found on form '" + FormName + "'.");
+                return;
-                }
             }
 
-            if (TargetRichTextBox == null)
+            var targetControl = targetWindow.FindName(ControlName) as RichTextBox;
+            if (targetControl == null)
             {
-                TargetForm = new Window
+                InternalLogger.Info("{0}: WIndowName '{1}' does not contain ControlName '{2}'", this, WindowName, ControlName);
-                {
+                return;
-                    Name = FormName,
-                    Width = Width,
-                    Height = Height,
-                    WindowStyle = ToolWindow ? WindowStyle.ToolWindow : WindowStyle.None,
-                    WindowState = ShowMinimized ? WindowState.Minimized : WindowState.Normal,
-                    Title = "NLog Messages"
-                };
-                TargetForm.Show();
-
-                TargetRichTextBox = new RichTextBox { Name = ControlName };
-                var style = new Style(typeof(Paragraph));
-                TargetRichTextBox.VerticalScrollBarVisibility = ScrollBarVisibility.Auto;
-                style.Setters.Add(new Setter(Block.MarginProperty, new Thickness(0, 0, 0, 0)));
-                TargetRichTextBox.Resources.Add(typeof(Paragraph), style);
-                TargetForm.Content = TargetRichTextBox;
-
-                CreatedForm = true;
             }
+
+            AttachToControl(targetWindow, targetControl);
+        }
+
+        private static void HandleError(string message, params object[] args)
+        {
+            if (LogManager.ThrowExceptions)
+            {
+                throw new NLogConfigurationException(string.Format(message, args));
+            }
+            InternalLogger.Error(message, args);
+        }
+
+        private void AttachToControl(Window window, RichTextBox textboxControl)
+        {
+            InternalLogger.Info("{0}: Attaching target to textbox {1}.{2}", this, window.Name, textboxControl.Name);
+            DetachFromControl();
+            TargetWindow = window;
+            TargetRichTextBox = textboxControl;
+        }
+
+        private void DetachFromControl()
+        {
+            TargetWindow = null;
+            TargetRichTextBox = null;
         }
 
         protected override void CloseTarget()
         {
-            if (CreatedForm)
+            DetachFromControl();
-            {
-                try
-                {
-                    TargetForm.Dispatcher.Invoke(() =>
-                    {
-                        TargetForm.Close();
-                        TargetForm = null;
-                    });
-                }
-                catch
-                {
-                }
-
-
-
-            }
         }
 
         protected override void Write(LogEventInfo logEvent)
         {
-            RichTextBoxRowColoringRule matchingRule = RowColoringRules.FirstOrDefault(rr => rr.CheckCondition(logEvent));
+            RichTextBox textbox = TargetRichTextBox;
-
+            if (textbox == null || textbox.Dispatcher.HasShutdownStarted || textbox.Dispatcher.HasShutdownFinished)
-            if (UseDefaultRowColoringRules && matchingRule == null)
             {
-                foreach (var rr in DefaultRowColoringRules.Where(rr => rr.CheckCondition(logEvent)))
+                //no last logged textbox
-                {
+                InternalLogger.Trace("{0}: Attached Textbox is {1}, skipping logging", this, textbox == null ? "null" : "disposed");
-                    matchingRule = rr;
+                return;
-                    break;
-                }
             }
 
-            if (matchingRule == null)
+            string logMessage = RenderLogEvent(Layout, logEvent);
-            {
+            RichTextBoxRowColoringRule matchingRule = FindMatchingRule(logEvent);
-                matchingRule = RichTextBoxRowColoringRule.Default;
+            _ = DoSendMessageToTextbox(logMessage, matchingRule, logEvent);
         }
 
-            var logMessage = Layout.Render(logEvent);
+        private bool DoSendMessageToTextbox(string logMessage, RichTextBoxRowColoringRule rule, LogEventInfo logEvent)
-
+        {
-            if (Application.Current == null) return;
+            RichTextBox textbox = TargetRichTextBox;
-
             try
             {
-                if (Application.Current.Dispatcher.CheckAccess() == false)
+                if (textbox != null && !textbox.Dispatcher.HasShutdownStarted && !textbox.Dispatcher.HasShutdownFinished)
                 {
-                    Application.Current.Dispatcher.Invoke(() => SendTheMessageToRichTextBox(logMessage, matchingRule));
+                    if (!textbox.Dispatcher.CheckAccess())
+                    {
+                        textbox.Dispatcher.BeginInvoke(() => SendTheMessageToRichTextBox(textbox, logMessage, rule, logEvent));
                     }
                     else
                     {
-                    SendTheMessageToRichTextBox(logMessage, matchingRule);
+                        SendTheMessageToRichTextBox(textbox, logMessage, rule, logEvent);
+                    }
+                    return true;
                 }
             }
             catch (Exception ex)
             {
-                Debug.WriteLine(ex);
+                InternalLogger.Warn(ex, "{0}: Failed to append RichTextBox", this);
-            }
 
-        }
+                if (LogManager.ThrowExceptions)
-
-
-        private static Color GetColorFromString(string color, Brush defaultColor)
                 {
-
+                    throw;
-            if (color == "Empty")
+                }
-            {
+            }
-                return defaultColor is SolidColorBrush solidBrush ? solidBrush.Color : Colors.White;
+            return false;
         }
 
-            return (Color)colorConverter.ConvertFromString(color);
+        private RichTextBoxRowColoringRule FindMatchingRule(LogEventInfo logEvent)
+        {
+            //custom rules first
+            if (RowColoringRules.Count > 0)
+            {
+                foreach (RichTextBoxRowColoringRule coloringRule in RowColoringRules)
+                {
+                    if (coloringRule.CheckCondition(logEvent))
+                    {
+                        return coloringRule;
+                    }
+                }
             }
 
-
+            if (UseDefaultRowColoringRules && DefaultRowColoringRules != null)
-        private void SendTheMessageToRichTextBox(string logMessage, RichTextBoxRowColoringRule rule)
             {
-            RichTextBox rtbx = TargetRichTextBox;
+                foreach (RichTextBoxRowColoringRule coloringRule in DefaultRowColoringRules)
+                {
+                    if (coloringRule.CheckCondition(logEvent))
+                    {
+                        return coloringRule;
+                    }
+                }
+            }
+
+            return RichTextBoxRowColoringRule.Default;
+        }
+
+        private void SendTheMessageToRichTextBox(RichTextBox textBox, string logMessage, RichTextBoxRowColoringRule rule, LogEventInfo logEvent)
+        {
+            if (textBox == null) return;
+
+            var document = textBox.Document;
+
+            // 插入文本（带换行）
+            var tr = new TextRange(document.ContentEnd, document.ContentEnd)
+            {
+                Text = logMessage + Environment.NewLine
+            };
+
+            // 设置行级样式
+            var fgColor = rule.FontColor?.Render(logEvent);
+            var bgColor = rule.BackgroundColor?.Render(logEvent);
 
-            var tr = new TextRange(rtbx.Document.ContentEnd, rtbx.Document.ContentEnd);
-            tr.Text = logMessage + "\n";
             tr.ApplyPropertyValue(TextElement.ForegroundProperty,
-                new SolidColorBrush(GetColorFromString(rule.FontColor, (Brush)tr.GetPropertyValue(TextElement.ForegroundProperty)))
+                string.IsNullOrEmpty(fgColor) || fgColor == "Empty"
-            );
+                    ? textBox.Foreground
+                    : new SolidColorBrush((Color)ColorConverter.ConvertFromString(fgColor)));
+
             tr.ApplyPropertyValue(TextElement.BackgroundProperty,
-                new SolidColorBrush(GetColorFromString(rule.BackgroundColor, (Brush)tr.GetPropertyValue(TextElement.BackgroundProperty)))
+                string.IsNullOrEmpty(bgColor) || bgColor == "Empty"
-            );
+                    ? Brushes.Transparent
-            tr.ApplyPropertyValue(TextElement.FontStyleProperty, rule.Style);
+                    : new SolidColorBrush((Color)ColorConverter.ConvertFromString(bgColor)));
-            tr.ApplyPropertyValue(TextElement.FontWeightProperty, rule.Weight);
 
+            tr.ApplyPropertyValue(TextElement.FontStyleProperty, rule.FontStyle);
+            tr.ApplyPropertyValue(TextElement.FontWeightProperty, rule.FontWeight);
 
+            // Word coloring（在刚插入的范围内做匹配）
+            if (WordColoringRules.Count > 0)
+            {
+                foreach (var wordRule in WordColoringRules)
+                {
+                    var pattern = wordRule.Regex?.Render(logEvent) ?? string.Empty;
+                    var text = wordRule.Text?.Render(logEvent) ?? string.Empty;
+                    var wholeWords = wordRule.WholeWords.RenderValue(logEvent);
+                    var ignoreCase = wordRule.IgnoreCase.RenderValue(logEvent);
+
+                    var regex = wordRule.ResolveRegEx(pattern, text, wholeWords, ignoreCase);
+                    var matches = regex.Matches(tr.Text);
+
+                    foreach (Match match in matches)
+                    {
+                        // 匹配到的部分范围
+                        var start = tr.Start.GetPositionAtOffset(match.Index, LogicalDirection.Forward);
+                        var endPos = tr.Start.GetPositionAtOffset(match.Index + match.Length, LogicalDirection.Backward);
+                        if (start == null || endPos == null) continue;
+
+                        var wordRange = new TextRange(start, endPos);
+
+                        var wordFg = wordRule.FontColor?.Render(logEvent);
+                        var wordBg = wordRule.BackgroundColor?.Render(logEvent);
+
+                        wordRange.ApplyPropertyValue(TextElement.ForegroundProperty,
+                            string.IsNullOrEmpty(wordFg) || wordFg == "Empty"
+                                ? tr.GetPropertyValue(TextElement.ForegroundProperty)
+                                : new SolidColorBrush((Color)ColorConverter.ConvertFromString(wordFg)));
+
+                        wordRange.ApplyPropertyValue(TextElement.BackgroundProperty,
+                            string.IsNullOrEmpty(wordBg) || wordBg == "Empty"
+                                ? tr.GetPropertyValue(TextElement.BackgroundProperty)
+                                : new SolidColorBrush((Color)ColorConverter.ConvertFromString(wordBg)));
+
+                        wordRange.ApplyPropertyValue(TextElement.FontStyleProperty, wordRule.FontStyle);
+                        wordRange.ApplyPropertyValue(TextElement.FontWeightProperty, wordRule.FontWeight);
+                    }
+                }
+            }
+
+            // 限制最大行数
             if (MaxLines > 0)
             {
-                lineCount++;
+                while (document.Blocks.Count > MaxLines)
-                if (lineCount > MaxLines)
                 {
-                    tr = new TextRange(rtbx.Document.ContentStart, rtbx.Document.ContentEnd);
+                    document.Blocks.Remove(document.Blocks.FirstBlock);
-                    tr.Text.Remove(0, tr.Text.IndexOf('\n'));
-                    lineCount--;
                 }
             }
 
+            // 自动滚动到最后
             if (AutoScroll)
             {
-                rtbx.ScrollToEnd();
+                textBox.ScrollToEnd();
             }
         }
     }

NLog.Windows.Wpf/RichTextBoxWordColoringRule.cs

@@ -1,119 +1,59 @@
-// 
+using NLog.Config;
-// Copyright (c) 2004-2011 Jaroslaw Kowalski <jaak@jkowalski.net>
+using NLog.Layouts;
-// 
-// All rights reserved.
-// 
-// Redistribution and use in source and binary forms, with or without 
-// modification, are permitted provided that the following conditions 
-// are met:
-// 
-// * Redistributions of source code must retain the above copyright notice, 
-//   this list of conditions and the following disclaimer. 
-// 
-// * Redistributions in binary form must reproduce the above copyright notice,
-//   this list of conditions and the following disclaimer in the documentation
-//   and/or other materials provided with the distribution. 
-// 
-// * Neither the name of Jaroslaw Kowalski nor the names of its 
-//   contributors may be used to endorse or promote products derived from this
-//   software without specific prior written permission. 
-// 
-// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
-// AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
-// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 
-// ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE 
-// LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
-// CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
-// SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 
-// INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 
-// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 
-// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 
-// THE POSSIBILITY OF SUCH DAMAGE.
-// 
-
 using System.ComponentModel;
 using System.Text.RegularExpressions;
 using System.Windows;
-using NLog.Config;
 
 namespace NLog.Windows.Wpf
 {
     [NLogConfigurationItem]
     public class RichTextBoxWordColoringRule
     {
-        private Regex compiledRegex;
+        public Layout Regex { get; set; }
+        public Layout Text { get; set; }
+        public Layout<bool> WholeWords { get; set; }
+        public Layout<bool> IgnoreCase { get; set; }
 
-        public RichTextBoxWordColoringRule()
+        public Layout FontColor { get; set; }
+        public Layout BackgroundColor { get; set; }
+
+        public FontStyle FontStyle { get; set; }
+        public FontWeight FontWeight { get; set; }
+
+        internal Regex ResolveRegEx(string pattern, string text, bool wholeWords, bool ignoreCase)
         {
-            FontColor = "Empty";
+            if (string.IsNullOrEmpty(pattern) && text != null)
-            BackgroundColor = "Empty";
+            {
+                pattern = System.Text.RegularExpressions.Regex.Escape(text);
+                if (wholeWords)
+                    pattern = "\b" + pattern + "\b";
             }
 
+            RegexOptions options = RegexOptions.None;
+            if (ignoreCase)
+                options |= RegexOptions.IgnoreCase;
+
+            return new Regex(pattern, options);   // RegEx-Cache
+        }
+
+        public RichTextBoxWordColoringRule() : this(null, "Empty", "Empty", FontStyles.Normal, FontWeights.Normal) { }
+
         public RichTextBoxWordColoringRule(string text, string fontColor, string backgroundColor)
         {
-            Text = text;
+            this.Text = text;
-            FontColor = fontColor;
+            this.FontColor = Layout.FromString(fontColor);
-            BackgroundColor = backgroundColor;
+            this.BackgroundColor = Layout.FromString(backgroundColor);
-            Style = FontStyles.Normal;
+            this.FontStyle = FontStyles.Normal;
-            Weight = FontWeights.Normal;
+            this.FontWeight = FontWeights.Normal;
         }
 
         public RichTextBoxWordColoringRule(string text, string textColor, string backgroundColor, FontStyle fontStyle, FontWeight fontWeight)
         {
-            Text = text;
+            this.Text = text;
-            FontColor = textColor;
+            this.FontColor = Layout.FromString(textColor);
-            BackgroundColor = backgroundColor;
+            this.BackgroundColor = Layout.FromString(backgroundColor);
-            Style = fontStyle;
+            this.FontStyle = fontStyle;
-            Weight = fontWeight;
+            this.FontWeight = fontWeight;
         }
-
-        public string Regex { get; set; }
-
-        public string Text { get; set; }
-
-        [DefaultValue(false)]
-        public bool WholeWords { get; set; }
-
-        [DefaultValue(false)]
-        public bool IgnoreCase { get; set; }
-
-        public FontStyle Style { get; set; }
-
-        public FontWeight Weight { get; set; }
-
-        public Regex CompiledRegex
-        {
-            get
-            {
-                if (compiledRegex == null)
-                {
-                    string regexpression = Regex;
-                    if (regexpression == null && Text != null)
-                    {
-                        regexpression = System.Text.RegularExpressions.Regex.Escape(Text);
-                        if (WholeWords)
-                        {
-                            regexpression = "\b" + regexpression + "\b";
-                        }
-                    }
-
-                    RegexOptions regexOptions = RegexOptions.Compiled;
-                    if (IgnoreCase)
-                    {
-                        regexOptions |= RegexOptions.IgnoreCase;
-                    }
-
-                    compiledRegex = new Regex(regexpression, regexOptions);
-                }
-
-                return compiledRegex;
-            }
-        }
-
-        [DefaultValue("Empty")]
-        public string FontColor { get; set; }
-
-        [DefaultValue("Empty")]
-        public string BackgroundColor { get; set; }
     }
 }

README.en.md

@@ -28,6 +28,8 @@ A simple and user-friendly Spine file viewer and exporter with multi-language su
 * Automatic resolution batch export.
 * FFmpeg custom export support.
 * Program parameter saving.
+* File name extension association.
+* Supports texture image formats other than PNG.
 * ...
 
 ### Supported Spine Versions

README.md

@@ -28,6 +28,8 @@
 - 支持自动分辨率批量导出
 - 支持 FFmpeg 自定义导出
 - 支持程序参数保存
+- 支持文件后缀关联
+- 支持非 png 格式的纹理图片格式
 - ......
 
 ### Spine 版本支持

Spine/Spine.csproj

@@ -7,7 +7,7 @@
         <TargetFramework>net8.0-windows</TargetFramework>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
-        <Version>0.15.15</Version>
+        <Version>0.15.18</Version>
     </PropertyGroup>
 
     <PropertyGroup>

Spine/SpineWrappers/TextureLoader.cs

@@ -1,4 +1,6 @@
-using System;
+using SFML.Graphics;
+using SkiaSharp;
+using System;
 using System.Collections.Generic;
 using System.Linq;
 using System.Text;
@@ -40,38 +42,27 @@ namespace Spine.SpineWrappers
         /// </summary>
         public bool ForceMipmap { get; set; }
 
-        private SFML.Graphics.Texture ReadTexture(string path)
+        private Texture ReadTexture(string path)
         {
-            if (ForcePremul)
+            using var codec = SKCodec.Create(path, out var result);
-            {
+            if (codec is null || result != SKCodecResult.Success)
-                using var image = new SFML.Graphics.Image(path);
+                throw new InvalidOperationException($"Failed to create codec '{path}', {result}");
-                var width = image.Size.X;
+
-                var height = image.Size.Y;
+            var width = codec.Info.Width;
-                var pixels = image.Pixels;
+            var height = codec.Info.Height;
-                var size = width * height * 4;
+
-                for (int i = 0; i < size; i += 4)
+            // 判断是否需要强制预乘
-                {
+            var alphaType = ForcePremul ? SKAlphaType.Premul : SKAlphaType.Unpremul;
-                    byte a = pixels[i + 3];
+            var info = new SKImageInfo(width, height, SKColorType.Rgba8888, alphaType);
-                    if (a == 0)
+
-                    {
+            result = codec.GetPixels(info, out var pixels);
-                        pixels[i + 0] = 0;
+            if (result != SKCodecResult.Success)
-                        pixels[i + 1] = 0;
+                throw new InvalidOperationException($"Failed to decode image '{path}', {result}");
-                        pixels[i + 2] = 0;
+
-                    }
+            Texture tex = new((uint)width, (uint)height);
-                    else if (a != 255)
-                    {
-                        float f = a / 255f;
-                        pixels[i + 0] = (byte)(pixels[i + 0] * f);
-                        pixels[i + 1] = (byte)(pixels[i + 1] * f);
-                        pixels[i + 2] = (byte)(pixels[i + 2] * f);
-                    }
-                }
-                var tex = new SFML.Graphics.Texture(width, height);
             tex.Update(pixels);
             return tex;
         }
-            return new(path);
-        }
 
         public virtual void Load(SpineRuntime21.AtlasPage page, string path)
         {
@@ -394,7 +385,7 @@ namespace Spine.SpineWrappers
 
         public virtual void Unload(object texture)
         {
-            ((SFML.Graphics.Texture)texture).Dispose();
+            ((Texture)texture).Dispose();
         }
     }
 }

SpineViewer/App.xaml.cs

@@ -1,10 +1,13 @@
 using NLog;
+using SpineViewer.Natives;
 using SpineViewer.Views;
 using System.Collections.Frozen;
 using System.Configuration;
 using System.Data;
 using System.Diagnostics;
 using System.Globalization;
+using System.IO;
+using System.IO.Pipes;
 using System.Reflection;
 using System.Windows;
 
@@ -15,9 +18,18 @@ namespace SpineViewer
     /// </summary>
     public partial class App : Application
     {
-        public static string Version => Assembly.GetExecutingAssembly().GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+        public const string ProgId = "SpineViewer.skel";
+
+        public static readonly string ProcessPath = Environment.ProcessPath;
+        public static readonly string ProcessDirectory = Path.GetDirectoryName(Environment.ProcessPath);
+        public static readonly string ProcessName = Process.GetCurrentProcess().ProcessName;
+        public static readonly string Version = Assembly.GetExecutingAssembly().GetCustomAttribute<AssemblyInformationalVersionAttribute>()?.InformationalVersion;
+
+        private const string MutexName = "SpineViewerInstance";
+        private const string PipeName = "SpineViewerPipe";
 
         private static readonly Logger _logger;
+        private static readonly Mutex _instanceMutex;
 
         static App()
         {
@@ -35,6 +47,17 @@ namespace SpineViewer
                 _logger.Error("Unobserved task exception: {0}", e.Exception.Message);
                 e.SetObserved();
             };
+
+            // 单例模式加 IPC 通信
+            _instanceMutex = new Mutex(true, MutexName, out var createdNew);
+            if (!createdNew)
+            {
+                ShowExistedInstance();
+                SendCommandLineArgs();
+                Environment.Exit(0); // 不再启动新实例
+                return;
+            }
+            StartPipeServer();
         }
 
         private static void InitializeLogConfiguration()
@@ -50,7 +73,9 @@ namespace SpineViewer
                 ArchiveNumbering = NLog.Targets.ArchiveNumberingMode.Rolling,
                 ArchiveAboveSize = 1048576,
                 MaxArchiveFiles = 5,
-                Layout = "${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${level:uppercase=true} - ${callsite-filename:includeSourcePath=false}:${callsite-linenumber} - ${message}"
+                Layout = "${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${level:uppercase=true} - ${processid} - ${callsite-filename:includeSourcePath=false}:${callsite-linenumber} - ${message}",
+                ConcurrentWrites = true,
+                KeepFileOpen = false,
             };
 
             config.AddTarget(fileTarget);
@@ -58,20 +83,113 @@ namespace SpineViewer
             LogManager.Configuration = config;
         }
 
+        private static void ShowExistedInstance()
+        {
+            try
+            {
+                // 2. 遍历同名进程
+                var processes = Process.GetProcessesByName(ProcessName);
+                foreach (var p in processes)
+                {
+                    // 跳过当前进程
+                    if (p.Id == Process.GetCurrentProcess().Id)
+                        continue;
+
+                    IntPtr hWnd = p.MainWindowHandle;
+                    if (hWnd != IntPtr.Zero)
+                    {
+                        // 3. 显示并置顶窗口
+                        if (User32.IsIconic(hWnd))
+                        {
+                            User32.ShowWindow(hWnd, User32.SW_RESTORE);
+                        }
+                        User32.SetForegroundWindow(hWnd);
+                        break; // 找到一个就可以退出
+                    }
+                }
+            }
+            catch
+            {
+                // 忽略异常，不影响当前进程退出
+            }
+        }
+
+        private static void SendCommandLineArgs()
+        {
+            var args = Environment.GetCommandLineArgs().Skip(1).ToArray();
+            if (args.Length <= 0)
+                return;
+
+            _logger.Info("Send command line args to existed instance, \"{0}\"", string.Join(", ", args));
+            try
+            {
+                // 已有实例在运行，把参数通过命名管道发过去
+                using (var client = new NamedPipeClientStream(".", PipeName, PipeDirection.Out))
+                {
+                    client.Connect(10000); // 10 秒超时
+                    using (var writer = new StreamWriter(client))
+                    {
+                        foreach (var v in args)
+                        {
+                            writer.WriteLine(v);
+                        }
+                    }
+                }
+            }
+            catch (Exception ex)
+            {
+                _logger.Trace(ex.ToString());
+                _logger.Error("Failed to pass command line args to existed instance, {0}", ex.Message);
+            }
+        }
+
+        private static void StartPipeServer()
+        {
+            var t = new Task(() =>
+            {
+                while (Current is null) Thread.Sleep(10);
+                while (true)
+                {
+                    var windowCreated = false;
+                    Current.Dispatcher.Invoke(() => windowCreated = Current.MainWindow is MainWindow);
+                    if (windowCreated)
+                        break;
+                    else
+                        Thread.Sleep(100);
+                }
+                while (true)
+                {
+                    using (var server = new NamedPipeServerStream(PipeName, PipeDirection.In))
+                    {
+                        server.WaitForConnection();
+                        using (var reader = new StreamReader(server))
+                        {
+                            var args = new List<string>();
+                            string? line;
+                            while ((line = reader.ReadLine()) != null)
+                                args.Add(line);
+
+                            if (args.Count > 0)
+                            {
+                                Current.Dispatcher.Invoke(() => ((MainWindow)Current.MainWindow).OpenFiles(args));
+                            }
+                        }
+                    }
+                }
+            }, default, TaskCreationOptions.LongRunning);
+            t.Start();
+        }
+
         protected override void OnStartup(StartupEventArgs e)
         {
+            // 正式启动窗口
             base.OnStartup(e);
-
-            var dict = new ResourceDictionary();
-
             var uiCulture = CultureInfo.CurrentUICulture.Name.ToLowerInvariant();
             _logger.Info("Current UI Culture: {0}", uiCulture);
 
             if (uiCulture.StartsWith("zh")) { } // 默认就是中文, 无需操作
             else if (uiCulture.StartsWith("ja")) Language = AppLanguage.JA;
             else Language = AppLanguage.EN;
-
-            Resources.MergedDictionaries.Add(dict);
         }
 
         private void App_DispatcherUnhandledException(object sender, System.Windows.Threading.DispatcherUnhandledExceptionEventArgs e)

SpineViewer/Models/LastStateModel.cs

@@ -33,6 +33,8 @@ namespace SpineViewer.Models
         public float Speed { get; set; } = 1f;
         public bool ShowAxis { get; set; } = true;
         public Color BackgroundColor { get; set; } = Color.FromRgb(105, 105, 105);
+        public string BackgroundImagePath { get; set; }
+        public Stretch BackgroundImageMode { get; set; } = Stretch.Uniform;
 
         #endregion
 

SpineViewer/Models/PreferenceModel.cs

@@ -76,6 +76,9 @@ namespace SpineViewer.Models
         [ObservableProperty]
         private bool _renderSelectedOnly;
 
+        [ObservableProperty]
+        private bool _associateFileSuffix;
+
         [ObservableProperty]
         private AppLanguage _appLanguage;
 

SpineViewer/Models/WorkspaceModel.cs

@@ -43,10 +43,9 @@ namespace SpineViewer.Models
 
         public Color BackgroundColor { get; set; }
 
-        // TODO: 背景图片
+        public string BackgroundImagePath { get; set; }
-        //public string? BackgroundImagePath { get; set; }
 
-        //public ? BackgroundImageDisplayMode { get; set; }
+        public Stretch BackgroundImageMode { get; set; } = Stretch.Uniform;
     }
 
     public class SpineObjectWorkspaceConfigModel

SpineViewer/Natives/Gdi32.cs

@@ -0,0 +1,29 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Runtime.InteropServices;
+using System.Text;
+using System.Threading.Tasks;
+using System.Windows;
+
+namespace SpineViewer.Natives
+{
+    /// <summary>
+    /// gdi32.dll 包装类
+    /// </summary>
+    public static class Gdi32
+    {
+        [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);
+    }
+}

SpineViewer/Natives/Shell32.cs

@@ -0,0 +1,28 @@
+using System;
+using System.Collections.Generic;
+using System.Diagnostics;
+using System.Linq;
+using System.Runtime.InteropServices;
+using System.Text;
+using System.Threading.Tasks;
+using System.Windows;
+
+namespace SpineViewer.Natives
+{
+    /// <summary>
+    /// shell32.dll 包装类
+    /// </summary>
+    public static class Shell32
+    {
+        private const uint SHCNE_ASSOCCHANGED = 0x08000000;
+        private const uint SHCNF_IDLIST = 0x0000;
+
+        [DllImport("shell32.dll")]
+        private static extern void SHChangeNotify(uint wEventId, uint uFlags, IntPtr dwItem1, IntPtr dwItem2);
+
+        public static void NotifyAssociationChanged()
+        {
+            SHChangeNotify(SHCNE_ASSOCCHANGED, SHCNF_IDLIST, IntPtr.Zero, IntPtr.Zero);
+        }
+    }
+}

SpineViewer/Natives/User32.cs

@@ -10,9 +10,9 @@ using System.Windows;
 namespace SpineViewer.Natives
 {
     /// <summary>
-    /// Win32 Sdk 包装类
+    /// user32.dll 包装类
     /// </summary>
-    public static class Win32
+    public static class User32
     {
         public const int GWL_STYLE = -16;
         public const int WS_SIZEBOX = 0x40000;
@@ -178,17 +178,11 @@ namespace SpineViewer.Natives
         [DllImport("user32.dll", SetLastError = true)]
         public static extern bool ShowWindow(nint hWnd, int nCmdShow);
 
-        [DllImport("gdi32.dll", SetLastError = true)]
+        [DllImport("user32.dll")]
-        public static extern nint CreateCompatibleDC(nint hdc);
+        public static extern bool IsIconic(IntPtr hWnd);
 
-        [DllImport("gdi32.dll", SetLastError = true)]
+        [DllImport("user32.dll")]
-        public static extern bool DeleteDC(nint hdc);
+        public static extern bool SetForegroundWindow(IntPtr hWnd);
-
-        [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);
 
         [DllImport("user32.dll")]
         private static extern IntPtr MonitorFromWindow(IntPtr hwnd, uint dwFlags);

SpineViewer/Resources/AppResource.cs

@@ -19,6 +19,8 @@ namespace SpineViewer.Resources
         public static string Str_GeneratePreviewsTitle => Get<string>("Str_GeneratePreviewsTitle");
         public static string Str_DeletePreviewsTitle => Get<string>("Str_DeletePreviewsTitle");
         public static string Str_AddSpineObjectsTitle => Get<string>("Str_AddSpineObjectsTitle");
+        public static string Str_OpenSkelFileTitle => Get<string>("Str_OpenSkelFileTitle");
+        public static string Str_OpenAtlasFileTitle => Get<string>("Str_OpenAtlasFileTitle");
         public static string Str_ReloadSpineObjectsTitle => Get<string>("Str_ReloadSpineObjectsTitle");
         public static string Str_CustomFFmpegExporterTitle => Get<string>("Str_CustomFFmpegExporterTitle");
 

SpineViewer/Resources/Strings/en.xaml

@@ -37,8 +37,11 @@
     <s:String x:Key="Str_Show">Show</s:String>
     <s:String x:Key="Str_ListViewStatusBar">{0} items, {1} selected</s:String>
     <s:String x:Key="Str_AddSpineObject">Add...</s:String>
-    <s:String x:Key="Str_RemoveSpineObject">Remove</s:String>
+    <s:String x:Key="Str_OpenSkelFileTitle">Select Skeleton File (skel)</s:String>
+    <s:String x:Key="Str_OpenAtlasFileTitle">Select Atlas File (atlas)</s:String>
     <s:String x:Key="Str_AddSpineObjectFromClipboard">Add from Clipboard</s:String>
+    <s:String x:Key="Str_RemoveSpineObject">Remove</s:String>
+    <s:String x:Key="Str_RemoveAllSpineObject">Remove All</s:String>
     <s:String x:Key="Str_Reload">Reload</s:String>
     <s:String x:Key="Str_MoveUpSpineObject">Move Up</s:String>
     <s:String x:Key="Str_MoveDownSpineObject">Move Down</s:String>
@@ -118,7 +121,8 @@
     <s:String x:Key="Str_RenderSelectedOnly">Render Selected Only</s:String>
     <s:String x:Key="Str_ShowAxis">Show Axis</s:String>
     <s:String x:Key="Str_BackgroundColor">Background Color</s:String>
-    <s:String x:Key="Str_BackgroundImage">Background Image</s:String>
+    <s:String x:Key="Str_BackgroundImagePath">Background Image Path</s:String>
+    <s:String x:Key="Str_BackgroundImageMode">Background Image Mode</s:String>
 
     <!-- 渲染画面按钮组 -->
     <s:String x:Key="Str_StopTooltip">Stop</s:String>
@@ -232,6 +236,7 @@
     <s:String x:Key="Str_RendererPreference">Preview Options</s:String>
 
     <s:String x:Key="Str_AppPreference">Application Options</s:String>
+    <s:String x:Key="Str_AssociateFileSuffix">Associate File Extension</s:String>
     <s:String x:Key="Str_Language">Language</s:String>
 
 </ResourceDictionary>

SpineViewer/Resources/Strings/ja.xaml

@@ -37,8 +37,11 @@
     <s:String x:Key="Str_Show">表示</s:String>
     <s:String x:Key="Str_ListViewStatusBar">全{0}件、選択中{1}件</s:String>
     <s:String x:Key="Str_AddSpineObject">追加...</s:String>
-    <s:String x:Key="Str_RemoveSpineObject">削除</s:String>
+    <s:String x:Key="Str_OpenSkelFileTitle">スケルトンファイルを選択（skel）</s:String>
+    <s:String x:Key="Str_OpenAtlasFileTitle">アトラスファイルを選択（atlas）</s:String>
     <s:String x:Key="Str_AddSpineObjectFromClipboard">クリップボードから追加</s:String>
+    <s:String x:Key="Str_RemoveSpineObject">削除</s:String>
+    <s:String x:Key="Str_RemoveAllSpineObject">すべて削除</s:String>
     <s:String x:Key="Str_Reload">再読み込み</s:String>
     <s:String x:Key="Str_MoveUpSpineObject">上へ移動</s:String>
     <s:String x:Key="Str_MoveDownSpineObject">下へ移動</s:String>
@@ -118,7 +121,8 @@
     <s:String x:Key="Str_RenderSelectedOnly">選択のみレンダリング</s:String>
     <s:String x:Key="Str_ShowAxis">座標軸を表示</s:String>
     <s:String x:Key="Str_BackgroundColor">背景色</s:String>
-    <s:String x:Key="Str_BackgroundImage">背景画像</s:String>
+    <s:String x:Key="Str_BackgroundImagePath">背景画像のパス</s:String>
+    <s:String x:Key="Str_BackgroundImageMode">背景画像のモード</s:String>
 
     <!-- 渲染画面按钮组 -->
     <s:String x:Key="Str_StopTooltip">停止</s:String>
@@ -232,6 +236,7 @@
     <s:String x:Key="Str_RendererPreference">プレビュー画面オプション</s:String>
 
     <s:String x:Key="Str_AppPreference">アプリケーションプション</s:String>
+    <s:String x:Key="Str_AssociateFileSuffix">ファイル拡張子を関連付ける</s:String>
     <s:String x:Key="Str_Language">言語</s:String>
 
 </ResourceDictionary>

SpineViewer/Resources/Strings/zh.xaml

@@ -37,8 +37,11 @@
     <s:String x:Key="Str_Show">显示</s:String>
     <s:String x:Key="Str_ListViewStatusBar">共 {0} 项，已选择 {1} 项</s:String>
     <s:String x:Key="Str_AddSpineObject">添加...</s:String>
-    <s:String x:Key="Str_RemoveSpineObject">移除</s:String>
+    <s:String x:Key="Str_OpenSkelFileTitle">选择骨骼文件（skel）</s:String>
+    <s:String x:Key="Str_OpenAtlasFileTitle">选择图集文件（atlas）</s:String>
     <s:String x:Key="Str_AddSpineObjectFromClipboard">从剪贴板添加</s:String>
+    <s:String x:Key="Str_RemoveSpineObject">移除</s:String>
+    <s:String x:Key="Str_RemoveAllSpineObject">移除全部</s:String>
     <s:String x:Key="Str_Reload">重新加载</s:String>
     <s:String x:Key="Str_MoveUpSpineObject">上移</s:String>
     <s:String x:Key="Str_MoveDownSpineObject">下移</s:String>
@@ -118,7 +121,8 @@
     <s:String x:Key="Str_RenderSelectedOnly">仅渲染选中</s:String>
     <s:String x:Key="Str_ShowAxis">显示坐标轴</s:String>
     <s:String x:Key="Str_BackgroundColor">背景颜色</s:String>
-    <s:String x:Key="Str_BackgroundImage">背景图片</s:String>
+    <s:String x:Key="Str_BackgroundImagePath">背景图片路径</s:String>
+    <s:String x:Key="Str_BackgroundImageMode">背景图片模式</s:String>
 
     <!-- 渲染画面按钮组 -->
     <s:String x:Key="Str_StopTooltip">停止</s:String>
@@ -232,6 +236,7 @@
     <s:String x:Key="Str_RendererPreference">预览画面选项</s:String>
 
     <s:String x:Key="Str_AppPreference">应用程序选项</s:String>
+    <s:String x:Key="Str_AssociateFileSuffix">关联文件后缀</s:String>
     <s:String x:Key="Str_Language">语言</s:String>
 
 </ResourceDictionary>

SpineViewer/Services/DialogService.cs

@@ -61,6 +61,18 @@ namespace SpineViewer.Services
             return dialog.ShowDialog() ?? false;
         }
 
+        public static bool ShowOpenFileDialog(out string? fileName, string title = null, string filter = "")
+        {
+            var dialog = new OpenFileDialog() { Title = title, Filter = filter };
+            if (dialog.ShowDialog() is true)
+            {
+                fileName = dialog.FileName;
+                return true;
+            }
+            fileName = null;
+            return false;
+        }
+
         /// <summary>
         /// 获取用户选择的文件夹
         /// </summary>
@@ -78,6 +90,22 @@ namespace SpineViewer.Services
             return false;
         }
 
+        public static bool ShowOpenSFMLImageDialog(out string? fileName, string initialDirectory = "")
+        {
+            var dialog = new OpenFileDialog()
+            {
+                InitialDirectory = initialDirectory,
+                Filter = "SFML Image|*.png;*.jpg;*.jpeg;*.bmp;*.tga|All|*.*"
+            };
+            if (dialog.ShowDialog() is true)
+            {
+                fileName = dialog.FileName;
+                return true;
+            }
+            fileName = null;
+            return false;
+        }
+
         public static bool ShowOpenJsonDialog(out string? fileName, string initialDirectory = "")
         {
             var dialog = new OpenFileDialog()

SpineViewer/SpineViewer.csproj

@@ -7,19 +7,24 @@
         <TargetFramework>net8.0-windows</TargetFramework>
         <BaseOutputPath>$(SolutionDir)out</BaseOutputPath>
         <IncludeSourceRevisionInInformationalVersion>false</IncludeSourceRevisionInInformationalVersion>
-        <Version>0.15.15</Version>
+        <Version>0.15.18</Version>
         <OutputType>WinExe</OutputType>
         <UseWPF>true</UseWPF>
     </PropertyGroup>
 
     <PropertyGroup>
         <NoWarn>$(NoWarn);NETSDK1206</NoWarn>
-        <ApplicationIcon>appicon.ico</ApplicationIcon>
+        <ApplicationIcon>Resources\Images\spineviewer.ico</ApplicationIcon>
         <ApplicationManifest>app.manifest</ApplicationManifest>
     </PropertyGroup>
 
     <ItemGroup>
-      <Content Include="appicon.ico" />
+      <Content Include="Resources\Images\skel.ico">
+        <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+      </Content>
+      <Content Include="Resources\Images\spineviewer.ico">
+        <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>
+      </Content>
     </ItemGroup>
 
     <ItemGroup>

SpineViewer/ViewModels/MainWindow/ExplorerListViewModel.cs

@@ -163,6 +163,7 @@ namespace SpineViewer.ViewModels.MainWindow
                         Size = new(bounds.Width, -bounds.Height),
                         Format = SkiaSharp.SKEncodedImageFormat.Webp,
                         Quality = PreviewQuality,
+                        BackgroundColor = SFML.Graphics.Color.Transparent,
                     };
                     exporter.Export(m.PreviewFilePath, sp);
                 }
@@ -199,6 +200,7 @@ namespace SpineViewer.ViewModels.MainWindow
             {
                 Format = SkiaSharp.SKEncodedImageFormat.Webp,
                 Quality = PreviewQuality,
+                BackgroundColor = SFML.Graphics.Color.Transparent,
             };
             for (int i = 0; i < totalCount; i++)
             {

SpineViewer/ViewModels/MainWindow/MainWindowViewModel.cs

@@ -5,6 +5,7 @@ using SFMLRenderer;
 using SpineViewer.Models;
 using SpineViewer.Services;
 using SpineViewer.Utils;
+using System.Windows;
 using System.Windows.Shell;
 
 namespace SpineViewer.ViewModels.MainWindow
@@ -72,6 +73,8 @@ namespace SpineViewer.ViewModels.MainWindow
         public SFMLRendererViewModel SFMLRendererViewModel => _sfmlRendererViewModel;
         private readonly SFMLRendererViewModel _sfmlRendererViewModel;
 
+        public RelayCommand Cmd_Exit => new(App.Current.Shutdown);
+
         /// <summary>
         /// 打开工作区
         /// </summary>

SpineViewer/ViewModels/MainWindow/PreferenceViewModel.cs

@@ -1,13 +1,16 @@
 using CommunityToolkit.Mvvm.ComponentModel;
 using CommunityToolkit.Mvvm.Input;
+using Microsoft.Win32;
 using NLog;
 using Spine.SpineWrappers;
 using SpineViewer.Models;
+using SpineViewer.Natives;
 using SpineViewer.Services;
 using SpineViewer.Utils;
 using System;
 using System.Collections.Generic;
 using System.Collections.Immutable;
+using System.Diagnostics;
 using System.IO;
 using System.Linq;
 using System.Text;
@@ -23,6 +26,10 @@ namespace SpineViewer.ViewModels.MainWindow
         /// </summary>
         public static readonly string PreferenceFilePath = Path.Combine(Path.GetDirectoryName(Environment.ProcessPath), "preference.json");
 
+        private static readonly string SkelFileDescription = "SpineViewer File";
+        private static readonly string SkelIconFilePath = Path.Combine(App.ProcessDirectory, "Resources\\Images\\skel.ico");
+        private static readonly string ShellOpenCommand = $"\"{App.ProcessPath}\" \"%1\"";
+
         private static readonly Logger _logger = LogManager.GetCurrentClassLogger();
 
         private readonly MainWindowViewModel _vmMain;
@@ -64,8 +71,19 @@ namespace SpineViewer.ViewModels.MainWindow
         public void LoadPreference()
         {
             if (JsonHelper.Deserialize<PreferenceModel>(PreferenceFilePath, out var obj, true))
+            {
+                try
+                {
                     Preference = obj;
                 }
+                catch (Exception ex)
+                {
+
+                    _logger.Trace(ex.ToString());
+                    _logger.Error("Failed to load some prefereneces, {0}", ex.Message);
+                }
+            }
+        }
 
         /// <summary>
         /// 获取参数副本或者进行设置
@@ -94,6 +112,7 @@ namespace SpineViewer.ViewModels.MainWindow
                     DebugClippings = DebugClippings,
 
                     RenderSelectedOnly = RenderSelectedOnly,
+                    AssociateFileSuffix = AssociateFileSuffix,
                     AppLanguage = AppLanguage,
                 };
             }
@@ -118,6 +137,7 @@ namespace SpineViewer.ViewModels.MainWindow
                 DebugClippings = value.DebugClippings;
 
                 RenderSelectedOnly = value.RenderSelectedOnly;
+                AssociateFileSuffix = value.AssociateFileSuffix;
                 AppLanguage = value.AppLanguage;
             }
         }
@@ -230,6 +250,71 @@ namespace SpineViewer.ViewModels.MainWindow
             set => SetProperty(_vmMain.SFMLRendererViewModel.RenderSelectedOnly, value, v => _vmMain.SFMLRendererViewModel.RenderSelectedOnly = v);
         }
 
+        public bool AssociateFileSuffix
+        {
+            get
+            {
+                try
+                {
+                    // 检查 .skel 的 ProgID
+                    using (var key = Registry.CurrentUser.OpenSubKey(@"Software\Classes\.skel"))
+                    {
+                        var progIdValue = key?.GetValue("") as string;
+                        if (!string.Equals(progIdValue, App.ProgId, StringComparison.OrdinalIgnoreCase))
+                            return false;
+                    }
+
+                    // 检查 command 指令是否相同
+                    using (var key = Registry.CurrentUser.OpenSubKey($@"Software\Classes\{App.ProgId}\shell\open\command"))
+                    {
+                        var command = key?.GetValue("") as string;
+                        if (string.IsNullOrWhiteSpace(command))
+                            return false;
+                        return command == ShellOpenCommand;
+                    }
+                }
+                catch
+                {
+                    return false;
+                }
+            }
+            set
+            {
+                SetProperty(AssociateFileSuffix, value, v =>
+                {
+                    if (v)
+                    {
+                        // 文件关联
+                        using (var key = Registry.CurrentUser.CreateSubKey(@"Software\Classes\.skel"))
+                        {
+                            key?.SetValue("", App.ProgId);
+                        }
+
+                        using (var key = Registry.CurrentUser.CreateSubKey($@"Software\Classes\{App.ProgId}"))
+                        {
+                            key?.SetValue("", SkelFileDescription);
+                            using (var iconKey = key?.CreateSubKey("DefaultIcon"))
+                            {
+                                iconKey?.SetValue("", $"\"{SkelIconFilePath}\"");
+                            }
+                            using (var shellKey = key?.CreateSubKey(@"shell\open\command"))
+                            {
+                                shellKey?.SetValue("", ShellOpenCommand);
+                            }
+                        }
+                    }
+                    else
+                    {
+                        // 删除关联
+                        Registry.CurrentUser.DeleteSubKeyTree(@"Software\Classes\.skel", false);
+                        Registry.CurrentUser.DeleteSubKeyTree($@"Software\Classes\{App.ProgId}", false);
+                    }
+
+                    Shell32.NotifyAssociationChanged();
+                });
+            }
+        }
+
         public AppLanguage AppLanguage
         {
             get => ((App)App.Current).Language;

SpineViewer/ViewModels/MainWindow/SFMLRendererViewModel.cs

@@ -10,8 +10,10 @@ using SpineViewer.Services;
 using SpineViewer.Utils;
 using System;
 using System.Collections.Generic;
+using System.Collections.Immutable;
 using System.Collections.Specialized;
 using System.Diagnostics;
+using System.IO;
 using System.Linq;
 using System.Text;
 using System.Threading.Tasks;
@@ -23,6 +25,8 @@ namespace SpineViewer.ViewModels.MainWindow
 {
     public class SFMLRendererViewModel : ObservableObject
     {
+        public ImmutableArray<Stretch> StretchOptions { get; } = Enum.GetValues<Stretch>().ToImmutableArray();
+
         /// <summary>
         /// 日志器
         /// </summary>
@@ -69,6 +73,13 @@ namespace SpineViewer.ViewModels.MainWindow
         private float _forwardDelta = 0;
         private readonly object _forwardDeltaLock = new();
 
+        /// <summary>
+        /// 背景图片
+        /// </summary>
+        private SFML.Graphics.Sprite? _backgroundImageSprite; // XXX: 暂时未使用 Dispose 释放
+        private SFML.Graphics.Texture? _backgroundImageTexture; // XXX: 暂时未使用 Dispose 释放
+        private readonly object _bgLock = new();
+
         /// <summary>
         /// 临时变量, 记录拖放世界源点
         /// </summary>
@@ -169,6 +180,64 @@ namespace SpineViewer.ViewModels.MainWindow
         }
         private SFML.Graphics.Color _backgroundColor = new(105, 105, 105);
 
+        public string BackgroundImagePath
+        {
+            get => _backgroundImagePath;
+            set => SetProperty(_backgroundImagePath, value, v =>
+            {
+                if (string.IsNullOrWhiteSpace(v))
+                {
+                    lock (_bgLock)
+                    {
+                        _backgroundImageSprite?.Dispose();
+                        _backgroundImageTexture?.Dispose();
+                        _backgroundImageTexture = null;
+                        _backgroundImageSprite = null;
+                    }
+                    _backgroundImagePath = v;
+                }
+                else
+                {
+                    if (!File.Exists(v))
+                    {
+                        _logger.Warn("Omit non-existed background image path, {0}", v);
+                        return;
+                    }
+                    SFML.Graphics.Texture tex = null;
+                    SFML.Graphics.Sprite sprite = null;
+                    try
+                    {
+                        tex = new(v);
+                        sprite = new(tex) { Origin = new(tex.Size.X / 2f, tex.Size.Y / 2f) };
+                        lock (_bgLock)
+                        {
+                            _backgroundImageSprite?.Dispose();
+                            _backgroundImageTexture?.Dispose();
+                            _backgroundImageTexture = tex;
+                            _backgroundImageSprite = sprite;
+                        }
+                        _backgroundImagePath = v;
+                        _logger.Info("Load background image from {0}", v);
+                        _logger.LogCurrentProcessMemoryUsage();
+                    }
+                    catch (Exception ex)
+                    {
+                        sprite?.Dispose();
+                        tex?.Dispose();
+                        _logger.Error("Failed to load background image from path: {0}, {1}", v, ex.Message);
+                    }
+                }
+            });
+        }
+        private string _backgroundImagePath;
+
+        public Stretch BackgroundImageMode
+        {
+            get => _backgroundImageMode;
+            set => SetProperty(ref _backgroundImageMode, value);
+        }
+        private Stretch _backgroundImageMode = Stretch.Uniform;
+
         public bool RenderSelectedOnly
         {
             get => _renderSelectedOnly;
@@ -189,6 +258,14 @@ namespace SpineViewer.ViewModels.MainWindow
         }
         private bool _isUpdating = true;
 
+        public RelayCommand Cmd_SelectBackgroundImage => _cmd_SelectBackgroundImage ??= new(() =>
+        {
+            if (!DialogService.ShowOpenSFMLImageDialog(out var fileName))
+                return;
+            BackgroundImagePath = fileName;
+        });
+        private RelayCommand? _cmd_SelectBackgroundImage;
+
         public RelayCommand Cmd_Stop => _cmd_Stop ??= new(() =>
         {
             IsUpdating = false;
@@ -386,6 +463,38 @@ namespace SpineViewer.ViewModels.MainWindow
 
                     _renderer.Clear(_backgroundColor);
 
+                    // 渲染背景
+                    lock (_bgLock)
+                    {
+                        if (_backgroundImageSprite is not null)
+                        {
+                            using var view = _renderer.GetView();
+                            var bg = _backgroundImageSprite;
+                            var viewSize = view.Size;
+                            var bgSize = bg.Texture.Size;
+                            var scaleX = Math.Abs(viewSize.X / bgSize.X);
+                            var scaleY = Math.Abs(viewSize.Y / bgSize.Y);
+                            var signX = Math.Sign(viewSize.X);
+                            var signY = Math.Sign(viewSize.Y);
+                            if (_backgroundImageMode == Stretch.None)
+                            {
+                                scaleX = scaleY = 1f / _renderer.Zoom;
+                            }
+                            else if (_backgroundImageMode == Stretch.Uniform)
+                            {
+                                scaleX = scaleY = Math.Min(scaleX, scaleY);
+                            }
+                            else if (_backgroundImageMode == Stretch.UniformToFill)
+                            {
+                                scaleX = scaleY = Math.Max(scaleX, scaleY);
+                            }
+                            bg.Scale = new(signX * scaleX, signY * scaleY);
+                            bg.Position = view.Center;
+                            bg.Rotation = view.Rotation;
+                            _renderer.Draw(bg);
+                        }
+                    }
+
                     if (_showAxis)
                     {
                         // 画一个很长的坐标轴, 用 1e9 比较合适
@@ -442,7 +551,6 @@ namespace SpineViewer.ViewModels.MainWindow
 
         public RendererWorkspaceConfigModel WorkspaceConfig
         {
-            // TODO: 背景图片
             get
             {
                 return new()
@@ -459,6 +567,8 @@ namespace SpineViewer.ViewModels.MainWindow
                     Speed = Speed,
                     ShowAxis = ShowAxis,
                     BackgroundColor = BackgroundColor,
+                    BackgroundImagePath = BackgroundImagePath,
+                    BackgroundImageMode = BackgroundImageMode,
                 };
             }
             set
@@ -474,6 +584,8 @@ namespace SpineViewer.ViewModels.MainWindow
                 Speed = value.Speed;
                 ShowAxis = value.ShowAxis;
                 BackgroundColor = value.BackgroundColor;
+                BackgroundImagePath = value.BackgroundImagePath;
+                BackgroundImageMode = value.BackgroundImageMode;
             }
         }
     }

SpineViewer/ViewModels/MainWindow/SpineObjectListViewModel.cs

@@ -107,7 +107,12 @@ namespace SpineViewer.ViewModels.MainWindow
 
         private void AddSpineObject_Execute()
         {
-            MessagePopupService.Info("Not Implemented, please drag files into here or add them from clipboard :)");
+            if (!DialogService.ShowOpenFileDialog(out var skelFileName, AppResource.Str_OpenSkelFileTitle))
+                return;
+            if (!DialogService.ShowOpenFileDialog(out var atlasFileName, AppResource.Str_OpenAtlasFileTitle))
+                return;
+            AddSpineObject(skelFileName, atlasFileName);
+            _logger.LogCurrentProcessMemoryUsage();
         }
 
         /// <summary>
@@ -144,6 +149,34 @@ namespace SpineViewer.ViewModels.MainWindow
             return true;
         }
 
+        /// <summary>
+        /// 移除全部模型
+        /// </summary>
+        public RelayCommand<IList?> Cmd_RemoveAllSpineObject => _cmd_RemoveAllSpineObject ??= new(RemoveAllSpineObject_Execute, RemoveAllSpineObject_CanExecute);
+        private RelayCommand<IList?>? _cmd_RemoveAllSpineObject;
+
+        private void RemoveAllSpineObject_Execute(IList? args)
+        {
+            if (!RemoveAllSpineObject_CanExecute(args)) return;
+
+            if (!MessagePopupService.Quest(string.Format(AppResource.Str_RemoveItemsQuest, args.Count)))
+                return;
+
+            lock (_spineObjectModels.Lock)
+            {
+                foreach (var sp in _spineObjectModels)
+                    sp.Dispose();
+                _spineObjectModels.Clear();
+            }
+        }
+
+        private bool RemoveAllSpineObject_CanExecute(IList? args)
+        {
+            if (args is null) return false;
+            if (args.Count <= 0) return false;
+            return true;
+        }
+
         /// <summary>
         /// 从剪贴板文件列表添加模型
         /// </summary>
@@ -463,7 +496,7 @@ namespace SpineViewer.ViewModels.MainWindow
             {
                 if (ct.IsCancellationRequested) break;
 
-                var skelPath = paths[i];
+                var skelPath = paths[totalCount - 1 - i]; // 从后往前添加, 每次插入到列表的第一个
                 reporter.ProgressText = $"[{i}/{totalCount}] {skelPath}";
 
                 if (AddSpineObject(skelPath))
@@ -486,7 +519,7 @@ namespace SpineViewer.ViewModels.MainWindow
         }
 
         /// <summary>
-        /// 安全地在末尾添加一个模型, 发生错误会输出日志
+        /// 安全地在列表头添加一个模型, 发生错误会输出日志
         /// </summary>
         /// <returns>是否添加成功</returns>
         private bool AddSpineObject(string skelPath, string? atlasPath = null)
@@ -494,7 +527,7 @@ namespace SpineViewer.ViewModels.MainWindow
             try
             {
                 var sp = new SpineObjectModel(skelPath, atlasPath);
-                lock (_spineObjectModels.Lock) _spineObjectModels.Add(sp);
+                lock (_spineObjectModels.Lock) _spineObjectModels.Insert(0, sp);
                 if (Application.Current.Dispatcher.CheckAccess())
                 {
                     RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Reset));
@@ -518,35 +551,6 @@ namespace SpineViewer.ViewModels.MainWindow
             return false;
         }
 
-        private bool AddSpineObject(SpineObjectWorkspaceConfigModel cfg)
-        {
-            try
-            {
-                var sp = new SpineObjectModel(cfg);
-                lock (_spineObjectModels.Lock) _spineObjectModels.Add(sp);
-                if (Application.Current.Dispatcher.CheckAccess())
-                {
-                    RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Reset));
-                    RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Add, sp));
-                }
-                else
-                {
-                    Application.Current.Dispatcher.Invoke(() =>
-                    {
-                        RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Reset));
-                        RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Add, sp));
-                    });
-                }
-                return true;
-            }
-            catch (Exception ex)
-            {
-                _logger.Trace(ex.ToString());
-                _logger.Error("Failed to load: {0}, {1}", cfg.SkelPath, ex.Message);
-            }
-            return false;
-        }
-
         public List<SpineObjectWorkspaceConfigModel> LoadedSpineObjects
         {
             get
@@ -609,7 +613,7 @@ namespace SpineViewer.ViewModels.MainWindow
             {
                 if (ct.IsCancellationRequested) break;
 
-                var cfg = models[i];
+                var cfg = models[totalCount - 1 - i]; // 从后往前添加, 每次插入到列表的第一个
                 reporter.ProgressText = $"[{i}/{totalCount}] {cfg}";
 
                 if (AddSpineObject(cfg))
@@ -637,5 +641,38 @@ namespace SpineViewer.ViewModels.MainWindow
                     sp.ResetAnimationsTime();
             }
         }
+
+        /// <summary>
+        /// 安全地在列表头添加一个模型, 发生错误会输出日志
+        /// </summary>
+        /// <returns>是否添加成功</returns>
+        private bool AddSpineObject(SpineObjectWorkspaceConfigModel cfg)
+        {
+            try
+            {
+                var sp = new SpineObjectModel(cfg);
+                lock (_spineObjectModels.Lock) _spineObjectModels.Insert(0, sp);
+                if (Application.Current.Dispatcher.CheckAccess())
+                {
+                    RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Reset));
+                    RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Add, sp));
+                }
+                else
+                {
+                    Application.Current.Dispatcher.Invoke(() =>
+                    {
+                        RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Reset));
+                        RequestSelectionChanging?.Invoke(this, new(NotifyCollectionChangedAction.Add, sp));
+                    });
+                }
+                return true;
+            }
+            catch (Exception ex)
+            {
+                _logger.Trace(ex.ToString());
+                _logger.Error("Failed to load: {0}, {1}", cfg.SkelPath, ex.Message);
+            }
+            return false;
+        }
     }
 }

SpineViewer/Views/MainWindow.xaml

@@ -9,6 +9,7 @@
         xmlns:utils="clr-namespace:SpineViewer.Utils"
         xmlns:SFMLRenderer="clr-namespace:SFMLRenderer;assembly=SFMLRenderer"
         mc:Ignorable="d"
+        x:Name="_mainWindow"
         Title="{Binding Title}"
         Width="1500"
         Height="800"
@@ -147,13 +148,16 @@
                                                 <ContextMenu>
                                                     <MenuItem Header="{DynamicResource Str_AddSpineObject}"
                                                               Command="{Binding Cmd_AddSpineObject}"/>
+                                                    <MenuItem Header="{DynamicResource Str_AddSpineObjectFromClipboard}"
+                                                              InputGestureText="Ctrl+V"
+                                                              Command="{Binding Cmd_AddSpineObjectFromClipboard}"/>
                                                     <MenuItem Header="{DynamicResource Str_RemoveSpineObject}"
                                                               InputGestureText="Delete"
                                                               Command="{Binding Cmd_RemoveSpineObject}"
                                                               CommandParameter="{Binding PlacementTarget.SelectedItems, RelativeSource={RelativeSource AncestorType={x:Type ContextMenu}}}"/>
-                                                    <MenuItem Header="{DynamicResource Str_AddSpineObjectFromClipboard}"
+                                                    <MenuItem Header="{DynamicResource Str_RemoveAllSpineObject}"
-                                                              InputGestureText="Ctrl+V"
+                                                              Command="{Binding Cmd_RemoveAllSpineObject}"
-                                                              Command="{Binding Cmd_AddSpineObjectFromClipboard}"/>
+                                                              CommandParameter="{Binding PlacementTarget.Items, RelativeSource={RelativeSource AncestorType={x:Type ContextMenu}}}"/>
                                                     <MenuItem Header="{DynamicResource Str_Reload}"
                                                               InputGestureText="Ctrl+R"
                                                               Command="{Binding Cmd_ReloadSpineObject}"
@@ -723,6 +727,8 @@
                                         <RowDefinition Height="Auto"/>
                                         <RowDefinition Height="Auto"/>
                                         <RowDefinition Height="Auto"/>
+                                        <RowDefinition Height="Auto"/>
+                                        <RowDefinition Height="Auto"/>
                                     </Grid.RowDefinitions>
 
                                     <!-- 水平分辨率 -->
@@ -776,7 +782,15 @@
                                     <TextBox Grid.Row="12" Grid.Column="1" Text="{Binding BackgroundColor}" ToolTip="#AARRGGBB"/>
 
                                     <!-- 背景图案 -->
+                                    <Label Grid.Row="13" Grid.Column="0" Content="{DynamicResource Str_BackgroundImagePath}"/>
+                                    <DockPanel Grid.Row="13" Grid.Column="1" >
+                                        <Button DockPanel.Dock="Right" Content="..." Command="{Binding Cmd_SelectBackgroundImage}"/>
+                                        <TextBox Text="{Binding BackgroundImagePath}"/>
+                                    </DockPanel>
+
                                     <!-- 背景图案模式 -->
+                                    <Label Grid.Row="14" Grid.Column="0" Content="{DynamicResource Str_BackgroundImageMode}"/>
+                                    <ComboBox Grid.Row="14" Grid.Column="1" SelectedValue="{Binding BackgroundImageMode}" ItemsSource="{Binding StretchOptions}"/>
                                 </Grid>
                             </TabItem>
                         </TabControl>
@@ -918,6 +932,21 @@
                    Opened="BottomPopup_Opened"
                    MouseLeave="PopupContainer_MouseLeave"/>
         </Grid>
+
+        <!-- 非可视元素通知栏图标 -->
+        <hc:NotifyIcon x:Name="_notifyIcon"
+                       Icon="/Resources/Images/spineviewer.ico"
+                       Click="_notifyIcon_Click"
+                       MouseDoubleClick="_notifyIcon_MouseDoubleClick">
+            <hc:NotifyIcon.ContextMenu>
+                <ContextMenu>
+                    <MenuItem Header="There may be a funtion :)" IsChecked="True"/>
+                    <Separator/>
+                    <MenuItem Header="{DynamicResource Str_Exit}" Command="{Binding Cmd_Exit}"/>
+                </ContextMenu>
+            </hc:NotifyIcon.ContextMenu>
+        </hc:NotifyIcon>
+
     </Grid>
 
 </Window>

SpineViewer/Views/MainWindow.xaml.cs

@@ -44,11 +44,13 @@ public partial class MainWindow : Window
     {
         InitializeComponent();
         InitializeLogConfiguration();
-        _vm = new (_renderPanel);
+        DataContext = _vm = new(_renderPanel);
-        DataContext = _vm;
+        _notifyIcon.Text = _vm.Title; // XXX: hc 的 NotifyIcon 的 Text 似乎没法双向绑定
+
         _vm.SpineObjectListViewModel.RequestSelectionChanging += SpinesListView_RequestSelectionChanging;
         _vm.SFMLRendererViewModel.RequestSelectionChanging += SpinesListView_RequestSelectionChanging;
         Loaded += MainWindow_Loaded;
+        ContentRendered += MainWindow_ContentRendered;
         Closed += MainWindow_Closed;
     }
 
@@ -56,7 +58,7 @@ public partial class MainWindow : Window
     {
         var vm = _vm.SFMLRendererViewModel;
         _renderPanel.CanvasMouseWheelScrolled += vm.CanvasMouseWheelScrolled;
-        _renderPanel.CanvasMouseButtonPressed += vm.CanvasMouseButtonPressed;
+        _renderPanel.CanvasMouseButtonPressed += (s, e) => { vm.CanvasMouseButtonPressed(s, e); _spinesListView.Focus(); }; // 用户点击画布后强制转移焦点至列表
         _renderPanel.CanvasMouseMove += vm.CanvasMouseMove;
         _renderPanel.CanvasMouseButtonReleased += vm.CanvasMouseButtonReleased;
 
@@ -75,6 +77,16 @@ public partial class MainWindow : Window
         LoadLastState();
     }
 
+    private void MainWindow_ContentRendered(object? sender, EventArgs e)
+    {
+        string[] args = Environment.GetCommandLineArgs();
+        if (args.Length > 1)
+        {
+            string[] filePaths = args.Skip(1).ToArray();
+            _vm.SpineObjectListViewModel.AddSpineObjectFromFileList(filePaths);
+        }
+    }
+
     private void MainWindow_Closed(object? sender, EventArgs e)
     {
         SaveLastState();
@@ -83,6 +95,14 @@ public partial class MainWindow : Window
         vm.StopRender();
     }
 
+    /// <summary>
+    /// 给管道通信提供的打开文件外部调用方法
+    /// </summary>
+    public void OpenFiles(IEnumerable<string> filePaths)
+    {
+        _vm.SpineObjectListViewModel.AddSpineObjectFromFileList(filePaths);
+    }
+
     /// <summary>
     /// 初始化窗口日志器
     /// </summary>
@@ -92,14 +112,13 @@ public partial class MainWindow : Window
         var rtbTarget = new NLog.Windows.Wpf.RichTextBoxTarget
         {
             Name = "rtbTarget",
-            FormName = GetType().Name,
+            WindowName = _mainWindow.Name,
             ControlName = _loggerRichTextBox.Name,
             AutoScroll = true,
             MaxLines = 3000,
-            Layout = "[${level:format=OneLetter}]${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${message}"
+            Layout = "[${level:format=OneLetter}]${date:format=yyyy-MM-dd HH\\:mm\\:ss} - ${message}",
         };
 
-        // TODO: 完善日志实现
         rtbTarget.WordColoringRules.Add(new("[D]", "Gray", "Empty"));
         rtbTarget.WordColoringRules.Add(new("[I]", "DimGray", "Empty"));
         rtbTarget.WordColoringRules.Add(new("[W]", "DarkOrange", "Empty"));
@@ -130,7 +149,7 @@ public partial class MainWindow : Window
 
             _rootGrid.ColumnDefinitions[0].Width = new(m.RootGridCol0Width);
             _modelListGrid.RowDefinitions[0].Height = new(m.ModelListRow0Height);
-            _explorerGrid.RowDefinitions[0].Height = new(m.ExplorerGridRow0Height);
+            if (m.ExplorerGridRow0Height > 0) _explorerGrid.RowDefinitions[0].Height = new(m.ExplorerGridRow0Height);
             _rightPanelGrid.RowDefinitions[0].Height = new(m.RightPanelGridRow0Height);
 
             _vm.SFMLRendererViewModel.SetResolution(m.ResolutionX, m.ResolutionY);
@@ -138,8 +157,9 @@ public partial class MainWindow : Window
             _vm.SFMLRendererViewModel.Speed = m.Speed;
             _vm.SFMLRendererViewModel.ShowAxis = m.ShowAxis;
             _vm.SFMLRendererViewModel.BackgroundColor = m.BackgroundColor;
+            _vm.SFMLRendererViewModel.BackgroundImagePath = m.BackgroundImagePath;
+            _vm.SFMLRendererViewModel.BackgroundImageMode = m.BackgroundImageMode;
         }
-        
     }
 
     private void SaveLastState()
@@ -163,6 +183,8 @@ public partial class MainWindow : Window
             Speed = _vm.SFMLRendererViewModel.Speed,
             ShowAxis = _vm.SFMLRendererViewModel.ShowAxis,
             BackgroundColor = _vm.SFMLRendererViewModel.BackgroundColor,
+            BackgroundImagePath = _vm.SFMLRendererViewModel.BackgroundImagePath,
+            BackgroundImageMode = _vm.SFMLRendererViewModel.BackgroundImageMode,
         };
 
         JsonHelper.Serialize(m, LastStateFilePath);
@@ -193,6 +215,9 @@ public partial class MainWindow : Window
             default:
                 break;
         }
+
+        // 如果选中项发生变化也强制转移焦点
+        _spinesListView.Focus();
     }
 
     private void SpinesListView_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
@@ -293,6 +318,31 @@ public partial class MainWindow : Window
 
     #endregion
 
+    #region _spineFilesListBox 事件
+
+    private void SpineFilesListBox_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
+    {
+        var list = (ListBox)sender;
+        if (VisualUpwardSearch<ListBoxItem>(e.OriginalSource as DependencyObject) is null)
+            list.SelectedItems.Clear();
+    }
+
+    #endregion
+
+    #region _nofityIcon 事件处理
+
+    private void _notifyIcon_Click(object sender, RoutedEventArgs e)
+    {
+
+    }
+
+    private void _notifyIcon_MouseDoubleClick(object sender, RoutedEventArgs e)
+    {
+
+    }
+
+    #endregion
+
     #region 切换全屏布局事件处理
 
     private void SwitchToFullScreenLayout()
@@ -302,7 +352,7 @@ public partial class MainWindow : Window
         if (_fullScreenLayout.Visibility == Visibility.Visible) return;
 
         IntPtr hwnd = new WindowInteropHelper(this).Handle;
-        if (Win32.GetScreenResolution(hwnd, out var resX, out var resY))
+        if (User32.GetScreenResolution(hwnd, out var resX, out var resY))
         {
             _vm.SFMLRendererViewModel.SetResolution(resX, resY);
         }
@@ -550,11 +600,4 @@ public partial class MainWindow : Window
     }
 
     #endregion
-
-    private void SpineFilesListBox_MouseLeftButtonDown(object sender, MouseButtonEventArgs e)
-    {
-        var list = (ListBox)sender;
-        if (VisualUpwardSearch<ListBoxItem>(e.OriginalSource as DependencyObject) is null)
-            list.SelectedItems.Clear();
-    }
 }

SpineViewer/Views/PreferenceDialog.xaml

@@ -143,13 +143,17 @@
                             <Grid.RowDefinitions>
                                 <RowDefinition Height="Auto"/>
                                 <RowDefinition Height="Auto"/>
+                                <RowDefinition Height="Auto"/>
                             </Grid.RowDefinitions>
 
                             <Label Grid.Row="0" Grid.Column="0" Content="{DynamicResource Str_RenderSelectedOnly}"/>
                             <ToggleButton Grid.Row="0" Grid.Column="1" IsChecked="{Binding RenderSelectedOnly}"/>
 
-                            <Label Grid.Row="1" Grid.Column="0" Content="{DynamicResource Str_Language}"/>
+                            <Label Grid.Row="1" Grid.Column="0" Content="{DynamicResource Str_AssociateFileSuffix}"/>
-                            <ComboBox Grid.Row="1" Grid.Column="1"
+                            <ToggleButton Grid.Row="1" Grid.Column="1" IsChecked="{Binding AssociateFileSuffix}"/>
+
+                            <Label Grid.Row="2" Grid.Column="0" Content="{DynamicResource Str_Language}"/>
+                            <ComboBox Grid.Row="2" Grid.Column="1"
                                       SelectedItem="{Binding AppLanguage}"
                                       ItemsSource="{x:Static vm:PreferenceViewModel.AppLanguageOptions}"/>