java.awt
类 RenderingHints

java.lang.Object
  java.awt.RenderingHints

所有已实现的接口：

Cloneable, Map<Object,Object>

public class RenderingHints
extends Object
implements Map<Object,Object>, Cloneable

RenderingHints 类包含可由 Graphics2D 类，以及实现 BufferedImageOp 和 Raster 的类使用的呈现提示。

嵌套类摘要

static class

RenderingHints.Key 定义用来控制呈现和图像管线各个方面的所有键的基本类型。

从接口 java.util.Map 继承的嵌套类/接口

Map.Entry<K,V>

字段摘要

static RenderingHints.Key	KEY_ALPHA_INTERPOLATION Alpha 插值提示键。
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 插值提示值——ALPHA_INTERPOLATION_DEFAULT。
static Object	VALUE_ALPHA_INTERPOLATION_QUALITY Alpha 插值提示值——ALPHA_INTERPOLATION_QUALITY。
static Object	VALUE_ALPHA_INTERPOLATION_SPEED Alpha 插值提示值——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<RenderingHints.Key,?> 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 将一个或多个键映射到指定值，则返回 true。
Set<Map.Entry<Object,Object>>	entrySet() 返回此 RenderingHints 中包含的映射关系的 Set 视图。
boolean	equals(Object o) 对指定的 Object 对象与此 RenderingHints 进行相等性比较。
Object	get(Object key) 返回指定键所映射的值。
int	hashCode() 返回此 RenderingHints 中的哈希码值。
boolean	isEmpty() 如果此 RenderingHints 未包含键-值映射关系，则返回 true。
Set<Object>	keySet() 返回此 RenderingHints 中包含的 Key 的 Set 视图。
Object	put(Object key, Object value) 将指定 key 映射到此 RenderingHints 对象中的指定 value。
void	putAll(Map<?,?> m) 将指定 Map 中所有映射关系复制到此 RenderingHints 中。
Object	remove(Object key) 从此 RenderingHints 对象中移除键和它所对应的值。
int	size() 返回此 RenderingHints 中的键-值映射关系数。
String	toString() 返回 hashmap 的一个相当长的字符串表示形式，该 hashmap 包含此 RenderingHints 对象的键或值的映射关系。
Collection<Object>	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

Alpha 插值提示键。

VALUE_ALPHA_INTERPOLATION_SPEED

public static final Object VALUE_ALPHA_INTERPOLATION_SPEED

Alpha 插值提示值——ALPHA_INTERPOLATION_SPEED。

VALUE_ALPHA_INTERPOLATION_QUALITY

public static final Object VALUE_ALPHA_INTERPOLATION_QUALITY

Alpha 插值提示值——ALPHA_INTERPOLATION_QUALITY。

VALUE_ALPHA_INTERPOLATION_DEFAULT

public static final Object VALUE_ALPHA_INTERPOLATION_DEFAULT

Alpha 插值提示值——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<RenderingHints.Key,?> init)

构造一个新对象，该对象具有从指定 Map 对象（可能为 null）初始化的键和值。

参数：

init - 初始化提示的键/值对映射，如果对象应为空，则该参数为 null

RenderingHints

public RenderingHints(RenderingHints.Key key,
                      Object value)

构造一个具有指定键/值对的新对象。

参数：

key - 特定提示属性的键

value - 用 key 指定的提示属性的值

方法详细信息

size

public int size()

返回此 RenderingHints 中的键-值映射关系数。

指定者：

接口 Map<Object,Object> 中的 size

返回：

此 RenderingHints 中的键-值映射关系数。

isEmpty

public boolean isEmpty()

如果此 RenderingHints 未包含键-值映射关系，则返回 true。

指定者：

接口 Map<Object,Object> 中的 isEmpty

返回：

如果此 RenderingHints 未包含键-值映射关系，则返回 true。

containsKey

public boolean containsKey(Object key)

如果此 RenderingHints 包含指定键的映射关系，则返回 true。

指定者：

接口 Map<Object,Object> 中的 containsKey

参数：

key - 测试其是否存在于此 RenderingHints 中的键。

返回：

如果此 RenderingHints 包含指定键的映射关系，则返回 true。

抛出：

ClassCastException - 键的类型不是 RenderingHints.Key

NullPointerException - 键为 null

containsValue

public boolean containsValue(Object value)

如果此 RenderingHints 将一个或多个键映射到指定值，则返回 true。更正式地说，当且仅当此 RenderingHints 包含至少一个到满足以下条件的值 v 的映射关系时返回 true：

(value==null ? v==null :value.equals(v))。
 
对于大部分 RenderingHints 实现而言，此操作需要的时间可能会与 RenderingHints 的大小呈线性关系。


指定者：
接口 Map<Object,Object> 中的 containsValue


参数：
value - 测试是否存在于此 RenderingHints 中的值。
返回：
如果此 RenderingHints 将一个或多个键映射到指定值，则返回 true。

get

public Object get(Object key)

返回指定键所映射的值。

指定者：

接口 Map<Object,Object> 中的 get

参数：

key - 呈现提示键

返回：

此对象中该键所映射的值；如果该键没有映射到此对象中的任何值，则返回 null。

抛出：

ClassCastException - 键的类型不是 RenderingHints.Key。

另请参见：

put(Object, Object)

put

public Object put(Object key,
                  Object value)

将指定 key 映射到此 RenderingHints 对象中的指定 value。key 和 value 都不可以是 null。通过使用与原来的键相同的键调用 get 方法，可以检索到该值。

指定者：

接口 Map<Object,Object> 中的 put

参数：

key - 呈现提示键。

key - 呈现提示值。

value - 与指定键相关联的值。

返回：

