SoShape.h
#ifndef COIN_SOSHAPE_H
#define COIN_SOSHAPE_H
/**************************************************************************\
* Copyright (c) Kongsberg Oil & Gas Technologies AS
* All rights reserved.
*
* Redistribution and use in source and binary forms, with or without
* modification, are permitted provided that the following conditions are
* met:
*
* Redistributions of source code must retain the above copyright notice,
* this list of conditions and the following disclaimer.
*
* Redistributions in binary form must reproduce the above copyright
* notice, this list of conditions and the following disclaimer in the
* documentation and/or other materials provided with the distribution.
*
* Neither the name of the copyright holder nor the names of its
* contributors may be used to endorse or promote products derived from
* this software without specific prior written permission.
*
* THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
* "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
* LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
* A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
* HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
* SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
* LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
* DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
* THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
* (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
\**************************************************************************/
#include <Inventor/nodes/SoSubNode.h>
#include <Inventor/elements/SoMultiTextureCoordinateElement.h>
#include <Inventor/SbMatrix.h>
#include <Inventor/SbVec2s.h>
#include <Inventor/SbBox3f.h>
class SoPrimitiveVertex;
class SoDetail;
class SoPickedPoint;
class SoFaceDetail;
class SoState;
class SoCoordinateElement;
class SbVec2f;
class SoMaterialBundle;
class SoBoundingBoxCache;
class COIN_DLL_API SoShape : public SoNode {
typedef SoNode inherited;
SO_NODE_ABSTRACT_HEADER(SoShape);
public:
static void initClass(void);
enum TriangleShape {
TRIANGLE_STRIP, TRIANGLE_FAN, TRIANGLES, POLYGON,
// The rest of the enums are not part of the original Inventor API.
QUADS, QUAD_STRIP, POINTS, LINES, LINE_STRIP
};
virtual SbBool affectsState(void) const;
virtual void notify(SoNotList * nl);
virtual void getBoundingBox(SoGetBoundingBoxAction * action);
virtual void GLRender(SoGLRenderAction * action);
virtual void rayPick(SoRayPickAction * action);
virtual void callback(SoCallbackAction * action);
virtual void computeBBox(SoAction * action, SbBox3f & box,
SbVec3f & center) = 0;
virtual void getPrimitiveCount(SoGetPrimitiveCountAction * action);
static void getScreenSize(SoState * const state, const SbBox3f & boundingbox,
SbVec2s & rectsize);
static float getDecimatedComplexity(SoState * state, float complexity);
const SoBoundingBoxCache * getBoundingBoxCache(void) const;
protected:
SoShape(void);
virtual ~SoShape();
float getComplexityValue(SoAction * action);
virtual void generatePrimitives(SoAction * action) = 0;
virtual SbBool shouldGLRender(SoGLRenderAction * action);
void beginSolidShape(SoGLRenderAction * action);
void endSolidShape(SoGLRenderAction * action);
void GLRenderBoundingBox(SoGLRenderAction * action);
SbBool shouldPrimitiveCount(SoGetPrimitiveCountAction * action);
SbBool shouldRayPick(SoRayPickAction * const action);
void computeObjectSpaceRay(SoRayPickAction * const action);
void computeObjectSpaceRay(SoRayPickAction * const action,
const SbMatrix & matrix);
virtual SoDetail * createTriangleDetail(SoRayPickAction * action,
const SoPrimitiveVertex * v1,
const SoPrimitiveVertex * v2,
const SoPrimitiveVertex * v3,
SoPickedPoint * pp);
virtual SoDetail * createLineSegmentDetail(SoRayPickAction * action,
const SoPrimitiveVertex * v1,
const SoPrimitiveVertex * v2,
SoPickedPoint * pp);
virtual SoDetail * createPointDetail(SoRayPickAction * action,
const SoPrimitiveVertex * v,
SoPickedPoint * pp);
void invokeTriangleCallbacks(SoAction * const action,
const SoPrimitiveVertex * const v1,
const SoPrimitiveVertex * const v2,
const SoPrimitiveVertex * const v3);
void invokeLineSegmentCallbacks(SoAction * const action,
const SoPrimitiveVertex * const v1,
const SoPrimitiveVertex * const v2);
void invokePointCallbacks(SoAction * const action,
const SoPrimitiveVertex * const v);
void beginShape(SoAction * const action, const TriangleShape shapetype,
SoDetail * const detail = NULL);
void shapeVertex(const SoPrimitiveVertex * const v);
void endShape(void);
void generateVertex(SoPrimitiveVertex * const pv,
const SbVec3f & point,
const SbBool useTexFunc,
const SoMultiTextureCoordinateElement * const tce,
const float s,
const float t,
const SbVec3f & normal);
void generateVertex(SoPrimitiveVertex * const pv,
const SbVec3f & point,
const SbBool useTexFunc,
const SoMultiTextureCoordinateElement * const tce,
const float s,
const float t,
const float r,
const SbVec3f & normal);
SbBool startVertexArray(SoGLRenderAction * action,
const SoCoordinateElement * coords,
const SbVec3f * pervertexnormals,
const SbBool texpervertex,
const SbBool colorpervertex);
void finishVertexArray(SoGLRenderAction * action,
const SbBool vbo,
const SbBool normpervertex,
const SbBool texpervertex,
const SbBool colorpervertex);
private:
class SoShapeP * pimpl;
void validatePVCache(SoGLRenderAction * action);
void getBBox(SoAction * action, SbBox3f & box, SbVec3f & center);
void rayPickBoundingBox(SoRayPickAction * action);
friend class soshape_primdata; // internal class
friend class so_generate_prim_private; // a very private class
};
#endif // !COIN_SOSHAPE_H
SbBox3f
The SbBox3f class is an abstraction for an axis aligned 3 dimensional box.
Definition SbBox3f.h:46
SbMatrix
The SbMatrix class is a 4x4 dimensional representation of a matrix.
Definition SbMatrix.h:47
SbVec2f
The SbVec2f class is a 2 dimensional vector with floating point coordinates.
Definition SbVec2f.h:49
SbVec2s
The SbVec2s class is a 2 dimensional vector with short integer coordinates.
Definition SbVec2s.h:51
SbVec3f
The SbVec3f class is a 3 dimensional vector with floating point coordinates.
Definition SbVec3f.h:51
SoAction
The SoAction class is the base class for all traversal actions.
Definition SoAction.h:77
SoBoundingBoxCache
The SoBoundingBoxCache class is used to cache bounding boxes.
Definition SoBoundingBoxCache.h:41
SoCallbackAction
The SoCallbackAction class invokes callbacks at specific nodes.
Definition SoCallbackAction.h:80
SoCoordinateElement
The SoCoordinateElement class is yet to be documented.
Definition SoCoordinateElement.h:40
SoDetail
The SoDetail class is the superclass for all classes storing detailed information about particular sh...
Definition SoDetail.h:39
SoFaceDetail
The SoFaceDetail class is for storing detailed polygon information.
Definition SoFaceDetail.h:38
SoGLRenderAction
The SoGLRenderAction class renders the scene graph with OpenGL calls.
Definition SoGLRenderAction.h:50
SoGetBoundingBoxAction
The SoGetBoundingBoxAction class calculates bounding boxes for nodes and subgraphs.
Definition SoGetBoundingBoxAction.h:45
SoGetPrimitiveCountAction
The SoGetPrimitiveCountAction class counts the primitives in a scene.
Definition SoGetPrimitiveCountAction.h:44
SoMaterialBundle
The SoMaterialBundle class simplifies material handling.
Definition SoMaterialBundle.h:42
SoMultiTextureCoordinateElement
The SoMultiTextureCoordinateElement class is yet to be documented.
Definition SoMultiTextureCoordinateElement.h:48
SoNode::SoNode
SoNode(void)
Definition SoNode.cpp:417
SoNode::notify
virtual void notify(SoNotList *l)
Definition SoNode.cpp:506
SoNode::getPrimitiveCount
virtual void getPrimitiveCount(SoGetPrimitiveCountAction *action)
Definition SoNode.cpp:943
SoNode::getBoundingBox
virtual void getBoundingBox(SoGetBoundingBoxAction *action)
Definition SoNode.cpp:914
SoNode::callback
virtual void callback(SoCallbackAction *action)
Definition SoNode.cpp:1075
SoNode::affectsState
virtual SbBool affectsState(void) const
Definition SoNode.cpp:880
SoNode::rayPick
virtual void rayPick(SoRayPickAction *action)
Definition SoNode.cpp:1188
SoNode::initClass
static void initClass(void)
Sets up initialization for data common to all instances of this class, like submitting necessary info...
Definition SoNode.cpp:573
SoNode::GLRender
virtual void GLRender(SoGLRenderAction *action)
Definition SoNode.cpp:1003
SoNotList
The SoNotList class is a list of SoNotRec notification records.
Definition SoNotification.h:43
SoPickedPoint
The SoPickedPoint class is used for specifying picked points.
Definition SoPickedPoint.h:48
SoPrimitiveVertex
The SoPrimitiveVertex class represents a single vertex of a generated primitive.
Definition SoPrimitiveVertex.h:43
SoRayPickAction
The SoRayPickAction class does ray intersection with scene graphs.
Definition SoRayPickAction.h:50
SoShape::endShape
void endShape(void)
Definition SoShape.cpp:1292
SoShape::invokePointCallbacks
void invokePointCallbacks(SoAction *const action, const SoPrimitiveVertex *const v)
Definition SoShape.cpp:1176
SoShape::createPointDetail
virtual SoDetail * createPointDetail(SoRayPickAction *action, const SoPrimitiveVertex *v, SoPickedPoint *pp)
Definition SoShape.cpp:977
SoShape::shapeVertex
void shapeVertex(const SoPrimitiveVertex *const v)
Definition SoShape.cpp:1279
SoShape::invokeLineSegmentCallbacks
void invokeLineSegmentCallbacks(SoAction *const action, const SoPrimitiveVertex *const v1, const SoPrimitiveVertex *const v2)
Definition SoShape.cpp:1101
SoShape::endSolidShape
void endSolidShape(SoGLRenderAction *action)
Definition SoShape.cpp:869
SoShape::finishVertexArray
void finishVertexArray(SoGLRenderAction *action, const SbBool vbo, const SbBool normpervertex, const SbBool texpervertex, const SbBool colorpervertex)
Definition SoShape.cpp:1705
SoShape::beginShape
void beginShape(SoAction *const action, const TriangleShape shapetype, SoDetail *const detail=NULL)
Definition SoShape.cpp:1264
SoShape::SoShape
SoShape(void)
Definition SoShape.cpp:350
SoShape::invokeTriangleCallbacks
void invokeTriangleCallbacks(SoAction *const action, const SoPrimitiveVertex *const v1, const SoPrimitiveVertex *const v2, const SoPrimitiveVertex *const v3)
Definition SoShape.cpp:989
SoShape::computeObjectSpaceRay
void computeObjectSpaceRay(SoRayPickAction *const action)
Definition SoShape.cpp:878
SoShape::beginSolidShape
void beginSolidShape(SoGLRenderAction *action)
Definition SoShape.cpp:854
SoShape::generateVertex
void generateVertex(SoPrimitiveVertex *const pv, const SbVec3f &point, const SbBool useTexFunc, const SoMultiTextureCoordinateElement *const tce, const float s, const float t, const SbVec3f &normal)
Definition SoShape.cpp:1302
SoShape::createTriangleDetail
virtual SoDetail * createTriangleDetail(SoRayPickAction *action, const SoPrimitiveVertex *v1, const SoPrimitiveVertex *v2, const SoPrimitiveVertex *v3, SoPickedPoint *pp)
Definition SoShape.cpp:909
SoShape::getBoundingBoxCache
const SoBoundingBoxCache * getBoundingBoxCache(void) const
Definition SoShape.cpp:1452
SoShape::createLineSegmentDetail
virtual SoDetail * createLineSegmentDetail(SoRayPickAction *action, const SoPrimitiveVertex *v1, const SoPrimitiveVertex *v2, SoPickedPoint *pp)
Definition SoShape.cpp:944
SoShape::generatePrimitives
virtual void generatePrimitives(SoAction *action)=0
SoShape::shouldGLRender
virtual SbBool shouldGLRender(SoGLRenderAction *action)
Definition SoShape.cpp:560
SoShape::TriangleShape
TriangleShape
Definition SoShape.h:60
SoShape::getDecimatedComplexity
static float getDecimatedComplexity(SoState *state, float complexity)
Definition SoShape.cpp:1364
SoShape::shouldPrimitiveCount
SbBool shouldPrimitiveCount(SoGetPrimitiveCountAction *action)
Definition SoShape.cpp:1400
SoShape::GLRenderBoundingBox
void GLRenderBoundingBox(SoGLRenderAction *action)
Definition SoShape.cpp:1374
SoShape::shouldRayPick
SbBool shouldRayPick(SoRayPickAction *const action)
Definition SoShape.cpp:831
SoShape::computeBBox
virtual void computeBBox(SoAction *action, SbBox3f &box, SbVec3f &center)=0
SoShape::startVertexArray
SbBool startVertexArray(SoGLRenderAction *action, const SoCoordinateElement *coords, const SbVec3f *pervertexnormals, const SbBool texpervertex, const SbBool colorpervertex)
Definition SoShape.cpp:1563
SoShape::getComplexityValue
float getComplexityValue(SoAction *action)
Definition SoShape.cpp:520
SoShape::getScreenSize
static void getScreenSize(SoState *const state, const SbBox3f &boundingbox, SbVec2s &rectsize)
Definition SoShape.cpp:472
SoState
The SoState class manages the Coin scene graph traversal state data.
Definition SoState.h:44
SO_NODE_ABSTRACT_HEADER
#define SO_NODE_ABSTRACT_HEADER(classname)
Definition Coin_macros.dox:61