org.ofdrw.converter

类 FontLoader

java.lang.Object

org.ofdrw.converter.FontLoader

public final class FontLoader
extends Object

字体加载器

从以下版本开始:

2021-04-13 19:00:39

作者:

qaqtutu

字段概要

字段

限定符和类型	字段和说明
static String	Separator
static String	SeparatorRegex

方法概要

限定符和类型	方法和说明
FontLoader	addAliasMapping(String familyName, String fontName, String aliasFamilyName, String aliasFontName) 追加字体映射
FontLoader	addSimilarFontReplaceRegexMapping(String familyNameRegex, String fontNameRegex, String aliasFamilyName, String aliasFontName) 追加相似字体正则匹配规则
void	addSystemFontMapping(String familyName, String fontName, String fontFilePath) 增加字体映射 用于解决部分字体不存在时的替代
static FontLoader	enableSimilarFontReplace() 已过时。 setSimilarFontReplace(boolean)
static void	FixOS2(String src) 修复了字体 小写os/2导致无法读取的问题
static FontLoader	getInstance()
String	getReplaceSimilarFontPath(String familyName, String fontName) 获取配置的 相似字体 对应的字体路径
String	getSystemFontPath(String familyName, String fontName) 从操作系统字体目下获取字体路径
void	init()
org.apache.fontbox.ttf.TrueTypeFont	loadDefaultFont() 加载默认字体
org.apache.fontbox.ttf.TrueTypeFont	loadExternalFont(String absPath) 已过时。 loadExternalFont(String, String, String)}
org.apache.fontbox.ttf.TrueTypeFont	loadExternalFont(String absPath, String familyName, String fontName) 加载外部字体
void	loadFont(File file) 加载字体到映射中
void	loadFont(Path file) 加载字体到映射中
org.apache.fontbox.ttf.TrueTypeFont	loadFont(ResourceLocator rl, org.ofdrw.core.text.font.CT_Font ctFont) 加载字体 兼容性保留
FontWrapper<org.apache.fontbox.ttf.TrueTypeFont>	loadFontSimilar(ResourceLocator rl, org.ofdrw.core.text.font.CT_Font ctFont) 加载字体
com.itextpdf.kernel.font.PdfFont	loadPDFFont(ResourceLocator rl, org.ofdrw.core.text.font.CT_Font ctFont) 加载字体 兼容性保留
FontWrapper<com.itextpdf.kernel.font.PdfFont>	loadPDFFontSimilar(ResourceLocator rl, org.ofdrw.core.text.font.CT_Font ctFont) 尽可能的加载字体 如果字体无法加载时使用相近字体替换
org.apache.fontbox.ttf.TrueTypeFont	loadSystemFont(String familyName, String fontName) 尝试从系统字体目录中加载字体
void	scanFontDir(File dir) 扫描目录下所有字体并加兹安
void	scanFontDir(Path dir) 扫描目录下所有字体并加载
static FontLoader	setSimilarFontReplace(boolean enable) 设置是否开启相近字体替换 该方法用于在字体无法识别的情况下采用默认的字体进行替换 防止渲染时字体内容缺失。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

字段详细资料

Separator

public static final String Separator

另请参阅:

常量字段值

SeparatorRegex

public static final String SeparatorRegex

另请参阅:

常量字段值

方法详细资料

enableSimilarFontReplace

@Deprecated
public static FontLoader enableSimilarFontReplace()

已过时。 setSimilarFontReplace(boolean)

是否开启 字体替换，替换规则 similarFontReplaceRegexMapping

返回:

实例

setSimilarFontReplace

public static FontLoader setSimilarFontReplace(boolean enable)

设置是否开启相近字体替换

该方法用于在字体无法识别的情况下采用默认的字体进行替换 防止渲染时字体内容缺失。

参数:

enable - true - 开启(默认); false - 关闭

返回:

实例

getInstance

public static FontLoader getInstance()

init

public void init()

addAliasMapping

public FontLoader addAliasMapping(String familyName,
                                  String fontName,
                                  String aliasFamilyName,
                                  String aliasFontName)

追加字体映射

参数:

familyName - 字族名

fontName - 字体名

aliasFamilyName - 字族别名

aliasFontName - 字体别名

返回:

this

addSimilarFontReplaceRegexMapping

