HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
GEO_Primitive.h
Go to the documentation of this file.
1 /*
2  * PROPRIETARY INFORMATION. This software is proprietary to
3  * Side Effects Software Inc., and is not to be reproduced,
4  * transmitted, or disclosed in any way without written permission.
5  *
6  * NAME: Geometry Library (C++)
7  *
8  * COMMENTS:
9  * The className method is used for saving/loading so there should
10  * be no spaces in the name.
11  *
12  */
13 
14 #pragma once
15 
16 #ifndef __GEO_Primitive_H__
17 #define __GEO_Primitive_H__
18 
19 #include "GEO_API.h"
20 #include <iosfwd>
21 #include <UT/UT_Matrix4.h>
22 #include <UT/UT_BoundingBox.h>
23 #include <UT/UT_BoundingSphere.h>
24 #include <GA/GA_Primitive.h>
25 #include "GEO_PrimType.h"
26 
27 class GA_AttributeRefMap;
28 class GA_Detail;
31 class GEO_ConvertParms;
32 class GEO_Detail;
33 class GEO_MetaPrim;
34 class GEO_Vertex;
35 
36 template<typename T, bool B> class GA_EdgeT;
38 
40 
42 {
43 protected:
44  /// NOTE: The constructor should only be called from subclass
45  /// constructors.
48  : GA_Primitive(*d, offset)
49  {}
50 
51  /// NOTE: The destructor should only be called from subclass
52  /// destructors; only GEO_Detail::destroyStashed() should be
53  /// calling delete on GEO_Primitive pointers, and GEO_Detail
54  /// is a friend.
55  virtual ~GEO_Primitive() {}
56 
57 public:
58  virtual GA_PrimCompat::TypeMask getPrimitiveId() const;
59 
60  /// Copy attribute data from the source primitive. Also, copy over all the
61  /// group membership information from the source primitive.
63  bool copy_groups=true)
64  {
65  copyAttributeData(src);
66  if (copy_groups)
67  copyGroupMembership(src);
68  }
70  GA_AttributeRefMap &gah,
71  bool copy_groups=true)
72  {
73  copyAttributeData(src, gah);
74  if (copy_groups)
75  copyGroupMembership(src);
76  }
77  /// NOTE: The copying of groups only works if src is in the same detail
79  GA_PrimitiveWrangler &wrangler,
80  bool copy_groups=true)
81  {
82  copyAttributeData(src, wrangler);
83  if (copy_groups)
84  copyGroupMembership(src);
85  }
86 
87  /// Copy the attribute data over from the source primitive. Often you will
88  /// want to call copyAttributesAndGroups() instead.
89  void copyAttributeData(const GEO_Primitive &src);
90  void copyAttributeData(const GEO_Primitive &src,
91  GA_AttributeRefMap &gah);
92  void copyAttributeData(const GEO_Primitive &src,
93  GA_PrimitiveWrangler &wrangler);
94 
95  void copyAttributeValues(const GEO_Primitive &src,
96  GA_PrimitiveWrangler &wrangler);
97 
98  /// Copy the group membership from the source primitive to the current
99  /// primitive. Both primitives must be in the same detail.
100  void copyGroupMembership(const GEO_Primitive &src);
101 
102  // NOTE: The point *indices* will be the same as in src.
103  // If this and src are in the same detail, this means that
104  // the point offsets will also be the same. There must be
105  // sufficient points in this' detail.
106  // NOTE: To remap the points, you can iterate through the vertices
107  // of the primitive after copying, and call getPointOffset
108  // and setPointOffset.
109  //
110  // copyPrimitive(), unlike copy(), will not copy the primitive attributes.
111  // (see copyAttributeData() or copyAttributesAndGroups()).
112 #if GA_PRIMITIVE_VERTEXLIST
113  virtual void copyPrimitive(const GEO_Primitive *src);
114 #else
115  virtual void copyPrimitive(const GEO_Primitive *src)=0;
116 #endif
117  virtual GEO_Primitive *copy(int preserve_shared_pts = 0) const;
118 
119  // Transforms the matrix associated with this primitive. The
120  // translate component is ignored: Translate the vertices of
121  // the primitive to translate the primitive.
122  // This only works with quadrics (sphere, tube, metaballs) and volumes.
123  virtual void transform(const UT_Matrix4 &);
124 
125  // Convert the real domain values of the primitive to unit values to be
126  // used in the evaluation methods below:
127  virtual void realToUnitPair(float ureal, float vreal,
128  float &uunit, float &vunit) const;
129 
130  // Convert the unit values of the primitive to the real domain values
131  virtual void unitToRealPair(float uunit, float vunit,
132  float &ureal, float &vreal) const;
133 
134  // Map the normalized length (distance value [0,1]) parameter to the unit
135  // parameterization of the primitve
136  virtual void unitLengthToUnitPair(float ulength, float vlength,
137  float &uparm, float &vparm)const;
138  virtual void unitLengthToUnitPair(float ulength, float vlength,
139  float &uparm, float &vparm, float tolerance)const;
140 
141  virtual void unitToUnitLengthPair(float uparm, float vparm,
142  float &ulength, float &vlength)
143  const;
144 
145  // Evaluate a set of attributes at the bary center of the primitive,
146  // returning true on success, false on failure.
147  bool evaluateBaryCenter(GA_Offset result_vtx,
148  GA_AttributeRefMap &map) const
149  { return evaluateBaryCenterRefMap(result_vtx, map); }
150 
151  // Evaluate a set of attributes at a u,v position. Optionally, evaluate
152  // the derivative in the u or v direction.
153  // The method returns true if the point could be evaluated
154  bool evaluatePoint(GA_Offset result_vtx,
155  GA_AttributeRefMap &map,
156  fpreal u, fpreal v=0,
157  uint du=0, uint dv=0) const
158  { return evaluatePointRefMap(result_vtx, map, u, v, du, dv); }
159 
160  // Evaluate the position, the derivative or the normal at domain point
161  // (u,v), where u and v MUST be in [0,1]. "v" and "dv" will be ignored
162  // when dealing with one-dimensional types such as circles and polygons.
163  // Return 0 if OK and -1 otherwise. The normal is not normalized.
164  int evaluatePoint( UT_Vector4 &pos, float u, float v = 0,
165  unsigned du=0, unsigned dv=0) const
166  { return evaluatePointV4(pos, u, v, du, dv); }
167 
168  virtual int evaluateNormalVector(UT_Vector3 &nml, float u,
169  float v = 0, float w = 0) const;
170 
171  // Evaluate the position at domain point (u,v) in the interior of the
172  // geometry. This calls evaluatePoint by default, but has a different
173  // implementation for triangles and quadrilaterals, where barycentric
174  // coords or bilinear interpolants are used to get an interior point,
175  // rather than a point on the perimeter of the poly. This was added
176  // so particles can stick to triangles and quads.
178  GA_AttributeRefMap &map,
179  fpreal u, fpreal v, fpreal w = 0) const
180  { return evaluateInteriorPointRefMap(
181  result_vtx, map, u, v, w); }
183  fpreal u, fpreal v, fpreal w = 0) const
184  { return evaluateInteriorPointV4(pos, u, v, w); }
185 
186 
187  /// Finds the weightings of the vertices that will compute an interior
188  /// point given the u,v,w coordinates. The offsets are into the gdp's
189  /// vertex list, not indices into this primitive's vertex list.
190  /// Weights are normalized.
191  /// Note this cannot be used to recover the Position as it often has
192  /// special case logic (as in spheres, or rational splines), in those
193  /// cases use evaluateInteriorPoint(UT_Vector4 &pos, ...)
194  /// It has the advantage over the other evaluateInteriorPoints in that
195  /// it allows you to avoid creating any temporary vertices.
196  /// Behaviour for non-sublcassed types is to return the 0th vertex.
197  virtual void computeInteriorPointWeights(
198  UT_Array<GA_Offset> &vtxlist,
199  UT_Array<float> &weightlist,
200  fpreal u, fpreal v, fpreal w) const;
201 
203  {
204  // We cannot do a static_cast because we have only forward
205  // declared GEO_Detail and GA_Detail
206  return reinterpret_cast<GEO_Detail *>(&getDetail());
207  }
208  static GA_PrimCompat::TypeMask getPrimitiveMaskH9(const char *maskstr);
209 
210  /// Compute the bounding box of the primitive. Return 0 if unable to
211  /// compute bounds (1 on successful computation)
212  virtual int getBBox(UT_BoundingBox *bbox) const = 0;
213 
214  /// @{
215  /// If the attribute is "P" the base-class will call getBBox()
216  virtual bool enlargeBoundingBox(UT_BoundingRect &b,
217  const GA_Attribute *P) const;
218  virtual bool enlargeBoundingBox(UT_BoundingBox &b,
219  const GA_Attribute *P) const;
220  /// @}
221 
222  /// Return a normal vector for the primitive
223  virtual UT_Vector3 computeNormal() const = 0;
224 
225  /// Reverse the order of vertices
226  virtual void reverse() = 0;
227 
228  /// Return the center of the primitive. This defaults to the center of the
229  /// bounding box. A better approximation might be the average value of the
230  /// vertex positions (which could be different).
231  virtual UT_Vector3 baryCenter() const;
232 
233  /// Enlarge the bounding sphere with the primitive's bounds.
234  /// By default, this will enlarge the bounding sphere by the primitive's
235  /// bounding box (i.e. getBBox()). It may be possible to have a tighter
236  /// bound (i.e. the vertex hull for many primitives is a much better
237  /// metric).
238  virtual void addToBSphere(UT_BoundingSphere *bsphere) const;
239 
240  /// Method to isolate a pasted surface
241  virtual void isolate() { /* No implementation here. */ }
242 
243  // Take the whole set of points into consideration when applying the
244  // point removal operation to this primitive. The method returns 0 if
245  // successful, -1 if it failed because it would have become degenerate,
246  // and -2 if it failed because it would have had to remove the primitive
247  // altogether.
248  virtual int detachPoints (GA_PointGroup &grp) = 0;
249 
250  virtual bool hasEdge(const GA_Edge &edge) const;
251 
252  /// These functions are only implemented to get guide points/edges
253  /// for spheres, tubes, and circles. The ID meaning is type-specific.
254  /// @{
255  virtual bool hasGuideEdge(int edgeid, UT_Vector3 &a,
256  UT_Vector3 &b) const;
257  virtual bool hasXsectPoint(int pointid, UT_Vector3 &p) const;
258  /// @}
259 
260  /// Apply the function to each vertex of the primitive. Break
261  /// when the function returns true. Return the value
262  /// of the last function applied (false if never called).
263 #if !GA_PRIMITIVE_VERTEXLIST
264  virtual bool vertexApply(bool (*apply)(GA_Offset vtx, void *),
265  void *data = 0) const;
266 #endif
267 
268  SYS_DEPRECATED_HDK(13.0)
269  GEO_Vertex getVertexElement(GA_Size i) const;
270 
271 //
272 // Method to get the tessera data for meta-primitives
273  virtual GEO_MetaPrim *castToMetaPrim(void);
274  virtual const GEO_MetaPrim *castToMetaPrim(void) const;
275 
276  // Return the surrounding values of the real-space u,v parameters.
277  // Returns 1 if succesful, 0 if out-of-range.
278 
279  virtual int parametricBBox(float u, float v,
280  float *u0, float *u1,
281  float *v0, float *v1);
282 
283  // Returns distance between two points in parameter space, aware
284  // of any possible wrapping.
285  virtual float uvDist(float u1, float v1, float u2, float v2) const;
286 
287  // Intersects a ray with the bounding box, iteratively growing it until
288  // an intersection is found or maxtries is reached.
289  int bboxIntersectRay(const UT_Vector3 &rayorig,
290  const UT_Vector3 &raydir,
291  int maxtries = 10,
292  float tmax = 1E17F,
293  float *distance = 0,
294  UT_Vector3 *nml=0) const;
295 
296  /// @{
297  /// If the method isn't known, or doesn't make sense, we return 0.
298  virtual fpreal calcVolume(const UT_Vector3 &) const { return 0; }
299  virtual fpreal calcArea() const { return 0; }
300  virtual fpreal calcPerimeter() const { return 0; }
301  /// @}
302 
303  // Is this primitive a GEO_Quadric?
304  virtual bool isQuadric() const { return false; }
305 
306  // Compute normals on points using a subclass of NormalComp. This
307  // class receives the point offset and vertex normal at that point, and
308  // will either add or subtract the normal from the existing data.
310  public:
311  virtual ~NormalComp() {}
312  virtual void add(GA_Offset offset, const UT_Vector3 &nml) {}
313  virtual void sub(GA_Offset offset, const UT_Vector3 &nml) {}
314  };
315 
316  // Compute point normals into an array, indexed by the point order
317  // number
319  public:
321  : myGdp(gdp)
322  , myOutput(output) {}
323  virtual void add(GA_Offset offset, const UT_Vector3 &nml)
324  { myOutput(myGdp.pointIndex(offset)) += nml; }
325  virtual void sub(GA_Offset offset, const UT_Vector3 &nml)
326  { myOutput(myGdp.pointIndex(offset)) -= nml; }
327 
328  private:
329  const GA_Detail &myGdp;
330  UT_Vector3Array &myOutput;
331  };
332 
333  // Compute normals into a normal attribute
335  public:
337  : myHandle(attr.getAttribute()) {}
339  : myHandle(attr) {}
340  virtual void add(GA_Offset offset, const UT_Vector3 &nml)
341  { myHandle.add(offset, nml); }
342  virtual void sub(GA_Offset offset, const UT_Vector3 &nml)
343  { myHandle.add(offset, -nml); }
344 
345  GA_RWHandleV3 &getHandle() { return myHandle; }
346 
347  protected:
349  };
350 
351  // Compute normals into a normal attribute
353  {
354  public:
356  : myParent(parent)
357  , myLock(lock)
358  , myBufferEntries(0)
359  {}
361  {
362  flush();
363  }
364  virtual void add(GA_Offset offset, const UT_Vector3 &nml)
365  {
366  myOffsetBuffer[myBufferEntries] = offset;
367  myDataBuffer[myBufferEntries] = nml;
368  ++myBufferEntries;
369  if (myBufferEntries == theBufferSize)
370  flush();
371  }
372 
373  virtual void sub(GA_Offset offset, const UT_Vector3 &nml)
374  {
375  myOffsetBuffer[myBufferEntries] = offset;
376  myDataBuffer[myBufferEntries] = -nml;
377  ++myBufferEntries;
378  if (myBufferEntries == theBufferSize)
379  flush();
380  }
381 
382  void flush()
383  {
384  UT_AutoLock lock(myLock);
385  for (GA_Size i = 0; i < myBufferEntries; ++i)
386  {
387  myParent.add(myOffsetBuffer[i], myDataBuffer[i]);
388  }
389  myBufferEntries = 0;
390  }
391 
392  private:
393  static const GA_Size theBufferSize = 1024;
394 
395  NormalComp &myParent;
396  UT_Lock &myLock;
397  GA_Size myBufferEntries;
398  GA_Offset myOffsetBuffer[theBufferSize];
399  UT_Vector3 myDataBuffer[theBufferSize];
400  };
401 
402  virtual void normal(NormalComp &output) const = 0;
403 
404  // Conversion Methods
405 
406  // This method converts the primitive to the specified toType and deletes
407  // the old primitive.
408 
409  virtual GEO_Primitive *convert(GEO_ConvertParms &parms,
410  GA_PointGroup *usedpts = 0) = 0;
411 
412  // This method creates a new primitive by converting the old primitive to
413  // the specified toType.
414 
415  virtual GEO_Primitive *convertNew(GEO_ConvertParms &parms) = 0;
416 
417  // The default implementation just checks the bounding box and
418  // deletes the primitive if the bounding box is beyond the plane.
419  // NOTE: normal should be normalized
420  virtual void clip(UT_Vector3 normal, float distance = 0,
421  GA_PrimitiveGroup *clipgrp = NULL);
422 
423  // The default implementation just intersects against the bounding box
424  virtual int intersectRay(const UT_Vector3 &o, const UT_Vector3 &d,
425  float tmax = 1E17F, float tol = 1E-12F,
426  float *distance = 0, UT_Vector3 *pos = 0,
427  UT_Vector3 *nml = 0, int accurate = 0,
428  float *u = 0, float *v = 0,
429  int ignoretrim = 1) const;
430 
431 
432  /// Convience objects to pass as arguments to saveH9()/loadH9().
434 
435 protected:
436  /// All subclasses should call this method to register the primitive
437  /// intrinsics.
438  /// @see GA_IntrinsicManager
441  { return GA_Primitive::registerIntrinsics(defn); }
442 
443  virtual bool evaluatePointRefMap(GA_Offset result_vtx,
444  GA_AttributeRefMap &map,
445  fpreal u, fpreal v=0,
446  uint du=0, uint dv=0) const = 0;
447 
448  /// Evaluate the position for the given parametric coordinates (with the
449  /// given derivatives). Return 0 if successful, or -1 if failure.
450  /// The default implementation returns {0,0,0,0};
451  virtual int evaluatePointV4( UT_Vector4 &pos, float u, float v = 0,
452  unsigned du=0, unsigned dv=0) const;
453 
454  /// By default, this will call evaluateInteriorPointRefMap with u=.5 and
455  /// v=.5. This is likely not the perfect solution. At the current time,
456  /// this is only used in POPs to birth points at primitive centers.
457  virtual bool evaluateBaryCenterRefMap(GA_Offset result_vtx,
458  GA_AttributeRefMap &map) const;
459 
460  virtual bool evaluateInteriorPointRefMap(GA_Offset result_vtx,
461  GA_AttributeRefMap &map,
462  fpreal u, fpreal v, fpreal w = 0) const;
463  virtual int evaluateInteriorPointV4(UT_Vector4 &pos,
464  fpreal u, fpreal v, fpreal w = 0) const;
465 
466 private:
467  friend class GEO_Detail; // Allow detail to get at private stuff
468 
469  // TODO: Eliminate, deprecate, or switch to saving json format.
470  friend std::ostream &operator<<(std::ostream &os, const GEO_Primitive &d)
471  {
472  d.saveH9(os, 0,
475  return os;
476  }
477 };
478 
480 
481 #endif
Definition of a geometry attribute.
Definition: GA_Attribute.h:190
NormalCompArray(const GA_Detail &gdp, UT_Vector3Array &output)
#define SYS_DEPRECATED_PUSH_DISABLE()
const GLdouble * v
Definition: glcorearb.h:836
void copyAttributesAndGroups(const GEO_Primitive &src, GA_AttributeRefMap &gah, bool copy_groups=true)
Definition: GEO_Primitive.h:69
#define SYS_DEPRECATED_POP_DISABLE()
bool evaluateInteriorPoint(GA_Offset result_vtx, GA_AttributeRefMap &map, fpreal u, fpreal v, fpreal w=0) const
void copyAttributesAndGroups(const GEO_Primitive &src, bool copy_groups=true)
Definition: GEO_Primitive.h:62
NormalCompBuffered(NormalComp &parent, UT_Lock &lock)
virtual void add(GA_Offset offset, const UT_Vector3 &nml)
GLboolean GLboolean GLboolean GLboolean a
Definition: glcorearb.h:1221
SYS_FORCE_INLINE GEO_Detail * getParent() const
GLfloat GLfloat GLfloat v2
Definition: glcorearb.h:817
3D Vector class.
png_uint_32 i
Definition: png.h:2877
exint GA_Size
Defines the bit width for index and offset types in GA.
Definition: GA_Types.h:211
#define GA_INVALID_OFFSET
Definition: GA_Types.h:654
virtual void sub(GA_Offset offset, const UT_Vector3 &nml)
virtual void add(GA_Offset offset, const UT_Vector3 &nml)
GA_Size GA_Offset
Definition: GA_Types.h:617
NormalCompAttr(const GA_RWHandleV3 &attr)
virtual void add(GA_Offset offset, const UT_Vector3 &nml)
This class provides a way to manage a reference to an attribute permitting Read-Write access...
virtual void sub(GA_Offset offset, const UT_Vector3 &nml)
T distance(const UT_Vector4T< T > &v1, const UT_Vector4T< T > &v2)
Definition: UT_Vector4.h:698
virtual fpreal calcArea() const
#define SYS_FORCE_INLINE
Definition: SYS_Inline.h:45
GLintptr offset
Definition: glcorearb.h:664
int evaluateInteriorPoint(UT_Vector4 &pos, fpreal u, fpreal v, fpreal w=0) const
#define GEO_API
Definition: GEO_API.h:10
bool evaluatePoint(GA_Offset result_vtx, GA_AttributeRefMap &map, fpreal u, fpreal v=0, uint du=0, uint dv=0) const
A handle to simplify manipulation of multiple attributes.
NormalCompAttr(const GA_RWAttributeRef &attr)
GLboolean * data
Definition: glcorearb.h:130
#define SYS_DEPRECATED_HDK(__V__)
GLboolean GLboolean GLboolean b
Definition: glcorearb.h:1221
GA_API const UT_StringHolder transform
virtual fpreal calcPerimeter() const
unsigned int uint
Definition: SYS_Types.h:40
virtual void sub(GA_Offset offset, const UT_Vector3 &nml)
virtual bool saveH9(std::ostream &os, bool binary, const UT_Array< GA_AttribSaveDataH9 > &prim_attribs, const UT_Array< GA_AttribSaveDataH9 > &vtx_attribs) const
GLfloat v0
Definition: glcorearb.h:815
double fpreal
Definition: SYS_Types.h:270
IMATH_INTERNAL_NAMESPACE_HEADER_ENTER T clip(const T &p, const Box< T > &box)
Definition: ImathBoxAlgo.h:89
SYS_FORCE_INLINE GEO_Primitive(GA_Detail *d, GA_Offset offset=GA_INVALID_OFFSET)
Definition: GEO_Primitive.h:47
int evaluatePoint(UT_Vector4 &pos, float u, float v=0, unsigned du=0, unsigned dv=0) const
virtual ~GEO_Primitive()
Definition: GEO_Primitive.h:55
static const UT_Array< GA_AttribSaveDataH9 > & theEmptySaveAttribs
Convience objects to pass as arguments to saveH9()/loadH9().
virtual void add(GA_Offset offset, const UT_Vector3 &nml)
bool evaluateBaryCenter(GA_Offset result_vtx, GA_AttributeRefMap &map) const
GLfloat GLfloat v1
Definition: glcorearb.h:816
Container class for all geometry.
Definition: GA_Detail.h:95
friend std::ostream & operator<<(std::ostream &os, const GEO_Primitive &d)
GLubyte GLubyte GLubyte GLubyte w
Definition: glcorearb.h:856
Definition of a geometric primitive.
#define const
Definition: zconf.h:214
virtual void sub(GA_Offset offset, const UT_Vector3 &nml)
virtual bool isQuadric() const
void copyAttributesAndGroups(const GEO_Primitive &src, GA_PrimitiveWrangler &wrangler, bool copy_groups=true)
NOTE: The copying of groups only works if src is in the same detail.
Definition: GEO_Primitive.h:78
static GA_IntrinsicManager::Registrar registerIntrinsics(GA_PrimitiveDefinition &defn)
virtual void isolate()
Method to isolate a pasted surface.
GLenum src
Definition: glcorearb.h:1792