public class FontRenderContext extends Object
FontRenderContext
クラスは、テキストの寸法を正しく測定するのに必要な情報のコンテナです。テキストのサイズは、アウトラインをピクセルにマップする規則や、アプリケーションが提供する描画ヒントによって変わる場合があります。
そのような情報の一例としては、印刷上のポイントをピクセルにスケーリングする変換情報があります。1ポイントは、1インチの1/72と定義されています。これは、伝統的な活版印刷以来使われているポイントとは、わずかに異なります。600 dpiのデバイスで12ptとして描画される文字のサイズは、同じ文字を72 dpiのデバイスで12ptとして描画する場合とは異なります。これは、フォントの設計時に指定された、ピクセル境界の丸めやヒントなどの要因のためです。
アプリケーションで指定されたアンチエイリアス、および部分メトリックスが、ピクセル境界の丸めのために、文字のサイズに影響を与えることがあります。
通常、FontRenderContext
のインスタンスはGraphics2D
オブジェクトから取得します。直接構築したFontRenderContext
は、実際のグラフィック・デバイスを表さない可能性が高く、予期しない結果や誤った結果になることがあります。
修飾子 | コンストラクタと説明 |
---|---|
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値を返します。 |
protected 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
- 新しく構築されるオブジェクトの部分メトリックスの有無を判定する。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
- ヒントが、有効な値のどれでもない場合。public boolean isTransformed()
FontRenderContext
オブジェクトが、変換された描画コンテキストでテキストを測定するかどうかを示します。FontRenderContext
オブジェクトが非恒等AffineTransform属性を持つ場合はtrue
、それ以外の場合はfalse
。getTransform()
public int getTransformType()
FontRenderContext
のアフィン変換の種類を、AffineTransform.getType()
で指定される整数で返します。AffineTransform
public AffineTransform getTransform()
FontRenderContext
で印刷上のポイントをピクセルにスケーリングするために使われる変換を返します。FontRenderContext
のAffineTransform
。AffineTransform
public boolean isAntiAliased()
FontRenderContext
で何らかのアンチエイリアス処理が指定されているかどうかを示すboolean値を返します。特定の描画ヒント値を取得するには、getAntiAliasingHint()
を呼び出してください。FontRenderContext
でテキストがアンチエイリアス処理されている場合はtrue
、そうでない場合はfalse
。RenderingHints.KEY_TEXT_ANTIALIASING
, FontRenderContext(AffineTransform,boolean,boolean)
, FontRenderContext(AffineTransform,Object,Object)
public boolean usesFractionalMetrics()
FontRenderContext
でテキストの部分メトリックス・モードが使用されるかどうかを示すboolean値を返します。対応する描画ヒント値を取得するには、getFractionalMetricsHint()
を呼び出してください。FontRenderContext
で部分メトリックスに従ってレイアウトを行う場合はtrue
、そうでない場合はfalse
。RenderingHints.KEY_FRACTIONALMETRICS
, FontRenderContext(AffineTransform,boolean,boolean)
, FontRenderContext(AffineTransform,Object,Object)
public Object getAntiAliasingHint()
FontRenderContext
で使われている、テキスト・アンチエイリアスの描画モード・ヒントを返します。これは、java.awt.RenderingHints
で定義されているテキスト・アンチエイリアスの描画ヒント値のいずれかになります。FontRenderContext
で使われている、テキスト・アンチエイリアスの描画モード・ヒント。public Object getFractionalMetricsHint()
FontRenderContext
で使われている、テキスト部分メトリックスの描画モード・ヒントを返します。これは、java.awt.RenderingHints
で定義されているテキスト部分メトリックスの描画ヒント値のいずれかになります。FontRenderContext
で使われている、テキスト部分メトリックスの描画モード・ヒント。public boolean equals(Object obj)
equals
、クラス: Object
obj
- 等しいかどうかが判定されるオブジェクトFontRenderContext
と等しい場合はtrue
、そうでない場合はfalse
。Object.hashCode()
、HashMap
public boolean equals(FontRenderContext rhs)
rhs
- 等しいかどうかが判定されるFontRenderContext
rhs
がこのFontRenderContext
と等しい場合はtrue
、そうでない場合はfalse
。public int hashCode()
hashCode
、クラス: Object
Object.equals(java.lang.Object)
, System.identityHashCode(java.lang.Object)
バグまたは機能を送信
詳細なAPIリファレンスおよび開発者ドキュメントについては、Java SEのドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2016, Oracle and/or its affiliates. All rights reserved.Use is subject to license termsDocumentation Redistribution Policyも参照してください。