orxMemory.h

Go to the documentation of this file.

/* Orx - Portable Game Engine
 *
 * Copyright (c) 2008- 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 _orxMEMORY_H_
#define _orxMEMORY_H_
 
 
#include "orxInclude.h"
#include "debug/orxDebug.h"
 
#include <string.h>

#if defined(__orxGCC__) || defined(__orxLLVM__) || defined(__orxWEB__)
  #define orxMEMORY_BARRIER()                             __sync_synchronize()
  #define orxHAS_MEMORY_BARRIER
  #define orxMEMORY_ATOMIC_INC32(ADDRESS)                 __atomic_add_fetch((ADDRESS), 1, __ATOMIC_SEQ_CST)
  #define orxMEMORY_ATOMIC_DEC32(ADDRESS)                 __atomic_sub_fetch((ADDRESS), 1, __ATOMIC_SEQ_CST)
  #define orxMEMORY_ATOMIC_INC64(ADDRESS)                 __atomic_add_fetch((ADDRESS), 1, __ATOMIC_SEQ_CST)
  #define orxMEMORY_ATOMIC_DEC64(ADDRESS)                 __atomic_sub_fetch((ADDRESS), 1, __ATOMIC_SEQ_CST)
  #define orxHAS_ATOMICS
  #if defined(__orxGCC__)
    #pragma GCC diagnostic push
    #pragma GCC diagnostic ignored "-Wstringop-overflow"
  #endif /* __orxGCC__ */
#elif defined(__orxMSVC__)
  #ifdef __orx64__
    #define orxMEMORY_BARRIER()                           __faststorefence()
  #else /* __orx64__ */
    #define orxMEMORY_BARRIER()     \
    {                               \
      long lBarrier;                \
      _InterlockedOr(&lBarrier, 0); \
    }
  #endif /* __orx64__ */
  #define orxHAS_MEMORY_BARRIER
  #define orxMEMORY_ATOMIC_INC32(ADDRESS)                 ((orxU32)_InterlockedIncrement((volatile long *)(ADDRESS)))
  #define orxMEMORY_ATOMIC_DEC32(ADDRESS)                 ((orxU32)_InterlockedDecrement((volatile long *)(ADDRESS)))
  #define orxMEMORY_ATOMIC_INC64(ADDRESS)                 ((orxU64)_InterlockedIncrement64((volatile __int64 *)(ADDRESS)))
  #define orxMEMORY_ATOMIC_DEC64(ADDRESS)                 ((orxU64)_InterlockedDecrement64((volatile __int64 *)(ADDRESS)))
  #define orxHAS_ATOMICS
#else
  #define orxMEMORY_BARRIER()
  #define orxMEMORY_ATOMIC_INC32(ADDRESS)                 (++(*(ADDRESS)))
  #define orxMEMORY_ATOMIC_DEC32(ADDRESS)                 (--(*(ADDRESS)))
  #define orxMEMORY_ATOMIC_INC64(ADDRESS)                 (++(*(ADDRESS)))
  #define orxMEMORY_ATOMIC_DEC64(ADDRESS)                 (--(*(ADDRESS)))
  #undef orxHAS_MEMORY_BARRIER
  #undef orxHAS_ATOMICS
 
  #warning !!WARNING!! This compiler does not have any builtin hardware memory barrier nor atomics.
#endif
 

#ifdef __orxPROFILER__
  #define orxMEMORY_TRACK(TYPE, SIZE, ALLOCATE)           orxMemory_Track(orxMEMORY_TYPE_##TYPE, SIZE, ALLOCATE)
#else /* __orxPROFILER__ */
  #define orxMEMORY_TRACK(TYPE, SIZE, ALLOCATE)
#endif /* __orxPROFILER__ */
 

#if !defined(__orxWINDOWS__)
  #include <alloca.h>
#endif /* !__orxWINDOWS__ */
#define orxMemory_StackAllocate(x)                        alloca((x))
 

