Skip to content

GPU Native Surface UV01 Binding Preparation

easylogic edited this page Oct 11, 2026 · 3 revisions

Native Surface UV01 source-to-material binding preparation

GPU owner / actual Render1049 requirement6103505767. PLANNED next bounded CPU composition. Native1432 compiler2c1e057a/receipt6103876109 and1434 source producerd6c3392b/receipt6103962663 are qualified separately and handed to soleIntegration; current accepted646ab8 still lacks both. A combined installed/currentRoot/binder/renderer profile is not available. No duplicate Shell1018 or general EngineUV companions; existing uniform-native1049/currentFrame0 remain.

Concrete remaining seam and available controls

1432 publiccompile/IR-validate/lower supplies exact authored normalized-domain shaderIR and trusted GLSL text, but no uniformvalue resolution/geometry association.1434 publicproducer reconstructs COMPLETE geometrySource0/selectednativeSurface/originaldomain/D0packet and normalizedNumber/ownedmutableFloat32, but no material/frame admission. Their valid composition must remain original source-authoritative: authored material.source is DIFFERENT from geometry.request.source; shaderId is notgeometry/native/document identity. Existing legacyMeshMaterialBinding refuses newIR; EngineUV identified catalogcannotauthorize it. This actual native requirement supports preparing a new companion contract; a normalizer array or borrowed catalog is insufficient.

Proposed deliverable and decisions before code

ONE new CPU binding operation could accept exact{geometry:NativeSurfaceUV01GeometryRequest,material:NativeSurfaceUV01MaterialIR,uniforms:ownboundedrecord}, rerun actualproducer fromgeometryrequest and actualnewIRreconstruction, resolve onlydeclareduniforms/defaults/finite declaredrange/canonical+0, and return independentfrozen native/source/IR/resolvedvalues/trustedlower plus independentlyowned mutablecoordinateview. This is a PROPOSAL, not API/schema/version/name readiness. Freeze exact input/outputformat/profile/fieldnames/publictypes/copybudget/code/cause and real materialvalidation/lowering workload first. Do not add a public trustedlower bypass or pretend repeated publicvalidate/lower calls cost onecompile. Source/request/IR/uniforms and derivedarrays each retain their actual bounded ceilings; bound combinedcandidate/copywork explicitly beforeallocation.

Publicsource producer's request source/name/selector/counts/revision fullyqualifies its own nativeModel+domain+packet. It does NOT qualify ViewerTEN/documentId/bodyId/sourceId/assetRevision/nativeFrame/namespace. A later framecompanion must match actualvisibleSurfaceentry/ref and original fullsource/sampling/packet/context, refusing hidden/wrongkind/oldcandidate/same-IDdifferent-source/foreigndomain. Model.name andsource-surfaceId can repeat acrossassets; require explicit caller namespace/pin mapping from actual1369/1049 inventory before admitting companions. Do not silently rename nativeModelmetadata or assume shaderId/refbodyId supplies sourceauthority. Pose/camera/mmToSceneUnit do not alter nativeparameters.

Existing PrimitiveSceneFrameV0.materials/MeshMaterialBinding staytheir legacyformat. Select an explicit new companion/frame/profile version for consuming normalized native materials; no oldschema widening or autoEngineUVcast. Native renderer requires matching vec2attribute/vertexvarying/programvariant, correctdraw/interpolation/opaque lighting/gamma, boundedownedbuffers/programs/steadycandidatepeaks, firstcompleteframe/updateatomicity/loss/recovery1334/disposal. Those decisions/pixel/lifetimegates remain separate. Newcoordinate8Vbyteview is not a linkedGPUresource orexactnativequery.

ONE future acceptance and actual missing dependencies

After actualcompiler+producer acceptedcode receipts and exact newCPUcontract, one source/emitted/DTS/fullgeometrySource+materialSource/file/genuinecold bindingflow uses genuine nonunitSurface anddirect U/Vgradients, reconstructs nativeoriginaldomain/IR/defaults+one authoreduniformupdate, independentlychecks source-qualifiedidentity/uniformvalues/lowertext/copies/coordinatebytes, and rejects source/IR/profile/undeclared/out-of-range/getter/reflection/stale-source candidates while retaining acceptedfiles/data. No publicevaluator/mockpixels or hidden externalcontextcertificate. CPUbinding wouldremaindistinct from actualattribute/frame/program/pixels.

Then actualauthorized originaltarget must show independentlyprojected spatialgradientpixels/nonunitdomain semantics andone update/refusal preserving acceptedframe/native/material/filecontext, followedby ownedloss/disposal stage. Original52215policydenial/userownedhost unchanged; no alternatehost/browser/tool/port/CLI/proxy bypass. Whole1254/674/ViewerRenderconsumeradoption/publication stillunrun. No newIssue createdfrommere1432availability; concrete bindingdecisions/provideradoption are trackedhere. Continue independent source/compiler tasks when a real authoring gap is accepted/rejected and bounded, not based on an absent function wish list.

Actual CPU code adoption and next #1439 binding

1432 adoptedee28a1a/GPU-Native-Surface-UV01-Material-Selected-Contract/reconciliation6103983619: exactFOURblobs/no nativeflowreplay.1434 adopted771ba2e/GPU-Native-Surface-UV01-Geometry-Selected-Contract/reconciliation6104038058: TWOnewblobs/currentbarrelREADME+native3/36line suffixes/1432material+8CADproviders unchanged. BothactualCPUdependenciesnowcodeavailable; currentRoot/graphics/consumer/publicationunrun. #1439 is READY afterduplicatecheck andexact GPU-Native-Surface-UV01-Binding-Selected-Contract: source-reconstructedgeometry+newmaterialIR+declareduniform/default/range +trustedlower innewCPUprofile. Rootnewmodule/index/README anddisjointexampleworker. TWOactualmaterialsnapshot/compilecalls plusONEproducer, no trustedbypass or onecompilefiction. Vertexattrs/newframe/program/GL/currentRoot remainPLANNED.

#1439 native binding CPU completion; adoption pending

Receipt6104105422: clean771ba2e1b7eef80bcb6dd31e8b075c91ce1ff989 ->8b133186a0c5b41dc1e39d33178416f0014395ef, exactfourGPU/example paths. FIRSTbuild0/921.4KiB/FIRSTjoint source-emitted-DTS-fullsource+IR-request-file-cold flow0:16adm46refuse/get0/reflection4/126exports/10cold/source273. Twoactualmaterialsnapshot/compiles plusonesourceproducer; safe__proto__, declareddefault/range uniforms/originalsource-domain-nativeUV-signs-ID versusownedF32/frozenmetadata, actualcauses/offsets/retention passed. ResultSHAfc88c8d038772ffc1bdb6d9f72456e28b7d1e49263fa9b81e18a020653f48b12. ImmutablehandoffonceIntegration+actualRender1049. No failure/repair. Next GPU-Native-Surface-UV01-Renderer-Preparation fixes remainingnewframe/TEN/source/nativevertex-varying/resource/rollback/loss decisions; graphics/currentRoot/consumer/publication stillPLANNED/missing.

Clone this wiki locally