The
GraphicsEnvironment
class describes the collection of
GraphicsDevice
objects and
Font
objects available to a Java(tm) application on a particular platform. The resources in this
GraphicsEnvironment
might be local or on a remote machine.
GraphicsDevice
objects can be screens, printers or image buffers and are the destination of
Graphics2D
drawing methods. Each
GraphicsDevice
has a number of
GraphicsConfiguration
objects associated with it. These objects specify the different configurations in which the
GraphicsDevice
can be used.
Constructors
protected
This is an abstract class and cannot be instantiated directly.
Returns a
Graphics2D
object for rendering into the specified
BufferedImage
.
Returns an array containing a one-point size instance of all fonts available in this GraphicsEnvironment
.
Returns an array containing the names of all font families in this GraphicsEnvironment
localized for the default locale, as returned by Locale.getDefault()
.
Returns an array containing the names of all font families in this GraphicsEnvironment
localized for the specified locale.
Returns the Point where Windows should be centered.
Returns the default screen GraphicsDevice
.
Returns the local GraphicsEnvironment
.
Returns the maximum bounds for centered Windows.
Returns an array of all of the screen GraphicsDevice
objects.
static boolean
Tests whether or not a display, keyboard, and mouse can be supported in this environment.
boolean
Returns whether or not a display, keyboard, and mouse can be supported in this graphics environment.
void
Indicates a preference for locale-specific fonts in the mapping of logical fonts to physical fonts.
void
Indicates a preference for proportional over non-proportional (for example dual-spaced CJK fonts) fonts in the mapping of logical fonts to physical fonts.
boolean
Registers a created Font
in this GraphicsEnvironment
.
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
protected GraphicsEnvironment()
This is an abstract class and cannot be instantiated directly. Instances must be obtained from a suitable factory or query method.
Returns the local GraphicsEnvironment
.
GraphicsEnvironment
public static boolean isHeadless()
Tests whether or not a display, keyboard, and mouse can be supported in this environment. If this method returns true, a HeadlessException is thrown from areas of the Toolkit and GraphicsEnvironment that are dependent on a display, keyboard, or mouse.
true
if this environment cannot support a display, keyboard, and mouse; false
otherwise
public boolean isHeadlessInstance()
Returns whether or not a display, keyboard, and mouse can be supported in this graphics environment. If this returns true, HeadlessException
will be thrown from areas of the graphics environment that are dependent on a display, keyboard, or mouse.
true
if a display, keyboard, and mouse can be supported in this environment; false
otherwise
Returns an array of all of the screen GraphicsDevice
objects.
GraphicsDevice
objects that represent screen devices
HeadlessException
- if isHeadless() returns true
Returns the default screen GraphicsDevice
.
GraphicsDevice
that represents the default screen device
HeadlessException
- if isHeadless() returns true
Returns a
Graphics2D
object for rendering into the specified
BufferedImage
.
img
- the specified BufferedImage
Graphics2D
to be used for rendering into the specified BufferedImage
NullPointerException
- if img
is null
()
Returns an array containing a one-point size instance of all fonts available in this
GraphicsEnvironment
. Typical usage would be to allow a user to select a particular font. Then, the application can size the font and set various font attributes by calling the
deriveFont
method on the chosen instance.
This method provides for the application the most precise control over which Font
instance is used to render text. If a font in this GraphicsEnvironment
has multiple programmable variations, only one instance of that Font
is returned in the array, and other variations must be derived by the application.
If a font in this environment has multiple programmable variations, such as Multiple-Master fonts, only one instance of that font is returned in the Font
array. The other variations must be derived by the application.
Font
objects
()
Returns an array containing the names of all font families in this
GraphicsEnvironment
localized for the default locale, as returned by
Locale.getDefault()
.
Typical usage would be for presentation to a user for selection of a particular family name. An application can then specify this name when creating a font, in conjunction with a style, such as bold or italic, giving the font system flexibility in choosing its own best match among multiple fonts in the same font family.
String
containing font family names localized for the default locale, or a suitable alternative name if no name exists for this locale.
Returns an array containing the names of all font families in this
GraphicsEnvironment
localized for the specified locale.
Typical usage would be for presentation to a user for selection of a particular family name. An application can then specify this name when creating a font, in conjunction with a style, such as bold or italic, giving the font system flexibility in choosing its own best match among multiple fonts in the same font family.
l
- a Locale
object that represents a particular geographical, political, or cultural region. Specifying null
is equivalent to specifying Locale.getDefault()
.
String
containing font family names localized for the specified Locale
, or a suitable alternative name if no name exists for the specified locale.
Registers a
createdFont
in this
GraphicsEnvironment
. A created font is one that was returned from calling
Font.createFont(int, java.io.InputStream)
, or derived from a created font by calling
Font.deriveFont(int, float)
. After calling this method for such a font, it is available to be used in constructing new
Font
s by name or family name, and is enumerated by
getAvailableFontFamilyNames()
and
getAllFonts()
within the execution context of this application or applet. This means applets cannot register fonts in a way that they are visible to other applets.
Reasons that this method might not register the font and therefore return false
are:
Font
.Font
already in this GraphicsEnvironment
. For example if the name is that of a system font, or a logical font as described in the documentation of the Font
class. It is implementation dependent whether a font may also conflict if it has the same family name as a system font.
Notice that an application can supersede the registration of an earlier created font with a new one.
font
- the font to be registered
font
is successfully registered in this GraphicsEnvironment
.
NullPointerException
- if font
is null
public void preferLocaleFonts()
The actual change in font rendering behavior resulting from a call to this method is implementation dependent; it may have no effect at all, or the requested behavior may already match the default behavior. The behavior may differ between font rendering in lightweight and peered components. Since calling this method requests a different font, clients should expect different metrics, and may need to recalculate window sizes and layout. Therefore this method should be called before user interface initialisation.
public void preferProportionalFonts()
The actual change in font rendering behavior resulting from a call to this method is implementation dependent; it may have no effect at all. The behavior may differ between font rendering in lightweight and peered components. Since calling this method requests a different font, clients should expect different metrics, and may need to recalculate window sizes and layout. Therefore this method should be called before user interface initialisation.
Returns the Point where Windows should be centered. It is recommended that centered Windows be checked to ensure they fit within the available display area using getMaximumWindowBounds().
HeadlessException
- if isHeadless() returns true
To get the usable bounds of a single display, use GraphicsConfiguration.getBounds()
and Toolkit.getScreenInsets()
.
HeadlessException
- if isHeadless() returns true
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4