< prev index next >

src/java.desktop/share/classes/java/awt/SplashScreen.java

Print this page




  48  * Place the image in the jar archive and specify the path in the option.
  49  * The path should not have a leading slash.
  50  * <BR>
  51  * For example, in the {@code manifest.mf} file:
  52  * <PRE>
  53  * Manifest-Version: 1.0
  54  * Main-Class: Test
  55  * SplashScreen-Image: filename.gif
  56  * </PRE>
  57  * <P>
  58  * If the Java implementation provides the command-line interface and you run
  59  * your application by using the command line or a shortcut, use the Java
  60  * application launcher option to show a splash screen. The Oracle reference
  61  * implementation allows you to specify the splash screen image location with
  62  * the {@code -splash:} option.
  63  * <BR>
  64  * For example:
  65  * <PRE>
  66  * java -splash:filename.gif Test
  67  * </PRE>










  68  * The command line interface has higher precedence over the manifest
  69  * setting.
  70  * <p>
  71  * The splash screen will be displayed as faithfully as possible to present the
  72  * whole splash screen image given the limitations of the target platform and
  73  * display.
  74  * <p>
  75  * It is implied that the specified image is presented on the screen "as is",
  76  * i.e. preserving the exact color values as specified in the image file. Under
  77  * certain circumstances, though, the presented image may differ, e.g. when
  78  * applying color dithering to present a 32 bits per pixel (bpp) image on a 16
  79  * or 8 bpp screen. The native platform display configuration may also affect
  80  * the colors of the displayed image (e.g.  color profiles, etc.)
  81  * <p>
  82  * The {@code SplashScreen} class provides the API for controlling the splash
  83  * screen. This class may be used to close the splash screen, change the splash
  84  * screen image, get the splash screen native window position/size, and paint
  85  * in the splash screen. It cannot be used to create the splash screen. You
  86  * should use the options provided by the Java implementation for that.
  87  * <p>




  48  * Place the image in the jar archive and specify the path in the option.
  49  * The path should not have a leading slash.
  50  * <BR>
  51  * For example, in the {@code manifest.mf} file:
  52  * <PRE>
  53  * Manifest-Version: 1.0
  54  * Main-Class: Test
  55  * SplashScreen-Image: filename.gif
  56  * </PRE>
  57  * <P>
  58  * If the Java implementation provides the command-line interface and you run
  59  * your application by using the command line or a shortcut, use the Java
  60  * application launcher option to show a splash screen. The Oracle reference
  61  * implementation allows you to specify the splash screen image location with
  62  * the {@code -splash:} option.
  63  * <BR>
  64  * For example:
  65  * <PRE>
  66  * java -splash:filename.gif Test
  67  * </PRE>
  68  * HiDPI scaled image is also supported for both jar and command line option
  69  * Unscaled image name i.e. filename.gif should be passed in
  70  * manifest/{@code -splash:} option for all image types irrespective of
  71  * HiDPI and Non-HiDPI
  72  * Following is the naming convention for scaled images.
  73  * Screen scale 1.25: filename@125pct.gif
  74  * Screen scale 1.50: filename@150pct.gif
  75  * Screen scale 2:    filename@200pct.gif and filename@2x.gif both are supported
  76  * Screen scale 2.50: filename@250pct.gif
  77  * Screen scale 3:    filename@300pct.gif and filename@3x.gif both are supported
  78  * The command line interface has higher precedence over the manifest
  79  * setting.
  80  * <p>
  81  * The splash screen will be displayed as faithfully as possible to present the
  82  * whole splash screen image given the limitations of the target platform and
  83  * display.
  84  * <p>
  85  * It is implied that the specified image is presented on the screen "as is",
  86  * i.e. preserving the exact color values as specified in the image file. Under
  87  * certain circumstances, though, the presented image may differ, e.g. when
  88  * applying color dithering to present a 32 bits per pixel (bpp) image on a 16
  89  * or 8 bpp screen. The native platform display configuration may also affect
  90  * the colors of the displayed image (e.g.  color profiles, etc.)
  91  * <p>
  92  * The {@code SplashScreen} class provides the API for controlling the splash
  93  * screen. This class may be used to close the splash screen, change the splash
  94  * screen image, get the splash screen native window position/size, and paint
  95  * in the splash screen. It cannot be used to create the splash screen. You
  96  * should use the options provided by the Java implementation for that.
  97  * <p>


< prev index next >