From 90689a171720550892ce7a9807193699569981a9 Mon Sep 17 00:00:00 2001 From: Fire-Head Date: Mon, 3 Aug 2020 01:25:29 +0300 Subject: [PATCH 1/5] shadow fixes --- src/render/Shadows.cpp | 65 +++++++++++++++++++++--------------------- src/render/Shadows.h | 11 +------ 2 files changed, 34 insertions(+), 42 deletions(-) diff --git a/src/render/Shadows.cpp b/src/render/Shadows.cpp index c169c351..9d6193b3 100644 --- a/src/render/Shadows.cpp +++ b/src/render/Shadows.cpp @@ -458,7 +458,7 @@ CShadows::StoreShadowForCar(CAutomobile *pCar) if ( CTimeCycle::GetShadowStrength() != 0 ) { CVector CarPos = pCar->GetPosition(); - float fDistToCamSqr = (CarPos - TheCamera.GetPosition()).MagnitudeSqr(); + float fDistToCamSqr = (CarPos - TheCamera.GetPosition()).MagnitudeSqr2D(); if ( CCutsceneMgr::IsRunning() ) fDistToCamSqr /= SQR(TheCamera.LODDistMultiplier) * 4.0f; @@ -1578,40 +1578,41 @@ CStaticShadow::Free(void) void CShadows::CalcPedShadowValues(CVector vecLightDir, - float *pfDisplacementX, float *pfDisplacementY, float *pfFrontX, float *pfFrontY, - float *pfSideX, float *pfSideY) + float *pfSideX, float *pfSideY, + float *pfDisplacementX, float *pfDisplacementY) { - ASSERT(pfDisplacementX != NULL); - ASSERT(pfDisplacementY != NULL); - ASSERT(pfFrontX != NULL); - ASSERT(pfFrontY != NULL); - ASSERT(pfSideX != NULL); - ASSERT(pfSideY != NULL); + ASSERT(pfFrontX != nil); + ASSERT(pfFrontY != nil); + ASSERT(pfSideX != nil); + ASSERT(pfSideY != nil); + ASSERT(pfDisplacementX != nil); + ASSERT(pfDisplacementY != nil); + + *pfFrontX = -vecLightDir.x; + *pfFrontY = -vecLightDir.y; + + float fDist = Sqrt(*pfFrontY * *pfFrontY + *pfFrontX * *pfFrontX); + float fMult = (fDist + 1.0f) / fDist; + + *pfFrontX *= fMult; + *pfFrontY *= fMult; + + *pfSideX = -vecLightDir.y / fDist; + *pfSideY = vecLightDir.x / fDist; *pfDisplacementX = -vecLightDir.x; *pfDisplacementY = -vecLightDir.y; - float fDist = Sqrt(*pfDisplacementY * *pfDisplacementY + *pfDisplacementX * *pfDisplacementX); - float fMult = (fDist + 1.0f) / fDist; - - *pfDisplacementX *= fMult; - *pfDisplacementY *= fMult; - - *pfFrontX = -vecLightDir.y / fDist; - *pfFrontY = vecLightDir.x / fDist; - - *pfSideX = -vecLightDir.x; - *pfSideY = -vecLightDir.y; - - *pfDisplacementX /= 2; - *pfDisplacementY /= 2; - *pfFrontX /= 2; *pfFrontY /= 2; *pfSideX /= 2; *pfSideY /= 2; + + *pfDisplacementX /= 2; + *pfDisplacementY /= 2; + } void @@ -1656,22 +1657,22 @@ CShadows::RenderExtraPlayerShadows(void) vecLight.y *= fInv; vecLight.z *= fInv; - float fDisplacementX, fDisplacementY, fFrontX, fFrontY, fSideX, fSideY; + float fFrontX, fFrontY, fSideX, fSideY, fDisplacementX, fDisplacementY; CalcPedShadowValues(vecLight, - &fDisplacementX, &fDisplacementY, - &fFrontX, &fFrontY, - &fSideX, &fSideY); + &fFrontX, &fFrontY, + &fSideX, &fSideY, + &fDisplacementX, &fDisplacementY); CVector shadowPos = FindPlayerCoors(); - shadowPos.x += fSideX; - shadowPos.y += fSideY; + shadowPos.x += fDisplacementX; + shadowPos.y += fDisplacementY; StoreShadowToBeRendered(SHADOWTYPE_DARK, gpShadowPedTex, &shadowPos, - fDisplacementX, fDisplacementY, fFrontX, fFrontY, + fSideX, fSideY, nColorStrength, 0, 0, 0, 4.0f, false, 1.0f); } @@ -1768,7 +1769,7 @@ CShadows::RenderIndicatorShadow(uint32 nID, uint8 ShadowType, RwTexture *pTextur { ASSERT(pPosn != NULL); - C3dMarkers::PlaceMarkerSet(nID, _TODOCONST(4), *pPosn, Max(fFrontX, -fSideY), + C3dMarkers::PlaceMarkerSet(nID, MARKERTYPE_CYLINDER, *pPosn, Max(fFrontX, -fSideY), 0, 128, 255, 128, 2048, 0.2f, 0); } diff --git a/src/render/Shadows.h b/src/render/Shadows.h index 63aaaaf2..8c909df3 100644 --- a/src/render/Shadows.h +++ b/src/render/Shadows.h @@ -128,21 +128,12 @@ class CPed; class CShadows { public: -#if 1 static int16 ShadowsStoredToBeRendered; static CStoredShadow asShadowsStored [MAX_STOREDSHADOWS]; static CPolyBunch aPolyBunches [MAX_POLYBUNCHES]; static CStaticShadow aStaticShadows [MAX_STATICSHADOWS]; static CPolyBunch *pEmptyBunchList; static CPermanentShadow aPermanentShadows[MAX_PERMAMENTSHADOWS]; -#else - static int16 &ShadowsStoredToBeRendered; - static CStoredShadow (&asShadowsStored) [MAX_STOREDSHADOWS]; - static CPolyBunch (&aPolyBunches) [MAX_POLYBUNCHES]; - static CStaticShadow (&aStaticShadows) [MAX_STATICSHADOWS]; - static CPolyBunch *&pEmptyBunchList; - static CPermanentShadow (&aPermanentShadows)[MAX_PERMAMENTSHADOWS]; -#endif static void Init (void); static void Shutdown (void); @@ -166,7 +157,7 @@ public: CVector *pPosn, float fFrontX, float fFrontY, float fSideX, float fSideY, int16 nIntensity, uint8 nRed, uint8 nGreen, uint8 nBlue, float fZDistance, float fScale, CPolyBunch **ppPolyBunch); static void UpdateStaticShadows (void); static void UpdatePermanentShadows (void); - static void CalcPedShadowValues (CVector vecLightDir, float *pfDisplacementX, float *pfDisplacementY, float *pfFrontX, float *pfFrontY, float *pfSideX, float *pfSideY); + static void CalcPedShadowValues (CVector vecLightDir, float *pfFrontX, float *pfFrontY, float *pfSideX, float *pfSideY, float *pfDisplacementX, float *pfDisplacementY); static void RenderExtraPlayerShadows (void); static void TidyUpShadows (void); static void RenderIndicatorShadow (uint32 nID, uint8 ShadowType, RwTexture *pTexture, CVector *pPosn, float fFrontX, float fFrontY, float fSideX, float fSideY, int16 nIntensity); From e14252914e9bd4cf7702479b5e0b050b935ba4aa Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?eray=20or=C3=A7unus?= Date: Mon, 3 Aug 2020 04:00:12 +0300 Subject: [PATCH 2/5] Squeeze performance option, minor fixes Fixes are already in miami --- src/control/RoadBlocks.cpp | 4 +++ src/core/Accident.cpp | 4 +++ src/core/Accident.h | 1 - src/core/Collision.h | 2 +- src/core/EventList.cpp | 8 ++++++ src/core/Game.cpp | 3 +++ src/core/Pad.cpp | 2 ++ src/core/World.cpp | 5 ++++ src/core/Zones.cpp | 5 ++++ src/core/config.h | 11 +++++++- src/core/main.cpp | 2 ++ src/peds/CopPed.cpp | 4 +-- src/peds/Population.cpp | 11 ++++++++ src/render/Fluff.cpp | 5 ++-- src/render/Font.h | 2 +- src/render/Renderer.cpp | 6 ++++- src/render/Rubbish.h | 4 +++ src/render/Sprite2d.cpp | 9 +++++++ src/weapons/BulletInfo.cpp | 39 ++++++++++++++++++++++++++-- src/weapons/ProjectileInfo.cpp | 46 ++++++++++++++++++++++++++++++++++ src/weapons/ShotInfo.cpp | 20 ++++++++++++++- 21 files changed, 181 insertions(+), 12 deletions(-) diff --git a/src/control/RoadBlocks.cpp b/src/control/RoadBlocks.cpp index ee9ec17e..86b4caf1 100644 --- a/src/control/RoadBlocks.cpp +++ b/src/control/RoadBlocks.cpp @@ -105,6 +105,10 @@ CRoadBlocks::GenerateRoadBlockCopsForCar(CVehicle* pVehicle, int32 roadBlockType void CRoadBlocks::GenerateRoadBlocks(void) { +#ifdef SQUEEZE_PERFORMANCE + if (FindPlayerPed()->m_pWanted->m_RoadblockDensity == 0) + return; +#endif CMatrix offsetMatrix; uint32 frame = CTimer::GetFrameCounter() & 0xF; int16 nRoadblockNode = (int16)(NUMROADBLOCKS * frame) / 16; diff --git a/src/core/Accident.cpp b/src/core/Accident.cpp index 1fd6c123..c8611323 100644 --- a/src/core/Accident.cpp +++ b/src/core/Accident.cpp @@ -53,6 +53,10 @@ CAccidentManager::ReportAccident(CPed *ped) void CAccidentManager::Update() { +#ifdef SQUEEZE_PERFORMANCE + // Handled after injury registered. + return; +#endif int32 e; if (CEventList::GetEvent(EVENT_INJURED_PED, &e)) { CPed *ped = CPools::GetPed(gaEvent[e].entityRef); diff --git a/src/core/Accident.h b/src/core/Accident.h index 949d5fb9..568e1149 100644 --- a/src/core/Accident.h +++ b/src/core/Accident.h @@ -1,5 +1,4 @@ #pragma once -#include "common.h" #include "config.h" class CPed; diff --git a/src/core/Collision.h b/src/core/Collision.h index d988f0c2..367ffa29 100644 --- a/src/core/Collision.h +++ b/src/core/Collision.h @@ -4,7 +4,7 @@ #include "Game.h" // for eLevelName // If you spawn many tanks at once, you will see that collisions of two entity exceeds 32. -#ifdef FIX_BUGS +#if defined(FIX_BUGS) && !defined(SQUEEZE_PERFORMANCE) #define MAX_COLLISION_POINTS 64 #else #define MAX_COLLISION_POINTS 32 diff --git a/src/core/EventList.cpp b/src/core/EventList.cpp index 675040ea..8d69ba78 100644 --- a/src/core/EventList.cpp +++ b/src/core/EventList.cpp @@ -8,6 +8,7 @@ #include "Messages.h" #include "Text.h" #include "main.h" +#include "Accident.h" int32 CEventList::ms_nFirstFreeSlotIndex; CEvent gaEvent[NUMEVENTS]; @@ -63,6 +64,13 @@ CEventList::RegisterEvent(eEventType type, eEventEntity entityType, CEntity *ent int ref; bool copsDontCare; +#ifdef SQUEEZE_PERFORMANCE + if (type == EVENT_INJURED_PED) { + gAccidentManager.ReportAccident((CPed*)ent); + return; + } +#endif + copsDontCare = false; switch(entityType){ case EVENT_ENTITY_PED: diff --git a/src/core/Game.cpp b/src/core/Game.cpp index 82e6992d..08623c65 100644 --- a/src/core/Game.cpp +++ b/src/core/Game.cpp @@ -106,6 +106,7 @@ int gameTxdSlot; bool DoRWStuffStartOfFrame(int16 TopRed, int16 TopGreen, int16 TopBlue, int16 BottomRed, int16 BottomGreen, int16 BottomBlue, int16 Alpha); void DoRWStuffEndOfFrame(void); +#ifdef PS2_MENU void MessageScreen(char *msg) { //TODO: stretch_screen @@ -139,6 +140,7 @@ void MessageScreen(char *msg) DoRWStuffEndOfFrame(); } +#endif bool CGame::InitialiseOnceBeforeRW(void) @@ -431,6 +433,7 @@ bool CGame::Initialise(const char* datFile) if ( !TheMemoryCard.m_bWantToLoad ) { #endif + LoadingScreen("Loading the Game", "Start script", nil); CTheScripts::StartTestScript(); CTheScripts::Process(); TheCamera.Process(); diff --git a/src/core/Pad.cpp b/src/core/Pad.cpp index 7df548aa..d4ffc5ea 100644 --- a/src/core/Pad.cpp +++ b/src/core/Pad.cpp @@ -1104,7 +1104,9 @@ void CPad::UpdatePads(void) if ( bUpdate ) { GetPad(0)->Update(0); +#ifndef SQUEEZE_PERFORMANCE GetPad(1)->Update(0); +#endif } #if defined(MASTER) && !defined(XINPUT) diff --git a/src/core/World.cpp b/src/core/World.cpp index 9f384048..7f8d8994 100644 --- a/src/core/World.cpp +++ b/src/core/World.cpp @@ -1941,6 +1941,11 @@ CWorld::Process(void) } else { for(CPtrNode *node = ms_listMovingEntityPtrs.first; node; node = node->next) { CEntity *movingEnt = (CEntity *)node->item; +#ifdef SQUEEZE_PERFORMANCE + if (movingEnt->bRemoveFromWorld) { + RemoveEntityInsteadOfProcessingIt(movingEnt); + } else +#endif if(movingEnt->m_rwObject && RwObjectGetType(movingEnt->m_rwObject) == rpCLUMP && RpAnimBlendClumpGetFirstAssociation(movingEnt->GetClump())) { RpAnimBlendClumpUpdateAnimations(movingEnt->GetClump(), diff --git a/src/core/Zones.cpp b/src/core/Zones.cpp index 1556731b..2e3e0f6e 100644 --- a/src/core/Zones.cpp +++ b/src/core/Zones.cpp @@ -7,6 +7,7 @@ #include "Clock.h" #include "Text.h" #include "World.h" +#include "Timer.h" eLevelName CTheZones::m_CurrLevel; CZone *CTheZones::m_pPlayersZone; @@ -122,6 +123,10 @@ CTheZones::Init(void) void CTheZones::Update(void) { +#ifdef SQUEEZE_PERFORMANCE + if (CTimer::GetFrameCounter() % 5 != 0) + return; +#endif CVector pos; pos = FindPlayerCoors(); m_pPlayersZone = FindSmallestZonePosition(&pos); diff --git a/src/core/config.h b/src/core/config.h index 94a35782..e1e11fe9 100644 --- a/src/core/config.h +++ b/src/core/config.h @@ -282,4 +282,13 @@ enum Config { #ifndef AUDIO_OAL // is not working yet for openal #define AUDIO_CACHE // cache sound lengths to speed up the cold boot #endif -//#define PS2_AUDIO // changes audio paths for cutscenes and radio to PS2 paths, needs vbdec to support VB with MSS \ No newline at end of file +//#define PS2_AUDIO // changes audio paths for cutscenes and radio to PS2 paths, needs vbdec to support VB with MSS + + +//#define SQUEEZE_PERFORMANCE +#ifdef SQUEEZE_PERFORMANCE + #undef PS2_ALPHA_TEST + #undef NO_ISLAND_LOADING + #define PC_PARTICLE + #define VC_PED_PORTS // To not process collisions always. But should be tested if that's really beneficial +#endif \ No newline at end of file diff --git a/src/core/main.cpp b/src/core/main.cpp index a1c64a6d..b63688ec 100644 --- a/src/core/main.cpp +++ b/src/core/main.cpp @@ -816,7 +816,9 @@ RenderScene(void) DefinedState(); CWaterLevel::RenderWater(); CRenderer::RenderFadingInEntities(); +#ifndef SQUEEZE_PERFORMANCE CRenderer::RenderVehiclesButNotBoats(); +#endif CWeather::RenderRainStreaks(); } diff --git a/src/peds/CopPed.cpp b/src/peds/CopPed.cpp index 6d106b0e..f289697e 100644 --- a/src/peds/CopPed.cpp +++ b/src/peds/CopPed.cpp @@ -45,7 +45,7 @@ CCopPed::CCopPed(eCopType copType) : CPed(PEDTYPE_COP) SetCurrentWeapon(WEAPONTYPE_UZI); m_fArmour = 50.0f; m_wepSkills = 32; /* TODO: what is this? seems unused */ - m_wepAccuracy = 64; + m_wepAccuracy = 68; break; case COP_ARMY: SetModelIndex(MI_ARMY); @@ -479,7 +479,7 @@ CCopPed::CopAI(void) SetAttack(playerOrHisVeh); SetShootTimer(CGeneral::GetRandomNumberInRange(500, 1000)); } - SetAttackTimer(CGeneral::GetRandomNumberInRange(100, 300)); + SetAttackTimer(CGeneral::GetRandomNumberInRange(200, 300)); } SetMoveState(PEDMOVE_STILL); } diff --git a/src/peds/Population.cpp b/src/peds/Population.cpp index 1357907d..0756df38 100644 --- a/src/peds/Population.cpp +++ b/src/peds/Population.cpp @@ -1104,7 +1104,11 @@ CPopulation::ManagePopulation(void) } int pedPoolSize = CPools::GetPedPool()->GetSize(); +#ifndef SQUEEZE_PERFORMANCE for (int poolIndex = pedPoolSize-1; poolIndex >= 0; poolIndex--) { +#else + for (int poolIndex = (pedPoolSize * (frameMod32 + 1) / 32) - 1; poolIndex >= pedPoolSize * frameMod32 / 32; poolIndex--) { +#endif CPed *ped = CPools::GetPedPool()->GetSlot(poolIndex); if (ped && !ped->IsPlayer() && ped->CanBeDeleted() && !ped->bInVehicle) { @@ -1117,6 +1121,13 @@ CPopulation::ManagePopulation(void) } float dist = (ped->GetPosition() - playerPos).Magnitude2D(); +#ifdef SQUEEZE_PERFORMANCE + if (dist > 50.f) + ped->bUsesCollision = false; + else + ped->bUsesCollision = true; +#endif + bool pedIsFarAway = false; if (PedCreationDistMultiplier() * (PED_REMOVE_DIST_SPECIAL * TheCamera.GenerationDistMultiplier) < dist || (!ped->bCullExtraFarAway && PedCreationDistMultiplier() * PED_REMOVE_DIST * TheCamera.GenerationDistMultiplier < dist) diff --git a/src/render/Fluff.cpp b/src/render/Fluff.cpp index f86801bf..690a1d3f 100644 --- a/src/render/Fluff.cpp +++ b/src/render/Fluff.cpp @@ -152,9 +152,9 @@ void CMovingThings::Shutdown() void CMovingThings::Update() { - const int TIME_SPAN = 64; // frames to process all aMovingThings - int16 i; +#ifndef SQUEEZE_PERFORMANCE + const int TIME_SPAN = 64; // frames to process all aMovingThings int block = CTimer::GetFrameCounter() % TIME_SPAN; @@ -167,6 +167,7 @@ void CMovingThings::Update() if (aMovingThings[i].m_nHidden == 0) aMovingThings[i].Update(); } +#endif for (i = 0; i < ARRAY_SIZE(aScrollBars); ++i) { diff --git a/src/render/Font.h b/src/render/Font.h index 9b4e7132..48f5703d 100644 --- a/src/render/Font.h +++ b/src/render/Font.h @@ -68,8 +68,8 @@ class CFont static int16 Size[MAX_FONTS][193]; #endif static int16 NewLine; - static CSprite2d Sprite[MAX_FONTS]; public: + static CSprite2d Sprite[MAX_FONTS]; static CFontDetails Details; static void Initialise(void); diff --git a/src/render/Renderer.cpp b/src/render/Renderer.cpp index 88d412c9..717021a7 100644 --- a/src/render/Renderer.cpp +++ b/src/render/Renderer.cpp @@ -73,8 +73,12 @@ CRenderer::PreRender(void) for(i = 0; i < ms_nNoOfVisibleEntities; i++) ms_aVisibleEntityPtrs[i]->PreRender(); - for(i = 0; i < ms_nNoOfInVisibleEntities; i++) + for (i = 0; i < ms_nNoOfInVisibleEntities; i++) { +#ifdef SQUEEZE_PERFORMANCE + if (ms_aInVisibleEntityPtrs[i]->IsVehicle() && ((CVehicle*)ms_aInVisibleEntityPtrs[i])->IsHeli()) +#endif ms_aInVisibleEntityPtrs[i]->PreRender(); + } for(node = CVisibilityPlugins::m_alphaEntityList.head.next; node != &CVisibilityPlugins::m_alphaEntityList.tail; diff --git a/src/render/Rubbish.h b/src/render/Rubbish.h index 2be592fe..37f895f3 100644 --- a/src/render/Rubbish.h +++ b/src/render/Rubbish.h @@ -4,7 +4,11 @@ class CVehicle; enum { // NB: not all values are allowed, check the code +#ifdef SQUEEZE_PERFORMANCE + NUM_RUBBISH_SHEETS = 32 +#else NUM_RUBBISH_SHEETS = 64 +#endif }; class COneSheet diff --git a/src/render/Sprite2d.cpp b/src/render/Sprite2d.cpp index 52b85018..453ed004 100644 --- a/src/render/Sprite2d.cpp +++ b/src/render/Sprite2d.cpp @@ -4,6 +4,7 @@ #include "Draw.h" #include "Camera.h" #include "Sprite2d.h" +#include "Font.h" RwIm2DVertex CSprite2d::maVertices[8]; float CSprite2d::RecipNearClip; @@ -27,14 +28,18 @@ CSprite2d::InitPerFrame(void) mCurrentBank = 0; for(i = 0; i < 10; i++) mCurrentSprite[i] = 0; +#ifndef SQUEEZE_PERFORMANCE for(i = 0; i < 10; i++) mpBankTextures[i] = nil; +#endif } int32 CSprite2d::GetBank(int32 n, RwTexture *tex) { +#ifndef SQUEEZE_PERFORMANCE mpBankTextures[mCurrentBank] = tex; +#endif mCurrentSprite[mCurrentBank] = 0; mBankStart[mCurrentBank+1] = mBankStart[mCurrentBank] + n; return mCurrentBank++; @@ -59,8 +64,12 @@ CSprite2d::DrawBank(int32 bank) { if(mCurrentSprite[bank] == 0) return; +#ifndef SQUEEZE_PERFORMANCE RwRenderStateSet(rwRENDERSTATETEXTURERASTER, mpBankTextures[bank] ? RwTextureGetRaster(mpBankTextures[bank]) : nil); +#else + CFont::Sprite[bank].SetRenderState(); +#endif RwRenderStateSet(rwRENDERSTATEVERTEXALPHAENABLE, (void*)TRUE); RwRenderStateSet(rwRENDERSTATETEXTUREFILTER, (void*)rwFILTERLINEAR); RwIm2DRenderPrimitive(rwPRIMTYPETRILIST, &maBankVertices[6*mBankStart[bank]], 6*mCurrentSprite[bank]); diff --git a/src/weapons/BulletInfo.cpp b/src/weapons/BulletInfo.cpp index 26fc459d..15dde011 100644 --- a/src/weapons/BulletInfo.cpp +++ b/src/weapons/BulletInfo.cpp @@ -24,6 +24,10 @@ #include "World.h" #include "SurfaceTable.h" +#ifdef SQUEEZE_PERFORMANCE +uint32 bulletInfoInUse; +#endif + #define BULLET_LIFETIME (1000) #define NUM_PED_BLOOD_PARTICLES (8) #define BLOOD_PARTICLE_OFFSET (CVector(0.0f, 0.0f, 0.0f)) @@ -47,6 +51,9 @@ void CBulletInfo::Initialise(void) gaBulletInfo[i].m_pSource = nil; } debug("CBulletInfo ready\n"); +#ifdef SQUEEZE_PERFORMANCE + bulletInfoInUse = 0; +#endif } void CBulletInfo::Shutdown(void) @@ -71,11 +78,19 @@ bool CBulletInfo::AddBullet(CEntity* pSource, eWeaponType type, CVector vecPosit gaBulletInfo[i].m_vecSpeed = vecSpeed; gaBulletInfo[i].m_fTimer = CTimer::GetTimeInMilliseconds() + BULLET_LIFETIME; gaBulletInfo[i].m_bInUse = true; + +#ifdef SQUEEZE_PERFORMANCE + bulletInfoInUse++; +#endif return true; } void CBulletInfo::Update(void) { +#ifdef SQUEEZE_PERFORMANCE + if (bulletInfoInUse == 0) + return; +#endif bool bAddSound = true; bPlayerSniperBullet = false; for (int i = 0; i < NUM_BULLETS; i++) { @@ -84,8 +99,12 @@ void CBulletInfo::Update(void) pBullet->m_pSource = nil; if (!pBullet->m_bInUse) continue; - if (CTimer::GetTimeInMilliseconds() > pBullet->m_fTimer) + if (CTimer::GetTimeInMilliseconds() > pBullet->m_fTimer) { pBullet->m_bInUse = false; +#ifdef SQUEEZE_PERFORMANCE + bulletInfoInUse--; +#endif + } CVector vecOldPos = pBullet->m_vecPosition; CVector vecNewPos = pBullet->m_vecPosition + pBullet->m_vecSpeed * CTimer::GetTimeStep() * 0.5f; CWorld::bIncludeCarTyres = true; @@ -108,6 +127,9 @@ void CBulletInfo::Update(void) pPed->InflictDamage(pBullet->m_pSource, pBullet->m_eWeaponType, pBullet->m_nDamage, (ePedPieceTypes)point.pieceB, pPed->GetLocalDirection(pPed->GetPosition() - point.point)); CEventList::RegisterEvent(pPed->m_nPedType == PEDTYPE_COP ? EVENT_SHOOT_COP : EVENT_SHOOT_PED, EVENT_ENTITY_PED, pPed, (CPed*)pBullet->m_pSource, 1000); pBullet->m_bInUse = false; +#ifdef SQUEEZE_PERFORMANCE + bulletInfoInUse--; +#endif vecNewPos = point.point; } else { @@ -134,6 +156,9 @@ void CBulletInfo::Update(void) } } pBullet->m_bInUse = false; +#ifdef SQUEEZE_PERFORMANCE + bulletInfoInUse--; +#endif vecNewPos = point.point; } } @@ -148,6 +173,9 @@ void CBulletInfo::Update(void) } #ifdef FIX_BUGS pBullet->m_bInUse = false; +#ifdef SQUEEZE_PERFORMANCE + bulletInfoInUse--; +#endif vecNewPos = point.point; #endif } @@ -167,6 +195,9 @@ void CBulletInfo::Update(void) } #ifdef FIX_BUGS pBullet->m_bInUse = false; +#ifdef SQUEEZE_PERFORMANCE + bulletInfoInUse--; +#endif vecNewPos = point.point; #endif } @@ -217,8 +248,12 @@ void CBulletInfo::Update(void) } pBullet->m_vecPosition = vecNewPos; if (pBullet->m_vecPosition.x < -MAP_BORDER || pBullet->m_vecPosition.x > MAP_BORDER || - pBullet->m_vecPosition.y < -MAP_BORDER || pBullet->m_vecPosition.y > MAP_BORDER) + pBullet->m_vecPosition.y < -MAP_BORDER || pBullet->m_vecPosition.y > MAP_BORDER) { pBullet->m_bInUse = false; +#ifdef SQUEEZE_PERFORMANCE + bulletInfoInUse--; +#endif + } } } diff --git a/src/weapons/ProjectileInfo.cpp b/src/weapons/ProjectileInfo.cpp index 47bc65ac..b56e3a29 100644 --- a/src/weapons/ProjectileInfo.cpp +++ b/src/weapons/ProjectileInfo.cpp @@ -13,6 +13,10 @@ #include "Weapon.h" #include "World.h" +#ifdef SQUEEZE_PERFORMANCE +uint32 projectileInUse; +#endif + CProjectileInfo gaProjectileInfo[NUM_PROJECTILES]; CProjectile *CProjectileInfo::ms_apProjectile[NUM_PROJECTILES]; @@ -30,6 +34,10 @@ CProjectileInfo::Initialise() } debug("CProjectileInfo ready\n"); + +#ifdef SQUEEZE_PERFORMANCE + projectileInUse = 0; +#endif } void @@ -154,6 +162,10 @@ CProjectileInfo::AddProjectile(CEntity *entity, eWeaponType weapon, CVector pos, ms_apProjectile[i]->m_fElasticity = elasticity; ms_apProjectile[i]->m_nSpecialCollisionResponseCases = SpecialCollisionResponseCase; +#ifdef SQUEEZE_PERFORMANCE + projectileInUse++; +#endif + gaProjectileInfo[i].m_bInUse = true; CWorld::Add(ms_apProjectile[i]); @@ -165,6 +177,9 @@ void CProjectileInfo::RemoveProjectile(CProjectileInfo *info, CProjectile *projectile) { RemoveNotAdd(info->m_pSource, info->m_eWeaponType, projectile->GetPosition()); +#ifdef SQUEEZE_PERFORMANCE + projectileInUse--; +#endif info->m_bInUse = false; CWorld::Remove(projectile); @@ -192,6 +207,11 @@ CProjectileInfo::RemoveNotAdd(CEntity *entity, eWeaponType weaponType, CVector p void CProjectileInfo::Update() { +#ifdef SQUEEZE_PERFORMANCE + if (projectileInUse == 0) + return; +#endif + for (int i = 0; i < ARRAY_SIZE(gaProjectileInfo); i++) { if (!gaProjectileInfo[i].m_bInUse) continue; @@ -200,6 +220,10 @@ CProjectileInfo::Update() gaProjectileInfo[i].m_pSource = nil; if (ms_apProjectile[i] == nil) { +#ifdef SQUEEZE_PERFORMANCE + projectileInUse--; +#endif + gaProjectileInfo[i].m_bInUse = false; continue; } @@ -252,6 +276,10 @@ CProjectileInfo::IsProjectileInRange(float x1, float x2, float y1, float y2, flo if (pos.x >= x1 && pos.x <= x2 && pos.y >= y1 && pos.y <= y2 && pos.z >= z1 && pos.z <= z2) { result = true; if (remove) { +#ifdef SQUEEZE_PERFORMANCE + projectileInUse--; +#endif + gaProjectileInfo[i].m_bInUse = false; CWorld::Remove(ms_apProjectile[i]); delete ms_apProjectile[i]; @@ -266,8 +294,17 @@ CProjectileInfo::IsProjectileInRange(float x1, float x2, float y1, float y2, flo void CProjectileInfo::RemoveAllProjectiles() { +#ifdef SQUEEZE_PERFORMANCE + if (projectileInUse == 0) + return; +#endif + for (int i = 0; i < ARRAY_SIZE(ms_apProjectile); i++) { if (gaProjectileInfo[i].m_bInUse) { +#ifdef SQUEEZE_PERFORMANCE + projectileInUse--; +#endif + gaProjectileInfo[i].m_bInUse = false; CWorld::Remove(ms_apProjectile[i]); delete ms_apProjectile[i]; @@ -278,12 +315,21 @@ CProjectileInfo::RemoveAllProjectiles() bool CProjectileInfo::RemoveIfThisIsAProjectile(CObject *object) { +#ifdef SQUEEZE_PERFORMANCE + if (projectileInUse == 0) + return false; +#endif + int i = 0; while (ms_apProjectile[i++] != object) { if (i >= ARRAY_SIZE(ms_apProjectile)) return false; } +#ifdef SQUEEZE_PERFORMANCE + projectileInUse--; +#endif + gaProjectileInfo[i].m_bInUse = false; CWorld::Remove(ms_apProjectile[i]); delete ms_apProjectile[i]; diff --git a/src/weapons/ShotInfo.cpp b/src/weapons/ShotInfo.cpp index f09ae052..c0ab9ac1 100644 --- a/src/weapons/ShotInfo.cpp +++ b/src/weapons/ShotInfo.cpp @@ -13,6 +13,9 @@ CShotInfo gaShotInfo[NUMSHOTINFOS]; float CShotInfo::ms_afRandTable[20]; +#ifdef SQUEEZE_PERFORMANCE +uint32 shotInfoInUse; +#endif /* Used for flamethrower. I don't know why it's name is CShotInfo. @@ -41,6 +44,9 @@ CShotInfo::Initialise() nextVal += 0.005f; } debug("CShotInfo ready\n"); +#ifdef SQUEEZE_PERFORMANCE + shotInfoInUse = 0; +#endif } bool @@ -54,6 +60,10 @@ CShotInfo::AddShot(CEntity *sourceEntity, eWeaponType weapon, CVector startPos, if (slot == ARRAY_SIZE(gaShotInfo)) return false; +#ifdef SQUEEZE_PERFORMANCE + shotInfoInUse++; +#endif + gaShotInfo[slot].m_inUse = true; gaShotInfo[slot].m_weapon = weapon; gaShotInfo[slot].m_startPos = startPos; @@ -87,6 +97,10 @@ CShotInfo::Shutdown() void CShotInfo::Update() { +#ifdef SQUEEZE_PERFORMANCE + if (shotInfoInUse == 0) + return; +#endif for (int slot = 0; slot < ARRAY_SIZE(gaShotInfo); slot++) { CShotInfo &shot = gaShotInfo[slot]; if (shot.m_sourceEntity && shot.m_sourceEntity->IsPed() && !((CPed*)shot.m_sourceEntity)->IsPointerValid()) @@ -96,8 +110,12 @@ CShotInfo::Update() continue; CWeaponInfo *weaponInfo = CWeaponInfo::GetWeaponInfo(shot.m_weapon); - if (CTimer::GetTimeInMilliseconds() > shot.m_timeout) + if (CTimer::GetTimeInMilliseconds() > shot.m_timeout) { +#ifdef SQUEEZE_PERFORMANCE + shotInfoInUse--; +#endif shot.m_inUse = false; + } if (weaponInfo->m_bSlowsDown) shot.m_areaAffected *= pow(0.96, CTimer::GetTimeStep()); // FRAMERATE From 4b3faea9659c0d34925a8a296c4a8ee07233e788 Mon Sep 17 00:00:00 2001 From: Sergeanur Date: Mon, 3 Aug 2020 17:04:00 +0300 Subject: [PATCH 3/5] Update mpg123.32 --- mpg123.32/dist/libmpg123-0.dll | Bin 0 -> 343552 bytes mpg123.32/dist/libmpg123.dll | Bin 150528 -> 0 bytes mpg123.32/include/fmt123.h | 159 +++ mpg123.32/include/mpg123.h | 1205 +++++++++++++---- mpg123.32/lib/libmpg123-0.lib | Bin 0 -> 34076 bytes mpg123.32/lib/libmpg123.lib | Bin 19996 -> 0 bytes .../dist/{libmpg123.dll => libmpg123-0.dll} | Bin .../lib/{libmpg123.lib => libmpg123-0.lib} | Bin src/audio/oal/stream.cpp | 7 +- 9 files changed, 1094 insertions(+), 277 deletions(-) create mode 100644 mpg123.32/dist/libmpg123-0.dll delete mode 100644 mpg123.32/dist/libmpg123.dll create mode 100644 mpg123.32/include/fmt123.h create mode 100644 mpg123.32/lib/libmpg123-0.lib delete mode 100644 mpg123.32/lib/libmpg123.lib rename mpg123.64/dist/{libmpg123.dll => libmpg123-0.dll} (100%) rename mpg123.64/lib/{libmpg123.lib => libmpg123-0.lib} (100%) diff --git a/mpg123.32/dist/libmpg123-0.dll b/mpg123.32/dist/libmpg123-0.dll new file mode 100644 index 0000000000000000000000000000000000000000..07bfef0c4b73622345bef2c10f09c1c1c3e3a149 GIT binary patch literal 343552 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 $0YF=P;c8Akv|D>GSN;Hz3rZ5Zxq*4#S5AjPmL+ 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 KasD6h`~LtO0y2yM literal 0 HcmV?d00001 diff --git a/mpg123.32/dist/libmpg123.dll b/mpg123.32/dist/libmpg123.dll deleted file mode 100644 index ccb429bfe781aad06c9d39d919e501346e7c85d4..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 150528 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 + /** \file mpg123.h The header file for the libmpg123 MPEG Audio decoder */ -/* A macro to check at compile time which set of API functions to expect. - This should be incremented at least each time a new symbol is added to the header. */ -#define MPG123_API_VERSION 29 +/** A macro to check at compile time which set of API functions to expect. + * This should be incremented at least each time a new symbol is added + * to the header. + */ +#define MPG123_API_VERSION 45 -/* These aren't actually in use... seems to work without using libtool. */ +#ifndef MPG123_EXPORT +/** Defines needed for MS Visual Studio(tm) DLL builds. + * Every public function must be prefixed with MPG123_EXPORT. When building + * the DLL ensure to define BUILD_MPG123_DLL. This makes the function accessible + * for clients and includes it in the import library which is created together + * with the DLL. When consuming the DLL ensure to define LINK_MPG123_DLL which + * imports the functions from the DLL. + */ #ifdef BUILD_MPG123_DLL /* The dll exports. */ -#define EXPORT __declspec(dllexport) +#define MPG123_EXPORT __declspec(dllexport) #else #ifdef LINK_MPG123_DLL /* The exe imports. */ -#define EXPORT __declspec(dllimport) +#define MPG123_EXPORT __declspec(dllimport) #else /* Nothing on normal/UNIX builds */ -#define EXPORT +#define MPG123_EXPORT #endif #endif +#endif + +/* This is for Visual Studio, so this header works as distributed in the binary downloads */ +#if defined(_MSC_VER) && !defined(MPG123_DEF_SSIZE_T) +#define MPG123_DEF_SSIZE_T +#include +typedef ptrdiff_t ssize_t; +#endif #ifndef MPG123_NO_CONFIGURE /* Enable use of this file without configure. */ #include @@ -63,6 +83,7 @@ #endif #define MPG123_LARGENAME(func) MPG123_MACROCAT(func, MPG123_LARGESUFFIX) +#define mpg123_open_fixed MPG123_LARGENAME(mpg123_open_fixed) #define mpg123_open MPG123_LARGENAME(mpg123_open) #define mpg123_open_fd MPG123_LARGENAME(mpg123_open_fd) #define mpg123_open_handle MPG123_LARGENAME(mpg123_open_handle) @@ -79,9 +100,11 @@ #define mpg123_set_index MPG123_LARGENAME(mpg123_set_index) #define mpg123_position MPG123_LARGENAME(mpg123_position) #define mpg123_length MPG123_LARGENAME(mpg123_length) +#define mpg123_framelength MPG123_LARGENAME(mpg123_framelength) #define mpg123_set_filesize MPG123_LARGENAME(mpg123_set_filesize) #define mpg123_replace_reader MPG123_LARGENAME(mpg123_replace_reader) #define mpg123_replace_reader_handle MPG123_LARGENAME(mpg123_replace_reader_handle) +#define mpg123_framepos MPG123_LARGENAME(mpg123_framepos) #endif /* largefile hackery */ @@ -109,31 +132,47 @@ struct mpg123_handle_struct; typedef struct mpg123_handle_struct mpg123_handle; /** Function to initialise the mpg123 library. - * This function is not thread-safe. Call it exactly once per process, before any other (possibly threaded) work with the library. + * This should be called once in a non-parallel context. It is not explicitly + * thread-safe, but repeated/concurrent calls still _should_ be safe as static + * tables are filled with the same values anyway. * * \return MPG123_OK if successful, otherwise an error number. */ -EXPORT int mpg123_init(void); +MPG123_EXPORT int mpg123_init(void); -/** Function to close down the mpg123 library. - * This function is not thread-safe. Call it exactly once per process, before any other (possibly threaded) work with the library. */ -EXPORT void mpg123_exit(void); +/** Superfluous Function to close down the mpg123 library. + * This was created with the thought that there sometime will be cleanup code + * to be run after library use. This never materialized. You can forget about + * this function and it is only here for old programs that do call it. + */ +MPG123_EXPORT void mpg123_exit(void); /** Create a handle with optional choice of decoder (named by a string, see mpg123_decoders() or mpg123_supported_decoders()). * and optional retrieval of an error code to feed to mpg123_plain_strerror(). * Optional means: Any of or both the parameters may be NULL. * - * \return Non-NULL pointer when successful. + * \param decoder optional choice of decoder variant (NULL for default) + * \param error optional address to store error codes + * \return Non-NULL pointer to fresh handle when successful. */ -EXPORT mpg123_handle *mpg123_new(const char* decoder, int *error); +MPG123_EXPORT mpg123_handle *mpg123_new(const char* decoder, int *error); -/** Delete handle, mh is either a valid mpg123 handle or NULL. */ -EXPORT void mpg123_delete(mpg123_handle *mh); +/** Delete handle, mh is either a valid mpg123 handle or NULL. + * \param mh handle + */ +MPG123_EXPORT void mpg123_delete(mpg123_handle *mh); + +/** Free plain memory allocated within libmpg123. + * This is for library users that are not sure to use the same underlying + * memory allocator as libmpg123. It is just a wrapper over free() in + * the underlying C library. + */ +MPG123_EXPORT void mpg123_free(void *ptr); /** Enumeration of the parameters types that it is possible to set/get. */ enum mpg123_parms { - MPG123_VERBOSE, /**< set verbosity value for enabling messages to stderr, >= 0 makes sense (integer) */ + MPG123_VERBOSE = 0, /**< set verbosity value for enabling messages to stderr, >= 0 makes sense (integer) */ MPG123_FLAGS, /**< set all flags, p.ex val = MPG123_GAPLESS|MPG123_MONO_MIX (integer) */ MPG123_ADD_FLAGS, /**< add some flags (integer) */ MPG123_FORCE_RATE, /**< when value > 0, force output rate to that value (integer) */ @@ -143,13 +182,21 @@ enum mpg123_parms MPG123_UPSPEED, /**< play every Nth frame (integer) */ MPG123_START_FRAME, /**< start with this frame (skip frames before that, integer) */ MPG123_DECODE_FRAMES, /**< decode only this number of frames (integer) */ - MPG123_ICY_INTERVAL, /**< stream contains ICY metadata with this interval (integer) */ + MPG123_ICY_INTERVAL, /**< Stream contains ICY metadata with this interval (integer). + Make sure to set this _before_ opening a stream.*/ MPG123_OUTSCALE, /**< the scale for output samples (amplitude - integer or float according to mpg123 output format, normally integer) */ MPG123_TIMEOUT, /**< timeout for reading from a stream (not supported on win32, integer) */ MPG123_REMOVE_FLAGS, /**< remove some flags (inverse of MPG123_ADD_FLAGS, integer) */ - MPG123_RESYNC_LIMIT, /**< Try resync on frame parsing for that many bytes or until end of stream (<0 ... integer). */ + MPG123_RESYNC_LIMIT, /**< Try resync on frame parsing for that many bytes or until end of stream (<0 ... integer). This can enlarge the limit for skipping junk on beginning, too (but not reduce it). */ MPG123_INDEX_SIZE /**< Set the frame index size (if supported). Values <0 mean that the index is allowed to grow dynamically in these steps (in positive direction, of course) -- Use this when you really want a full index with every individual frame. */ ,MPG123_PREFRAMES /**< Decode/ignore that many frames in advance for layer 3. This is needed to fill bit reservoir after seeking, for example (but also at least one frame in advance is needed to have all "normal" data for layer 3). Give a positive integer value, please.*/ + ,MPG123_FEEDPOOL /**< For feeder mode, keep that many buffers in a pool to avoid frequent malloc/free. The pool is allocated on mpg123_open_feed(). If you change this parameter afterwards, you can trigger growth and shrinkage during decoding. The default value could change any time. If you care about this, then set it. (integer) */ + ,MPG123_FEEDBUFFER /**< Minimal size of one internal feeder buffer, again, the default value is subject to change. (integer) */ + ,MPG123_FREEFORMAT_SIZE /**< Tell the parser a free-format frame size to + * avoid read-ahead to get it. A value of -1 (default) means that the parser + * will determine it. The parameter value is applied during decoder setup + * for a freshly opened stream only. + */ }; /** Flag bits for MPG123_FLAGS, use the usual binary or to combine. */ @@ -170,6 +217,47 @@ enum mpg123_param_flags ,MPG123_PLAIN_ID3TEXT = 0x800 /**< 100000000000 Do not translate ID3 text data to UTF-8. ID3 strings will contain the raw text data, with the first byte containing the ID3 encoding code. */ ,MPG123_IGNORE_STREAMLENGTH = 0x1000 /**< 1000000000000 Ignore any stream length information contained in the stream, which can be contained in a 'TLEN' frame of an ID3v2 tag or a Xing tag */ ,MPG123_SKIP_ID3V2 = 0x2000 /**< 10 0000 0000 0000 Do not parse ID3v2 tags, just skip them. */ + ,MPG123_IGNORE_INFOFRAME = 0x4000 /**< 100 0000 0000 0000 Do not parse the LAME/Xing info frame, treat it as normal MPEG data. */ + ,MPG123_AUTO_RESAMPLE = 0x8000 /**< 1000 0000 0000 0000 Allow automatic internal resampling of any kind (default on if supported). Especially when going lowlevel with replacing output buffer, you might want to unset this flag. Setting MPG123_DOWNSAMPLE or MPG123_FORCE_RATE will override this. */ + ,MPG123_PICTURE = 0x10000 /**< 17th bit: Enable storage of pictures from tags (ID3v2 APIC). */ + ,MPG123_NO_PEEK_END = 0x20000 /**< 18th bit: Do not seek to the end of + * the stream in order to probe + * the stream length and search for the id3v1 field. This also means + * the file size is unknown unless set using mpg123_set_filesize() and + * the stream is assumed as non-seekable unless overridden. + */ + ,MPG123_FORCE_SEEKABLE = 0x40000 /**< 19th bit: Force the stream to be seekable. */ + ,MPG123_STORE_RAW_ID3 = 0x80000 /**< store raw ID3 data (even if skipping) */ + ,MPG123_FORCE_ENDIAN = 0x100000 /**< Enforce endianess of output samples. + * This is not reflected in the format codes. If this flag is set along with + * MPG123_BIG_ENDIAN, MPG123_ENC_SIGNED16 means s16be, without + * MPG123_BIG_ENDIAN, it means s16le. Normal operation without + * MPG123_FORCE_ENDIAN produces output in native byte order. + */ + ,MPG123_BIG_ENDIAN = 0x200000 /**< Choose big endian instead of little. */ + ,MPG123_NO_READAHEAD = 0x400000 /**< Disable read-ahead in parser. If + * you know you provide full frames to the feeder API, this enables + * decoder output from the first one on, instead of having to wait for + * the next frame to confirm that the stream is healthy. It also disables + * free format support unless you provide a frame size using + * MPG123_FREEFORMAT_SIZE. + */ + ,MPG123_FLOAT_FALLBACK = 0x800000 /**< Consider floating point output encoding only after + * trying other (possibly downsampled) rates and encodings first. This is to + * support efficient playback where floating point output is only configured for + * an external resampler, bypassing that resampler when the desired rate can + * be produced directly. This is enabled by default to be closer to older versions + * of libmpg123 which did not enable float automatically at all. If disabled, + * float is considered after the 16 bit default and higher-bit integer encodings + * for any rate. */ + ,MPG123_NO_FRANKENSTEIN = 0x1000000 /**< Disable support for Frankenstein streams + * (different MPEG streams stiched together). Do not accept serious change of MPEG + * header inside a single stream. With this flag, the audio output format cannot + * change during decoding unless you open a new stream. This also stops decoding + * after an announced end of stream (Info header contained a number of frames + * and this number has been reached). This makes your MP3 files behave more like + * ordinary media files with defined structure, rather than stream dumps with + * some sugar. */ }; /** choices for MPG123_RVA */ @@ -181,15 +269,27 @@ enum mpg123_param_rva ,MPG123_RVA_MAX = MPG123_RVA_ALBUM /**< The maximum RVA code, may increase in future. */ }; -/* TODO: Assess the possibilities and troubles of changing parameters during playback. */ - /** Set a specific parameter, for a specific mpg123_handle, using a parameter - * type key chosen from the mpg123_parms enumeration, to the specified value. */ -EXPORT int mpg123_param(mpg123_handle *mh, enum mpg123_parms type, long value, double fvalue); + * type key chosen from the mpg123_parms enumeration, to the specified value. + * \param mh handle + * \param type parameter choice + * \param value integer value + * \param fvalue floating point value + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_param( mpg123_handle *mh +, enum mpg123_parms type, long value, double fvalue ); /** Get a specific parameter, for a specific mpg123_handle. - * See the mpg123_parms enumeration for a list of available parameters. */ -EXPORT int mpg123_getparam(mpg123_handle *mh, enum mpg123_parms type, long *val, double *fval); + * See the mpg123_parms enumeration for a list of available parameters. + * \param mh handle + * \param type parameter choice + * \param value integer value return address + * \param fvalue floating point value return address + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_getparam( mpg123_handle *mh +, enum mpg123_parms type, long *value, double *fvalue ); /** Feature set available for query with mpg123_feature. */ enum mpg123_feature_set @@ -208,10 +308,28 @@ enum mpg123_feature_set ,MPG123_FEATURE_DECODE_NTOM /**< flexible rate decoding */ ,MPG123_FEATURE_PARSE_ICY /**< ICY support */ ,MPG123_FEATURE_TIMEOUT_READ /**< Reader with timeout (network). */ + ,MPG123_FEATURE_EQUALIZER /**< tunable equalizer */ + ,MPG123_FEATURE_MOREINFO /**< more info extraction (for frame analyzer) */ + ,MPG123_FEATURE_OUTPUT_FLOAT32 /**< 32 bit float output */ + ,MPG123_FEATURE_OUTPUT_FLOAT64 /**< 64 bit float output (usually never) */ }; -/** Query libmpg123 feature, 1 for success, 0 for unimplemented functions. */ -EXPORT int mpg123_feature(const enum mpg123_feature_set key); +/** Query libmpg123 features. + * \param key feature selection + * \return 1 for success, 0 for unimplemented functions + */ +MPG123_EXPORT int mpg123_feature(const enum mpg123_feature_set key); + +/** Query libmpg123 features with better ABI compatibility + * + * This is the same as mpg123_feature(), but this time not using + * the enum as argument. Compilers don't have to agree on the size of + * enums and hence they are not safe in public API. + * + * \param key feature selection + * \return 1 for success, 0 for unimplemented functions + */ +MPG123_EXPORT int mpg123_feature2(int key); /* @} */ @@ -221,9 +339,28 @@ EXPORT int mpg123_feature(const enum mpg123_feature_set key); * Functions to get text version of the error numbers and an enumeration * of the error codes returned by libmpg123. * - * Most functions operating on a mpg123_handle simply return MPG123_OK on success and MPG123_ERR on failure (setting the internal error variable of the handle to the specific error code). - * Decoding/seek functions may also return message codes MPG123_DONE, MPG123_NEW_FORMAT and MPG123_NEED_MORE (please read up on these on how to react!). - * The positive range of return values is used for "useful" values when appropriate. + * Most functions operating on a mpg123_handle simply return MPG123_OK (0) + * on success and MPG123_ERR (-1) on failure, setting the internal error + * variable of the handle to the specific error code. If there was not a valid + * (non-NULL) handle provided to a function operating on one, MPG123_BAD_HANDLE + * may be returned if this can not be confused with a valid positive return + * value. + * Meaning: A function expected to return positive integers on success will + * always indicate error or a special condition by returning a negative one. + * + * Decoding/seek functions may also return message codes MPG123_DONE, + * MPG123_NEW_FORMAT and MPG123_NEED_MORE (all negative, see below on how to + * react). Note that calls to those can be nested, so generally watch out + * for these codes after initial handle setup. + * Especially any function that needs information about the current stream + * to work will try to at least parse the beginning if that did not happen + * yet. + * + * On a function that is supposed to return MPG123_OK on success and + * MPG123_ERR on failure, make sure you check for != MPG123_OK, not + * == MPG123_ERR, as the error code could get more specific in future, + * or there is just a special message from a decoding routine as indicated + * above. * * @{ */ @@ -278,19 +415,29 @@ enum mpg123_errors ,MPG123_LSEEK_FAILED /**< Low-level seek failed. */ ,MPG123_BAD_CUSTOM_IO /**< Custom I/O not prepared. */ ,MPG123_LFS_OVERFLOW /**< Offset value overflow during translation of large file API calls -- your client program cannot handle that large file. */ + ,MPG123_INT_OVERFLOW /**< Some integer overflow. */ }; -/** Return a string describing that error errcode means. */ -EXPORT const char* mpg123_plain_strerror(int errcode); +/** Look up error strings given integer code. + * \param errcode integer error code + * \return string describing what that error error code means + */ +MPG123_EXPORT const char* mpg123_plain_strerror(int errcode); /** Give string describing what error has occured in the context of handle mh. * When a function operating on an mpg123 handle returns MPG123_ERR, you should check for the actual reason via * char *errmsg = mpg123_strerror(mh) - * This function will catch mh == NULL and return the message for MPG123_BAD_HANDLE. */ -EXPORT const char* mpg123_strerror(mpg123_handle *mh); + * This function will catch mh == NULL and return the message for MPG123_BAD_HANDLE. + * \param mh handle + * \return error message + */ +MPG123_EXPORT const char* mpg123_strerror(mpg123_handle *mh); -/** Return the plain errcode intead of a string. */ -EXPORT int mpg123_errcode(mpg123_handle *mh); +/** Return the plain errcode intead of a string. + * \param mh handle + * \return error code recorded in handle or MPG123_BAD_HANDLE + */ +MPG123_EXPORT int mpg123_errcode(mpg123_handle *mh); /*@}*/ @@ -303,21 +450,33 @@ EXPORT int mpg123_errcode(mpg123_handle *mh); * @{ */ -/** Return a NULL-terminated array of generally available decoder names (plain 8bit ASCII). */ -EXPORT const char **mpg123_decoders(void); +/** Get available decoder list. + * \return NULL-terminated array of generally available decoder names (plain 8bit ASCII) + */ +MPG123_EXPORT const char **mpg123_decoders(void); -/** Return a NULL-terminated array of the decoders supported by the CPU (plain 8bit ASCII). */ -EXPORT const char **mpg123_supported_decoders(void); +/** Get supported decoder list. + * \return NULL-terminated array of the decoders supported by the CPU (plain 8bit ASCII) + */ +MPG123_EXPORT const char **mpg123_supported_decoders(void); -/** Set the chosen decoder to 'decoder_name' */ -EXPORT int mpg123_decoder(mpg123_handle *mh, const char* decoder_name); +/** Set the active decoder. + * \param mh handle + * \param decoder_name name of decoder + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_decoder(mpg123_handle *mh, const char* decoder_name); -/** Get the currently active decoder engine name. - The active decoder engine can vary depening on output constraints, - mostly non-resampling, integer output is accelerated via 3DNow & Co. but for other modes a fallback engine kicks in. - Note that this can return a decoder that is ony active in the hidden and not available as decoder choice from the outside. - \return The decoder name or NULL on error. */ -EXPORT const char* mpg123_current_decoder(mpg123_handle *mh); +/** Get the currently active decoder name. + * The active decoder engine can vary depening on output constraints, + * mostly non-resampling, integer output is accelerated via 3DNow & Co. but for + * other modes a fallback engine kicks in. + * Note that this can return a decoder that is only active in the hidden and not + * available as decoder choice from the outside. + * \param mh handle + * \return The decoder name or NULL on error. + */ +MPG123_EXPORT const char* mpg123_current_decoder(mpg123_handle *mh); /*@}*/ @@ -326,100 +485,124 @@ EXPORT const char* mpg123_current_decoder(mpg123_handle *mh); * * Functions to get and select the format of the decoded audio. * + * Before you dive in, please be warned that you might get confused by this. + * This seems to happen a lot, therefore I am trying to explain in advance. + * If you do feel confused and just want to decode your normal MPEG audio files that + * don't alter properties in the middle, just use mpg123_open_fixed() with a fixed encoding + * and channel count and forget about a matrix of audio formats. If you want to get funky, + * read ahead ... + * + * The mpg123 library decides what output format to use when encountering the first frame in a stream, or actually any frame that is still valid but differs from the frames before in the prompted output format. At such a deciding point, an internal table of allowed encodings, sampling rates and channel setups is consulted. According to this table, an output format is chosen and the decoding engine set up accordingly (including optimized routines for different output formats). This might seem unusual but it just follows from the non-existence of "MPEG audio files" with defined overall properties. There are streams, streams are concatenations of (semi) independent frames. We store streams on disk and call them "MPEG audio files", but that does not change their nature as the decoder is concerned (the LAME/Xing header for gapless decoding makes things interesting again). + * + * To get to the point: What you do with mpg123_format() and friends is to fill the internal table of allowed formats before it is used. That includes removing support for some formats or adding your forced sample rate (see MPG123_FORCE_RATE) that will be used with the crude internal resampler. Also keep in mind that the sample encoding is just a question of choice -- the MPEG frames do only indicate their native sampling rate and channel count. If you want to decode to integer or float samples, 8 or 16 bit ... that is your decision. In a "clean" world, libmpg123 would always decode to 32 bit float and let you handle any sample conversion. But there are optimized routines that work faster by directly decoding to the desired encoding / accuracy. We prefer efficiency over conceptual tidyness. + * + * People often start out thinking that mpg123_format() should change the actual decoding format on the fly. That is wrong. It only has effect on the next natural change of output format, when libmpg123 will consult its format table again. To make life easier, you might want to call mpg123_format_none() before any thing else and then just allow one desired encoding and a limited set of sample rates / channel choices that you actually intend to deal with. You can force libmpg123 to decode everything to 44100 KHz, stereo, 16 bit integer ... it will duplicate mono channels and even do resampling if needed (unless that feature is disabled in the build, same with some encodings). But I have to stress that the resampling of libmpg123 is very crude and doesn't even contain any kind of "proper" interpolation. + * + * In any case, watch out for MPG123_NEW_FORMAT as return message from decoding routines and call mpg123_getformat() to get the currently active output format. + * * @{ */ -/** An enum over all sample types possibly known to mpg123. - * The values are designed as bit flags to allow bitmasking for encoding families. - * - * Note that (your build of) libmpg123 does not necessarily support all these. - * Usually, you can expect the 8bit encodings and signed 16 bit. - * Also 32bit float will be usual beginning with mpg123-1.7.0 . - * What you should bear in mind is that (SSE, etc) optimized routines may be absent - * for some formats. We do have SSE for 16, 32 bit and float, though. - * 24 bit integer is done via postprocessing of 32 bit output -- just cutting - * the last byte, no rounding, even. If you want better, do it yourself. - * - * All formats are in native byte order. If you need different endinaness, you - * can simply postprocess the output buffers (libmpg123 wouldn't do anything else). - * mpg123_encsize() can be helpful there. - */ -enum mpg123_enc_enum -{ - MPG123_ENC_8 = 0x00f /**< 0000 0000 1111 Some 8 bit integer encoding. */ - ,MPG123_ENC_16 = 0x040 /**< 0000 0100 0000 Some 16 bit integer encoding. */ - ,MPG123_ENC_24 = 0x4000 /**< 0100 0000 0000 0000 Some 24 bit integer encoding. */ - ,MPG123_ENC_32 = 0x100 /**< 0001 0000 0000 Some 32 bit integer encoding. */ - ,MPG123_ENC_SIGNED = 0x080 /**< 0000 1000 0000 Some signed integer encoding. */ - ,MPG123_ENC_FLOAT = 0xe00 /**< 1110 0000 0000 Some float encoding. */ - ,MPG123_ENC_SIGNED_16 = (MPG123_ENC_16|MPG123_ENC_SIGNED|0x10) /**< 1101 0000 signed 16 bit */ - ,MPG123_ENC_UNSIGNED_16 = (MPG123_ENC_16|0x20) /**< 0110 0000 unsigned 16 bit */ - ,MPG123_ENC_UNSIGNED_8 = 0x01 /**< 0000 0001 unsigned 8 bit */ - ,MPG123_ENC_SIGNED_8 = (MPG123_ENC_SIGNED|0x02) /**< 1000 0010 signed 8 bit */ - ,MPG123_ENC_ULAW_8 = 0x04 /**< 0000 0100 ulaw 8 bit */ - ,MPG123_ENC_ALAW_8 = 0x08 /**< 0000 1000 alaw 8 bit */ - ,MPG123_ENC_SIGNED_32 = MPG123_ENC_32|MPG123_ENC_SIGNED|0x1000 /**< 0001 0001 1000 0000 signed 32 bit */ - ,MPG123_ENC_UNSIGNED_32 = MPG123_ENC_32|0x2000 /**< 0010 0001 0000 0000 unsigned 32 bit */ - ,MPG123_ENC_SIGNED_24 = MPG123_ENC_24|MPG123_ENC_SIGNED|0x1000 /**< 0101 0000 1000 0000 signed 24 bit */ - ,MPG123_ENC_UNSIGNED_24 = MPG123_ENC_24|0x2000 /**< 0110 0000 0000 0000 unsigned 24 bit */ - ,MPG123_ENC_FLOAT_32 = 0x200 /**< 0010 0000 0000 32bit float */ - ,MPG123_ENC_FLOAT_64 = 0x400 /**< 0100 0000 0000 64bit float */ - ,MPG123_ENC_ANY = ( MPG123_ENC_SIGNED_16 | MPG123_ENC_UNSIGNED_16 | MPG123_ENC_UNSIGNED_8 - | MPG123_ENC_SIGNED_8 | MPG123_ENC_ULAW_8 | MPG123_ENC_ALAW_8 - | MPG123_ENC_SIGNED_32 | MPG123_ENC_UNSIGNED_32 - | MPG123_ENC_SIGNED_24 | MPG123_ENC_UNSIGNED_24 - | MPG123_ENC_FLOAT_32 | MPG123_ENC_FLOAT_64 ) /**< Any encoding on the list. */ -}; - /** They can be combined into one number (3) to indicate mono and stereo... */ enum mpg123_channelcount { - MPG123_MONO = 1 - ,MPG123_STEREO = 2 + MPG123_MONO = 1 /**< mono */ + ,MPG123_STEREO = 2 /**< stereo */ }; /** An array of supported standard sample rates * These are possible native sample rates of MPEG audio files. - * You can still force mpg123 to resample to a different one, but by default you will only get audio in one of these samplings. + * You can still force mpg123 to resample to a different one, but by + * default you will only get audio in one of these samplings. + * This list is in ascending order. * \param list Store a pointer to the sample rates array there. * \param number Store the number of sample rates there. */ -EXPORT void mpg123_rates(const long **list, size_t *number); +MPG123_EXPORT void mpg123_rates(const long **list, size_t *number); /** An array of supported audio encodings. * An audio encoding is one of the fully qualified members of mpg123_enc_enum (MPG123_ENC_SIGNED_16, not MPG123_SIGNED). * \param list Store a pointer to the encodings array there. * \param number Store the number of encodings there. */ -EXPORT void mpg123_encodings(const int **list, size_t *number); +MPG123_EXPORT void mpg123_encodings(const int **list, size_t *number); /** Return the size (in bytes) of one mono sample of the named encoding. * \param encoding The encoding value to analyze. * \return positive size of encoding in bytes, 0 on invalid encoding. */ -EXPORT int mpg123_encsize(int encoding); +MPG123_EXPORT int mpg123_encsize(int encoding); /** Configure a mpg123 handle to accept no output format at all, - * use before specifying supported formats with mpg123_format */ -EXPORT int mpg123_format_none(mpg123_handle *mh); + * use before specifying supported formats with mpg123_format + * \param mh handle + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_format_none(mpg123_handle *mh); /** Configure mpg123 handle to accept all formats - * (also any custom rate you may set) -- this is default. */ -EXPORT int mpg123_format_all(mpg123_handle *mh); + * (also any custom rate you may set) -- this is default. + * \param mh handle + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_format_all(mpg123_handle *mh); /** Set the audio format support of a mpg123_handle in detail: - * \param mh audio decoder handle + * \param mh handle * \param rate The sample rate value (in Hertz). * \param channels A combination of MPG123_STEREO and MPG123_MONO. * \param encodings A combination of accepted encodings for rate and channels, p.ex MPG123_ENC_SIGNED16 | MPG123_ENC_ULAW_8 (or 0 for no support). Please note that some encodings may not be supported in the library build and thus will be ignored here. * \return MPG123_OK on success, MPG123_ERR if there was an error. */ -EXPORT int mpg123_format(mpg123_handle *mh, long rate, int channels, int encodings); +MPG123_EXPORT int mpg123_format( mpg123_handle *mh +, long rate, int channels, int encodings ); + +/** Set the audio format support of a mpg123_handle in detail: + * \param mh handle + * \param rate The sample rate value (in Hertz). Special value 0 means + * all rates (the reason for this variant of mpg123_format()). + * \param channels A combination of MPG123_STEREO and MPG123_MONO. + * \param encodings A combination of accepted encodings for rate and channels, + * p.ex MPG123_ENC_SIGNED16 | MPG123_ENC_ULAW_8 (or 0 for no support). + * Please note that some encodings may not be supported in the library build + * and thus will be ignored here. + * \return MPG123_OK on success, MPG123_ERR if there was an error. */ +MPG123_EXPORT int mpg123_format2( mpg123_handle *mh +, long rate, int channels, int encodings ); /** Check to see if a specific format at a specific rate is supported * by mpg123_handle. + * \param mh handle + * \param rate sampling rate + * \param encoding encoding * \return 0 for no support (that includes invalid parameters), MPG123_STEREO, * MPG123_MONO or MPG123_STEREO|MPG123_MONO. */ -EXPORT int mpg123_format_support(mpg123_handle *mh, long rate, int encoding); +MPG123_EXPORT int mpg123_format_support( mpg123_handle *mh +, long rate, int encoding ); -/** Get the current output format written to the addresses givenr. */ -EXPORT int mpg123_getformat(mpg123_handle *mh, long *rate, int *channels, int *encoding); +/** Get the current output format written to the addresses given. + * If the stream is freshly loaded, this will try to parse enough + * of it to give you the format to come. This clears the flag that + * would otherwise make the first decoding call return + * MPG123_NEW_FORMAT. + * \param mh handle + * \param rate sampling rate return address + * \param channels channel count return address + * \param encoding encoding return address + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_getformat( mpg123_handle *mh +, long *rate, int *channels, int *encoding ); + +/** Get the current output format written to the addresses given. + * This differs from plain mpg123_getformat() in that you can choose + * _not_ to clear the flag that would trigger the next decoding call + * to return MPG123_NEW_FORMAT in case of a new format arriving. + * \param mh handle + * \param rate sampling rate return address + * \param channels channel count return address + * \param encoding encoding return address + * \param clear_flag if true, clear internal format flag + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_getformat2( mpg123_handle *mh +, long *rate, int *channels, int *encoding, int clear_flag ); /*@}*/ @@ -431,47 +614,116 @@ EXPORT int mpg123_getformat(mpg123_handle *mh, long *rate, int *channels, int *e * @{ */ -/* reading samples / triggering decoding, possible return values: */ -/** Enumeration of the error codes returned by libmpg123 functions. */ +/** Open a simple MPEG file with fixed properties. + * + * This function shall simplify the common use case of a plain MPEG + * file on disk that you want to decode, with one fixed sample + * rate and channel count, and usually a length defined by a Lame/Info/Xing + * tag. It will: + * + * - set the MPG123_NO_FRANKENSTEIN flag + * - set up format support according to given parameters, + * - open the file, + * - query audio format, + * - fix the audio format support table to ensure the format stays the same, + * - call mpg123_scan() if there is no header frame to tell the track length. + * + * From that on, you can call mpg123_getformat() for querying the sample + * rate (and channel count in case you allowed both) and mpg123_length() + * to get a pretty safe number for the duration. + * Only the sample rate is left open as that indeed is a fixed property of + * MPEG files. You could set MPG123_FORCE_RATE beforehand, but that may trigger + * low-quality resampling in the decoder, only do so if in dire need. + * The library will convert mono files to stereo for you, and vice versa. + * If any constraint cannot be satisified (most likely because of a non-default + * build of libmpg123), you get MPG123_ERR returned and can query the detailed + * cause from the handle. Only on MPG123_OK there will an open file that you + * then close using mpg123_close(), or implicitly on mpg123_delete() or the next + * call to open another file. + * + * So, for your usual CD rip collection, you could use + * + * mpg123_open_fixed(mh, path, MPG123_STEREO, MPG123_ENC_SIGNED_16) + * + * and be happy calling mpg123_getformat() to verify 44100 Hz rate, then just + * playing away with mpg123_read(). The occasional mono file, or MP2 file, + * will also be decoded without you really noticing. Just the speed could be + * wrong if you do not care about sample rate at all. + * \param mh handle + * \param path filesystem path + * \param channels allowed channel count, either 1 (MPG123_MONO) or + * 2 (MPG123_STEREO), or bitwise or of them, but then you're halfway back to + * calling mpg123_format() again;-) + * \param encoding a definite encoding from enum mpg123_enc_enum + * or a bitmask like for mpg123_format(), defeating the purpose somewhat + */ +MPG123_EXPORT int mpg123_open_fixed(mpg123_handle *mh, const char *path +, int channels, int encoding); /** Open and prepare to decode the specified file by filesystem path. * This does not open HTTP urls; libmpg123 contains no networking code. * If you want to decode internet streams, use mpg123_open_fd() or mpg123_open_feed(). + * \param mh handle + * \param path filesystem path + * \return MPG123_OK on success */ -EXPORT int mpg123_open(mpg123_handle *mh, const char *path); +MPG123_EXPORT int mpg123_open(mpg123_handle *mh, const char *path); /** Use an already opened file descriptor as the bitstream input * mpg123_close() will _not_ close the file descriptor. + * \param mh handle + * \param fd file descriptor + * \return MPG123_OK on success */ -EXPORT int mpg123_open_fd(mpg123_handle *mh, int fd); +MPG123_EXPORT int mpg123_open_fd(mpg123_handle *mh, int fd); /** Use an opaque handle as bitstream input. This works only with the * replaced I/O from mpg123_replace_reader_handle()! * mpg123_close() will call the cleanup callback for your handle (if you gave one). + * \param mh handle + * \param iohandle your handle + * \return MPG123_OK on success */ -EXPORT int mpg123_open_handle(mpg123_handle *mh, void *iohandle); +MPG123_EXPORT int mpg123_open_handle(mpg123_handle *mh, void *iohandle); /** Open a new bitstream and prepare for direct feeding * This works together with mpg123_decode(); you are responsible for reading and feeding the input bitstream. + * Also, you are expected to handle ICY metadata extraction yourself. This + * input method does not handle MPG123_ICY_INTERVAL. It does parse ID3 frames, though. + * \param mh handle + * \return MPG123_OK on success */ -EXPORT int mpg123_open_feed(mpg123_handle *mh); +MPG123_EXPORT int mpg123_open_feed(mpg123_handle *mh); -/** Closes the source, if libmpg123 opened it. */ -EXPORT int mpg123_close(mpg123_handle *mh); +/** Closes the source, if libmpg123 opened it. + * \param mh handle + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_close(mpg123_handle *mh); /** Read from stream and decode up to outmemsize bytes. + * + * Note: The type of outmemory changed to a void pointer in mpg123 1.26.0 + * (API version 45). + * + * \param mh handle * \param outmemory address of output buffer to write to * \param outmemsize maximum number of bytes to write * \param done address to store the number of actually decoded bytes to - * \return error/message code (watch out for MPG123_DONE and friends!) */ -EXPORT int mpg123_read(mpg123_handle *mh, unsigned char *outmemory, size_t outmemsize, size_t *done); + * \return MPG123_OK or error/message code + */ +MPG123_EXPORT int mpg123_read(mpg123_handle *mh +, void *outmemory, size_t outmemsize, size_t *done ); /** Feed data for a stream that has been opened with mpg123_open_feed(). * It's give and take: You provide the bytestream, mpg123 gives you the decoded samples. + * \param mh handle * \param in input buffer * \param size number of input bytes - * \return error/message code. */ -EXPORT int mpg123_feed(mpg123_handle *mh, const unsigned char *in, size_t size); + * \return MPG123_OK or error/message code. + */ +MPG123_EXPORT int mpg123_feed( mpg123_handle *mh +, const unsigned char *in, size_t size ); /** Decode MPEG Audio from inmemory to outmemory. * This is very close to a drop-in replacement for old mpglib. @@ -480,6 +732,11 @@ EXPORT int mpg123_feed(mpg123_handle *mh, const unsigned char *in, size_t size); * without taking decoded data. * Think of this function being the union of mpg123_read() and mpg123_feed() (which it actually is, sort of;-). * You can actually always decide if you want those specialized functions in separate steps or one call this one here. + * + * Note: The type of outmemory changed to a void pointer in mpg123 1.26.0 + * (API version 45). + * + * \param mh handle * \param inmemory input buffer * \param inmemsize number of input bytes * \param outmemory output buffer @@ -487,30 +744,67 @@ EXPORT int mpg123_feed(mpg123_handle *mh, const unsigned char *in, size_t size); * \param done address to store the number of actually decoded bytes to * \return error/message code (watch out especially for MPG123_NEED_MORE) */ -EXPORT int mpg123_decode(mpg123_handle *mh, const unsigned char *inmemory, size_t inmemsize, unsigned char *outmemory, size_t outmemsize, size_t *done); +MPG123_EXPORT int mpg123_decode( mpg123_handle *mh +, const unsigned char *inmemory, size_t inmemsize +, void *outmemory, size_t outmemsize, size_t *done ); /** Decode next MPEG frame to internal buffer * or read a frame and return after setting a new format. + * \param mh handle * \param num current frame offset gets stored there * \param audio This pointer is set to the internal buffer to read the decoded audio from. * \param bytes number of output bytes ready in the buffer + * \return MPG123_OK or error/message code */ -EXPORT int mpg123_decode_frame(mpg123_handle *mh, off_t *num, unsigned char **audio, size_t *bytes); +MPG123_EXPORT int mpg123_decode_frame( mpg123_handle *mh +, off_t *num, unsigned char **audio, size_t *bytes ); /** Decode current MPEG frame to internal buffer. * Warning: This is experimental API that might change in future releases! * Please watch mpg123 development closely when using it. + * \param mh handle * \param num last frame offset gets stored there * \param audio this pointer is set to the internal buffer to read the decoded audio from. * \param bytes number of output bytes ready in the buffer + * \return MPG123_OK or error/message code */ -EXPORT int mpg123_framebyframe_decode(mpg123_handle *mh, off_t *num, unsigned char **audio, size_t *bytes); +MPG123_EXPORT int mpg123_framebyframe_decode( mpg123_handle *mh +, off_t *num, unsigned char **audio, size_t *bytes ); /** Find, read and parse the next mp3 frame * Warning: This is experimental API that might change in future releases! * Please watch mpg123 development closely when using it. + * \param mh handle + * \return MPG123_OK or error/message code */ -EXPORT int mpg123_framebyframe_next(mpg123_handle *mh); +MPG123_EXPORT int mpg123_framebyframe_next(mpg123_handle *mh); + +/** Get access to the raw input data for the last parsed frame. + * This gives you a direct look (and write access) to the frame body data. + * Together with the raw header, you can reconstruct the whole raw MPEG stream without junk and meta data, or play games by actually modifying the frame body data before decoding this frame (mpg123_framebyframe_decode()). + * A more sane use would be to use this for CRC checking (see mpg123_info() and MPG123_CRC), the first two bytes of the body make up the CRC16 checksum, if present. + * You can provide NULL for a parameter pointer when you are not interested in the value. + * + * \param mh handle + * \param header the 4-byte MPEG header + * \param bodydata pointer to the frame body stored in the handle (without the header) + * \param bodybytes size of frame body in bytes (without the header) + * \return MPG123_OK if there was a yet un-decoded frame to get the + * data from, MPG123_BAD_HANDLE or MPG123_ERR otherwise (without further + * explanation, the error state of the mpg123_handle is not modified by + * this function). + */ +MPG123_EXPORT int mpg123_framedata( mpg123_handle *mh +, unsigned long *header, unsigned char **bodydata, size_t *bodybytes ); + +/** Get the input position (byte offset in stream) of the last parsed frame. + * This can be used for external seek index building, for example. + * It just returns the internally stored offset, regardless of validity -- + * you ensure that a valid frame has been parsed before! + * \param mh handle + * \return byte offset in stream + */ +MPG123_EXPORT off_t mpg123_framepos(mpg123_handle *mh); /*@}*/ @@ -530,65 +824,97 @@ EXPORT int mpg123_framebyframe_next(mpg123_handle *mh); * Also, really sample-accurate seeking (meaning that you get the identical sample value after seeking compared to plain decoding up to the position) is only guaranteed when you do not mess with the position code by using MPG123_UPSPEED, MPG123_DOWNSPEED or MPG123_START_FRAME. The first two mainly should cause trouble with NtoM resampling, but in any case with these options in effect, you have to keep in mind that the sample offset is not the same as counting the samples you get from decoding since mpg123 counts the skipped samples, too (or the samples played twice only once)! * Short: When you care about the sample position, don't mess with those parameters;-) * Also, seeking is not guaranteed to work for all streams (underlying stream may not support it). + * And yet another caveat: If the stream is concatenated out of differing pieces (Frankenstein stream), seeking may suffer, too. * * @{ */ /** Returns the current position in samples. - * On the next read, you'd get that sample. */ -EXPORT off_t mpg123_tell(mpg123_handle *mh); + * On the next successful read, you'd get that sample. + * \param mh handle + * \return sample offset or MPG123_ERR (null handle) + */ +MPG123_EXPORT off_t mpg123_tell(mpg123_handle *mh); -/** Returns the frame number that the next read will give you data from. */ -EXPORT off_t mpg123_tellframe(mpg123_handle *mh); +/** Returns the frame number that the next read will give you data from. + * \param mh handle + * \return frame offset or MPG123_ERR (null handle) + */ +MPG123_EXPORT off_t mpg123_tellframe(mpg123_handle *mh); -/** Returns the current byte offset in the input stream. */ -EXPORT off_t mpg123_tell_stream(mpg123_handle *mh); +/** Returns the current byte offset in the input stream. + * \param mh handle + * \return byte offset or MPG123_ERR (null handle) + */ +MPG123_EXPORT off_t mpg123_tell_stream(mpg123_handle *mh); -/** Seek to a desired sample offset. - * Set whence to SEEK_SET, SEEK_CUR or SEEK_END. - * \return The resulting offset >= 0 or error/message code */ -EXPORT off_t mpg123_seek(mpg123_handle *mh, off_t sampleoff, int whence); +/** Seek to a desired sample offset. + * Usage is modelled afer the standard lseek(). + * \param mh handle + * \param sampleoff offset in PCM samples + * \param whence one of SEEK_SET, SEEK_CUR or SEEK_END + * \return The resulting offset >= 0 or error/message code + */ +MPG123_EXPORT off_t mpg123_seek( mpg123_handle *mh +, off_t sampleoff, int whence ); /** Seek to a desired sample offset in data feeding mode. * This just prepares things to be right only if you ensure that the next chunk of input data will be from input_offset byte position. + * \param mh handle + * \param sampleoff offset in PCM samples + * \param whence one of SEEK_SET, SEEK_CUR or SEEK_END * \param input_offset The position it expects to be at the * next time data is fed to mpg123_decode(). * \return The resulting offset >= 0 or error/message code */ -EXPORT off_t mpg123_feedseek(mpg123_handle *mh, off_t sampleoff, int whence, off_t *input_offset); +MPG123_EXPORT off_t mpg123_feedseek( mpg123_handle *mh +, off_t sampleoff, int whence, off_t *input_offset ); -/** Seek to a desired MPEG frame index. - * Set whence to SEEK_SET, SEEK_CUR or SEEK_END. - * \return The resulting offset >= 0 or error/message code */ -EXPORT off_t mpg123_seek_frame(mpg123_handle *mh, off_t frameoff, int whence); +/** Seek to a desired MPEG frame offset. + * Usage is modelled afer the standard lseek(). + * \param mh handle + * \param frameoff offset in MPEG frames + * \param whence one of SEEK_SET, SEEK_CUR or SEEK_END + * \return The resulting offset >= 0 or error/message code */ +MPG123_EXPORT off_t mpg123_seek_frame( mpg123_handle *mh +, off_t frameoff, int whence ); /** Return a MPEG frame offset corresponding to an offset in seconds. * This assumes that the samples per frame do not change in the file/stream, which is a good assumption for any sane file/stream only. * \return frame offset >= 0 or error/message code */ -EXPORT off_t mpg123_timeframe(mpg123_handle *mh, double sec); +MPG123_EXPORT off_t mpg123_timeframe(mpg123_handle *mh, double sec); /** Give access to the frame index table that is managed for seeking. * You are asked not to modify the values... Use mpg123_set_index to set the * seek index + * \param mh handle * \param offsets pointer to the index array * \param step one index byte offset advances this many MPEG frames - * \param fill number of recorded index offsets; size of the array */ -EXPORT int mpg123_index(mpg123_handle *mh, off_t **offsets, off_t *step, size_t *fill); + * \param fill number of recorded index offsets; size of the array + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_index( mpg123_handle *mh +, off_t **offsets, off_t *step, size_t *fill ); /** Set the frame index table * Setting offsets to NULL and fill > 0 will allocate fill entries. Setting offsets * to NULL and fill to 0 will clear the index and free the allocated memory used by the index. + * \param mh handle * \param offsets pointer to the index array * \param step one index byte offset advances this many MPEG frames - * \param fill number of recorded index offsets; size of the array */ -EXPORT int mpg123_set_index(mpg123_handle *mh, off_t *offsets, off_t step, size_t fill); + * \param fill number of recorded index offsets; size of the array + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_set_index( mpg123_handle *mh +, off_t *offsets, off_t step, size_t fill ); -/** Get information about current and remaining frames/seconds. - * WARNING: This function is there because of special usage by standalone mpg123 and may be removed in the final version of libmpg123! - * You provide an offset (in frames) from now and a number of output bytes - * served by libmpg123 but not yet played. You get the projected current frame - * and seconds, as well as the remaining frames/seconds. This does _not_ care - * about skipped samples due to gapless playback. */ -EXPORT int mpg123_position( mpg123_handle *mh, off_t frame_offset, off_t buffered_bytes, off_t *current_frame, off_t *frames_left, double *current_seconds, double *seconds_left); +/** An old crutch to keep old mpg123 binaries happy. + * WARNING: This function is there only to avoid runtime linking errors with + * standalone mpg123 before version 1.23.0 (if you strangely update the + * library but not the end-user program) and actually is broken + * for various cases (p.ex. 24 bit output). Do never use. It might eventually + * be purged from the library. + */ +MPG123_EXPORT int mpg123_position( mpg123_handle *mh, off_t frame_offset, off_t buffered_bytes, off_t *current_frame, off_t *frames_left, double *current_seconds, double *seconds_left); /*@}*/ @@ -598,6 +924,7 @@ EXPORT int mpg123_position( mpg123_handle *mh, off_t frame_offset, off_t buffere * @{ */ +/** another channel enumeration, for left/right choice */ enum mpg123_channels { MPG123_LEFT=0x1 /**< The Left Channel. */ @@ -606,32 +933,55 @@ enum mpg123_channels }; /** Set the 32 Band Audio Equalizer settings. + * \param mh handle * \param channel Can be MPG123_LEFT, MPG123_RIGHT or MPG123_LEFT|MPG123_RIGHT for both. * \param band The equaliser band to change (from 0 to 31) - * \param val The (linear) adjustment factor. */ -EXPORT int mpg123_eq(mpg123_handle *mh, enum mpg123_channels channel, int band, double val); + * \param val The (linear) adjustment factor. + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_eq( mpg123_handle *mh +, enum mpg123_channels channel, int band, double val ); /** Get the 32 Band Audio Equalizer settings. + * \param mh handle * \param channel Can be MPG123_LEFT, MPG123_RIGHT or MPG123_LEFT|MPG123_RIGHT for (arithmetic mean of) both. * \param band The equaliser band to change (from 0 to 31) - * \return The (linear) adjustment factor. */ -EXPORT double mpg123_geteq(mpg123_handle *mh, enum mpg123_channels channel, int band); + * \return The (linear) adjustment factor (zero for pad parameters) */ +MPG123_EXPORT double mpg123_geteq(mpg123_handle *mh + , enum mpg123_channels channel, int band); -/** Reset the 32 Band Audio Equalizer settings to flat */ -EXPORT int mpg123_reset_eq(mpg123_handle *mh); +/** Reset the 32 Band Audio Equalizer settings to flat + * \param mh handle + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_reset_eq(mpg123_handle *mh); /** Set the absolute output volume including the RVA setting, - * vol<0 just applies (a possibly changed) RVA setting. */ -EXPORT int mpg123_volume(mpg123_handle *mh, double vol); + * vol<0 just applies (a possibly changed) RVA setting. + * \param mh handle + * \param vol volume value (linear factor) + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_volume(mpg123_handle *mh, double vol); -/** Adjust output volume including the RVA setting by chosen amount */ -EXPORT int mpg123_volume_change(mpg123_handle *mh, double change); +/** Adjust output volume including the RVA setting by chosen amount + * \param mh handle + * \param change volume value (linear factor increment) + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_volume_change(mpg123_handle *mh, double change); /** Return current volume setting, the actual value due to RVA, and the RVA * adjustment itself. It's all as double float value to abstract the sample * format. The volume values are linear factors / amplitudes (not percent) - * and the RVA value is in decibels. */ -EXPORT int mpg123_getvolume(mpg123_handle *mh, double *base, double *really, double *rva_db); + * and the RVA value is in decibels. + * \param mh handle + * \param base return address for base volume (linear factor) + * \param really return address for actual volume (linear factor) + * \param rva_db return address for RVA value (decibels) + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_getvolume(mpg123_handle *mh, double *base, double *really, double *rva_db); /* TODO: Set some preamp in addition / to replace internal RVA handling? */ @@ -684,7 +1034,7 @@ struct mpg123_frameinfo long rate; /**< The sampling rate in Hz. */ enum mpg123_mode mode; /**< The audio mode (Mono, Stereo, Joint-stero, Dual Channel). */ int mode_ext; /**< The mode extension bit flag. */ - int framesize; /**< The size of the frame (in bytes). */ + int framesize; /**< The size of the frame (in bytes, including header). */ enum mpg123_flags flags; /**< MPEG Audio flag bits. Just now I realize that it should be declared as int, not enum. It's a bitwise combination of the enum values. */ int emphasis; /**< The emphasis type. */ int bitrate; /**< Bitrate of the frame (kbps). */ @@ -692,49 +1042,130 @@ struct mpg123_frameinfo enum mpg123_vbr vbr; /**< The VBR mode. */ }; -/** Get frame information about the MPEG audio bitstream and store it in a mpg123_frameinfo structure. */ -EXPORT int mpg123_info(mpg123_handle *mh, struct mpg123_frameinfo *mi); +/** Data structure for even more detailed information out of the decoder, + * for MPEG layer III only. + * This was added to support the frame analyzer by the Lame project and + * just follows what was used there before. You know what the fields mean + * if you want use this structure. */ +struct mpg123_moreinfo +{ + double xr[2][2][576]; + double sfb[2][2][22]; /* [2][2][SBMAX_l] */ + double sfb_s[2][2][3*13]; /* [2][2][3*SBMAX_s] */ + int qss[2][2]; + int big_values[2][2]; + int sub_gain[2][2][3]; + int scalefac_scale[2][2]; + int preflag[2][2]; + int blocktype[2][2]; + int mixed[2][2]; + int mainbits[2][2]; + int sfbits[2][2]; + int scfsi[2]; + int maindata; + int padding; +}; -/** Get the safe output buffer size for all cases (when you want to replace the internal buffer) */ -EXPORT size_t mpg123_safe_buffer(void); - -/** Make a full parsing scan of each frame in the file. ID3 tags are found. An accurate length - * value is stored. Seek index will be filled. A seek back to current position - * is performed. At all, this function refuses work when stream is - * not seekable. - * \return MPG123_OK or MPG123_ERR. +/** Get frame information about the MPEG audio bitstream and store it in a mpg123_frameinfo structure. + * \param mh handle + * \param mi address of existing frameinfo structure to write to + * \return MPG123_OK on success */ -EXPORT int mpg123_scan(mpg123_handle *mh); +MPG123_EXPORT int mpg123_info(mpg123_handle *mh, struct mpg123_frameinfo *mi); -/** Return, if possible, the full (expected) length of current track in samples. - * \return length >= 0 or MPG123_ERR if there is no length guess possible. */ -EXPORT off_t mpg123_length(mpg123_handle *mh); +/** Trigger collection of additional decoder information while decoding. + * \param mh handle + * \param mi pointer to data storage (NULL to disable collection) + * \return MPG123_OK if the collection was enabled/disabled as desired, MPG123_ERR + * otherwise (e.g. if the feature is disabled) + */ +MPG123_EXPORT int mpg123_set_moreinfo( mpg123_handle *mh +, struct mpg123_moreinfo *mi ); + +/** Get the safe output buffer size for all cases + * (when you want to replace the internal buffer) + * \return safe buffer size + */ +MPG123_EXPORT size_t mpg123_safe_buffer(void); + +/** Make a full parsing scan of each frame in the file. ID3 tags are found. An + * accurate length value is stored. Seek index will be filled. A seek back to + * current position is performed. At all, this function refuses work when + * stream is not seekable. + * \param mh handle + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_scan(mpg123_handle *mh); + +/** Return, if possible, the full (expected) length of current track in + * MPEG frames. + * \param mh handle + * \return length >= 0 or MPG123_ERR if there is no length guess possible. + */ +MPG123_EXPORT off_t mpg123_framelength(mpg123_handle *mh); + +/** Return, if possible, the full (expected) length of current + * track in samples (PCM frames). + * + * This relies either on an Info frame at the beginning or a previous + * call to mpg123_scan() to get the real number of MPEG frames in a + * file. It will guess based on file size if neither Info frame nor + * scan data are present. In any case, there is no guarantee that the + * decoder will not give you more data, for example in case the open + * file gets appended to during decoding. + * \param mh handle + * \return length >= 0 or MPG123_ERR if there is no length guess possible. + */ +MPG123_EXPORT off_t mpg123_length(mpg123_handle *mh); /** Override the value for file size in bytes. - * Useful for getting sensible track length values in feed mode or for HTTP streams. - * \return MPG123_OK or MPG123_ERR */ -EXPORT int mpg123_set_filesize(mpg123_handle *mh, off_t size); + * Useful for getting sensible track length values in feed mode or for HTTP streams. + * \param mh handle + * \param size file size in bytes + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_set_filesize(mpg123_handle *mh, off_t size); -/** Returns the time (seconds) per frame; <0 is error. */ -EXPORT double mpg123_tpf(mpg123_handle *mh); +/** Get MPEG frame duration in seconds. + * \param mh handle + * \return frame duration in seconds, <0 on error + */ +MPG123_EXPORT double mpg123_tpf(mpg123_handle *mh); -/** Get and reset the clip count. */ -EXPORT long mpg123_clip(mpg123_handle *mh); +/** Get MPEG frame duration in samples. + * \param mh handle + * \return samples per frame for the most recently parsed frame; <0 on errors + */ +MPG123_EXPORT int mpg123_spf(mpg123_handle *mh); + +/** Get and reset the clip count. + * \param mh handle + * \return count of clipped samples + */ +MPG123_EXPORT long mpg123_clip(mpg123_handle *mh); /** The key values for state information from mpg123_getstate(). */ enum mpg123_state { - MPG123_ACCURATE = 1 /**< Query if positons are currently accurate (integer value, 0 if false, 1 if true) */ + MPG123_ACCURATE = 1 /**< Query if positons are currently accurate (integer value, 0 if false, 1 if true). */ + ,MPG123_BUFFERFILL /**< Get fill of internal (feed) input buffer as integer byte count returned as long and as double. An error is returned on integer overflow while converting to (signed) long, but the returned floating point value shold still be fine. */ + ,MPG123_FRANKENSTEIN /**< Stream consists of carelessly stitched together files. Seeking may yield unexpected results (also with MPG123_ACCURATE, it may be confused). */ + ,MPG123_FRESH_DECODER /**< Decoder structure has been updated, possibly indicating changed stream (integer value, 0 if false, 1 if true). Flag is cleared after retrieval. */ + ,MPG123_ENC_DELAY /** Encoder delay read from Info tag (layer III, -1 if unknown). */ + ,MPG123_ENC_PADDING /** Encoder padding read from Info tag (layer III, -1 if unknown). */ + ,MPG123_DEC_DELAY /** Decoder delay (for layer III only, -1 otherwise). */ }; /** Get various current decoder/stream state information. + * \param mh handle * \param key the key to identify the information to give. * \param val the address to return (long) integer values to * \param fval the address to return floating point values to - * \return MPG123_OK or MPG123_ERR for success + * \return MPG123_OK on success */ -EXPORT int mpg123_getstate(mpg123_handle *mh, enum mpg123_state key, long *val, double *fval); +MPG123_EXPORT int mpg123_getstate( mpg123_handle *mh +, enum mpg123_state key, long *val, double *fval ); /*@}*/ @@ -756,53 +1187,128 @@ typedef struct size_t fill; /**< number of used bytes (including closing zero byte) */ } mpg123_string; -/** Create and allocate memory for a new mpg123_string */ -EXPORT void mpg123_init_string(mpg123_string* sb); +/** Allocate and intialize a new string. + * \param val optional initial string value (can be NULL) + */ +MPG123_EXPORT mpg123_string* mpg123_new_string(const char* val); -/** Free-up mempory for an existing mpg123_string */ -EXPORT void mpg123_free_string(mpg123_string* sb); +/** Free memory of contents and the string structure itself. + * \param sb string handle + */ +MPG123_EXPORT void mpg123_delete_string(mpg123_string* sb); + +/** Initialize an existing mpg123_string structure to {NULL, 0, 0}. + * If you hand in a NULL pointer here, your program should crash. The other + * string functions are more forgiving, but this one here is too basic. + * \param sb string handle (address of existing structure on your side) + */ +MPG123_EXPORT void mpg123_init_string(mpg123_string* sb); + +/** Free-up memory of the contents of an mpg123_string (not the struct itself). + * This also calls mpg123_init_string() and hence is safe to be called + * repeatedly. + * \param sb string handle + */ +MPG123_EXPORT void mpg123_free_string(mpg123_string* sb); /** Change the size of a mpg123_string - * \return 0 on error, 1 on success */ -EXPORT int mpg123_resize_string(mpg123_string* sb, size_t news); + * \param sb string handle + * \param news new size in bytes + * \return 0 on error, 1 on success + */ +MPG123_EXPORT int mpg123_resize_string(mpg123_string* sb, size_t news); /** Increase size of a mpg123_string if necessary (it may stay larger). - * Note that the functions for adding and setting in current libmpg123 use this instead of mpg123_resize_string(). - * That way, you can preallocate memory and safely work afterwards with pieces. - * \return 0 on error, 1 on success */ -EXPORT int mpg123_grow_string(mpg123_string* sb, size_t news); + * Note that the functions for adding and setting in current libmpg123 + * use this instead of mpg123_resize_string(). + * That way, you can preallocate memory and safely work afterwards with + * pieces. + * \param sb string handle + * \param news new minimum size + * \return 0 on error, 1 on success + */ +MPG123_EXPORT int mpg123_grow_string(mpg123_string* sb, size_t news); /** Copy the contents of one mpg123_string string to another. - * \return 0 on error, 1 on success */ -EXPORT int mpg123_copy_string(mpg123_string* from, mpg123_string* to); + * Yes the order of arguments is reversed compated to memcpy(). + * \param from string handle + * \param to string handle + * \return 0 on error, 1 on success + */ +MPG123_EXPORT int mpg123_copy_string(mpg123_string* from, mpg123_string* to); + +/** Move the contents of one mpg123_string string to another. + * This frees any memory associated with the target and moves over the + * pointers from the source, leaving the source without content after + * that. The only possible error is that you hand in NULL pointers. + * If you handed in a valid source, its contents will be gone, even if + * there was no target to move to. If you hand in a valid target, its + * original contents will also always be gone, to be replaced with the + * source's contents if there was some. + * \param from source string handle + * \param to target string handle + * \return 0 on error, 1 on success + */ +MPG123_EXPORT int mpg123_move_string(mpg123_string* from, mpg123_string* to); /** Append a C-String to an mpg123_string - * \return 0 on error, 1 on success */ -EXPORT int mpg123_add_string(mpg123_string* sb, const char* stuff); + * \param sb string handle + * \param stuff to append + * \return 0 on error, 1 on success + */ +MPG123_EXPORT int mpg123_add_string(mpg123_string* sb, const char* stuff); /** Append a C-substring to an mpg123 string - * \return 0 on error, 1 on success + * \param sb string handle + * \param stuff content to copy * \param from offset to copy from - * \param count number of characters to copy (a null-byte is always appended) */ -EXPORT int mpg123_add_substring(mpg123_string *sb, const char *stuff, size_t from, size_t count); - -/** Set the conents of a mpg123_string to a C-string - * \return 0 on error, 1 on success */ -EXPORT int mpg123_set_string(mpg123_string* sb, const char* stuff); - -/** Set the contents of a mpg123_string to a C-substring + * \param count number of characters to copy (a null-byte is always appended) * \return 0 on error, 1 on success - * \param from offset to copy from - * \param count number of characters to copy (a null-byte is always appended) */ -EXPORT int mpg123_set_substring(mpg123_string *sb, const char *stuff, size_t from, size_t count); + */ +MPG123_EXPORT int mpg123_add_substring( mpg123_string *sb +, const char *stuff, size_t from, size_t count ); -/** Count characters in a mpg123 string (non-null bytes or UTF-8 characters). - * \return character count - * \param sb the string +/** Set the content of a mpg123_string to a C-string + * \param sb string handle + * \param stuff content to copy + * \return 0 on error, 1 on success + */ +MPG123_EXPORT int mpg123_set_string(mpg123_string* sb, const char* stuff); + +/** Set the content of a mpg123_string to a C-substring + * \param sb string handle + * \param stuff the future content + * \param from offset to copy from + * \param count number of characters to copy (a null-byte is always appended) + * \return 0 on error, 1 on success + */ +MPG123_EXPORT int mpg123_set_substring( mpg123_string *sb +, const char *stuff, size_t from, size_t count ); + +/** Count characters in a mpg123 string (non-null bytes or Unicode points). + * This function is of limited use, as it does just count code points + * encoded in an UTF-8 string, only loosely related to the count of visible + * characters. Get your full Unicode handling support elsewhere. + * \param sb string handle * \param utf8 a flag to tell if the string is in utf8 encoding - * Even with the fill property, the character count is not obvious as there could be multiple trailing null bytes. + * \return character count */ -EXPORT size_t mpg123_strlen(mpg123_string *sb, int utf8); +MPG123_EXPORT size_t mpg123_strlen(mpg123_string *sb, int utf8); + +/** Remove trailing \\r and \\n, if present. + * \param sb string handle + * \return 0 on error, 1 on success + */ +MPG123_EXPORT int mpg123_chomp_string(mpg123_string *sb); + +/** Determine if two strings contain the same data. + * This only returns 1 if both given handles are non-NULL and + * if they are filled with the same bytes. + * \param a first string handle + * \param b second string handle + * \return 0 for different strings, 1 for identical + */ +MPG123_EXPORT int mpg123_same_string(mpg123_string *a, mpg123_string *b); /** The mpg123 text encodings. This contains encodings we encounter in ID3 tags or ICY meta info. */ enum mpg123_text_encoding @@ -834,25 +1340,30 @@ enum mpg123_id3_enc ,mpg123_id3_enc_max = 3 /**< Placeholder to check valid range of encoding byte. */ }; -/** Convert ID3 encoding byte to mpg123 encoding index. */ -EXPORT enum mpg123_text_encoding mpg123_enc_from_id3(unsigned char id3_enc_byte); +/** Convert ID3 encoding byte to mpg123 encoding index. + * \param id3_enc_byte the ID3 encoding code + * \return the mpg123 encoding index + */ + +MPG123_EXPORT enum mpg123_text_encoding mpg123_enc_from_id3(unsigned char id3_enc_byte); /** Store text data in string, after converting to UTF-8 from indicated encoding - * \return 0 on error, 1 on success (on error, mpg123_free_string is called on sb) - * \param sb target string - * \param enc mpg123 text encoding value - * \param source source buffer with plain unsigned bytes (you might need to cast from char *) - * \param source_size number of bytes in the source buffer - * * A prominent error can be that you provided an unknown encoding value, or this build of libmpg123 lacks support for certain encodings (ID3 or ICY stuff missing). * Also, you might want to take a bit of care with preparing the data; for example, strip leading zeroes (I have seen that). + * \param sb target string + * \param enc mpg123 text encoding value + * \param source source buffer with plain unsigned bytes (you might need to cast from signed char) + * \param source_size number of bytes in the source buffer + * \return 0 on error, 1 on success (on error, mpg123_free_string is called on sb) */ -EXPORT int mpg123_store_utf8(mpg123_string *sb, enum mpg123_text_encoding enc, const unsigned char *source, size_t source_size); +MPG123_EXPORT int mpg123_store_utf8(mpg123_string *sb, enum mpg123_text_encoding enc, const unsigned char *source, size_t source_size); /** Sub data structure for ID3v2, for storing various text fields (including comments). * This is for ID3v2 COMM, TXXX and all the other text fields. - * Only COMM and TXXX have a description, only COMM and USLT have a language. - * You should consult the ID3v2 specification for the use of the various text fields ("frames" in ID3v2 documentation, I use "fields" here to separate from MPEG frames). */ + * Only COMM, TXXX and USLT may have a description, only COMM and USLT + * have a language. + * You should consult the ID3v2 specification for the use of the various text fields + * ("frames" in ID3v2 documentation, I use "fields" here to separate from MPEG frames). */ typedef struct { char lang[3]; /**< Three-letter language code (not terminated). */ @@ -861,6 +1372,45 @@ typedef struct mpg123_string text; /**< ... */ } mpg123_text; +/** The picture type values from ID3v2. */ +enum mpg123_id3_pic_type +{ + mpg123_id3_pic_other = 0 /**< see ID3v2 docs */ + ,mpg123_id3_pic_icon = 1 /**< see ID3v2 docs */ + ,mpg123_id3_pic_other_icon = 2 /**< see ID3v2 docs */ + ,mpg123_id3_pic_front_cover = 3 /**< see ID3v2 docs */ + ,mpg123_id3_pic_back_cover = 4 /**< see ID3v2 docs */ + ,mpg123_id3_pic_leaflet = 5 /**< see ID3v2 docs */ + ,mpg123_id3_pic_media = 6 /**< see ID3v2 docs */ + ,mpg123_id3_pic_lead = 7 /**< see ID3v2 docs */ + ,mpg123_id3_pic_artist = 8 /**< see ID3v2 docs */ + ,mpg123_id3_pic_conductor = 9 /**< see ID3v2 docs */ + ,mpg123_id3_pic_orchestra = 10 /**< see ID3v2 docs */ + ,mpg123_id3_pic_composer = 11 /**< see ID3v2 docs */ + ,mpg123_id3_pic_lyricist = 12 /**< see ID3v2 docs */ + ,mpg123_id3_pic_location = 13 /**< see ID3v2 docs */ + ,mpg123_id3_pic_recording = 14 /**< see ID3v2 docs */ + ,mpg123_id3_pic_performance = 15 /**< see ID3v2 docs */ + ,mpg123_id3_pic_video = 16 /**< see ID3v2 docs */ + ,mpg123_id3_pic_fish = 17 /**< see ID3v2 docs */ + ,mpg123_id3_pic_illustration = 18 /**< see ID3v2 docs */ + ,mpg123_id3_pic_artist_logo = 19 /**< see ID3v2 docs */ + ,mpg123_id3_pic_publisher_logo = 20 /**< see ID3v2 docs */ +}; + +/** Sub data structure for ID3v2, for storing picture data including comment. + * This is for the ID3v2 APIC field. You should consult the ID3v2 specification + * for the use of the APIC field ("frames" in ID3v2 documentation, I use "fields" + * here to separate from MPEG frames). */ +typedef struct +{ + char type; /**< mpg123_id3_pic_type value */ + mpg123_string description; /**< description string */ + mpg123_string mime_type; /**< MIME type */ + size_t size; /**< size in bytes */ + unsigned char* data; /**< pointer to the image data */ +} mpg123_picture; + /** Data structure for storing IDV3v2 tags. * This structure is not a direct binary mapping with the file contents. * The ID3v2 text frames are allowed to contain multiple strings. @@ -883,11 +1433,14 @@ typedef struct size_t texts; /**< Numer of text fields. */ mpg123_text *extra; /**< The array of extra (TXXX) fields. */ size_t extras; /**< Number of extra text (TXXX) fields. */ + mpg123_picture *picture; /**< Array of ID3v2 pictures fields (APIC). + Only populated if MPG123_PICTURE flag is set! */ + size_t pictures; /**< Number of picture (APIC) fields. */ } mpg123_id3v2; /** Data structure for ID3v1 tags (the last 128 bytes of a file). * Don't take anything for granted (like string termination)! - * Also note the change ID3v1.1 did: comment[28] = 0; comment[19] = track_number + * Also note the change ID3v1.1 did: comment[28] = 0; comment[29] = track_number * It is your task to support ID3v1 only or ID3v1.1 ...*/ typedef struct { @@ -906,23 +1459,50 @@ typedef struct #define MPG123_NEW_ICY 0x4 /**< 0100 There is ICY info that changed since last call to mpg123_icy. */ /** Query if there is (new) meta info, be it ID3 or ICY (or something new in future). - The check function returns a combination of flags. */ -EXPORT int mpg123_meta_check(mpg123_handle *mh); /* On error (no valid handle) just 0 is returned. */ + * \param mh handle + * \return combination of flags, 0 on error (same as "nothing new") + */ +MPG123_EXPORT int mpg123_meta_check(mpg123_handle *mh); + +/** Clean up meta data storage (ID3v2 and ICY), freeing memory. + * \param mh handle + */ +MPG123_EXPORT void mpg123_meta_free(mpg123_handle *mh); /** Point v1 and v2 to existing data structures wich may change on any next read/decode function call. * v1 and/or v2 can be set to NULL when there is no corresponding data. - * \return Return value is MPG123_OK or MPG123_ERR, */ -EXPORT int mpg123_id3(mpg123_handle *mh, mpg123_id3v1 **v1, mpg123_id3v2 **v2); + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_id3( mpg123_handle *mh +, mpg123_id3v1 **v1, mpg123_id3v2 **v2 ); + +/** Return pointers to and size of stored raw ID3 data if storage has + * been configured with MPG123_RAW_ID3 and stream parsing passed the + * metadata already. Null value with zero size is a possibility! + * The storage can change at any next API call. + * \param v1 address to store pointer to v1 tag + * \param v1_size size of v1 data in bytes + * \param v2 address to store pointer to v2 tag + * \param v2_size size of v2 data in bytes + * \return MPG123_OK or MPG123_ERR. Only on MPG123_OK the output + * values are set. + */ +MPG123_EXPORT int mpg123_id3_raw( mpg123_handle *mh +, unsigned char **v1, size_t *v1_size +, unsigned char **v2, size_t *v2_size ); /** Point icy_meta to existing data structure wich may change on any next read/decode function call. - * \return Return value is MPG123_OK or MPG123_ERR, */ -EXPORT int mpg123_icy(mpg123_handle *mh, char **icy_meta); /* same for ICY meta string */ + * \param mh handle + * \param icy_meta return address for ICY meta string (set to NULL if nothing there) + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_icy(mpg123_handle *mh, char **icy_meta); /** Decode from windows-1252 (the encoding ICY metainfo used) to UTF-8. * Note that this is very similar to mpg123_store_utf8(&sb, mpg123_text_icy, icy_text, strlen(icy_text+1)) . * \param icy_text The input data in ICY encoding * \return pointer to newly allocated buffer with UTF-8 data (You free() it!) */ -EXPORT char* mpg123_icy2utf8(const char* icy_text); +MPG123_EXPORT char* mpg123_icy2utf8(const char* icy_text); /* @} */ @@ -949,44 +1529,95 @@ struct mpg123_pars_struct; /** Opaque structure for the libmpg123 decoder parameters. */ typedef struct mpg123_pars_struct mpg123_pars; -/** Create a handle with preset parameters. */ -EXPORT mpg123_handle *mpg123_parnew(mpg123_pars *mp, const char* decoder, int *error); +/** Create a handle with preset parameters. + * \param mp parameter handle + * \param decoder decoder choice + * \param error error code return address + * \return mpg123 handle + */ +MPG123_EXPORT mpg123_handle *mpg123_parnew( mpg123_pars *mp +, const char* decoder, int *error ); -/** Allocate memory for and return a pointer to a new mpg123_pars */ -EXPORT mpg123_pars *mpg123_new_pars(int *error); +/** Allocate memory for and return a pointer to a new mpg123_pars + * \param error error code return address + * \return new parameter handle + */ +MPG123_EXPORT mpg123_pars *mpg123_new_pars(int *error); -/** Delete and free up memory used by a mpg123_pars data structure */ -EXPORT void mpg123_delete_pars(mpg123_pars* mp); +/** Delete and free up memory used by a mpg123_pars data structure + * \param mp parameter handle + */ +MPG123_EXPORT void mpg123_delete_pars(mpg123_pars* mp); /** Configure mpg123 parameters to accept no output format at all, - * use before specifying supported formats with mpg123_format */ -EXPORT int mpg123_fmt_none(mpg123_pars *mp); + * use before specifying supported formats with mpg123_format + * \param mp parameter handle + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_fmt_none(mpg123_pars *mp); /** Configure mpg123 parameters to accept all formats - * (also any custom rate you may set) -- this is default. */ -EXPORT int mpg123_fmt_all(mpg123_pars *mp); + * (also any custom rate you may set) -- this is default. + * \param mp parameter handle + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_fmt_all(mpg123_pars *mp); /** Set the audio format support of a mpg123_pars in detail: - \param rate The sample rate value (in Hertz). - \param channels A combination of MPG123_STEREO and MPG123_MONO. - \param encodings A combination of accepted encodings for rate and channels, p.ex MPG123_ENC_SIGNED16|MPG123_ENC_ULAW_8 (or 0 for no support). - \return 0 on success, -1 if there was an error. / + * \param mp parameter handle + * \param rate The sample rate value (in Hertz). + * \param channels A combination of MPG123_STEREO and MPG123_MONO. + * \param encodings A combination of accepted encodings for rate and channels, + * p.ex MPG123_ENC_SIGNED16|MPG123_ENC_ULAW_8 (or 0 for no + * support). + * \return MPG123_OK on success */ -EXPORT int mpg123_fmt(mpg123_pars *mh, long rate, int channels, int encodings); /* 0 is good, -1 is error */ +MPG123_EXPORT int mpg123_fmt(mpg123_pars *mp +, long rate, int channels, int encodings); -/** Check to see if a specific format at a specific rate is supported +/** Set the audio format support of a mpg123_pars in detail: + * \param mp parameter handle + * \param rate The sample rate value (in Hertz). Special value 0 means + * all rates (reason for this variant of mpg123_fmt). + * \param channels A combination of MPG123_STEREO and MPG123_MONO. + * \param encodings A combination of accepted encodings for rate and channels, + * p.ex MPG123_ENC_SIGNED16|MPG123_ENC_ULAW_8 (or 0 for no + * support). + * \return MPG123_OK on success +*/ +MPG123_EXPORT int mpg123_fmt2(mpg123_pars *mp +, long rate, int channels, int encodings); + +/** Check to see if a specific format at a specific rate is supported * by mpg123_pars. + * \param mp parameter handle + * \param rate sampling rate + * \param encoding encoding * \return 0 for no support (that includes invalid parameters), MPG123_STEREO, * MPG123_MONO or MPG123_STEREO|MPG123_MONO. */ -EXPORT int mpg123_fmt_support(mpg123_pars *mh, long rate, int encoding); +MPG123_EXPORT int mpg123_fmt_support(mpg123_pars *mp, long rate, int encoding); /** Set a specific parameter, for a specific mpg123_pars, using a parameter - * type key chosen from the mpg123_parms enumeration, to the specified value. */ -EXPORT int mpg123_par(mpg123_pars *mp, enum mpg123_parms type, long value, double fvalue); + * type key chosen from the mpg123_parms enumeration, to the specified value. + * \param mp parameter handle + * \param type parameter choice + * \param value integer value + * \param fvalue floating point value + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_par( mpg123_pars *mp +, enum mpg123_parms type, long value, double fvalue ); /** Get a specific parameter, for a specific mpg123_pars. - * See the mpg123_parms enumeration for a list of available parameters. */ -EXPORT int mpg123_getpar(mpg123_pars *mp, enum mpg123_parms type, long *val, double *fval); + * See the mpg123_parms enumeration for a list of available parameters. + * \param mp parameter handle + * \param type parameter choice + * \param value integer value return address + * \param fvalue floating point value return address + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_getpar( mpg123_pars *mp +, enum mpg123_parms type, long *value, double *fvalue); /* @} */ @@ -997,36 +1628,68 @@ EXPORT int mpg123_getpar(mpg123_pars *mp, enum mpg123_parms type, long *val, dou * @{ */ /** Replace default internal buffer with user-supplied buffer. - * Instead of working on it's own private buffer, mpg123 will directly use the one you provide for storing decoded audio. */ -EXPORT int mpg123_replace_buffer(mpg123_handle *mh, unsigned char *data, size_t size); + * Instead of working on it's own private buffer, mpg123 will directly use the one you provide for storing decoded audio. + * Note that the required buffer size could be bigger than expected from output + * encoding if libmpg123 has to convert from primary decoder output (p.ex. 32 bit + * storage for 24 bit output). + * + * Note: The type of data changed to a void pointer in mpg123 1.26.0 + * (API version 45). + * + * \param mh handle + * \param data pointer to user buffer + * \param size of buffer in bytes + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_replace_buffer(mpg123_handle *mh +, void *data, size_t size); /** The max size of one frame's decoded output with current settings. - * Use that to determine an appropriate minimum buffer size for decoding one frame. */ -EXPORT size_t mpg123_outblock(mpg123_handle *mh); + * Use that to determine an appropriate minimum buffer size for decoding one frame. + * \param mh handle + * \return maximum decoded data size in bytes + */ +MPG123_EXPORT size_t mpg123_outblock(mpg123_handle *mh); /** Replace low-level stream access functions; read and lseek as known in POSIX. * You can use this to make any fancy file opening/closing yourself, - * using mpg123_open_fd() to set the file descriptor for your read/lseek (doesn't need to be a "real" file descriptor...). + * using mpg123_open_fd() to set the file descriptor for your read/lseek + * (doesn't need to be a "real" file descriptor...). * Setting a function to NULL means that the default internal read is * used (active from next mpg123_open call on). * Note: As it would be troublesome to mess with this while having a file open, - * this implies mpg123_close(). */ -EXPORT int mpg123_replace_reader(mpg123_handle *mh, ssize_t (*r_read) (int, void *, size_t), off_t (*r_lseek)(int, off_t, int)); + * this implies mpg123_close(). + * \param mh handle + * \param r_read callback for reading (behaviour like POSIX read) + * \param r_lseek callback for seeking (like POSIX lseek) + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_replace_reader( mpg123_handle *mh +, ssize_t (*r_read) (int, void *, size_t) +, off_t (*r_lseek)(int, off_t, int) +); -/** Replace I/O functions with your own ones operating on some kind of handle instead of integer descriptors. +/** Replace I/O functions with your own ones operating on some kind of + * handle instead of integer descriptors. * The handle is a void pointer, so you can pass any data you want... * mpg123_open_handle() is the call you make to use the I/O defined here. * There is no fallback to internal read/seek here. * Note: As it would be troublesome to mess with this while having a file open, * this mpg123_close() is implied here. - * \param r_read The callback for reading (behaviour like posix read). - * \param r_lseek The callback for seeking (like posix lseek). - * \param cleanup A callback to clean up an I/O handle on mpg123_close, can be NULL for none (you take care of cleaning your handles). */ -EXPORT int mpg123_replace_reader_handle(mpg123_handle *mh, ssize_t (*r_read) (void *, void *, size_t), off_t (*r_lseek)(void *, off_t, int), void (*cleanup)(void*)); + * \param mh handle + * \param r_read callback for reading (behaviour like POSIX read) + * \param r_lseek callback for seeking (like POSIX lseek) + * \param cleanup A callback to clean up an I/O handle on mpg123_close, + * can be NULL for none (you take care of cleaning your handles). + * \return MPG123_OK on success + */ +MPG123_EXPORT int mpg123_replace_reader_handle( mpg123_handle *mh +, ssize_t (*r_read) (void *, void *, size_t) +, off_t (*r_lseek)(void *, off_t, int) +, void (*cleanup)(void*) ); /* @} */ - #ifdef __cplusplus } #endif diff --git a/mpg123.32/lib/libmpg123-0.lib b/mpg123.32/lib/libmpg123-0.lib new file mode 100644 index 0000000000000000000000000000000000000000..1dddc020a0ea5b638a8f693f0f0880e732fb8f9f GIT binary patch literal 34076 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 HFVg=33#Pn8 literal 0 HcmV?d00001 diff --git a/mpg123.32/lib/libmpg123.lib b/mpg123.32/lib/libmpg123.lib deleted file mode 100644 index e355565509bff4d699b55bd29de4d2456b362202..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 19996 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 fkxPT**vUL-O-jJ6VrK(DeTh!W#Y$1^c7Y diff --git a/mpg123.64/dist/libmpg123.dll b/mpg123.64/dist/libmpg123-0.dll similarity index 100% rename from mpg123.64/dist/libmpg123.dll rename to mpg123.64/dist/libmpg123-0.dll diff --git a/mpg123.64/lib/libmpg123.lib b/mpg123.64/lib/libmpg123-0.lib similarity index 100% rename from mpg123.64/lib/libmpg123.lib rename to mpg123.64/lib/libmpg123-0.lib diff --git a/src/audio/oal/stream.cpp b/src/audio/oal/stream.cpp index 34080514..eeaaafb0 100644 --- a/src/audio/oal/stream.cpp +++ b/src/audio/oal/stream.cpp @@ -8,13 +8,8 @@ #include #else #ifdef _WIN32 - -// TODO: This is due to version difference of 32-bit libmpg123 and 64-bit libmpg123, fix it -#ifndef _WIN64 -typedef long ssize_t; -#endif #pragma comment( lib, "libsndfile-1.lib" ) -#pragma comment( lib, "libmpg123.lib" ) +#pragma comment( lib, "libmpg123-0.lib" ) #else #include "crossplatform.h" #endif From abb640c6b6b1c4c1b699d18509c8a344e2be2dd5 Mon Sep 17 00:00:00 2001 From: aap Date: Mon, 3 Aug 2020 12:58:37 +0200 Subject: [PATCH 4/5] VU0 collision --- src/core/Collision.cpp | 1118 ++++++++++++++++++++++++++++++++++++- src/core/Collision.h | 79 +++ src/core/SurfaceTable.h | 5 + src/core/common.h | 10 + src/core/config.h | 6 +- src/core/vu0Collision.dsm | 21 + src/core/vu0Collision_1.s | 610 ++++++++++++++++++++ src/core/vu0Collision_2.s | 191 +++++++ src/math/Matrix.h | 1 + src/math/VuVector.h | 41 ++ src/math/math.cpp | 128 +++++ src/render/Shadows.cpp | 4 +- 12 files changed, 2194 insertions(+), 20 deletions(-) create mode 100644 src/core/vu0Collision.dsm create mode 100644 src/core/vu0Collision_1.s create mode 100644 src/core/vu0Collision_2.s create mode 100644 src/math/VuVector.h diff --git a/src/core/Collision.cpp b/src/core/Collision.cpp index 99be816f..6522ff1c 100644 --- a/src/core/Collision.cpp +++ b/src/core/Collision.cpp @@ -1,5 +1,6 @@ #include "common.h" +#include "VuVector.h" #include "main.h" #include "Lists.h" #include "Game.h" @@ -21,6 +22,346 @@ #include "Lines.h" #include "Collision.h" + +// TODO: where do these go? + +#ifdef VU_COLLISION + +struct VuTriangle +{ + // Compressed int16 but unpacked +#ifdef GTA_PS2 + uint128 v0; + uint128 v1; + uint128 v2; + uint128 plane; +#else + int32 v0[4]; + int32 v1[4]; + int32 v2[4]; + int32 plane[4]; +#endif +}; + +#ifndef GTA_PS2 +static int16 vi01; +static CVuVector vf01; +static CVuVector vf02; +static CVuVector vf03; + +CVuVector +DistanceBetweenSphereAndLine(const CVuVector ¢er, const CVuVector &p0, const CVuVector &line) +{ + // center VF12 + // p0 VF14 + // line VF15 + CVuVector ret; // VF16 + CVuVector p1 = p0+line; + CVuVector dist0 = center - p0; // VF20 + CVuVector dist1 = center - p1; // VF25 + float lenSq = line.MagnitudeSqr(); // VF21 + float distSq0 = dist0.MagnitudeSqr(); // VF22 + float distSq1 = dist1.MagnitudeSqr(); + float dot = DotProduct(dist0, line); // VF23 + if(dot < 0.0f){ + // not above line, closest to p0 + ret = p0; + ret.w = distSq0; + return ret; + } + float t = dot/lenSq; // param of nearest point on infinite line + if(t > 1.0f){ + // not above line, closest to p1 + ret = p1; + ret.w = distSq1; + return ret; + } + // closest to line + ret = p0 + line*t; + ret.w = (ret - center).MagnitudeSqr(); + return ret; +} +inline int SignFlags(const CVector &v) +{ + int f = 0; + if(v.x < 0.0f) f |= 1; + if(v.y < 0.0f) f |= 2; + if(v.z < 0.0f) f |= 4; + return f; +} +#endif + +extern "C" void +LineToTriangleCollision(const CVuVector &p0, const CVuVector &p1, + const CVuVector &v0, const CVuVector &v1, const CVuVector &v2, + const CVuVector &plane) +{ +#ifdef GTA_PS2 + __asm__ volatile ( + ".set noreorder\n" + "lqc2 vf12, 0x0(%0)\n" + "lqc2 vf13, 0x0(%1)\n" + "lqc2 vf14, 0x0(%2)\n" + "lqc2 vf15, 0x0(%3)\n" + "lqc2 vf16, 0x0(%4)\n" + "lqc2 vf17, 0x0(%5)\n" + "vcallms Vu0LineToTriangleCollisionStart\n" + ".set reorder\n" + : + : "r" (&p0), "r" (&p1), "r" (&v0), "r" (&v1), "r" (&v2), "r" (&plane) + ); +#else + float dot0 = DotProduct(plane, p0); + float dot1 = DotProduct(plane, p1); + float dist0 = plane.w - dot0; + float dist1 = plane.w - dot1; + + // if points are on the same side, no collision + if(dist0 * dist1 > 0.0f){ + vi01 = 0; + return; + } + + CVuVector diff = p1 - p0; + float t = dist0/(dot1 - dot0); + CVuVector p = p0 + diff*t; + p.w = 0.0f; + vf01 = p; + vf03.x = t; + + // Check if point is inside + CVector cross1 = CrossProduct(p-v0, v1-v0); + CVector cross2 = CrossProduct(p-v1, v2-v1); + CVector cross3 = CrossProduct(p-v2, v0-v2); + // Only check relevant directions + int flagmask = 0; + if(Abs(plane.x) > 0.5f) flagmask |= 1; + if(Abs(plane.y) > 0.5f) flagmask |= 2; + if(Abs(plane.z) > 0.5f) flagmask |= 4; + int flags1 = SignFlags(cross1) & flagmask; + int flags2 = SignFlags(cross2) & flagmask; + int flags3 = SignFlags(cross3) & flagmask; + // inside if on the same side of all edges + if(flags1 != flags2 || flags1 != flags3){ + vi01 = 0; + return; + } + vi01 = 1; + vf02 = plane; + return; +#endif +} + +extern "C" void +LineToTriangleCollisionCompressed(const CVuVector &p0, const CVuVector &p1, VuTriangle &tri) +{ +#ifdef GTA_PS2 + __asm__ volatile ( + ".set noreorder\n" + "lqc2 vf12, 0x0(%0)\n" + "lqc2 vf13, 0x0(%1)\n" + "lqc2 vf14, 0x0(%2)\n" + "lqc2 vf15, 0x10(%2)\n" + "lqc2 vf16, 0x20(%2)\n" + "lqc2 vf17, 0x30(%2)\n" + "vcallms Vu0LineToTriangleCollisionCompressedStart\n" + ".set reorder\n" + : + : "r" (&p0), "r" (&p1), "r" (&tri) + ); +#else + CVuVector v0, v1, v2, plane; + v0.x = tri.v0[0]/128.0f; + v0.y = tri.v0[1]/128.0f; + v0.z = tri.v0[2]/128.0f; + v0.w = tri.v0[3]/128.0f; + v1.x = tri.v1[0]/128.0f; + v1.y = tri.v1[1]/128.0f; + v1.z = tri.v1[2]/128.0f; + v1.w = tri.v1[3]/128.0f; + v2.x = tri.v2[0]/128.0f; + v2.y = tri.v2[1]/128.0f; + v2.z = tri.v2[2]/128.0f; + v2.w = tri.v2[3]/128.0f; + plane.x = tri.plane[0]/4096.0f; + plane.y = tri.plane[1]/4096.0f; + plane.z = tri.plane[2]/4096.0f; + plane.w = tri.plane[3]/128.0f; + LineToTriangleCollision(p0, p1, v0, v1, v2, plane); +#endif +} + +extern "C" void +SphereToTriangleCollision(const CVuVector &sph, + const CVuVector &v0, const CVuVector &v1, const CVuVector &v2, + const CVuVector &plane) +{ +#ifdef GTA_PS2 + __asm__ volatile ( + ".set noreorder\n" + "lqc2 vf12, 0x0(%0)\n" + "lqc2 vf14, 0x0(%1)\n" + "lqc2 vf15, 0x0(%2)\n" + "lqc2 vf16, 0x0(%3)\n" + "lqc2 vf17, 0x0(%4)\n" + "vcallms Vu0SphereToTriangleCollisionStart\n" + ".set reorder\n" + : + : "r" (&sph), "r" (&v0), "r" (&v1), "r" (&v2), "r" (&plane) + ); +#else + float planedist = DotProduct(plane, sph) - plane.w; // VF02 + if(Abs(planedist) > sph.w){ + vi01 = 0; + return; + } + // point on plane + CVuVector p = sph - planedist*plane; + p.w = 0.0f; + vf01 = p; + planedist = Abs(planedist); + // edges + CVuVector v01 = v1 - v0; + CVuVector v12 = v2 - v1; + CVuVector v20 = v0 - v2; + // VU code calculates normal again for some weird reason... + // Check sides of point + CVector cross1 = CrossProduct(p-v0, v01); + CVector cross2 = CrossProduct(p-v1, v12); + CVector cross3 = CrossProduct(p-v2, v20); + // Only check relevant directions + int flagmask = 0; + if(Abs(plane.x) > 0.1f) flagmask |= 1; + if(Abs(plane.y) > 0.1f) flagmask |= 2; + if(Abs(plane.z) > 0.1f) flagmask |= 4; + int nflags = SignFlags(plane) & flagmask; + int flags1 = SignFlags(cross1) & flagmask; + int flags2 = SignFlags(cross2) & flagmask; + int flags3 = SignFlags(cross3) & flagmask; + int testcase = 0; + CVuVector closest(0.0f, 0.0f, 0.0f); // VF04 + if(flags1 == nflags){ + closest += v2; + testcase++; + } + if(flags2 == nflags){ + closest += v0; + testcase++; + } + if(flags3 == nflags){ + closest += v1; + testcase++; + } + if(testcase == 3){ + // inside triangle - dist to plane already checked + vf02 = plane; + vf02.w = vf03.x = planedist; + vi01 = 1; + }else if(testcase == 1){ + // outside two sides - closest to point opposide inside edge + vf01 = closest; + vf02 = sph - closest; + float distSq = vf02.MagnitudeSqr(); + vi01 = sph.w*sph.w > distSq; + vf03.x = Sqrt(distSq); + vf02 *= 1.0f/vf03.x; + }else{ + // inside two sides - closest to third edge + if(flags1 != nflags) + closest = DistanceBetweenSphereAndLine(sph, v0, v01); + else if(flags2 != nflags) + closest = DistanceBetweenSphereAndLine(sph, v1, v12); + else + closest = DistanceBetweenSphereAndLine(sph, v2, v20); + vi01 = sph.w*sph.w > closest.w; + vf01 = closest; + vf02 = sph - closest; + vf03.x = Sqrt(closest.w); + vf02 *= 1.0f/vf03.x; + } +#endif +} + +extern "C" void +SphereToTriangleCollisionCompressed(const CVuVector &sph, VuTriangle &tri) +{ +#ifdef GTA_PS2 + __asm__ volatile ( + ".set noreorder\n" + "lqc2 vf12, 0x0(%0)\n" + "lqc2 vf14, 0x0(%1)\n" + "lqc2 vf15, 0x10(%1)\n" + "lqc2 vf16, 0x20(%1)\n" + "lqc2 vf17, 0x30(%1)\n" + "vcallms Vu0SphereToTriangleCollisionCompressedStart\n" + ".set reorder\n" + : + : "r" (&sph), "r" (&tri) + ); +#else + CVuVector v0, v1, v2, plane; + v0.x = tri.v0[0]/128.0f; + v0.y = tri.v0[1]/128.0f; + v0.z = tri.v0[2]/128.0f; + v0.w = tri.v0[3]/128.0f; + v1.x = tri.v1[0]/128.0f; + v1.y = tri.v1[1]/128.0f; + v1.z = tri.v1[2]/128.0f; + v1.w = tri.v1[3]/128.0f; + v2.x = tri.v2[0]/128.0f; + v2.y = tri.v2[1]/128.0f; + v2.z = tri.v2[2]/128.0f; + v2.w = tri.v2[3]/128.0f; + plane.x = tri.plane[0]/4096.0f; + plane.y = tri.plane[1]/4096.0f; + plane.z = tri.plane[2]/4096.0f; + plane.w = tri.plane[3]/128.0f; + SphereToTriangleCollision(sph, v0, v1, v2, plane); +#endif +} + +inline int +GetVUresult(void) +{ +#ifdef GTA_PS2 + int ret; + __asm__ volatile ( + "cfc2.i %0,vi01\n" // .i important! wait for VU0 to finish + : "=r" (ret) + ); + return ret; +#else + return vi01; +#endif +} + +inline int +GetVUresult(CVuVector &point, CVuVector &normal, float &dist) +{ +#ifdef GTA_PS2 + int ret; + __asm__ volatile ( + "cfc2.i %0,vi01\n" // .i important! wait for VU0 to finish + "sqc2 vf01,(%1)\n" + "sqc2 vf02,(%2)\n" + "qmfc2 $12,vf03\n" + "sw $12,(%3)\n" + : "=r" (ret) + : "r" (&point), "r" (&normal), "r" (&dist) + : "$12" + ); + return ret; +#else + point = vf01; + normal = vf02; + dist = vf03.x; + return vi01; +#endif +} + +#endif + + enum Direction { DIR_X_POS, @@ -397,6 +738,20 @@ CCollision::TestVerticalLineBox(const CColLine &line, const CColBox &box) bool CCollision::TestLineTriangle(const CColLine &line, const CompressedVector *verts, const CColTriangle &tri, const CColTrianglePlane &plane) { +#ifdef VU_COLLISION + // not used in favour of optimized loops + VuTriangle vutri; + verts[tri.a].Unpack(vutri.v0); + verts[tri.b].Unpack(vutri.v1); + verts[tri.c].Unpack(vutri.v2); + plane.Unpack(vutri.plane); + + LineToTriangleCollisionCompressed(*(CVuVector*)&line.p0, *(CVuVector*)&line.p1, vutri); + + if(GetVUresult()) + return true; + return false; +#else float t; CVector normal; plane.GetNormal(normal); @@ -470,6 +825,7 @@ CCollision::TestLineTriangle(const CColLine &line, const CompressedVector *verts if(CrossProduct2D(vec3-vec1, vect-vec1) > 0.0f) return false; if(CrossProduct2D(vec3-vec2, vect-vec2) < 0.0f) return false; return true; +#endif } // Test if line segment intersects with sphere. @@ -507,6 +863,20 @@ bool CCollision::TestSphereTriangle(const CColSphere &sphere, const CompressedVector *verts, const CColTriangle &tri, const CColTrianglePlane &plane) { +#ifdef VU_COLLISION + // not used in favour of optimized loops + VuTriangle vutri; + verts[tri.a].Unpack(vutri.v0); + verts[tri.b].Unpack(vutri.v1); + verts[tri.c].Unpack(vutri.v2); + plane.Unpack(vutri.plane); + + SphereToTriangleCollisionCompressed(*(CVuVector*)&sphere, vutri); + + if(GetVUresult()) + return true; + return false; +#else // If sphere and plane don't intersect, no collision float planedist = plane.CalcPoint(sphere.center); if(Abs(planedist) > sphere.radius) @@ -520,7 +890,9 @@ CCollision::TestSphereTriangle(const CColSphere &sphere, CVector vec2 = vb - va; float len = vec2.Magnitude(); vec2 = vec2 * (1.0f/len); - CVector vec1 = CrossProduct(vec2, plane.normal); + CVector normal; + plane.GetNormal(normal); + CVector vec1 = CrossProduct(vec2, normal); // We know A has local coordinate [0,0] and B has [0,len]. // Now calculate coordinates on triangle for these two vectors: @@ -563,11 +935,78 @@ CCollision::TestSphereTriangle(const CColSphere &sphere, } return dist < sphere.radius; +#endif } bool CCollision::TestLineOfSight(const CColLine &line, const CMatrix &matrix, CColModel &model, bool ignoreSeeThrough) { +#ifdef VU_COLLISION + CMatrix matTransform; + int i; + + // transform line to model space + Invert(matrix, matTransform); + CVuVector newline[2]; + TransformPoints(newline, 2, matTransform, (RwV3d*)&line.p0, sizeof(CColLine)/2); + + // If we don't intersect with the bounding box, no chance on the rest + if(!TestLineBox(*(CColLine*)newline, model.boundingBox)) + return false; + + for(i = 0; i < model.numSpheres; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.spheres[i].surface)) continue; + if(TestLineSphere(*(CColLine*)newline, model.spheres[i])) + return true; + } + + for(i = 0; i < model.numBoxes; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.boxes[i].surface)) continue; + if(TestLineBox(*(CColLine*)newline, model.boxes[i])) + return true; + } + + CalculateTrianglePlanes(&model); + int lastTest = -1; + VuTriangle vutri; + for(i = 0; i < model.numTriangles; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.triangles[i].surface)) continue; + + CColTriangle *tri = &model.triangles[i]; + model.vertices[tri->a].Unpack(vutri.v0); + model.vertices[tri->b].Unpack(vutri.v1); + model.vertices[tri->c].Unpack(vutri.v2); + model.trianglePlanes[i].Unpack(vutri.plane); + + LineToTriangleCollisionCompressed(newline[0], newline[1], vutri); + lastTest = i; + break; + } +#ifdef FIX_BUGS + // no need to check first again + i++; +#endif + for(; i < model.numTriangles; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.triangles[i].surface)) continue; + + CColTriangle *tri = &model.triangles[i]; + model.vertices[tri->a].Unpack(vutri.v0); + model.vertices[tri->b].Unpack(vutri.v1); + model.vertices[tri->c].Unpack(vutri.v2); + model.trianglePlanes[i].Unpack(vutri.plane); + + if(GetVUresult()) + return true; + + LineToTriangleCollisionCompressed(newline[0], newline[1], vutri); + lastTest = i; + + } + if(lastTest != -1 && GetVUresult()) + return true; + + return false; +#else static CMatrix matTransform; int i; @@ -599,6 +1038,7 @@ CCollision::TestLineOfSight(const CColLine &line, const CMatrix &matrix, CColMod } return false; +#endif } @@ -614,20 +1054,24 @@ CCollision::ProcessSphereSphere(const CColSphere &s1, const CColSphere &s2, CCol { CVector dist = s1.center - s2.center; float d = dist.Magnitude() - s2.radius; // distance from s1's center to s2 - float dc = d < 0.0f ? 0.0f : d; // clamp to zero, i.e. if s1's center is inside s2 + float depth = s1.radius - d; // sphere overlap + if(d < 0.0f) d = 0.0f; // clamp to zero, i.e. if s1's center is inside s2 // no collision if sphere is not close enough - if(mindistsq <= dc*dc || s1.radius <= dc) - return false; - dist.Normalise(); - point.point = s1.center - dist*dc; - point.normal = dist; - point.surfaceA = s1.surface; - point.pieceA = s1.piece; - point.surfaceB = s2.surface; - point.pieceB = s2.piece; - point.depth = s1.radius - d; // sphere overlap - mindistsq = dc*dc; // collision radius - return true; + if(d*d < mindistsq && d < s1.radius){ + dist.Normalise(); + point.point = s1.center - dist*d; + point.normal = dist; +#ifndef VU_COLLISION + point.surfaceA = s1.surface; + point.pieceA = s1.piece; + point.surfaceB = s2.surface; + point.pieceB = s2.piece; +#endif + point.depth = depth; + mindistsq = d*d; // collision radius + return true; + } + return false; } bool @@ -667,10 +1111,12 @@ CCollision::ProcessSphereBox(const CColSphere &sph, const CColBox &box, CColPoin if(lensq < mindistsq){ point.normal = dist * (1.0f/Sqrt(lensq)); point.point = sph.center - point.normal; +#ifndef VU_COLLISION point.surfaceA = sph.surface; point.pieceA = sph.piece; point.surfaceB = box.surface; point.pieceB = box.piece; +#endif // find absolute distance to the closer side in each dimension float dx = dist.x > 0.0f ? @@ -710,10 +1156,12 @@ CCollision::ProcessSphereBox(const CColSphere &sph, const CColBox &box, CColPoin float len = Sqrt(lensq); point.point = p; point.normal = dist * (1.0f/len); +#ifndef VU_COLLISION point.surfaceA = sph.surface; point.pieceA = sph.piece; point.surfaceB = box.surface; point.pieceB = box.piece; +#endif point.depth = sph.radius - len; mindistsq = lensq; return true; @@ -828,10 +1276,12 @@ CCollision::ProcessLineBox(const CColLine &line, const CColBox &box, CColPoint & point.point = p; point.normal = normal; +#ifndef VU_COLLISION point.surfaceA = 0; point.pieceA = 0; point.surfaceB = box.surface; point.pieceB = box.piece; +#endif mindist = mint; return true; @@ -861,10 +1311,12 @@ CCollision::ProcessLineSphere(const CColLine &line, const CColSphere &sphere, CC point.point = line.p0 + v01*t; point.normal = point.point - sphere.center; point.normal.Normalise(); +#ifndef VU_COLLISION point.surfaceA = 0; point.pieceA = 0; point.surfaceB = sphere.surface; point.pieceB = sphere.piece; +#endif mindist = t; return true; } @@ -874,6 +1326,17 @@ CCollision::ProcessVerticalLineTriangle(const CColLine &line, const CompressedVector *verts, const CColTriangle &tri, const CColTrianglePlane &plane, CColPoint &point, float &mindist, CStoredCollPoly *poly) { +#ifdef VU_COLLISION + // not used in favour of optimized loops + bool res = ProcessLineTriangle(line, verts, tri, plane, point, mindist); + if(res && poly){ + poly->verts[0] = verts[tri.a].Get(); + poly->verts[1] = verts[tri.b].Get(); + poly->verts[2] = verts[tri.c].Get(); + poly->valid = true; + } + return res; +#else float t; CVector normal; @@ -960,11 +1423,40 @@ CCollision::ProcessVerticalLineTriangle(const CColLine &line, } mindist = t; return true; +#endif } bool CCollision::IsStoredPolyStillValidVerticalLine(const CVector &pos, float z, CColPoint &point, CStoredCollPoly *poly) { +#ifdef VU_COLLISION + if(!poly->valid) + return false; + + CVuVector p0 = pos; + CVuVector p1 = pos; + p1.z = z; + + CVector v01 = poly->verts[1] - poly->verts[0]; + CVector v02 = poly->verts[2] - poly->verts[0]; + CVuVector plane = CrossProduct(v02, v01); + plane.Normalise(); + plane.w = DotProduct(plane, poly->verts[0]); + + LineToTriangleCollision(p0, p1, poly->verts[0], poly->verts[1], poly->verts[2], plane); + + CVuVector pnt; + float dist; + if(!GetVUresult(pnt, plane, dist)) +#ifdef FIX_BUGS + // perhaps not needed but be safe + return poly->valid = false; +#else + return false; +#endif + point.point = pnt; + return true; +#else float t; if(!poly->valid) @@ -987,7 +1479,9 @@ CCollision::IsStoredPolyStillValidVerticalLine(const CVector &pos, float z, CCol return poly->valid = false; // intersection parameter on line - t = -plane.CalcPoint(p0) / DotProduct(p1 - p0, plane.normal); + CVector normal; + plane.GetNormal(normal); + t = -plane.CalcPoint(p0) / DotProduct(p1 - p0, normal); // find point of intersection CVector p = p0 + (p1-p0)*t; @@ -1037,13 +1531,36 @@ CCollision::IsStoredPolyStillValidVerticalLine(const CVector &pos, float z, CCol if(CrossProduct2D(vec3-vec2, vect-vec2) < 0.0f) return poly->valid = false; point.point = p; return poly->valid = true; +#endif } bool -CCollision::ProcessLineTriangle(const CColLine &line , +CCollision::ProcessLineTriangle(const CColLine &line, const CompressedVector *verts, const CColTriangle &tri, const CColTrianglePlane &plane, CColPoint &point, float &mindist) { +#ifdef VU_COLLISION + // not used in favour of optimized loops + VuTriangle vutri; + verts[tri.a].Unpack(vutri.v0); + verts[tri.b].Unpack(vutri.v1); + verts[tri.c].Unpack(vutri.v2); + plane.Unpack(vutri.plane); + + LineToTriangleCollisionCompressed(*(CVuVector*)&line.p0, *(CVuVector*)&line.p1, vutri); + + CVuVector pnt, normal; + float dist; + if(GetVUresult(pnt, normal, dist)){ + if(dist < mindist){ + point.point = pnt; + point.normal = normal; + mindist = dist; + return true; + } + } + return false; +#else float t; CVector normal; plane.GetNormal(normal); @@ -1117,6 +1634,7 @@ CCollision::ProcessLineTriangle(const CColLine &line , point.pieceB = 0; mindist = t; return true; +#endif } bool @@ -1124,6 +1642,30 @@ CCollision::ProcessSphereTriangle(const CColSphere &sphere, const CompressedVector *verts, const CColTriangle &tri, const CColTrianglePlane &plane, CColPoint &point, float &mindistsq) { +#ifdef VU_COLLISION + // not used in favour of optimized loops + VuTriangle vutri; + verts[tri.a].Unpack(vutri.v0); + verts[tri.b].Unpack(vutri.v1); + verts[tri.c].Unpack(vutri.v2); + plane.Unpack(vutri.plane); + + SphereToTriangleCollisionCompressed(*(CVuVector*)&sphere, vutri); + + CVuVector pnt, normal; + float dist; + if(GetVUresult(pnt, normal, dist) && dist*dist < mindistsq){ + float depth = sphere.radius - dist; + if(depth > point.depth){ + point.point = pnt; + point.normal = normal; + point.depth = depth; + mindistsq = dist*dist; + return true; + } + } + return false; +#else // If sphere and plane don't intersect, no collision float planedist = plane.CalcPoint(sphere.center); float distsq = planedist*planedist; @@ -1191,13 +1733,16 @@ CCollision::ProcessSphereTriangle(const CColSphere &sphere, point.point = p; point.normal = sphere.center - p; point.normal.Normalise(); +#ifndef VU_COLLISION point.surfaceA = sphere.surface; point.pieceA = sphere.piece; point.surfaceB = tri.surface; point.pieceB = 0; +#endif point.depth = sphere.radius - dist; mindistsq = dist*dist; return true; +#endif } bool @@ -1205,6 +1750,94 @@ CCollision::ProcessLineOfSight(const CColLine &line, const CMatrix &matrix, CColModel &model, CColPoint &point, float &mindist, bool ignoreSeeThrough) { +#ifdef VU_COLLISION + CMatrix matTransform; + int i; + + // transform line to model space + Invert(matrix, matTransform); + CVuVector newline[2]; + TransformPoints(newline, 2, matTransform, (RwV3d*)&line.p0, sizeof(CColLine)/2); + + if(mindist < 1.0f) + newline[1] = newline[0] + (newline[1] - newline[0])*mindist; + + // If we don't intersect with the bounding box, no chance on the rest + if(!TestLineBox(*(CColLine*)newline, model.boundingBox)) + return false; + + float coldist = 1.0f; + for(i = 0; i < model.numSpheres; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.spheres[i].surface)) continue; + if(ProcessLineSphere(*(CColLine*)newline, model.spheres[i], point, coldist)) + point.Set(0, 0, model.spheres[i].surface, model.spheres[i].piece); + } + + for(i = 0; i < model.numBoxes; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.boxes[i].surface)) continue; + if(ProcessLineBox(*(CColLine*)newline, model.boxes[i], point, coldist)) + point.Set(0, 0, model.boxes[i].surface, model.boxes[i].piece); + } + + CalculateTrianglePlanes(&model); + VuTriangle vutri; + CColTriangle *lasttri = nil; + for(i = 0; i < model.numTriangles; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.triangles[i].surface)) continue; + + CColTriangle *tri = &model.triangles[i]; + model.vertices[tri->a].Unpack(vutri.v0); + model.vertices[tri->b].Unpack(vutri.v1); + model.vertices[tri->c].Unpack(vutri.v2); + model.trianglePlanes[i].Unpack(vutri.plane); + + LineToTriangleCollisionCompressed(newline[0], newline[1], vutri); + lasttri = tri; + break; + } +#ifdef FIX_BUGS + // no need to check first again + i++; +#endif + CVuVector pnt, normal; + float dist; + for(; i < model.numTriangles; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.triangles[i].surface)) continue; + + CColTriangle *tri = &model.triangles[i]; + model.vertices[tri->a].Unpack(vutri.v0); + model.vertices[tri->b].Unpack(vutri.v1); + model.vertices[tri->c].Unpack(vutri.v2); + model.trianglePlanes[i].Unpack(vutri.plane); + + if(GetVUresult(pnt, normal, dist)) + if(dist < coldist){ + point.point = pnt; + point.normal = normal; + point.Set(0, 0, lasttri->surface, 0); + coldist = dist; + } + + LineToTriangleCollisionCompressed(newline[0], newline[1], vutri); + lasttri = tri; + } + if(lasttri && GetVUresult(pnt, normal, dist)) + if(dist < coldist){ + point.point = pnt; + point.normal = normal; + point.Set(0, 0, lasttri->surface, 0); + coldist = dist; + } + + + if(coldist < 1.0f){ + point.point = matrix * point.point; + point.normal = Multiply3x3(matrix, point.normal); + mindist *= coldist; + return true; + } + return false; +#else static CMatrix matTransform; int i; @@ -1240,6 +1873,7 @@ CCollision::ProcessLineOfSight(const CColLine &line, return true; } return false; +#endif } bool @@ -1247,6 +1881,125 @@ CCollision::ProcessVerticalLine(const CColLine &line, const CMatrix &matrix, CColModel &model, CColPoint &point, float &mindist, bool ignoreSeeThrough, CStoredCollPoly *poly) { +#ifdef VU_COLLISION + static CStoredCollPoly TempStoredPoly; + CMatrix matTransform; + int i; + + // transform line to model space + Invert(matrix, matTransform); + CVuVector newline[2]; + TransformPoints(newline, 2, matTransform, (RwV3d*)&line.p0, sizeof(CColLine)/2); + + if(mindist < 1.0f) + newline[1] = newline[0] + (newline[1] - newline[0])*mindist; + + if(!TestLineBox(*(CColLine*)newline, model.boundingBox)) + return false; + + float coldist = 1.0f; + for(i = 0; i < model.numSpheres; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.spheres[i].surface)) continue; + if(ProcessLineSphere(*(CColLine*)newline, model.spheres[i], point, coldist)) + point.Set(0, 0, model.spheres[i].surface, model.spheres[i].piece); + } + + for(i = 0; i < model.numBoxes; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.boxes[i].surface)) continue; + if(ProcessLineBox(*(CColLine*)newline, model.boxes[i], point, coldist)) + point.Set(0, 0, model.boxes[i].surface, model.boxes[i].piece); + } + + CalculateTrianglePlanes(&model); + TempStoredPoly.valid = false; + if(model.numTriangles){ + bool registeredCol; + CColTriangle *lasttri = nil; + VuTriangle vutri; + for(i = 0; i < model.numTriangles; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.triangles[i].surface)) continue; + + CColTriangle *tri = &model.triangles[i]; + model.vertices[tri->a].Unpack(vutri.v0); + model.vertices[tri->b].Unpack(vutri.v1); + model.vertices[tri->c].Unpack(vutri.v2); + model.trianglePlanes[i].Unpack(vutri.plane); + + LineToTriangleCollisionCompressed(newline[0], newline[1], vutri); + lasttri = tri; + break; + } +#ifdef FIX_BUGS + // no need to check first again + i++; +#endif + CVuVector pnt, normal; + float dist; + for(; i < model.numTriangles; i++){ + if(ignoreSeeThrough && IsSeeThrough(model.triangles[i].surface)) continue; + + CColTriangle *tri = &model.triangles[i]; + model.vertices[tri->a].Unpack(vutri.v0); + model.vertices[tri->b].Unpack(vutri.v1); + model.vertices[tri->c].Unpack(vutri.v2); + model.trianglePlanes[i].Unpack(vutri.plane); + + if(GetVUresult(pnt, normal, dist)){ + if(dist < coldist){ + point.point = pnt; + point.normal = normal; + point.Set(0, 0, lasttri->surface, 0); + coldist = dist; + registeredCol = true; + }else + registeredCol = false; + }else + registeredCol = false; + + if(registeredCol){ + TempStoredPoly.verts[0] = model.vertices[lasttri->a].Get(); + TempStoredPoly.verts[1] = model.vertices[lasttri->b].Get(); + TempStoredPoly.verts[2] = model.vertices[lasttri->c].Get(); + TempStoredPoly.valid = true; + } + + LineToTriangleCollisionCompressed(newline[0], newline[1], vutri); + lasttri = tri; + } + if(lasttri && GetVUresult(pnt, normal, dist)){ + if(dist < coldist){ + point.point = pnt; + point.normal = normal; + point.Set(0, 0, lasttri->surface, 0); + coldist = dist; + registeredCol = true; + }else + registeredCol = false; + }else + registeredCol = false; + + if(registeredCol){ + TempStoredPoly.verts[0] = model.vertices[lasttri->a].Get(); + TempStoredPoly.verts[1] = model.vertices[lasttri->b].Get(); + TempStoredPoly.verts[2] = model.vertices[lasttri->c].Get(); + TempStoredPoly.valid = true; + } + } + + if(coldist < 1.0f){ + point.point = matrix * point.point; + point.normal = Multiply3x3(matrix, point.normal); + if(TempStoredPoly.valid && poly){ + *poly = TempStoredPoly; + poly->verts[0] = matrix * CVector(poly->verts[0]); + poly->verts[1] = matrix * CVector(poly->verts[1]); + poly->verts[2] = matrix * CVector(poly->verts[2]); + } + mindist *= coldist; + return true; + } + return false; +#else static CStoredCollPoly TempStoredPoly; int i; @@ -1290,6 +2043,7 @@ CCollision::ProcessVerticalLine(const CColLine &line, return true; } return false; +#endif } enum { @@ -1299,6 +2053,15 @@ enum { MAXNUMTRIS = 600 }; +#ifdef VU_COLLISION +#ifdef GTA_PS2 +#define SPR(off) ((uint8*)(0x70000000 + (off))) +#else +static uint8 fakeSPR[16*1024]; +#define SPR(off) ((uint8*)(fakeSPR + (off))) +#endif +#endif + // This checks model A's spheres and lines against model B's spheres, boxes and triangles. // Returns the number of A's spheres that collide. // Returned ColPoints are in world space. @@ -1308,6 +2071,308 @@ CCollision::ProcessColModels(const CMatrix &matrixA, CColModel &modelA, const CMatrix &matrixB, CColModel &modelB, CColPoint *spherepoints, CColPoint *linepoints, float *linedists) { +#ifdef VU_COLLISION + CVuVector *aSpheresA = (CVuVector*)SPR(0x0000); + CVuVector *aSpheresB = (CVuVector*)SPR(0x0800); + CVuVector *aLinesA = (CVuVector*)SPR(0x1000); + int32 *aSphereIndicesA = (int32*)SPR(0x1200); + int32 *aSphereIndicesB = (int32*)SPR(0x1400); + int32 *aBoxIndicesB = (int32*)SPR(0x1600); + int32 *aTriangleIndicesB = (int32*)SPR(0x1680); + bool *aCollided = (bool*)SPR(0x1FE0); + CMatrix &matAB = *(CMatrix*)SPR(0x1FF0); + CMatrix &matBA = *(CMatrix*)SPR(0x2040); + int i, j, k; + + // From model A space to model B space + Invert(matrixB, matAB); + matAB *= matrixA; + + CVuVector bsphereAB; // bounding sphere of A in B space + TransformPoint(bsphereAB, matAB, *(RwV3d*)modelA.boundingSphere.center); // inlined + bsphereAB.w = modelA.boundingSphere.radius; + if(!TestSphereBox(*(CColSphere*)&bsphereAB, modelB.boundingBox)) + return 0; + + // transform modelA's spheres and lines to B space + TransformPoints(aSpheresA, modelA.numSpheres, matAB, (RwV3d*)&modelA.spheres->center, sizeof(CColSphere)); + for(i = 0; i < modelA.numSpheres; i++) + aSpheresA[i].w = modelA.spheres[i].radius; + TransformPoints(aLinesA, modelA.numLines*2, matAB, (RwV3d*)&modelA.lines->p0, sizeof(CColLine)/2); + + // Test them against model B's bounding volumes + int numSpheresA = 0; + for(i = 0; i < modelA.numSpheres; i++) + if(TestSphereBox(*(CColSphere*)&aSpheresA[i], modelB.boundingBox)) + aSphereIndicesA[numSpheresA++] = i; + // No collision + if(numSpheresA == 0 && modelA.numLines == 0) + return 0; + + + // B to A space + Invert(matrixA, matBA); + matBA *= matrixB; + + // transform modelB's spheres to A space + TransformPoints(aSpheresB, modelB.numSpheres, matBA, (RwV3d*)&modelB.spheres->center, sizeof(CColSphere)); + for(i = 0; i < modelB.numSpheres; i++) + aSpheresB[i].w = modelB.spheres[i].radius; + + // Check model B against A's bounding volumes + int numSpheresB = 0; + int numBoxesB = 0; + int numTrianglesB = 0; + for(i = 0; i < modelB.numSpheres; i++) + if(TestSphereBox(*(CColSphere*)&aSpheresB[i], modelA.boundingBox)) + aSphereIndicesB[numSpheresB++] = i; + for(i = 0; i < modelB.numBoxes; i++) + if(TestSphereBox(*(CColSphere*)&bsphereAB, modelB.boxes[i])) + aBoxIndicesB[numBoxesB++] = i; + CalculateTrianglePlanes(&modelB); + if(modelB.numTriangles){ + VuTriangle vutri; + // process the first triangle + CColTriangle *tri = &modelB.triangles[0]; + modelB.vertices[tri->a].Unpack(vutri.v0); + modelB.vertices[tri->b].Unpack(vutri.v1); + modelB.vertices[tri->c].Unpack(vutri.v2); + modelB.trianglePlanes[0].Unpack(vutri.plane); + + SphereToTriangleCollisionCompressed(bsphereAB, vutri); + + for(i = 1; i < modelB.numTriangles; i++){ + // set up the next triangle while VU0 is running + tri = &modelB.triangles[i]; + modelB.vertices[tri->a].Unpack(vutri.v0); + modelB.vertices[tri->b].Unpack(vutri.v1); + modelB.vertices[tri->c].Unpack(vutri.v2); + modelB.trianglePlanes[i].Unpack(vutri.plane); + + // check previous result + if(GetVUresult()) + aTriangleIndicesB[numTrianglesB++] = i-1; + + // kick off this one + SphereToTriangleCollisionCompressed(bsphereAB, vutri); + } + + // check last result + if(GetVUresult()) + aTriangleIndicesB[numTrianglesB++] = i-1; + } + // No collision + if(numSpheresB == 0 && numBoxesB == 0 && numTrianglesB == 0) + return 0; + + // We now have the collision volumes in A and B that are worth processing. + + // Process A's spheres against B's collision volumes + int numCollisions = 0; + spherepoints[numCollisions].depth = -1.0f; + for(i = 0; i < numSpheresA; i++){ + float coldist = 1.0e24f; + bool hasCollided = false; + CColSphere *sphA = &modelA.spheres[aSphereIndicesA[i]]; + CVuVector *vusphA = &aSpheresA[aSphereIndicesA[i]]; + + for(j = 0; j < numSpheresB; j++) + // This actually looks like something was inlined here + if(ProcessSphereSphere(*(CColSphere*)vusphA, modelB.spheres[aSphereIndicesB[j]], + spherepoints[numCollisions], coldist)){ + spherepoints[numCollisions].Set( + sphA->surface, sphA->piece, + modelB.spheres[aSphereIndicesB[j]].surface, modelB.spheres[aSphereIndicesB[j]].piece); + hasCollided = true; + } + for(j = 0; j < numBoxesB; j++) + if(ProcessSphereBox(*(CColSphere*)vusphA, modelB.boxes[aBoxIndicesB[j]], + spherepoints[numCollisions], coldist)){ + spherepoints[numCollisions].Set( + sphA->surface, sphA->piece, + modelB.boxes[aBoxIndicesB[j]].surface, modelB.boxes[aBoxIndicesB[j]].piece); + hasCollided = true; + } + if(numTrianglesB){ + CVuVector point, normal; + float depth; + bool registeredCol; + CColTriangle *lasttri; + + VuTriangle vutri; + // process the first triangle + k = aTriangleIndicesB[0]; + CColTriangle *tri = &modelB.triangles[k]; + modelB.vertices[tri->a].Unpack(vutri.v0); + modelB.vertices[tri->b].Unpack(vutri.v1); + modelB.vertices[tri->c].Unpack(vutri.v2); + modelB.trianglePlanes[k].Unpack(vutri.plane); + + SphereToTriangleCollisionCompressed(*vusphA, vutri); + lasttri = tri; + + for(j = 1; j < numTrianglesB; j++){ + k = aTriangleIndicesB[j]; + // set up the next triangle while VU0 is running + tri = &modelB.triangles[k]; + modelB.vertices[tri->a].Unpack(vutri.v0); + modelB.vertices[tri->b].Unpack(vutri.v1); + modelB.vertices[tri->c].Unpack(vutri.v2); + modelB.trianglePlanes[k].Unpack(vutri.plane); + + // check previous result + // TODO: this looks inlined but spherepoints[numCollisions] does not... + if(GetVUresult(point, normal, depth)){ + depth = sphA->radius - depth; + if(depth > spherepoints[numCollisions].depth){ + spherepoints[numCollisions].point = point; + spherepoints[numCollisions].normal = normal; + spherepoints[numCollisions].Set(depth, + sphA->surface, sphA->piece, lasttri->surface, 0); + registeredCol = true; + }else + registeredCol = false; + }else + registeredCol = false; + + if(registeredCol) + hasCollided = true; + + // kick off this one + SphereToTriangleCollisionCompressed(*vusphA, vutri); + lasttri = tri; + } + + // check last result + // TODO: this looks inlined but spherepoints[numCollisions] does not... + if(GetVUresult(point, normal, depth)){ + depth = sphA->radius - depth; + if(depth > spherepoints[numCollisions].depth){ + spherepoints[numCollisions].point = point; + spherepoints[numCollisions].normal = normal; + spherepoints[numCollisions].Set(depth, + sphA->surface, sphA->piece, lasttri->surface, 0); + registeredCol = true; + }else + registeredCol = false; + }else + registeredCol = false; + + if(registeredCol) + hasCollided = true; + } + + if(hasCollided){ + numCollisions++; + if(numCollisions == MAX_COLLISION_POINTS) + break; + spherepoints[numCollisions].depth = -1.0f; + } + } + for(i = 0; i < numCollisions; i++){ + // TODO: both VU0 macros + spherepoints[i].point = matrixB * spherepoints[i].point; + spherepoints[i].normal = Multiply3x3(matrixB, spherepoints[i].normal); + } + + // And the same thing for the lines in A + for(i = 0; i < modelA.numLines; i++){ + aCollided[i] = false; + CVuVector *lineA = &aLinesA[i*2]; + + for(j = 0; j < numSpheresB; j++) + if(ProcessLineSphere(*(CColLine*)lineA, modelB.spheres[aSphereIndicesB[j]], + linepoints[i], linedists[i])){ + linepoints[i].Set(0, 0, +#ifdef FIX_BUGS + modelB.spheres[aSphereIndicesB[j]].surface, modelB.spheres[aSphereIndicesB[j]].piece); +#else + modelB.spheres[j].surface, modelB.spheres[j].piece); +#endif + aCollided[i] = true; + } + for(j = 0; j < numBoxesB; j++) + if(ProcessLineBox(*(CColLine*)lineA, modelB.boxes[aBoxIndicesB[j]], + linepoints[i], linedists[i])){ + linepoints[i].Set(0, 0, + modelB.boxes[aBoxIndicesB[j]].surface, modelB.boxes[aBoxIndicesB[j]].piece); + aCollided[i] = true; + } + if(numTrianglesB){ + CVuVector point, normal; + float dist; + bool registeredCol; + CColTriangle *lasttri; + + VuTriangle vutri; + // process the first triangle + k = aTriangleIndicesB[0]; + CColTriangle *tri = &modelB.triangles[k]; + modelB.vertices[tri->a].Unpack(vutri.v0); + modelB.vertices[tri->b].Unpack(vutri.v1); + modelB.vertices[tri->c].Unpack(vutri.v2); + modelB.trianglePlanes[k].Unpack(vutri.plane); + + LineToTriangleCollisionCompressed(lineA[0], lineA[1], vutri); + lasttri = tri; + + for(j = 1; j < numTrianglesB; j++){ + k = aTriangleIndicesB[j]; + // set up the next triangle while VU0 is running + CColTriangle *tri = &modelB.triangles[k]; + modelB.vertices[tri->a].Unpack(vutri.v0); + modelB.vertices[tri->b].Unpack(vutri.v1); + modelB.vertices[tri->c].Unpack(vutri.v2); + modelB.trianglePlanes[k].Unpack(vutri.plane); + + // check previous result + // TODO: this again somewhat looks inlined + if(GetVUresult(point, normal, dist)){ + if(dist < linedists[i]){ + linepoints[i].point = point; + linepoints[i].normal = normal; + linedists[i] = dist; + linepoints[i].Set(0, 0, lasttri->surface, 0); + registeredCol = true; + }else + registeredCol = false; + }else + registeredCol = false; + + if(registeredCol) + aCollided[i] = true; + + // kick of this one + LineToTriangleCollisionCompressed(lineA[0], lineA[1], vutri); + lasttri = tri; + } + + // check last result + if(GetVUresult(point, normal, dist)){ + if(dist < linedists[i]){ + linepoints[i].point = point; + linepoints[i].normal = normal; + linedists[i] = dist; + linepoints[i].Set(0, 0, lasttri->surface, 0); + registeredCol = true; + }else + registeredCol = false; + }else + registeredCol = false; + + if(registeredCol) + aCollided[i] = true; + } + + if(aCollided[i]){ + // TODO: both VU0 macros + linepoints[i].point = matrixB * linepoints[i].point; + linepoints[i].normal = Multiply3x3(matrixB, linepoints[i].normal); + } + } + + return numCollisions; // sphere collisions +#else static int aSphereIndicesA[MAXNUMSPHERES]; static int aLineIndicesA[MAXNUMLINES]; static int aSphereIndicesB[MAXNUMSPHERES]; @@ -1324,14 +2389,16 @@ CCollision::ProcessColModels(const CMatrix &matrixA, CColModel &modelA, assert(modelA.numLines <= MAXNUMLINES); // From model A space to model B space - matAB = Invert(matrixB, matAB) * matrixA; + Invert(matrixB, matAB); + matAB *= matrixA; CColSphere bsphereAB; // bounding sphere of A in B space bsphereAB.Set(modelA.boundingSphere.radius, matAB * modelA.boundingSphere.center); if(!TestSphereBox(bsphereAB, modelB.boundingBox)) return 0; // B to A space - matBA = Invert(matrixA, matBA) * matrixB; + matBA = Invert(matrixA, matBA); + matBA *= matrixB; // transform modelA's spheres and lines to B space for(i = 0; i < modelA.numSpheres; i++){ @@ -1444,6 +2511,7 @@ CCollision::ProcessColModels(const CMatrix &matrixA, CColModel &modelA, } return numCollisions; // sphere collisions +#endif } @@ -1987,6 +3055,19 @@ CColTriangle::Set(const CompressedVector *, int a, int b, int c, uint8 surf, uin this->surface = surf; } +#ifdef VU_COLLISION +void +CColTrianglePlane::Set(const CVector &va, const CVector &vb, const CVector &vc) +{ + CVector norm = CrossProduct(vc-va, vb-va); + norm.Normalise(); + float d = DotProduct(norm, va); + normal.x = norm.x*4096.0f; + normal.y = norm.y*4096.0f; + normal.z = norm.z*4096.0f; + dist = d*128.0f; +} +#else void CColTrianglePlane::Set(const CVector &va, const CVector &vb, const CVector &vc) { @@ -2002,6 +3083,7 @@ CColTrianglePlane::Set(const CVector &va, const CVector &vb, const CVector &vc) else dir = normal.z < 0.0f ? DIR_Z_NEG : DIR_Z_POS; } +#endif CColModel::CColModel(void) { diff --git a/src/core/Collision.h b/src/core/Collision.h index d988f0c2..ccc99244 100644 --- a/src/core/Collision.h +++ b/src/core/Collision.h @@ -2,6 +2,9 @@ #include "templates.h" #include "Game.h" // for eLevelName +#ifdef VU_COLLISION +#include "VuVector.h" +#endif // If you spawn many tanks at once, you will see that collisions of two entity exceeds 32. #ifdef FIX_BUGS @@ -16,6 +19,28 @@ struct CompressedVector int16 x, y, z; CVector Get(void) const { return CVector(x, y, z)/128.0f; }; void Set(float x, float y, float z) { this->x = x*128.0f; this->y = y*128.0f; this->z = z*128.0f; }; +#ifdef GTA_PS2 + void Unpack(uint128 &qword) const { + __asm__ volatile ( + "lh $8, 0(%1)\n" + "lh $9, 2(%1)\n" + "lh $10, 4(%1)\n" + "pextlw $10, $8\n" + "pextlw $2, $9, $10\n" + "sq $2, %0\n" + : "=m" (qword) + : "r" (this) + : "$8", "$9", "$10", "$2" + ); + } +#else + void Unpack(int32 *qword) const { + qword[0] = x; + qword[1] = y; + qword[2] = z; + qword[3] = 0; // junk + } +#endif #else float x, y, z; CVector Get(void) const { return CVector(x, y, z); }; @@ -25,6 +50,7 @@ struct CompressedVector struct CColSphere { + // NB: this has to be compatible with a CVuVector CVector center; float radius; uint8 surface; @@ -47,6 +73,7 @@ struct CColBox struct CColLine { + // NB: this has to be compatible with two CVuVectors CVector p0; int pad0; CVector p1; @@ -69,6 +96,39 @@ struct CColTriangle struct CColTrianglePlane { +#ifdef VU_COLLISION + CompressedVector normal; + int16 dist; + + void Set(const CVector &va, const CVector &vb, const CVector &vc); + void Set(const CompressedVector *v, CColTriangle &tri) { Set(v[tri.a].Get(), v[tri.b].Get(), v[tri.c].Get()); } + void GetNormal(CVector &n) const { n.x = normal.x/4096.0f; n.y = normal.y/4096.0f; n.z = normal.z/4096.0f; } + float CalcPoint(const CVector &v) const { CVector n; GetNormal(n); return DotProduct(n, v) - dist/128.0f; }; +#ifdef GTA_PS2 + void Unpack(uint128 &qword) const { + __asm__ volatile ( + "lh $8, 0(%1)\n" + "lh $9, 2(%1)\n" + "lh $10, 4(%1)\n" + "lh $11, 6(%1)\n" + "pextlw $10, $8\n" + "pextlw $11, $9\n" + "pextlw $2, $11, $10\n" + "sq $2, %0\n" + : "=m" (qword) + : "r" (this) + : "$8", "$9", "$10", "$11", "$2" + ); + } +#else + void Unpack(int32 *qword) const { + qword[0] = normal.x; + qword[1] = normal.y; + qword[2] = normal.z; + qword[3] = dist; + } +#endif +#else CVector normal; float dist; uint8 dir; @@ -77,6 +137,7 @@ struct CColTrianglePlane void Set(const CompressedVector *v, CColTriangle &tri) { Set(v[tri.a].Get(), v[tri.b].Get(), v[tri.c].Get()); } void GetNormal(CVector &n) const { n = normal; } float CalcPoint(const CVector &v) const { return DotProduct(normal, v) - dist; }; +#endif }; struct CColPoint @@ -91,11 +152,29 @@ struct CColPoint uint8 surfaceB; uint8 pieceB; float depth; + + void Set(float depth, uint8 surfA, uint8 pieceA, uint8 surfB, uint8 pieceB) { + this->depth = depth; + this->surfaceA = surfA; + this->pieceA = pieceA; + this->surfaceB = surfB; + this->pieceB = pieceB; + } + void Set(uint8 surfA, uint8 pieceA, uint8 surfB, uint8 pieceB) { + this->surfaceA = surfA; + this->pieceA = pieceA; + this->surfaceB = surfB; + this->pieceB = pieceB; + } }; struct CStoredCollPoly { +#ifdef VU_COLLISION + CVuVector verts[3]; +#else CVector verts[3]; +#endif bool valid; }; diff --git a/src/core/SurfaceTable.h b/src/core/SurfaceTable.h index 1f16843d..8ee1724e 100644 --- a/src/core/SurfaceTable.h +++ b/src/core/SurfaceTable.h @@ -60,6 +60,11 @@ IsSeeThrough(uint8 surfType) switch(surfType) case SURFACE_GLASS: case SURFACE_TRANSPARENT_CLOTH: +#if defined(FIX_BUGS) || defined(GTA_PS2) + case SURFACE_METAL_CHAIN_FENCE: + case SURFACE_TRANSPARENT_STONE: + case SURFACE_SCAFFOLD_POLE: +#endif return true; return false; } diff --git a/src/core/common.h b/src/core/common.h index ebb3acb0..e876c4ec 100644 --- a/src/core/common.h +++ b/src/core/common.h @@ -89,6 +89,16 @@ typedef uint16_t wchar; #include #endif +#ifdef __GNUC__ +#define TYPEALIGN(n) __attribute__ ((aligned (n))) +#else +#ifdef _MSC_VER +#define TYPEALIGN(n) __declspec(align(n)) +#else +#define TYPEALIGN(n) // unknown compiler...ignore +#endif +#endif + #define ALIGNPTR(p) (void*)((((uintptr)(void*)p) + sizeof(void*)-1) & ~(sizeof(void*)-1)) // PDP-10 like byte functions diff --git a/src/core/config.h b/src/core/config.h index 94a35782..92b9f2f9 100644 --- a/src/core/config.h +++ b/src/core/config.h @@ -158,7 +158,7 @@ enum Config { #if defined GTA_PS2 # define GTA_PS2_STUFF # define RANDOMSPLASH -# define COMPRESSED_COL_VECTORS +# define VU_COLLISION #elif defined GTA_PC # define GTA3_1_1_PATCH //# define GTA3_STEAM_PATCH @@ -170,6 +170,10 @@ enum Config { #elif defined GTA_XBOX #endif +#ifdef VU_COLLISION +#define COMPRESSED_COL_VECTORS // current need compressed vectors in this code +#endif + #ifdef MASTER // only in master builds #else diff --git a/src/core/vu0Collision.dsm b/src/core/vu0Collision.dsm new file mode 100644 index 00000000..657c8b81 --- /dev/null +++ b/src/core/vu0Collision.dsm @@ -0,0 +1,21 @@ +.align 4 +.global Vu0CollisionDmaTag +Vu0CollisionDmaTag: +DMAcnt * +MPG 0, * +.vu +.include "vu0Collision_1.s" +.EndMPG +.EndDmaData +DMAend + +.global Vu0Collision2DmaTag +Vu0Collision2DmaTag: +DMAcnt * +MPG 0, * +.vu +.include "vu0Collision_2.s" +.EndMPG +.EndDmaData +DMAend +.end diff --git a/src/core/vu0Collision_1.s b/src/core/vu0Collision_1.s new file mode 100644 index 00000000..055c8640 --- /dev/null +++ b/src/core/vu0Collision_1.s @@ -0,0 +1,610 @@ +QuitAndFail: + NOP[E] IADDIU VI01, VI00, 0 + NOP NOP + + +QuitAndSucceed: + NOP[E] IADDIU VI01, VI00, 1 + NOP NOP + + +; 20 -- unused +; VF12, VF13 xyz: sphere centers +; VF14, VF15 x: sphere radii +; out: +; VI01: set when collision +; VF01: supposed to be intersection point? +; VF02: normal (pointing towards s1, not normalized) +.globl Vu0SphereToSphereCollision +Vu0SphereToSphereCollision: + SUB.xyz VF02, VF13, VF12 NOP ; dist of centers + ADD.x VF04, VF14, VF15 NOP ; s = sum of radii + MUL.xyzw VF03, VF02, VF02 NOP ; + MUL.x VF04, VF04, VF04 DIV Q, VF14x, VF04x ; square s + NOP NOP ; + NOP NOP ; + MULAx.w ACC, VF00, VF03 NOP ; + MADDAy.w ACC, VF00, VF03 NOP ; + MADDz.w VF03, VF00, VF03 NOP ; d = DistSq of centers + NOP NOP ; + MULAw.xyz ACC, VF12, VF00 NOP ; + MADDq.xyz VF01, VF02, Q NOP ; intersection, but wrong + CLIPw.xyz VF04, VF03 NOP ; compare s and d + SUB.xyz VF02, VF00, VF02 NOP ; compute normal + NOP NOP ; + NOP NOP ; + NOP FCAND VI01, 0x3 ; 0x2 cannot be set here + NOP[E] NOP ; + NOP NOP ; + + +; B8 -- unused +; VF12: +; VF13: radius +; VF14: +; VF15: box dimensions (?) +.globl Vu0SphereToAABBCollision +Vu0SphereToAABBCollision: + SUB.xyz VF03, VF12, VF14 LOI 0.5 + MULi.xyz VF15, VF15, I NOP + MUL.x VF13, VF13, VF13 NOP + SUB.xyz VF04, VF03, VF15 NOP + ADD.xyz VF05, VF03, VF15 MR32.xyzw VF16, VF15 + CLIPw.xyz VF03, VF16 MR32.xyzw VF17, VF16 + MUL.xyz VF04, VF04, VF04 NOP + MUL.xyz VF05, VF05, VF05 NOP + CLIPw.xyz VF03, VF17 MR32.xyzw VF16, VF17 + NOP FCAND VI01, 0x1 + MINI.xyz VF04, VF04, VF05 MFIR.x VF09, VI01 + NOP NOP + CLIPw.xyz VF03, VF16 FCAND VI01, 0x4 + NOP MFIR.y VF09, VI01 + NOP NOP + MULAx.w ACC, VF00, VF00 NOP + ADD.xyz VF01, VF00, VF03 FCAND VI01, 0x10 + NOP MFIR.z VF09, VI01 + NOP LOI 2 + NOP FCAND VI01, 0x30 + SUBAw.xyz ACC, VF00, VF00 IADD VI04, VI00, VI01 + ITOF0.xyz VF09, VF09 FCAND VI01, 0x300 + NOP IADD VI03, VI00, VI01 + NOP FCAND VI01, 0x3000 + NOP IADD VI02, VI00, VI01 + MADDi.xyzw VF09, VF09, I NOP + NOP IBEQ VI04, VI00, IgnoreZValue + NOP NOP + MADDAz.w ACC, VF00, VF04 NOP + MUL.z VF01, VF09, VF15 NOP +IgnoreZValue: + NOP IBEQ VI03, VI00, IgnoreYValue + NOP NOP + MADDAy.w ACC, VF00, VF04 NOP + MUL.y VF01, VF09, VF15 NOP +IgnoreYValue: + NOP IBEQ VI02, VI00, IgnoreXValue + NOP NOP + MADDAx.w ACC, VF00, VF04 NOP + MUL.x VF01, VF09, VF15 NOP +IgnoreXValue: + MADDx.w VF06, VF00, VF00 NOP + SUB.xyz VF02, VF03, VF01 NOP + ADD.xyz VF01, VF01, VF14 NOP + MULx.w VF01, VF00, VF00 NOP + CLIPw.xyz VF13, VF06 NOP + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x1 +QuitMicrocode: + NOP[E] NOP + NOP NOP + + +; 240 +.globl Vu0LineToSphereCollision +Vu0LineToSphereCollision: + SUB.xyzw VF01, VF13, VF12 NOP + SUB.xyzw VF02, VF14, VF12 NOP + MUL.xyz VF03, VF01, VF02 NOP + MUL.xyz VF04, VF01, VF01 NOP + MUL.x VF15, VF15, VF15 NOP + MUL.xyz VF02, VF02, VF02 NOP + MULAx.w ACC, VF00, VF03 NOP + MADDAy.w ACC, VF00, VF03 NOP + MADDz.w VF03, VF00, VF03 NOP + MULAx.w ACC, VF00, VF04 NOP + MADDAy.w ACC, VF00, VF04 NOP + MADDz.w VF01, VF00, VF04 NOP + MULAx.w ACC, VF00, VF02 NOP + MADDAy.w ACC, VF00, VF02 NOP + MADDz.w VF02, VF00, VF02 NOP + MULA.w ACC, VF03, VF03 NOP + MADDAx.w ACC, VF01, VF15 NOP + MSUB.w VF05, VF01, VF02 NOP + NOP NOP + NOP NOP + NOP IADDIU VI02, VI00, 0x10 + NOP FMAND VI01, VI02 + NOP IBNE VI01, VI00, QuitAndFail + NOP NOP + CLIPw.xyz VF15, VF02 SQRT Q, VF05w + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x1 + NOP IBNE VI00, VI01, LineStartInsideSphere + NOP NOP + SUBq.w VF05, VF03, Q NOP + SUB.w VF05, VF05, VF01 DIV Q, VF05w, VF01w + NOP FMAND VI01, VI02 + NOP IBNE VI01, VI00, QuitAndFail + NOP NOP + NOP FMAND VI01, VI02 + NOP IBEQ VI01, VI00, QuitAndFail + NOP NOP + ADDA.xyz ACC, VF12, VF00 NOP + MADDq.xyz VF01, VF01, Q NOP + MULx.w VF01, VF00, VF00 NOP + SUB.xyz VF02, VF01, VF14 NOP + NOP[E] NOP + NOP NOP +LineStartInsideSphere: + NOP MOVE.xyzw VF01, VF12 + NOP[E] IADDIU VI01, VI00, 0x1 + NOP NOP + + +; 3C0 +.globl Vu0LineToAABBCollision +Vu0LineToAABBCollision: + SUB.xyzw VF08, VF13, VF12 LOI 0.5 + MULi.xyz VF15, VF15, I IADDIU VI08, VI00, 0x0 + SUB.xyzw VF12, VF12, VF14 NOP + SUB.xyzw VF13, VF13, VF14 NOP + NOP DIV Q, VF00w, VF08x + NOP MR32.xyzw VF03, VF15 + SUB.xyz VF06, VF15, VF12 NOP + ADD.xyz VF07, VF15, VF12 NOP + NOP NOP + CLIPw.xyz VF12, VF03 MR32.xyzw VF04, VF03 + NOP NOP + ADDq.x VF09, VF00, Q DIV Q, VF00w, VF08y + NOP NOP + CLIPw.xyz VF12, VF04 MR32.xyzw VF05, VF04 + SUB.xyz VF07, VF00, VF07 IADDIU VI06, VI00, 0xCC + NOP IADDIU VI07, VI00, 0x30 + NOP NOP + CLIPw.xyz VF12, VF05 FCGET VI02 + NOP IAND VI02, VI02, VI06 + ADDq.y VF09, VF00, Q DIV Q, VF00w, VF08z + SUB.xyz VF10, VF00, VF10 NOP + CLIPw.xyz VF13, VF03 FCGET VI03 + CLIPw.xyz VF13, VF04 IAND VI03, VI03, VI07 + CLIPw.xyz VF13, VF05 FCAND VI01, 0x3330 + NOP IBEQ VI01, VI00, StartPointInsideAABB + NOP NOP + ADDq.z VF09, VF00, Q FCGET VI04 + NOP FCGET VI05 + NOP IAND VI04, VI04, VI06 + NOP IAND VI05, VI05, VI07 + MULx.xyz VF17, VF08, VF09 NOP + MULy.xyz VF18, VF08, VF09 IADDIU VI07, VI00, 0x80 + MULz.xyz VF19, VF08, VF09 IAND VI06, VI02, VI07 + MUL.w VF10, VF00, VF00 IAND VI07, VI04, VI07 + NOP NOP + NOP IBEQ VI06, VI07, CheckMaxXSide + NOP NOP + MULAx.xyz ACC, VF17, VF07 NOP + MADDw.xyz VF16, VF12, VF00 NOP + MUL.x VF10, VF07, VF09 NOP + CLIPw.xyz VF16, VF04 NOP + CLIPw.xyz VF16, VF05 NOP + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x330 + NOP IBNE VI01, VI00, CheckMaxXSide + NOP NOP + MULx.w VF10, VF00, VF10 IADDIU VI08, VI00, 0x1 + ADD.yz VF02, VF00, VF00 MOVE.xyzw VF01, VF16 + SUBw.x VF02, VF00, VF00 NOP +CheckMaxXSide: + MULAx.xyz ACC, VF17, VF06 IADDIU VI07, VI00, 0x40 + MADDw.xyz VF16, VF12, VF00 IAND VI06, VI02, VI07 + MUL.x VF10, VF06, VF09 IAND VI07, VI04, VI07 + NOP NOP + NOP IBEQ VI06, VI07, CheckMinYSide + NOP NOP + CLIPw.xyz VF16, VF04 NOP + CLIPw.xyz VF16, VF05 NOP + CLIPw.xyz VF10, VF10 NOP + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0xCC03 + NOP IBNE VI01, VI00, CheckMinYSide + NOP NOP + MULx.w VF10, VF00, VF10 IADDIU VI08, VI00, 0x1 + ADD.yz VF02, VF00, VF00 MOVE.xyzw VF01, VF16 + ADDw.x VF02, VF00, VF00 NOP +CheckMinYSide: + MULAy.xyz ACC, VF18, VF07 IADDIU VI07, VI00, 0x8 + MADDw.xyz VF16, VF12, VF00 IAND VI06, VI02, VI07 + MUL.y VF10, VF07, VF09 IAND VI07, VI04, VI07 + NOP NOP + NOP IBEQ VI06, VI07, CheckMaxYSide + NOP NOP + CLIPw.xyz VF16, VF03 NOP + CLIPw.xyz VF16, VF05 NOP + CLIPw.xyz VF10, VF10 NOP + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x3C0C + NOP IBNE VI01, VI00, CheckMaxYSide + NOP NOP + MULy.w VF10, VF00, VF10 IADDIU VI08, VI00, 0x1 + ADD.xz VF02, VF00, VF00 MOVE.xyzw VF01, VF16 + SUBw.y VF02, VF00, VF00 NOP +CheckMaxYSide: + MULAy.xyz ACC, VF18, VF06 IADDIU VI07, VI00, 0x4 + MADDw.xyz VF16, VF12, VF00 IAND VI06, VI02, VI07 + MUL.y VF10, VF06, VF09 IAND VI07, VI04, VI07 + NOP NOP + NOP IBEQ VI06, VI07, CheckMinZSide + NOP NOP + CLIPw.xyz VF16, VF03 NOP + CLIPw.xyz VF16, VF05 NOP + CLIPw.xyz VF10, VF10 NOP + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x3C0C + NOP IBNE VI01, VI00, CheckMinZSide + NOP NOP + MULy.w VF10, VF00, VF10 IADDIU VI08, VI00, 0x1 + ADD.xz VF02, VF00, VF00 MOVE.xyzw VF01, VF16 + ADDw.y VF02, VF00, VF00 NOP +CheckMinZSide: + MULAz.xyz ACC, VF19, VF07 IADDIU VI07, VI00, 0x20 + MADDw.xyz VF16, VF12, VF00 IAND VI06, VI03, VI07 + MUL.z VF10, VF07, VF09 IAND VI07, VI05, VI07 + NOP NOP + NOP IBEQ VI06, VI07, CheckMaxZSide + NOP NOP + CLIPw.xyz VF16, VF03 NOP + CLIPw.xyz VF16, VF04 NOP + CLIPw.xyz VF10, VF10 NOP + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x3330 + NOP IBNE VI01, VI00, CheckMaxZSide + NOP NOP + MULz.w VF10, VF00, VF10 IADDIU VI08, VI00, 0x1 + ADD.xy VF02, VF00, VF00 MOVE.xyzw VF01, VF16 + SUBw.z VF02, VF00, VF00 NOP +CheckMaxZSide: + MULAz.xyz ACC, VF19, VF06 IADDIU VI07, VI00, 0x10 + MADDw.xyz VF16, VF12, VF00 IAND VI06, VI03, VI07 + MUL.z VF10, VF06, VF09 IAND VI07, VI05, VI07 + NOP NOP + NOP IBEQ VI06, VI07, DoneAllChecks + NOP NOP + CLIPw.xyz VF16, VF03 NOP + CLIPw.xyz VF16, VF04 NOP + CLIPw.xyz VF10, VF10 NOP + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x3330 + NOP IBNE VI01, VI00, DoneAllChecks + NOP NOP + MULz.w VF10, VF00, VF10 IADDIU VI08, VI00, 0x1 + ADD.xy VF02, VF00, VF00 MOVE.xyzw VF01, VF16 + ADDw.z VF02, VF00, VF00 NOP +DoneAllChecks: + ADD.xyz VF01, VF01, VF14 IADD VI01, VI00, VI08 + NOP[E] NOP + NOP NOP +StartPointInsideAABB: + ADD.xyz VF01, VF12, VF14 WAITQ + NOP IADDIU VI01, VI00, 0x1 + NOP[E] NOP + NOP NOP + + +; 860 +.globl Vu0LineToTriangleCollisionCompressedStart +Vu0LineToTriangleCollisionCompressedStart: + ITOF0.xyzw VF17, VF17 LOI 0.000244140625 ; 1.0/4096.0 + ITOF0.xyzw VF14, VF14 NOP + ITOF0.xyzw VF15, VF15 NOP + ITOF0.xyzw VF16, VF16 NOP + MULi.xyz VF17, VF17, I LOI 0.0078125 ; 1.0/128.0 + MULi.w VF17, VF17, I NOP + MULi.xyzw VF14, VF14, I NOP + MULi.xyzw VF15, VF15, I NOP + MULi.xyzw VF16, VF16, I NOP +; fall through + +; 8A8 +; VF12: point0 +; VF13: point1 +; VF14-16: verts +; VF17: plane +; out: +; VF01: intersection point +; VF02: triangle normal +; VF03 x: intersection parameter +.globl Vu0LineToTriangleCollisionStart +Vu0LineToTriangleCollisionStart: + MUL.xyz VF10, VF17, VF12 LOI 0.5 + MUL.xyz VF11, VF17, VF13 NOP + SUB.xyz VF02, VF13, VF12 NOP ; line dist + ADD.xyz VF17, VF17, VF00 NOP + MULi.w VF03, VF00, I NOP + MULAx.w ACC, VF00, VF10 NOP + MADDAy.w ACC, VF00, VF10 IADDIU VI06, VI00, 0xE0 + MADDz.w VF10, VF00, VF10 FMAND VI05, VI06 ; -- normal sign flags, unused + MULAx.w ACC, VF00, VF11 NOP + MADDAy.w ACC, VF00, VF11 NOP + MADDz.w VF11, VF00, VF11 NOP + SUB.w VF09, VF17, VF10 NOP ; plane-pos 0 + CLIPw.xyz VF17, VF03 NOP ; compare normal against 0.5 to figure out which in which dimension to compare + NOP IADDIU VI02, VI00, 0x10 ; Sw flag + SUBA.w ACC, VF17, VF11 NOP ; plane-pos 1 + SUB.w VF08, VF11, VF10 FMAND VI01, VI02 + NOP NOP + NOP NOP + NOP FMAND VI02, VI02 + NOP IBEQ VI01, VI02, QuitAndFail ; if on same side, no collision + NOP NOP + NOP DIV Q, VF09w, VF08w ; parameter of intersection + NOP FCAND VI01, 0x3 ; check x direction + NOP IADDIU VI02, VI01, 0x7F + NOP IADDIU VI06, VI00, 0x80 + NOP IAND VI02, VI02, VI06 ; Sx flag + NOP FCAND VI01, 0xC ; check y direction + NOP IADDIU VI03, VI01, 0x3F + MULAw.xyz ACC, VF12, VF00 IADDIU VI06, VI00, 0x40 + MADDq.xyz VF01, VF02, Q IAND VI03, VI03, VI06 ; point of intersection -- Sy flag + MULx.w VF01, VF00, VF00 FCAND VI01, 0x30 ; -- check z direction + ADDq.x VF03, VF00, Q IADDIU VI04, VI01, 0x1F ; output parameter + SUB.xyz VF05, VF15, VF14 IADDIU VI06, VI00, 0x20 ; edge vectors + SUB.xyz VF08, VF01, VF14 IAND VI04, VI04, VI06 ; edge vectors -- Sz flag + SUB.xyz VF06, VF16, VF15 IADD VI06, VI02, VI03 ; edge vectors + SUB.xyz VF09, VF01, VF15 IADD VI06, VI06, VI04 ; edge vectors -- combine flags + SUB.xyz VF07, VF14, VF16 NOP ; edge vectors + SUB.xyz VF10, VF01, VF16 NOP ; edge vectors + OPMULA.xyz ACC, VF08, VF05 NOP + OPMSUB.xyz VF18, VF05, VF08 NOP ; cross1 + OPMULA.xyz ACC, VF09, VF06 NOP + OPMSUB.xyz VF19, VF06, VF09 NOP ; cross2 + OPMULA.xyz ACC, VF10, VF07 NOP + OPMSUB.xyz VF20, VF07, VF10 FMAND VI02, VI06 ; cross3 + NOP NOP + NOP FMAND VI03, VI06 + NOP NOP + NOP FMAND VI04, VI06 + NOP NOP + NOP IBNE VI03, VI02, QuitAndFail ; point has to lie on the same side of all edges (i.e. inside) + NOP NOP + NOP IBNE VI04, VI02, QuitAndFail + NOP NOP + MULw.xyz VF02, VF17, VF00 IADDIU VI01, VI00, 0x1 ; success + NOP[E] NOP + NOP NOP + + +; A68 +; VF12: center +; VF14: line origin +; VF15: line vector to other point +; out: VF16 xyz: nearest point on line; w: distance to that point +DistanceBetweenSphereAndLine: + SUB.xyz VF20, VF12, VF14 NOP + MUL.xyz VF21, VF15, VF15 NOP + ADDA.xyz ACC, VF14, VF15 NOP + MSUBw.xyz VF25, VF12, VF00 NOP ; VF25 = VF12 - (VF14+VF15) + MUL.xyz VF22, VF20, VF20 NOP + MUL.xyz VF23, VF20, VF15 NOP + MULAx.w ACC, VF00, VF21 NOP + MADDAy.w ACC, VF00, VF21 NOP + MADDz.w VF21, VF00, VF21 NOP ; MagSq VF15 (line length) + MULAx.w ACC, VF00, VF23 NOP + MADDAy.w ACC, VF00, VF23 NOP + MADDz.w VF23, VF00, VF23 NOP ; dot(VF12-VF14, VF15) + MULAx.w ACC, VF00, VF22 NOP + MADDAy.w ACC, VF00, VF22 NOP + MADDz.w VF22, VF00, VF22 IADDIU VI08, VI00, 0x10 ; MagSq VF12-VF14 -- Sw bit + MUL.xyz VF25, VF25, VF25 FMAND VI08, VI08 + NOP DIV Q, VF23w, VF21w + NOP IBNE VI00, VI08, NegativeRatio + NOP NOP + ADDA.xyz ACC, VF00, VF14 NOP + MADDq.xyz VF16, VF15, Q WAITQ ; nearest point on infinte line + ADDq.x VF24, VF00, Q NOP ; ratio + NOP NOP + NOP NOP + SUB.xyz VF26, VF16, VF12 NOP + CLIPw.xyz VF24, VF00 NOP ; compare ratio to 1.0 + NOP NOP + NOP NOP + MUL.xyz VF26, VF26, VF26 NOP + NOP FCAND VI01, 0x1 + NOP IBNE VI00, VI01, RatioGreaterThanOne + NOP NOP + MULAx.w ACC, VF00, VF26 NOP + MADDAy.w ACC, VF00, VF26 NOP + MADDz.w VF16, VF00, VF26 NOP ; distance + NOP JR VI15 + NOP NOP +NegativeRatio: + ADD.xyz VF16, VF00, VF14 NOP ; return line origin + MUL.w VF16, VF00, VF22 NOP ; and DistSq to it + NOP JR VI15 + NOP NOP +RatioGreaterThanOne: + MULAx.w ACC, VF00, VF25 NOP + MADDAy.w ACC, VF00, VF25 NOP + MADDz.w VF16, VF00, VF25 NOP + ADD.xyz VF16, VF14, VF15 NOP ; return toerh line point + NOP JR VI15 + NOP NOP + + +; BE0 +.globl Vu0SphereToTriangleCollisionCompressedStart +Vu0SphereToTriangleCollisionCompressedStart: + ITOF0.xyzw VF17, VF17 LOI 0.000244140625 ; 1.0/4096.0 + ITOF0.xyzw VF14, VF14 NOP + ITOF0.xyzw VF15, VF15 NOP + ITOF0.xyzw VF16, VF16 NOP + MULi.xyz VF17, VF17, I LOI 0.0078125 ; 1.0/128.0 + MULi.w VF17, VF17, I NOP + MULi.xyzw VF14, VF14, I NOP + MULi.xyzw VF15, VF15, I NOP + MULi.xyzw VF16, VF16, I NOP +; fall through + +; C28 +; VF12: sphere +; VF14-16: verts +; VF17: plane +; out: +; VF01: intersection point +; VF02: triangle normal +; VF03 x: intersection parameter +.globl Vu0SphereToTriangleCollisionStart +Vu0SphereToTriangleCollisionStart: + MUL.xyz VF02, VF12, VF17 LOI 0.1 + ADD.xyz VF17, VF17, VF00 NOP + ADDw.x VF13, VF00, VF12 NOP + NOP NOP + MULAx.w ACC, VF00, VF02 IADDIU VI06, VI00, 0xE0 + MADDAy.w ACC, VF00, VF02 FMAND VI05, VI06 ; normal sign flags + MADDAz.w ACC, VF00, VF02 NOP + MSUB.w VF02, VF00, VF17 NOP ; center plane pos + MULi.w VF03, VF00, I MOVE.xyzw VF04, VF03 + NOP NOP + NOP NOP + CLIPw.xyz VF13, VF02 NOP ; compare dist and radius + CLIPw.xyz VF17, VF03 NOP + MULAw.xyz ACC, VF12, VF00 IADDIU VI07, VI00, 0x0 ; -- clear test case + MSUBw.xyz VF01, VF17, VF02 NOP + MULx.w VF01, VF00, VF00 FCAND VI01, 0x3 ; projected center on plane + ABS.w VF02, VF02 IBEQ VI00, VI01, QuitAndFail ; no intersection + NOP NOP + NOP FCAND VI01, 0x3 ; -- check x direction + SUB.xyz VF02, VF12, VF01 IADDIU VI02, VI01, 0x7F + NOP IADDIU VI06, VI00, 0x80 + SUB.xyz VF05, VF15, VF14 IAND VI02, VI02, VI06 + SUB.xyz VF08, VF01, VF14 FCAND VI01, 0xC ; -- check y direction + SUB.xyz VF06, VF16, VF15 IADDIU VI03, VI01, 0x3F + SUB.xyz VF09, VF01, VF15 IADDIU VI06, VI00, 0x40 + SUB.xyz VF07, VF14, VF16 IAND VI03, VI03, VI06 + SUB.xyz VF10, VF01, VF16 FCAND VI01, 0x30 ; -- check z direction + MUL.xyz VF03, VF02, VF02 IADDIU VI04, VI01, 0x1F + OPMULA.xyz ACC, VF08, VF05 IADDIU VI06, VI00, 0x20 + OPMSUB.xyz VF18, VF05, VF08 IAND VI04, VI04, VI06 + OPMULA.xyz ACC, VF09, VF06 NOP + OPMSUB.xyz VF19, VF06, VF09 IADD VI06, VI02, VI03 + OPMULA.xyz ACC, VF10, VF07 IADD VI06, VI06, VI04 ; -- combine flags + OPMSUB.xyz VF20, VF07, VF10 FMAND VI02, VI06 ; -- cross 1 flags + MULAx.w ACC, VF00, VF03 IAND VI05, VI05, VI06 + MADDAy.w ACC, VF00, VF03 FMAND VI03, VI06 ; -- cross 2 flags + MADDz.w VF03, VF00, VF03 IADDIU VI08, VI00, 0x3 + NOP FMAND VI04, VI06 ; -- cross 3 flags + NOP NOP + NOP IBNE VI02, VI05, CheckSide2 + NOP RSQRT Q, VF00w, VF03w + ADD.xyz VF04, VF00, VF16 IADDIU VI07, VI07, 0x1 ; inside side 1 +CheckSide2: + NOP IBNE VI03, VI05, CheckSide3 + NOP NOP + ADD.xyz VF04, VF00, VF14 IADDIU VI07, VI07, 0x1 ; inside side 2 +CheckSide3: + NOP IBNE VI04, VI05, FinishCheckingSides + NOP NOP + ADD.xyz VF04, VF00, VF15 IADDIU VI07, VI07, 0x1 ; inside side 3 + NOP NOP + NOP IBEQ VI07, VI08, TotallyInsideTriangle + NOP NOP +FinishCheckingSides: + MUL.x VF13, VF13, VF13 IADDIU VI08, VI00, 0x2 + MULq.xyz VF02, VF02, Q WAITQ + NOP IBNE VI07, VI08, IntersectionOutsideTwoSides + NOP NOP + NOP IBEQ VI02, VI05, CheckDistanceSide2 + NOP NOP + NOP MOVE.xyzw VF15, VF05 + NOP BAL VI15, DistanceBetweenSphereAndLine + NOP NOP + NOP B ProcessLineResult + NOP NOP +CheckDistanceSide2: + NOP IBEQ VI03, VI05, CheckDistanceSide3 + NOP NOP + NOP MOVE.xyzw VF14, VF15 + NOP MOVE.xyzw VF15, VF06 + NOP BAL VI15, DistanceBetweenSphereAndLine + NOP NOP + NOP B ProcessLineResult + NOP NOP +CheckDistanceSide3: + NOP MOVE.xyzw VF14, VF16 + NOP MOVE.xyzw VF15, VF07 + NOP BAL VI15, DistanceBetweenSphereAndLine + NOP NOP + NOP B ProcessLineResult + NOP NOP +IntersectionOutsideTwoSides: + SUB.xyz VF05, VF04, VF12 NOP + ADD.xyz VF01, VF00, VF04 NOP ; col point + SUB.xyz VF02, VF12, VF04 NOP + NOP NOP + MUL.xyz VF05, VF05, VF05 NOP + NOP NOP + NOP NOP + NOP NOP + MULAx.w ACC, VF00, VF05 NOP + MADDAy.w ACC, VF00, VF05 NOP + MADDz.w VF05, VF00, VF05 NOP ; distSq to vertex + NOP NOP + NOP NOP + NOP NOP + CLIPw.xyz VF13, VF05 SQRT Q, VF05w ; compare radiusSq and distSq + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x1 + ADDq.x VF03, VF00, Q WAITQ ; dist to vertex + NOP IBEQ VI00, VI01, QuitAndFail ; too far + NOP NOP + NOP NOP + NOP DIV Q, VF00w, VF03x + MULq.xyz VF02, VF02, Q WAITQ ; col normal + NOP[E] NOP + NOP NOP +TotallyInsideTriangle: + ADDw.x VF03, VF00, VF02 WAITQ + MULq.xyz VF02, VF02, Q NOP + NOP[E] IADDIU VI01, VI00, 0x1 + NOP NOP +ProcessLineResult: + CLIPw.xyz VF13, VF16 SQRT Q, VF16w + ADD.xyz VF01, VF00, VF16 NOP + SUB.xyz VF02, VF12, VF16 NOP + NOP NOP + NOP FCAND VI01, 0x1 + ADDq.x VF03, VF00, Q WAITQ + NOP IBEQ VI00, VI01, QuitAndFail + NOP NOP + NOP NOP + NOP DIV Q, VF00w, VF03x + MULq.xyz VF02, VF02, Q WAITQ + NOP[E] NOP + NOP NOP + +EndOfMicrocode: diff --git a/src/core/vu0Collision_2.s b/src/core/vu0Collision_2.s new file mode 100644 index 00000000..716c29ac --- /dev/null +++ b/src/core/vu0Collision_2.s @@ -0,0 +1,191 @@ +QuitAndFail2: + NOP[E] IADDIU VI01, VI00, 0x0 + NOP NOP + + +QuitAndSucceed2: + NOP[E] IADDIU VI01, VI00, 0x1 + NOP NOP + + +; 20 +GetBBVertices: + MULw.xy VF02, VF01, VF00 NOP + MUL.z VF02, VF01, VF11 NOP + MULw.xz VF03, VF01, VF00 NOP + MUL.y VF03, VF01, VF11 NOP + MULw.x VF04, VF01, VF00 NOP + MUL.yz VF04, VF01, VF11 NOP + NOP JR VI15 + NOP NOP + + +; 60 +Vu0OBBToOBBCollision: + SUBw.xyz VF11, VF00, VF00 LOI 0.5 + MULi.xyz VF12, VF12, I NOP + MULi.xyz VF13, VF13, I NOP + NOP NOP + NOP NOP + NOP MOVE.xyz VF01, VF12 + NOP BAL VI15, GetBBVertices + NOP NOP + MULAx.xyz ACC, VF14, VF01 NOP + MADDAy.xyz ACC, VF15, VF01 NOP + MADDz.xyz VF01, VF16, VF01 NOP + MULAx.xyz ACC, VF14, VF02 NOP + MADDAy.xyz ACC, VF15, VF02 NOP + MADDz.xyz VF02, VF16, VF02 NOP + MULAx.xyz ACC, VF14, VF03 NOP + MADDAy.xyz ACC, VF15, VF03 NOP + MADDz.xyz VF03, VF16, VF03 NOP + MULAx.xyz ACC, VF14, VF04 NOP + MADDAy.xyz ACC, VF15, VF04 NOP + MADDz.xyz VF04, VF16, VF04 NOP + ABS.xyz VF05, VF01 NOP + ABS.xyz VF06, VF02 NOP + ABS.xyz VF07, VF03 NOP + ABS.xyz VF08, VF04 NOP + NOP NOP + MAX.xyz VF05, VF05, VF06 NOP + NOP NOP + MAX.xyz VF07, VF07, VF08 NOP + NOP NOP + NOP NOP + NOP NOP + MAX.xyz VF05, VF05, VF07 NOP + NOP NOP + NOP NOP + NOP NOP + ADD.xyz VF09, VF05, VF13 NOP + NOP NOP + NOP NOP + NOP NOP + MULx.w VF05, VF00, VF09 NOP + MULy.w VF06, VF00, VF09 NOP + MULz.w VF07, VF00, VF09 NOP + CLIPw.xyz VF17, VF05 NOP + CLIPw.xyz VF17, VF06 NOP + CLIPw.xyz VF17, VF07 MOVE.xyz VF01, VF13 + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x3330 + NOP IBNE VI01, VI00, QuitAndFail2 + NOP NOP + NOP BAL VI15, GetBBVertices + NOP NOP + MULAx.xyz ACC, VF18, VF01 NOP + MADDAy.xyz ACC, VF19, VF01 NOP + MADDz.xyz VF01, VF20, VF01 NOP + MULAx.xyz ACC, VF18, VF02 NOP + MADDAy.xyz ACC, VF19, VF02 NOP + MADDz.xyz VF02, VF20, VF02 NOP + MULAx.xyz ACC, VF18, VF03 NOP + MADDAy.xyz ACC, VF19, VF03 NOP + MADDz.xyz VF03, VF20, VF03 NOP + MULAx.xyz ACC, VF18, VF04 NOP + MADDAy.xyz ACC, VF19, VF04 NOP + MADDz.xyz VF04, VF20, VF04 NOP + ABS.xyz VF05, VF01 NOP + ABS.xyz VF06, VF02 NOP + ABS.xyz VF07, VF03 NOP + ABS.xyz VF08, VF04 NOP + NOP NOP + MAX.xyz VF05, VF05, VF06 NOP + NOP NOP + MAX.xyz VF07, VF07, VF08 NOP + NOP NOP + NOP NOP + NOP NOP + MAX.xyz VF05, VF05, VF07 NOP + NOP NOP + NOP NOP + NOP NOP + ADD.xyz VF09, VF05, VF12 NOP + NOP NOP + NOP NOP + NOP NOP + MULx.w VF05, VF00, VF09 NOP + MULy.w VF06, VF00, VF09 NOP + MULz.w VF07, VF00, VF09 NOP + CLIPw.xyz VF21, VF05 NOP + CLIPw.xyz VF21, VF06 NOP + CLIPw.xyz VF21, VF07 NOP + NOP NOP + NOP NOP + NOP NOP + NOP FCAND VI01, 0x3330 + NOP IBNE VI01, VI00, QuitAndFail2 + NOP NOP + SUB.xyz VF06, VF02, VF01 NOP + SUB.xyz VF07, VF03, VF01 NOP + ADD.xyz VF08, VF04, VF01 NOP + ADD.x VF09, VF00, VF12 NOP + ADD.yz VF09, VF00, VF00 NOP + ADD.y VF10, VF00, VF12 NOP + ADD.xz VF10, VF00, VF00 NOP + ADD.z VF11, VF00, VF12 IADDI VI04, VI00, 0x0 + ADD.xy VF11, VF00, VF00 IADD VI02, VI00, VI00 + OPMULA.xyz ACC, VF06, VF09 NOP + OPMSUB.xyz VF01, VF09, VF06 NOP + OPMULA.xyz ACC, VF06, VF10 NOP + OPMSUB.xyz VF02, VF10, VF06 NOP + OPMULA.xyz ACC, VF06, VF11 NOP + OPMSUB.xyz VF03, VF11, VF06 SQI.xyzw VF01, (VI02++) + OPMULA.xyz ACC, VF07, VF09 NOP + OPMSUB.xyz VF01, VF09, VF07 SQI.xyzw VF02, (VI02++) + OPMULA.xyz ACC, VF07, VF10 NOP + OPMSUB.xyz VF02, VF10, VF07 SQI.xyzw VF03, (VI02++) + OPMULA.xyz ACC, VF07, VF11 NOP + OPMSUB.xyz VF03, VF11, VF07 SQI.xyzw VF01, (VI02++) + OPMULA.xyz ACC, VF08, VF09 NOP + OPMSUB.xyz VF01, VF09, VF08 SQI.xyzw VF02, (VI02++) + OPMULA.xyz ACC, VF08, VF10 NOP + OPMSUB.xyz VF02, VF10, VF08 SQI.xyzw VF03, (VI02++) + OPMULA.xyz ACC, VF08, VF11 LOI 0.5 + OPMSUB.xyz VF01, VF11, VF08 SQI.xyzw VF01, (VI02++) + MULi.xyz VF06, VF06, I NOP + MULi.xyz VF07, VF07, I SQI.xyzw VF02, (VI02++) + MULi.xyz VF08, VF08, I NOP + MUL.xyz VF02, VF21, VF01 NOP + MUL.xyz VF03, VF12, VF01 NOP + MUL.xyz VF09, VF06, VF01 NOP + MUL.xyz VF10, VF07, VF01 NOP + MUL.xyz VF11, VF08, VF01 NOP + ABS.xyz VF03, VF03 NOP + ADDy.x VF05, VF09, VF09 NOP + ADDx.y VF05, VF10, VF10 NOP + ADDx.z VF05, VF11, VF11 NOP + NOP NOP +EdgePairLoop: + ADDz.x VF05, VF05, VF09 NOP + ADDz.y VF05, VF05, VF10 NOP + ADDy.z VF05, VF05, VF11 NOP + MULAx.w ACC, VF00, VF02 IADD VI03, VI02, VI00 + MADDAy.w ACC, VF00, VF02 LQD.xyzw VF01, (--VI02) + MADDz.w VF02, VF00, VF02 NOP + ABS.xyz VF05, VF05 NOP + MULAx.w ACC, VF00, VF03 NOP + MADDAy.w ACC, VF00, VF03 NOP + MADDAz.w ACC, VF00, VF03 NOP + MADDAx.w ACC, VF00, VF05 NOP + MADDAy.w ACC, VF00, VF05 NOP + MADDz.w VF03, VF00, VF05 NOP + ADDw.x VF04, VF00, VF02 NOP + MUL.xyz VF02, VF21, VF01 NOP + MUL.xyz VF03, VF12, VF01 NOP + MUL.xyz VF09, VF06, VF01 NOP + CLIPw.xyz VF04, VF03 NOP + MUL.xyz VF10, VF07, VF01 NOP + MUL.xyz VF11, VF08, VF01 NOP + ABS.xyz VF03, VF03 NOP + ADDy.x VF05, VF09, VF09 FCAND VI01, 0x3 + ADDx.y VF05, VF10, VF10 IBNE VI01, VI00, QuitAndFail2 + ADDx.z VF05, VF11, VF11 NOP + NOP IBNE VI03, VI00, EdgePairLoop + NOP NOP + NOP[E] IADDIU VI01, VI00, 0x1 + NOP NOP + +EndOfMicrocode2: diff --git a/src/math/Matrix.h b/src/math/Matrix.h index c849a5c4..e2d6b0e0 100644 --- a/src/math/Matrix.h +++ b/src/math/Matrix.h @@ -81,6 +81,7 @@ public: m_matrix.pos.z += rhs.m_matrix.pos.z; return *this; } + CMatrix& operator*=(CMatrix const &rhs); CVector &GetPosition(void){ return *(CVector*)&m_matrix.pos; } CVector &GetRight(void) { return *(CVector*)&m_matrix.right; } diff --git a/src/math/VuVector.h b/src/math/VuVector.h new file mode 100644 index 00000000..f90818e0 --- /dev/null +++ b/src/math/VuVector.h @@ -0,0 +1,41 @@ +#pragma once + +class TYPEALIGN(16) CVuVector : public CVector +{ +public: + float w; + CVuVector(void) {} + CVuVector(float x, float y, float z) : CVector(x, y, z) {} + CVuVector(float x, float y, float z, float w) : CVector(x, y, z), w(w) {} + CVuVector(const CVector &v) : CVector(v.x, v.y, v.z) {} +#ifdef RWCORE_H + CVuVector(const RwV3d &v) : CVector(v.x, v.y, v.z) {} + + operator RwV3d (void) const { + RwV3d vecRw = { this->x, this->y, this->z }; + return vecRw; + } + + operator RwV3d *(void) { + return (RwV3d*)this; + } +#endif +/* + void Normalise(void) { + float sq = MagnitudeSqr(); + // TODO: VU0 code + if(sq > 0.0f){ + float invsqrt = RecipSqrt(sq); + x *= invsqrt; + y *= invsqrt; + z *= invsqrt; + }else + x = 1.0f; + } +*/ +}; + +void TransformPoint(CVuVector &out, const CMatrix &mat, const CVuVector &in); +void TransformPoint(CVuVector &out, const CMatrix &mat, const RwV3d &in); +void TransformPoints(CVuVector *out, int n, const CMatrix &mat, const RwV3d *in, int stride); +void TransformPoints(CVuVector *out, int n, const CMatrix &mat, const CVuVector *in); diff --git a/src/math/math.cpp b/src/math/math.cpp index 0cfc2ce9..4792fdd0 100644 --- a/src/math/math.cpp +++ b/src/math/math.cpp @@ -1,9 +1,124 @@ #include "common.h" #include "Quaternion.h" +#include "VuVector.h" // TODO: move more stuff into here + +void TransformPoint(CVuVector &out, const CMatrix &mat, const CVuVector &in) +{ +#ifdef GTA_PS2 + __asm__ __volatile__("\n\ + lqc2 vf01,0x0(%2)\n\ + lqc2 vf02,0x0(%1)\n\ + lqc2 vf03,0x10(%1)\n\ + lqc2 vf04,0x20(%1)\n\ + lqc2 vf05,0x30(%1)\n\ + vmulax.xyz ACC, vf02,vf01\n\ + vmadday.xyz ACC, vf03,vf01\n\ + vmaddaz.xyz ACC, vf04,vf01\n\ + vmaddw.xyz vf06,vf05,vf00\n\ + sqc2 vf06,0x0(%0)\n\ + ": : "r" (&out) , "r" (&mat) ,"r" (&in): "memory"); +#else + out = mat * in; +#endif +} + +void TransformPoint(CVuVector &out, const CMatrix &mat, const RwV3d &in) +{ +#ifdef GTA_PS2 + __asm__ __volatile__("\n\ + ldr $8,0x0(%2)\n\ + ldl $8,0x7(%2)\n\ + lw $9,0x8(%2)\n\ + pcpyld $10,$9,$8\n\ + qmtc2 $10,vf01\n\ + lqc2 vf02,0x0(%1)\n\ + lqc2 vf03,0x10(%1)\n\ + lqc2 vf04,0x20(%1)\n\ + lqc2 vf05,0x30(%1)\n\ + vmulax.xyz ACC, vf02,vf01\n\ + vmadday.xyz ACC, vf03,vf01\n\ + vmaddaz.xyz ACC, vf04,vf01\n\ + vmaddw.xyz vf06,vf05,vf00\n\ + sqc2 vf06,0x0(%0)\n\ + ": : "r" (&out) , "r" (&mat) ,"r" (&in): "memory"); +#else + out = mat * in; +#endif +} + +void TransformPoints(CVuVector *out, int n, const CMatrix &mat, const RwV3d *in, int stride) +{ +#ifdef GTA_PS3 + __asm__ __volatile__("\n\ + paddub $3,%4,$0\n\ + lqc2 vf02,0x0(%2)\n\ + lqc2 vf03,0x10(%2)\n\ + lqc2 vf04,0x20(%2)\n\ + lqc2 vf05,0x30(%2)\n\ + ldr $8,0x0(%3)\n\ + ldl $8,0x7(%3)\n\ + lw $9,0x8(%3)\n\ + pcpyld $10,$9,$8\n\ + qmtc2 $10,vf01\n\ + 1: vmulax.xyz ACC, vf02,vf01\n\ + vmadday.xyz ACC, vf03,vf01\n\ + vmaddaz.xyz ACC, vf04,vf01\n\ + vmaddw.xyz vf06,vf05,vf00\n\ + add %3,%3,$3\n\ + ldr $8,0x0(%3)\n\ + ldl $8,0x7(%3)\n\ + lw $9,0x8(%3)\n\ + pcpyld $10,$9,$8\n\ + qmtc2 $10,vf01\n\ + addi %1,%1,-1\n\ + addiu %0,%0,0x10\n\ + sqc2 vf06,-0x10(%0)\n\ + bnez %1,1b\n\ + ": : "r" (out) , "r" (n), "r" (&mat), "r" (in), "r" (stride): "memory"); +#else + while(n--){ + *out = mat * *in; + in = (RwV3d*)((uint8*)in + stride); + out++; + } +#endif +} + +void TransformPoints(CVuVector *out, int n, const CMatrix &mat, const CVuVector *in) +{ +#ifdef GTA_PS2 + __asm__ __volatile__("\n\ + lqc2 vf02,0x0(%2)\n\ + lqc2 vf03,0x10(%2)\n\ + lqc2 vf04,0x20(%2)\n\ + lqc2 vf05,0x30(%2)\n\ + lqc2 vf01,0x0(%3)\n\ + nop\n\ + 1: vmulax.xyz ACC, vf02,vf01\n\ + vmadday.xyz ACC, vf03,vf01\n\ + vmaddaz.xyz ACC, vf04,vf01\n\ + vmaddw.xyz vf06,vf05,vf00\n\ + lqc2 vf01,0x10(%3)\n\ + addiu %3,%3,0x10\n\ + addi %1,%1,-1\n\ + addiu %0,%0,0x10\n\ + sqc2 vf06,-0x10(%0)\n\ + bnez %1,1b\n\ + ": : "r" (out) , "r" (n), "r" (&mat) ,"r" (in): "memory"); +#else + while(n--){ + *out = mat * *in; + in++; + out++; + } +#endif +} + + void CVector2D::Normalise(void) { @@ -87,6 +202,7 @@ CMatrix::Reorthogonalise(void) CMatrix& Invert(const CMatrix &src, CMatrix &dst) { + // TODO: VU0 code // GTA handles this as a raw 4x4 orthonormal matrix // and trashes the RW flags, let's not do that // actual copy of librw code: @@ -117,6 +233,7 @@ Invert(const CMatrix &src, CMatrix &dst) CVector operator*(const CMatrix &mat, const CVector &vec) { + // TODO: VU0 code return CVector( mat.m_matrix.right.x * vec.x + mat.m_matrix.up.x * vec.y + mat.m_matrix.at.x * vec.z + mat.m_matrix.pos.x, mat.m_matrix.right.y * vec.x + mat.m_matrix.up.y * vec.y + mat.m_matrix.at.y * vec.z + mat.m_matrix.pos.y, @@ -126,6 +243,7 @@ operator*(const CMatrix &mat, const CVector &vec) CMatrix operator*(const CMatrix &m1, const CMatrix &m2) { + // TODO: VU0 code CMatrix out; RwMatrix *dst = &out.m_matrix; const RwMatrix *src1 = &m1.m_matrix; @@ -145,9 +263,18 @@ operator*(const CMatrix &m1, const CMatrix &m2) return out; } +CMatrix& +CMatrix::operator*=(CMatrix const &rhs) +{ + // TODO: VU0 code + *this = *this * rhs; + return *this; +} + const CVector Multiply3x3(const CMatrix &mat, const CVector &vec) { + // TODO: VU0 code return CVector( mat.m_matrix.right.x * vec.x + mat.m_matrix.up.x * vec.y + mat.m_matrix.at.x * vec.z, mat.m_matrix.right.y * vec.x + mat.m_matrix.up.y * vec.y + mat.m_matrix.at.y * vec.z, @@ -179,6 +306,7 @@ CQuaternion::Slerp(const CQuaternion &q1, const CQuaternion &q2, float theta, fl w1 = Sin((1.0f - t) * theta) * invSin; w2 = Sin(t * theta) * invSin; } + // TODO: VU0 code *this = w1*q1 + w2*q2; } } diff --git a/src/render/Shadows.cpp b/src/render/Shadows.cpp index c169c351..9980d678 100644 --- a/src/render/Shadows.cpp +++ b/src/render/Shadows.cpp @@ -1027,7 +1027,9 @@ CShadows::CastShadowEntity(CEntity *pEntity, float fStartX, float fStartY, floa CColTrianglePlane *pColTriPlanes = pCol->trianglePlanes; ASSERT(pColTriPlanes != NULL); - if ( Abs(pColTriPlanes[i].normal.z) > 0.1f ) + CVector normal; + pColTriPlanes[i].GetNormal(normal); + if ( Abs(normal.z) > 0.1f ) { CColTriangle *pColTri = pCol->triangles; ASSERT(pColTri != NULL); From 456cb01f16ded015803508c98fbd34f563b153ee Mon Sep 17 00:00:00 2001 From: Sergeanur Date: Wed, 5 Aug 2020 13:36:07 +0300 Subject: [PATCH 5/5] Enable PS2 Alpha test Emu in debug menu on RW --- src/core/re3.cpp | 2 -- 1 file changed, 2 deletions(-) diff --git a/src/core/re3.cpp b/src/core/re3.cpp index 8c0020d0..f9be4b51 100644 --- a/src/core/re3.cpp +++ b/src/core/re3.cpp @@ -457,9 +457,7 @@ DebugMenuPopulate(void) DebugMenuAddCmd("Spawn", "Spawn Predator", [](){ SpawnCar(MI_PREDATOR); }); DebugMenuAddVarBool8("Render", "Draw hud", &CHud::m_Wants_To_Draw_Hud, nil); -#ifdef LIBRW DebugMenuAddVarBool8("Render", "PS2 Alpha test Emu", &gPS2alphaTest, nil); -#endif DebugMenuAddVarBool8("Render", "Frame limiter", &FrontEndMenuManager.m_PrefsFrameLimiter, nil); DebugMenuAddVarBool8("Render", "VSynch", &FrontEndMenuManager.m_PrefsVsync, nil); DebugMenuAddVar("Render", "Max FPS", &RsGlobal.maxFPS, nil, 1, 1, 1000, nil);