此对象中指定键以前的值；如果不存在该值，则返回 null。

抛出：

NullPointerException - 如果 key 或 value 为 null。

ClassCastException - 键的类型不是 RenderingHints.Key。

IllegalArgumentException - 值不适合指定的键。

另请参见：

get(Object)

add

public void add(RenderingHints hints)

将指定 RenderingHints 对象中的所有键和相应的值添加到此 RenderingHints 对象中。位于此 RenderingHints 对象中，但不在指定的 RenderingHints 对象中的键不受影响。

参数：

hints - 添加到此 RenderingHints 对象中的键/值对的集合

clear

public void clear()

清除所有键/值对的 RenderingHints 对象。

指定者：

接口 Map<Object,Object> 中的 clear

remove

public Object remove(Object key)

从此 RenderingHints 对象中移除键和它所对应的值。如果该键不在此 RenderingHints 对象中，则此方法不执行任何操作。

指定者：

接口 Map<Object,Object> 中的 remove

参数：

key - 需要移除的呈现提示键

返回：

该键在此 RenderingHints 对象中以前被映射的值，如果该键没有映射关系，则返回 null。

抛出：

ClassCastException - 键的类型不是 RenderingHints.Key。

putAll

public void putAll(Map<?,?> m)

将指定 Map 中所有映射关系复制到此 RenderingHints 中。这些映射关系将替换此 RenderingHints 中针对指定 Map 中的当前所有键而存在的所有映射关系。

指定者：

接口 Map<Object,Object> 中的 putAll

参数：

m - 指定的 Map

抛出：

ClassCastException - 指定 Map 中的键或值的类不允许将其存储在此 RenderingHints 中。

IllegalArgumentException - 如果指定 Map 中的键或值的某些方面不允许将其存储在此中。

keySet

public Set<Object> keySet()

返回此 RenderingHints 中包含的 Key 的 Set 视图。Set 受 RenderingHints 的支持，所以对 RenderingHints 的更改反映在 Set 中，反之亦然。如果在对 Set 进行迭代的同时修改了 RenderingHints，则迭代的结果是不确定的。通过 Iterator.remove、Set.remove、removeAll、retainAll 和 clear 操作，此 Set 支持元素移除，可从 RenderingHints 中移除相应的映射关系。它不支持 add 或 addAll 操作。

指定者：

接口 Map<Object,Object> 中的 keySet

返回：

此 RenderingHints 所包含的键的 Set 视图。

values

public Collection<Object> values()

返回此 RenderingHints 中包含的值的 Collection 视图。Collection 受 RenderingHints 的支持，所以对 RenderingHints 的更改反映在 Collection 中，反之亦然。如果在对 Collection 进行迭代的同时修改了 RenderingHints，则迭代的结果是不确定的。通过 Iterator.remove、Collection.remove、removeAll、retainAll 和 clear 操作，此 Collection 支持元素移除，可从 RenderingHints 中移除相应的映射关系。它不支持 add 或 addAll 操作。

指定者：

接口 Map<Object,Object> 中的 values

返回：

此 RenderingHints 所包含的值的 Collection 视图。

entrySet

public Set<Map.Entry<Object,Object>> entrySet()

返回此 RenderingHints 中包含的映射关系的 Set 视图。在返回的 Set 中，每个元素都是一个 Map.Entry。Set 受 RenderingHints 的支持，所以对 RenderingHints 的更改反映在 Set 中，反之亦然。如果在对 Set 进行迭代的同时修改了 RenderingHints，则迭代的结果是不确定的。

从 RenderingHints 对象中返回的 entrySet 是不可修改的。

指定者：

接口 Map<Object,Object> 中的 entrySet

返回：

此 RenderingHints 所包含的映射关系的 Set 视图。

equals

public boolean equals(Object o)

对指定的 Object 对象与此 RenderingHints 进行相等性比较。如果指定对象也是一个 Map，并且这两个 Map 对象表示相同的映射关系，则返回 true。更正式地说，如果 t1.keySet().equals(t2.keySet())，并且对于 t1.keySet() 中的每个键 k，都存在

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

则 t1 和 t2 这两个 Map 对象表示相同的映射关系。 这确保了 equals 方法在 Map 接口的不同实现中能够正常工作。

指定者：

接口 Map<Object,Object> 中的 equals

覆盖：

类 Object 中的 equals

参数：

o - 要与此 RenderingHints 进行相等性比较的 Object。

返回：

如果指定的 Object 等于此 RenderingHints，则返回 true。

另请参见：

Object.hashCode(), Hashtable

hashCode

public int hashCode()

返回此 RenderingHints 中的哈希码值。RenderingHints 的哈希码被定义为此 RenderingHints 对象的 entrySet 视图中每个 Entry 的 hashCode 之和。这确保了 t1.equals(t2) 意味着对于任何两个 Map 对象 t1 和 t2 而言，都存在 t1.hashCode()==t2.hashCode()，这是 Object.hashCode 的通用协定所要求的。

指定者：

接口 Map<Object,Object> 中的 hashCode

覆盖：

类 Object 中的 hashCode

返回：

此 RenderingHints 的哈希码值。

另请参见：

Map.Entry.hashCode(), Object.hashCode(), Object.equals(Object), equals(Object)

clone

public Object clone()

创建此 RenderingHints 对象的一个克隆，它与此 RenderingHints 对象具有相同的内容。

覆盖：

类 Object 中的 clone

返回：

此实例的一个克隆。

另请参见：

Cloneable

toString

public String toString()

返回 hashmap 的一个相当长的字符串表示形式，该 hashmap 包含此 RenderingHints 对象的键或值的映射关系。

覆盖：

类 Object 中的 toString

返回：

此对象的字符串表示形式。