RenderingHints

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 5.0

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

java.awt
类 RenderingHints

java.lang.Object
  java.awt.RenderingHints

所有已实现的接口：: Cloneable, Map<Object,Object>

public class RenderingHints
extends Object
implements Map<Object,Object>, Cloneable
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 的通用协定所要求的。