JavaTM 2 Platform
Std. Ed. v1.3

java.awt
クラス RenderingHints

java.lang.Object
  |
  +--java.awt.RenderingHints
すべての実装インタフェース:
Cloneable, Map

public class RenderingHints
extends Object
implements Map, Cloneable

RenderingHints クラスには、Graphics2D クラスや、BufferedImageOp および Raster を実装するクラスによって使用される描画ヒントが含まれています。


内部クラスの概要
static class RenderingHints.Key
          描画用およびイメージ処理用のパイプラインのさまざまな側面を制御するために使われるすべてのキーの基底型を定義します。
 
クラス java.util.Map から継承した内部クラス
Map.Entry
 
フィールドの概要
static RenderingHints.Key KEY_ALPHA_INTERPOLATION
          アルファ補間のヒントキーです。
static RenderingHints.Key KEY_ANTIALIASING
          アンチエイリアスのヒントキーです。
static RenderingHints.Key KEY_COLOR_RENDERING
          カラーレンダリングのヒントキーです。
static RenderingHints.Key KEY_DITHERING
          ディザリングのヒントキーです。
static RenderingHints.Key KEY_FRACTIONALMETRICS
          フォント部分メトリックスのヒントキーです。
static RenderingHints.Key KEY_INTERPOLATION
          補間のヒントキーです。
static RenderingHints.Key KEY_RENDERING
          レンダリングのヒントキーです。
static RenderingHints.Key KEY_STROKE_CONTROL
          ストローク正規化コントロールのヒントキーです。
static RenderingHints.Key KEY_TEXT_ANTIALIASING
          テキストアンチエイリアスのヒントキーです。
static Object VALUE_ALPHA_INTERPOLATION_DEFAULT
          アルファ補間のヒント値 ALPHA_INTERPOLATION_DEFAULT です。
static Object VALUE_ALPHA_INTERPOLATION_QUALITY
          アルファ補間のヒント値 ALPHA_INTERPOLATION_QUALITY です。
static Object VALUE_ALPHA_INTERPOLATION_SPEED
          アルファ補間のヒント値 ALPHA_INTERPOLATION_SPEED です。
static Object VALUE_ANTIALIAS_DEFAULT
          アンチエイリアスのヒント値です。
static Object VALUE_ANTIALIAS_OFF
          アンチエイリアスのヒント値です。
static Object VALUE_ANTIALIAS_ON
          アンチエイリアスのヒント値です。
static Object VALUE_COLOR_RENDER_DEFAULT
          カラーレンダリングのヒント値 COLOR_RENDER_DEFAULT です。
static Object VALUE_COLOR_RENDER_QUALITY
          カラーレンダリングのヒント値 COLOR_RENDER_QUALITY です。
static Object VALUE_COLOR_RENDER_SPEED
          カラーレンダリングのヒント値 COLOR_RENDER_SPEED です。
static Object VALUE_DITHER_DEFAULT
          ディザリングのヒント値です。
static Object VALUE_DITHER_DISABLE
          ディザリングのヒント値です。
static Object VALUE_DITHER_ENABLE
          ディザリングのヒント値です。
static Object VALUE_FRACTIONALMETRICS_DEFAULT
          フォント部分メトリックスのヒント値です。
static Object VALUE_FRACTIONALMETRICS_OFF
          フォント部分メトリックスのヒント値です。
static Object VALUE_FRACTIONALMETRICS_ON
          フォント部分メトリックスのヒント値です。
static Object VALUE_INTERPOLATION_BICUBIC
          補間のヒント値 INTERPOLATION_BICUBIC です。
static Object VALUE_INTERPOLATION_BILINEAR
          補間のヒント値 INTERPOLATION_BILINEAR です。
static Object VALUE_INTERPOLATION_NEAREST_NEIGHBOR
          補間のヒント値 INTERPOLATION_NEAREST_NEIGHBOR です。
static Object VALUE_RENDER_DEFAULT
          レンダリングのヒント値です。
