update readme

This commit is contained in:
ww-rm
2025-09-30 11:12:06 +08:00
parent 6742dacaf2
commit 48d46afcff
4 changed files with 58 additions and 40 deletions

View File

@@ -8,29 +8,30 @@
A simple and user-friendly Spine file viewer and exporter with multi-language support (Chinese/English/Japanese). A simple and user-friendly Spine file viewer and exporter with multi-language support (Chinese/English/Japanese).
![previewer](img/preview.webp) ![previewer](https://github.com/user-attachments/assets/f2663975-63b9-4b90-93f2-af57be1c64b2)
## Features ## Features
* Supports multiple versions of Spine files. - Multiple versions of Spine files
* Batch open files via drag-and-drop or copy-paste. - Batch file opening via drag-and-drop or copy-paste
* Batch preview functionality. - Batch preview
* List-based multi-skeleton viewing and render order management. - List-based multi-skeleton viewing and render order management
* Batch adjustment of skeleton parameters using multi-selection. - Multi-selection in lists for batch skeleton parameter settings
* Multi-track animation settings. - Multi-track animation settings
* Skin and custom slot attachment settings. - Skin and custom slot attachment settings
* Custom slot visibility settings. - Custom slot visibility
* Debug rendering support. - Debug rendering
* View/model/track time scale adjustment. - Playback speed adjustment for view/model/track timelines
* Track alpha blending parameter settings. - Track alpha blending parameter settings
* Fullscreen preview mode. - Fullscreen preview
* Export to single frame/image sequence/animated GIF/video formats. - Export to single frame, image sequence, animated GIF, or video file
* Automatic resolution batch export. - Automatic resolution batch export
* FFmpeg custom export support. - Custom export with FFmpeg
* Program parameter saving. - Program parameter saving
* File name extension association. - File extension association
* Supports texture image formats other than PNG. - Texture images in formats other than PNG
* ... - Launch at startup with persistent dynamic wallpaper
- ......
### Supported Spine Versions ### Supported Spine Versions
@@ -78,14 +79,14 @@ In the menu, go to "File" -> "Preferences..." -> "Language," select your desired
The program is organized into a left-right layout: The program is organized into a left-right layout:
* **Left Panel:** Functionality panel. - **Left Panel:** Functionality panel.
* **Right Panel:** Preview display. - **Right Panel:** Preview display.
The left panel includes three sub-panels: The left panel includes three sub-panels:
* **Browse:** Preview the content of a specified folder without importing files into the program. This panel allows generating `.webp` previews for models or importing selected models. - **Browse:** Preview the content of a specified folder without importing files into the program. This panel allows generating `.webp` previews for models or importing selected models.
* **Model:** Lists imported models for rendering. Parameters and rendering order can be adjusted here, along with other model-related functionalities. - **Model:** Lists imported models for rendering. Parameters and rendering order can be adjusted here, along with other model-related functionalities.
* **Display:** Adjust parameters for the right-side preview display. - **Display:** Adjust parameters for the right-side preview display.
Hover your mouse over buttons, labels, or input fields to see help text for most UI elements. Hover your mouse over buttons, labels, or input fields to see help text for most UI elements.
@@ -101,10 +102,10 @@ The Model panel supports right-click menus, some shortcuts, and batch adjustment
For preview display adjustments: For preview display adjustments:
* **Left-click:** Select and drag models. Hold `Ctrl` for multi-selection, synchronized with the left-side list. - **Left-click:** Select and drag models. Hold `Ctrl` for multi-selection, synchronized with the left-side list.
* **Right-click:** Drag the entire display. - **Right-click:** Drag the entire display.
* **Scroll wheel:** Zoom in/out. Hold `Ctrl` to scale selected models. - **Scroll wheel:** Zoom in/out. Hold `Ctrl` to scale selected models.
* **Render selected-only mode:** In this mode, the preview only shows selected models, and selection status can only be changed via the left-side list. - **Render selected-only mode:** In this mode, the preview only shows selected models, and selection status can only be changed via the left-side list.
The buttons below the preview display allow time adjustments, serving as a simple playback control. The buttons below the preview display allow time adjustments, serving as a simple playback control.
@@ -116,9 +117,17 @@ Use the right-click menu in the Model panel to export selected items.
Key export parameters include: Key export parameters include:
* **Output folder:** Optional. When not specified, output is saved to the respective model folder; otherwise, all output is saved to the provided folder. - **Output folder:** Optional. When not specified, output is saved to the respective model folder; otherwise, all output is saved to the provided folder.
* **Export single:** By default, each model is exported independently. Selecting "Export single" renders all selected models in a single frame, producing a unified output. - **Export single:** By default, each model is exported independently. Selecting "Export single" renders all selected models in a single frame, producing a unified output.
* **Auto resolution:** Ignores the preview resolution and viewport parameters, exporting output at the actual size of the content. For animations/videos, the output matches the size required for full visibility. - **Auto resolution:** Ignores the preview resolution and viewport parameters, exporting output at the actual size of the content. For animations/videos, the output matches the size required for full visibility.
### Dynamic Wallpaper
Dynamic wallpaper is implemented through desktop projection, allowing the content of the current preview to be projected onto the desktop in real time.
You can enable or disable desktop projection from the program preferences or the right-click menu of the tray icon. After adjusting the model and display parameters, you can save the current configuration as a workspace file for convenient restoration later.
If you want the wallpaper to stay active after startup, you can enable auto-start in the preferences and specify which workspace file should be loaded when the program launches.
### More Information ### More Information
@@ -126,12 +135,12 @@ For detailed usage and documentation, see the [Wiki](https://github.com/ww-rm/Sp
## Acknowledgements ## Acknowledgements
* [spine-runtimes](https://github.com/EsotericSoftware/spine-runtimes) - [spine-runtimes](https://github.com/EsotericSoftware/spine-runtimes)
* [SFML.Net](https://github.com/SFML/SFML.Net) - [SFML.Net](https://github.com/SFML/SFML.Net)
* [FFMpegCore](https://github.com/rosenbjerg/FFMpegCore) - [FFMpegCore](https://github.com/rosenbjerg/FFMpegCore)
* [HandyControl](https://github.com/HandyOrg/HandyControl) - [HandyControl](https://github.com/HandyOrg/HandyControl)
* [NLog](https://github.com/NLog/NLog) - [NLog](https://github.com/NLog/NLog)
* [SkiaSharp](https://github.com/mono/SkiaSharp) - [SkiaSharp](https://github.com/mono/SkiaSharp)
--- ---

View File

@@ -6,9 +6,9 @@
[中文](README.md) | [English](README.en.md) [中文](README.md) | [English](README.en.md)
一个简单好用的 Spine 文件查看&导出程序, 支持中/英/日多语言界面. Spine 文件查看&导出程序, 同时也是支持 Spine 的动态壁纸程序.
![previewer](img/preview.webp) ![previewer](https://github.com/user-attachments/assets/f2663975-63b9-4b90-93f2-af57be1c64b2)
## 功能 ## 功能
@@ -30,6 +30,7 @@
- 支持程序参数保存 - 支持程序参数保存
- 支持文件后缀关联 - 支持文件后缀关联
- 支持非 png 格式的纹理图片格式 - 支持非 png 格式的纹理图片格式
- 支持开机自启常驻动态壁纸
- ...... - ......
### Spine 版本支持 ### Spine 版本支持
@@ -117,6 +118,14 @@
- 导出单个. 默认是每个模型独立导出, 即对模型列表进行批量操作, 如果选择仅导出单个, 那么被导出的所有模型将在同一个画面上被渲染, 输出产物只有一份. - 导出单个. 默认是每个模型独立导出, 即对模型列表进行批量操作, 如果选择仅导出单个, 那么被导出的所有模型将在同一个画面上被渲染, 输出产物只有一份.
- 自动分辨率. 该模式会忽略预览画面的分辨率和视区参数, 导出产物的分辨率与被导出内容的实际大小一致, 如果是动图或者视频则会与完整显示动画的必需大小一致. - 自动分辨率. 该模式会忽略预览画面的分辨率和视区参数, 导出产物的分辨率与被导出内容的实际大小一致, 如果是动图或者视频则会与完整显示动画的必需大小一致.
### 动态壁纸
动态壁纸通过桌面投影实现, 可以将当前预览画面上的内容实时投影至桌面.
在程序首选项或者托盘图标右键菜单中可以进行桌面投影的启用与否, 模型和画面参数调整完成后, 可以将当前参数保存为工作区文件, 方便之后恢复该配置.
如果希望开机自启常驻壁纸, 也可以在首选项中启用开机自启, 并且设置启动后需要加载的工作区文件.
### 更多 ### 更多
更为详细的使用方法和说明见 [Wiki](https://github.com/ww-rm/SpineViewer/wiki), 有使用上的问题或者 BUG 可以提个 [Issue](https://github.com/ww-rm/SpineViewer/issues). 更为详细的使用方法和说明见 [Wiki](https://github.com/ww-rm/SpineViewer/wiki), 有使用上的问题或者 BUG 可以提个 [Issue](https://github.com/ww-rm/SpineViewer/issues).

Binary file not shown.

Before

Width:  |  Height:  |  Size: 177 KiB

Binary file not shown.

Before

Width:  |  Height:  |  Size: 2.2 KiB