ukui-theme-customizer/README.md

# 主题制作工坊软件介绍
## 1. 软件概述  
### 1.1 背景与意义  
主题制作工坊是一款专为 openKylin 系统设计的定制主题软件，旨在提供用户一个灵活且直观的工具，使其能够轻松定制个性化的系统外观。openKylin 操作系统以其开源、自由的特性受到广泛欢迎，然而，用户个性化的需求也随之增长。本工坊的推出旨在满足用户对系统外观的高度自定义需求，为其提供一个简便而功能丰富的定制平台。  
  
### 1.2 优势与特点
#### 1.2.1 多元主题修改  
主题制作工坊不仅提供全局主题的修改，还涵盖图标、光标、开机动画和 grub 界面等多个方面的定制。这一全面的主题修改功能使用户能够全方位地打造独一无二的系统外观。  
  
#### 1.2.2 直观用户界面    
软件采用直观、用户友好的界面设计，使得即使是初学者也能轻松上手。各个主题模块的设置清晰可见，用户通过简单的点击和拖拽即可完成各项修改，无需深入了解复杂的技术细节。  
  
#### 1.2.3 支持多种格式  
壁纸模块支持 PNG 图片格式和 JPG 图片格式、开机动画模块支持 MP4 文件格式和 PNG 图片格式，为用户提供了更大的自由度。用户可以选择符合自己审美和需求的多种媒体格式。  
  
### 1.3 实时预览    
#### 1.3.1 即时生效  
用户在自定义主题设置中的每次修改都会立即反映在预览界面上。  
实时交互： 用户可以动态地查看和评估他们对主题的各种调整。  
  
#### 1.3.2 用户体验  
可视反馈： 提供实时预览，使用户能够直观地了解其对主题的修改效果，减少了试错的可能性。  
定制性体验： 用户可以根据实际需求调整主题设置，通过实时预览迅速找到最满意的外观。  
用户满意度： 增加用户满意度，因为他们能够在调整主题时立即看到结果，而无需不断保存和刷新。  
  
#### 1.3.3 预览界面功能  
交互式元素： 在预览界面上提供交互式元素，使用户能够直接在预览中与某些主题元素进行交互，以更全面地评估外观效果。  
比较功能： 提供比较功能，允许用户在不同主题设置之间切换，以更容易地选择最喜欢的外观。
  
#### 1.3.4 可保存与应用  
保存设置： 用户满意后，可以保存他们的自定义主题设置，确保下次启动时应用相同的外观。  
取消与还原： 提供取消或还原功能，以便用户在修改过程中可以回到之前的状态。  
通过实时预览的特点，用户可以更直观、高效地调整自定义主题，提高用户体验和满意度。如果有其他关于主题定制或预览界面的需求，请告诉我，我将继续为您提供支持。  
  
### 1.4 使用场景  
主题制作工坊适用于个人用户、系统管理员以及 openKylin 爱好者。个人用户可以通过该工具定制个性化的桌面环境，满足自身审美需求。系统管理员可以在企业环境中使用该工具，为公司或团队创建统一的视觉风格。openKylin 爱好者则可以通过该工坊深度参与系统定制，探索更多创意和可能性。  
通过主题制作工坊，用户能够将 openKylin 操作系统打造成符合自己独特品味和需求的个性化系统，从而提升整体的用户体验。  
  
## 2.主题制作工坊软件功能概览  
主题制作工坊是专为 openKylin 系统设计的定制主题软件。它提供了修改五个主题的功能，包括全局主题、图标主题、光标主题、开机动画和 grub 主题。
  
### 2.1 全局主题
#### 2.1.1 封面设置

    控制面板显示：定制控制面板中自定义的预览显示。

    尺寸设置：

    宽度： 1640 像素

    高度： 1080 像素

    文件大小限制： 5MB

    文件格式：PNG

  这样的参数设置将确保用户在定制控制面板显示时，能够上传满足特定尺寸和文件格式要求的图片。确保软件在接收用户上传的图片时，会检查并强制执行这些参数，以保证用户体验的一致性和最佳效果。
