Function parseWithWasm

src/parsers/wasmParser.ts:21–216

(
  camerasFile: File,
  imagesFile: File,
  points3DFile: File,
  rigsFile?: File,
  framesFile?: File,
)

 * Returns the WASM wrapper along with parsed data so it can be kept alive for fast rendering path
 */
export async function parseWithWasm(
  camerasFile: File,
  imagesFile: File,
  points3DFile: File,
  rigsFile?: File,
  framesFile?: File,
): Promise<{
  cameras: Map<number, Camera>;
  images: Map<number, ColmapImage>;
  rigData?: RigData;
  wasmWrapper: WasmReconstructionWrapper;
} | null> {
  let wasm: WasmReconstructionWrapper | null = null;

  try {
    wasm = await createWasmReconstruction();
    if (!wasm) {
      appLogger.warn('[WASM] Module not available, falling back to JS parser');
      return null;
    }

    // Only parse binary files with WASM (text files use JS parser)
    if (!camerasFile.name.endsWith('.bin') ||
        !imagesFile.name.endsWith('.bin') ||
        !points3DFile.name.endsWith('.bin')) {
      appLogger.info('[WASM] Text files detected, using JS parser');
      wasm.dispose();
      return null;
    }

    // Also check if rig files are text (will fall back to JS for those specifically)
    const canParseRigsWithWasm = rigsFile && framesFile &&
      rigsFile.name.endsWith('.bin') && framesFile.name.endsWith('.bin');

    const startTime = performance.now();

    // Parse all files with WASM
    const [camerasBuffer, imagesBuffer, points3DBuffer] = await Promise.all([
      camerasFile.arrayBuffer(),
      imagesFile.arrayBuffer(),
      points3DFile.arrayBuffer(),
    ]);

    const camerasOk = wasm.parseCameras(camerasBuffer);
    // Use lazy parsing - 2D points are NOT cached in WASM memory
    // Instead, only file offsets are stored (~50KB), and 2D points are loaded on-demand
    // This enables loading 1.9GB+ images.bin files without running out of memory
    const imagesOk = wasm.parseImagesLazy(imagesBuffer);
    const points3DOk = wasm.parsePoints3D(points3DBuffer);

    if (!camerasOk || !imagesOk || !points3DOk) {
      appLogger.warn('[WASM] Failed to parse some files, falling back to JS parser');
      wasm.dispose();
      return null;
    }

    const parseTime = performance.now() - startTime;
    appLogger.info(`[WASM] Parsed in ${parseTime.toFixed(0)}ms: ${wasm.cameraCount} cameras, ${wasm.imageCount} images, ${wasm.pointCount} points`);