modules/javafx.graphics/src/main/java/javafx/scene/Scene.java

rev 10598 : 8185767: Fix broken links in Javadocs

*** 122,132 ****
   * without any 3D transforms does not need a depth buffer nor scene
   * anti-aliasing support. A scene containing 3D shapes or 2D shapes with 3D
   * transforms may use depth buffer support for proper depth sorted rendering; to
   * avoid depth fighting (also known as Z fighting), disable depth testing on 2D
   * shapes that have no 3D transforms. See
!  * {@link Node#depthTestProperty depthTest} for more information. A scene with
   * 3D shapes may enable scene anti-aliasing to improve its rendering quality.
   * <p>
   * The depthBuffer and antiAliasing flags are conditional features. With the
   * respective default values of: false and {@code SceneAntialiasing.DISABLED}.
   * See {@link javafx.application.ConditionalFeature#SCENE3D ConditionalFeature.SCENE3D}
--- 122,132 ----
   * without any 3D transforms does not need a depth buffer nor scene
   * anti-aliasing support. A scene containing 3D shapes or 2D shapes with 3D
   * transforms may use depth buffer support for proper depth sorted rendering; to
   * avoid depth fighting (also known as Z fighting), disable depth testing on 2D
   * shapes that have no 3D transforms. See
!  * {@link Node#depthTestProperty() depthTest} for more information. A scene with
   * 3D shapes may enable scene anti-aliasing to improve its rendering quality.
   * <p>
   * The depthBuffer and antiAliasing flags are conditional features. With the
   * respective default values of: false and {@code SceneAntialiasing.DISABLED}.
   * See {@link javafx.application.ConditionalFeature#SCENE3D ConditionalFeature.SCENE3D}
*** 136,146 ****
   * {@code Shape3D} nodes, but no light nodes. This light source is a
   * {@code Color.WHITE} {@code PointLight} placed at the camera position.
   *
   * <p>
   * A {@code Scene} may be created and modified on any thread until it is attached
!  * to a {@link Window} that is {@link Window#isShowing showing}.
   * After that, it must be modified only on the JavaFX Application Thread.
   * Note that {@code Scene} is not thread-safe; modifying a {@code Scene} on
   * multiple threads at the same time will lead to unpredictable results and
   * must be avoided.
   * </p>
--- 136,146 ----
   * {@code Shape3D} nodes, but no light nodes. This light source is a
   * {@code Color.WHITE} {@code PointLight} placed at the camera position.
   *
   * <p>
   * A {@code Scene} may be created and modified on any thread until it is attached
!  * to a {@link Window} that is {@link Window#isShowing() showing}.
   * After that, it must be modified only on the JavaFX Application Thread.
   * Note that {@code Scene} is not thread-safe; modifying a {@code Scene} on
   * multiple threads at the same time will lead to unpredictable results and
   * must be avoided.
   * </p>
*** 271,281 ****
       * A scene with only 2D shapes and without any 3D transforms does not need a
       * depth buffer. A scene containing 3D shapes or 2D shapes with 3D
       * transforms may use depth buffer support for proper depth sorted
       * rendering; to avoid depth fighting (also known as Z fighting), disable
       * depth testing on 2D shapes that have no 3D transforms. See
!      * {@link Node#depthTestProperty depthTest} for more information.
       *
       * @param root The root node of the scene graph
       * @param width The width of the scene
       * @param height The height of the scene
       * @param depthBuffer The depth buffer flag
--- 271,281 ----
       * A scene with only 2D shapes and without any 3D transforms does not need a
       * depth buffer. A scene containing 3D shapes or 2D shapes with 3D
       * transforms may use depth buffer support for proper depth sorted
       * rendering; to avoid depth fighting (also known as Z fighting), disable
       * depth testing on 2D shapes that have no 3D transforms. See
!      * {@link Node#depthTestProperty() depthTest} for more information.
       *
       * @param root The root node of the scene graph
       * @param width The width of the scene
       * @param height The height of the scene
       * @param depthBuffer The depth buffer flag
*** 301,311 ****
       * A scene with only 2D shapes and without any 3D transforms does not need a
       * depth buffer nor scene anti-aliasing support. A scene containing 3D
       * shapes or 2D shapes with 3D transforms may use depth buffer support for
       * proper depth sorted rendering; to avoid depth fighting (also known as Z
       * fighting), disable depth testing on 2D shapes that have no 3D transforms.
!      * See {@link Node#depthTestProperty depthTest} for more information. A
       * scene with 3D shapes may enable scene anti-aliasing to improve its
       * rendering quality.
       *
       * @param root The root node of the scene graph
       * @param width The width of the scene
--- 301,311 ----
       * A scene with only 2D shapes and without any 3D transforms does not need a
       * depth buffer nor scene anti-aliasing support. A scene containing 3D
       * shapes or 2D shapes with 3D transforms may use depth buffer support for
       * proper depth sorted rendering; to avoid depth fighting (also known as Z
       * fighting), disable depth testing on 2D shapes that have no 3D transforms.
!      * See {@link Node#depthTestProperty() depthTest} for more information. A
       * scene with 3D shapes may enable scene anti-aliasing to improve its
       * rendering quality.
       *
       * @param root The root node of the scene graph
       * @param width The width of the scene
*** 5769,5779 ****
      }
  
      /**
       * Defines a function to be called when the mouse button is released
       * on this {@code Scene} during drag and drop gesture. Transfer of data from
!      * the {@link DragEvent}'s {@link DragEvent#dragboard dragboard} should
       * happen in this function.
       * @return the function to be called when the mouse button is released on
       * this scene during drag and drop gesture
       */
      public final ObjectProperty<EventHandler<? super DragEvent>> onDragDroppedProperty() {
--- 5769,5779 ----
      }
  
      /**
       * Defines a function to be called when the mouse button is released
       * on this {@code Scene} during drag and drop gesture. Transfer of data from
!      * the {@link DragEvent}'s {@link DragEvent#getDragboard() dragboard} should
       * happen in this function.
       * @return the function to be called when the mouse button is released on
       * this scene during drag and drop gesture
       */
      public final ObjectProperty<EventHandler<? super DragEvent>> onDragDroppedProperty() {
*** 5818,5829 ****
       * clear out its data. Clearing the source's data gives the appropriate
       * appearance to a user that the data has been moved by the drag and drop
       * gesture. A {@code transferMode} that has the value {@code NONE}
       * indicates that no data was transferred during the drag and drop gesture.
       * Positional data for the {@code DragEvent} is invalid.  Valid positional
!      * data for the {@code DragEvent} is presented in the {@link onDragDropped}
!      * event handler.
       * @return the function to be called when this scene is a drag and drop
       * gesture source after its data has been dropped on a drop target
       */
      public final ObjectProperty<EventHandler<? super DragEvent>> onDragDoneProperty() {
          if (onDragDone == null) {
--- 5818,5829 ----
       * clear out its data. Clearing the source's data gives the appropriate
       * appearance to a user that the data has been moved by the drag and drop
       * gesture. A {@code transferMode} that has the value {@code NONE}
       * indicates that no data was transferred during the drag and drop gesture.
       * Positional data for the {@code DragEvent} is invalid.  Valid positional
!      * data for the {@code DragEvent} is presented in the
!      * {@link #onDragDroppedProperty() onDragDropped} event handler.
       * @return the function to be called when this scene is a drag and drop
       * gesture source after its data has been dropped on a drop target
       */
      public final ObjectProperty<EventHandler<? super DragEvent>> onDragDoneProperty() {
          if (onDragDone == null) {