Jj/dZddlmZddlZddlmZddlmZddlm Z m Z ee jjdZedz Zed z Zdd Zddd Zdd Zdd ZddZedk(r eey)zHBuild a focused review of the DirectDraw palette buffer/copy/apply path.) annotationsN)Path)Any) read_sections va_to_offsetout Hwanse2.exec|yd|dS)N0x08x)values &tools/build_palette_pipeline_review.pyhxrs } c{ ct||}|t|ddddS||||z}t|t||jdddS)NF)vaHex fileOffsetHexbytes available T)rrhex)exesectionsvasizeoffsetblobs r exe_bytesr se (B 'F ~V!   v &DBF#  rc vgd}|Dcgc]\}}}}it||||||dc}}}}Scc}}}}w)N))iX\Azpalette header versionz1writes 0x0300 to the palette header at 0x004676e4)ib\Ar"zpalette entry countz9writes 0x0100 to palette header +2, grounding 256 entries)ih\Azpalette entries pointerzAsets 0x004676e8 to palette header +4, the first PALETTEENTRY byte)i\A zPC flag byte loopz:writes byte 0x04 to entry flag byte for entries 0x0a..0xf5)i.eAr"zCreatePalette callz5calls IDirectDraw::CreatePalette through vtable +0x14)iUeAr"zprimary SetPalette callzHattaches the created palette to the primary surface through vtable +0x7c)ieAr"zrange apply wrapperz8calls the SetEntries helper for range start 0 count 0xff)i!fAzSetEntries source pointerzBcomputes 0x004676e8 + start * 4 as the PALETTEENTRY source pointer)iIfAr"zSetEntries call A9calls IDirectDrawPalette::SetEntries through vtable +0x18)iwfAr"zSetEntries helper Bz;second range-apply helper used by VM/deferred palette paths)igAr"zSetEntries call Br&)izgAr#zcopy red channelzCcopies caller/source red byte into the current palette entry buffer)igAr#zcopy green channelzEcopies caller/source green byte into the current palette entry buffer)igAr#zcopy blue channelzDcopies caller/source blue byte into the current palette entry buffer)igAr"zcopy then applyzd7g||d?d@gdAdBdCdD|tj|jdEijdFdGu|jdijdFdGu|jd ijdFdGu|jdijdFdGu|jdHijdFdGudGdIdJdKdLdMdNdOdPdMdQdRdSdMggdTdU Scc}w)VNr 0x0041652ezIDirectDraw::CreatePalette0x14z.flags=0x04, entries=0x004676e8, out=0x004676c4zKcreates the 8-bit DirectDraw palette object from the EXE-owned entry buffer)rmethodvtableOffsetHex argumentsrole 0x00416555zIDirectDrawSurface::SetPalette0x7cz9surface=primary wrapper at 0x0055abd8, palette=0x004676c4z>attaches the DirectDraw palette to the primary display surface 0x00416649zIDirectDrawPalette::SetEntries0x18z:start/count from helper args, entries=0x004676e8 + start*4zAapplies a current-palette range after computing the entry pointer 0x00416708z9second range apply path used after palette VM/list writes 0x00416856zIDirectDrawPalette::GetEntries0x20zreads entries into EXE bufferz palette snapshot/readback helper 0x00415c53zpalette buffer initializerzjinitializes a DD-style palette header, 256-entry count, entry pointer, and PC flags for entries 0x0a..0xf5grounded)rnameeffectstatus 0x004165b8zrange SetEntries helper Azhoptionally reattaches the palette to the primary surface, then applies a range from 0x004676e8 + start*4 0x00416677zrange SetEntries helper BzQsame range-apply class as A; this one is reached by deferred palette update paths 0x00416736zRGB copy then SetEntrieszacopies count RGB triples into the current palette entry buffer, then calls the range apply helperzhwanse-palette-pipeline-reviewz'palette-buffer-copy-apply-path-grounded)r zout/directdraw_flow.jsonz0web/map_animation_execution_boundary_review.htmlz(tools/build_map_animation_tile_review.pyz640x480x8 indexed color 0x004676c4 0x004676e4 0x004676e8zR, G, B, flagsz 0x0a..0xf50x04zThe EXE keeps a mutable 256-entry palette buffer at 0x004676e8. Palette effects copy or step RGB bytes inside that buffer, then push a range to DirectDraw with SetEntries. This is a color/fade/ramp pipeline, not proof of tile-position animation.) displayModepaletteObjectGlobalpaletteHeaderGlobalpaletteEntriesGlobal entryCountentryStrideBytes entryLayout pcFlagRange pcFlagValuesetEntriesHelperscopyThenApplyHelperbyteEvidenceRowscoreConclusionz!DirectDraw palette object pointerz@receives the IDirectDrawPalette pointer created by CreatePalette) addressHexr;r(zpalette header/allocationzCstores version 0x0300 and entry count 0x0100 before the entry byteszcurrent palette entriesz7first mutable PALETTEENTRY; entry i is 0x004676e8 + i*4 0x00559d98zpalette dirty flagzYmap/VM palette handlers mark pending palette changes before the deferred SetEntries apply0x380x39zz0x38 steps palette entries toward target/list/backup RGB values; 0x39 writes/fills current or backup palette ranges/lists.zoif dirty flag 0x00559d98 is set, the VM path applies start 0 count 0x100 through 0x00416677 and clears the flagz~these handlers explain palette color transforms and fades, but do not identify per-map waterfall/fire tile source-index motion)knownOpcodeFamiliesconfirmedMeaning deferredApplyboundary 0x00415c58rT 0x004167f1)hasExepaletteHeaderWriteAvailablecreatePaletteCallAvailablesetEntriesCallAAvailablesetEntriesCallBAvailablecopyThenApplyAvailablenotMapTileMotionProofzpalette fade/rampzjrange/list RGB writes plus SetEntries are grounded and should be treated as the EXE palette animation pathpromoted)area conclusionr=zindexed CNS renderingzweb rendering should preserve palette-index semantics where fidelity matters; precolored immutable PNGs cannot model later SetEntries updateszimplementation-guidancezmap animated tileszpalette changes can recolor indexed pixels, but visible waterfall/fire source-tile motion still needs a separate tile/source-index producerzboundary-fixed)zaName the exact callers that feed palette opcode 0x38/0x39 streams for each scene/map/effect root.zwFind the non-palette producer for map tile source-index motion if waterfall/fire animation is not purely palette-based.zsCapture or statically bind which palette ranges are used by individual battle helper effects that are palette-only.) kindr=sourcesummary memoryModeldirectDrawPaletteCallsupdateRoutinespaletteVmBoundary byteEvidence verificationmodelBoundaries openQuestions) EXE read_bytesrr*strlowerlenexistsget)rr byte_rowsrow byte_by_vadirect_draw_palette_callsupdate_routiness r build_reportrs .. CS!Hc8,I>,+K+O+OP[+\`d+d*4..r*J*N*N{*[_c*c(2|R(H(L(L[(Y]a(a(2|R(H(L(L[(Y]a(a&0nn\2&F&J&J;&W[_&_%) ,K$  0n3  -l*  " q] ]GGs$F*ct}tjdtdz jt j |dddzd y ) NT)exist_okzpalette_pipeline_review.jsonF) ensure_asciiindent zutf-8)encodingr)rOUTmkdir write_textjsondumps)reports rmainr9sM ^FIItI ))55 6a84?6 r__main__)rz int | Nonereturnz str | None)) rrrlist[dict[str, Any]]rintrrrdict[str, Any])rrrrrr)rr)rr)__doc__ __future__rrpathlibrtypingrprobe_exe_scene_tablesrr__file__resolveparentsROOTrrsrr r*rr__name__ SystemExitrrrrsN" > H~''* Ul ] $fRdN  z TV r