java.lang.Object | |
↳ | java.awt.SplashScreen |
The splash screen can be created at application startup, before the Java Virtual Machine (JVM) starts. The splash screen is displayed as an undecorated window containing an image. You can use GIF, JPEG, and PNG files for the image. Animation (for GIF) and transparency (for GIF, PNG) are supported. The window is positioned at the center of the screen (the position on multi-monitor systems is not specified - it is platform and implementation dependent). The window is closed automatically as soon as the first window is displayed by Swing/AWT (may be also closed manually using the Java API, see below).
There are two ways to show the native splash screen:
java -splash:filename.gif Test
manifest.mf
file:
Manifest-Version: 1.0 Main-Class: Test SplashScreen-Image: filename.gifThe command line interface has higher precedence over the manifest setting.
The SplashScreen
class provides the API for controlling the splash
screen. This class may be used to close the splash screen, change the splash
screen image, get the image position/size and paint in the splash screen. It
cannot be used to create the splash screen; you should use the command line or manifest
file option for that.
This class cannot be instantiated. Only a single instance of this class
can exist, and it may be obtained using the getSplashScreen()
static method. In case the splash screen has not been created at
application startup via the command line or manifest file option,
the getSplashScreen
method returns null
.
Public Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
Hides the splash screen, closes the window, and releases all associated
resources.
| |||||||||||
Creates a graphics context (as a
Graphics2D object) for the splash
screen overlay image, which allows you to draw over the splash screen. | |||||||||||
Returns the bounds of the splash screen window as a
Rectangle . | |||||||||||
Returns the current splash screen image.
| |||||||||||
Returns the size of the splash screen window as a
Dimension . | |||||||||||
Returns the
SplashScreen object used for
Java startup splash screen control. | |||||||||||
Determines whether the splash screen is visible.
| |||||||||||
Changes the splash screen image.
| |||||||||||
Updates the splash window with current contents of the overlay image.
|
[Expand]
Inherited Methods | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|
From class
java.lang.Object
|
Hides the splash screen, closes the window, and releases all associated resources.
IllegalStateException | if the splash screen has already been closed |
---|
Creates a graphics context (as a Graphics2D
object) for the splash
screen overlay image, which allows you to draw over the splash screen.
Note that you do not draw on the main image but on the image that is
displayed over the main image using alpha blending. Also note that drawing
on the overlay image does not necessarily update the contents of splash
screen window. You should call update()
on the
SplashScreen
when you want the splash screen to be
updated immediately.
IllegalStateException | if the splash screen has already been closed |
---|
Returns the bounds of the splash screen window as a Rectangle
.
This may be useful if, for example, you want to replace the splash
screen with your window at the same location.
You cannot control the size or position of the splash screen. The splash screen size is adjusted automatically when the image changes.
Rectangle
containing the splash screen boundsIllegalStateException | if the splash screen has already been closed |
---|
Returns the current splash screen image.
IllegalStateException | if the splash screen has already been closed |
---|
Returns the size of the splash screen window as a Dimension
.
This may be useful if, for example,
you want to draw on the splash screen overlay surface.
You cannot control the size or position of the splash screen. The splash screen size is adjusted automatically when the image changes.
Dimension
object indicating the splash screen sizeIllegalStateException | if the splash screen has already been closed |
---|
Returns the SplashScreen
object used for
Java startup splash screen control.
SplashScreen
instance, or null
if there is
none or it has already been closed
UnsupportedOperationException | if the splash screen feature is not supported by the current toolkit |
---|---|
HeadlessException | if GraphicsEnvironment.isHeadless()
returns true |
Determines whether the splash screen is visible. The splash screen may
be hidden using close()
, it is also hidden automatically when
the first AWT/Swing window is made visible.
Changes the splash screen image. The new image is loaded from the specified URL; GIF, JPEG and PNG image formats are supported. The method returns after the image has finished loading and the window has been updated. The splash screen window is resized according to the size of the image and is centered on the screen.
imageURL | the non-null URL for the new
splash screen image |
---|
NullPointerException | if imageURL is null |
---|---|
IOException | if there was an error while loading the image |
IllegalStateException | if the splash screen has already been closed |
Updates the splash window with current contents of the overlay image.
IllegalStateException | if the overlay image does not exist;
for example, if createGraphics has never been called,
or if the splash screen has already been closed
|
---|