modules/graphics/src/main/java/javafx/scene/image/Image.java

@@ -60,10 +60,17 @@
 /**
  * The {@code Image} class represents graphical images and is used for loading
  * images from a specified URL.
  *
  * <p>
+ * Supported image formats are BMP, <a href="http://www.w3.org/Graphics/GIF/spec-gif89a.txt">GIF</a>, <a href="http://www.ijg.org">JPEG</a> and <a href="http://www.libpng.org/pub/png/spec/">PNG</a>.
+ * BMP format support is limited to the <a href="http://msdn.microsoft.com/en-us/library/dd183376(v=vs.85).aspx">version 3</a>.
+ * PNG and JPEG images embedded in the BMP files are not supported.<br>
+ * On the iOS platform images are loaded using native Image I/O framework.
+ * </p>
+ *
+ * <p>
  * Images can be resized as they are loaded (for example to reduce the amount of
  * memory consumed by the image). The application can specify the quality of
  * filtering used when scaling, and whether or not to preserve the original
  * image's aspect ratio.
  * </p>