| /* |
| * Copyright (c) 1998, 2005, Oracle and/or its affiliates. All rights reserved. |
| * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. |
| * |
| * This code is free software; you can redistribute it and/or modify it |
| * under the terms of the GNU General Public License version 2 only, as |
| * published by the Free Software Foundation. Oracle designates this |
| * particular file as subject to the "Classpath" exception as provided |
| * by Oracle in the LICENSE file that accompanied this code. |
| * |
| * This code is distributed in the hope that it will be useful, but WITHOUT |
| * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License |
| * version 2 for more details (a copy is included in the LICENSE file that |
| * accompanied this code). |
| * |
| * You should have received a copy of the GNU General Public License version |
| * 2 along with this work; if not, write to the Free Software Foundation, |
| * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA. |
| * |
| * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA |
| * or visit www.oracle.com if you need additional information or have any |
| * questions. |
| */ |
| |
| package sun.awt; |
| |
| import java.awt.RenderingHints; |
| |
| /** |
| * This class contains rendering hints that can be used by the |
| * {@link java.awt.Graphics2D} class, and classes that implement |
| * {@link java.awt.image.BufferedImageOp} and |
| * {@link java.awt.image.Raster}. |
| */ |
| public class SunHints { |
| /** |
| * Defines the type of all keys used to control various |
| * aspects of the rendering and imaging pipelines. Instances |
| * of this class are immutable and unique which means that |
| * tests for matches can be made using the == operator instead |
| * of the more expensive equals() method. |
| */ |
| public static class Key extends RenderingHints.Key { |
| String description; |
| |
| /** |
| * Construct a key using the indicated private key. Each |
| * subclass of Key maintains its own unique domain of integer |
| * keys. No two objects with the same integer key and of the |
| * same specific subclass can be constructed. An exception |
| * will be thrown if an attempt is made to construct another |
| * object of a given class with the same integer key as a |
| * pre-existing instance of that subclass of Key. |
| */ |
| public Key(int privatekey, String description) { |
| super(privatekey); |
| this.description = description; |
| } |
| |
| /** |
| * Returns the numeric index associated with this Key. This |
| * is useful for use in switch statements and quick lookups |
| * of the setting of a particular key. |
| */ |
| public final int getIndex() { |
| return intKey(); |
| } |
| |
| /** |
| * Returns a string representation of the Key. |
| */ |
| public final String toString() { |
| return description; |
| } |
| |
| /** |
| * Returns true if the specified object is a valid value |
| * for this Key. |
| */ |
| public boolean isCompatibleValue(Object val) { |
| if (val instanceof Value) { |
| return ((Value)val).isCompatibleKey(this); |
| } |
| return false; |
| } |
| } |
| |
| /** |
| * Defines the type of all "enumerative" values used to control |
| * various aspects of the rendering and imaging pipelines. Instances |
| * of this class are immutable and unique which means that |
| * tests for matches can be made using the == operator instead |
| * of the more expensive equals() method. |
| */ |
| public static class Value { |
| private SunHints.Key myKey; |
| private int index; |
| private String description; |
| |
| private static Value[][] ValueObjects = |
| new Value[NUM_KEYS][VALS_PER_KEY]; |
| |
| private synchronized static void register(SunHints.Key key, |
| Value value) { |
| int kindex = key.getIndex(); |
| int vindex = value.getIndex(); |
| if (ValueObjects[kindex][vindex] != null) { |
| throw new InternalError("duplicate index: "+vindex); |
| } |
| ValueObjects[kindex][vindex] = value; |
| } |
| |
| public static Value get(int keyindex, int valueindex) { |
| return ValueObjects[keyindex][valueindex]; |
| } |
| |
| /** |
| * Construct a value using the indicated private index. Each |
| * subclass of Value maintains its own unique domain of integer |
| * indices. Enforcing the uniqueness of the integer indices |
| * is left to the subclass. |
| */ |
| public Value(SunHints.Key key, int index, String description) { |
| this.myKey = key; |
| this.index = index; |
| this.description = description; |
| |
| register(key, this); |
| } |
| |
| /** |
| * Returns the numeric index associated with this Key. This |
| * is useful for use in switch statements and quick lookups |
| * of the setting of a particular key. |
| */ |
| public final int getIndex() { |
| return index; |
| } |
| |
| /** |
| * Returns a string representation of this Value. |
| */ |
| public final String toString() { |
| return description; |
| } |
| |
| /** |
| * Returns true if the specified object is a valid Key |
| * for this Value. |
| */ |
| public final boolean isCompatibleKey(Key k) { |
| return myKey == k; |
| } |
| |
| /** |
| * The hash code for all SunHints.Value objects will be the same |
| * as the system identity code of the object as defined by the |
| * System.identityHashCode() method. |
| */ |
| public final int hashCode() { |
| return System.identityHashCode(this); |
| } |
| |
| /** |
| * The equals method for all SunHints.Value objects will return |
| * the same result as the equality operator '=='. |
| */ |
| public final boolean equals(Object o) { |
| return this == o; |
| } |
| } |
| |
| private static final int NUM_KEYS = 9; |
| private static final int VALS_PER_KEY = 8; |
| |
| /** |
| * Rendering hint key and values |
| */ |
| public static final int INTKEY_RENDERING = 0; |
| public static final int INTVAL_RENDER_DEFAULT = 0; |
| public static final int INTVAL_RENDER_SPEED = 1; |
| public static final int INTVAL_RENDER_QUALITY = 2; |
| |
| /** |
| * Antialiasing hint key and values |
| */ |
| public static final int INTKEY_ANTIALIASING = 1; |
| public static final int INTVAL_ANTIALIAS_DEFAULT = 0; |
| public static final int INTVAL_ANTIALIAS_OFF = 1; |
| public static final int INTVAL_ANTIALIAS_ON = 2; |
| |
| /** |
| * Text antialiasing hint key and values |
| */ |
| public static final int INTKEY_TEXT_ANTIALIASING = 2; |
| public static final int INTVAL_TEXT_ANTIALIAS_DEFAULT = 0; |
| public static final int INTVAL_TEXT_ANTIALIAS_OFF = 1; |
| public static final int INTVAL_TEXT_ANTIALIAS_ON = 2; |
| public static final int INTVAL_TEXT_ANTIALIAS_GASP = 3; |
| public static final int INTVAL_TEXT_ANTIALIAS_LCD_HRGB = 4; |
| public static final int INTVAL_TEXT_ANTIALIAS_LCD_HBGR = 5; |
| public static final int INTVAL_TEXT_ANTIALIAS_LCD_VRGB = 6; |
| public static final int INTVAL_TEXT_ANTIALIAS_LCD_VBGR = 7; |
| |
| /** |
| * Font fractional metrics hint key and values |
| */ |
| public static final int INTKEY_FRACTIONALMETRICS = 3; |
| public static final int INTVAL_FRACTIONALMETRICS_DEFAULT = 0; |
| public static final int INTVAL_FRACTIONALMETRICS_OFF = 1; |
| public static final int INTVAL_FRACTIONALMETRICS_ON = 2; |
| |
| /** |
| * Dithering hint key and values |
| */ |
| public static final int INTKEY_DITHERING = 4; |
| public static final int INTVAL_DITHER_DEFAULT = 0; |
| public static final int INTVAL_DITHER_DISABLE = 1; |
| public static final int INTVAL_DITHER_ENABLE = 2; |
| |
| /** |
| * Interpolation hint key and values |
| */ |
| public static final int INTKEY_INTERPOLATION = 5; |
| public static final int INTVAL_INTERPOLATION_NEAREST_NEIGHBOR = 0; |
| public static final int INTVAL_INTERPOLATION_BILINEAR = 1; |
| public static final int INTVAL_INTERPOLATION_BICUBIC = 2; |
| |
| /** |
| * Alpha interpolation hint key and values |
| */ |
| public static final int INTKEY_ALPHA_INTERPOLATION = 6; |
| public static final int INTVAL_ALPHA_INTERPOLATION_DEFAULT = 0; |
| public static final int INTVAL_ALPHA_INTERPOLATION_SPEED = 1; |
| public static final int INTVAL_ALPHA_INTERPOLATION_QUALITY = 2; |
| |
| /** |
| * Color rendering hint key and values |
| */ |
| public static final int INTKEY_COLOR_RENDERING = 7; |
| public static final int INTVAL_COLOR_RENDER_DEFAULT = 0; |
| public static final int INTVAL_COLOR_RENDER_SPEED = 1; |
| public static final int INTVAL_COLOR_RENDER_QUALITY = 2; |
| |
| /** |
| * Stroke normalization control hint key and values |
| */ |
| public static final int INTKEY_STROKE_CONTROL = 8; |
| public static final int INTVAL_STROKE_DEFAULT = 0; |
| public static final int INTVAL_STROKE_NORMALIZE = 1; |
| public static final int INTVAL_STROKE_PURE = 2; |
| |
| /** |
| * LCD text contrast control hint key. |
| * Value is "100" to make discontiguous with the others which |
| * are all enumerative and are of a different class. |
| */ |
| public static final int INTKEY_AATEXT_LCD_CONTRAST = 100; |
| |
| /** |
| * Rendering hint key and value objects |
| */ |
| public static final Key KEY_RENDERING = |
| new SunHints.Key(SunHints.INTKEY_RENDERING, |
| "Global rendering quality key"); |
| public static final Object VALUE_RENDER_SPEED = |
| new SunHints.Value(KEY_RENDERING, |
| SunHints.INTVAL_RENDER_SPEED, |
| "Fastest rendering methods"); |
| public static final Object VALUE_RENDER_QUALITY = |
| new SunHints.Value(KEY_RENDERING, |
| SunHints.INTVAL_RENDER_QUALITY, |
| "Highest quality rendering methods"); |
| public static final Object VALUE_RENDER_DEFAULT = |
| new SunHints.Value(KEY_RENDERING, |
| SunHints.INTVAL_RENDER_DEFAULT, |
| "Default rendering methods"); |
| |
| /** |
| * Antialiasing hint key and value objects |
| */ |
| public static final Key KEY_ANTIALIASING = |
| new SunHints.Key(SunHints.INTKEY_ANTIALIASING, |
| "Global antialiasing enable key"); |
| public static final Object VALUE_ANTIALIAS_ON = |
| new SunHints.Value(KEY_ANTIALIASING, |
| SunHints.INTVAL_ANTIALIAS_ON, |
| "Antialiased rendering mode"); |
| public static final Object VALUE_ANTIALIAS_OFF = |
| new SunHints.Value(KEY_ANTIALIASING, |
| SunHints.INTVAL_ANTIALIAS_OFF, |
| "Nonantialiased rendering mode"); |
| public static final Object VALUE_ANTIALIAS_DEFAULT = |
| new SunHints.Value(KEY_ANTIALIASING, |
| SunHints.INTVAL_ANTIALIAS_DEFAULT, |
| "Default antialiasing rendering mode"); |
| |
| /** |
| * Text antialiasing hint key and value objects |
| */ |
| public static final Key KEY_TEXT_ANTIALIASING = |
| new SunHints.Key(SunHints.INTKEY_TEXT_ANTIALIASING, |
| "Text-specific antialiasing enable key"); |
| public static final Object VALUE_TEXT_ANTIALIAS_ON = |
| new SunHints.Value(KEY_TEXT_ANTIALIASING, |
| SunHints.INTVAL_TEXT_ANTIALIAS_ON, |
| "Antialiased text mode"); |
| public static final Object VALUE_TEXT_ANTIALIAS_OFF = |
| new SunHints.Value(KEY_TEXT_ANTIALIASING, |
| SunHints.INTVAL_TEXT_ANTIALIAS_OFF, |
| "Nonantialiased text mode"); |
| public static final Object VALUE_TEXT_ANTIALIAS_DEFAULT = |
| new SunHints.Value(KEY_TEXT_ANTIALIASING, |
| SunHints.INTVAL_TEXT_ANTIALIAS_DEFAULT, |
| "Default antialiasing text mode"); |
| public static final Object VALUE_TEXT_ANTIALIAS_GASP = |
| new SunHints.Value(KEY_TEXT_ANTIALIASING, |
| SunHints.INTVAL_TEXT_ANTIALIAS_GASP, |
| "gasp antialiasing text mode"); |
| public static final Object VALUE_TEXT_ANTIALIAS_LCD_HRGB = |
| new SunHints.Value(KEY_TEXT_ANTIALIASING, |
| SunHints.INTVAL_TEXT_ANTIALIAS_LCD_HRGB, |
| "LCD HRGB antialiasing text mode"); |
| public static final Object VALUE_TEXT_ANTIALIAS_LCD_HBGR = |
| new SunHints.Value(KEY_TEXT_ANTIALIASING, |
| SunHints.INTVAL_TEXT_ANTIALIAS_LCD_HBGR, |
| "LCD HBGR antialiasing text mode"); |
| public static final Object VALUE_TEXT_ANTIALIAS_LCD_VRGB = |
| new SunHints.Value(KEY_TEXT_ANTIALIASING, |
| SunHints.INTVAL_TEXT_ANTIALIAS_LCD_VRGB, |
| "LCD VRGB antialiasing text mode"); |
| public static final Object VALUE_TEXT_ANTIALIAS_LCD_VBGR = |
| new SunHints.Value(KEY_TEXT_ANTIALIASING, |
| SunHints.INTVAL_TEXT_ANTIALIAS_LCD_VBGR, |
| "LCD VBGR antialiasing text mode"); |
| |
| /** |
| * Font fractional metrics hint key and value objects |
| */ |
| public static final Key KEY_FRACTIONALMETRICS = |
| new SunHints.Key(SunHints.INTKEY_FRACTIONALMETRICS, |
| "Fractional metrics enable key"); |
| public static final Object VALUE_FRACTIONALMETRICS_ON = |
| new SunHints.Value(KEY_FRACTIONALMETRICS, |
| SunHints.INTVAL_FRACTIONALMETRICS_ON, |
| "Fractional text metrics mode"); |
| public static final Object VALUE_FRACTIONALMETRICS_OFF = |
| new SunHints.Value(KEY_FRACTIONALMETRICS, |
| SunHints.INTVAL_FRACTIONALMETRICS_OFF, |
| "Integer text metrics mode"); |
| public static final Object VALUE_FRACTIONALMETRICS_DEFAULT = |
| new SunHints.Value(KEY_FRACTIONALMETRICS, |
| SunHints.INTVAL_FRACTIONALMETRICS_DEFAULT, |
| "Default fractional text metrics mode"); |
| |
| /** |
| * Dithering hint key and value objects |
| */ |
| public static final Key KEY_DITHERING = |
| new SunHints.Key(SunHints.INTKEY_DITHERING, |
| "Dithering quality key"); |
| public static final Object VALUE_DITHER_ENABLE = |
| new SunHints.Value(KEY_DITHERING, |
| SunHints.INTVAL_DITHER_ENABLE, |
| "Dithered rendering mode"); |
| public static final Object VALUE_DITHER_DISABLE = |
| new SunHints.Value(KEY_DITHERING, |
| SunHints.INTVAL_DITHER_DISABLE, |
| "Nondithered rendering mode"); |
| public static final Object VALUE_DITHER_DEFAULT = |
| new SunHints.Value(KEY_DITHERING, |
| SunHints.INTVAL_DITHER_DEFAULT, |
| "Default dithering mode"); |
| |
| /** |
| * Interpolation hint key and value objects |
| */ |
| public static final Key KEY_INTERPOLATION = |
| new SunHints.Key(SunHints.INTKEY_INTERPOLATION, |
| "Image interpolation method key"); |
| public static final Object VALUE_INTERPOLATION_NEAREST_NEIGHBOR = |
| new SunHints.Value(KEY_INTERPOLATION, |
| SunHints.INTVAL_INTERPOLATION_NEAREST_NEIGHBOR, |
| "Nearest Neighbor image interpolation mode"); |
| public static final Object VALUE_INTERPOLATION_BILINEAR = |
| new SunHints.Value(KEY_INTERPOLATION, |
| SunHints.INTVAL_INTERPOLATION_BILINEAR, |
| "Bilinear image interpolation mode"); |
| public static final Object VALUE_INTERPOLATION_BICUBIC = |
| new SunHints.Value(KEY_INTERPOLATION, |
| SunHints.INTVAL_INTERPOLATION_BICUBIC, |
| "Bicubic image interpolation mode"); |
| |
| /** |
| * Alpha interpolation hint key and value objects |
| */ |
| public static final Key KEY_ALPHA_INTERPOLATION = |
| new SunHints.Key(SunHints.INTKEY_ALPHA_INTERPOLATION, |
| "Alpha blending interpolation method key"); |
| public static final Object VALUE_ALPHA_INTERPOLATION_SPEED = |
| new SunHints.Value(KEY_ALPHA_INTERPOLATION, |
| SunHints.INTVAL_ALPHA_INTERPOLATION_SPEED, |
| "Fastest alpha blending methods"); |
| public static final Object VALUE_ALPHA_INTERPOLATION_QUALITY = |
| new SunHints.Value(KEY_ALPHA_INTERPOLATION, |
| SunHints.INTVAL_ALPHA_INTERPOLATION_QUALITY, |
| "Highest quality alpha blending methods"); |
| public static final Object VALUE_ALPHA_INTERPOLATION_DEFAULT = |
| new SunHints.Value(KEY_ALPHA_INTERPOLATION, |
| SunHints.INTVAL_ALPHA_INTERPOLATION_DEFAULT, |
| "Default alpha blending methods"); |
| |
| /** |
| * Color rendering hint key and value objects |
| */ |
| public static final Key KEY_COLOR_RENDERING = |
| new SunHints.Key(SunHints.INTKEY_COLOR_RENDERING, |
| "Color rendering quality key"); |
| public static final Object VALUE_COLOR_RENDER_SPEED = |
| new SunHints.Value(KEY_COLOR_RENDERING, |
| SunHints.INTVAL_COLOR_RENDER_SPEED, |
| "Fastest color rendering mode"); |
| public static final Object VALUE_COLOR_RENDER_QUALITY = |
| new SunHints.Value(KEY_COLOR_RENDERING, |
| SunHints.INTVAL_COLOR_RENDER_QUALITY, |
| "Highest quality color rendering mode"); |
| public static final Object VALUE_COLOR_RENDER_DEFAULT = |
| new SunHints.Value(KEY_COLOR_RENDERING, |
| SunHints.INTVAL_COLOR_RENDER_DEFAULT, |
| "Default color rendering mode"); |
| |
| /** |
| * Stroke normalization control hint key and value objects |
| */ |
| public static final Key KEY_STROKE_CONTROL = |
| new SunHints.Key(SunHints.INTKEY_STROKE_CONTROL, |
| "Stroke normalization control key"); |
| public static final Object VALUE_STROKE_DEFAULT = |
| new SunHints.Value(KEY_STROKE_CONTROL, |
| SunHints.INTVAL_STROKE_DEFAULT, |
| "Default stroke normalization"); |
| public static final Object VALUE_STROKE_NORMALIZE = |
| new SunHints.Value(KEY_STROKE_CONTROL, |
| SunHints.INTVAL_STROKE_NORMALIZE, |
| "Normalize strokes for consistent rendering"); |
| public static final Object VALUE_STROKE_PURE = |
| new SunHints.Value(KEY_STROKE_CONTROL, |
| SunHints.INTVAL_STROKE_PURE, |
| "Pure stroke conversion for accurate paths"); |
| |
| |
| public static class LCDContrastKey extends Key { |
| |
| public LCDContrastKey(int privatekey, String description) { |
| super(privatekey, description); |
| } |
| |
| /** |
| * Returns true if the specified object is a valid value |
| * for this Key. The allowable range is 100 to 250. |
| */ |
| public final boolean isCompatibleValue(Object val) { |
| if (val instanceof Integer) { |
| int ival = ((Integer)val).intValue(); |
| return ival >= 100 && ival <= 250; |
| } |
| return false; |
| } |
| |
| } |
| |
| /** |
| * LCD text contrast hint key |
| */ |
| public static final RenderingHints.Key |
| KEY_TEXT_ANTIALIAS_LCD_CONTRAST = |
| new LCDContrastKey(SunHints.INTKEY_AATEXT_LCD_CONTRAST, |
| "Text-specific LCD contrast key"); |
| } |
