java.awt.GraphicsConfiguration Maven / Gradle / Ivy

Neither this file nor any files generated from it describe a complete specification, and they may only be used as described below. For example, no permission is given for you to incorporate this file, in whole or in part, in an implementation of a Java specification.

Sun Microsystems Inc. owns the copyright in this file and it is provided to you for informative, as opposed to normative, use. The file and any files generated from it may be used to generate other informative documentation, such as a unified set of documents of API signatures for a platform that includes technologies expressed as Java APIs. The file may also be used to produce "compilation stubs," which allow applications to be compiled and validated for such platforms.

Any work generated from this file, such as unified javadocs or compiled stub files, must be accompanied by this notice in its entirety.

This work corresponds to the API signatures of JSR 217: Personal Basis Profile 1.1. In the event of a discrepency between this work and the JSR 217 specification, which is available at http://www.jcp.org/en/jsr/detail?id=217, the latter takes precedence. */ package java.awt; // import java.awt.geom.AffineTransform; import java.awt.image.BufferedImage; import java.awt.image.ColorModel; import java.awt.image.VolatileImage; /** * The GraphicsConfiguration class describes the * characteristics of a graphics destination such as a printer or monitor. * There can be many GraphicsConfiguration objects associated * with a single graphics device, representing different drawing modes or * capabilities. The corresponding native structure will vary from platform * to platform. For example, on X11 windowing systems, * each visual is a different GraphicsConfiguration. * On Microsoft Windows, GraphicsConfigurations represent * PixelFormats available in the current resolution and color depth. *

* In a virtual device multi-screen environment in which the desktop * area could span multiple physical screen devices, the bounds of the * GraphicsConfiguration objects are relative to the * virtual coordinate system. When setting the location of a * component, use {@link #getBounds() getBounds} to get the bounds of * the desired GraphicsConfiguration and offset the location * with the coordinates of the GraphicsConfiguration, * as the following code sample illustrates: *

 *      Frame f = new Frame(gc);  // where gc is a GraphicsConfiguration
 *      Rectangle bounds = gc.getBounds();
 *      f.setLocation(10 + bounds.x, 10 + bounds.y); 

* To determine if your environment is a virtual device * environment, call getBounds on all of the * GraphicsConfiguration objects in your system. If * any of the origins of the returned bounds is not (0, 0), * your environment is a virtual device environment. * *

* You can also use getBounds to determine the bounds * of the virtual device. To do this, first call getBounds on all * of the GraphicsConfiguration objects in your * system. Then calculate the union of all of the bounds returned * from the calls to getBounds. The union is the * bounds of the virtual device. The following code sample * calculates the bounds of the virtual device. * *

 *      Rectangle virtualBounds = new Rectangle();
 *      GraphicsEnvironment ge = GraphicsEnvironment.
 *              getLocalGraphicsEnvironment();
 *      GraphicsDevice[] gs =
 *              ge.getScreenDevices();
 *      for (int j = 0; j < gs.length; j++) { 
 *          GraphicsDevice gd = gs[j];
 *          GraphicsConfiguration[] gc =
 *              gd.getConfigurations();
 *          for (int i=0; i < gc.length; i++) {
 *              virtualBounds =
 *                  virtualBounds.union(gc[i].getBounds());
 *          }
 *      } 

// * For a particular {@link Graphics2D}, g, one // * can reset the transformation to create // * such a mapping by using the following pseudocode: // *

     // *      GraphicsConfiguration gc = g.getGraphicsConfiguration();
     // *
     // *      g.setTransform(gc.getDefaultTransform());
     // *      g.transform(gc.getNormalizingTransform());
     // *