Uploaded image for project: 'JDK'
  1. JDK
  2. JDK-8140222

JavaFX documentation and tutorial should reflect about HDPI image support

    XMLWordPrintable

Details

    • Enhancement
    • Resolution: Won't Fix
    • P4
    • None
    • 8u66
    • docs
    • x86_64
    • windows_7

    Description

      A DESCRIPTION OF THE REQUEST :
      JavaFX currently supports transparent loading of HDPI images using the Apple naming scheme convention for CSS, FXML and javafx.scene.image.Image.

      IE: on HDPI / retina display or when launching the app with the -Dglass.win.uiScale=2.0 JVM flag, if the code (CSS, FXML or Java) specifies to load an image named "foo.png", the runtime will load an alternate high-resolution image named "foo@2x.png" instead if present.

      However this feature is neither mentionned nor described in the JavaFX tutorial and documentation at Oracle's or specified in the javadoc of javafx.scene.image.Image.

      JUSTIFICATION :
      Amending the documentation and tutorial to explicitely mention this feature, would help clarify that JavaFX does indeed support HDPI display.

      This would also help understand the limitations of the current loading process (IE: apparently currently it's not possible to use an image named "foo@4x.png" for ultra-high-DPI displays).

      EXPECTED VERSUS ACTUAL BEHAVIOR :
      EXPECTED -
      Documentation and tutorial should clearly indicate the extend to which this feature works and is supported among major officially supported platforms (Windows, Linux and Mac OS X).

      The javadoc of javadoc of javafx.scene.image.Image should be explicit on how image loading works and if it also works for remote images (HTTP or HTTPS URLs) or only for local (ie: disk and JAR) URLs.
      ACTUAL -
      There is currently no description of this feature at all execpt for few references on the OpenJFX mailing list and some blog posts.

      Attachments

        Activity

          People

            Unassigned Unassigned
            webbuggrp Webbug Group
            Votes:
            0 Vote for this issue
            Watchers:
            2 Start watching this issue

            Dates

              Created:
              Updated:
              Resolved: