java.awt
クラス RenderingHints

java.lang.Object
  |
  +--java.awt.RenderingHints

public class RenderingHints

extends Object

implements Map, Cloneable

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

内部クラスの概要

static class

RenderingHints.Key 描画用およびイメージ処理用のパイプラインのさまざまな側面を制御するために使われるすべてのキーの基底型を定義します。

フィールドの概要

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_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_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 です。

コンストラクタの詳細

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

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.remove、Set.remove、removeAll、retainAll、および clear の各オペレーションを介して RenderingHints から対応するマッピングを削除する要素削除処理をサポートします。add オペレーションや addAll オペレーションはサポートされていません。

定義:

インタフェース Map 内の keySet

戻り値:

この RenderingHints に格納されているキーの Set ビュー

values

public Collection values()

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

定義:

インタフェース Map 内の values

戻り値:

この RenderingHints に格納されている値の Collection ビュー

entrySet

public Set entrySet()

この RenderingHints に格納されているマッピングの Set ビューを返します。返される Set の各要素は Map.Entry です。Set は RenderingHints を基にするので、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 オブジェクト t1 と t2 は同じマッピングを表します。

 (t1.get(k)==null ? t2.get(k)==null : t1.get(k).equals(t2.get(k)))
 

. これにより、Map インタフェースの実装が異なる場合でも、equals メソッドは正しく動作することが保証されます。

定義:

インタフェース Map 内の equals

パラメータ:

o - この RenderingHints と等しいかどうかの比較対象となる Object

戻り値:

指定された Object がこの RenderingHints と等しい場合は true

オーバーライド:

クラス Object 内の equals

hashCode

public int hashCode()

この RenderingHints のハッシュコード値を返します。RenderingHints のハッシュコードは、RenderingHints オブジェクトの entrySet ビュー内の各 Entry の hashCode の合計になるように定義されます。これにより、Object.hashCode の汎用規約によって要求されるように、任意の 2 つの Map オブジェクト t1 と t2 で t1.equals(t2) ならば t1.hashCode()==t2.hashCode() となることが保証されます。

定義:

インタフェース Map 内の hashCode

戻り値:

この RenderingHints のハッシュコード値

オーバーライド:

クラス Object 内の hashCode

関連項目:

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