Parse a VTK XML ImageData (.vti) file into voxel / vector
grids. Handles these <DataArray> encodings:
format="ascii" — whitespace-separated numbers in the XML
text node.
format="binary" — base64-encoded raw bytes with a 4-byte
UInt32 length-header prefix (VTK's canonical layout).
Does NOT support:
format="appended" — raw bytes after the XML doc.
Compression (zlib, lz4).
Big-endian byte order.
Component count picks the destination bucket: 1 → scalar
(VoxelGrid); 3 → vector (VectorGrid). Other counts are
skipped and surfaced as a warning in VTIFile.warnings.
Parse a VTK XML ImageData (
.vti) file into voxel / vector grids. Handles these<DataArray>encodings:format="ascii"— whitespace-separated numbers in the XML text node.format="binary"— base64-encoded raw bytes with a 4-byte UInt32 length-header prefix (VTK's canonical layout).Does NOT support:
format="appended"— raw bytes after the XML doc.zlib,lz4).Component count picks the destination bucket:
1→ scalar (VoxelGrid);3→ vector (VectorGrid). Other counts are skipped and surfaced as a warning in VTIFile.warnings.Returns
SDKResult<VTIFile>— never throws.