【Foxit PDF SDK for Web】PDF未嵌入字体的情况下，如何使用WebSDK完整显示PDF中的内容？ - 福昕PDF支持中心

福昕首页
开发中心
SDK文档资料

福昕首页
开发中心
SDK文档资料

企业自动化
- Compressor
福昕CloudAPI
福昕PDF SDK 软件开发工具包
福昕管理控制台
福昕阅读器
- RMS插件
福昕高级编辑器
- AI助手
- Mac版本
  - 常规问题
- windows版本
- 教育用户
  - 论文查重
  - 论文畅
- 网页版
  - 电子签章
- 订阅
- 资源
福昕高级编辑器Linux版本
福船图纸管理系统

福昕PDF SDK 软件开发工具包

标签:

【Foxit PDF SDK for Web】PDF未嵌入字体的情况下，如何使用WebSDK完整显示PDF中的内容？

福昕知识库
2023-08-30

技术背景：PDF未嵌入其使用到的字体的情况下，使用PDF引擎进行解析渲染的时候，通常会出现使用相关字体书写的内容不能正确显示或是直接显示空白页面的现象。这是因为PDF引擎在渲染PDF时会优先从PDF自身的数据结构中寻找内容相关字体的字型。如果内容相关字体没有嵌入到PDF数据结构中，则PDF引擎需要借助应用层引入的字体进行内容渲染展示。若应用层没有引入任何字体，则显示时就会出现空白页面的情况。若应用层没有引入该PDF中用到的字体，但有类似的其他字体，则PDF引擎会根据应用层引入的字体，去寻找并匹配类似字体的字型去渲染显示PDF内容，确保PDF内容的可读性。比如PDF内容生成时用的是宋体，但是保存PDF时其用到的宋体字型未嵌入到PDF中，那么PDF引擎在渲染显示该PDF时就会用缺省的开源中文字体进行显示，最终预览的效果看着像黑体。

基于前边补充的技术背景，针对上述问题，解决思路如下：

步骤一：
使用包含开源字体资源的WebSDK标准包或完整包，其中的external目录是SDK内置的开源免费字体资源，用于确保PDF中未嵌入字体的相关内容仍然可以被渲染展示出来，方便使用者可以完整阅读到PDF的内容。
开发者需要在初始化PDFViewer或pdfui实例对象时，在其构造函数中指定PDF引擎可使用的缺省字体资源路径，即fontPath参数，如`fontPath: '../external/brotli'`，fontPath参数的值，可以是项目中的相对路径，也可以是字体服务器的url地址，确保字体资源可以被有效访问到即可。

步骤二：
结合技术背景的描述可以知道，“步骤一”只能确保PDF内容的可读性，但未必能确保PDF内容的完整且正确显示。如上所述，如果待渲染的PDF中用到的是黑体相关的字型，或使用者不在乎渲染时的字体效果，只在乎内容的完整性，那么“步骤一”完成后即可满足使用场景。如果使用者要求完整且正确的显示PDF中的内容，则需要开发者根据业务需要，在应用程序中引入已购买了授权的字体文件（需要引入的字体数量取决于待渲染的PDF中未嵌入的字体数量），并为PDF引擎配置这些自定义字体的存放路径和相关参数。可以参考WebSDK中内置的Demo：`/examples/UIExtension/custom-font/`。

备注：上述解答适用于WebSDK 8.x版本及 9.0.0版本。

相关内容

【校园昕积分】邀请攻略：使用福昕合作高校发放教育专用激活码激活

【校园昕积分】邀请攻略：使用CARSI高校账户或高校EDU邮箱注册

在福昕高级PDF编辑器中如何自定义快速访问工具栏

在福昕高级PDF编辑器中如何设置常用图章

在对文件虚拟打印后如何设置文件不自动打开

通知消息关闭后如何开启

PDF文件奇偶页差异化页码添加

Web SDK 开发实战：动态自定义 PDF 注释右键菜单的 JavaScript 实现方案

无法安装服务“Foxit Document Management”(FoxitAssistantSvcPlus)

将3D文件添加作为信任文件

推荐内容

【校园昕积分】邀请攻略：使用福昕合作高校发放教育专用激活码激活

【校园昕积分】邀请攻略：使用CARSI高校账户或高校EDU邮箱注册

在福昕高级PDF编辑器中如何自定义快速访问工具栏

在福昕高级PDF编辑器中如何设置常用图章

在对文件虚拟打印后如何设置文件不自动打开

通知消息关闭后如何开启

PDF文件奇偶页差异化页码添加

Web SDK 开发实战：动态自定义 PDF 注释右键菜单的 JavaScript 实现方案

无法安装服务“Foxit Document Management”(FoxitAssistantSvcPlus)

将3D文件添加作为信任文件

产品

应用行业
白皮书

开发支持

开发中心
SDK文档资料

销售咨询：010-50951668

客服电话：0591-38509808

销售咨询

微信公众号

©2025 福建福昕软件开发股份有限公司版权所有