java.awt.font
クラス FontRenderContext

java.lang.Object
  java.awt.font.FontRenderContext

public class FontRenderContext
extends Object

FontRenderContext クラスは、テキストの寸法を正しく測定するのに必要な情報のコンテナです。テキストのサイズは、アウトラインをピクセルにマップする規則や、アプリケーションが提供する描画ヒントによって変わる場合があります。

そのような情報の一例としては、印刷上のポイントをピクセルにスケーリングする変換情報があります。1 ポイントは、1 インチの 1/72 と定義されています。 これは、伝統的な活版印刷以来使われているポイントとは、わずかに異なります。600 dpi のデバイスで 12pt として描画される文字のサイズは、同じ文字を 72 dpi のデバイスで 12pt として描画する場合とは異なります。 これは、フォントの設計時に指定された、ピクセル境界の丸めやヒントなどの要因のためです。

アプリケーションで指定された平滑化、および部分メトリックスが、ピクセル境界の丸めのために、文字のサイズに影響を与えることがあります。

通常、FontRenderContext のインスタンスは Graphics2D オブジェクトから取得します。直接構築した FontRenderContext は、実際のグラフィックデバイスを表さない可能性が多く、予期しない結果や誤った結果になることがあります。

関連項目:

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

コンストラクタの概要

protected	FontRenderContext() 新しい FontRenderContext オブジェクトを構築します。
	FontRenderContext(AffineTransform tx, boolean isAntiAliased, boolean usesFractionalMetrics) 任意指定の AffineTransform、および新しく構築されるオブジェクトの平滑化と部分メトリックスの有無を判定する 2 つの boolean 値から FontRenderContext オブジェクトを構築します。
	FontRenderContext(AffineTransform tx, Object aaHint, Object fmHint) 任意指定の AffineTransform、および新しく構築されるオブジェクトの平滑化と部分メトリックスの有無を判定する 2 つの Object 値から FontRenderContext オブジェクトを構築します。

メソッドの概要

boolean	equals(FontRenderContext rhs) rhs の変換、平滑化、および部分メトリックスの値がこれと等しい場合は true を返します。
boolean	equals(Object obj) obj が FontRenderContext のインスタンスであり、その変換、平滑化、および部分メトリックスの値がこれと等しい場合は true を返します。
Object	getAntiAliasingHint() この FontRenderContext で使われている、テキストアンチエイリアスの描画モードヒントを返します。
Object	getFractionalMetricsHint() この FontRenderContext で使われている、テキスト部分メトリックスの描画モードヒントを返します。
AffineTransform	getTransform() この FontRenderContext で印刷上のポイントをピクセルにスケーリングするために使われる変換を返します。
int	getTransformType() この FontRenderContext のアフィン変換の種類を、AffineTransform.getType() で指定される整数で返します。
int	hashCode() この FontRenderContext のハッシュコードを返します。
boolean	isAntiAliased() この FontRenderContext で何らかのアンチエイリアス処理が指定されているかどうかを示す boolean 値を返します。
boolean	isTransformed() この FontRenderContext オブジェクトが、変換された描画コンテキストでテキストを測定するかどうかを示します。
boolean	usesFractionalMetrics() この FontRenderContext でテキストの部分メトリックスモードが使用されるかどうかを示す boolean 値を返します。

クラス 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、および新しく構築されるオブジェクトの平滑化と部分メトリックスの有無を判定する 2 つの boolean 値から FontRenderContext オブジェクトを構築します。各場合とも、boolean 値 true と false は、描画ヒント値 ON と OFF にそれぞれ対応します。

ほかのヒント値を指定するには、描画ヒント値をパラメータとして指定するコンストラクタ FontRenderContext(AffineTransform, Object, Object) を使用してください。

パラメータ:

tx - この FontRenderContext で印刷上のポイントをピクセルにスケーリングするために使われる変換。null の場合は恒等変換が使用される

isAntiAliased - 新しく構築されるオブジェクトの平滑化の有無を判定する

usesFractionalMetrics - 新しく構築されるオブジェクトの部分メトリックスの有無を判定する

FontRenderContext

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

