gvjTFdZddlmZddlZdd Zdd ZddZddZddZdS)z FreeExile Common Mathematical Utilities. Pure, stateless mathematical and spatial calculation functions. High performance, zero-allocation, suitable for real-time game loops. ) annotationsNx1floaty1x2y2returnc8tj||z ||z S)z4Calculates 2D Euclidean distance between two points.)mathhypot)rrrrs 1C:\Projects\FreeExile\server\common\math_utils.pyeuclidean_distance_2dr s :b2grBw ' ''c,||z }||z }||z||zzS)zRCalculates squared 2D Euclidean distance (avoids costly sqrt in proximity checks).)rrrrdxdys r euclidean_distance_squared_2drs' bB bB 7R"W rradiusboolc4t||||||zkS)zRFast check whether two points are within a circular radius using squared distance.)r)rrrrrs r is_within_radius_2drs (RR 8 8Vf_ MMrvalmin_valmax_valc&||kr|S||kr|S|S)z2Clamps a numeric value between [min_val, max_val].r)rrrs r clamprs# W}} W}} Jrabtc:t|dd}|||z |zzS)zILinear interpolation between a and b by factor t (clamped to [0.0, 1.0]).gg?)r)rrr clamped_ts r lerpr#%s'ac""I A" ""r) rrrrrrrrr r) rrrrrrrrrrr r)rrrrrrr r)rrrrr rr r) __doc__ __future__rr rrrrr#rrr r&s #""""" (((( NNNN ######r