ajq tdZddlZddlmZmZGddeZGddeZGdd ZdS) z Shared 2.5D Isometric Coordinate and Mathematical System for FreeExile (Server Core). Implements standard 2:1 isometric projection, reverse projection (raycasting), height layering, and hardware depth value calculations. N)Tuple NamedTuplec$eZdZUeed<eed<dS)Vector2DxyN__name__ __module__ __qualname__float__annotations__4C:\Projects\FreeExile\server\world\isometric_math.pyrr s" HHH HHHHHrrc.eZdZUeed<eed<eed<dS)Vector3DrrzNr rrrrrs+ HHH HHH HHHHHrrc eZdZUdZeed<dZeed<dZeed<dZeed<e dd ed ed ed e fdZ e ddeded ed e fdZ e dd ed eded efdZ e efdededed efdZe dedededed ef dZdS) IsometricMathgP@ TILE_WIDTHg@@ TILE_HEIGHTg8@ HEIGHT_SCALEg?CAPSULE_HEIGHTworld_xworld_yworld_zreturnc||z tjdz z}||ztjdz z|tjzz }t ||S)z Converts 2.5D world coordinates (X, Y ground plane, Z elevation) to 2D isometric screen projection coordinates. g@)rrrrr)rrrscreen_xscreen_ys rworld_to_screenzIsometricMath.world_to_screensP g%-*BS*HIg%-*Cc*IJgXeXrNrs(+++rr!r"c||tjzz}|tjz |tjz z}|tjz |tjz z }t ||S)z Reverse projection: maps 2D screen coordinates back to 2.5D world coordinates on plane Z. Used for touch raycasting and ground target aiming. )rrrrr)r!r"r adjusted_yrrs rscreen_to_worldzIsometricMath.screen_to_world'sZ =+E!EF m66: Ha;ab 99hIa>ab)))r layer_offsetc|dz|z|zS)z Calculates a monotonic depth sorting key for hardware Z-buffer. In 2.5D isometric view, objects with larger Y coordinates are rendered in front (closer to camera). g$@r)rrr's rcalculate_depth_keyz!IsometricMath.calculate_depth_key2s $')L88rz_az_b thresholdc.t||z |kS)z Determines whether two entities occupy the same vertical slice for collision. Allows characters on bridges (Z=1.0) to walk over characters underneath (Z=0.0). )abs)r*r+r,s rcheck_height_overlapz"IsometricMath.check_height_overlap:s 39~~ ))rx1y1x2y2c8tj||z ||z S)N)mathhypot)r0r1r2r3s r distance_2dzIsometricMath.distance_2dBsz"r'27+++rN)r)rr)r r r rr rrrr staticmethodrr#r&r)boolr/r7rrrrrsJKL%NE,,,,,QY,,,\,**%*5*5*S[***\*99U9U9PU9`e999\9HV**%*e**[_***\*,,5,e,,5,,,\,,,rr)__doc__r5typingrrrrrrrrr<s  $$$$$$$$     z        z   .,.,.,.,.,.,.,.,.,.,r