FontRenderContext (Java Platform SE 7)

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 を返します。
    
    オーバーライド:
    
    equals、クラス: Object
    
    パラメータ:
    obj - 等しいかどうかが判定されるオブジェクト
    
    戻り値:
    指定されたオブジェクトがこの FontRenderContext と等しい場合は true、そうでない場合は false。
    関連項目:
    Object.hashCode()、HashMap
  - equals
```
public boolean equals(FontRenderContext rhs)
```
    rhs の変換、アンチエイリアス、および部分メトリックスの値がこれと等しい場合は true を返します。
    
    パラメータ:
    rhs - 等しいかどうかが判定される FontRenderContext
    
    戻り値:
    rhs がこの FontRenderContext と等しい場合は true、そうでない場合は false。
    導入されたバージョン:
    
    1.4
  - hashCode
```
public int hashCode()
```
    この FontRenderContext のハッシュコードを返します。
    
    オーバーライド:
    
    hashCode、クラス: Object
    
    戻り値:
    このオブジェクトのハッシュコード値。
    関連項目:
    Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

バグまたは機能を送信
詳細な API リファレンスおよび開発者ドキュメントについては、Java SE のドキュメントを参照してください。そのドキュメントには、概念的な概要、用語の定義、回避方法、有効なコード例などの、開発者を対象にしたより詳細な説明が含まれています。
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.

クラス FontRenderContext

コンストラクタのサマリー

メソッドのサマリー

クラス java.lang.Object から継承されたメソッド

コンストラクタの詳細

FontRenderContext

FontRenderContext

FontRenderContext

メソッドの詳細

isTransformed

getTransformType

getTransform

isAntiAliased

usesFractionalMetrics

getAntiAliasingHint

getFractionalMetricsHint

equals

equals

hashCode