typedef enum __orxMEMORY_TYPE_t
{
  orxMEMORY_TYPE_MAIN = 0,                                
  orxMEMORY_TYPE_AUDIO,                                   
  orxMEMORY_TYPE_CONFIG,                                  
  orxMEMORY_TYPE_DEBUG,                                   
  orxMEMORY_TYPE_PHYSICS,                                 
  orxMEMORY_TYPE_SYSTEM,                                  
  orxMEMORY_TYPE_TEMP,                                    
  orxMEMORY_TYPE_TEXT,                                    
  orxMEMORY_TYPE_VIDEO,                                   
 
  orxMEMORY_TYPE_NUMBER,                                  
 
  orxMEMORY_TYPE_NONE = orxENUM_NONE                      
 
} orxMEMORY_TYPE;
 

extern orxDLLAPI void orxFASTCALL                         orxMemory_Setup();

extern orxDLLAPI orxSTATUS orxFASTCALL                    orxMemory_Init();

extern orxDLLAPI void orxFASTCALL                         orxMemory_Exit();

extern orxDLLAPI orxSTATUS orxFASTCALL                    orxMemory_InitThread();

extern orxDLLAPI void orxFASTCALL                         orxMemory_ExitThread();

extern orxDLLAPI void *orxFASTCALL                        orxMemory_Allocate(orxU32 _u32Size, orxMEMORY_TYPE _eMemType);

extern orxDLLAPI void *orxFASTCALL                        orxMemory_Reallocate(void *_pMem, orxU32 _u32Size, orxMEMORY_TYPE _eMemType);

extern orxDLLAPI void orxFASTCALL                         orxMemory_Free(void *_pMem);
 

static orxINLINE void *                                   orxMemory_Copy(void *_pDest, const void *_pSrc, orxU32 _u32Size)
{
  /* Checks */
  orxASSERT(_pDest != orxNULL);
  orxASSERT(_pSrc != orxNULL);
 
  /* Done! */
  return((void *)memcpy(_pDest, _pSrc, (size_t)_u32Size));
}

static orxINLINE void *                                   orxMemory_Move(void *_pDest, const void *_pSrc, orxU32 _u32Size)
{
  /* Checks */
  orxASSERT(_pDest != orxNULL);
  orxASSERT(_pSrc != orxNULL);
 
  /* Done! */
  return((void *)memmove(_pDest, _pSrc, (size_t)_u32Size));
}

static orxINLINE orxU32                                   orxMemory_Compare(const void *_pMem1, const void *_pMem2, orxU32 _u32Size)
{
  /* Checks */
  orxASSERT(_pMem1 != orxNULL);
  orxASSERT(_pMem2 != orxNULL);
 
  /* Done! */
  return((orxU32)memcmp(_pMem1, _pMem2, (size_t)_u32Size));
}

static orxINLINE void *                                   orxMemory_Set(void *_pDest, orxU8 _u8Data, orxU32 _u32Size)
{
  /* Checks */
  orxASSERT(_pDest != orxNULL);
 
  /* Done! */
  return((void *)memset(_pDest, _u8Data, (size_t)_u32Size));
}

static orxINLINE void *                                   orxMemory_Zero(void *_pDest, orxU32 _u32Size)
{
  /* Checks */
  orxASSERT(_pDest != orxNULL);
 
  /* Done! */
  return((void *)memset(_pDest, 0, (size_t)_u32Size));
}
 

extern orxDLLAPI const orxSTRING orxFASTCALL              orxMemory_GetTypeName(orxMEMORY_TYPE _eMemType);
 

extern orxDLLAPI orxU32 orxFASTCALL                       orxMemory_GetCacheLineSize();
 
 
#ifdef __orxPROFILER__

extern orxDLLAPI orxSTATUS orxFASTCALL                    orxMemory_GetUsage(orxMEMORY_TYPE _eMemType, orxU64 *_pu64Count, orxU64 *_pu64PeakCount, orxU64 *_pu64Size, orxU64 *_pu64PeakSize, orxU64 *_pu64OperationCount);
 

extern orxDLLAPI orxSTATUS orxFASTCALL                    orxMemory_Track(orxMEMORY_TYPE _eMemType, orxU32 _u32Size, orxBOOL _bAllocate);
 
#endif /* __orxPROFILER__  */
 
#if defined(__orxGCC__)
  #pragma GCC diagnostic pop
#endif /* __orxGCC__ */
 
#endif /* _orxMEMORY_H_ */