static Object VALUE_RENDER_QUALITY
          レンダリングのヒント値です。
static Object VALUE_RENDER_SPEED
          レンダリングのヒント値です。
static Object VALUE_STROKE_DEFAULT
          ストローク正規化コントロールのヒント値 STROKE_DEFAULT です。
static Object VALUE_STROKE_NORMALIZE
          ストローク正規化コントロールのヒント値 STROKE_NORMALIZE です。
static Object VALUE_STROKE_PURE
          ストローク正規化コントロールのヒント値 STROKE_PURE です。
static Object VALUE_TEXT_ANTIALIAS_DEFAULT
          テキストアンチエイリアスのヒント値です。
static Object VALUE_TEXT_ANTIALIAS_OFF
          テキストアンチエイリアスのヒント値です。
static Object VALUE_TEXT_ANTIALIAS_ON
          テキストアンチエイリアスのヒント値です。
 
コンストラクタの概要
RenderingHints(Map init)
          キーと値を指定された Map オブジェクト (null の場合もある) から初期化して、オブジェクトを新しく構築します。
RenderingHints(RenderingHints.Key key, Object value)
          指定されたキーと値のペアでオブジェクトを新しく作成します。
 
メソッドの概要
 void add(RenderingHints hints)
          指定された RenderingHints オブジェクトからすべてのキーとその対応する値をこの RenderingHints オブジェクトに追加します。
 void clear()
          この RenderingHints オブジェクトからすべてのキーと値のペアを削除します。
 Object clone()
          この RenderingHints オブジェクトと同一の内容を持つ、この RenderingHints のクローン (複製) を作成します。
 boolean containsKey(Object key)
          この RenderingHints 内に、指定されたキーのマッピングが含まれている場合に true を返します。
 boolean containsValue(Object value)
          この RenderingHints が指定された値に 1 つ以上のキーをマッピングしている場合に true を返します。
 Set entrySet()
          この RenderingHints に格納されているマッピングの Set ビューを返します。
 boolean equals(Object o)
          指定された Object とこの RenderingHints が等しいかどうかを比較します。
 Object get(Object key)
          指定されたキーがマッピングされている値を返します。
 int hashCode()
          この RenderingHints のハッシュコード値を返します。
 boolean isEmpty()
          この RenderingHints 内にキーと値のマッピングがない場合に true を返します。
 Set keySet()
          この RenderingHints に格納されている Key の Set ビューを返します。
 Object put(Object key, Object value)
          この RenderingHints オブジェクトで、指定された key を指定された value にマッピングします。
 void putAll(Map m)
          指定された Map からすべてのマッピングをこの RenderingHints にコピーします。
 Object remove(Object key)
          この RenderingHints オブジェクトから、指定されたキーとその対応する値を削除します。
 int size()
          この RenderingHints 内のキーと値のマッピングの数を返します。
 String toString()
          この RenderingHints オブジェクトのキーと値のマッピングを格納するハッシュマップの比較的長い文字列表現を返します。
 Collection values()
          この RenderingHints に格納されている値の Collection ビューを返します。
 
クラス java.lang.Object から継承したメソッド
finalize, getClass, notify, notifyAll, wait, wait, wait
 

フィールドの詳細

KEY_ANTIALIASING

public static final RenderingHints.Key KEY_ANTIALIASING
アンチエイリアスのヒントキーです。

VALUE_ANTIALIAS_ON

public static final Object VALUE_ANTIALIAS_ON
アンチエイリアスのヒント値です。描画はアンチエイリアスを使って行われます。

VALUE_ANTIALIAS_OFF

public static final Object VALUE_ANTIALIAS_OFF
アンチエイリアスのヒント値です。描画はアンチエイリアスなしで行われます。

VALUE_ANTIALIAS_DEFAULT

public static final Object VALUE_ANTIALIAS_DEFAULT
アンチエイリアスのヒント値です。描画はプラットフォームのデフォルトのアンチエイリアスモードを使って行われます。

