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 boolean	DEBUG

方法概要

限定符和类型	方法和说明
FontLoader	addAliasMapping(String fontName, String alias) 添加字体映射
FontLoader	addAliasMapping(@Nullable String familyName, String fontName, @Nullable String aliasFamilyName, String aliasFontName) 已过时。 addAliasMapping(String, String)
FontLoader	addSimilarFontReplaceRegexMapping(String fontNameRegex, String fontName) 追加相似字体正则匹配规则
FontLoader	addSimilarFontReplaceRegexMapping(@Nullable String familyNameRegex, String fontNameRegex, @Nullable String aliasFamilyName, String aliasFontName) 已过时。 addSimilarFontReplaceRegexMapping(String, String)
FontLoader	addSystemFontMapping(String fontName, String fontFilePath) 增加字体映射 用于解决部分字体不存在时的替代
FontLoader	addSystemFontMapping(@Nullable String familyName, String fontName, String fontFilePath) 已过时。 addSystemFontMapping(String, String)
static FontLoader	enableSimilarFontReplace() 已过时。 setSimilarFontReplace(boolean)
static void	FixOS2(String src) 修复了字体 小写os/2导致无法读取的问题
TrueTypeFont	getDefaultFont() 默认字体解析模式
Path	getDefaultFontPath() 获取默认字体文件路径
String	getFontAlias(org.ofdrw.core.text.font.CT_Font ctFont) 获取字体别名
static FontLoader	getInstance() 获取字体加载器实例并加载程序
com.itextpdf.io.font.TrueTypeFont	getITextDefaultFont() 默认字体iText格式
String	getReplaceSimilarFontPath(@Nullable String familyName, String fontName) 获取配置的 相似字体 对应的字体路径
String	getSystemFontPath(@Nullable String familyName, String fontName) 从操作系统字体目下获取字体路径
void	init()
static boolean	loadAsDefaultFont(String path) 尝试加载为默认字体
TrueTypeFont	loadDefaultFont() 加载默认字体
TrueTypeFont	loadExternalFont(String absPath) 已过时。 loadExternalFont(String, String, String)}
TrueTypeFont	loadExternalFont(@NotNull String absPath, @Nullable String familyName, @Nullable String fontName) 加载外部字体
void	loadFont(File file) 加载字体到映射中 支持：otf、ttf、ttc格式
void	loadFont(Path file) 加载字体到映射中
TrueTypeFont	loadFont(ResourceLocator rl, org.ofdrw.core.text.font.CT_Font ctFont) 加载字体 兼容性保留
FontWrapper<TrueTypeFont>	loadFontSimilar(ResourceLocator rl, org.ofdrw.core.text.font.CT_Font ctFont) 加载字体
InputStream	loadFontSimilarStream(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) 尽可能的加载字体 如果字体无法加载时使用相近字体替换
TrueTypeFont	loadSystemFont(String familyName, String fontName) 尝试从系统字体目录中加载字体
static FontLoader	Preload() 预加载字体 扫描操作系统内字体,功能与getInstance() 一致
void	scanFontDir(File dir) 扫描目录下所有字体并加兹安
void	scanFontDir(Path dirPath) 扫描目录下所有字体并加兹安
static FontLoader	setSimilarFontReplace(boolean enable) 设置是否开启相近字体替换 该方法用于在字体无法识别的情况下采用默认的字体进行替换 防止渲染时字体内容缺失。

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

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

字段详细资料

DEBUG

public static boolean DEBUG

方法详细资料

enableSimilarFontReplace

@Deprecated
public static FontLoader enableSimilarFontReplace()

已过时。 setSimilarFontReplace(boolean)

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

返回:

实例

setSimilarFontReplace

public static FontLoader setSimilarFontReplace(boolean enable)

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

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

参数:

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

返回:

实例

getInstance

public static FontLoader getInstance()

获取字体加载器实例并加载程序

返回:

字体加载器

Preload

public static FontLoader Preload()

预加载字体

扫描操作系统内字体,功能与getInstance() 一致

返回:

字体加载器

init

public void init()

loadAsDefaultFont

public static boolean loadAsDefaultFont(String path)

尝试加载为默认字体

参数:

path - 字体路径

返回:

true - 加载成功；false - 加载失败

addAliasMapping

@Deprecated
public FontLoader addAliasMapping(@Nullable
                                               @Nullable String familyName,
                                               String fontName,
                                               @Nullable
                                               @Nullable String aliasFamilyName,
                                               String aliasFontName)

已过时。 addAliasMapping(String, String)

追加字体映射

参数:

familyName - 字族名

fontName - 字体名

aliasFamilyName - 字族别名

