java.awt.font

Class FontRenderContext

java.lang.Object

java.awt.font.FontRenderContext

public class FontRenderContext
extends Object

FontRenderContext类是用于正确测量文本所需信息的容器。 文本的测量可能因为将轮廓映射到像素的规则以及应用程序提供的提示而有所不同。

一个这样的信息是将印刷点缩放到像素的变换。 （一个点被定义为正好1/72英寸，与一点的传统机械测量略有不同）。在600dpi设备上以12pt渲染的字符可能与提供的相同字符的大小不同在72dpi设备上的12pt，因为诸如四舍五入到像素边界和字体设计者可能指定的提示等因素。

应用程序指定的抗锯齿和分数度量也可能会影响字符的大小，因为四舍五入到像素边界。

通常，FontRenderContext的FontRenderContext是从Graphics2D对象获得的。 甲FontRenderContext被直接构造将最有可能并不代表任何实际的图形设备，并且可以导致意外的或不正确的结果。

另请参见：

RenderingHints.KEY_TEXT_ANTIALIASING ， RenderingHints.KEY_FRACTIONALMETRICS ， Graphics2D.getFontRenderContext() ， LineMetrics

构造方法摘要

构造方法

Modifier	Constructor and Description
protected	FontRenderContext() 构造一个新的 FontRenderContext对象。
	FontRenderContext(AffineTransform tx, boolean isAntiAliased, boolean usesFractionalMetrics) 从可选的AffineTransform和两个boolean构造一个FontRenderContext对象，确定新构造的对象是否具有抗锯齿或分数度量。
	FontRenderContext(AffineTransform tx, Object aaHint, Object fmHint) 从可选的AffineTransform和两个Object值构造一个FontRenderContext对象，确定新构造的对象是否具有抗锯齿或分数度量。

方法摘要

Modifier and Type	Method and Description
boolean	equals(FontRenderContext rhs) 如果rhs具有相同的变换，抗锯齿和小数度量值，则返回true。
boolean	equals(Object obj) 如果obj是FontRenderContext的一个实例，并且具有与此相同的转换，抗锯齿和小数度量值，则返回true。
Object	getAntiAliasingHint() 返回本 FontRenderContext使用的文本反锯齿渲染模式提示。
Object	getFractionalMetricsHint() 返回在此使用的文本fractional metrics呈现模式提示 FontRenderContext 。
AffineTransform	getTransform() 获得用于在FontRenderContext中将印刷点缩放到像素的 FontRenderContext 。
int	getTransformType() 为这将返回仿射的整数类型的变换 FontRenderContext如通过指定 AffineTransform.getType()
int	hashCode() 返回此FontRenderContext的哈希码。
boolean	isAntiAliased() 返回一个布尔值，指示某种形式的抗锯齿是否由此 FontRenderContext 。
boolean	isTransformed() 指示此 FontRenderContext对象是否测量转换的渲染上下文中的文本。
boolean	usesFractionalMetrics() 返回在此 FontRenderContext中是否使用文本分数度量模式的布尔值。

Methods inherited from class java.lang.Object

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

构造方法详细信息

FontRenderContext

protected FontRenderContext()

构造一个新的 FontRenderContext对象。

FontRenderContext

public FontRenderContext(AffineTransform tx,
                         boolean isAntiAliased,
                         boolean usesFractionalMetrics)

从可选的AffineTransform和两个boolean值构造一个FontRenderContext对象，确定新构造的对象是否具有抗锯齿或小数度量。 在每种情况下，布尔值true和false对应于呈现提示值ON和OFF分别。

要指定其他提示值，请使用将渲染提示值指定为参数的构造函数： FontRenderContext(AffineTransform, Object, Object) 。

参数

tx - 用于在FontRenderContext中将印刷点缩放到像素的FontRenderContext 。 如果为空，则使用身份转换。

isAntiAliased - 确定新构造的对象是否具有抗锯齿。

usesFractionalMetrics - 确定新构建的对象是否具有小数度量。

FontRenderContext

public FontRenderContext(AffineTransform tx,
                         Object aaHint,
                         Object fmHint)

从可选的AffineTransform和两个Object值构造一个FontRenderContext对象，以确定新构造的对象是否具有抗锯齿或小数度量。