任意指定の AffineTransform、および新しく構築されるオブジェクトの平滑化と部分メトリックスの有無を判定する 2 つの Object 値から FontRenderContext オブジェクトを構築します。

パラメータ:

tx - この FontRenderContext で印刷上のポイントをピクセルにスケーリングするために使われる変換。null の場合は恒等変換が使用される

aaHint - java.awt.RenderingHints で定義されているテキストアンチエイリアスの描画ヒント値の 1 つ。ほかの値を指定すると IllegalArgumentException がスローされる。VALUE_TEXT_ANTIALIAS_DEFAULT も指定可能で、その場合、使用されるモードは実装により異なる

fmHint - - java.awt.RenderingHints で定義されているテキスト部分描画ヒント値の 1 つ。VALUE_FRACTIONALMETRICS_DEFAULT も指定可能で、その場合、使用されるモードは実装により異なる。ほかの値を指定すると IllegalArgumentException がスローされる

例外:

IllegalArgumentException - ヒントが、有効な値のどれでもない場合

導入されたバージョン:

1.6

メソッドの詳細

isTransformed

public boolean isTransformed()

この FontRenderContext オブジェクトが、変換された描画コンテキストでテキストを測定するかどうかを示します。

戻り値:

この FontRenderContext オブジェクトが非恒等 AffineTransform 属性を持つ場合は true、そうでない場合は false

導入されたバージョン:

1.6

関連項目:

getTransform()

getTransformType

public int getTransformType()

この FontRenderContext のアフィン変換の種類を、AffineTransform.getType() で指定される整数で返します。

戻り値:

変換の種類

導入されたバージョン:

1.6

関連項目:

AffineTransform

getTransform

public AffineTransform getTransform()

この FontRenderContext で印刷上のポイントをピクセルにスケーリングするために使われる変換を返します。

戻り値:

この FontRenderContext の AffineTransform

関連項目:

AffineTransform

isAntiAliased

public boolean isAntiAliased()

この FontRenderContext で何らかのアンチエイリアス処理が指定されているかどうかを示す boolean 値を返します。特定の描画ヒント値を取得するには、getAntiAliasingHint() を呼び出してください。

戻り値:

この FontRenderContext でテキストがアンチエイリアス処理されている場合は true、そうでない場合は false

関連項目:

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

usesFractionalMetrics

public boolean usesFractionalMetrics()

この FontRenderContext でテキストの部分メトリックスモードが使用されるかどうかを示す boolean 値を返します。対応する描画ヒント値を取得するには、getFractionalMetricsHint() を呼び出してください。

戻り値:

この FontRenderContext で部分メトリックスに従ってレイアウトを行う場合は true、そうでない場合は false

関連項目:

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

この FontRenderContext で使われている、テキスト部分メトリックスの描画モードヒントを返します。これは、java.awt.RenderingHints で定義されているテキスト部分メトリックスの描画ヒント値のいずれかになります。

戻り値:

この FontRenderContext で使われている、テキスト部分メトリックスの描画モードヒント

導入されたバージョン:

1.6

equals

public boolean equals(Object obj)

obj が FontRenderContext のインスタンスであり、その変換、平滑化、および部分メトリックスの値がこれと等しい場合は true を返します。

オーバーライド:

クラス Object 内の equals

パラメータ:

obj - 等しいかどうかが判定されるオブジェクト

戻り値:

指定されたオブジェクトがこの FontRenderContext と等しい場合は true、そうでない場合は false

関連項目:

Object.hashCode(), Hashtable

equals

public boolean equals(FontRenderContext rhs)

rhs の変換、平滑化、および部分メトリックスの値がこれと等しい場合は true を返します。

パラメータ:

rhs - 等しいかどうかが判定される FontRenderContext

戻り値:

rhs がこの FontRenderContext と等しい場合は true、そうでない場合は false

導入されたバージョン:

1.4

hashCode

public int hashCode()

この FontRenderContext のハッシュコードを返します。

オーバーライド:

クラス Object 内の hashCode

戻り値:

このオブジェクトのハッシュコード値

関連項目:

Object.equals(java.lang.Object), Hashtable