/** Creates an empty FXPointer
* @return Created orxFXPOINTER / orxNULL
*/
orxFXPOINTER *orxFASTCALL orxFXPointer_Create()
{
orxFXPOINTER *pstResult;
/* Checks */
orxASSERT(sstFXPointer.u32Flags & orxFXPOINTER_KU32_STATIC_FLAG_READY);
/* Creates FXPointer */
pstResult = orxFXPOINTER(orxStructure_Create(orxSTRUCTURE_ID_FXPOINTER));
/* Created? */
if(pstResult != orxNULL)
{
/* Inits flags */
orxStructure_SetFlags(pstResult, orxFXPOINTER_KU32_FLAG_ENABLED, orxFXPOINTER_KU32_MASK_ALL);
/* Increases counter */
orxStructure_IncreaseCounter(pstResult);
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_OBJECT, "Failed to create FX pointer structure.");
}
/* Done! */
return pstResult;
}
/** Creates an empty SoundPointer
* @return Created orxSOUNDPOINTER / orxNULL
*/
orxSOUNDPOINTER *orxFASTCALL orxSoundPointer_Create()
{
orxSOUNDPOINTER *pstResult;
/* Checks */
orxASSERT(sstSoundPointer.u32Flags & orxSOUNDPOINTER_KU32_STATIC_FLAG_READY);
/* Creates SoundPointer */
pstResult = orxSOUNDPOINTER(orxStructure_Create(orxSTRUCTURE_ID_SOUNDPOINTER));
/* Created? */
if(pstResult != orxNULL)
{
/* Clears last added sound index */
pstResult->u32LastAddedIndex = orxU32_UNDEFINED;
/* Inits flags */
orxStructure_SetFlags(pstResult, orxSOUNDPOINTER_KU32_FLAG_ENABLED, orxSOUNDPOINTER_KU32_MASK_ALL);
/* Increases counter */
orxStructure_IncreaseCounter(pstResult);
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_SOUND, "Failed to create Sound Pointer structure.");
}
/* Done! */
return pstResult;
}
/** Creates an empty TimeLine
* @return Created orxTIMELINE / orxNULL
*/
orxTIMELINE *orxFASTCALL orxTimeLine_Create()
{
orxTIMELINE *pstResult;
/* Checks */
orxASSERT(sstTimeLine.u32Flags & orxTIMELINE_KU32_STATIC_FLAG_READY);
/* Creates TimeLine */
pstResult = orxTIMELINE(orxStructure_Create(orxSTRUCTURE_ID_TIMELINE));
/* Created? */
if(pstResult != orxNULL)
{
/* Inits flags */
orxStructure_SetFlags(pstResult, orxTIMELINE_KU32_FLAG_ENABLED, orxTIMELINE_KU32_MASK_ALL);
/* Increases counter */
orxStructure_IncreaseCounter(pstResult);
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_OBJECT, "Failed to create TimeLine structure.");
}
/* Done! */
return pstResult;
}
/** Creates an empty text
* @return orxTEXT / orxNULL
*/
orxTEXT *orxFASTCALL orxText_Create()
{
orxTEXT *pstResult;
/* Checks */
orxASSERT(sstText.u32Flags & orxTEXT_KU32_STATIC_FLAG_READY);
/* Creates text */
pstResult = orxTEXT(orxStructure_Create(orxSTRUCTURE_ID_TEXT));
/* Created? */
if(pstResult != orxNULL)
{
/* Inits it */
pstResult->zString = orxNULL;
pstResult->pstFont = orxNULL;
/* Inits flags */
orxStructure_SetFlags(pstResult, orxTEXT_KU32_FLAG_NONE, orxTEXT_KU32_MASK_ALL);
/* Increases counter */
orxStructure_IncreaseCounter(pstResult);
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_DISPLAY, "Failed to create structure for text.");
}
/* Done! */
return pstResult;
}
/** Creates an empty graphic
* @return Created orxGRAPHIC / orxNULL
*/
orxGRAPHIC *orxFASTCALL orxGraphic_Create()
{
orxGRAPHIC *pstGraphic;
/* Checks */
orxASSERT(sstGraphic.u32Flags & orxGRAPHIC_KU32_STATIC_FLAG_READY);
/* Creates graphic */
pstGraphic = orxGRAPHIC(orxStructure_Create(orxSTRUCTURE_ID_GRAPHIC));
/* Valid? */
if(pstGraphic != orxNULL)
{
/* Inits flags */
orxStructure_SetFlags(pstGraphic, orxGRAPHIC_KU32_FLAG_NONE, orxGRAPHIC_KU32_MASK_ALL);
/* Clears its color */
orxGraphic_ClearColor(pstGraphic);
/* Sets its repeat value to default */
orxGraphic_SetRepeat(pstGraphic, orxFLOAT_1, orxFLOAT_1);
/* Increases counter */
orxStructure_IncreaseCounter(pstGraphic);
}
/* Done! */
return pstGraphic;
}
/** Adds a delayed FX
* @param[in] _pstFXPointer Concerned FXPointer
* @param[in] _pstFX FX to add
* @param[in] _fDelay Delay time
* @return orxSTATUS_SUCCESS / orxSTATUS_FAILURE
*/
orxSTATUS orxFASTCALL orxFXPointer_AddDelayedFX(orxFXPOINTER *_pstFXPointer, orxFX *_pstFX, orxFLOAT _fDelay)
{
orxU32 u32Index;
orxSTATUS eResult;
/* Checks */
orxASSERT(sstFXPointer.u32Flags & orxFXPOINTER_KU32_STATIC_FLAG_READY);
orxSTRUCTURE_ASSERT(_pstFXPointer);
orxSTRUCTURE_ASSERT(_pstFX);
orxASSERT(_fDelay >= orxFLOAT_0);
/* Finds an empty slot */
for(u32Index = 0; (u32Index < orxFXPOINTER_KU32_FX_NUMBER) && (_pstFXPointer->astFXList[u32Index].pstFX != orxNULL); u32Index++);
/* Found? */
if(u32Index < orxFXPOINTER_KU32_FX_NUMBER)
{
orxSTRUCTURE *pstOwner;
orxFX_EVENT_PAYLOAD stPayload;
/* Gets owner */
pstOwner = orxStructure_GetOwner(_pstFXPointer);
/* Increases its reference counter */
orxStructure_IncreaseCounter(_pstFX);
/* Adds it to holder */
_pstFXPointer->astFXList[u32Index].pstFX = _pstFX;
/* Inits its start time */
_pstFXPointer->astFXList[u32Index].fStartTime = _pstFXPointer->fTime + _fDelay;
/* Updates its flags */
orxFLAG_SET(_pstFXPointer->astFXList[u32Index].u32Flags, orxFXPOINTER_HOLDER_KU32_FLAG_NONE, orxFXPOINTER_HOLDER_KU32_MASK_ALL);
/* Inits event payload */
orxMemory_Zero(&stPayload, sizeof(orxFX_EVENT_PAYLOAD));
stPayload.pstFX = _pstFX;
stPayload.zFXName = orxFX_GetName(_pstFX);
/* Sends event */
orxEVENT_SEND(orxEVENT_TYPE_FX, orxFX_EVENT_ADD, pstOwner, pstOwner, &stPayload);
/* Updates result */
eResult = orxSTATUS_SUCCESS;
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_OBJECT, "No available slots for FX.");
/* Updates result */
eResult = orxSTATUS_FAILURE;
}
/* Done! */
return eResult;
}
/** Sets text font
* @param[in] _pstText Concerned text
* @param[in] _pstFont Font / orxNULL to use default
* @return orxSTATUS_SUCCESS / orxSTATUS_FAILURE
*/
orxSTATUS orxFASTCALL orxText_SetFont(orxTEXT *_pstText, orxFONT *_pstFont)
{
orxSTATUS eResult = orxSTATUS_SUCCESS;
/* Checks */
orxASSERT(sstText.u32Flags & orxTEXT_KU32_STATIC_FLAG_READY);
orxSTRUCTURE_ASSERT(_pstText);
/* Different? */
if(_pstText->pstFont != _pstFont)
{
/* Has current font? */
if(_pstText->pstFont != orxNULL)
{
/* Updates structure reference counter */
orxStructure_DecreaseCounter(_pstText->pstFont);
/* Internally handled? */
if(orxStructure_TestFlags(_pstText, orxTEXT_KU32_FLAG_INTERNAL))
{
/* Removes its owner */
orxStructure_SetOwner(_pstText->pstFont, orxNULL);
/* Deletes it */
orxFont_Delete(_pstText->pstFont);
/* Updates flags */
orxStructure_SetFlags(_pstText, orxTEXT_KU32_FLAG_NONE, orxTEXT_KU32_FLAG_INTERNAL);
}
/* Cleans it */
_pstText->pstFont = orxNULL;
}
/* Has new font? */
if(_pstFont != orxNULL)
{
/* Stores it */
_pstText->pstFont = _pstFont;
/* Updates its reference counter */
orxStructure_IncreaseCounter(_pstFont);
}
/* Updates text's size */
orxText_UpdateSize(_pstText);
}
/* Done! */
return eResult;
}
/** Creates a clock
* @param[in] _fTickSize Tick size for the clock (in seconds)
* @param[in] _eType Type of the clock
* @return orxCLOCK / orxNULL
*/
orxCLOCK *orxFASTCALL orxClock_Create(orxFLOAT _fTickSize, orxCLOCK_TYPE _eType)
{
orxCLOCK *pstClock;
/* Checks */
orxASSERT(sstClock.u32Flags & orxCLOCK_KU32_STATIC_FLAG_READY);
orxASSERT(_fTickSize >= orxFLOAT_0);
/* Creates clock */
pstClock = orxCLOCK(orxStructure_Create(orxSTRUCTURE_ID_CLOCK));
/* Valid? */
if(pstClock != orxNULL)
{
/* Creates function bank */
pstClock->pstFunctionBank = orxBank_Create(orxCLOCK_KU32_FUNCTION_BANK_SIZE, sizeof(orxCLOCK_FUNCTION_STORAGE), orxBANK_KU32_FLAG_NONE, orxMEMORY_TYPE_MAIN);
/* Valid? */
if(pstClock->pstFunctionBank != orxNULL)
{
/* Inits clock */
pstClock->stClockInfo.fTickSize = _fTickSize;
pstClock->stClockInfo.eType = _eType;
pstClock->stClockInfo.eModType = orxCLOCK_MOD_TYPE_NONE;
orxStructure_SetFlags(pstClock, orxCLOCK_KU32_FLAG_NONE, orxCLOCK_KU32_MASK_ALL);
/* Increases counter */
orxStructure_IncreaseCounter(pstClock);
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_CLOCK, "Couldn't create clock function storage.");
/* Deletes clock */
orxStructure_Delete(pstClock);
/* Not allocated */
pstClock = orxNULL;
}
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_CLOCK, "Couldn't allocate bank for clock.");
}
/* Done! */
return pstClock;
}
/** Adds a delayed FX using its config ID
* @param[in] _pstFXPointer Concerned FXPointer
* @param[in] _zFXConfigID Config ID of the FX to add
* @param[in] _fDelay Delay time
* @return orxSTATUS_SUCCESS / orxSTATUS_FAILURE
*/
orxSTATUS orxFASTCALL orxFXPointer_AddDelayedFXFromConfig(orxFXPOINTER *_pstFXPointer, const orxSTRING _zFXConfigID, orxFLOAT _fDelay)
{
orxU32 u32Index;
orxSTATUS eResult;
/* Checks */
orxASSERT(sstFXPointer.u32Flags & orxFXPOINTER_KU32_STATIC_FLAG_READY);
orxSTRUCTURE_ASSERT(_pstFXPointer);
orxASSERT((_zFXConfigID != orxNULL) && (_zFXConfigID != orxSTRING_EMPTY));
orxASSERT(_fDelay >= orxFLOAT_0);
/* Finds an empty slot */
for(u32Index = 0; (u32Index < orxFXPOINTER_KU32_FX_NUMBER) && (_pstFXPointer->astFXList[u32Index].pstFX != orxNULL); u32Index++);
/* Found? */
if(u32Index < orxFXPOINTER_KU32_FX_NUMBER)
{
orxFX *pstFX;
/* Creates FX */
pstFX = orxFX_CreateFromConfig(_zFXConfigID);
/* Valid? */
if(pstFX != orxNULL)
{
orxSTRUCTURE *pstOwner;
orxFX_EVENT_PAYLOAD stPayload;
/* Gets owner */
pstOwner = orxStructure_GetOwner(_pstFXPointer);
/* Increases its reference counter */
orxStructure_IncreaseCounter(pstFX);
/* Adds it to holder */
_pstFXPointer->astFXList[u32Index].pstFX = pstFX;
/* Inits its start time */
_pstFXPointer->astFXList[u32Index].fStartTime = _pstFXPointer->fTime + _fDelay;
/* Updates its owner */
orxStructure_SetOwner(pstFX, _pstFXPointer);
/* Updates its flags */
orxFLAG_SET(_pstFXPointer->astFXList[u32Index].u32Flags, orxFXPOINTER_HOLDER_KU32_FLAG_INTERNAL, orxFXPOINTER_HOLDER_KU32_MASK_ALL);
/* Inits event payload */
orxMemory_Zero(&stPayload, sizeof(orxFX_EVENT_PAYLOAD));
stPayload.pstFX = pstFX;
stPayload.zFXName = orxFX_GetName(pstFX);
/* Sends event */
orxEVENT_SEND(orxEVENT_TYPE_FX, orxFX_EVENT_ADD, pstOwner, pstOwner, &stPayload);
/* Updates result */
eResult = orxSTATUS_SUCCESS;
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_OBJECT, "Loading FX <%s> from config failed.", _zFXConfigID);
/* Updates result */
eResult = orxSTATUS_FAILURE;
}
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_SOUND, "Failed to find an empty slot to put FX <%s> into.", _zFXConfigID);
/* Updates result */
eResult = orxSTATUS_FAILURE;
}
/* Done! */
return eResult;
}
/** Adds a sound using its config ID
* @param[in] _pstSoundPointer Concerned SoundPointer
* @param[in] _zSoundConfigID Config ID of the sound to add
* @return orxSTATUS_SUCCESS / orxSTATUS_FAILURE
*/
orxSTATUS orxFASTCALL orxSoundPointer_AddSoundFromConfig(orxSOUNDPOINTER *_pstSoundPointer, const orxSTRING _zSoundConfigID)
{
orxU32 u32Index;
orxSTATUS eResult;
/* Checks */
orxASSERT(sstSoundPointer.u32Flags & orxSOUNDPOINTER_KU32_STATIC_FLAG_READY);
orxSTRUCTURE_ASSERT(_pstSoundPointer);
orxASSERT((_zSoundConfigID != orxNULL) && (_zSoundConfigID != orxSTRING_EMPTY));
/* Finds an empty slot */
for(u32Index = 0; (u32Index < orxSOUNDPOINTER_KU32_SOUND_NUMBER) && (_pstSoundPointer->astSoundList[u32Index].pstSound != orxNULL); u32Index++);
/* Not found? */
if(u32Index == orxSOUNDPOINTER_KU32_SOUND_NUMBER)
{
orxFLOAT fShortestDuration;
orxU32 u32ShortestIndex;
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_SOUND, "No free slot to play sound <%s>, replacing shortest one.", _zSoundConfigID);
/* Gets first index */
u32ShortestIndex = (_pstSoundPointer->u32LastAddedIndex == 0) ? 1 : 0;
/* Gets its duration */
fShortestDuration = orxSound_GetDuration(_pstSoundPointer->astSoundList[u32ShortestIndex].pstSound);
/* For all other sounds */
for(u32Index = u32ShortestIndex + 1; (u32Index < orxSOUNDPOINTER_KU32_SOUND_NUMBER); u32Index++)
{
/* Not the latest added one? */
if(u32Index != _pstSoundPointer->u32LastAddedIndex)
{
orxFLOAT fDuration;
/* Gets its duration */
fDuration = orxSound_GetDuration(_pstSoundPointer->astSoundList[u32Index].pstSound);
/* Shorter? */
if(fDuration < fShortestDuration)
{
/* Selects it */
u32ShortestIndex = u32Index;
}
}
}
/* Removes it */
orxSoundPointer_RemoveSound(_pstSoundPointer, _pstSoundPointer->astSoundList[u32ShortestIndex].pstSound);
/* Updates index */
u32Index = u32ShortestIndex;
}
/* Found? */
if(u32Index < orxSOUNDPOINTER_KU32_SOUND_NUMBER)
{
orxSOUND *pstSound;
/* Creates sound */
pstSound = orxSound_CreateFromConfig(_zSoundConfigID);
/* Valid? */
if(pstSound != orxNULL)
{
orxSOUND_EVENT_PAYLOAD stPayload;
orxOBJECT *pstOwner;
/* Increases its reference counter */
orxStructure_IncreaseCounter(pstSound);
/* Adds it to holder */
_pstSoundPointer->astSoundList[u32Index].pstSound = pstSound;
/* Updates its owner */
orxStructure_SetOwner(pstSound, _pstSoundPointer);
/* Updates its flags */
orxFLAG_SET(_pstSoundPointer->astSoundList[u32Index].u32Flags, orxSOUNDPOINTER_HOLDER_KU32_FLAG_INTERNAL | orxSOUNDPOINTER_HOLDER_KU32_FLAG_AUTO_PLAY, orxSOUNDPOINTER_HOLDER_KU32_MASK_ALL);
/* Stores it as last added sound */
_pstSoundPointer->u32LastAddedIndex = u32Index;
/* Gets its owner object */
pstOwner = orxOBJECT(orxStructure_GetOwner(_pstSoundPointer));
/* Valid? */
if(pstOwner != orxNULL)
{
orxVECTOR vPosition;
/* Updates its position */
orxSound_SetPosition(pstSound, orxObject_GetWorldPosition(pstOwner, &vPosition));
}
/* Inits event payload */
orxMemory_Zero(&stPayload, sizeof(orxSOUND_EVENT_PAYLOAD));
stPayload.pstSound = pstSound;
/* Sends event */
orxEVENT_SEND(orxEVENT_TYPE_SOUND, orxSOUND_EVENT_ADD, pstOwner, pstOwner, &stPayload);
/* Updates result */
eResult = orxSTATUS_SUCCESS;
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_SOUND, "Could not find object named '%s' in config.", _zSoundConfigID);
/* Clears last added sound index */
_pstSoundPointer->u32LastAddedIndex = orxU32_UNDEFINED;
/* Updates result */
eResult = orxSTATUS_FAILURE;
}
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_SOUND, "Failed to find an empty slot to put sound <%s> into.", _zSoundConfigID);
/* Updates result */
eResult = orxSTATUS_FAILURE;
}
/* Done! */
return eResult;
}
/** Creates a camera
* @param[in] _u32Flags Camera flags (2D / ...)
* @return Created orxCAMERA / orxNULL
*/
orxCAMERA *orxFASTCALL orxCamera_Create(orxU32 _u32Flags)
{
orxCAMERA *pstCamera = orxNULL;
orxFRAME *pstFrame;
/* Checks */
orxASSERT(sstCamera.u32Flags & orxCAMERA_KU32_STATIC_FLAG_READY);
orxASSERT((_u32Flags & orxCAMERA_KU32_MASK_USER_ALL) == _u32Flags);
/* Creates camera */
pstCamera = orxCAMERA(orxStructure_Create(orxSTRUCTURE_ID_CAMERA));
/* Valid? */
if(pstCamera != orxNULL)
{
/* Creates frame */
pstFrame = orxFrame_Create(orxFRAME_KU32_FLAG_NONE);
/* Valid? */
if(pstFrame != orxNULL)
{
/* 2D? */
if(orxFLAG_TEST(_u32Flags, orxCAMERA_KU32_FLAG_2D))
{
/* Stores frame */
pstCamera->pstFrame = pstFrame;
/* Increases its reference counter */
orxStructure_IncreaseCounter(pstFrame);
/* Updates flags */
orxStructure_SetFlags(pstCamera, orxCAMERA_KU32_FLAG_2D, orxCAMERA_KU32_FLAG_NONE);
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_RENDER, "Camera currently only supports 2d.");
/* Fress partially allocated camera */
orxFrame_Delete(pstFrame);
orxStructure_Delete(pstCamera);
/* Updates result */
pstCamera = orxNULL;
}
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_RENDER, "Failed to create camera's frame.");
/* Fress partially allocated camera */
orxStructure_Delete(pstCamera);
/* Updates result */
pstCamera = orxNULL;
}
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_RENDER, "Failed to create camera.");
}
/* Done! */
return pstCamera;
}
/** Sets graphic data
* @param[in] _pstGraphic Graphic concerned
* @param[in] _pstData Data structure to set / orxNULL
* @return orxSTATUS_SUCCESS / orxSTATUS_FAILURE
*/
orxSTATUS orxFASTCALL orxGraphic_SetData(orxGRAPHIC *_pstGraphic, orxSTRUCTURE *_pstData)
{
orxSTATUS eResult = orxSTATUS_SUCCESS;
/* Checks */
orxASSERT(sstGraphic.u32Flags & orxGRAPHIC_KU32_STATIC_FLAG_READY);
orxSTRUCTURE_ASSERT(_pstGraphic);
/* Had previous data? */
if(_pstGraphic->pstData != orxNULL)
{
/* Updates structure reference counter */
orxStructure_DecreaseCounter(_pstGraphic->pstData);
/* Internally handled? */
if(orxStructure_TestFlags(_pstGraphic, orxGRAPHIC_KU32_FLAG_INTERNAL))
{
/* Removes its owner */
orxStructure_SetOwner(_pstGraphic->pstData, orxNULL);
/* 2D data? */
if(orxStructure_TestFlags(_pstGraphic, orxGRAPHIC_KU32_FLAG_2D))
{
/* Deletes it */
orxTexture_Delete(orxTEXTURE(_pstGraphic->pstData));
}
/* Text data? */
else if(orxStructure_TestFlags(_pstGraphic, orxGRAPHIC_KU32_FLAG_TEXT))
{
/* Deletes it */
orxText_Delete(orxTEXT(_pstGraphic->pstData));
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_DISPLAY, "Non-2d (texture/text) graphics not supported yet.");
/* Updates result */
eResult = orxSTATUS_FAILURE;
}
/* Updates flags */
orxStructure_SetFlags(_pstGraphic, orxGRAPHIC_KU32_FLAG_NONE, orxGRAPHIC_KU32_FLAG_INTERNAL);
}
/* Cleans reference */
_pstGraphic->pstData = orxNULL;
}
/* Valid & sets new data? */
if((eResult != orxSTATUS_FAILURE) && (_pstData != orxNULL))
{
/* Stores it */
_pstGraphic->pstData = _pstData;
/* Updates structure reference counter */
orxStructure_IncreaseCounter(_pstData);
/* Is data a texture? */
if(orxTEXTURE(_pstData) != orxNULL)
{
/* Updates flags */
orxStructure_SetFlags(_pstGraphic, orxGRAPHIC_KU32_FLAG_2D, orxGRAPHIC_KU32_MASK_TYPE);
}
/* Is data a text? */
else if(orxTEXT(_pstData) != orxNULL)
{
/* Updates flags */
orxStructure_SetFlags(_pstGraphic, orxGRAPHIC_KU32_FLAG_TEXT, orxGRAPHIC_KU32_MASK_TYPE);
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_DISPLAY, "Data given is not a texture nor a text.");
/* Updates flags */
orxStructure_SetFlags(_pstGraphic, orxGRAPHIC_KU32_FLAG_NONE, orxGRAPHIC_KU32_MASK_TYPE);
/* Updates result */
eResult = orxSTATUS_FAILURE;
}
}
else
{
/* Updates flags */
orxStructure_SetFlags(_pstGraphic, orxGRAPHIC_KU32_FLAG_NONE, orxGRAPHIC_KU32_MASK_TYPE);
}
/* Done! */
return eResult;
}
/** Deletes a clock
* @param[in] _pstClock Concerned clock
* @return orxSTATUS_SUCCESS / orxSTATUS_FAILURE
*/
orxSTATUS orxFASTCALL orxClock_Delete(orxCLOCK *_pstClock)
{
orxSTATUS eResult = orxSTATUS_SUCCESS;
/* Checks */
orxASSERT(sstClock.u32Flags & orxCLOCK_KU32_STATIC_FLAG_READY);
orxSTRUCTURE_ASSERT(_pstClock);
/* Decreases counter */
orxStructure_DecreaseCounter(_pstClock);
/* Not referenced? */
if(orxStructure_GetRefCounter(_pstClock) == 0)
{
/* Not locked? */
if(!orxStructure_TestFlags(_pstClock, orxCLOCK_KU32_FLAG_UPDATE_LOCK))
{
orxCLOCK_TIMER_STORAGE *pstTimerStorage;
/* For all stored timers */
for(pstTimerStorage = (orxCLOCK_TIMER_STORAGE *)orxLinkList_GetFirst(&(_pstClock->stTimerList));
pstTimerStorage != orxNULL;
pstTimerStorage = (orxCLOCK_TIMER_STORAGE *)orxLinkList_GetFirst(&(_pstClock->stTimerList)))
{
/* Removes it */
orxLinkList_Remove(&(pstTimerStorage->stNode));
/* Deletes it */
orxBank_Free(sstClock.pstTimerBank, pstTimerStorage);
}
/* Deletes function bank */
orxBank_Delete(_pstClock->pstFunctionBank);
/* Is referenced? */
if(orxStructure_TestFlags(_pstClock, orxCLOCK_KU32_FLAG_REFERENCED))
{
/* Removes it from reference table */
orxHashTable_Remove(sstClock.pstReferenceTable, orxString_ToCRC(_pstClock->zReference));
}
/* Has reference? */
if(_pstClock->zReference != orxNULL)
{
/* Unprotects it */
orxConfig_ProtectSection(_pstClock->zReference, orxFALSE);
}
/* Deletes clock */
orxStructure_Delete(_pstClock);
}
else
{
/* Increases counter */
orxStructure_IncreaseCounter(_pstClock);
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_CLOCK, "Can't delete clock <%s> as it's currently locked for processing!", orxStructure_TestFlags(_pstClock, orxCLOCK_KU32_FLAG_REFERENCED) ? _pstClock->zReference : orxSTRING_EMPTY);
/* Updates result */
eResult = orxSTATUS_FAILURE;
}
}
else
{
/* Referenced by others */
eResult = orxSTATUS_FAILURE;
}
/* Done! */
return eResult;
}
/** Creates a clock from config
* @param[in] _zConfigID Config ID
* @ return orxCLOCK / orxNULL
*/
orxCLOCK *orxFASTCALL orxClock_CreateFromConfig(const orxSTRING _zConfigID)
{
orxCLOCK *pstResult;
/* Checks */
orxASSERT(sstClock.u32Flags & orxCLOCK_KU32_STATIC_FLAG_READY);
/* Search for clock */
pstResult = orxClock_Get(_zConfigID);
/* Found? */
if(pstResult != orxNULL)
{
/* Increases counter */
orxStructure_IncreaseCounter(pstResult);
}
else
{
/* Pushes section */
if((orxConfig_HasSection(_zConfigID) != orxFALSE)
&& (orxConfig_PushSection(_zConfigID) != orxSTATUS_FAILURE))
{
orxFLOAT fFrequency;
/* Gets its frequency */
fFrequency = orxConfig_GetFloat(orxCLOCK_KZ_CONFIG_FREQUENCY);
/* Creates clock */
pstResult = orxClock_Create((fFrequency > orxFLOAT_0) ? orxFLOAT_1 / fFrequency : orxFLOAT_0, orxCLOCK_TYPE_USER);
/* Valid? */
if(pstResult != orxNULL)
{
/* Has a modifier? */
if(orxConfig_HasValue(orxCLOCK_KZ_CONFIG_MODIFIER_TYPE) != orxFALSE)
{
orxFLOAT fModifierValue;
/* Gets its value */
fModifierValue = orxConfig_GetFloat(orxCLOCK_KZ_CONFIG_MODIFIER_VALUE);
/* Valid? */
if(fModifierValue > orxFLOAT_0)
{
const orxSTRING zModifierType;
orxCLOCK_MOD_TYPE eModifierType;
/* Gets modifier type */
zModifierType = orxConfig_GetString(orxCLOCK_KZ_CONFIG_MODIFIER_TYPE);
/* Capped? */
if(orxString_ICompare(zModifierType, orxCLOCK_KZ_MODIFIER_CAPPED) == 0)
{
/* Updates modifier value */
fModifierValue = orxFLOAT_1 / fModifierValue;
/* Updates modifier type */
eModifierType = orxCLOCK_MOD_TYPE_MAXED;
}
/* Fixed? */
else if(orxString_ICompare(zModifierType, orxCLOCK_KZ_MODIFIER_FIXED) == 0)
{
/* Updates modifier value */
fModifierValue = orxFLOAT_1 / fModifierValue;
/* Updates modifier type */
eModifierType = orxCLOCK_MOD_TYPE_FIXED;
}
/* Multiply? */
else if(orxString_ICompare(zModifierType, orxCLOCK_KZ_MODIFIER_MULTIPLY) == 0)
{
/* Updates modifier type */
eModifierType = orxCLOCK_MOD_TYPE_MULTIPLY;
}
/* None */
else
{
/* Updates modifier type */
eModifierType = orxCLOCK_MOD_TYPE_NONE;
}
/* Updates clock */
orxClock_SetModifier(pstResult, eModifierType, fModifierValue);
}
}
/* Stores its reference key */
pstResult->zReference = orxConfig_GetCurrentSection();
/* Protects it */
orxConfig_ProtectSection(pstResult->zReference, orxTRUE);
/* Adds it to reference table */
orxHashTable_Add(sstClock.pstReferenceTable, orxString_ToCRC(pstResult->zReference), pstResult);
/* Updates status flags */
orxStructure_SetFlags(pstResult, orxCLOCK_KU32_FLAG_REFERENCED, orxCLOCK_KU32_FLAG_NONE);
}
/* Pops previous section */
orxConfig_PopSection();
}
else
{
/* Logs message */
orxDEBUG_PRINT(orxDEBUG_LEVEL_RENDER, "Cannot find config section named (%s).", _zConfigID);
/* Updates result */
pstResult = orxNULL;
}
}
/* Done! */
return pstResult;
}
