TryBuildSeaLevelHitPosition()

bool CCTLiquid::TryBuildSeaLevelHitPosition ( PlayerBase player, vector playerPos, out vector seaHitPosition )

inlineprotected

Server validates the synced cursor position. It should not invent one from camera data.

Dynamic minimum downward angle. If the ray is too close to horizontal, tiny camera sway causes huge sea cursor jumps.

Only reject near-horizontal aim. Do not scale this directly with height, because the real intersection check below decides whether the sea-plane hit is within range.

Real intersection of camera ray with sea plane.

If the real cursor/sea intersection is beyond allowed range, do not clamp a closer fake point.

Apply small deadband/sticky cache.

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

    {
        seaHitPosition = vector.Zero;
        
        if (g_Game.IsHeadlessOrDedicatedServer())
            return false;
        
        float seaLevel = g_Game.SurfaceGetSeaLevel();
        float seaLevelMax = g_Game.SurfaceGetSeaLevelMax();
    
        if (playerPos[1] > seaLevelMax + m_MaxVerticalReach)
            return false;
    
        vector cameraPos = g_Game.GetCurrentCameraPosition();
        vector cameraDir = g_Game.GetCurrentCameraDirection();
    
        if (cameraPos == vector.Zero || cameraDir == vector.Zero)
            return false;
        
        cameraDir.Normalize();
    
        float safeDistance = m_MaxActionDistance - SEA_FALLBACK_DISTANCE_BUFFER;
        if (safeDistance <= 1.0)
            safeDistance = m_MaxActionDistance * 0.8;
    
        float cameraToSeaHeight = cameraPos[1] - seaLevel;
        if (cameraToSeaHeight <= 0.0)
            return false;
        
        float minStableDownDot = SEA_CURSOR_MIN_DOWN_DOT;
        float maxAllowedCameraDirY = -minStableDownDot;
        
        if (cameraDir[1] > maxAllowedCameraDirY)
        {
            #ifdef DIAG_DEVELOPER
            DbgUI.Begin("", 10, 200);
            if (m_DebugSyntheticCursor)
            {
                DbgUI.Text(string.Format("CCTLiquid TryBuildSeaLevelHitPosition rejected: reason=camera too shallow | cameraDirY=%1 | minStableDownDot=%2 | height=%3 | safeDist=%4", cameraDir[1], minStableDownDot, cameraToSeaHeight, safeDistance));
            }
            DbgUI.End();
            #endif
        
            return false;
        }
        
        float t = (seaLevel - cameraPos[1]) / cameraDir[1];
        if (t <= 0)
            return false;
    
        vector candidate = cameraPos + cameraDir * t;
        candidate[1] = seaLevel;
    
        float safeDistanceSq = safeDistance * safeDistance;
    
        if (vector.DistanceSq(playerPos, candidate) > safeDistanceSq)
        {
            #ifdef DIAG_DEVELOPER
            DbgUI.Begin("", 20, 200);
            if (m_DebugSyntheticCursor)
            {
                DbgUI.Text(string.Format("CCTLiquid TryBuildSeaLevelHitPosition rejected: reason=Real sea intersection too far | player=%1 | candidate=%2 | dist=%3 | safeDist=%4", playerPos.ToString(), candidate.ToString(), vector.Distance(playerPos, candidate), safeDistance));
            }
            DbgUI.End();
            #endif
            return false;
        }
    
        if (!IsSeaHitPositionValid(playerPos, candidate))
            return false;
        
        vector seaSurfacePos = candidate;
        seaSurfacePos[1] = seaSurfacePos[1] + LIQUID_SURFACE_RAYCAST_OFFSET;
        
        if (!HasClearPathToLiquidSurface(player, seaSurfacePos))
            return false;
    
        candidate = ApplySyntheticHitCursorStability(playerPos, candidate, LIQUID_SALTWATER);
        if (!IsSeaHitPositionValid(playerPos, candidate))
            return false;
        
        vector cachedOrStableSeaSurfacePos = candidate;
        cachedOrStableSeaSurfacePos[1] = cachedOrStableSeaSurfacePos[1] + LIQUID_SURFACE_RAYCAST_OFFSET;
        
        if (!HasClearPathToLiquidSurface(player, cachedOrStableSeaSurfacePos))
            return false;
    
        seaHitPosition = candidate;
        return true;
    }

Перекрестные ссылки ApplySyntheticHitCursorStability(), DbgUI::Begin(), vector::Distance(), vector::DistanceSq(), DbgUI::End(), g_Game, HasClearPathToLiquidSurface(), IsSeaHitPositionValid(), LIQUID_SALTWATER, LIQUID_SURFACE_RAYCAST_OFFSET, m_MaxActionDistance, m_MaxVerticalReach, vector::Normalize(), SEA_CURSOR_MIN_DOWN_DOT, SEA_FALLBACK_DISTANCE_BUFFER, DbgUI::Text(), vector::ToString() и vector::Zero.

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