JavaTM 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

RenderingHints 类包含可由 Graphics2D 类,以及实现 BufferedImageOpRaster 的类使用的呈现提示。


嵌套类摘要
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.removeSet.removeremoveAllretainAllclear 操作,此 Set 支持元素移除,可从 RenderingHints 中移除相应的映射关系。它不支持 addaddAll 操作。

指定者:
接口 Map<Object,Object> 中的 keySet
返回:
RenderingHints 所包含的键的 Set 视图。

values

public Collection<Object> values()
返回此 RenderingHints 中包含的值的 Collection 视图。CollectionRenderingHints 的支持,所以对 RenderingHints 的更改反映在 Collection 中,反之亦然。如果在对 Collection 进行迭代的同时修改了 RenderingHints,则迭代的结果是不确定的。通过 Iterator.removeCollection.removeremoveAllretainAllclear 操作,此 Collection 支持元素移除,可从 RenderingHints 中移除相应的映射关系。它不支持 addaddAll 操作。

指定者:
接口 Map<Object,Object> 中的 values
返回:
RenderingHints 所包含的值的 Collection 视图。

entrySet

public Set<Map.Entry<Object,Object>> entrySet()
返回此 RenderingHints 中包含的映射关系的 Set 视图。在返回的 Set 中,每个元素都是一个 Map.EntrySetRenderingHints 的支持,所以对 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))),
t1t2 这两个 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 对象 t1t2 而言,都存在 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
返回:
此对象的字符串表示形式。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策