java.awt
public class RenderingHints extends Object implements Map<Object,Object>, Cloneable
Graphics2D
rendering pipeline. Because these
items are hints only, they may be ignored by a particular
Graphics2D
implementation.Modifier and Type | Class and Description |
---|---|
static class |
RenderingHints.Key
The base class used to represent keys.
|
Modifier and Type | Field and Description |
---|---|
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 and Description |
---|
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.
|
Modifier and Type | Method and Description |
---|---|
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.
|
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.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.public int size()
public boolean isEmpty()
true
if there are no hints in the collection,
and false
otherwise.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()
public Object remove(Object key)
remove
in interface Map<Object,Object>
key
- the key.null
if
the key was not part of the collectionClassCastException
- 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 Collection<Object> values()
RenderingHints
instance,
so updates to one will affect the other.public Set<Map.Entry<Object,Object>> entrySet()
public boolean equals(Object o)
public int hashCode()
hashCode
in interface Map<Object,Object>
hashCode
in class Object
Object.equals(Object)
,
System.identityHashCode(Object)
public String toString()
toString
in class Object
Object.getClass()
,
Object.hashCode()
,
Class.getName()
,
Integer.toHexString(int)