KEY_RENDERING

public static final RenderingHints.Key KEY_RENDERING
レンダリングのヒントキーです。

VALUE_RENDER_SPEED

public static final Object VALUE_RENDER_SPEED
レンダリングのヒント値です。出力速度の設定に合わせて適切なレンダリングアルゴリズムが選択されます。

VALUE_RENDER_QUALITY

public static final Object VALUE_RENDER_QUALITY
レンダリングのヒント値です。出力画質の設定に合わせて適切なレンダリングアルゴリズムが選択されます。

VALUE_RENDER_DEFAULT

public static final Object VALUE_RENDER_DEFAULT
レンダリングのヒント値です。プラットフォームのデフォルトのレンダリングアルゴリズムが選択されます。

KEY_DITHERING

public static final RenderingHints.Key KEY_DITHERING
ディザリングのヒントキーです。

VALUE_DITHER_DISABLE

public static final Object VALUE_DITHER_DISABLE
ディザリングのヒント値です。描画時にディザリングを行いません。

VALUE_DITHER_ENABLE

public static final Object VALUE_DITHER_ENABLE
ディザリングのヒント値です。必要に応じて描画時にディザリングを行います。

VALUE_DITHER_DEFAULT

public static final Object VALUE_DITHER_DEFAULT
ディザリングのヒント値です。ディザリングにプラットフォームのデフォルトを使用します。

KEY_TEXT_ANTIALIASING

public static final RenderingHints.Key KEY_TEXT_ANTIALIASING
テキストアンチエイリアスのヒントキーです。

VALUE_TEXT_ANTIALIAS_ON

public static final Object VALUE_TEXT_ANTIALIAS_ON
テキストアンチエイリアスのヒント値です。テキスト描画はアンチエイリアスを使って行われます。

VALUE_TEXT_ANTIALIAS_OFF

public static final Object VALUE_TEXT_ANTIALIAS_OFF
テキストアンチエイリアスのヒント値です。テキスト描画はアンチエイリアスなしで行われます。

VALUE_TEXT_ANTIALIAS_DEFAULT

public static final Object VALUE_TEXT_ANTIALIAS_DEFAULT
テキストアンチエイリアスのヒント値です。テキスト描画は、プラットフォームのデフォルトのテキストアンチエイリアスモードを使って行われます。

KEY_FRACTIONALMETRICS

public static final RenderingHints.Key KEY_FRACTIONALMETRICS
フォント部分メトリックスのヒントキーです。

VALUE_FRACTIONALMETRICS_OFF

public static final Object VALUE_FRACTIONALMETRICS_OFF
フォント部分メトリックスのヒント値です。部分メトリックスは使用不可です。

VALUE_FRACTIONALMETRICS_ON

public static final Object VALUE_FRACTIONALMETRICS_ON
フォント部分メトリックスのヒント値です。部分メトリックスは使用可能です。

VALUE_FRACTIONALMETRICS_DEFAULT

public static final Object VALUE_FRACTIONALMETRICS_DEFAULT
フォント部分メトリックスのヒント値です。部分メトリックスとして、プラットフォームのデフォルトを使用します。

KEY_INTERPOLATION

public static final RenderingHints.Key KEY_INTERPOLATION
補間のヒントキーです。

VALUE_INTERPOLATION_NEAREST_NEIGHBOR

public static final Object VALUE_INTERPOLATION_NEAREST_NEIGHBOR
補間のヒント値 INTERPOLATION_NEAREST_NEIGHBOR です。

VALUE_INTERPOLATION_BILINEAR

public static final Object VALUE_INTERPOLATION_BILINEAR
補間のヒント値 INTERPOLATION_BILINEAR です。

VALUE_INTERPOLATION_BICUBIC

public static final Object VALUE_INTERPOLATION_BICUBIC
補間のヒント値 INTERPOLATION_BICUBIC です。

KEY_ALPHA_INTERPOLATION

public static final RenderingHints.Key KEY_ALPHA_INTERPOLATION
アルファ補間のヒントキーです。

VALUE_ALPHA_INTERPOLATION_SPEED

public static final Object VALUE_ALPHA_INTERPOLATION_SPEED
アルファ補間のヒント値 ALPHA_INTERPOLATION_SPEED です。

VALUE_ALPHA_INTERPOLATION_QUALITY

public static final Object VALUE_ALPHA_INTERPOLATION_QUALITY
アルファ補間のヒント値 ALPHA_INTERPOLATION_QUALITY です。

VALUE_ALPHA_INTERPOLATION_DEFAULT

public static final Object VALUE_ALPHA_INTERPOLATION_DEFAULT
アルファ補間のヒント値 ALPHA_INTERPOLATION_DEFAULT です。

KEY_COLOR_RENDERING

public static final RenderingHints.Key KEY_COLOR_RENDERING
カラーレンダリングのヒントキーです。

VALUE_COLOR_RENDER_SPEED

public static final Object VALUE_COLOR_RENDER_SPEED
カラーレンダリングのヒント値 COLOR_RENDER_SPEED です。

VALUE_COLOR_RENDER_QUALITY

public static final Object VALUE_COLOR_RENDER_QUALITY
カラーレンダリングのヒント値 COLOR_RENDER_QUALITY です。

VALUE_COLOR_RENDER_DEFAULT

public static final Object VALUE_COLOR_RENDER_DEFAULT
カラーレンダリングのヒント値 COLOR_RENDER_DEFAULT です。

KEY_STROKE_CONTROL

public static final RenderingHints.Key KEY_STROKE_CONTROL
ストローク正規化コントロールのヒントキーです。

VALUE_STROKE_DEFAULT

public static final Object VALUE_STROKE_DEFAULT
ストローク正規化コントロールのヒント値 STROKE_DEFAULT です。

VALUE_STROKE_NORMALIZE

public static final Object VALUE_STROKE_NORMALIZE
ストローク正規化コントロールのヒント値 STROKE_NORMALIZE です。

VALUE_STROKE_PURE

public static final Object VALUE_STROKE_PURE
ストローク正規化コントロールのヒント値 STROKE_PURE です。
コンストラクタの詳細

RenderingHints

public RenderingHints(Map init)
キーと値を指定された Map オブジェクト (null の場合もある) から初期化して、オブジェクトを新しく構築します。
パラメータ:
init - ヒントを初期化するキーと値のペアのマップ。オブジェクトを空にする場合は null

RenderingHints

public RenderingHints(RenderingHints.Key key,
                      Object value)
指定されたキーと値のペアでオブジェクトを新しく作成します。
パラメータ:
key - 特定のヒントプロパティのキー
value - key で指定されたヒントプロパティの値
メソッドの詳細

size

public int size()
この RenderingHints 内のキーと値のマッピングの数を返します。
定義:
インタフェース Map 内の size
戻り値:
この RenderingHints 内のキーと値のマッピングの数

isEmpty

public boolean isEmpty()
この RenderingHints 内にキーと値のマッピングがない場合に true を返します。
定義:
インタフェース Map 内の isEmpty
戻り値:
この RenderingHints がキーと値のマッピングを保持しない場合は true

containsKey

public boolean containsKey(Object key)
この RenderingHints 内に、指定されたキーのマッピングが含まれている場合に true を返します。
定義:
インタフェース Map 内の containsKey
パラメータ:
key - この RenderingHints 内にあるかどうかテスト対象となるキー
戻り値:
この RenderingHints 内に、指定されたキーのマッピングが含まれている場合は true
例外:
ClassCastException - key が RenderingHints.Key タイプではない場合
NullPointerException -  
NullPointerException - key が null の場合

containsValue

public boolean containsValue(Object value)
この RenderingHints が指定された値に 1 つ以上のキーをマッピングしている場合に true を返します。つまり、この RenderingHints に次のような値 v へのマッピングが 1 つ以上ある場合に限り true を返します。
 (value==null ? v==null : value.equals(v))
RenderingHints のほとんどの実装で、このオペレーションは RenderingHints のサイズに正比例して時間がかかります。
定義:
インタフェース Map 内の containsValue
パラメータ:
value - この RenderingHints 内にあるかどうかテスト対象となる値
戻り値:
この RenderingHints が、指定された値に 1 つ以上のキーをマッピングしている場合は true

get

public Object get(Object key)
指定されたキーがマッピングされている値を返します。
定義:
インタフェース Map 内の get
パラメータ:
key - 描画ヒントキー
戻り値:
このオブジェクトで指定されたキーがマッピングされている値。そのキーがこのオブジェクトでどの値にもマッピングされていない場合は null
例外:
ClassCastException - key が RenderingHints.Key タイプではない場合
関連項目:
put(Object, Object)

put

public Object put(Object key,
                  Object value)
この RenderingHints オブジェクトで、指定された key を指定された value にマッピングします。キーにも、値にも null は指定できません。値は、元のキーと等しいキーで get メソッドを呼び出すことにより取得できます。
定義:
インタフェース Map 内の put
パラメータ:
key - 描画ヒントキー
value - 描画ヒント値
戻り値:
このオブジェクトの指定されたキーの前の値。それがない場合は null
例外:
NullPointerException - キーまたは値が null の場合
ClassCastException - key が RenderingHints.Key タイプではない場合
IllegalArgumentException - value が、指定されたキーに対して適切ではない場合
関連項目:
get(Object)

add

public void add(RenderingHints hints)
指定された RenderingHints オブジェクトからすべてのキーとその対応する値をこの RenderingHints オブジェクトに追加します。この RenderingHints オブジェクトに存在するが、指定された RenderingHints オブジェクトにないキーは影響を受けません。
パラメータ:
hints - この RenderingHints オブジェクトに追加されるキーと値のペアのセット

clear

public void clear()
この RenderingHints オブジェクトからすべてのキーと値のペアを削除します。
定義:
インタフェース Map 内の clear
インタフェース java.util.Map からコピーされたタグ:
例外:
UnsupportedOperationException - clear がマップによってサポートされていない場合

remove

public Object remove(Object key)
この RenderingHints オブジェクトから、指定されたキーとその対応する値を削除します。指定されたキーがこの RenderingHints オブジェクトにない場合、このメソッドは何もしません。
定義:
インタフェース Map 内の remove
パラメータ:
key - 削除される描画ヒントキー
戻り値:
この RenderingHints オブジェクトでキーが以前にマッピングされていた値。キーがマッピングを持っていなかった場合は null
例外:
ClassCastException - key が RenderingHints.Key タイプではない場合

putAll

public void putAll(Map m)
指定された Map からすべてのマッピングをこの RenderingHints にコピーします。それらのマッピングは、指定された Map に現在あるキーに対応する、この RenderingHints にあったマッピングを置換します。
定義:
インタフェース Map 内の putAll
パラメータ:
t - この RenderingHints に格納されるマッピング
例外:
ClassCastException - 指定された Map のキーまたは値のクラスが原因で、この RenderingHints に格納できない場合
IllegalArgumentException - 指定された Map のキーまたは値の特性が原因で、この RenderingHints に格納できない場合

keySet

public Set keySet()
この RenderingHints に格納されている Key の Set ビューを返します。Set は RenderingHints を基にしているので、RenderingHints への変更は Set で反映され、その逆方向でも反映されます。Set の繰り返し処理の進行中に RenderingHints が変更される場合、繰り返し処理の結果は保証されません。Set は、Iterator.removeSet.removeremoveAllretainAll、および clear の各オペレーションを介して RenderingHints から対応するマッピングを削除する要素削除処理をサポートします。add オペレーションや addAll オペレーションはサポートされていません。
定義:
インタフェース Map 内の keySet
戻り値:
この RenderingHints に格納されているキーの Set ビュー

