JDK-8101810 : Finish javadoc for FX 8 3D API
  • Type: Enhancement
  • Component: javafx
  • Sub-Component: graphics
  • Affected Version: 8
  • Priority: P3
  • Status: Resolved
  • Resolution: Fixed
  • Submitted: 2012-11-20
  • Updated: 2015-06-16
  • Resolved: 2013-12-10
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-8102150 - Need to define parallel camera position for picking
Blocks :  
JDK-8122785 - Document importance of TriangleMesh order of elements
Blocks :  
JDK-8103108 - Document the eye coordinate system
Blocks :  
JDK-8124939 - [FX3D] Need better documentation for the default PointLight
Blocks :  
JDK-8102454 - Specify the lighting equation for 3D PhongMaterial rendering
Blocks :  
JDK-8123042 - Camera.isFixedEyeAtCameraZero needs documentation
Relates :  
JDK-8102019 - Re-evaluate the coord. system where the near and far clipping planes of Camera is specified
Relates :  
JDK-8103194 - Document TriangleMesh's texture coordinate system
Relates :  
JDK-8102634 - Re-evaluate the values and range of near and far clipping planes of Camera
Description
There is a good amount of java doc written for the new 3D API for FX 8. We need to ensure this work finish before we release FX 8.
Comments
Fixed. Changeset: 35d622e670f1 Author: Chien Yang <chien.yang@oracle.com> Date: 2013-12-10 12:43 -0800 URL: http://hg.openjdk.java.net/openjfx/8/graphics/rt/rev/35d622e670f1
10-12-2013
I have verified that the near and far clip documentation was done.
10-12-2013
The changes to SubScene look fine to me. While reviewing the changes, I noticed a couple of things that could still use fixing. First, there may be some formatting oddities, since I see blank lines in the javadoc that suggest a paragraph break, but which are ignored by the tool when turning it to HTML (you usually want to use a <p> ... </p> in that case). Second, the first sentence should be turned into a paragraph or two describing what SubScene does and how it works. If you are out of time in FX 8, please file a follow-on JIRA for this.
07-12-2013
http://hg.openjdk.java.net/openjfx/8/graphics/rt/rev/7d702464f5be
07-12-2013
Partial fix: http://cr.openjdk.java.net/~ckyang/RT-26385/part1webrev.00/
07-12-2013
Added javadoc for Camera class on nearClip and farClip
07-11-2013
Need to improve the near and far clipping planes documentation. We need to define eye coordinates as it is the first time we mention it to the API.
25-05-2013