< prev index next >
src/java.desktop/share/classes/java/awt/RenderingHints.java
Print this page
*** 159,171 ****
}
/**
* Returns true if the specified object is a valid value
* for this Key.
! * @param val the <code>Object</code> to test for validity
! * @return <code>true</code> if <code>val</code> is valid;
! * <code>false</code> otherwise.
*/
public abstract boolean isCompatibleValue(Object val);
/**
* Returns the private integer key that the subclass
--- 159,171 ----
}
/**
* Returns true if the specified object is a valid value
* for this Key.
! * @param val the {@code Object} to test for validity
! * @return {@code true} if {@code val} is valid;
! * {@code false} otherwise.
*/
public abstract boolean isCompatibleValue(Object val);
/**
* Returns the private integer key that the subclass
*** 517,527 ****
SunHints.VALUE_TEXT_ANTIALIAS_LCD_VBGR;
/**
* LCD text contrast rendering hint key.
! * The value is an <code>Integer</code> object which is used as a text
* contrast adjustment when used in conjunction with an LCD text
* anti-aliasing hint such as
* {@link #VALUE_TEXT_ANTIALIAS_LCD_HRGB}.
* <ul>
* <li>Values should be a positive integer in the range 100 to 250.
--- 517,527 ----
SunHints.VALUE_TEXT_ANTIALIAS_LCD_VBGR;
/**
* LCD text contrast rendering hint key.
! * The value is an {@code Integer} object which is used as a text
* contrast adjustment when used in conjunction with an LCD text
* anti-aliasing hint such as
* {@link #VALUE_TEXT_ANTIALIAS_LCD_HRGB}.
* <ul>
* <li>Values should be a positive integer in the range 100 to 250.
*** 1026,1058 ****
/**
* Constructs a new object with the specified key/value pair.
* @param key the key of the particular hint property
* @param value the value of the hint property specified with
! * <code>key</code>
*/
public RenderingHints(Key key, Object value) {
hintmap.put(key, value);
}
/**
* Returns the number of key-value mappings in this
! * <code>RenderingHints</code>.
*
* @return the number of key-value mappings in this
! * <code>RenderingHints</code>.
*/
public int size() {
return hintmap.size();
}
/**
! * Returns <code>true</code> if this
! * <code>RenderingHints</code> contains no key-value mappings.
*
! * @return <code>true</code> if this
! * <code>RenderingHints</code> contains no key-value mappings.
*/
public boolean isEmpty() {
return hintmap.isEmpty();
}
--- 1026,1058 ----
/**
* Constructs a new object with the specified key/value pair.
* @param key the key of the particular hint property
* @param value the value of the hint property specified with
! * {@code key}
*/
public RenderingHints(Key key, Object value) {
hintmap.put(key, value);
}
/**
* Returns the number of key-value mappings in this
! * {@code RenderingHints}.
*
* @return the number of key-value mappings in this
! * {@code RenderingHints}.
*/
public int size() {
return hintmap.size();
}
/**
! * Returns {@code true} if this
! * {@code RenderingHints} contains no key-value mappings.
*
! * @return {@code true} if this
! * {@code RenderingHints} contains no key-value mappings.
*/
public boolean isEmpty() {
return hintmap.isEmpty();
}
*** 1072,1094 ****
}
/**
* Returns true if this RenderingHints maps one or more keys to the
* specified value.
! * More formally, returns <code>true</code> if and only
! * if this <code>RenderingHints</code>
! * contains at least one mapping to a value <code>v</code> such that
* <pre>
* (value==null ? v==null : value.equals(v))
* </pre>.
* This operation will probably require time linear in the
! * <code>RenderingHints</code> size for most implementations
! * of <code>RenderingHints</code>.
*
* @param value value whose presence in this
! * <code>RenderingHints</code> is to be tested.
! * @return <code>true</code> if this <code>RenderingHints</code>
* maps one or more keys to the specified value.
*/
public boolean containsValue(Object value) {
return hintmap.containsValue(value);
}
--- 1072,1094 ----
}
/**
* Returns true if this RenderingHints maps one or more keys to the
* specified value.
! * More formally, returns {@code true} if and only
! * if this {@code RenderingHints}
! * contains at least one mapping to a value {@code v} such that
* <pre>
* (value==null ? v==null : value.equals(v))
* </pre>.
* This operation will probably require time linear in the
! * {@code RenderingHints} size for most implementations
! * of {@code RenderingHints}.
*
* @param value value whose presence in this
! * {@code RenderingHints} is to be tested.
! * @return {@code true} if this {@code RenderingHints}
* maps one or more keys to the specified value.
*/
public boolean containsValue(Object value) {
return hintmap.containsValue(value);
}
*** 1137,1159 ****
return hintmap.put((Key) key, value);
}
/**
* Adds all of the keys and corresponding values from the specified
! * <code>RenderingHints</code> object to this
! * <code>RenderingHints</code> object. Keys that are present in
! * this <code>RenderingHints</code> object, but not in the specified
! * <code>RenderingHints</code> object are not affected.
* @param hints the set of key/value pairs to be added to this
! * <code>RenderingHints</code> object
*/
public void add(RenderingHints hints) {
hintmap.putAll(hints.hintmap);
}
/**
! * Clears this <code>RenderingHints</code> object of all key/value
* pairs.
*/
public void clear() {
hintmap.clear();
}
--- 1137,1159 ----
return hintmap.put((Key) key, value);
}
/**
* Adds all of the keys and corresponding values from the specified
! * {@code RenderingHints} object to this
! * {@code RenderingHints} object. Keys that are present in
! * this {@code RenderingHints} object, but not in the specified
! * {@code RenderingHints} object are not affected.
* @param hints the set of key/value pairs to be added to this
! * {@code RenderingHints} object
*/
public void add(RenderingHints hints) {
hintmap.putAll(hints.hintmap);
}
/**
! * Clears this {@code RenderingHints} object of all key/value
* pairs.
*/
public void clear() {
hintmap.clear();
}
*** 1200,1296 ****
put(entry.getKey(), entry.getValue());
}
}
/**
! * Returns a <code>Set</code> view of the Keys contained in this
! * <code>RenderingHints</code>. The Set is backed by the
! * <code>RenderingHints</code>, so changes to the
! * <code>RenderingHints</code> are reflected in the <code>Set</code>,
! * and vice-versa. If the <code>RenderingHints</code> is modified
! * while an iteration over the <code>Set</code> is in progress,
! * the results of the iteration are undefined. The <code>Set</code>
* supports element removal, which removes the corresponding
! * mapping from the <code>RenderingHints</code>, via the
! * <code>Iterator.remove</code>, <code>Set.remove</code>,
! * <code>removeAll</code> <code>retainAll</code>, and
! * <code>clear</code> operations. It does not support
! * the <code>add</code> or <code>addAll</code> operations.
*
! * @return a <code>Set</code> view of the keys contained
! * in this <code>RenderingHints</code>.
*/
public Set<Object> keySet() {
return hintmap.keySet();
}
/**
! * Returns a <code>Collection</code> view of the values
! * contained in this <code>RenderingHints</code>.
! * The <code>Collection</code> is backed by the
! * <code>RenderingHints</code>, so changes to
! * the <code>RenderingHints</code> are reflected in
! * the <code>Collection</code>, and vice-versa.
! * If the <code>RenderingHints</code> is modified while
! * an iteration over the <code>Collection</code> is
* in progress, the results of the iteration are undefined.
! * The <code>Collection</code> supports element removal,
* which removes the corresponding mapping from the
! * <code>RenderingHints</code>, via the
! * <code>Iterator.remove</code>,
! * <code>Collection.remove</code>, <code>removeAll</code>,
! * <code>retainAll</code> and <code>clear</code> operations.
! * It does not support the <code>add</code> or
! * <code>addAll</code> operations.
*
! * @return a <code>Collection</code> view of the values
! * contained in this <code>RenderingHints</code>.
*/
public Collection<Object> values() {
return hintmap.values();
}
/**
! * Returns a <code>Set</code> view of the mappings contained
! * in this <code>RenderingHints</code>. Each element in the
! * returned <code>Set</code> is a <code>Map.Entry</code>.
! * The <code>Set</code> is backed by the <code>RenderingHints</code>,
! * so changes to the <code>RenderingHints</code> are reflected
! * in the <code>Set</code>, and vice-versa. If the
! * <code>RenderingHints</code> is modified while
! * while an iteration over the <code>Set</code> is in progress,
* the results of the iteration are undefined.
* <p>
! * The entrySet returned from a <code>RenderingHints</code> object
* is not modifiable.
*
! * @return a <code>Set</code> view of the mappings contained in
! * this <code>RenderingHints</code>.
*/
public Set<Map.Entry<Object,Object>> entrySet() {
return Collections.unmodifiableMap(hintmap).entrySet();
}
/**
! * Compares the specified <code>Object</code> with this
! * <code>RenderingHints</code> for equality.
! * Returns <code>true</code> if the specified object is also a
! * <code>Map</code> and the two <code>Map</code> objects represent
! * the same mappings. More formally, two <code>Map</code> objects
! * <code>t1</code> and <code>t2</code> represent the same mappings
! * if <code>t1.keySet().equals(t2.keySet())</code> and for every
! * key <code>k</code> in <code>t1.keySet()</code>,
* <pre>
* (t1.get(k)==null ? t2.get(k)==null : t1.get(k).equals(t2.get(k)))
* </pre>.
! * This ensures that the <code>equals</code> method works properly across
! * different implementations of the <code>Map</code> interface.
*
! * @param o <code>Object</code> to be compared for equality with
! * this <code>RenderingHints</code>.
! * @return <code>true</code> if the specified <code>Object</code>
! * is equal to this <code>RenderingHints</code>.
*/
public boolean equals(Object o) {
if (o instanceof RenderingHints) {
return hintmap.equals(((RenderingHints) o).hintmap);
} else if (o instanceof Map) {
--- 1200,1296 ----
put(entry.getKey(), entry.getValue());
}
}
/**
! * Returns a {@code Set} view of the Keys contained in this
! * {@code RenderingHints}. The Set is backed by the
! * {@code RenderingHints}, so changes to the
! * {@code RenderingHints} are reflected in the {@code Set},
! * and vice-versa. If the {@code RenderingHints} is modified
! * while an iteration over the {@code Set} is in progress,
! * the results of the iteration are undefined. The {@code Set}
* supports element removal, which removes the corresponding
! * mapping from the {@code RenderingHints}, via the
! * {@code Iterator.remove}, {@code Set.remove},
! * {@code removeAll retainAll}, and
! * {@code clear} operations. It does not support
! * the {@code add} or {@code addAll} operations.
*
! * @return a {@code Set} view of the keys contained
! * in this {@code RenderingHints}.
*/
public Set<Object> keySet() {
return hintmap.keySet();
}
/**
! * Returns a {@code Collection} view of the values
! * contained in this {@code RenderingHints}.
! * The {@code Collection} is backed by the
! * {@code RenderingHints}, so changes to
! * the {@code RenderingHints} are reflected in
! * the {@code Collection}, and vice-versa.
! * If the {@code RenderingHints} is modified while
! * an iteration over the {@code Collection} is
* in progress, the results of the iteration are undefined.
! * The {@code Collection} supports element removal,
* which removes the corresponding mapping from the
! * {@code RenderingHints}, via the
! * {@code Iterator.remove},
! * {@code Collection.remove}, {@code removeAll},
! * {@code retainAll} and {@code clear} operations.
! * It does not support the {@code add} or
! * {@code addAll} operations.
*
! * @return a {@code Collection} view of the values
! * contained in this {@code RenderingHints}.
*/
public Collection<Object> values() {
return hintmap.values();
}
/**
! * Returns a {@code Set} view of the mappings contained
! * in this {@code RenderingHints}. Each element in the
! * returned {@code Set} is a {@code Map.Entry}.
! * The {@code Set} is backed by the {@code RenderingHints},
! * so changes to the {@code RenderingHints} are reflected
! * in the {@code Set}, and vice-versa. If the
! * {@code RenderingHints} is modified while
! * while an iteration over the {@code Set} is in progress,
* the results of the iteration are undefined.
* <p>
! * The entrySet returned from a {@code RenderingHints} object
* is not modifiable.
*
! * @return a {@code Set} view of the mappings contained in
! * this {@code RenderingHints}.
*/
public Set<Map.Entry<Object,Object>> entrySet() {
return Collections.unmodifiableMap(hintmap).entrySet();
}
/**
! * Compares the specified {@code Object} with this
! * {@code RenderingHints} for equality.
! * Returns {@code true} if the specified object is also a
! * {@code Map} and the two {@code Map} objects represent
! * the same mappings. More formally, two {@code Map} objects
! * {@code t1} and {@code t2} represent the same mappings
! * if {@code t1.keySet().equals(t2.keySet())} and for every
! * key {@code k} in {@code t1.keySet()},
* <pre>
* (t1.get(k)==null ? t2.get(k)==null : t1.get(k).equals(t2.get(k)))
* </pre>.
! * This ensures that the {@code equals} method works properly across
! * different implementations of the {@code Map} interface.
*
! * @param o {@code Object} to be compared for equality with
! * this {@code RenderingHints}.
! * @return {@code true} if the specified {@code Object}
! * is equal to this {@code RenderingHints}.
*/
public boolean equals(Object o) {
if (o instanceof RenderingHints) {
return hintmap.equals(((RenderingHints) o).hintmap);
} else if (o instanceof Map) {
*** 1298,1329 ****
}
return false;
}
/**
! * Returns the hash code value for this <code>RenderingHints</code>.
! * The hash code of a <code>RenderingHints</code> is defined to be
! * the sum of the hashCodes of each <code>Entry</code> in the
! * <code>RenderingHints</code> object's entrySet view. This ensures that
! * <code>t1.equals(t2)</code> implies that
! * <code>t1.hashCode()==t2.hashCode()</code> for any two <code>Map</code>
! * objects <code>t1</code> and <code>t2</code>, as required by the general
! * contract of <code>Object.hashCode</code>.
*
! * @return the hash code value for this <code>RenderingHints</code>.
* @see java.util.Map.Entry#hashCode()
* @see Object#hashCode()
* @see Object#equals(Object)
* @see #equals(Object)
*/
public int hashCode() {
return hintmap.hashCode();
}
/**
! * Creates a clone of this <code>RenderingHints</code> object
! * that has the same contents as this <code>RenderingHints</code>
* object.
* @return a clone of this instance.
*/
@SuppressWarnings("unchecked")
public Object clone() {
--- 1298,1329 ----
}
return false;
}
/**
! * Returns the hash code value for this {@code RenderingHints}.
! * The hash code of a {@code RenderingHints} is defined to be
! * the sum of the hashCodes of each {@code Entry} in the
! * {@code RenderingHints} object's entrySet view. This ensures that
! * {@code t1.equals(t2)} implies that
! * {@code t1.hashCode()==t2.hashCode()} for any two {@code Map}
! * objects {@code t1} and {@code t2}, as required by the general
! * contract of {@code Object.hashCode}.
*
! * @return the hash code value for this {@code RenderingHints}.
* @see java.util.Map.Entry#hashCode()
* @see Object#hashCode()
* @see Object#equals(Object)
* @see #equals(Object)
*/
public int hashCode() {
return hintmap.hashCode();
}
/**
! * Creates a clone of this {@code RenderingHints} object
! * that has the same contents as this {@code RenderingHints}
* object.
* @return a clone of this instance.
*/
@SuppressWarnings("unchecked")
public Object clone() {
*** 1342,1352 ****
}
/**
* Returns a rather long string representation of the hashmap
* which contains the mappings of keys to values for this
! * <code>RenderingHints</code> object.
* @return a string representation of this object.
*/
public String toString() {
if (hintmap == null) {
return getClass().getName() + "@" +
--- 1342,1352 ----
}
/**
* Returns a rather long string representation of the hashmap
* which contains the mappings of keys to values for this
! * {@code RenderingHints} object.
* @return a string representation of this object.
*/
public String toString() {
if (hintmap == null) {
return getClass().getName() + "@" +
< prev index next >