JDK-8124939 : [FX3D] Need better documentation for the default PointLight
  • Type: Bug
  • Component: javafx
  • Sub-Component: graphics
  • Affected Version: 8
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2013-05-15
  • Updated: 2015-06-17
  • Resolved: 2013-12-06
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availability Release.

To download the current JDK release, click here.
JDK 8
8Fixed
Related Reports
Blocks :  
JDK-8101810 - Finish javadoc for FX 8 3D API
Relates :  
JDK-8123980 - FX 8 3D: Scene doesn't have default lighting that is stated in the specification
Description
Run this code.

You can see in code, that scene not contains any light.
But on screenshot sphere is not dark.
Comments
Thanks!
06-12-2013
A couple suggestions for you. PointLight.java: + * Defines a point light source object. An light source that has a "A" light source ... Scene.java: + * A default headlight will be added to a scene that contains {@code Shape3D} + * but without light source. ... that contains one or more {@code Shape3D} nodes, but no light nodes. SubScene.java: same comment as for Scene; also you should replace "scene" with "SubScene" in the javadoc. +1 with the recommends changes (or similar).
06-12-2013
Kevin, Please review this simple javadoc change: http://cr.openjdk.java.net/~ckyang/RT-30404/webrev.00/
06-12-2013
This is not a bug (see RT-28624), but is the intended behavior. I have changed the summary to reflect the fact that this behavior needs to be better documented.
15-05-2013