values

public Collection values()
この RenderingHints に格納されている値の Collection ビューを返します。CollectionRenderingHints を基にするので、RenderingHints への変更は Collection で反映され、その逆方向でも反映されます。Collection の繰り返し処理の進行中に RenderingHints が変更される場合、繰り返し処理の結果は保証されません。Collection は、Iterator.removeCollection.removeremoveAllretainAll、および clear の各オペレーションを介して RenderingHints から対応するマッピングを削除する要素削除処理をサポートします。add オペレーションや addAll オペレーションはサポートされていません。
定義:
インタフェース Map 内の values
戻り値:
この RenderingHints に格納されている値の Collection ビュー

entrySet

public Set entrySet()
この RenderingHints に格納されているマッピングの Set ビューを返します。返される Set の各要素は Map.Entry です。SetRenderingHints を基にするので、RenderingHints への変更は Set で反映され、その逆方向でも反映されます。Set の繰り返し処理の進行中に RenderingHints が変更される場合、繰り返し処理の結果は保証されません。

RenderingHints オブジェクトから返される entrySet は変更できません。

定義:
インタフェース Map 内の entrySet
戻り値:
この RenderingHints に格納されているマッピングの Set ビュー

equals

public boolean equals(Object o)
指定された Object とこの RenderingHints が等しいかどうかを比較します。指定されたオブジェクトも Map であり、2 つの Map オブジェクトが同じマッピングを表す場合に true を返します。つまり、t1.keySet().equals(t2.keySet()) であり、t1.keySet() 内のすべてのキー k で次のような場合に、2 つの Map オブジェクト t1t2 は同じマッピングを表します。
 (t1.get(k)==null ? t2.get(k)==null : t1.get(k).equals(t2.get(k)))
これにより、Map インタフェースの実装が異なる場合でも、equals メソッドは正しく動作することが保証されます。
定義:
インタフェース Map 内の equals
オーバーライド:
クラス Object 内の equals
パラメータ:
o - この RenderingHints と等しいかどうかの比較対象となる Object
戻り値:
指定された Object がこの RenderingHints と等しい場合は true

hashCode

public int hashCode()
この RenderingHints のハッシュコード値を返します。RenderingHints のハッシュコードは、RenderingHints オブジェクトの entrySet ビュー内の各 Entry の hashCode の合計になるように定義されます。これにより、Object.hashCode の汎用規約によって要求されるように、任意の 2 つの Map オブジェクト t1t2t1.equals(t2) ならば t1.hashCode()==t2.hashCode() となることが保証されます。
定義:
インタフェース Map 内の hashCode
オーバーライド:
クラス Object 内の hashCode
戻り値:
この RenderingHints のハッシュコード値
関連項目:
Map.Entry.hashCode(), Object.hashCode(), Object.equals(Object), equals(Object)

clone

public Object clone()
この RenderingHints オブジェクトと同一の内容を持つ、この RenderingHints のクローン (複製) を作成します。
オーバーライド:
クラス Object 内の clone
戻り値:
このインスタンスのクローン (複製)

toString

public String toString()
この RenderingHints オブジェクトのキーと値のマッピングを格納するハッシュマップの比較的長い文字列表現を返します。
オーバーライド:
クラス Object 内の toString
戻り値:
このオブジェクトの文字列表現

JavaTM 2 Platform
Std. Ed. v1.3

バグや機能要求の報告
さらに詳しい API リファレンスおよび開発者ドキュメントについては、 Java 2 SDK SE Developer Documentation を参照してください。このドキュメントには、概念、用語の定義、回避策、 実用的なコード例など、開発者を対象にした詳細な解説が掲載されています。

Java、Java 2D、JDBC は、米国およびその他の国における米国 Sun Microsystems, Inc. の商標もしくは登録商標です。
Copyright 1993-2000 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.