org.ofdrw.font

Class EnvFont

java.lang.Object

org.ofdrw.font.EnvFont

public final class EnvFont
extends Object

环境变量中的字体

Since:

2023-3-2 22:05:45

Author:

权观宇

Constructor Summary

Constructors

Constructor and Description
EnvFont()

Method Summary

Modifier and Type	Method and Description
static FontRenderContext	FRCtx() 获取默认字体绘制上下文
static Font	getDefaultFont() 获取默认字体
static Font	getFont(String name) 在当前环境中寻找指定名称的字体
static Font	getFont(String name, String family) 在当前环境中寻找指定名称的字体
static void	load(Path dirPath) 从目录中加载字体，仅加载以 .otf 或 .ttf 结尾的字体文件，若字体无法加载则忽略并打印错误
static void	setDefaultFont(Font defaultFont) 设置默认字体
static void	setDefaultFont(Path path) 设置默认字体
static void	setMapping(String name, Font font) 设置自定义文字映射
static Rectangle2D	strBounds(String name, String family, String str, double size) 分析字符串大小在指定字号下所占空间大小

Methods inherited from class java.lang.Object

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

Constructor Detail

EnvFont

public EnvFont()

Method Detail

getFont

public static Font getFont(String name)

在当前环境中寻找指定名称的字体

Parameters:

name - 字体名

Returns:

指定名称字体，若不存在则返回空。

getFont

public static Font getFont(String name,
                           String family)

在当前环境中寻找指定名称的字体

Parameters:

name - 字体名

family - 替换字体名

Returns:

指定名称字体，若不存在则返回空。

setMapping

public static void setMapping(String name,
                              Font font)

设置自定义文字映射

Parameters:

name - 字体名

font - 字体对象

load

public static void load(Path dirPath)
                 throws IOException

从目录中加载字体，仅加载以 .otf 或 .ttf 结尾的字体文件，若字体无法加载则忽略并打印错误

首次运行会加载环境变量中的字体，然后以目标目录中的字体文件覆盖环境变量中的字体。

若需要指定默认字体，可以在加载字体后调用 setDefaultFont(Path) 方法。

Parameters:

dirPath - 字体文件所有目录

Throws:

IOException - IO读写异常

strBounds

public static Rectangle2D strBounds(String name,
                                    String family,
                                    String str,
                                    double size)

分析字符串大小在指定字号下所占空间大小

若无法找到字体则使用默认字体计算

Parameters:

name - 字体名

family - 替换字体名

str - 待分析字符串

size - 字体大小

Returns:

字符所占区域大小

getDefaultFont

public static Font getDefaultFont()

获取默认字体

Returns:

默认字体

setDefaultFont

public static void setDefaultFont(Font defaultFont)

设置默认字体

Parameters:

defaultFont - 默认字体

setDefaultFont

public static void setDefaultFont(Path path)
                           throws IOException,
                                  FontFormatException

设置默认字体

Parameters:

path - 字体文件路径

Throws:

IOException - IO读写异常

FontFormatException - 字体格式异常

FRCtx

public static FontRenderContext FRCtx()

获取默认字体绘制上下文

Returns:

上下文