GameGrid.h

#pragma once
 
#include <Foundation/Containers/DynamicArray.h>
#include <Foundation/Math/Mat3.h>
#include <Foundation/Math/Vec2.h>
#include <Foundation/Math/Vec3.h>
#include <Utilities/UtilitiesDLL.h>
 
template <class CellData>
class plGameGrid
{
public:
  enum Orientation
  {
    InPlaneXY,      
    InPlaneXZ,      
    InPlaneXminusZ, 
  };
 
  plGameGrid();
 
  void CreateGrid(plUInt16 uiSizeX, plUInt16 uiSizeY);
 
  void SetWorldSpaceDimensions(const plVec3& vLowerLeftCorner, const plVec3& vCellSize, Orientation ori = InPlaneXZ);
 
  void SetWorldSpaceDimensions(const plVec3& vLowerLeftCorner, const plVec3& vCellSize, const plMat3& mRotation);
 
  plVec3 GetCellSize() const { return m_vLocalSpaceCellSize; }
 
  plVec2I32 GetCellAtWorldPosition(const plVec3& vWorldSpacePos) const;
 
  plUInt16 GetGridSizeX() const { return m_uiGridSizeX; }
 
  plUInt16 GetGridSizeY() const { return m_uiGridSizeY; }
 
  plBoundingBox GetWorldBoundingBox() const;
 
  plUInt32 GetNumCells() const { return m_uiGridSizeX * m_uiGridSizeY; }
 
  CellData& GetCell(plUInt32 uiIndex) { return m_Cells[uiIndex]; }
 
  const CellData& GetCell(plUInt32 uiIndex) const { return m_Cells[uiIndex]; }
 
  CellData& GetCell(const plVec2I32& vCoord) { return m_Cells[ConvertCellCoordinateToIndex(vCoord)]; }
 
  const CellData& GetCell(const plVec2I32& vCoord) const { return m_Cells[ConvertCellCoordinateToIndex(vCoord)]; }
 
  plVec2I32 ConvertCellIndexToCoordinate(plUInt32 uiIndex) const { return plVec2I32(uiIndex % m_uiGridSizeX, uiIndex / m_uiGridSizeX); }
 
  plUInt32 ConvertCellCoordinateToIndex(const plVec2I32& vCoord) const { return vCoord.y * m_uiGridSizeX + vCoord.x; }
 
  plVec3 GetCellWorldSpaceOrigin(const plVec2I32& vCoord) const;
  plVec3 GetCellLocalSpaceOrigin(const plVec2I32& vCoord) const;
 
  plVec3 GetCellWorldSpaceCenter(const plVec2I32& vCoord) const;
  plVec3 GetCellLocalSpaceCenter(const plVec2I32& vCoord) const;
 
  bool IsValidCellCoordinate(const plVec2I32& vCoord) const;
 
  bool PickCell(const plVec3& vRayStartPos, const plVec3& vRayDirNorm, plVec2I32* out_pCellCoord, plVec3* out_pIntersection = nullptr) const;
 
  const plVec3& GetWorldSpaceOrigin() const { return m_vWorldSpaceOrigin; }
 
  const plMat3& GetRotationToWorldSpace() const { return m_mRotateToWorldspace; }
 
  const plMat3& GetRotationToGridSpace() const { return m_mRotateToGridspace; }
 
  bool GetRayIntersection(const plVec3& vRayStartWorldSpace, const plVec3& vRayDirNormalizedWorldSpace, float fMaxLength, float& out_fIntersection,
    plVec2I32& out_vCellCoord) const;
 
  bool GetRayIntersectionExpandedBBox(const plVec3& vRayStartWorldSpace, const plVec3& vRayDirNormalizedWorldSpace, float fMaxLength,
    float& out_fIntersection, const plVec3& vExpandBBoxByThis) const;
 
  void ComputeWorldSpaceCorners(plVec3* pCorners) const;
 
  plResult Serialize(plStreamWriter& stream) const;
  plResult Deserialize(plStreamReader& stream);
 
private:
  plUInt16 m_uiGridSizeX;
  plUInt16 m_uiGridSizeY;
 
  plMat3 m_mRotateToWorldspace;
  plMat3 m_mRotateToGridspace;
 
  plVec3 m_vWorldSpaceOrigin;
  plVec3 m_vLocalSpaceCellSize;
  plVec3 m_vInverseLocalSpaceCellSize;
 
  plDynamicArray<CellData> m_Cells;
};
 
#include <Utilities/DataStructures/Implementation/GameGrid_inl.h>