[JS] auto_load_fonts 脚本使用说明

[Hill-98]

PS: mpv-player/mpv#9856 已被合并，如果你只是需要自动加载播放文件下的字体目录，那么可以使用 sub-fonts-dir-auto 脚本实现，如果需要更复杂的设置，可以继续使用此脚本。

启用方法：

• 将 mpv.conf 的 sub-font-provider = auto 行改为 sub-font-provider = fontconfig
• 确保当前 mpv 版本支持 fontconfig (https://sourceforge.net/projects/mpv-player-windows/files)

auto_load_fonts 将检查当前文件所在目录是否存在 fonts 文件夹，如果存在，将自动设置 fontconfig 加载 fonts 文件夹的字体文件。

一些字幕组发布的外挂字幕资源可能会包含字幕用到的字体文件压缩包，将压缩包解压到 fonts 文件夹即可使用此脚本自动加载这些字体。

注意事项

分区兼容问题我已向 https://github.com/shinchiro/mpv-winbuild-cmake 提交修复补丁，使用最新版本即可避免兼容问题，如果还有其他问题，欢迎反馈。

由于 Windows 的 NTFS 分区路径字符编码不统一 (mpv-player/mpv#10679)，在某些分区上会遇到无法加载文件名包含非英文字符的字体文件，遇到此问题可以用以下几种方法解决：

• 重新使用 Windows 内置的磁盘管理重新格式化分区
• 将文件名包含非英文字符的字体文件重命名为只包含英文字符文件名。
• 使用兼容模式 (见下方)

使用 fontconfig 作为字体提供者时，mpv 将不使用系统方法查询字体，第三方字体加载工具将失效。

如果你需要预加载额外字体，比如：超级字体整合包XZ，可以编辑 portable_config\fonts.conf 文件，示例如下：

<?xml version="1.0"?>
<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
<fontconfig>
    <description>Default configuration file</description>
    <dir>WINDOWSFONTDIR</dir>
    <dir>WINDOWSUSERFONTDIR</dir>
    <dir>D:/超级字体整合包XZ</dir>
    <dir prefix="cwd">fonts</dir>
    <cachedir>~/.cache/mpv/fonts</cachedir>
    <include ignore_missing="yes">~/.auto_load_fonts.conf</include>
</fontconfig>

如果使用原始超级字体整合包XZ可能会遇到 mpv 加载卡顿等性能问题，可以打开 PowerShell 依次执行以下命令进行修复。

# 切换当前目录到"超级字体整合包XZ"目录

Set-Location D:\超级字体整合包XZ

# 把子目录的字体文件全部移动到顶层目录

Get-ChildItem -Recurse -File | foreach($_) { Move-Item -Path $_.Fullname -Destination "$PWD\$($_.Name)"}

# 删除空的子目录

$dirs=(Get-ChildItem -Directory -Recurse); [Array]::Reverse($dirs); foreach($dir in $dirs) { if ((Get-ChildItem -Path $dir).Count -eq 0) { Remove-Item -Path $dir.FullName } }

# 清除 fontconfig 字体缓存

Remove-Item -Path "$Env:USERPROFILE\.cache\mpv\fonts" -Recurse -Force

兼容模式

兼容模式主要用于解决一些性能问题和 Windows 某些分区上的错误，脚本在兼容模式下加载字体文件时会将 fonts 文件夹复制到指定位置，然后使用新位置进行加载。默认位置为配置目录的 .fonts 目录，如果配置目录所在分区也存在兼容性问题，你还可以自定义兼容目录位置。

设置项

兼容模式: compatible_mode=[yes|no] # 默认关闭

兼容目录: compatible_dir=D:\fonts-cache # 设置兼容目录为 D:\fonts-cache

设置项支持实时更新，可以配合 profile-cond 按需开启兼容模式。

小提示：如果所有分区都不兼容又不想拆分现有分区，可以使用 ImDisk 等软件创建内存盘。

[snylonue]

这个是按需加载的吗

[Hill-98]

是的，只会加载播放文件下fonts文件夹的字体文件，播放结束后自动卸载，如果不存在也不会加载。

[snylonue]

那在fonts里但播放时不会用到的字体会不会被加载

[Hill-98]

不会

[HorizenX1]

我装了好像没效果，fonts文件夹里的所有字体都加载了，兼容模式开了也没效果，这是怎么回事

[   0.032][v][auto_load_fonts] Loading file D:/Program Files (x86)/mpv/portable_config/scripts/auto-load-fonts.js
[   0.032][d][global] user path: 'D:/Program Files (x86)/mpv/portable_config/scripts/auto-load-fonts.js' -> 'D:/Program Files (x86)/mpv/portable_config/scripts/auto-load-fonts.js'
[   0.032][v][auto_load_fonts] Reading file 'D:/Program Files (x86)/mpv/portable_config/scripts/auto-load-fonts.js'
[   0.034][d][global] user path: 'D:/Program Files (x86)/mpv/portable_config/scripts/../script-modules/commands.js' -> 'D:/Program Files (x86)/mpv/portable_config/scripts/../script-modules/commands.js'
[   0.034][v][auto_load_fonts] Reading file 'D:/Program Files (x86)/mpv/portable_config/scripts/../script-modules/commands.js'
[   0.035][d][global] user path: 'D:/Program Files (x86)/mpv/portable_config/scripts/../script-modules/utils.js' -> 'D:/Program Files (x86)/mpv/portable_config/scripts/../script-modules/utils.js'
[   0.035][v][auto_load_fonts] Reading file 'D:/Program Files (x86)/mpv/portable_config/scripts/../script-modules/utils.js'
[   0.036][d][uosc] reading options for uosc 
[   0.036][d][global] config path: 'script-opts/uosc.conf' -> 'D:/Program Files (x86)/mpv/portable_config/script-opts/uosc.conf'
[   0.037][v][uosc] Opened config file script-opts/uosc.conf. 
[   0.039][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\MaterialIconsRound-Regular.otf'
[   0.040][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\SourceHanSansCN-Medium.otf'
[   0.048][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\SourceHanSansJP-Medium.otf'
[   0.052][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\SourceHanSansTW-Medium_0.otf'
[   0.057][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\SourceHanSerifCN-Medium.otf'
[   0.067][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\SourceHanSerifTW-Medium.otf'
[   0.073][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\SourceSansPro-Semibold.otf'
[   0.073][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\uosc_icons.otf'
[   0.074][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\uosc_textures.ttf'
[   0.074][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\方正兰亭黑-R-GBK1-0.otf'
[   0.080][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\方正准雅宋_GBK.TTF'
[   0.092][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\方正粗圆_GBK.ttf'
[   0.104][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\方正粗雅宋_GBK.TTF'
[   0.122][v][osd/libass] Loading font file 'D:/Program Files (x86)/mpv/portable_config/fonts\方正隶变_GBK.TTF'
[   0.147][v][osd/libass] Using font provider directwrite (with GDI)
[   0.147][v][osd/libass] Done.

[Hill-98]

看起来你安装的是我的上游版本，上游版本跟这个仓库里的版本有些许不同，文件位置也不同，其中包括fonts.conf内引用文件的位置，确保这个引用文件位置正确。

[Hill-98]

我刚刚修复了一个兼容模式在Windows上的BUG，如果你的问题没有解决的话，你可以试试最新版本。

[dyphire]

提醒：mpv 上游此 pr mpv-player/mpv#9856 已被合并，对应脚本 sub-fonts-dir-auto 的使用不再限制于个人编译。基于 fontconfig 实现的变通方法已不再必要