TryBuildPondHitPosition()

bool CCTLiquid::TryBuildPondHitPosition ( PlayerBase player, vector playerPos, out vector pondHitPosition )

inlineprotected

Client only. Server validates synced cursor position.

If looking upward/horizontal, we are probably not aiming at a pond surface.

The ray is close enough to the liquid surface.

Last chance: use closest sampled surface if it was very close.

См. определение в файле CCTLiquid.c строка 431

    {
        #ifdef DIAG_DEVELOPER
        float debugBestDelta = 999999.0;
        int debugSampleCount = 0;
        int debugValidKnownSurfaceCount = 0;
        string debugPondFailReason = "no pond samples";
        #endif
        
        pondHitPosition = vector.Zero;
    
        if (g_Game.IsHeadlessOrDedicatedServer())
            return false;
        
        vector cameraPos = g_Game.GetCurrentCameraPosition();
        vector cameraDir = g_Game.GetCurrentCameraDirection();
    
        if (cameraPos == vector.Zero || cameraDir == vector.Zero)
            return false;
    
        cameraDir.Normalize();
    
        if (cameraDir[1] > 0.15)
            return false;
    
        float safeDistance = m_MaxActionDistance - SYNTHETIC_CURSOR_DISTANCE_BUFFER;
        if (safeDistance <= 1.0)
            safeDistance = m_MaxActionDistance * 0.8;
    
        vector bestSurfacePos = vector.Zero;
        int bestLiquidType = LIQUID_NONE;
        float bestDelta = 999999.0;
        vector pondSurfacePos = vector.Zero;
        
        for (float dist = 1.0; dist <= safeDistance; dist += SYNTHETIC_POND_SAMPLE_STEP)
        {
            #ifdef DIAG_DEVELOPER
            debugSampleCount++;
            #endif
            
            vector probePos = cameraPos + cameraDir * dist;
            
            vector surfacePos;
            int liquidType;
            string surfaceType;
        
            if (!TryGetLiquidSurfaceAt(probePos, surfacePos, liquidType, surfaceType))
            {
                #ifdef DIAG_DEVELOPER
                debugPondFailReason = "TryGetLiquidSurfaceAt failed";
                #endif
                continue;
            }
        
            if (!IsAllowedPondLiquidSurface(playerPos, surfacePos, liquidType))
            {
                #ifdef DIAG_DEVELOPER
                debugPondFailReason = "known pond surface invalid";
                #endif
                continue;
            }
            
            #ifdef DIAG_DEVELOPER
            debugValidKnownSurfaceCount++;
            #endif
        
            float rayToSurfaceDelta = Math.AbsFloat(probePos[1] - surfacePos[1]);
            if (rayToSurfaceDelta < bestDelta)
            {
                bestDelta = rayToSurfaceDelta;
                bestSurfacePos = surfacePos;
                bestLiquidType = liquidType;
                
                #ifdef DIAG_DEVELOPER
                debugBestDelta = bestDelta;
                debugPondFailReason = "best pond surface too far from camera ray";
                #endif
            }
        
            if (rayToSurfaceDelta <= SYNTHETIC_POND_SURFACE_TOLERANCE)
            {
                surfacePos = ApplySyntheticHitCursorStability(playerPos, surfacePos, liquidType);
            
                if (!IsValidPondHitPosition(playerPos, surfacePos, liquidType))
                    continue;
            
                pondSurfacePos = surfacePos;
                pondSurfacePos[1] = pondSurfacePos[1] + LIQUID_SURFACE_RAYCAST_OFFSET;
            
                if (!HasClearPathToLiquidSurface(player, pondSurfacePos))
                    continue;
            
                pondHitPosition = surfacePos;
                return true;
            }
        }
    
        if (!IsNearlyZero(bestSurfacePos) && bestDelta <= SYNTHETIC_POND_FALLBACK_SURFACE_TOLERANCE)
        {
            bestSurfacePos = ApplySyntheticHitCursorStability(playerPos, bestSurfacePos, bestLiquidType);
            if (IsValidPondHitPosition(playerPos, bestSurfacePos, bestLiquidType))
            {
                pondSurfacePos = bestSurfacePos;
                pondSurfacePos[1] = pondSurfacePos[1] + LIQUID_SURFACE_RAYCAST_OFFSET;
                
                if (!HasClearPathToLiquidSurface(player, pondSurfacePos))
                    return false;
                
                pondHitPosition = bestSurfacePos;
                return true;
            }
        }
        
        #ifdef DIAG_DEVELOPER
        DbgUI.Begin("", 50, 240);
        if (m_DebugSyntheticCursor)
        {
            DbgUI.Text(string.Format("CCTLiquid TryBuildPondHitPosition failed: reason=%1 | samples=%2 | validSurfaces=%3 | bestDelta=%4 | tolerance=%5 | relaxedTolerance=%6", debugPondFailReason, debugSampleCount, debugValidKnownSurfaceCount, debugBestDelta, SYNTHETIC_POND_SURFACE_TOLERANCE, SYNTHETIC_POND_FALLBACK_SURFACE_TOLERANCE));
        }
        DbgUI.End();
        #endif
    
        return false;
    }

Перекрестные ссылки Math::AbsFloat(), ApplySyntheticHitCursorStability(), DbgUI::Begin(), DbgUI::End(), g_Game, HasClearPathToLiquidSurface(), IsAllowedPondLiquidSurface(), IsNearlyZero(), IsValidPondHitPosition(), LIQUID_NONE, LIQUID_SURFACE_RAYCAST_OFFSET, m_MaxActionDistance, vector::Normalize(), SYNTHETIC_CURSOR_DISTANCE_BUFFER, SYNTHETIC_POND_FALLBACK_SURFACE_TOLERANCE, SYNTHETIC_POND_SAMPLE_STEP, SYNTHETIC_POND_SURFACE_TOLERANCE, DbgUI::Text(), TryGetLiquidSurfaceAt() и vector::Zero.

Используется в TryBuildSyntheticCursor().