From 87e7484aca3d694a94674291b9c3a505ba63c991 Mon Sep 17 00:00:00 2001 From: Chien Yang Date: Fri, 1 Apr 2005 18:17:39 +0000 Subject: Improved text style and a fixed a few typos. git-svn-id: https://svn.java.net/svn/j3d-core~svn/trunk@188 ba19aa83-45c5-6ac9-afd3-db810772062c --- www/j3d1_4/picking.html | 155 +++++++++++++++++++++++++----------------------- 1 file changed, 81 insertions(+), 74 deletions(-) (limited to 'www') diff --git a/www/j3d1_4/picking.html b/www/j3d1_4/picking.html index 5dbfbf5..cbffdf9 100644 --- a/www/j3d1_4/picking.html +++ b/www/j3d1_4/picking.html @@ -13,36 +13,44 @@ is a Work in Progress

This page describes the proposed picking changes in Java 3D 1.4. The main motivation is to improve picking performance. It eliminates the -need to rely on picking utility for extra pick information, such as the +need to rely on the picking utility for extra pick information, such as +the color, normal and texture coordinates of the intersection points. This -information will be returned, from the core picking methods, in a newly +information will be returned, by the new core picking APIs, in a newly created PickInfo class.
 
-The proposed API is:
+The proposed API are :

-

The following 4 methods will be -added to -Locale and BranchGroup :  -
-

-
public +
    +
  • New methods in existing classes:   +
    +
    • +
+

The following 4 methods will be added to Locale and BranchGroup :  +
+

+
method: public PickInfo[] pickAll( int mode, int flags, PickShape pickShape )
-public PickInfo[] +method: public PickInfo[] pickAllSorted( int mode, int flags, PickShape pickShape )
-public PickInfo pickClosest( +method: public PickInfo pickClosest( int mode, int flags, PickShape pickShape )
-public PickInfo pickAny( int +method: public PickInfo pickAny( int mode, int flags, PickShape pickShape )
-

-
+

Where

-
mode +
mode is an enum of [ Bounds, Geometry ]
-flags +flags is a mask indicating which components are present in each returned PickInfo object. This is specified as one or more individual flags that are bitwise "OR"ed together to describe the returned per PickInfo data. @@ -50,13 +58,13 @@ are bitwise "OR"ed together to describe the returned per PickInfo data. The flags include:
SCENEGRAPHPATH               -- request for computed SceneGraphPath;    
+- request for computed SceneGraphPath.    
NODE                         - request -for computed intersected Node;
+for computed intersected Node.
LOCAL_TO_VWORLD            -  - request for computed local to virtual world transform;
+  - request for computed local to virtual world transform.
CLOSEST_INTERSECTION_POINT   - request for closest intersection point.
@@ -65,28 +73,27 @@ closest intersection point.
         - request for the closest distance of the intersection.
CLOSEST_GEOM_INFO         -   - request for -ONLY the closest intersection geometry information.
-ALL_GEOM_INFO          +   - request for only the closest intersection geometry +information.
+ALL_GEOM_INFO                - request for all intersection geometry information.      
-

-

-
+

+
NOTES :
-

-
If CLOSEST_INTERSECTION_POINT -is not set -return PickInfo.closestIntersectionPoint is set to null.
+
+

+
If CLOSEST_INTERSECTION_POINT +is not set, PickInfo.closestIntersectionPoint is set to null.
If CLOSEST_GEOM_INFO is -set the return PickInfo.intersectionInfos is of length 1, and -pickInfo.geomPickInfo +set, PickInfo.intersectionInfos is of length 1, and +PickInfo.intersectionInfos[0] contains the information of the closest pick.
-If ALL_GEOM_INFO is set -the return PickInfo.intersectionInfos contains all intersections of the +If ALL_GEOM_INFO is set, PickInfo.intersectionInfos +contains all intersections of the pickable node in sorted order.
If both CLOSEST_GEOM_INFO @@ -100,92 +107,92 @@ is thrown if  bothALL_GEOM_INFO are set.
-


-
-    * New classes

-public class PickInfo extends Object    -

-/** +

  • New classes
    • + +
    public class PickInfo extends Object    +
    +

    /** Retrieves the reference to the SceneGraphPath in this PickInfo object. */
    -public -SceneGraphPath getSceneGraphPath()
    +method: public +SceneGraphPath getSceneGraphPath()

    -

    /*/** Retrieves the reference to the picked node, either a Shape3D or a Morph, in this PickInfo object. */
    -    public Node getNode()
    +    method: public Node +getNode()

    /** Retrieves the reference to the LocalToVworld transform of the picked node in this PickInfo object. */
    -    public -Transform3D getLocalToVWorld()
    +    method: public +Transform3D getLocalToVWorld()

    -

    /** +

    /** Retrieves the reference to the closest intersection point in this PickInfo object. */
    -    public -Point3d getClosestIntersectionPoint()
    +    method: public +Point3d getClosestIntersectionPoint()

    -

    /** +

    /** Retrieves the distance between the start point of the pickShape and the intersection point. */
    -    public -double getDistance()
    +    method: public +double getDistance()

    -

    /** +

    /** Retrieves the reference to the array of intersection results in this PickInfo object. */
    -    public -IntersectionInfo[] getIntersectionInfos()
    +method: public +IntersectionInfo[] getIntersectionInfos()

    -

    public class -PickInfo.IntersectionInfo extends Object  ( inner -class )
    +

    public class +PickInfo.IntersectionInfo +extends Object  ( inner +class )

    -
    /** +
    /** Retrieves the index to the intersected geometry in the picked node, either a Shape3D or Morph. */
    -public -int getGeometryIndex() 
    +method: public +int getGeometryIndex() 

    /** Retrieves the reference to the intersected geometry in the picked object, either a Shape3D or Morph. */
    -public -Geometry getGeometry()
    +method: public +Geometry getGeometry()

    /** Retrieves the interpolation weights for each of the verticies of the  intersected primitive. */
    -public -float[] getWeights()
    +method: public +float[] getWeights()

    /** Retrieves the reference to the intersection point of the picked geometry in this IntersectionInfo object. */
    -public -Point3d getIntersectionPoint()
    +method: public +Point3d getIntersectionPoint()

    /** Retrieves the vertex indices of the intersected primitive in the geometry. */
    -public int[] getVertexIndices()
    +method: public int[] getVertexIndices()
    -

    +

    -

    -

    +

    +


    Page last updated — $Date$ -- cgit v1.2.3