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

オーバーライド:

クラス Object 内の equals

パラメータ:

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

戻り値:

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

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

オーバーライド:

クラス 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

戻り値:

このオブジェクトの文字列表現