TryResolveSyntheticCursor()

bool CCTLiquid::TryResolveSyntheticCursor ( PlayerBase player, vector playerPos, vector currentHitPosition, out vector resolvedHitPosition, out int resolvedLiquidType )

inlineprotected

First validate the existing/synced cursor.

If there is a real cursor hit but it is not valid liquid, do not synthesize water. This prevents looking at ground/terrain near a pond from creating a synthetic cursor.

Server stops here. It should not invent a cursor from camera state.

Client fallback: build synthetic cursor only when current cursor is invalid.

Do not immediately drop a previously valid cursor. A single frame can fail because the camera ray is shallow or surface detection missed.

Validate the generated cursor once.

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

    {
        resolvedHitPosition = currentHitPosition;
        resolvedLiquidType = LIQUID_NONE;
    
        if (TryValidateHitCursor(player, playerPos, currentHitPosition, resolvedHitPosition, resolvedLiquidType))
            return true;
        
        if (currentHitPosition != vector.Zero)
        {
            ClearSyntheticCursorCache();
        
            #ifdef DIAG_DEVELOPER
            if (m_DebugSyntheticCursor)
                DebugDrawSyntheticCursor(player, currentHitPosition, vector.Zero, false, "current non-liquid hit prevents synthetic cursor", LIQUID_NONE);
            else
                ClearDebugCursorShapes();
            #endif
        
            return false;
        }
    
        if (g_Game.IsHeadlessOrDedicatedServer())
            return false;
    
        vector syntheticHitPosition;
        int syntheticLiquidType;
        
        if (!TryBuildSyntheticCursor(player, playerPos, syntheticHitPosition, syntheticLiquidType))
        {
            if (TryUseCachedSyntheticCursor(player, playerPos, currentHitPosition, resolvedHitPosition, resolvedLiquidType))
            {
                #ifdef DIAG_DEVELOPER
                if (m_DebugSyntheticCursor)
                    DebugDrawSyntheticCursor(player, currentHitPosition, resolvedHitPosition, true, "accepted cached synthetic cursor", resolvedLiquidType);
                else
                    ClearDebugCursorShapes();
                #endif
        
                return true;
            }
        
            ClearSyntheticCursorCache();
        
            #ifdef DIAG_DEVELOPER
            if (m_DebugSyntheticCursor)
                DebugDrawSyntheticCursor(player, currentHitPosition, syntheticHitPosition, false, "synthetic cursor failed", LIQUID_NONE);
            else
                ClearDebugCursorShapes();
            #endif
        
            return false;
        }
    
        if (!TryValidateHitCursor(player, playerPos, syntheticHitPosition, resolvedHitPosition, resolvedLiquidType))
        {
            ClearSyntheticCursorCache();
    
            #ifdef DIAG_DEVELOPER
            if (m_DebugSyntheticCursor)
                DebugDrawSyntheticCursor(player, currentHitPosition, syntheticHitPosition, false, "synthetic cursor invalid after build", syntheticLiquidType);
            else
                ClearDebugCursorShapes();
            #endif
    
            return false;
        }
    
        #ifdef DIAG_DEVELOPER
        if (m_DebugSyntheticCursor)
            DebugDrawSyntheticCursor(player, currentHitPosition, resolvedHitPosition, true, "accepted synthetic cursor", resolvedLiquidType);
        else
            ClearDebugCursorShapes();
        #endif
    
        return true;
    }

Перекрестные ссылки ClearSyntheticCursorCache(), g_Game, LIQUID_NONE, TryBuildSyntheticCursor(), TryUseCachedSyntheticCursor(), TryValidateHitCursor() и vector::Zero.

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