aliasFontName - 字体别名

返回:

this

addAliasMapping

public FontLoader addAliasMapping(String fontName,
                                  String alias)

添加字体映射

参数:

fontName - 字体名称

alias - 字体别名

返回:

this

addSimilarFontReplaceRegexMapping

@Deprecated
public FontLoader addSimilarFontReplaceRegexMapping(@Nullable
                                                                 @Nullable String familyNameRegex,
                                                                 String fontNameRegex,
                                                                 @Nullable
                                                                 @Nullable String aliasFamilyName,
                                                                 String aliasFontName)

已过时。 addSimilarFontReplaceRegexMapping(String, String)

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

参数:

familyNameRegex - 字族名匹配规则

fontNameRegex - 字体名匹配规则

aliasFamilyName - 字族别名

aliasFontName - 字体别名

返回:

this

addSimilarFontReplaceRegexMapping

public FontLoader addSimilarFontReplaceRegexMapping(String fontNameRegex,
                                                    String fontName)

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

参数:

fontNameRegex - 字体名匹配规则

fontName - 相近替换字体名

返回:

this

addSystemFontMapping

@Deprecated
public FontLoader addSystemFontMapping(@Nullable
                                                    @Nullable String familyName,
                                                    String fontName,
                                                    String fontFilePath)

已过时。 addSystemFontMapping(String, String)

增加字体映射

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

参数:

familyName - 字族名

fontName - 字体名

fontFilePath - 字体位置

返回:

this

addSystemFontMapping

public FontLoader addSystemFontMapping(String fontName,
                                       String fontFilePath)

增加字体映射

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

参数:

fontName - 字体名

fontFilePath - 字体位置

返回:

this

getSystemFontPath

public String getSystemFontPath(@Nullable
                                @Nullable String familyName,
                                String fontName)

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

参数:

familyName - 字族名（用于在字体不存在是替代字体，可为空）

fontName - 字体名

返回:

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

getReplaceSimilarFontPath

public String getReplaceSimilarFontPath(@Nullable
                                        @Nullable String familyName,
                                        String fontName)

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

参数:

familyName - 字族名（用于在字体不存在是替代字体，可为空）

fontName - 字体名

返回:

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

loadSystemFont

public TrueTypeFont loadSystemFont(String familyName,
                                   String fontName)

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

参数:

familyName - 字族名

fontName - 字体名

返回:

字体或null

loadExternalFont

@Deprecated
public TrueTypeFont loadExternalFont(String absPath)

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

加载外部字体

参数:

absPath - 绝对路径

返回:

null或外部字体

loadExternalFont

public TrueTypeFont loadExternalFont(@NotNull
                                     @NotNull String absPath,
                                     @Nullable
                                     @Nullable String familyName,
                                     @Nullable
                                     @Nullable String fontName)

加载外部字体

参数:

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

familyName - 字族名，因为是可选参数忽略

fontName - 字体名

返回:

字体

loadFont

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

加载字体

兼容性保留

参数:

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

ctFont - 字体对象

返回:

字体或null

loadFontSimilar

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

加载字体

参数:

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

ctFont - 字体对象

返回:

字体或null

loadFontSimilarStream

public InputStream loadFontSimilarStream(ResourceLocator rl,
                                         org.ofdrw.core.text.font.CT_Font ctFont)

加载相近字体流

参数:

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

ctFont - 字体对象

返回:

字体流

getFontAlias

public String getFontAlias(org.ofdrw.core.text.font.CT_Font ctFont)

获取字体别名

参数:

ctFont - 字体对象

返回:

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 TrueTypeFont loadDefaultFont()

加载默认字体

返回:

默认字体宋体

scanFontDir

public void scanFontDir(File dir)

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

参数:

dir - 目录

scanFontDir

public void scanFontDir(Path dirPath)

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

参数:

dirPath - 目录路径

loadFont

public void loadFont(Path file)

加载字体到映射中

参数:

file - 字体文件

loadFont

public void loadFont(File file)

加载字体到映射中

支持：otf、ttf、ttc格式

参数:

file - 字体文件路径

FixOS2

public static void FixOS2(String src)
                   throws IOException

修复了字体

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

参数:

src - 待修复字体文件路径

抛出:

IOException - 文件读写IO异常

getDefaultFont

public TrueTypeFont getDefaultFont()

默认字体解析模式

返回:

字体

getITextDefaultFont

public com.itextpdf.io.font.TrueTypeFont getITextDefaultFont()

默认字体iText格式

返回:

字体

getDefaultFontPath

public Path getDefaultFontPath()

获取默认字体文件路径

返回:

文件路径