M12-07H Status

status: done
task: PLY vertex/face/color/custom property mapping and unknown property loss report
updated: 2026-08-18 America/New_York
enablingTask: false
parityStateChange: false

Scope

The production ply-import protocol now accepts explicitly declared ASCII and binary little-endian PLY. Vertex position, normal, RGBA color, numeric custom properties, face indices, and numeric face properties are mapped into a bounded canonical document. Unsupported vertex/face list properties and unknown elements are skipped with deterministic PLY_UNKNOWN_PROPERTY/PLY_UNKNOWN_ELEMENT loss warnings; mapped fields remain available. The worker serializes the canonical document to bounded ASCII PLY for desktop validation. This task does not expose a general PLY file-picker route or claim full PLY attribute parity.

Evidence

build_blender_5.2.0/bin/blender -b --factory-startup --python tools/web/generate-ply-mapping-fixtures.py -- tests/files/web/m12_ply_mapping_v1 tests/golden/M12-07H/mapping-report.json generated deterministic ASCII and binary little-endian fixtures containing four vertices, two faces, RGBA colors, and two numeric custom vertex attributes. A derived ASCII fixture contains an unsupported list property.
node tools/web/check-ply-mapping-fixtures.mjs matched pinned Blender 5.2 runtime identity, artifact hashes, field counts and a fresh byte-for-byte regeneration: ply-mapping-fixtures-ok vertices=4 faces=2 colors=rgba custom=2 unknown=PLY_UNKNOWN_PROPERTY deterministic=true next=M12-07I.
node --test web/tests/unit/ply-import.test.mjs passed 3/3. It covers both encodings, mapped values, unknown-property loss, serialization/reopen, and format mismatch blocking.
UPDATE_PLY_MAPPING_REPORT=1 CHROME_PATH=/usr/bin/google-chrome-stable WEB_TEST_PORT=5472 node_modules/.bin/playwright test --config playwright.config.ts --workers=1 tests/e2e/ply-web-roundtrip.spec.ts passed 1/1. Production Chromium Worker parsed both encodings, reported unknown loss, serialized ASCII, and pinned Blender 5.2 re-imported the result with exact vertex/face/position counts and mapped custom/color attributes.
npm --prefix web run typecheck, node --check tools/web/check-ply-mapping-fixtures.mjs, and Python compile checks passed.

Artifact Hashes

protocol: 058a3263fde553637840a4e9ad4e8e9d923eb52c250f8000317c7f43a228881d
worker: f6bf5e39e83286d7b257bbdce88f4d7fa027c64651da9765567788b5cf298c71
generator: ffc051eccfc6973ee00cc791cdbd641fcce308b4083741e3e6ae82291d9347b7
checker: 2b055dbc705830848efdf4d8db8543a3ccc684de1f258732bcafefa86cf65c3a
desktop importer: 6edbc6e401a1a902dcfd11c4d767e8c8620d694e40eb4ca29dd8479f9c55ef37
unit/e2e: b03a5f4b4b2a974fa26e653763470b92d1433c5d352ae09ab5492b841e6e5e1f / 2cadebc89057655d78e9b520bb6adf9debb27c6d783cd002efee08d269636fb9
desktop mapping report: 8a02fc9e364ed79e50ef00897affa9ab63808d3cb3cdabd00fdb8ee4c26ec18a
Chromium/desktop round-trip report: 1ca9d3b7870fcc8c9e3c9bbbd90ef48bd13bbc9ae0462312c9482f24f05f13ec
ASCII/binary/unknown fixtures: acaa369c17252d4d089a2e3064d0c1fcdfdb2d066759ed160adf7869d3e859d5 / d0fc195fd1a101c42ac984a2382bccdddb7d0bf60dd618e9f637c964f1b30b9e / a994c7126f235d0067ce4af35f8b0c6699cc83073e2a37e982edd45ece459f33

Next Task

M12-07I: PLY big-endian, malformed list, and oversized count stable blocking.

Rollback

Remove the PLY mapping protocol, worker, fixture generator/checker, fixtures, reports, tests, package script, and this status entry. Restore M12-07G as the queue tail and move the machine queue back to M12-07H. No parity ledger rollback is required.

3.6 KiB Raw Blame History