|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectjava.awt.RenderingHints
public class RenderingHints
A collection of (key, value) items that provide 'hints' for the
Graphics2D
rendering pipeline. Because these
items are hints only, they may be ignored by a particular
Graphics2D
implementation.
Nested Class Summary | |
---|---|
static class |
RenderingHints.Key
The base class used to represent keys. |
Nested classes/interfaces inherited from interface java.util.Map |
---|
Map.Entry<K,V> |
Field Summary | |
---|---|
static RenderingHints.Key |
KEY_ALPHA_INTERPOLATION
A key for the 'alpha interpolation' hint. |
static RenderingHints.Key |
KEY_ANTIALIASING
A key for the 'antialiasing' hint. |
static RenderingHints.Key |
KEY_COLOR_RENDERING
A key for the 'color rendering' hint. |
static RenderingHints.Key |
KEY_DITHERING
A key for the 'dithering' hint. |
static RenderingHints.Key |
KEY_FRACTIONALMETRICS
A key for the 'fractional metrics' hint. |
static RenderingHints.Key |
KEY_INTERPOLATION
A key for the 'interpolation' hint. |
static RenderingHints.Key |
KEY_RENDERING
A key for the 'rendering' hint. |
static RenderingHints.Key |
KEY_STROKE_CONTROL
A key for the 'stroke control' hint. |
static RenderingHints.Key |
KEY_TEXT_ANTIALIASING
A key for the 'text antialiasing' hint. |
static Object |
VALUE_ALPHA_INTERPOLATION_DEFAULT
This value is for use with the KEY_ALPHA_INTERPOLATION key. |
static Object |
VALUE_ALPHA_INTERPOLATION_QUALITY
This value is for use with the KEY_ALPHA_INTERPOLATION key. |
static Object |
VALUE_ALPHA_INTERPOLATION_SPEED
This value is for use with the KEY_ALPHA_INTERPOLATION key. |
static Object |
VALUE_ANTIALIAS_DEFAULT
This value is for use with the KEY_ANTIALIASING key. |
static Object |
VALUE_ANTIALIAS_OFF
This value is for use with the KEY_ANTIALIASING key. |
static Object |
VALUE_ANTIALIAS_ON
This value is for use with the KEY_ANTIALIASING key. |
static Object |
VALUE_COLOR_RENDER_DEFAULT
This value is for use with the KEY_COLOR_RENDERING key. |
static Object |
VALUE_COLOR_RENDER_QUALITY
This value is for use with the KEY_COLOR_RENDERING key. |
static Object |
VALUE_COLOR_RENDER_SPEED
This value is for use with the KEY_COLOR_RENDERING key. |
static Object |
VALUE_DITHER_DEFAULT
This value is for use with the KEY_DITHERING key. |
static Object |
VALUE_DITHER_DISABLE
This value is for use with the KEY_DITHERING key. |
static Object |
VALUE_DITHER_ENABLE
This value is for use with the KEY_DITHERING key. |
static Object |
VALUE_FRACTIONALMETRICS_DEFAULT
This value is for use with the KEY_FRACTIONALMETRICS key. |
static Object |
VALUE_FRACTIONALMETRICS_OFF
This value is for use with the KEY_FRACTIONALMETRICS key. |
static Object |
VALUE_FRACTIONALMETRICS_ON
This value is for use with the KEY_FRACTIONALMETRICS key. |
static Object |
VALUE_INTERPOLATION_BICUBIC
This value is for use with the KEY_INTERPOLATION key. |
static Object |
VALUE_INTERPOLATION_BILINEAR
This value is for use with the KEY_INTERPOLATION key. |
static Object |
VALUE_INTERPOLATION_NEAREST_NEIGHBOR
This value is for use with the KEY_INTERPOLATION key. |
static Object |
VALUE_RENDER_DEFAULT
This value is for use with the KEY_RENDERING key. |
static Object |
VALUE_RENDER_QUALITY
This value is for use with the KEY_RENDERING key. |
static Object |
VALUE_RENDER_SPEED
This value is for use with the KEY_RENDERING key. |
static Object |
VALUE_STROKE_DEFAULT
This value is for use with the KEY_STROKE_CONTROL key. |
static Object |
VALUE_STROKE_NORMALIZE
This value is for use with the KEY_STROKE_CONTROL key. |
static Object |
VALUE_STROKE_PURE
This value is for use with the KEY_STROKE_CONTROL key. |
static Object |
VALUE_TEXT_ANTIALIAS_DEFAULT
This value is for use with the KEY_TEXT_ANTIALIASING key. |
static Object |
VALUE_TEXT_ANTIALIAS_OFF
This value is for use with the KEY_TEXT_ANTIALIASING key. |
static Object |
VALUE_TEXT_ANTIALIAS_ON
This value is for use with the KEY_TEXT_ANTIALIASING key. |
Constructor Summary | |
---|---|
RenderingHints(Map<RenderingHints.Key,?> init)
Creates a new collection of hints containing all the (key, value) pairs in the specified map. |
|
RenderingHints(RenderingHints.Key key,
Object value)
Creates a new collection containing a single (key, value) pair. |
Method Summary | |
---|---|
void |
add(RenderingHints hints)
Adds all the hints from a collection to this collection. |
void |
clear()
Clears all the hints from this collection. |
Object |
clone()
Creates a clone of this instance. |
boolean |
containsKey(Object key)
Returns true if the collection of hints contains the
specified key, and false otherwise. |
boolean |
containsValue(Object value)
Returns true if the collection of hints contains the
specified value, and false otherwise. |
Set<Map.Entry<Object,Object>> |
entrySet()
Returns a set of entries from the collection. |
boolean |
equals(Object o)
Checks this collection for equality with an arbitrary object. |
Object |
get(Object key)
Returns the value associated with the specified key, or null
if there is no value defined for the key. |
int |
hashCode()
Returns a hash code for the collection of hints. |
boolean |
isEmpty()
Returns true if there are no hints in the collection,
and false otherwise. |
Set<Object> |
keySet()
Returns a set containing the keys from this collection. |
Object |
put(Object key,
Object value)
Adds a (key, value) pair to the collection of hints (if the collection already contains the specified key, then the value is updated). |
void |
putAll(Map<?,?> m)
Adds a collection of (key, value) pairs to the collection. |
Object |
remove(Object key)
Removes a hint from the collection. |
int |
size()
Returns the number of hints in the collection. |
String |
toString()
Returns a string representation of this instance. |
Collection<Object> |
values()
Returns a collection of the values from this hint collection. |
Methods inherited from class java.lang.Object |
---|
finalize, getClass, notify, notifyAll, wait, wait, wait |
Field Detail |
---|
public static final RenderingHints.Key KEY_ANTIALIASING
VALUE_ANTIALIAS_OFF |
Render without antialiasing (better speed). |
VALUE_ANTIALIAS_ON |
Render with antialiasing (better quality). |
VALUE_ANTIALIAS_DEFAULT |
Use the default value for antialiasing. |
public static final Object VALUE_ANTIALIAS_ON
KEY_ANTIALIASING
key.
public static final Object VALUE_ANTIALIAS_OFF
KEY_ANTIALIASING
key.
public static final Object VALUE_ANTIALIAS_DEFAULT
KEY_ANTIALIASING
key.
public static final RenderingHints.Key KEY_RENDERING
VALUE_RENDER_SPEED |
Prefer speed over quality when rendering. |
VALUE_RENDER_QUALITY |
Prefer quality over speed when rendering. |
VALUE_RENDER_DEFAULT |
Use the default value for quality vs. speed when rendering. |
public static final Object VALUE_RENDER_SPEED
KEY_RENDERING
key.
public static final Object VALUE_RENDER_QUALITY
KEY_RENDERING
key.
public static final Object VALUE_RENDER_DEFAULT
KEY_RENDERING
key.
public static final RenderingHints.Key KEY_DITHERING
VALUE_DITHER_DISABLE |
Disable dithering. |
VALUE_DITHER_ENABLE |
Enable dithering. |
VALUE_DITHER_DEFAULT |
Use the default value for dithering. |
public static final Object VALUE_DITHER_DISABLE
KEY_DITHERING
key.
public static final Object VALUE_DITHER_ENABLE
KEY_DITHERING
key.
public static final Object VALUE_DITHER_DEFAULT
KEY_DITHERING
key.
public static final RenderingHints.Key KEY_TEXT_ANTIALIASING
VALUE_TEXT_ANTIALIAS_ON |
Render text with antialiasing (better quality usually). |
VALUE_TEXT_ANTIALIAS_OFF |
Render test without antialiasing (better speed). |
VALUE_TEXT_ANTIALIAS_DEFAULT |
Use the default value for text antialiasing. |
public static final Object VALUE_TEXT_ANTIALIAS_ON
KEY_TEXT_ANTIALIASING
key.
public static final Object VALUE_TEXT_ANTIALIAS_OFF
KEY_TEXT_ANTIALIASING
key.
public static final Object VALUE_TEXT_ANTIALIAS_DEFAULT
KEY_TEXT_ANTIALIASING
key.
public static final RenderingHints.Key KEY_FRACTIONALMETRICS
VALUE_FRACTIONALMETRICS_OFF |
Render text with fractional metrics off. |
VALUE_FRACTIONALMETRICS_ON |
Render text with fractional metrics on. |
VALUE_FRACTIONALMETRICS_DEFAULT |
Use the default value for fractional metrics. |
public static final Object VALUE_FRACTIONALMETRICS_OFF
KEY_FRACTIONALMETRICS
key.
public static final Object VALUE_FRACTIONALMETRICS_ON
KEY_FRACTIONALMETRICS
key.
public static final Object VALUE_FRACTIONALMETRICS_DEFAULT
KEY_FRACTIONALMETRICS
key.
public static final RenderingHints.Key KEY_INTERPOLATION
VALUE_INTERPOLATION_NEAREST_NEIGHBOR |
Use nearest neighbour interpolation. |
VALUE_INTERPOLATION_BILINEAR |
Use bilinear interpolation. |
VALUE_INTERPOLATION_BICUBIC |
Use bicubic interpolation. |
public static final Object VALUE_INTERPOLATION_NEAREST_NEIGHBOR
KEY_INTERPOLATION
key.
public static final Object VALUE_INTERPOLATION_BILINEAR
KEY_INTERPOLATION
key.
public static final Object VALUE_INTERPOLATION_BICUBIC
KEY_INTERPOLATION
key.
public static final RenderingHints.Key KEY_ALPHA_INTERPOLATION
VALUE_ALPHA_INTERPOLATION_SPEED |
Prefer speed over quality. |
VALUE_ALPHA_INTERPOLATION_QUALITY |
Prefer quality over speed. |
VALUE_ALPHA_INTERPOLATION_DEFAULT |
Use the default setting. |
public static final Object VALUE_ALPHA_INTERPOLATION_SPEED
KEY_ALPHA_INTERPOLATION
key.
public static final Object VALUE_ALPHA_INTERPOLATION_QUALITY
KEY_ALPHA_INTERPOLATION
key.
public static final Object VALUE_ALPHA_INTERPOLATION_DEFAULT
KEY_ALPHA_INTERPOLATION
key.
public static final RenderingHints.Key KEY_COLOR_RENDERING
VALUE_COLOR_RENDER_SPEED |
Prefer speed over quality. |
VALUE_COLOR_RENDER_QUALITY |
Prefer quality over speed. |
VALUE_COLOR_RENDER_DEFAULT |
Use the default setting. |
public static final Object VALUE_COLOR_RENDER_SPEED
KEY_COLOR_RENDERING
key.
public static final Object VALUE_COLOR_RENDER_QUALITY
KEY_COLOR_RENDERING
key.
public static final Object VALUE_COLOR_RENDER_DEFAULT
KEY_COLOR_RENDERING
key.
public static final RenderingHints.Key KEY_STROKE_CONTROL
VALUE_STROKE_DEFAULT |
Use the default setting. |
VALUE_STROKE_NORMALIZE |
XXX |
VALUE_STROKE_PURE |
XXX |
public static final Object VALUE_STROKE_DEFAULT
KEY_STROKE_CONTROL
key.
public static final Object VALUE_STROKE_NORMALIZE
KEY_STROKE_CONTROL
key.
public static final Object VALUE_STROKE_PURE
KEY_STROKE_CONTROL
key.
Constructor Detail |
---|
public RenderingHints(Map<RenderingHints.Key,?> init)
init
- a map containing a collection of hints (null
permitted).public RenderingHints(RenderingHints.Key key, Object value)
key
- the key.value
- the value.Method Detail |
---|
public int size()
size
in interface Map<Object,Object>
public boolean isEmpty()
true
if there are no hints in the collection,
and false
otherwise.
isEmpty
in interface Map<Object,Object>
public boolean containsKey(Object key)
true
if the collection of hints contains the
specified key, and false
otherwise.
containsKey
in interface Map<Object,Object>
key
- the key (null
not permitted).
NullPointerException
- if key
is null
.
ClassCastException
- if key
is not a RenderingHints.Key
.public boolean containsValue(Object value)
true
if the collection of hints contains the
specified value, and false
otherwise.
containsValue
in interface Map<Object,Object>
value
- the value.
public Object get(Object key)
null
if there is no value defined for the key.
get
in interface Map<Object,Object>
key
- the key (null
permitted).
null
).
ClassCastException
- if key
is not a RenderingHints.Key
.containsKey(Object)
public Object put(Object key, Object value)
put
in interface Map<Object,Object>
key
- the key.value
- the value.
null
if the key
didn't have a value yet.Map.containsKey(Object)
public void add(RenderingHints hints)
hints
- the hint collection.public void clear()
clear
in interface Map<Object,Object>
public Object remove(Object key)
remove
in interface Map<Object,Object>
key
- the key.
null
if
the key was not part of the collection
ClassCastException
- if the key is not a subclass of
RenderingHints.Key
.public void putAll(Map<?,?> m)
putAll
in interface Map<Object,Object>
m
- a map containing (key, value) items.
ClassCastException
- if the map contains a key that is not
a subclass of RenderingHints.Key
.
IllegalArgumentException
- if the map contains a value that is
not compatible with its key.Map.put(Object, Object)
public Set<Object> keySet()
keySet
in interface Map<Object,Object>
public Collection<Object> values()
RenderingHints
instance,
so updates to one will affect the other.
values
in interface Map<Object,Object>
public Set<Map.Entry<Object,Object>> entrySet()
entrySet
in interface Map<Object,Object>
Map.Entry
public boolean equals(Object o)
equals
in interface Map<Object,Object>
equals
in class Object
o
- the object (null
permitted)
Object.hashCode()
public int hashCode()
hashCode
in interface Map<Object,Object>
hashCode
in class Object
Object.equals(Object)
,
System.identityHashCode(Object)
public Object clone()
clone
in class Object
Cloneable
public String toString()
toString
in class Object
Object.getClass()
,
Object.hashCode()
,
Class.getName()
,
Integer.toHexString(int)
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |