overte-HifiExperiments/libraries/octree/src/OctreeElement.h

//
//  OctreeElement.h
//  libraries/octree/src
//
//  Created by Stephen Birarda on 3/13/13.
//  Copyright 2013 High Fidelity, Inc.
//
//  Distributed under the Apache License, Version 2.0.
//  See the accompanying file LICENSE or http://www.apache.org/licenses/LICENSE-2.0.html
//

#ifndef hifi_OctreeElement_h
#define hifi_OctreeElement_h

//#define SIMPLE_CHILD_ARRAY
#define SIMPLE_EXTERNAL_CHILDREN

#include <atomic>

#include <QReadWriteLock>

#include <OctalCode.h>
#include <SharedUtil.h>
#include <ViewFrustum.h>

#include "AACube.h"
#include "OctreeConstants.h"

using AtomicUIntStat = std::atomic<uintmax_t>;


class EncodeBitstreamParams;
class Octree;
class OctreeElement;
class OctreePacketData;
class ReadBitstreamToTreeParams;
class Shape;
class VoxelSystem;

using OctreeElementPointer = std::shared_ptr<OctreeElement>;
using OctreeElementWeakPointer = std::weak_ptr<OctreeElement>;
using ConstOctreeElementPointer = std::shared_ptr<const OctreeElement>;
using OctreePointer = std::shared_ptr<Octree>;

class OctreeElement: public std::enable_shared_from_this<OctreeElement> {

protected:
    // can only be constructed by derived implementation
    OctreeElement();

    virtual OctreeElementPointer createNewElement(unsigned char * octalCode = NULL) = 0;

public:
    virtual void init(unsigned char * octalCode); /// Your subclass must call init on construction.
    virtual ~OctreeElement();

    // methods you can and should override to implement your tree functionality

    /// Adds a child to the current element. Override this if there is additional child initialization your class needs.
    virtual OctreeElementPointer addChildAtIndex(int childIndex);

    /// Override this to implement LOD averaging on changes to the tree.
    virtual void calculateAverageFromChildren() { }

    /// Override this to implement LOD collapsing and identical child pruning on changes to the tree.
    virtual bool collapseChildren() { return false; }

    /// Should this element be considered to have content in it. This will be used in collision and ray casting methods.
    /// By default we assume that only leaves are actual content, but some octrees may have different semantics.
    virtual bool hasContent() const { return isLeaf(); }

    /// Should this element be considered to have detailed content in it. Specifically should it be rendered.
    /// By default we assume that only leaves have detailed content, but some octrees may have different semantics.
    virtual bool hasDetailedContent() const { return isLeaf(); }

    /// Override this to break up large octree elements when an edit operation is performed on a smaller octree element.
    /// For example, if the octrees represent solid cubes and a delete of a smaller octree element is done then the
    /// meaningful split would be to break the larger cube into smaller cubes of the same color/texture.
    virtual void splitChildren() { }

    /// Override to indicate that this element requires a split before editing lower elements in the octree
    virtual bool requiresSplit() const { return false; }

    /// The state of the call to appendElementData
    typedef enum { COMPLETED, PARTIAL, NONE } AppendState;

    virtual void debugExtraEncodeData(EncodeBitstreamParams& params) const { }

    /// Override to deserialize the state of this element. This is used for loading from a persisted file or from reading
    /// from the network.
    virtual int readElementDataFromBuffer(const unsigned char* data, int bytesLeftToRead, ReadBitstreamToTreeParams& args)
                    { return 0; }

    /// Override to indicate that the item is currently rendered in the rendering engine. By default we assume that if
    /// the element should be rendered, then your rendering engine is rendering. But some rendering engines my have cases
    /// where an element is not actually rendering all should render elements. If the isRendered() state doesn't match the
    /// shouldRender() state, the tree will remark elements as changed even in cases there the elements have not changed.
    virtual bool isRendered() const { return getShouldRender(); }

    virtual bool deleteApproved() const { return true; }
    
    virtual bool canPickIntersect() const { return isLeaf(); }
    /// \param center center of sphere in meters
    /// \param radius radius of sphere in meters
    /// \param[out] penetration pointing into cube from sphere
    /// \param penetratedObject unused
    virtual bool findSpherePenetration(const glm::vec3& center, float radius,
                        glm::vec3& penetration, void** penetratedObject) const;

    // Base class methods you don't need to implement
    const unsigned char* getOctalCode() const { return (_octcodePointer) ? _octalCode.pointer : &_octalCode.buffer[0]; }
    OctreeElementPointer getChildAtIndex(int childIndex) const;
    void deleteChildAtIndex(int childIndex);
    OctreeElementPointer removeChildAtIndex(int childIndex);
    bool isParentOf(const OctreeElementPointer& possibleChild) const;

    /// handles deletion of all descendants, returns false if delete not approved
    bool safeDeepDeleteChildAtIndex(int childIndex, int recursionCount = 0);


    const AACube& getAACube() const { return _cube; }
    const glm::vec3& getCorner() const { return _cube.getCorner(); }
    float getScale() const { return _cube.getScale(); }
    int getLevel() const { return numberOfThreeBitSectionsInCode(getOctalCode()) + 1; }

    float getEnclosingRadius() const;
    bool isInView(const ViewFrustum& viewFrustum) const { return computeViewIntersection(viewFrustum) != ViewFrustum::OUTSIDE; }
    ViewFrustum::intersection computeViewIntersection(const ViewFrustum& viewFrustum) const;
    float distanceToCamera(const ViewFrustum& viewFrustum) const;
    float furthestDistanceToCamera(const ViewFrustum& viewFrustum) const;

    // points are assumed to be in Voxel Coordinates (not TREE_SCALE'd)
    float distanceSquareToPoint(const glm::vec3& point) const; // when you don't need the actual distance, use this.
    float distanceToPoint(const glm::vec3& point) const;

    bool isLeaf() const { return _childBitmask == 0; }
    int getChildCount() const { return numberOfOnes(_childBitmask); }
    void printDebugDetails(const char* label) const;
    bool isDirty() const { return _isDirty; }
    void clearDirtyBit() { _isDirty = false; }
    void setDirtyBit() { _isDirty = true; }
    bool hasChangedSince(quint64 time) const { return (_lastChanged > time); }
    void markWithChangedTime();
    quint64 getLastChanged() const { return _lastChanged; }
    void handleSubtreeChanged(OctreePointer myTree);

    // Used by VoxelSystem for rendering in/out of view and LOD
    void setShouldRender(bool shouldRender);
    bool getShouldRender() const { return _shouldRender; }


    void setSourceUUID(const QUuid& sourceID);
    QUuid getSourceUUID() const;
    uint16_t getSourceUUIDKey() const { return _sourceUUIDKey; }
    bool matchesSourceUUID(const QUuid& sourceUUID) const;
    static uint16_t getSourceNodeUUIDKey(const QUuid& sourceUUID);

    static void resetPopulationStatistics();
    static unsigned long getNodeCount() { return _voxelNodeCount; }
    static unsigned long getInternalNodeCount() { return _voxelNodeCount - _voxelNodeLeafCount; }
    static unsigned long getLeafNodeCount() { return _voxelNodeLeafCount; }

    static quint64 getOctreeMemoryUsage() { return _octreeMemoryUsage; }
    static quint64 getOctcodeMemoryUsage() { return _octcodeMemoryUsage; }
    static quint64 getExternalChildrenMemoryUsage() { return _externalChildrenMemoryUsage; }
    static quint64 getTotalMemoryUsage() { return _octreeMemoryUsage + _octcodeMemoryUsage + _externalChildrenMemoryUsage; }

    static quint64 getGetChildAtIndexTime() { return _getChildAtIndexTime; }
    static quint64 getGetChildAtIndexCalls() { return _getChildAtIndexCalls; }
    static quint64 getSetChildAtIndexTime() { return _setChildAtIndexTime; }
    static quint64 getSetChildAtIndexCalls() { return _setChildAtIndexCalls; }

    static quint64 getExternalChildrenCount() { return _externalChildrenCount; }
    static quint64 getChildrenCount(int childCount) { return _childrenCount[childCount]; }

