Public Types | |
| enum | CenterMode { USE_BOUNDING_SPHERE_CENTER, USER_DEFINED_CENTER } |
| Modes which control how the center of object should be determined when computing which child is active. More... | |
| enum | RangeMode { DISTANCE_FROM_EYE_POINT, PIXEL_SIZE_ON_SCREEN } |
| Modes that control how the range values should be intepreted when computing which child is active. More... | |
| typedef std::pair < float, float > | MinMaxPair |
| typedef std::vector < MinMaxPair > | RangeList |
Public Member Functions | |
| LOD () | |
| LOD (const LOD &, const CopyOp ©op=CopyOp::SHALLOW_COPY) | |
| Copy constructor using CopyOp to manage deep vs shallow copy. | |
| META_Node (osg, LOD) | |
| virtual void | traverse (NodeVisitor &nv) |
| Traverse downwards : calls children's accept method with NodeVisitor. | |
| virtual bool | addChild (Node *child) |
| Add Node to Group. | |
| virtual bool | addChild (Node *child, float min, float max) |
| virtual bool | removeChildren (unsigned int pos, unsigned int numChildrenToRemove=1) |
| Remove children from Group. | |
| void | setCenterMode (CenterMode mode) |
| Set how the center of object should be determined when computing which child is active. | |
| CenterMode | getCenterMode () const |
| Get how the center of object should be determined when computing which child is active. | |
| void | setCenter (const Vec3 ¢er) |
| Sets the object-space point which defines the center of the osg::LOD. | |
| const Vec3 & | getCenter () const |
| return the LOD center point. | |
| void | setRadius (float radius) |
| Set the object-space reference radius of the volume enclosed by the LOD. | |
| float | getRadius () const |
| Get the object-space radius of the volume enclosed by the LOD. | |
| void | setRangeMode (RangeMode mode) |
| Set how the range values should be intepreted when computing which child is active. | |
| RangeMode | getRangeMode () const |
| Get how the range values should be intepreted when computing which child is active. | |
| void | setRange (unsigned int childNo, float min, float max) |
| Sets the min and max visible ranges of range of specifiec child. | |
| float | getMinRange (unsigned int childNo) const |
| returns the min visible range for specified child. | |
| float | getMaxRange (unsigned int childNo) const |
| returns the max visible range for specified child. | |
| unsigned int | getNumRanges () const |
| returns the number of ranges currently set. | |
| void | setRangeList (const RangeList &rangeList) |
| set the list of MinMax ranges for each child. | |
| const RangeList & | getRangeList () const |
| return the list of MinMax ranges for each child. | |
| virtual BoundingSphere | computeBound () const |
| Compute the bounding sphere around Node's geometry or children. | |
Protected Member Functions | |
| virtual | ~LOD () |
Protected Attributes | |
| CenterMode | _centerMode |
| Vec3 | _userDefinedCenter |
| float | _radius |
| RangeMode | _rangeMode |
| RangeList | _rangeList |
Typical uses are for load balancing - objects further away from the eye point are rendered at a lower level of detail, and at times of high stress on the graphics pipeline lower levels of detail can also be chosen by adjusting the viewers's Camera/CullSettings LODScale value. Each child has a corresponding valid range consisting of a minimum and maximum distance. Given a distance to the viewer (d), LOD displays a child if min <= d < max. LOD may display multiple children simultaneously if their corresponding ranges overlap. Children can be in any order, and don't need to be sorted by range or amount of detail. If the number of ranges (m) is less than the number of children (n), then children m+1 through n are ignored.
| typedef std::pair<float,float> osg::LOD::MinMaxPair |
| typedef std::vector<MinMaxPair> osg::LOD::RangeList |
| enum osg::LOD::CenterMode |
| enum osg::LOD::RangeMode |
| osg::LOD::LOD | ( | ) |
Copy constructor using CopyOp to manage deep vs shallow copy.
| virtual osg::LOD::~LOD | ( | ) | [inline, protected, virtual] |
| osg::LOD::META_Node | ( | osg | , | |
| LOD | ||||
| ) |
| virtual void osg::LOD::traverse | ( | NodeVisitor & | ) | [virtual] |
Traverse downwards : calls children's accept method with NodeVisitor.
Reimplemented from osg::Group.
Reimplemented in osg::PagedLOD, and osgSim::Impostor.
| virtual bool osg::LOD::addChild | ( | Node * | child | ) | [virtual] |
If node is not NULL and is not contained in Group then increment its reference count, add it to the child list and dirty the bounding sphere to force it to recompute on next getBound() and return true for success. Otherwise return false. Scene nodes can't be added as child nodes.
Reimplemented from osg::Group.
Reimplemented in osg::PagedLOD.
| virtual bool osg::LOD::addChild | ( | Node * | child, | |
| float | min, | |||
| float | max | |||
| ) | [virtual] |
Reimplemented in osg::PagedLOD.
| virtual bool osg::LOD::removeChildren | ( | unsigned int | pos, | |
| unsigned int | numChildrenToRemove = 1 | |||
| ) | [virtual] |
Remove children from Group.
Note, must be override by subclasses of Group which add per child attributes.
Reimplemented from osg::Group.
Reimplemented in osg::PagedLOD.
| void osg::LOD::setCenterMode | ( | CenterMode | mode | ) | [inline] |
Set how the center of object should be determined when computing which child is active.
| CenterMode osg::LOD::getCenterMode | ( | ) | const [inline] |
Get how the center of object should be determined when computing which child is active.
| void osg::LOD::setCenter | ( | const Vec3 & | center | ) | [inline] |
| void osg::LOD::setRadius | ( | float | radius | ) | [inline] |
| float osg::LOD::getRadius | ( | ) | const [inline] |
Get the object-space radius of the volume enclosed by the LOD.
| void osg::LOD::setRangeMode | ( | RangeMode | mode | ) | [inline] |
Set how the range values should be intepreted when computing which child is active.
| RangeMode osg::LOD::getRangeMode | ( | ) | const [inline] |
Get how the range values should be intepreted when computing which child is active.
| void osg::LOD::setRange | ( | unsigned int | childNo, | |
| float | min, | |||
| float | max | |||
| ) |
Sets the min and max visible ranges of range of specifiec child.
Values are floating point distance specified in local objects coordinates.
| float osg::LOD::getMinRange | ( | unsigned int | childNo | ) | const [inline] |
returns the min visible range for specified child.
| float osg::LOD::getMaxRange | ( | unsigned int | childNo | ) | const [inline] |
returns the max visible range for specified child.
| unsigned int osg::LOD::getNumRanges | ( | ) | const [inline] |
returns the number of ranges currently set.
An LOD which has been fully set up will have getNumChildren()==getNumRanges().
| void osg::LOD::setRangeList | ( | const RangeList & | rangeList | ) | [inline] |
set the list of MinMax ranges for each child.
| const RangeList& osg::LOD::getRangeList | ( | ) | const [inline] |
return the list of MinMax ranges for each child.
| virtual BoundingSphere osg::LOD::computeBound | ( | ) | const [virtual] |
Compute the bounding sphere around Node's geometry or children.
This method is automatically called by getBound() when the bounding sphere has been marked dirty via dirtyBound().
Reimplemented from osg::Group.
Reimplemented in osgSim::Impostor.
CenterMode osg::LOD::_centerMode [protected] |
Vec3 osg::LOD::_userDefinedCenter [protected] |
float osg::LOD::_radius [protected] |
RangeMode osg::LOD::_rangeMode [protected] |
RangeList osg::LOD::_rangeList [protected] |