UHjk@ dZddlmZddlZddlZddlZddlZddlmZddl m Z m Z ddl m Z eejj dZedz Zed z Zd Zd d gZd ZdZdZdZdZdZdZdZdZdZddddddZ dddd d!d"d#d$d%Z!dd&d'd(Z"d6d)Z#d7d*Z$d8d+Z%d8d,Z&d8d-Z'd9d.Z(d:d/Z)edfd;d0Z*dd4Z.e/d5k(re.yy)?zKSummarize the original executable's DirectDraw setup and presentation flow.) annotationsN)Path) read_sections va_to_offset) parse_importsoutz Hwanse2.exei]CiVAiVAivFivFivFivFivFivFivFivFivFiثU CreateClipper CreatePalette CreateSurfaceSetCooperativeLevelSetDisplayMode)PTReleaseBltFastBltBltBatchFlipGetAttachedSurface SetClipper SetPalette)rrr,0p| GetEntries SetEntries)rrrc|yd|dS)N0x08x)values 6/home/exedev/hwanse/tools/summarize_directdraw_flow.pyhex32r):s } c{ c^t||}|tdt|d||||zS)NzVA z is outside raw sections)r ValueErrorr))exesectionsvasizeoffsets r(read_atr2@s= (B 'F ~3uRyk)ABCC v &&r*c$t|||ddS)Nrr)r2)r-r.r/s r(read_u8r4Gs 3"a ( ++r*c t|||}|dk7rtdt|tjdt |||dzdd}|dz|zS)Nzexpected near call at z> --gc8R!VQ? @ CC 6C<r*cft|||d}|dddk7rtdt||dS)NsPz&expected call DWORD PTR [eax+imm8] at )r2r,r))r-r.r/bodys r(vtable_call_offsetrBSs@ 3"a (D BQx;A%)MNN 7Nr*c|jdxsgD]I}|jdxsgD]/}|jd|k(sd|jdi|ccSKtd|d)Nimports functionsnamedllzimport z not found)getr,)rDrFrGfns r( find_importrJZsz{{9%+5''+&," 5Bvvf~%swwu~444 55 wtfJ/ 00r*c  gd}tttddid}g}|D]c\}}}}} t|||} |j t ||d| dd|d|j |ij | d|| | |k(de|S) N))i`VA IDirectDrawrz$windowed cooperative level candidatezflags 0x00000008)iVArLrz&exclusive fullscreen cooperative levelzflags 0x00000011)iVArLrzfullscreen display mode 640x480x8)ifWArLrz"primary flipping surface candidatez*DDSD_CAPS|DDSD_BACKBUFFERCOUNT, caps 0x218)iWArLrz simple primary surface candidatezDDSD_CAPS, caps 0x200)i6XAIDirectDrawSurfacerattached backbuffer lookupcaps 0x00000004)iXArLr#offscreen 640x480 surface candidate)DDSD_CAPS|HEIGHT|WIDTH, caps include 0x40)ioYArNrrOrP)iZArLrrQrR)iZArLrzwindowed clipper creationzout 0x004676c8)iZAIDirectDrawClipper zclipper SetHWnd candidatezhwnd 0x004676f0)i[ArNrzprimary SetClipper candidatezclipper 0x004676c8)i.eArLrzpalette creationz256-entry palette buffer)iUeArNr zprimary SetPalettepalette 0x004676c4)ifArNr zrefresh primary SetPaletterU)iIfAIDirectDrawPaletterr"writes changed palette range)igArVrr"rW)iVhArVrr!zreads palette range)ivArNrrzfullscreen/page-flip path)i"wArNrrcopy/update path)iKxArNrrrX)i8yArNrrrX)iK{ArNrrwindowed/scaled copy path)i{ArNrrrY)i{ArNrrrYrTSetHWnd)rLrNrVrSr$02xunknown)vaHex interfacevtableOffsetHexexpectedOffsetHexmethodrolenotesverified) DDRAW_METHODSSURFACE_METHODSPALETTE_METHODSrBappendr)rH) r-r.rowsmethodsoutputr/r^expected_offsetrbrc actual_offsets r(known_vtable_callsrnbs D8%--#Y/ G F7;  3Ie*3"=  r&%' c':#;')/#)>%?!++i488 R)_<     Mr*cF|j}t|}|xs t|}t|d}tDcgc]}t |||}}t ||}t||ddjdt||ddjdt||ddjdd} t||d djdt||d d jdd } |jd dk(td|Dt||dddk(t||dddk(| ddk(xr| ddk(xr| ddk(| ddk(xr| ddk(td|Dtd|Dd k\td!|Dxrtd"|Dd# } t||jd$t|jd tttDcgc] }t|c}|D cgc] } t| c} tt tt"tt$tt&tt(d% |D cgc] } | d&d'k(s | c} t+d(|Dd)d*d+| d,tt,d-d.d/d0d1d2d3d0d4d5d6d0g|D cgc] } | d&d7k(s | c} |D cgc]} | d8d9k(r | d&d:k7r| c} d;tt.tt0tt2d<| |D cgc] } | d&d=vr|  c} d>d?|D cgc] } | d&d@k(s | c} |D cgc] } | d&dAk(s | c} dBdC|| dDgdEdF }|Scc}wcc}wcc} wcc} wcc} wcc} wcc} wcc} wcc} w)GNDirectDrawCreateiVAr@ iVAr8iVA)bppPush heightPush widthPushiX\Aib\A) versionWrite countWriteiatVaitZc3.K|] }|tk(yw)N)DIRECTDRAW_CREATE_WRAPPER).0targets r( z build_summary..s0pY_;T1T0piUAshvFiVAsjrrz6a 08rsz68 e0 01 00 00rtz68 80 02 00 00rvz66 c7 00 00 03rwz66 c7 40 02 00 01c3&K|] }|d yw)rdNr&r{rows r(r}z build_summary..s)Rc#j/)Rc32K|]}|ddk(s dyw)rar rNr&rs r(r}z build_summary..s-lC3x=\kKka-l r7c3,K|] }|ddk(yw)rarNr&rs r(r}z build_summary..s@CH '@c3,K|] }|ddk(yw)rarNr&rs r(r}z build_summary..sCsCMU*Cr) directDrawCreateImportMatches!directDrawCreateCallsReachWrapperdirectDrawOutputGlobalMatcheshardwareDeviceBranchPushes2displayModeIs640x480x8paletteHeaderIs256EntriesallKnownVtableOffsetsMatchcreateSurfaceCallCountAtLeast4presentationHasFlipAndBltrG) rGiatVaHex wrapperVaHex callSites callTargetsoutputGlobalHexerrorGlobalHex flagGlobalHexdisplayModeGlobalHex hwndGlobalHexrar c32K|]}|ddk(s |yw)rarNr&rs r(r}z build_summary..s&hsc(mWgFgs&hriir)setCooperativeLevelCallssetDisplayModeCallwidthheightbppbytesr 0x0055abd8zprimary/front surface wrapper)slotwrapperGlobalHexrbr 0x0055abdczoffscreen/back surface wrapper 0x0055aed4zattached backbuffer wrapperr r^rNr)surfaceTableBaseHexprimarySurfaceSlotscreateSurfaceCallssurfaceCallSamples>r!r"rr )paletteGlobalHexbufferGlobalHexentriesGlobalHex entryCount headerBytescallsz&directdraw-640x480x8-paletted-surfacesrrzThe web runtime should preserve 640x480 indexed-image assumptions, then present through canvas scaling rather than inventing a higher-resolution native layout.)classification flipCallsbltCalls implicationzrender-pipeline-grounded)zQExact draw-order and dirty-rectangle rules still require deeper renderer tracing.zThe static vtable labels assume DirectDraw 1 era COM layouts, which match the import shape but are not symbol names from the binary.z:Event and route promotion are not affected by this report.) sourcedirectDrawCreate displayModesurfacespalette presentation vtableCalls verificationpromotionStatus openQuestions) read_bytesrrrJDIRECTDRAW_CREATE_CALLSr=rnr2hexrHallsumanystrr)rzDIRECTDRAW_GLOBAL ERROR_GLOBAL FLAGS_GLOBALDISPLAY_MODE_GLOBAL HWND_GLOBALnext SURFACE_TABLEPALETTE_GLOBALPALETTE_BUFFER_GLOBALPALETTE_ENTRIES_GLOBAL)exe_path exe_importsr-r.rDdirectdraw_creater/ call_targets vtable_callsdisplay_mode_bytespalette_header_bytesrr|rsummarys r( build_summaryrs     CS!H4]84G#G-?@>UVLh3VLV%c84L3*a8<>sC  Xz1=AA#Fc8Z;??D *;)>)>w)G:)U-00pco0p-p)0h A)NRi)i'.sHj!'LP['[ y )W 4 D"<04DD D";/3CC ! 04D D J$\26II&))R\)R&R*--l<-l*lpq*q @<@ @ DClCC%L,h-$((//33G<=!";<.EF%)F8DEfE&ME$%67#L1"<0$)*=$>";/   ,)s8}@U/U)#'&hl&h"h'  $)#7 Fef Ffg N  N N#N< N N N"Ncddd|ddd|dddddd |d d dd |d d dddjd|d dDd|d ddd|d dd|d dd|d dddddddd|ddd|dd d|dd!dd"|dd#d$ddd%d&g}|dd'D]&}|jd(|d$d)|d*d+|d,d-(|jd(|dd#d$d.|jdd/dd0|d1d2d3dd4d5g|d1d6D]&}|jd7|d8d9|d:d+|d;d-(|jgd<|d1d=D],}|jd(|d$d)|d*d+|d;d>|d,d- .|jdd?dd@|dAdBdC|dAdDdEddFdGg|dAdHD],}|jd(|d$d)|d*d+|d;d>|d,d- .|jddIddJ|dKdLddMdjdN|dKdODxsdPdQdjdR|dKdSDxsdPdT|dKdUddVddWdXg |dYjD]\}}|jd(|d)|dZ|jgd[|jd\|d]Dd^j|d^zS)_Nz# DirectDraw Flowz Executable: `r`zPromotion status: `rz## Import And Entryz- `DirectDrawCreate` IAT: `rrz- import thunk/wrapper: `rz- call sites: z, c3(K|] }d|d yw)rNr&r{items r(r}ztext_summary.. s"d4QtfA;"dsrz- output global: `rz%- mode/window globals: display mode `rz `, hwnd `rz `, flags `rzThe two call sites pass either device selector `0` or `2` based on the graphics flag at `0x004676d4`, then store the created `IDirectDraw*` in `0x004676c0`.z## Display Modez- target mode: `rrxrrz- `SetDisplayMode` call: `rr]z| call | method | notes |z| --- | --- | --- |rz| `z` | `raz` | rcz |z"` | `SetDisplayMode` | 640x480x8 |z ## Surfacesz#Surface wrappers are indexed from `rrz`. The initialization path creates a primary/front wrapper, an offscreen/back wrapper, and in fullscreen flip mode an attached backbuffer wrapper.z| slot | wrapper | role |z| ---: | --- | --- |rz| rz | `rrb)r | call | method | role | notes || --- | --- | --- | --- |rz | z ## PalettezThe palette buffer at `rrzC` stores a 256-entry DirectDraw palette; the raw entries start at `rz`.rrrz## Presentationz- classification: `rrz- flip calls: c3.K|] }d|ddywrr]Nr&rs r(r}ztext_summary..=s"g3Qs7|nA#6"gr~r-z - blt calls: c3.K|] }d|ddywrr&rs r(r}ztext_summary..>s!e#Ac'l^1"5!er~rz- implication: rz## Verificationz| check | value |z | --- | --- |rz` |)rz## Open Questionsrc3&K|] }d| yw)z- Nr&rs r(r}ztext_summary..MsB2dVBrr )joinrhextenditems)rlinesrkeyr's r( text_summaryrs )*!, g&789;  %g.@&A*&M%NaP #G,>$?$O#PPQR "d7CU;VWb;c"ddef W%789JKLAN /8J0KLb0c/ddmnuwIoJKZo[n\\fgnoAgBCRgSfTTU V  g  7=1':;1W]=ST\=]<^^_`ghu`vw|`}_~~ A $W]%; DirectDraw Flow 
z
)rhtmlescape)rrAs r( html_pagerQs3  D  ++d    r*c|jdd|dz jtj|dddzd |d z jt |d y) NT)parentsexist_okzdirectdraw_flow.jsonFr@) ensure_asciiindentrzutf-8)encodingdirectdraw_flow.html)mkdir write_textjsondumpsr)rout_dirs r( write_outputsrdsc MM$M. %%11 7q9D@2 %%11)G2Dw1Wr*cTtjt}|jdtt |jdtt |j}t|j}t||jtd|jdz y)N) descriptionz--exe)typedefaultz --out-dirz!wrote DirectDraw flow summary -> r) argparseArgumentParser__doc__ add_argumentrEXEOUT parse_argsrr-rrprint)parserargsrs r(mainrms  $ $ 9F dC8  $<    DDHH%G'4<<( -dll=S.S-T UVr*__main__)r'z int | Nonereturnz str | None) r-rr. list[dict]r/intr0rrr)r-rr.rr/rrr)rDdictrFrrr)r-rr.rrr)rrrz dict | Nonerr)rrrr)rrrrrNone)rr)0r __future__rrrrr9pathlibrprobe_exe_scene_tablesrrsummarize_exe_importsr__file__resolverROOTr rrzrrrCLIPPER_GLOBALrrrrrrrrerfrgr)r2r4r=rBrJrnrrrrr__name__r&r*r(rsGQ" >/ H~''* Ul ]&%z2    "#                     ',11h$'4hVM#`&25XW zFr*