8JjC.dZddlmZddlZddlmZddlmZeejjdZ e dz Z d dZ dd Zdd Zdd Zed k(r eey)a:Build a compact field-vs-battle render pipeline model review. This report does not introduce a new speculative renderer. It consolidates already-grounded DirectDraw, field tile redraw, and battle helper/object evidence into one active artifact so later CNS rect/source-rect work can share the same mental model. ) annotationsN)Path)Anyoutct|z }|jsdd|dStj|j dS)NTout/)missingpathutf-8encoding)OUTexistsjsonloads read_text)namer s +tools/build_render_pipeline_model_review.py read_jsonrs? :D ;;=4v77 ::dnngn6 77cd||jd |jd|jdxs|jddS)Nr r kindstatuspromotionStatus)r rrr)get)rpayloads rartifact_statusrsKtf kk),, F#++h'I7;;7H+I  rc,td}td}td}td}td}|jdxsi}|jdxsi}|jdxsi}|jdxsi}|jdxsi} |jdxsi} |jd xsg} | D cgc]} | jd d us| } } d d gddddd|jdxsdt| t| d|jd| jd| jd| jd| jdddd td|td|td|td|td|gd|jdxsd|jdxsgd d!d"d#d$d%d&d'd(d)d*d+d,d-d.d/d0d1d2d3d4d2d5d6d2d7d8d2d9d:d2d;dd?d@dA|jdB|jdC|jdD|jdE|jdFdGdHdIdJdKdLdMdNdOdPdQdRdSdTd2dUdVd2dWdXd2dYdZd2g| jd| jd[| jd| jd\| jd| jd]| jd^| jd_d`dadbdcdddedfdgdedhdidedjdkdegdl Scc} w)mNzdirectdraw_flow.jsonz)map_animation_redraw_consumer_review.jsonz-map_animation_draw_tile_transform_review.jsonz battle_effect_object_review.jsonz-battle_child_lifecycle_draw_order_review.jsonsurfaces verificationsummary vtableCallsverifiedTz#hwanse-render-pipeline-model-reviewz"field-battle-render-model-grounded)zout/directdraw_flow.jsonz-out/map_animation_redraw_consumer_review.jsonz1out/map_animation_draw_tile_transform_review.jsonz$out/battle_effect_object_review.jsonz1out/battle_child_lifecycle_draw_order_review.jsonz(docs/map3_active_object_overlay_notes.mdzdocs/DIRECTDRAW_NOTES.md 640x480x8z$DirectDraw surface/palette copy pathz437x21 visible tile grid plus dirty/occlusion bufferszBactive object/sprite/effect display objects over battle backgroundsurfaceTableBaseHex 0x0055abd8zLconfirmed redraw invalidation consumer; visible frame producer still unbound#drawTimeVisibleMotionTransformFoundhelpershelpersWithSpawnTreehelpersWithMotionSteptotalDirectSpawnEvents)r)r*r+r,zTransparency must be tracked as draw-call/context state. A source CNS transparent color alone is not sufficient unless the Blt/BltFast path requests source color key handling.) displayResolutionsharedApiSurface fieldDrawUnitbattleDrawUnitsurfaceWrapperTabledirectDrawVerifiedCallCountdirectDrawTotalCallCountfieldAnimatedFlag0x40MeaningfieldDrawTimeTileTransformFoundbattleHelperCoveragecolorKeyConclusionzgrounded-call-surfaceprimarySurfaceSlotsz 640, 480, 8z%primary/offscreen/backbuffer wrappersz256-entry palette pathz/fullscreen and copy/windowed presentation paths)SetDisplayMode CreateSurfacez#CreatePalette/SetPalette/SetEntrieszFlip/BltzThis proves the Win32/DirectDraw presentation surface, not the full game-engine draw ordering. Field and battle diverge before these DirectDraw calls.)evidenceStatusr1 primarySlotsconfirmedMethodsboundaryz&tilemap-dirty-render-consumer-groundedz%tile row renderer over 37x21 viewportz0x005957d0 + y * 37 + xz0x0058d7d0 + index * 2z0x00595af0 + index * 2 0x004576dc 0x004576de 0x00595ada)dirtyVisibleGridliveLayer1FlagsliveLayer0TileIdsviewXviewYmapWidth 0x00425403z"37x21 viewport dirty scan wrapper.)vaHexmeaning 0x00425494z/Reads layer1 flags and tests low byte bit 0x40. 0x004254a5z0Marks matching visible dirty cell with bit 0x01. 0x00425163z.Dirty row renderer reads live layer0 tile ids. 0x004175d3zKPacks draw descriptor into temporary object +0x28 and x/y into +0x1c/+0x20. 0x004199a0zUConverts low-word tile/frame index to source rect using wrapper width/height/columns.zsprite/tile cell widthzsprite/tile cell heightcolumnszgroup table candidate)z+0x2ez+0x30z+0x32z+0x34usesLayer1AnimatedFlag0x40usesFrameCounterusesPerMapAnimationSequencealternateTileSelectionFoundvisibleMotionProducerFound)drawTimeUsesLayer1Flag0x40drawTimeUsesFrameCounter#drawTimeUsesPerMapAnimationSequence+alternateTileSelectionFoundInRedrawConsumer*visibleMotionProducerFoundInRedrawConsumerzField animation flag 0x40 is a redraw invalidation/input to dirty rendering. The visible motion source is still not proven in the generic tile converter; if motion is tile-id based, a producer must mutate 0x00595af0 before redraw.)r;drawUnitglobalsconfirmedSteps wrapperFieldsnegativeEvidencecurrentConclusionz#object-sprite-helper-model-groundedz:active object / battle actor / helper child display object 0x0055a800z0x0055abd8 + slot * 4zPpacked draw-source selector; low word frame/source index, high word surface slotzprojected x, fixed 16.16zprojected y, fixed 16.16zEdraw/object flags candidate; exact bit roles still need focused proof) currentObjectr1z object+0x28z object+0x1cz object+0x20z object+0x2c 0x00416ce2z+Common active-object rect/draw-source path.z0x00416ceb..0x00416cf6z8Uses object+0x28 low word as source rect/frame selector.z0x00416cf9..0x00416d07zBUses object+0x28 high word as surface slot and indexes 0x0055abd8.z0x00416d11..0x00416d3dz5Uses object+0x1c/+0x20 as projected draw coordinates.helpersWithDirectFrameScripthelpersWithRandomRangeframeScriptSpriteCountsrendererReadinessCountsdrawOrderStatusCounts)r)rdr*rer+rfrgrhzBattle rendering is not a visible tile grid pass. It composes a battle background and object/helper frame streams, with source selection routed through object+0x28 and surface wrapper metadata.)r;r[globalsAndFieldsr]helperEvidencer`zfield animation producerzSearch for live layer0 0x00595af0 mutation tied to map tick/frame counter, or prove a specialized draw path outside 0x004199a0.)areaworkzwrapper validationzoDump wrapper +0x2e/+0x30/+0x32/+0x34 for loaded CNS slots and compare against the CNS rect/source-rect catalog.zdraw flags / color keyz~Decode object+0x2c and Blt/BltFast flag consumers to separate opaque copy, source-color-key copy, and palette/context effects.zbattle object placementzKeep battle actor/helper position opcodes separate from field tilemap placement; do not reuse map_*3 assumptions for battle effects.) rrsourcer"artifactStatusessharedDirectDrawModel fieldPipelinebattlePipeline nextFrontier)rrlenr) directdrawredrawdraw_transform battle_objectbattle_lifecycledirectdraw_surfacesdirectdraw_verificationredraw_summarytransform_summarybattle_object_summarybattle_lifecycle_summarydirectdraw_callsrowdirectdraw_verified_callss r build_reportr$s:12J B CFNON@AM !PQ$..4:(nn^<BZZ *0bN&**95;)--i8>B/33I>D"!~~m4:0@ `CGGJDW[_D_ ` `66 "- FSb#6#:#:;P#Q#aUa+./H+I(+,<(=,z/@/D/DEj/k044Y?(=(A(ABX(Y)>)B)BCZ)[*B*F*FG_*` %R# , 2J ? G P K^ \ > N KM] ^  6#6#:#:;P#Q#aUa/334IJPb"/!H7OM !J" G?$=#;%=%%( *C *P *Q *O *l *v+622"0 /@.C.CD`.a,=,A,ABT,U7H7L7LMj7k?M?Q?QRo?p>L>P>PQm>n !Eg6 pDT!-'>q99f !*L 6Y 6c 6V&144Y?0E0I0IJh0i(=(A(ABX(Y*?*C*CD\*])>)B)BCZ)[+@+D+DE^+_+C+G+GHa+b)A)E)EF])^ aQ+ \3Z  -J  1Y  2_  ul l!as L(Lctjdt}tdz jt j |dddzd t d t t j |d ddy ) NT)exist_okz!render_pipeline_model_review.jsonF) ensure_asciiindent r r zrender_pipeline_model_review okr"r)rmkdirr write_textrdumpsprint)reports rmainrspIItI ^F ..:: 6a84?; +, $**VI&U1 EF r__main__)rstrreturndict[str, Any])rrrrrr)rr)rint)__doc__ __future__rrpathlibrtypingr__file__resolveparentsROOTrrrrr__name__ SystemExitrrrsr#  H~''* Ul8|~   z TV r