JDK-8112268 : Need to document clipping semantic on Node with 3D transforms
  • Type: Bug
  • Component: javafx
  • Sub-Component: graphics
  • Affected Version: fx2.0
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • Submitted: 2011-03-14
  • Updated: 2015-06-16
  • Resolved: 2011-08-31
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.
Other
fx2.0Fixed
Related Reports
Blocks :  
JDK-8099884 - Resolve clipping semantic with 3D transforms
Blocks :  
JDK-8099419 - Add Z depth sorting (Z-buffering) to JavaFX
Blocks :  
JDK-8114034 - Shape with clip set to true doesn't render correctly with perspective transform and depth test
Blocks :  
JDK-8092948 - Clipping doesn't work for objects in 3D
Relates :  
JDK-8108728 - Need to address Node.cache for 3D perspective camera rendering
Description
The is a TODO to document the expected rendering behavior and semantic of clip on Node with 3D transforms. Test cases have been written and were added to toys/visual3DTest
Comments
Verified with b42
02-09-2011
We believe the clipping documentation is sufficient for 2.0. We will add a release note for RT-15181 describing the clipping bug.
31-08-2011
SQE - If we do not consider this feature done and don't want people to use it - this needs to be mentioned in documentation or release notes If we want people to use this but there are limitation or issue why don't we document what the limitations are.
31-08-2011
Until we resolve the underlying implementation issues, and determine what, if any, additional documentation should be added, we want to intentionally keep the specification loose. We neither want to just document the current behavior as if that were the specification, nor do we want to specify something else that we currently don't implement. This is similar in that regard to the spec bug we deferred with picking and depth testing. So either we will defer this, or close it as "Won't Fix" because as it stands there is nothing to do in this area for Presidio.
26-08-2011
This is not a code bug but a TODO about to add info to the javadoc. This needs to be done in Presidio.
26-08-2011
Pls target it to Lombard.
25-08-2011
As you might have noticed the API doc. was already done, to intentionally keep the specification loose as the implementation is still in progress. It was reopened by Alexander to make the specification clearer, but we prefer not to till we have completed the implementation.
25-08-2011
SQE - Why are we deferring a documentation request? I understand that what we are going to release does not work as expected but this is what we have and we need to document it If we consider current behavior broken than we need to mention this in documentaiton (as APIs are there) and release note it
25-08-2011
We can better document clipping semantic once we get the proper clipping implementation working in JavaFX. We recommend to defer this bug till RT-15181 is resolved.
23-08-2011
justClipping.jpg looks as expected. However, when transforms are applied, it generates something completely different and unpredictable.
19-07-2011
The wording is not sufficient: "There is a known limitation of mixing Clip with a 3D Transform. Clipping is essentially a 2D image operation. The result of a Clip set on a Group node with 3D transformed children will cause its children to be rendered in order without Z-buffering applied between those children. " It is not clear from this description how will the clipping be applied after the children are rendered without proper Z-buffering. See the attached images and source code.
19-07-2011
Fixed. Changeset: d26f8f449a34 Author: Chien Yang <chien.yang@orcale.com> Date: Tue Jun 14 21:50:32 2011 +0800 URL: http://jfxsrc.us.oracle.com/javafx/presidio/scrum/graphics/runtime/rev/d26f8f449a34
14-06-2011
The document will be placed in the depth-test API doc. section. Note that the rendering effect, w/o depth-test enabled, is the same between 2D and 3D; i.e. in-order rendering.
14-03-2011