public FontLoader addSimilarFontReplaceRegexMapping(String familyNameRegex,
                                                    String fontNameRegex,
                                                    String aliasFamilyName,
                                                    String aliasFontName)

追加相似字体正则匹配规则

参数:

familyNameRegex - 字族名匹配规则

fontNameRegex - 字体名匹配规则

aliasFamilyName - 字族别名

aliasFontName - 字体别名

返回:

this

addSystemFontMapping

public void addSystemFontMapping(String familyName,
                                 String fontName,
                                 String fontFilePath)

增加字体映射

用于解决部分字体不存在时的替代

参数:

familyName - 字族名

fontName - 字体名

fontFilePath - 字体位置

getSystemFontPath

public String getSystemFontPath(String familyName,
                                String fontName)

从操作系统字体目下获取字体路径

参数:

familyName - 字族名

fontName - 字体名

返回:

字体操作系统内绝对路径，如果不存在返还null

getReplaceSimilarFontPath

public String getReplaceSimilarFontPath(String familyName,
                                        String fontName)

获取配置的 相似字体 对应的字体路径

参数:

familyName - 字族名

fontName - 字体名

返回:

字体操作系统内绝对路径，如果不存在返还 null

loadSystemFont

public org.apache.fontbox.ttf.TrueTypeFont loadSystemFont(String familyName,
                                                          String fontName)

尝试从系统字体目录中加载字体

参数:

familyName - 字族名

fontName - 字体名

返回:

字体或null

loadExternalFont

@Deprecated
public org.apache.fontbox.ttf.TrueTypeFont loadExternalFont(String absPath)

已过时。 loadExternalFont(String, String, String)}

加载外部字体

参数:

absPath - 绝对路径

返回:

null或外部字体

loadExternalFont

public org.apache.fontbox.ttf.TrueTypeFont loadExternalFont(String absPath,
                                                            String familyName,
                                                            String fontName)

加载外部字体

参数:

absPath - 字体操作系统绝对路径

familyName - 字族名

fontName - 字体名

返回:

字体

loadFont

public org.apache.fontbox.ttf.TrueTypeFont loadFont(ResourceLocator rl,
                                                    org.ofdrw.core.text.font.CT_Font ctFont)

加载字体

兼容性保留

参数:

rl - 资源加载器，用于从虚拟容器中取出文件

ctFont - 字体对象

返回:

字体或null

loadFontSimilar

public FontWrapper<org.apache.fontbox.ttf.TrueTypeFont> loadFontSimilar(ResourceLocator rl,
                                                                        org.ofdrw.core.text.font.CT_Font ctFont)

加载字体

参数:

rl - 资源加载器，用于从虚拟容器中取出文件

ctFont - 字体对象

返回:

字体或null

loadPDFFont

public com.itextpdf.kernel.font.PdfFont loadPDFFont(ResourceLocator rl,
                                                    org.ofdrw.core.text.font.CT_Font ctFont)

加载字体

兼容性保留

参数:

rl - 资源加载器，用于从虚拟容器中取出文件

ctFont - 字体对象

返回:

字体 或 null

loadPDFFontSimilar

public FontWrapper<com.itextpdf.kernel.font.PdfFont> loadPDFFontSimilar(ResourceLocator rl,
                                                                        org.ofdrw.core.text.font.CT_Font ctFont)

尽可能的加载字体

如果字体无法加载时使用相近字体替换

参数:

rl - 资源加载器，用于从虚拟容器中取出文件

ctFont - 字体对象

返回:

字体 或 null

loadDefaultFont

public org.apache.fontbox.ttf.TrueTypeFont loadDefaultFont()

加载默认字体

返回:

默认字体宋体

scanFontDir

public void scanFontDir(Path dir)

扫描目录下所有字体并加载

参数:

dir - 目录

scanFontDir

public void scanFontDir(File dir)

扫描目录下所有字体并加兹安

参数:

dir - 目录

loadFont

public void loadFont(Path file)

加载字体到映射中

参数:

file - 字体文件

loadFont

public void loadFont(File file)

加载字体到映射中

参数:

file - 字体文件

FixOS2

public static void FixOS2(String src)
                   throws IOException

修复了字体

小写os/2导致无法读取的问题

参数:

src - 待修复字体文件路径

抛出:

IOException - 文件读写IO异常