参数

tx - 用于在FontRenderContext中将印刷点缩放到像素的FontRenderContext 。 如果为空，则使用身份转换。

aaHint - - java.awt.RenderingHints中定义的文本抗锯齿渲染提示值之一 。 任何其他的值都会抛出IllegalArgumentException 。 VALUE_TEXT_ANTIALIAS_DEFAULT可以指定，在这种情况下使用的模式是依赖于实现的。

fmHint - - java.awt.RenderingHints中定义的文本分数渲染提示值之一 。 VALUE_FRACTIONALMETRICS_DEFAULT可以指定，在这种情况下使用的模式是依赖于实现的。 任何其他值将抛出IllegalArgumentException

异常

IllegalArgumentException - 如果提示不是合法价值之一。

从以下版本开始：

1.6

方法详细信息

isTransformed

public boolean isTransformed()

指示此 FontRenderContext对象是否测量转换的渲染上下文中的文本。

结果

true如果此FontRenderContext对象具有非身份AffineTransform属性。 false否则。

从以下版本开始：

1.6

另请参见：

getTransform()

getTransformType

public int getTransformType()

为这将返回仿射的整数类型的变换 FontRenderContext如通过指定 AffineTransform.getType()

结果

转换的类型。

从以下版本开始：

1.6

另请参见：

AffineTransform

getTransform

public AffineTransform getTransform()

获取用于在FontRenderContext中将印刷点缩放到像素的 FontRenderContext 。

结果

这 AffineTransform这 FontRenderContext 。

另请参见：

AffineTransform

isAntiAliased

public boolean isAntiAliased()

返回一个布尔值，表示某种形式的抗锯齿是否由此FontRenderContext 。 请致电getAntiAliasingHint()获取具体的渲染提示值。

结果

true ，如果文本是反锯齿在这FontRenderContext ; false否则。

另请参见：

RenderingHints.KEY_TEXT_ANTIALIASING ， FontRenderContext(AffineTransform,boolean,boolean) ， FontRenderContext(AffineTransform,Object,Object)

usesFractionalMetrics

public boolean usesFractionalMetrics()

返回在此FontRenderContext中使用文本分数度量模式的布尔值。 调用getFractionalMetricsHint()获取相应的渲染提示值。

结果

true ，如果布局应以小数度量进行; false否则。 在这FontRenderContext 。

另请参见：

RenderingHints.KEY_FRACTIONALMETRICS ， FontRenderContext(AffineTransform,boolean,boolean) ， FontRenderContext(AffineTransform,Object,Object)

getAntiAliasingHint

public Object getAntiAliasingHint()

返回在本FontRenderContext使用的文本反锯齿渲染模式提示。 这将是java.awt.RenderingHints中定义的文本抗锯齿渲染提示值之一 。

结果

文字反锯齿渲染模式提示用于此 FontRenderContext 。

从以下版本开始：

1.6

getFractionalMetricsHint

public Object getFractionalMetricsHint()

返回在此使用的文本fractional metrics呈现模式提示FontRenderContext 。 这将是java.awt.RenderingHints中定义的文本分数度量渲染提示值之一 。

结果

在此使用的文本小数规格呈现模式暗示 FontRenderContext 。

从以下版本开始：

1.6

equals

public boolean equals(Object obj)

如果obj是FontRenderContext的一个实例，并且具有与此相同的转换，抗锯齿和小数度量值，则返回true。

重写：

equals在 Object类

参数

obj - 测试对象的相等性

结果

true如果指定的对象等于此FontRenderContext ; false否则。

另请参见：

Object.hashCode() ， HashMap

equals

public boolean equals(FontRenderContext rhs)

如果rhs具有相同的变换，抗锯齿和小数度量值，则返回true。

参数

rhs - FontRenderContext测试平等

结果

true如果rhs等于这个FontRenderContext ; false否则。

从以下版本开始：

1.4

hashCode

public int hashCode()

返回此FontRenderContext的哈希码。

重写：

hashCode在 Object

结果

该对象的哈希码值。

另请参见：

Object.equals(java.lang.Object) ， System.identityHashCode(java.lang.Object)