2D/3D 충돌 감지(Collision vs Trigger) 조건 매트릭스와 LayerMask 비트 연산

using UnityEngine;

public class PhysicsUtility : MonoBehaviour
{
    [SerializeField] private LayerMask targetLayers;

    // 매 프레임 배열을 할당하지 않도록 정적 버퍼 사전 캐싱 (GC 0)
    private static readonly RaycastHit2D[] HitBuffer = new RaycastHit2D[8];

    // 특정 레이어 번호를 LayerMask 비트마스크로 변환
    public static LayerMask LayerToMask(int layerIndex)
    {
        return 1 << layerIndex;
    }

    // 마스크에 특정 레이어가 포함되어 있는지 검사
    public static bool ContainsLayer(LayerMask mask, int layerIndex)
    {
        return (mask.value & (1 << layerIndex)) != 0;
    }

    // 가비지 컬렉션 없는 2D 원형 감지
    public int DetectEnemiesNonAlloc(Vector2 center, float radius, LayerMask enemyMask)
    {
        ContactFilter2D filter = new ContactFilter2D();
        filter.SetLayerMask(enemyMask);
        filter.useLayerMask = true;
        filter.useTriggers = false;

        // Physics2D.OverlapCircleNonAlloc (또는 CircleCastNonAlloc)
        int hitCount = Physics2D.OverlapCircle(center, radius, filter, HitBuffer);

        for (int i = 0; i < hitCount; i++)
        {
            Collider2D target = HitBuffer[i];
            // 타겟 처리...
        }

        return hitCount;
    }
}