orxAABox.h

Go to the documentation of this file.

/* Orx - Portable Game Engine
 *
 * Copyright (c) 2008-2022 Orx-Project
 *
 * This software is provided 'as-is', without any express or implied
 * warranty. In no event will the authors be held liable for any damages
 * arising from the use of this software.
 *
 * Permission is granted to anyone to use this software for any purpose,
 * including commercial applications, and to alter it and redistribute it
 * freely, subject to the following restrictions:
 *
 *    1. The origin of this software must not be misrepresented; you must not
 *    claim that you wrote the original software. If you use this software
 *    in a product, an acknowledgment in the product documentation would be
 *    appreciated but is not required.
 *
 *    2. Altered source versions must be plainly marked as such, and must not be
 *    misrepresented as being the original software.
 *
 *    3. This notice may not be removed or altered from any source
 *    distribution.
 */

#ifndef _orxAABOX_H_
#define _orxAABOX_H_

#include "orxInclude.h"

#include "math/orxVector.h"


typedef struct __orxAABOX_t
{
  orxVECTOR vTL; 
  orxVECTOR vBR; 
} orxAABOX;


/* *** AABox inlined functions *** */


static orxINLINE orxAABOX *                   orxAABox_Reorder(orxAABOX *_pstBox)
{
  /* Checks */
  orxASSERT(_pstBox != orxNULL);

  /* Reorders coordinates so as to have upper left & bottom right box corners */

  /* X coord */
  if(_pstBox->vTL.fX > _pstBox->vBR.fX)
  {
     orxFLOAT fTemp;

     /* Swaps */
     fTemp           = _pstBox->vTL.fX;
     _pstBox->vTL.fX = _pstBox->vBR.fX;
     _pstBox->vBR.fX = fTemp;
  }

  /* Y coord */
  if(_pstBox->vTL.fY > _pstBox->vBR.fY)
  {
    orxFLOAT fTemp;

    /* Swaps */
    fTemp           = _pstBox->vTL.fY;
    _pstBox->vTL.fY = _pstBox->vBR.fY;
    _pstBox->vBR.fY = fTemp;
  }

  /* Z coord */
  if(_pstBox->vTL.fZ > _pstBox->vBR.fZ)
  {
    orxFLOAT fTemp;

    /* Swaps */
    fTemp           = _pstBox->vTL.fZ;
    _pstBox->vTL.fZ = _pstBox->vBR.fZ;
    _pstBox->vBR.fZ = fTemp;
  }

  /* Done! */
  return _pstBox;
}

static orxINLINE orxAABOX *                   orxAABox_Set(orxAABOX *_pstRes, const orxVECTOR *_pvTL, const orxVECTOR *_pvBR)
{
  /* Checks */
  orxASSERT(_pstRes != orxNULL);
  orxASSERT(_pvTL != orxNULL);
  orxASSERT(_pvBR != orxNULL);

  /* Sets values */
  orxVector_Copy(&(_pstRes->vTL), _pvTL);
  orxVector_Copy(&(_pstRes->vBR), _pvBR);

  /* Reorders corners */
  orxAABox_Reorder(_pstRes);

  /* Done! */
  return _pstRes;
}

static orxINLINE orxBOOL                      orxAABox_IsInside(const orxAABOX *_pstBox, const orxVECTOR *_pvPosition)
{
  orxBOOL bResult = orxFALSE;

  /* Checks */
  orxASSERT(_pstBox != orxNULL);
  orxASSERT(_pvPosition != orxNULL);

  /* Z intersected? */
  if((_pvPosition->fZ >= _pstBox->vTL.fZ)
  && (_pvPosition->fZ <= _pstBox->vBR.fZ))
  {
    /* X intersected? */
    if((_pvPosition->fX >= _pstBox->vTL.fX)
    && (_pvPosition->fX <= _pstBox->vBR.fX))
    {
      /* Y intersected? */
      if((_pvPosition->fY >= _pstBox->vTL.fY)
      && (_pvPosition->fY <= _pstBox->vBR.fY))
      {
        /* Intersects */
        bResult = orxTRUE;
      }
    }
  }

  /* Done! */
  return bResult;
}

static orxINLINE orxBOOL                      orxAABox_TestIntersection(const orxAABOX *_pstBox1, const orxAABOX *_pstBox2)
{
  orxBOOL bResult = orxFALSE;

  /* Checks */
  orxASSERT(_pstBox1 != orxNULL);
  orxASSERT(_pstBox2 != orxNULL);

  /* Z intersected? */
  if((_pstBox2->vBR.fZ >= _pstBox1->vTL.fZ)
  && (_pstBox2->vTL.fZ <= _pstBox1->vBR.fZ))
  {
    /* X intersected? */
    if((_pstBox2->vBR.fX >= _pstBox1->vTL.fX)
    && (_pstBox2->vTL.fX <= _pstBox1->vBR.fX))
    {
      /* Y intersected? */
      if((_pstBox2->vBR.fY >= _pstBox1->vTL.fY)
      && (_pstBox2->vTL.fY <= _pstBox1->vBR.fY))
      {
        /* Intersects */
        bResult = orxTRUE;
      }
    }
  }

  /* Done! */
  return bResult;
}

static orxINLINE orxBOOL                      orxAABox_Test2DIntersection(const orxAABOX *_pstBox1, const orxAABOX *_pstBox2)
{
  orxBOOL bResult = orxFALSE;

  /* Checks */
  orxASSERT(_pstBox1 != orxNULL);
  orxASSERT(_pstBox2 != orxNULL);

  /* X intersected? */
  if((_pstBox2->vBR.fX >= _pstBox1->vTL.fX)
  && (_pstBox2->vTL.fX <= _pstBox1->vBR.fX))
  {
    /* Y intersected? */
    if((_pstBox2->vBR.fY >= _pstBox1->vTL.fY)
    && (_pstBox2->vTL.fY <= _pstBox1->vBR.fY))
    {
      /* Intersects */
      bResult = orxTRUE;
    }
  }

  /* Done! */
  return bResult;
}

static orxINLINE orxAABOX *                   orxAABox_Copy(orxAABOX *_pstDst, const orxAABOX *_pstSrc)
{
  /* Checks */
  orxASSERT(_pstDst != orxNULL);
  orxASSERT(_pstSrc != orxNULL);

  /* Copies it */
  orxMemory_Copy(_pstDst, _pstSrc, sizeof(orxAABOX));

  /* Done! */
  return _pstDst;
}

static orxINLINE orxAABOX *                   orxAABox_Move(orxAABOX *_pstRes, const orxAABOX *_pstOp, const orxVECTOR *_pvMove)
{
  /* Checks */
  orxASSERT(_pstRes != orxNULL);
  orxASSERT(_pstOp != orxNULL);
  orxASSERT(_pvMove != orxNULL);

  /* Updates result */
  orxVector_Add(&(_pstRes->vTL), &(_pstOp->vTL), _pvMove);
  orxVector_Add(&(_pstRes->vBR), &(_pstOp->vBR), _pvMove);

  /* Done! */
  return _pstRes;
}

static orxINLINE orxVECTOR *                  orxAABox_GetCenter(const orxAABOX *_pstOp, orxVECTOR *_pvRes)
{
  /* Checks */
  orxASSERT(_pstOp != orxNULL);
  orxASSERT(_pvRes != orxNULL);

  /* Gets box center */
  orxVector_Add(_pvRes, &(_pstOp->vTL), &(_pstOp->vBR));
  orxVector_Mulf(_pvRes, _pvRes, orx2F(0.5f));

  /* Done! */
  return _pvRes;
}

#endif /* _orxAABOX_H_ */