Plugin.theme . Ventoy

Ventoy 主题插件

当你第一眼看到Ventoy的时候，你是什么感觉？不是很漂亮对吧？现在你可以定制你自己的主题了！
Ventoy 的启动菜单是基于 grub2 的，所以所有 grub2 的主题都可以应用在 Ventoy上面。
这个网站上收集了很多非常漂亮的 grub 主题 —— GRUB Themes - Gnome-look.org

Json 配置参数

关于 ventoy.json 的位置以及相关说明，请首先参考插件入口（*必读）
在镜像分区 /ventoy/ventoy.json 中定义了一个 theme 结构用于描述关于主题的配置参数。
注意你不需要对这里列出来的每一项都做配置，可以只对其中的一项或几项做特殊配置，其他的会使用默认值.

{
    "theme": {
        "file": "/ventoy/theme/blur/theme.txt",
        "gfxmode": "1920x1080",
        "display_mode": "GUI",
        "serial_param": "--unit=0 --speed=9600",
        "ventoy_left": "5%",
        "ventoy_top": "95%",
        "ventoy_color": "#0000ff",
        "fonts": [
            "/ventoy/theme/blur/Hack-12.pf2",
            "/ventoy/theme/blur/Hack-14.pf2",
            "/ventoy/theme/blur/Hack-16.pf2"
        ]
    }
}

关键字	类型	说明
`file`	`STRING/STRING ARRAY`	theme.txt 文件的全路径。可以是1个字符串，也可以是字符串数组，例如： "file": [ "/ventoy/theme1/theme.txt", "/ventoy/theme2/theme.txt", "/ventoy/theme3/theme.txt", "/ventoy/theme4/theme.txt" ] 当设置为数组时，每次启动时会随机选择其中一个主题生效。
`gfxmode`	`STRING`	可选的，可以不设置。grub2 的 gfxmode 参数，默认为 "1024x768"
`display_mode`	`STRING`	可选的，可以不设置。菜单显示模式，可以设置为 `GUI` `CLI` `serial` `serial_console` 默认为 GUI GUI和CLI 分别对应图形模式和文本模式。在有极个别的机器上Ventoy的背景菜单无法显示，或者显示后菜单移动极其缓慢，这种情况可以默认设置为文本模式。不过，不管GUI还是CLI都是基于VGA显示设备的，如果你的机器上只有串口，你可以设置为 `serial` 当然，如果既有串口也有VGA设备，则也可以设置为 `serial_console` 注意：如果菜单名称（文件名）里有中文的话，在文本或serial模式下是无法显示的。
`serial_param`	`STRING`	可选的，可以不设置。只在 display_mode 设置为 `serial` 或 `serial_console` 时才生效这个参数用来配置串口的端口号以及波特率等参数，--unit=0 对应 com1 --unit=1 对应 com2 详细描述请参考 https://www.gnu.org/software/grub/manual/grub/grub.html#serial
`ventoy_left`	`STRING`	可选的，可以不设置。ventoy版本信息的 X 位置, 默认为 "5%"
`ventoy_top`	`STRING`	可选的，可以不设置。ventoy版本信息的 Y 位置, 默认为 "95%"
`ventoy_color`	`STRING`	可选的，可以不设置。ventoy版本信息的颜色, 默认为 "#0000ff"
`fonts`	`STRING ARRAY`	可选的，可以不设置。数组中的每一项代表一个字体文件的全路径，Ventoy在启动时会依次加载这些字体文件。

文本模式 <==> 图形模式切换

默认情况下 Ventoy 是图形模式，但在个别比较特殊的机器上可能会有显示问题，比如花屏、卡顿之类的。这种情况下你可以切换为文本模式。
Ventoy 文本模式和图形模式在功能上是一样的，只是图形模式更漂亮一点，再有就是文本模式中文会显示为？？问号。
有以下几种方式可以切换显示模式：

通过 F5 Tools-->Screen Display Mode-->Force Text Mode 菜单切换。这个是一次性的，每次启动都需要重新设置
通过按 F7 快捷键来切换。这个和方法1效果是一样的，更方便一些。反复按可以在文本模式和图形模式之间来回切换。
通过本文中的主题插件设置，这样可以把默认模式切换成文本模式，不需要每次都切换。

热键提示

为了能正常显示热键提示，你需要把下面这几个 hbox 的定义添加到新的 theme.txt 文件中。你也可以修改里面的位置和颜色属性。

+ hbox{ 
    left = 30%
    top = 95%
    width = 10%
    height = 25
    + label {text = "@VTOY_HOTKEY_TIP@" color = "blue" align = "left"} 
}

+ hbox{ 
    left = 90%
    top = 5 
    width = 10%
    height = 25
    + label {text = "@VTOY_MEM_DISK@" color = "red" align = "left"} 
}

Ventoy 版本信息

默认情况下，在界面的左下角会显示Ventoy的版本信息，比如 1.0.10 UEFI www.ventoy.net
这个信息是在代码中固定实现的，你可以通过 ventoy_left/ventoy_top/ventoy_color 变量来调整它的位置和颜色。
如果你想完全删除它，我鼓励你去阅读Ventoy的源代码，修改之后重新编译。我想这也是开源的意义所在。

分别针对不同的 BIOS 模式设置不同的主题

theme 支持多模式，可以分别针对 x86 Legacy BIOS、IA32 UEFI、x86_64 UEFI 和 ARM64 UEFI 模式分别设置不同的主题，甚至可以有的使用图形模式，另一些使用文本模式。
详细说明请参考多模式选项

主题示例

https://gbatemp.net/threads/medicat-usb-a-multiboot-linux-usb-for-pc-repair.361577/