1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
|
/**************************************************************************\
*
* This file is part of the Coin 3D visualization library.
* Copyright (C) by Kongsberg Oil & Gas Technologies.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* ("GPL") version 2 as published by the Free Software Foundation.
* See the file LICENSE.GPL at the root directory of this source
* distribution for additional information about the GNU GPL.
*
* For using Coin with software that can not be combined with the GNU
* GPL, and for taking advantage of the additional benefits of our
* support services, please contact Kongsberg Oil & Gas Technologies
* about acquiring a Coin Professional Edition License.
*
* See http://www.coin3d.org/ for more information.
*
* Kongsberg Oil & Gas Technologies, Bygdoy Alle 5, 0257 Oslo, NORWAY.
* http://www.sim.no/ sales@sim.no coin-support@coin3d.org
*
\**************************************************************************/
/*!
\class SoPickStyle SoPickStyle.h Inventor/nodes/SoPickStyle.h
\brief The SoPickStyle class is a node for setting up how to do picking.
\ingroup nodes
By default, all geometry in a scene is available for picking. Upon
writing applications with interaction possibilities, this is often
\e not what you want. To exclude parts of the scene graph from pick
actions, use the SoPickStyle::UNPICKABLE.
You can also optimize pick operations by using the
SoPickStyle::BOUNDING_BOX pickstyle.
<b>FILE FORMAT/DEFAULTS:</b>
\code
PickStyle {
style SHAPE
}
\endcode
\sa SoRayPickAction
*/
// *************************************************************************
#include <Inventor/actions/SoPickAction.h>
#include <Inventor/elements/SoOverrideElement.h>
#include <Inventor/actions/SoCallbackAction.h>
#include "nodes/SoSubNodeP.h"
// *************************************************************************
/*!
\enum SoPickStyle::Style
Enumeration of the available picking strategies.
*/
/*!
\var SoPickStyle::Style SoPickStyle::SHAPE
Do "exact" picks, finding the correct intersection point(s), etc.
*/
/*!
\var SoPickStyle::Style SoPickStyle::BOUNDING_BOX
Only compare pick intersection with the bounding boxes of
shapes. This is usually much faster than SoPickStyle::SHAPE.
*/
/*!
\var SoPickStyle::Style SoPickStyle::UNPICKABLE
The geometry following this node in the scene will not be available
for picking.
*/
/*!
\var SoPickStyle::Style SoPickStyle::SHAPE_ON_TOP
Do exact picks, like SHAPE, but sort the shape to the front of the
list of picked points so it appears to be the frontmost item. This
does not affect the SoPickedPoint pick coordinate though, just the
sorting by depth done on the picked point list.
\since Coin 3.0
*/
/*!
\var SoPickStyle::Style SoPickStyle::BOUNDING_BOX_ON_TOP
Do picks against the enclosing bounding box of the object, like
BOUNDING_BOX, but sort the shape to the front of the list of picked
points so it appears to be the frontmost item. This does not affect
the SoPickedPoint pick coordinate though, just the sorting by depth
done on the picked point list.
\since Coin 3.0
*/
/*!
\var SoPickStyle::Style SoPickStyle::SHAPE_FRONTFACES
Do exact picks, like SHAPE, but cull all the backface intersections
from the list. Note that this logic is relative to the ray, not the
view, in case the ray and the view direction are not aligned.
The behaviour of this setting will also depend on the SoShapeStyle
vertexOrdering and shapeType setting, which are used to flip
frontfaces to become backfaces and vice versa and to turn backface
culling on and off.
\since Coin 3.0
*/
/*!
\var SoSFEnum SoPickStyle::style
Which strategy to use for the picking actions for subsequent shapes
in the scene graph. Default value is SoPickStyle::SHAPE.
*/
// *************************************************************************
SO_NODE_SOURCE(SoPickStyle);
/*!
Constructor.
*/
SoPickStyle::SoPickStyle(void)
{
SO_NODE_INTERNAL_CONSTRUCTOR(SoPickStyle);
SO_NODE_ADD_FIELD(style, (SoPickStyle::SHAPE));
SO_NODE_DEFINE_ENUM_VALUE(Style, SHAPE);
SO_NODE_DEFINE_ENUM_VALUE(Style, BOUNDING_BOX);
SO_NODE_DEFINE_ENUM_VALUE(Style, UNPICKABLE);
SO_NODE_DEFINE_ENUM_VALUE(Style, SHAPE_ON_TOP);
SO_NODE_DEFINE_ENUM_VALUE(Style, BOUNDING_BOX_ON_TOP);
SO_NODE_DEFINE_ENUM_VALUE(Style, SHAPE_FRONTFACES);
SO_NODE_SET_SF_ENUM_TYPE(style, Style);
}
/*!
Destructor.
*/
SoPickStyle::~SoPickStyle()
{
}
// doc in super
void
SoPickStyle::initClass(void)
{
SO_NODE_INTERNAL_INIT_CLASS(SoPickStyle, SO_FROM_INVENTOR_2_0);
SO_ENABLE(SoCallbackAction, SoPickStyleElement);
SO_ENABLE(SoPickAction, SoPickStyleElement);
}
void
SoPickStyle::doAction(SoAction * action)
{
if (!this->style.isIgnored()
&& !SoOverrideElement::getPickStyleOverride(action->getState())) {
SoPickStyleElement::set(action->getState(), this,
(int32_t) this->style.getValue());
if (this->isOverride()) {
SoOverrideElement::setPickStyleOverride(action->getState(), this, TRUE);
}
}
}
void
SoPickStyle::callback(SoCallbackAction * action)
{
SoPickStyle::doAction(action);
}
void
SoPickStyle::pick(SoPickAction * action)
{
SoPickStyle::doAction(action);
}
|