OAjKUdZddlmZddlmZddlmZddlZddlm Z m Z m Z m Z m Z mZedGd d Zed d Zed dZeddZeddZeddZGddeeZGddZddddZded<dd d!d"d#Zded$<d%d&d'd'd(d"d)Zded*<d+d,d-d-d(d(d)Zded.<d/d0d1d2d3d4d5Zded6<dgd:Zd;ejfdhdBZ ejfdidDZ!ejfdjdEZ"ejfdkdHZ#ejfdldKZ$ejfdldLZ%ejfdmdOZ&eGdPdQZ'eGdRdSZ( dndod`Z) dpdqdfZ*dS)ruJAutoPOE2 - Dynamic Resolution Scaling Engine (Doc 63 / SSoT 2026). ====================================================================== Module chuyển đổi và co giãn tọa độ màn hình động (Dynamic Coordinate Transform): - Hỗ trợ co giãn tuyến tính chính xác giữa Single Source of Truth (1920x1080), 1440p (2560x1440), 720p (1280x720), và chế độ Windowed thực tế (1189x891). - Chuẩn hóa ma trận tọa độ pixel cho các phần tử UI trọng yếu: * Nút TRAVERSE & khung tương tác Map Device. * Khay cắm Waystone (Map Device Socket) & khay Waystone hàng 1 Atlas. * Lưới hòm đồ Stash (12x12) và túi đồ Inventory (12x5). * Giao diện Sàn Ngoại Hối Faustus Currency Exchange. - Đảm bảo sai số làm tròn tối đa <= 1 pixel trên mọi độ phân giải. Tuân thủ nghiêm ngặt: - Rule 1: Python 3.11 Cold Path Tier 2. - Rule 4: Module hóa dùng chung tại src/common/, trần file < 500 dòng. - Rule 16: Google Docstrings đầy đủ. - Bất biến: INV-SCALE-IDEMPOTENT-1PX, INV-WASD-NO-BLIND-LMB. ) annotations) dataclass)EnumN)AnyDictListOptionalTupleUnionT)frozenceZdZUdZded<ded<ddZedd Zedd Zedd Z edd Z dS) ResolutionuĐặc tả độ phân giải màn hình hoặc cửa sổ game. Attributes: width: Chiều rộng tính bằng pixel (> 0). height: Chiều cao tính bằng pixel (> 0). intwidthheightreturnNonecp|jdks |jdkrtd|jd|jdS)Nru,Độ phân giải không hợp lệ: width=z , height=)rr ValueErrorselfs 7C:\Projects\AutoPOE2\src\common\coordinate_transform.py __post_init__zResolution.__post_init__'sF :??dkQ..nDJnnaealnnoo o/.floatc:|jt|jz S)u'Tỷ lệ khung hình (width / height).)rrrrs r aspect_ratiozResolution.aspect_ratio+szE$+....rboolc8t|jdz dkS)uKKiểm tra xem có xấp xỉ tỷ lệ chuẩn 16:9 (1.777...) hay không.gqq?g?)absrrs ris_standard_16_9zResolution.is_standard_16_90s4$ 344t;;rc|jdkS)ucKiểm tra xem có phải tỷ lệ khung hình cửa sổ nhỏ (< 1.60 như 4:3, 5:4) hay không.g?rrs ris_windowed_aspectzResolution.is_windowed_aspect5s 4''rc|jdkS)uFKiểm tra màn hình siêu rộng (21:9 hoặc 32:9, aspect >= 2.30).gffffff@r#rs r is_ultrawidezResolution.is_ultrawide:s D((rN)rr)rr)rr) __name__ __module__ __qualname____doc____annotations__rpropertyrr!r$r&rrrrs JJJKKKpppp///X/<<<X<(((X()))X)))rrii8i iiiiipii{c"eZdZdZdZdZdZdZdS) ScalingModeu-Chế độ co giãn tọa độ hình học.STRETCH UNIFORM_FITCENTER_ANCHOREDWINDOWED_ADAPTIVEN)r'r(r)r*r0r1r2r3r-rrr/r/Hs+77GK'O+rr/ceZdZdZeefd"dZejfd#dZejfd$dZ ejfd%dZ ejfd&dZ ejfd#d Z d!S)'CoordinateScaleru^Bộ chuyển đổi tọa độ động giữa các độ phân giải với sai số <= 1px. source_resr target_resrrc||_||_|jt|jz |_|jt|jz |_dS)uKhởi tạo bộ chuyển đổi. Args: source_res: Độ phân giải gốc chứa tọa độ tham chiếu (mặc định 1080p SSoT). target_res: Độ phân giải đích cần chuyển đổi tới. N)r6r7rrscale_xrscale_y)rr6r7s r__init__zCoordinateScaler.__init__SsJ%$(.z7G1H1HH (/% 8I2J2JJ rxrymoder/Tuple[int, int]c|tjkrL||jz}||jz}t t |t t |fS|tjks|tjkr~|jj rr|j j dz}|jj dz}||z }|||jzz}||jz}t t |t t |fS|tj krt|j|j} |jj |j j | zz dz} |jj|j j| zz dz} | || zz}| || zz}t t |t t |fSt t ||jzt t ||jzfS)urChuyển đổi một điểm (X, Y) từ source_res sang target_res. Args: x: Tọa độ X trên source_res. y: Tọa độ Y trên source_res. mode: Chế độ co giãn (mặc định STRETCH tuyến tính). Returns: Tuple[int, int]: Tọa độ (x_target, y_target) đã làm tròn chuẩn. ?)r/r0r9r:rroundr2r3r7r$r6rr1minr) rr<r=r>txty center_src_x center_tgt_xoffset_xspad_xpad_ys rtransform_pointz CoordinateScaler.transform_pointcs ;& & &T\!BT\!BuRyy>>3uRyy>>1 1 ;. . . K1 1 1do6X 1 ?036L?036L<'HDL!89BT\!BuRyy>>3uRyy>>1 1 ;* * *DL$,//A_*do.Ca.GHCOE_+t/E/IJcQE!a%B!a%BuRyy>>3uRyy>>1 15T\)**++Sq4<7G1H1H-I-IIIrwhTuple[int, int, int, int]c||||\}}|||z||z|\}} ||td||z td| |z fS)u9Chuyển đổi hình chữ nhật (x, y, width, height).r>)rLmax) rr<r=rMrNr>x1y1x2y2s rtransform_rectzCoordinateScaler.transform_rectso%%a%66B%%a!eQU%>>B2s1b2gArBw77rrTrUrVrWcz||||\}}||||\}} |||| fS)u.Chuyển đổi bounding box (x1, y1, x2, y2).rQrL) rrTrUrVrWr>tx1ty1tx2ty2s rtransform_bboxzCoordinateScaler.transform_bboxsO''BT'::S''BT'::SCc!!rorigin_xorigin_ycell_wcell_hcolrrowc^||dz|zz}||dz|zz} ||| |S)ucTính tâm của ô lưới (col, row) trên target_res không bị tích lũy sai số làm tròn.rArQrZ) rr`rarbrcrdrer>cx_srccy_srcs rtransform_grid_cellz$CoordinateScaler.transform_grid_cellsES3Y&00S3Y&00##FF#>>>rcht|j|j}||||S)u=Biến đổi ngược lại từ target_res về source_res.r6r7rQ)r5r7r6rL)rr<r=r> inv_scalers rinverse_transform_pointz(CoordinateScaler.inverse_transform_points5&T_]]] ))!QT):::rN)r6rr7rrr)r<rr=rr>r/rr?) r<rr=rrMrrNrr>r/rrO) rTrrUrrVrrWrr>r/rrO)r`rrarrbrrcrrdrrerr>r/rr?) r'r(r)r* RES_1080Pr;r/r0rLrXr_rirmr-rrr5r5Pshh"+!*KKKKK((/ )J)J)J)J)Jb(/ 8 8 8 8 8&(/ " " " " "*(/ ? ? ? ? ?&(/ ;;;;;;;rr5)g@g@)g@g@)gj@g@gĊ@g$@) text_center frame_centerbboxzDict[str, Any]CANONICAL_TRAVERSE_1080P)g@g:@)gn@g@gN@) socket_centertray_row1_origintray_slot_steptray_slot_countCANONICAL_WAYSTONE_1080Pg@gp@g@J@ )r`rarbrccolsrowsCANONICAL_INVENTORY_1080Pgf@gg@gJ@CANONICAL_STASH_1080P)@g@)g@@p@)g@r)r~g@@)r~g`@)g0@gi@) panel_center tab_i_want tab_i_have amount_inputsubmit_order_btnclose_panel_btnCANONICAL_FAUSTUS_1080Ptarget'Union[Resolution, Tuple[int, int], Any]rct|tr|St|ttfrIt |dkr6tt |dt |dSt |drZt|jtr@tt |jdt |jdSt |drDt |dr4tt |jt |j StS)ujChuẩn hóa đối tượng độ phân giải từ nhiều nguồn (Resolution, tuple, PIL Image, HWND).rrRsizerr) isinstancertuplelistlenrhasattrrrrrn)rs rresolve_resolutionrs&*%% &5$-((:S[[A-=-=#fQi..#fQi..999vvD:fk5#A#AD#fk!n--s6;q>/B/BCCCvwAGFH$=$=A#fl++S-?-?@@@ rFr7"Union[Resolution, Tuple[int, int]]use_frame_centerrr>r?ct|}tt|}|rdnd}t|\}}||||S)uLấy tọa độ click tối ưu của nút TRAVERSE trên độ phân giải đích. Args: target_res: Độ phân giải màn hình đích. use_frame_center: True nếu muốn lấy tâm khung nút, False lấy tâm chữ TRAVERSE. mode: Chế độ co giãn (mặc định STRETCH tuyến tính). Returns: Tuple[int, int]: Tọa độ (x, y) với sai số <= 1px. rkrprorQ)rr5rnrrrL)r7rr>resscalerref_keyref_xref_ys rget_traverse_button_posrsZ Z ( (C s C C CF 0CnnmG+G4LE5  ! !%T ! : ::rrOct|}tt|}td\}}}}||||||S)uXLấy bounding box (x1, y1, x2, y2) của nút TRAVERSE trên độ phân giải đích.rkrqrQ)rr5rnrrr_)r7r>rrbx1by1bx2by2s rget_traverse_button_bboxr$sU Z ( (C s C C CF1&9Cc3  c3$ ? ??rct|}tt|}td\}}||||S)u9Lấy tọa độ ổ cắm Waystone trên Map Device UI.rkrtrQrr5rnrxrL)r7r>rrsxsys rget_waystone_socket_posr/sL Z ( (C s C C CF %o 6FB  ! !"bt ! 4 44r slot_indexrct|}tt|}td\}}td}|||zz}||||S)uWLấy tọa độ ô thứ `slot_index` (0..4) trên khay Waystone Hàng 1 của Atlas.rkrurvrQr) rr7r>rroxoystepslot_xs rget_waystone_tray_slot_posr:sg Z ( (C s C C CF %&8 9FB #$4 5D :$ %F  ! !&"4 ! 8 88rrdrec t|}t}|jr|jdz }|d|z}d|dz z}|j|z |d|zz } |jdz} | ||zz|dzz} | ||zz|dzz} t t | t t | fStt|} | |d |d |d|d ||| S) uLấy tọa độ tâm ô túi đồ Inventory (col: 0..11, row: 0..4). Đặc biệt: Khi target_res là chế độ Windowed (aspect < 1.60 như 1189x891), tự động áp dụng neo lề phải (Right-anchored pouch margin) chuẩn theo Doc 63. @rbgb@g?rzgbX9?rArkr`rarcrQ) rr|r$rrrrBr5rnri)rdrer7r>rcfgscale cell_size pouch_marginrrcxcyrs rget_inventory_slot_posrHs Z ( (C #C . F"ME)  9: Y %Vy)@ A Z%  3? #y3 7 3? #y3 7599~~s599~~-- s C C CF  % % JZ#h-XSW[ &  rc t|}t}tt|}||d|d|d|d|||S)uRLấy tọa độ tâm ô hòm đồ Stash Tab Thường (col: 0..11, row: 0..11).rkr`rarbrcrQ)rr}r5rnri)rdrer7r>rrrs rget_stash_slot_posrgse Z ( (C C s C C CF  % % JZ#h-XSW[ &  r element_namestrct|}|tvrtd|dtt|}t|\}}||||S)uSLấy tọa độ các thành phần tương tác trên sàn ngoại hối Faustus.uKhông tìm thấy UI element 'z' trong CANONICAL_FAUSTUS_1080PrkrQ)rrKeyErrorr5rnrL)rr7r>rrrrs rget_faustus_element_posrvsr Z ( (C222ffffggg s C C CF*<8LE5  ! !%T ! : ::rc(eZdZUdZded<ded<dS) ScreenPointu(Tọa độ pixel trên màn hình game.rr<r=N)r'r(r)r*r+r-rrrrs(22 HHH HHHHHrrcLeZdZUdZdZded<dZded<dZded<dZded<dS) WasdVectoru.Vector trạng thái 4 phím di chuyển WASD.FrupleftdownrightN) r'r(r)r*rr+rrrr-rrrrs\88BDDErrr@I@dxrdydistOptional[float]screen_wscreen_hmarginTuple[float, float]c|dkrd}|dkrd}|dz}|dz}tj||z||zz}|dkr||z nd} |dkr||z nd} ||n|} || | z | zdzz} || | z| zdzz } t||}t|||z }t||}t|||z }t|t| |} t|t| |} | | fS) u6Chuẩn hóa phép chiếu Isometric 2D từ vector delta thế giới (dx, dy) sang pixel màn hình POE2. Đồng bộ 1:1 với common::WorldToScreenIsometric trong src/core/common/math2d.hpp. Hệ trục màn hình Windows: - X tăng dần sang phải màn hình. - Y tăng dần xuống dưới màn hình (cy là tâm màn hình). Phép chiếu Isometric POE2: - Trục X màn hình: targetX = cx + (ndx - ndy) * dist * 0.70710678 - Trục Y màn hình: targetY = cy - (ndx + ndy) * dist * 0.45000000 (Khi nhân vật tiến lên phía trước/bắc thế giới: ndx + ndy > 0 -> targetY < cy, tức hướng lên nửa trên màn hình). Args: dx: Độ lệch trục X thế giới (target.x - origin.x) dy: Độ lệch trục Y thế giới (target.y - origin.y) dist: Khoảng cách chiếu pixel từ tâm (nếu None sẽ tự tính bằng độ dài vector dx, dy) screen_w: Chiều rộng màn hình tính bằng pixel (mặc định 1920.0) screen_h: Chiều cao màn hình tính bằng pixel (mặc định 1080.0) margin: Khoảng cách an toàn tối thiểu tính từ rìa màn hình (mặc định 50.0) Returns: Tuple[float, float]: (target_x, target_y) đã clamp an toàn vào khung nhìn màn hình. grrrAgMbP?N'e?g?)mathsqrtrCrS)rrrrrrrrlengthndxndy actual_disttarget_xtarget_ymin_xmax_xmin_ymax_ys rworld_to_screen_isometricrs5>33 CB CB YrBwb( ) )F!E>>2;;sC!E>>2;;sC*$$KS3Y+- ::HS3Y+- ::H OOE Hv% & &E OOE Hv% & &E5#h..//H5#h..//H X r{Gz?RQ?deadzone thresholdTuple[bool, bool, bool, bool]ctj||z||zz}|dks||krdS||z }||z }d}||z |z}||z|z} | |k} | | k} ||k} || k} | | | | fS)uPhân định 8 hướng phím WASD Isometric chuẩn src/core/common/math2d.hpp. Args: dx: Độ lệch trục X thế giới dy: Độ lệch trục Y thế giới deadzone: Ngưỡng chết tối thiểu để kích hoạt phím (mặc định 0.01) threshold: Ngưỡng kích hoạt hướng phím (mặc định 0.38) Returns: Tuple[bool, bool, bool, bool]: (up/W, left/A, down/S, right/D) g-C6?)FFFFr)rr)rrrrrrr inv_sqrt2screen_xscreen_yrrrrs r world_to_wasdrs"YrBwb( ) )F 6H,,)) v+C v+CIc Y&Hc Y&H I B yj D y E yj D tT5  r)rrrr)r7rrrr>r/rr?)r7rr>r/rrO)r7rr>r/rr?)rrr7rr>r/rr?) rdrrerr7rr>r/rr?)rrr7rr>r/rr?)Nrrr)rrrrrrrrrrrrrr)rr) rrrrrrrrrr)+r* __future__r dataclassesrenumrrtypingrrrr r r rrn RES_1440PRES_720PRES_4KRES_WINDOWED_DEFAULTrr/r5rrr+rxr|r}rrr0rrrrrrrrrrrr-rrrs6&#"""""!!!!!! :::::::::::::::: $ ) ) ) ) ) ) ) )H JtT " " JtT " " :dC  D$  !z$,,,,,,,#t,,,o;o;o;o;o;o;o;o;v$# ),,%& ,,  --   ))# !"&& ++     ##+;;;;;0$+@@@@@$+55555$+ 9 9 9 9 9$$+ F$+     $$+ ; ; ; ; ;            ! 88888| !!!!!!!!!!!!!!r