![](img/1.png)

#### 2.1.2 壁纸定制  
    
    选择壁纸：从本地文件中选择或者通过网络获取壁纸。

    尺寸设置：

    宽度： 3840 像素

    高度： 2160 像素

    文件大小限制： 10MB

    支持的文件格式：PNG、JPG

    这样的参数设置确保了用户在选择壁纸时能够使用符合指定尺寸和文件格式的图片。这有助于保持壁纸的质量和兼容性，并确保在不同屏幕上都能够正常显示。
![](img/2.png)
![](img/3.png)
![](img/4.png)


#### 2.1.3 窗口外观
    
    窗口透明度：调整窗口的透明度，实现更加个性化的窗口外观。

    透明度范围：

    最小值： 0

    最大值： 100

    默认透明度：65

    这样的参数设置允许用户在一个 0 到 100 的范围内调整窗口的透明度，其中 0 表示完全透明，100 表示完全不透明。默认透明度设置为 65，以提供一个中等程度的透明效果。
![](img/5.png)
![](img/6.png)
![](img/7.png)


    窗口圆角大小：定制窗口边角的圆角大小，营造不同的窗口风格。

    以下是圆角大小的设置：

    大圆角：

    圆角大小： 12 像素 (px)

    中圆角：

    圆角大小： 6 像素 (px)

    小圆角：

    圆角大小： 0 像素 (px)

    默认圆角：中圆角

    这样的参数设置允许用户选择不同的圆角大小，分别为大、中、小三种。
![](img/8.png)
![](img/9.png)
![](img/10.png)


   窗口深浅主题：定制窗口深浅主题

   深主题：

   提供深色调的主题，适合喜欢暗色调的用户。

   浅主题：

   提供浅色调的主题，适合喜欢明亮色调的用户。

   默认主题：浅主题

   用户可以在这两种主题之间进行选择，以满足用户对窗口外观的个性化喜好。
![](img/11.png)
![](img/12.png)

#### 2.1.4 控件定制
   控件圆角大小：调整界面控件的圆角大小，增强整体视觉效果。

   圆角大小范围：

   最小值： 0 像素 (px)

   最大值： 18 像素 (px)

   默认圆角大小：6 像素 (px)

   用户可以在 0 到 18 像素的范围内选择他们喜欢的圆角大小。默认圆角大小设置为 6 像素，以提供一个中等程度的圆角效果。
![](img/13.png)
![](img/14.png)
![](img/15.png)

   强调色：选择强调色，用于突出显示界面中的重要元素。

   可选的强调色：

   daybreakBlue、jamPurple、magentaSunRed、sunsetOrange、dustGold、polarGreen

   默认强调色：

   daybreakBlue

   用户可以在这些选项中选择他们喜欢的强调色，以使界面中的重要元素更为突出。
![](img/16.png)
![](img/17.png)
![](img/18.png)
![](img/19.png)


### 2.2 图标主题
    
    应用图标：定制每个应用的图标，支持常见的应用如 biometric-manager、box-manager 等。
![](img/20.png)

    系统图标：修改系统控制面板中的图标，包括 kylin-settings-account、kylin-settings-application 等。
![](img/21.png)

### 2.3 光标主题
   
    光标样式：从预设的光标样式中选择，也支持导入自定义的光标。
![](img/22.png)

### 2.4 开机动画
    支持的格式

    MP4 文件格式：允许用户上传和应用 MP4 格式的开机动画

    支持的文件格式：MP4

    文件大小限制：10MB

    PNG 图片：支持将一张 PNG 图片作为开机动画，为用户提供更多创意空间。

    支持的文件格式：PNG

    文件大小限制：20KB
    ![](img/23.png)

### 2.5 Grub 主题
    上传自定义图片：选择并上传用户喜欢的图片作为 Grub 界面的背景。

    尺寸设置：

    宽度： 3840 像素

    高度： 2160 像素

    文件大小限制： 10MB

    支持的文件格式：PNG
    ![](img/24.png)
    ![](img/25.png)