    enum ChildIndex {
        CHILD_BOTTOM_RIGHT_NEAR = 0,
        CHILD_BOTTOM_RIGHT_FAR = 1,
        CHILD_TOP_RIGHT_NEAR = 2,
        CHILD_TOP_RIGHT_FAR = 3,
        CHILD_BOTTOM_LEFT_NEAR = 4,
        CHILD_BOTTOM_LEFT_FAR = 5,
        CHILD_TOP_LEFT_NEAR = 6,
        CHILD_TOP_LEFT_FAR = 7,
        CHILD_UNKNOWN = -1
    };

    struct HalfSpace {
        enum {
            None    = 0x00,
            Bottom  = 0x01,
            Top     = 0x02,
            Right   = 0x04,
            Left    = 0x08,
            Near    = 0x10,
            Far     = 0x20,
            All     = 0x3f,
        };
    };


    OctreeElementPointer getOrCreateChildElementAt(float x, float y, float z, float s);
    OctreeElementPointer getOrCreateChildElementContaining(const AACube& box);
    OctreeElementPointer getOrCreateChildElementContaining(const AABox& box);
    int getMyChildContaining(const AACube& cube) const;
    int getMyChildContaining(const AABox& box) const;
    int getMyChildContainingPoint(const glm::vec3& point) const;

    void bumpChangedContent() { _lastChangedContent = usecTimestampNow(); }
    uint64_t getLastChangedContent() const { return _lastChangedContent; }

protected:

    void deleteAllChildren();
    void setChildAtIndex(int childIndex, const OctreeElementPointer& child);

    void calculateAACube();

    AACube _cube; /// Client and server, axis aligned box for bounds of this voxel, 48 bytes

    /// Client and server, buffer containing the octal code or a pointer to octal code for this node, 8 bytes
    union octalCode_t {
      unsigned char buffer[8];
      unsigned char* pointer;
    } _octalCode;

    quint64 _lastChanged; /// Client and server, timestamp this node was last changed, 8 bytes
    uint64_t _lastChangedContent { 0 };

    /// Client and server, pointers to child nodes, various encodings
#ifdef SIMPLE_CHILD_ARRAY
    OctreeElementPointer _simpleChildArray[8]; /// Only used when SIMPLE_CHILD_ARRAY is enabled
#endif

#ifdef SIMPLE_EXTERNAL_CHILDREN
    // union children_t {
    OctreeElementPointer _childrenSingle;
    OctreeElementPointer _externalChildren[NUMBER_OF_CHILDREN];
    // } _children;
#endif

    uint16_t _sourceUUIDKey; /// Client only, stores node id of voxel server that sent his voxel, 2 bytes

    // Support for _sourceUUID, we use these static member variables to track the UUIDs that are
    // in use by various voxel server nodes. We map the UUID strings into an 16 bit key, this limits us to at
    // most 65k voxel servers in use at a time within the client. Which is far more than we need.
    static uint16_t _nextUUIDKey; // start at 1, 0 is reserved for NULL
    static std::map<QString, uint16_t> _mapSourceUUIDsToKeys;
    static std::map<uint16_t, QString> _mapKeysToSourceUUIDs;

    unsigned char _childBitmask;     // 1 byte

    bool _falseColored : 1, /// Client only, is this voxel false colored, 1 bit
         _isDirty : 1, /// Client only, has this voxel changed since being rendered, 1 bit
         _shouldRender : 1, /// Client only, should this voxel render at this time, 1 bit
         _octcodePointer : 1, /// Client and Server only, is this voxel's octal code a pointer or buffer, 1 bit
         _unknownBufferIndex : 1,
         _childrenExternal : 1; /// Client only, is this voxel's VBO buffer the unknown buffer index, 1 bit

    static AtomicUIntStat _voxelNodeCount;
    static AtomicUIntStat _voxelNodeLeafCount;

    static AtomicUIntStat _octreeMemoryUsage;
    static AtomicUIntStat _octcodeMemoryUsage;
    static AtomicUIntStat _externalChildrenMemoryUsage;

    static AtomicUIntStat _getChildAtIndexTime;
    static AtomicUIntStat _getChildAtIndexCalls;
    static AtomicUIntStat _setChildAtIndexTime;
    static AtomicUIntStat _setChildAtIndexCalls;

    static AtomicUIntStat _externalChildrenCount;
    static AtomicUIntStat _childrenCount[NUMBER_OF_CHILDREN + 1];
};

#endif // hifi_OctreeElement_h