/usr/include/osg/ClipNode is in libopenscenegraph-3.4-dev 3.4.0+dfsg1-4+b3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
| 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 | /* -*-c++-*- OpenSceneGraph - Copyright (C) 1998-2006 Robert Osfield
 *
 * This library is open source and may be redistributed and/or modified under
 * the terms of the OpenSceneGraph Public License (OSGPL) version 0.0 or
 * (at your option) any later version.  The full license is in LICENSE file
 * included with this distribution, and on the openscenegraph.org website.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * OpenSceneGraph Public License for more details.
*/
#ifndef OSG_CLIPNODE
#define OSG_CLIPNODE 1
#include <osg/Group>
#include <osg/ClipPlane>
namespace osg {
/** Node for defining the position of ClipPlanes in the scene.*/
class OSG_EXPORT ClipNode : public Group
{
    public:
        typedef std::vector<ref_ptr<ClipPlane> > ClipPlaneList;
        ClipNode();
        ClipNode(const ClipNode& es, const CopyOp& copyop=CopyOp::SHALLOW_COPY);
        META_Node(osg, ClipNode);
        enum ReferenceFrame
        {
            RELATIVE_RF,
            ABSOLUTE_RF
        };
        /** Set the ClipNode's ReferenceFrame, either to be relative to its
          * parent reference frame, or relative to an absolute coordinate
          * frame. RELATIVE_RF is the default.
          * Note: setting the ReferenceFrame to be ABSOLUTE_RF will
          * also set the CullingActive flag to false on the ClipNode (and
          * consequently all of its parents), thereby disabling culling of it and
          * all its parents.  This is necessary to prevent inappropriate
          * culling, but may impact cull times if the absolute ClipNode is
          * deep in the scene graph.  It is therefore recommended to only use
          * absolute ClipNode at the top of the scene.
        */
        void setReferenceFrame(ReferenceFrame rf);
        ReferenceFrame getReferenceFrame() const { return _referenceFrame; }
        /** Creates six clip planes corresponding to the given BoundingBox. */
        void createClipBox(const BoundingBox& bb,unsigned int clipPlaneNumberBase=0);
        /** Adds the clipplane. Returns true on success, and false if the plane
          * has already been added, or if clipplane is NULL. */
        bool addClipPlane(ClipPlane* clipplane);
        /** Removes the clipplane. Returns true on success, false if clipplane
         * isn't in this ClipNode.*/
        bool removeClipPlane(ClipPlane* clipplane);
        /** Remove the ClipPlane with the given index. Returns true on success,
          * false if pos is not a valid plane index. */
        bool removeClipPlane(unsigned int pos);
        /** Returns the number of ClipPlanes. */
        inline unsigned int getNumClipPlanes() const { return _planes.size(); }
        /** Get ClipPlane at the given index position. */
        inline ClipPlane* getClipPlane(unsigned int pos) { return _planes[pos].get(); }
        /** Get const ClipPlane at the given index position. */
        inline const ClipPlane* getClipPlane(unsigned int pos) const { return _planes[pos].get(); }
        /** Set the ClipPlaneList. */
        inline void setClipPlaneList(const ClipPlaneList& cpl) { _planes=cpl; }
        /** Get the ClipPlaneList. */
        inline ClipPlaneList& getClipPlaneList() { return _planes; }
        /** Get the const ClipPlaneList. */
        inline const ClipPlaneList& getClipPlaneList() const { return _planes; }
        /** Set the GLModes for all ClipPlanes, on the StateSet. */
        void setStateSetModes(StateSet&,StateAttribute::GLModeValue) const;
        /** Set up the local StateSet. */
        void setLocalStateSetModes(StateAttribute::GLModeValue=StateAttribute::ON);
        virtual BoundingSphere computeBound() const;
    protected:
        virtual ~ClipNode();
        StateAttribute::GLModeValue     _value;
        ClipPlaneList                   _planes;
        ReferenceFrame                  _referenceFrame;
};
}
#endif
 |