1SoPickedPoint(3IV)()                                      SoPickedPoint(3IV)()
2
3
4

NAME

6       SoPickedPoint — represents point on surface of picked object
7

INHERITS FROM

9       SoPickedPoint
10

SYNOPSIS

12       #include <Inventor/SoPickedPoint.h>
13
14          Methods from class SoPickedPoint:
15
16                         SoPickedPoint(const SoPickedPoint &pp)
17                         ~SoPickedPoint()
18     const SbVec3f &     getPoint() const
19     const SbVec3f &     getNormal() const
20     const SbVec4f &     getTextureCoords() const
21     int                 getMaterialIndex() const
22     SoPath *            getPath() const
23     SbBool              isOnGeometry() const
24     const SoDetail *    getDetail(const SoNode *node = NULL) const
25     const SbMatrix      getObjectToWorld(const SoNode *node = NULL) const
26     const SbMatrix      getWorldToObject(const SoNode *node = NULL) const
27     const SbMatrix      getObjectToImage(const SoNode *node = NULL) const
28     const SbMatrix      getImageToObject(const SoNode *node = NULL) const
29     const SbVec3f       getObjectPoint(const SoNode *node = NULL) const
30     const SbVec3f       getObjectNormal(const SoNode *node = NULL) const
31     const SbVec4f       getObjectTextureCoords(const SoNode *node=NULL) const
32
33

DESCRIPTION

35       An  SoPickedPoint  represents  a point on the surface of an object that
36       was picked by applying an SoRayPickAction to a  scene.  It  contains  a
37       path to the picked shape, the point of intersection, the surface normal
38       and texture coordinates at that point, and other information.
39
40       Each node in the picked path may have a  corresponding  instance  of  a
41       detail  subclass.  These  detail  instances are stored in the SoPicked‐
42       Point.
43

METHODS

45                         SoPickedPoint(const SoPickedPoint &pp)
46          Copy constructor.
47
48                         ~SoPickedPoint()
49          Destructor.
50
51     const SbVec3f &     getPoint() const
52     const SbVec3f &     getNormal() const
53     const SbVec4f &     getTextureCoords() const
54          These return the intersection point  and  surface  normal  in  world
55          space, and the texture coordinates in image space.
56
57     int                 getMaterialIndex() const
58          Returns  the index into the current set of materials of the material
59          active at the intersection point. Note that  if  the  materials  are
60          interpolated  between  vertices,  the  index  will correspond to the
61          material at one of the vertices.
62
63     SoPath *            getPath() const
64          Returns the path to the object that was intersected.
65
66     SbBool              isOnGeometry() const
67          Returns whether the intersection is actually on the geometry of  the
68          character that was hit, as opposed to being on the bounding box. The
69          pick style (see SoPickStyle) affects this decision.
70
71     const SoDetail *    getDetail(const SoNode *node = NULL) const
72          Returns the detail that corresponds to the given node  in  the  path
73          returned  by  getPath().  If the node pointer is NULL (the default),
74          the detail corresponding to the tail of the (full) path is returned.
75
76     const SbMatrix      getObjectToWorld(const SoNode *node = NULL) const
77     const SbMatrix      getWorldToObject(const SoNode *node = NULL) const
78          These return the transformation matrices between world space and the
79          object  space  corresponding  to  the given node in the path. If the
80          node pointer is NULL (the default), the matrix corresponding to  the
81          tail of the (full) path is returned.
82
83     const SbMatrix      getObjectToImage(const SoNode *node = NULL) const
84     const SbMatrix      getImageToObject(const SoNode *node = NULL) const
85          These return the texture transformation matrices between image space
86          and the object space corresponding to the given node in the path. If
87          the  node pointer is NULL (the default), the matrix corresponding to
88          the tail of the (full) path is returned.
89
90     const SbVec3f       getObjectPoint(const SoNode *node = NULL) const
91     const SbVec3f       getObjectNormal(const SoNode *node = NULL) const
92     const SbVec4f       getObjectTextureCoords(const SoNode *node=NULL) const
93          These return the intersection point,  surface  normal,  and  texture
94          coordinates  in  the object space corresponding to the given node in
95          the path. If the node pointer is NULL (the default), the information
96          corresponding to the tail of the (full) path is returned.
97
98

SEE ALSO

100       SoRayPickAction, SoPickStyle, SoDetail, SoPath
101
102
103
104
105                                                          SoPickedPoint(3IV)()
Impressum