1 /*
   2  * Copyright (c) 1997, 2011, Oracle and/or its affiliates. All rights reserved.
   3  * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
   4  *
   5  * This code is free software; you can redistribute it and/or modify it
   6  * under the terms of the GNU General Public License version 2 only, as
   7  * published by the Free Software Foundation.  Oracle designates this
   8  * particular file as subject to the "Classpath" exception as provided
   9  * by Oracle in the LICENSE file that accompanied this code.
  10  *
  11  * This code is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
  13  * FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  14  * version 2 for more details (a copy is included in the LICENSE file that
  15  * accompanied this code).
  16  *
  17  * You should have received a copy of the GNU General Public License version
  18  * 2 along with this work; if not, write to the Free Software Foundation,
  19  * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
  20  *
  21  * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
  22  * or visit www.oracle.com if you need additional information or have any
  23  * questions.
  24  */
  25 
  26 package sun.java2d;
  27 
  28 import java.awt.AWTError;
  29 import java.awt.Color;
  30 import java.awt.Font;
  31 import java.awt.Graphics2D;
  32 import java.awt.GraphicsConfiguration;
  33 import java.awt.GraphicsDevice;
  34 import java.awt.GraphicsEnvironment;
  35 import java.awt.Insets;
  36 import java.awt.Rectangle;
  37 import java.awt.Toolkit;
  38 import java.awt.font.TextAttribute;
  39 import java.awt.image.BufferedImage;
  40 import java.awt.peer.ComponentPeer;
  41 import java.io.BufferedReader;
  42 import java.io.File;
  43 import java.io.FileInputStream;
  44 import java.io.FilenameFilter;
  45 import java.io.InputStreamReader;
  46 import java.io.IOException;
  47 import java.text.AttributedCharacterIterator;
  48 import java.util.ArrayList;
  49 import java.util.HashSet;
  50 import java.util.Iterator;
  51 import java.util.Locale;
  52 import java.util.Map;
  53 import java.util.NoSuchElementException;
  54 import java.util.Set;
  55 import java.util.StringTokenizer;
  56 import java.util.TreeMap;
  57 import java.util.Vector;
  58 import java.util.concurrent.ConcurrentHashMap;
  59 import sun.awt.AppContext;
  60 import sun.awt.DisplayChangedListener;
  61 import sun.awt.FontConfiguration;
  62 import sun.awt.SunDisplayChanger;
  63 import sun.font.CompositeFontDescriptor;
  64 import sun.font.Font2D;
  65 import sun.font.FontManager;
  66 import sun.font.FontManagerFactory;
  67 import sun.font.FontManagerForSGE;
  68 import sun.font.NativeFont;
  69 
  70 /**
  71  * This is an implementation of a GraphicsEnvironment object for the
  72  * default local GraphicsEnvironment.
  73  *
  74  * @see GraphicsDevice
  75  * @see GraphicsConfiguration
  76  */
  77 public abstract class SunGraphicsEnvironment extends GraphicsEnvironment
  78     implements DisplayChangedListener {
  79 
  80     public static boolean isOpenSolaris;
  81     private static Font defaultFont;
  82 
  83     public SunGraphicsEnvironment() {
  84         java.security.AccessController.doPrivileged(
  85                                     new java.security.PrivilegedAction() {
  86             public Object run() {
  87                     String version = System.getProperty("os.version", "0.0");
  88                     try {
  89                         float ver = Float.parseFloat(version);
  90                         if (ver > 5.10f) {
  91                             File f = new File("/etc/release");
  92                             FileInputStream fis = new FileInputStream(f);
  93                             InputStreamReader isr
  94                                 = new InputStreamReader(fis, "ISO-8859-1");
  95                             BufferedReader br = new BufferedReader(isr);
  96                             String line = br.readLine();
  97                             if (line.indexOf("OpenSolaris") >= 0) {
  98                                 isOpenSolaris = true;
  99                             } else {
 100                                 /* We are using isOpenSolaris as meaning
 101                                  * we know the Solaris commercial fonts aren't
 102                                  * present. "Solaris Next" (03/10) did not
 103                                  * include these even though its was not
 104                                  * OpenSolaris. Need to revisit how this is
 105                                  * handled but for now as in 6ux, we'll use
 106                                  * the test for a standard font resource as
 107                                  * being an indicator as to whether we need
 108                                  * to treat this as OpenSolaris from a font
 109                                  * config perspective.
 110                                  */
 111                                 String courierNew =
 112                                     "/usr/openwin/lib/X11/fonts/TrueType/CourierNew.ttf";
 113                                 File courierFile = new File(courierNew);
 114                                 isOpenSolaris = !courierFile.exists();
 115                             }
 116                             fis.close();
 117                         }
 118                     } catch (Exception e) {
 119                     }
 120 
 121                 /* Establish the default font to be used by SG2D etc */
 122                 defaultFont = new Font(Font.DIALOG, Font.PLAIN, 12);
 123 
 124                 return null;
 125             }
 126         });
 127     }
 128 
 129     protected GraphicsDevice[] screens;
 130 
 131     /**
 132      * Returns an array of all of the screen devices.
 133      */
 134     public synchronized GraphicsDevice[] getScreenDevices() {
 135         GraphicsDevice[] ret = screens;
 136         if (ret == null) {
 137             int num = getNumScreens();
 138             if (num == 0) {
 139                 throw new AWTError("no screen devices");
 140             }
 141             ret = new GraphicsDevice[num];
 142             for (int i = 0; i < num; i++) {
 143                 ret[i] = makeScreenDevice(i);
 144             }
 145             screens = ret;
 146         }
 147         return ret;
 148     }
 149 
 150     /**
 151      * Returns the number of screen devices of this graphics environment.
 152      *
 153      * @return the number of screen devices of this graphics environment
 154      */
 155     protected abstract int getNumScreens();
 156 
 157     /**
 158      * Create and return the screen device with the specified number. The
 159      * device with number <code>0</code> will be the default device (returned
 160      * by {@link #getDefaultScreenDevice()}.
 161      *
 162      * @param screennum the number of the screen to create
 163      *
 164      * @return the created screen device
 165      */
 166     protected abstract GraphicsDevice makeScreenDevice(int screennum);
 167 
 168     /**
 169      * Returns the default screen graphics device.
 170      */
 171     public GraphicsDevice getDefaultScreenDevice() {
 172         return getScreenDevices()[0];
 173     }
 174 
 175     /**
 176      * Returns a Graphics2D object for rendering into the
 177      * given BufferedImage.
 178      * @throws NullPointerException if BufferedImage argument is null
 179      */
 180     public Graphics2D createGraphics(BufferedImage img) {
 181         if (img == null) {
 182             throw new NullPointerException("BufferedImage cannot be null");
 183         }
 184         SurfaceData sd = SurfaceData.getPrimarySurfaceData(img);
 185         return new SunGraphics2D(sd, Color.white, Color.black, defaultFont);
 186     }
 187 
 188     public static FontManagerForSGE getFontManagerForSGE() {
 189         FontManager fm = FontManagerFactory.getInstance();
 190         return (FontManagerForSGE) fm;
 191     }
 192 
 193     /* Modifies the behaviour of a subsequent call to preferLocaleFonts()
 194      * to use Mincho instead of Gothic for dialoginput in JA locales
 195      * on windows. Not needed on other platforms.
 196      *
 197      * DO NOT MOVE OR RENAME OR OTHERWISE ALTER THIS METHOD.
 198      * ITS USED BY SOME NON-JRE INTERNAL CODE.
 199      */
 200     public static void useAlternateFontforJALocales() {
 201         getFontManagerForSGE().useAlternateFontforJALocales();
 202     }
 203 
 204      /**
 205      * Returns all fonts available in this environment.
 206      */
 207     public Font[] getAllFonts() {
 208         FontManagerForSGE fm = getFontManagerForSGE();
 209         Font[] installedFonts = fm.getAllInstalledFonts();
 210         Font[] created = fm.getCreatedFonts();
 211         if (created == null || created.length == 0) {
 212             return installedFonts;
 213         } else {
 214             int newlen = installedFonts.length + created.length;
 215             Font [] fonts = java.util.Arrays.copyOf(installedFonts, newlen);
 216             System.arraycopy(created, 0, fonts,
 217                              installedFonts.length, created.length);
 218             return fonts;
 219         }
 220     }
 221 
 222     public String[] getAvailableFontFamilyNames(Locale requestedLocale) {
 223         FontManagerForSGE fm = getFontManagerForSGE();
 224         String[] installed = fm.getInstalledFontFamilyNames(requestedLocale);
 225         /* Use a new TreeMap as used in getInstalledFontFamilyNames
 226          * and insert all the keys in lower case, so that the sort order
 227          * is the same as the installed families. This preserves historical
 228          * behaviour and inserts new families in the right place.
 229          * It would have been marginally more efficient to directly obtain
 230          * the tree map and just insert new entries, but not so much as
 231          * to justify the extra internal interface.
 232          */
 233         TreeMap<String, String> map = fm.getCreatedFontFamilyNames();
 234         if (map == null || map.size() == 0) {
 235             return installed;
 236         } else {
 237             for (int i=0; i<installed.length; i++) {
 238                 map.put(installed[i].toLowerCase(requestedLocale),
 239                         installed[i]);
 240             }
 241             String[] retval =  new String[map.size()];
 242             Object [] keyNames = map.keySet().toArray();
 243             for (int i=0; i < keyNames.length; i++) {
 244                 retval[i] = (String)map.get(keyNames[i]);
 245             }
 246             return retval;
 247         }
 248     }
 249 
 250     public String[] getAvailableFontFamilyNames() {
 251         return getAvailableFontFamilyNames(Locale.getDefault());
 252     }
 253 
 254     /**
 255      * Return the bounds of a GraphicsDevice, less its screen insets.
 256      * See also java.awt.GraphicsEnvironment.getUsableBounds();
 257      */
 258     public static Rectangle getUsableBounds(GraphicsDevice gd) {
 259         GraphicsConfiguration gc = gd.getDefaultConfiguration();
 260         Insets insets = Toolkit.getDefaultToolkit().getScreenInsets(gc);
 261         Rectangle usableBounds = gc.getBounds();
 262 
 263         usableBounds.x += insets.left;
 264         usableBounds.y += insets.top;
 265         usableBounds.width -= (insets.left + insets.right);
 266         usableBounds.height -= (insets.top + insets.bottom);
 267 
 268         return usableBounds;
 269     }
 270 
 271     /**
 272      * From the DisplayChangedListener interface; called
 273      * when the display mode has been changed.
 274      */
 275     public void displayChanged() {
 276         // notify screens in device array to do display update stuff
 277         for (GraphicsDevice gd : getScreenDevices()) {
 278             if (gd instanceof DisplayChangedListener) {
 279                 ((DisplayChangedListener) gd).displayChanged();
 280             }
 281         }
 282 
 283         // notify SunDisplayChanger list (e.g. VolatileSurfaceManagers and
 284         // SurfaceDataProxies) about the display change event
 285         displayChanger.notifyListeners();
 286     }
 287 
 288     /**
 289      * Part of the DisplayChangedListener interface:
 290      * propagate this event to listeners
 291      */
 292     public void paletteChanged() {
 293         displayChanger.notifyPaletteChanged();
 294     }
 295 
 296     /**
 297      * Returns true when the display is local, false for remote displays.
 298      *
 299      * @return true when the display is local, false for remote displays
 300      */
 301     public abstract boolean isDisplayLocal();
 302 
 303     /*
 304      * ----DISPLAY CHANGE SUPPORT----
 305      */
 306 
 307     protected SunDisplayChanger displayChanger = new SunDisplayChanger();
 308 
 309     /**
 310      * Add a DisplayChangeListener to be notified when the display settings
 311      * are changed.
 312      */
 313     public void addDisplayChangedListener(DisplayChangedListener client) {
 314         displayChanger.add(client);
 315     }
 316 
 317     /**
 318      * Remove a DisplayChangeListener from Win32GraphicsEnvironment
 319      */
 320     public void removeDisplayChangedListener(DisplayChangedListener client) {
 321         displayChanger.remove(client);
 322     }
 323 
 324     /*
 325      * ----END DISPLAY CHANGE SUPPORT----
 326      */
 327 
 328     /**
 329      * Returns true if FlipBufferStrategy with COPIED buffer contents
 330      * is preferred for this peer's GraphicsConfiguration over
 331      * BlitBufferStrategy, false otherwise.
 332      *
 333      * The reason FlipBS could be preferred is that in some configurations
 334      * an accelerated copy to the screen is supported (like Direct3D 9)
 335      *
 336      * @return true if flip strategy should be used, false otherwise
 337      */
 338     public boolean isFlipStrategyPreferred(ComponentPeer peer) {
 339         return false;
 340     }
 341 }