KRPano Multi-Res Generator

Generate multi-resolution panorama projects entirely in-memory.

\n \n \n

\n \n\n\n`;\n\n// ---------------------------------------------------------\n// 2. Wasm-Vips Environment Workaround\n// ---------------------------------------------------------\n// ---------------------------------------------------------\n// 2. Wasm-Vips Environment Workaround (In-Memory Filesystem)\n// ---------------------------------------------------------\nconst tmpFiles = new Map(); // Stores file path -> { buf: Uint8Array, size: number }\nconst tmpFds = new Map(); // Stores file descriptor -> { path, pos }\nlet nextFd = 10000; // Starting file descriptor number\nconst URANDOM_FD = 99999;\n\n// A robust, Node-compliant mock stat object\nconst dummyStat = (isDir, size = 0, options = {}) => {\n const mode = isDir ? 16877 : 33188; // 040755 for dir, 0100644 for file\n const now = Date.now();\n const blksize = 4096;\n const blocks = Math.ceil(size / 512);\n\n const stat = {\n isFile: () => !isDir,\n isDirectory: () => isDir,\n isBlockDevice: () => false,\n isCharacterDevice: () => false,\n isSymbolicLink: () => false,\n isFIFO: () => false,\n isSocket: () => false,\n dev: 1,\n ino: 12345, // Fake inode\n mode: mode,\n nlink: 1,\n uid: 1000,\n gid: 1000,\n rdev: 0,\n size: size,\n blksize: blksize,\n blocks: blocks,\n atimeMs: now,\n mtimeMs: now,\n ctimeMs: now,\n birthtimeMs: now,\n atime: new Date(now),\n mtime: new Date(now),\n ctime: new Date(now),\n birthtime: new Date(now),\n };\n\n // If Emscripten explicitly asks for BigInts\n if (options && options.bigint) {\n stat.dev = BigInt(stat.dev);\n stat.ino = BigInt(stat.ino);\n stat.mode = BigInt(stat.mode);\n stat.nlink = BigInt(stat.nlink);\n stat.uid = BigInt(stat.uid);\n stat.gid = BigInt(stat.gid);\n stat.rdev = BigInt(stat.rdev);\n stat.size = BigInt(stat.size);\n stat.blksize = BigInt(stat.blksize);\n stat.blocks = BigInt(stat.blocks);\n stat.atimeMs = BigInt(stat.atimeMs);\n stat.mtimeMs = BigInt(stat.mtimeMs);\n stat.ctimeMs = BigInt(stat.ctimeMs);\n stat.birthtimeMs = BigInt(stat.birthtimeMs);\n }\n\n return stat;\n};\n\n// Helper to cleanly intercept Node FS calls and fallback to original\nconst wrapFs = (method, handler) => {\n const orig = fs[method];\n fs[method] = function (...args) {\n try {\n const result = handler(orig ? orig.bind(fs) : null, ...args);\n if (result !== undefined) return result;\n } catch (e) {\n if (e.isMockBypass) return orig.apply(fs, args);\n throw e;\n }\n };\n};\nconst bypass = () => {\n const e = new Error();\n e.isMockBypass = true;\n throw e;\n};\n\n// 1. STAT: Pretend /tmp exists, report virtual file sizes, and block build paths\nwrapFs(\"statSync\", (orig, path, options) => {\n const p = path?.toString().replace(/\\\\/g, \"/\");\n if (p === \"/tmp\" || p === \"/tmp/\") return dummyStat(true, 0, options);\n if (p?.startsWith(\"/tmp/\")) {\n if (tmpFiles.has(p)) return dummyStat(false, tmpFiles.get(p).size, options);\n const err = new Error(`ENOENT: no such file or directory, stat '${p}'`);\n err.code = \"ENOENT\";\n throw err;\n }\n // NEW: Intercept hardcoded Wasm build paths and cleanly report them as missing\n if (p?.startsWith(\"/src/build/target/\")) {\n if (p.includes(\"/vips-modules-8.18\")) return dummyStat(true, 0, options);\n const err = new Error(`ENOENT: no such file or directory, stat '${p}'`);\n err.code = \"ENOENT\";\n throw err;\n }\n bypass();\n});\n\nwrapFs(\"lstatSync\", (orig, path, options) => {\n const p = path?.toString().replace(/\\\\/g, \"/\");\n if (p?.startsWith(\"/tmp/\")) return fs.statSync(path, options); // Route to our mock statSync\n\n // NEW: Shield lstatSync as well\n if (p?.startsWith(\"/src/build/target/\")) {\n if (p.includes(\"/vips-modules-8.18\")) return dummyStat(true, 0, options);\n const err = new Error(`ENOENT: no such file or directory, lstat '${p}'`);\n err.code = \"ENOENT\";\n throw err;\n }\n bypass();\n});\n\n// 2. OPEN: Create a virtual file descriptor and store a direct reference to the memory object\nwrapFs(\"openSync\", (orig, path, flags, mode) => {\n const p = path?.toString().replace(/\\\\/g, \"/\");\n if (p === \"/dev/urandom\") return URANDOM_FD;\n if (p?.startsWith(\"/tmp/\")) {\n const fd = nextFd++;\n if (!tmpFiles.has(p)) {\n tmpFiles.set(p, { buf: new Uint8Array(1024 * 1024), size: 0 });\n }\n\n // CRITICAL FIX: Store direct reference to `fileObj` so it survives path unlinking\n tmpFds.set(fd, { path: p, pos: 0, fileObj: tmpFiles.get(p) });\n return fd;\n }\n if (p?.startsWith(\"/src/build/target/\")) {\n const err = new Error(`ENOENT: no such file or directory, open '${p}'`);\n err.code = \"ENOENT\";\n throw err;\n }\n bypass();\n});\n\n// 3. READ: Return data using the direct object reference\nwrapFs(\"readSync\", (orig, fd, buffer, offset, length, position) => {\n if (fd === URANDOM_FD) {\n globalThis.crypto.getRandomValues(\n new Uint8Array(buffer.buffer, buffer.byteOffset + offset, length),\n );\n return length;\n }\n if (tmpFds.has(fd)) {\n const file = tmpFds.get(fd);\n const fileObj = file.fileObj; // Use direct reference\n const readPos = (position != null && position !== -1) ? position : file.pos;\n\n const available = Math.max(0, Math.min(length, fileObj.size - readPos));\n if (available > 0) {\n const dest = new Uint8Array(\n buffer.buffer,\n buffer.byteOffset + offset,\n available,\n );\n dest.set(fileObj.buf.subarray(readPos, readPos + available));\n }\n\n if (position == null || position === -1) file.pos = readPos + available;\n return available;\n }\n bypass();\n});\n\n// 4. WRITE: Write using the direct object reference\nwrapFs(\"writeSync\", (orig, fd, buffer, offset, length, position) => {\n if (tmpFds.has(fd)) {\n const file = tmpFds.get(fd);\n const fileObj = file.fileObj; // Use direct reference\n const writePos = (position != null && position !== -1)\n ? position\n : file.pos;\n\n const endPos = writePos + length;\n if (endPos > fileObj.buf.length) {\n const newBuf = new Uint8Array(\n Math.max(fileObj.buf.length * 2, endPos + 1024 * 1024),\n );\n newBuf.set(fileObj.buf);\n fileObj.buf = newBuf;\n }\n\n const src = new Uint8Array(\n buffer.buffer,\n buffer.byteOffset + offset,\n length,\n );\n fileObj.buf.set(src, writePos);\n fileObj.size = Math.max(fileObj.size, endPos);\n\n if (position == null || position === -1) file.pos = endPos;\n return length;\n }\n bypass();\n});\n\n// 5. LIFECYCLE: Close descriptors and delete tmp files from memory when done\nwrapFs(\"closeSync\", (orig, fd) => {\n if (fd === URANDOM_FD) return;\n if (tmpFds.has(fd)) {\n tmpFds.delete(fd);\n return;\n }\n bypass();\n});\n\nwrapFs(\"unlinkSync\", (orig, path) => {\n const p = path?.toString().replace(/\\\\/g, \"/\");\n if (p?.startsWith(\"/tmp/\")) {\n if (tmpFiles.has(p)) {\n tmpFiles.delete(p);\n return;\n }\n const err = new Error(`ENOENT: no such file or directory, unlink '${p}'`);\n err.code = \"ENOENT\";\n throw err;\n }\n bypass();\n});\n\n// 6. MISC: File stats via Descriptor and Directory skipping\n// Update fstatSync to also accept and pass options\n// Update fstatSync to use direct reference too\nwrapFs(\"fstatSync\", (orig, fd, options) => {\n if (tmpFds.has(fd)) {\n const fileObj = tmpFds.get(fd).fileObj; // Use direct reference\n return dummyStat(false, fileObj.size, options);\n }\n bypass();\n});\n\nwrapFs(\"readdirSync\", (orig, path) => {\n if (\n path?.toString().replace(/\\\\/g, \"/\").includes(\n \"/src/build/target/lib/vips-modules-8.18\",\n )\n ) return [];\n bypass();\n});\n\nwrapFs(\"readFileSync\", (orig, path) => {\n const p = path?.toString().replace(/\\\\/g, \"/\");\n if (p?.includes(\"/src/build/target/lib/vips-modules-8.18\")) {\n throw new Error(`EISDIR: illegal operation on a directory, read '${p}'`);\n }\n bypass();\n});\n\n// 4.5 TRUNCATE: Resize using the direct object reference\nwrapFs(\"ftruncateSync\", (orig, fd, length) => {\n if (tmpFds.has(fd)) {\n const file = tmpFds.get(fd);\n const fileObj = file.fileObj; // Use direct reference\n const newSize = length || 0;\n\n if (newSize > fileObj.buf.length) {\n const newBuf = new Uint8Array(newSize);\n newBuf.set(fileObj.buf);\n fileObj.buf = newBuf;\n } else if (newSize < fileObj.size) {\n fileObj.buf.fill(0, newSize, fileObj.size);\n }\n\n fileObj.size = newSize;\n return;\n }\n bypass();\n});\n\n// Also mock truncateSync (by path) just in case Emscripten falls back to it\nwrapFs(\"truncateSync\", (orig, path, length) => {\n const p = path?.toString().replace(/\\\\/g, \"/\");\n if (p?.startsWith(\"/tmp/\")) {\n if (tmpFiles.has(p)) {\n const fileObj = tmpFiles.get(p);\n const newSize = length || 0;\n\n if (newSize > fileObj.buf.length) {\n const newBuf = new Uint8Array(newSize);\n newBuf.set(fileObj.buf);\n fileObj.buf = newBuf;\n } else if (newSize < fileObj.size) {\n fileObj.buf.fill(0, newSize, fileObj.size);\n }\n\n fileObj.size = newSize;\n return;\n }\n const err = new Error(`ENOENT: no such file or directory, truncate '${p}'`);\n err.code = \"ENOENT\";\n throw err;\n }\n bypass();\n});\n\n// ---------------------------------------------------------\n// 3. Initialize VIPS and Hono\n// ---------------------------------------------------------\nconsole.log(\"Loading wasm-vips...\");\nconst { default: VipsInit } = await import(\"npm:wasm-vips\");\nconst vips = await VipsInit();\nif (vips.Cache) vips.Cache.max(0); // Essential for memory safety in edge environments\nconsole.log(\"wasm-vips ready.\");\n\nconst app = new Hono();\napp.use(\"*\", cors());\n\n// ---------------------------------------------------------\n// 4. Utility: Equirectangular to Cube Face LUT\n// ---------------------------------------------------------\nasync function createCubeFaceLUT(faceName, width, height, eqW, eqH) {\n const lut = new Float32Array(width * height * 2);\n let i = 0;\n\n // Pre-calculate constants outside the intensive loop\n const pi = Math.PI;\n const pi2 = 2.0 * pi;\n const wFactor = 2.0 / (width - 1);\n const hFactor = 2.0 / (height - 1);\n const eqWMinus1 = eqW - 1;\n const eqHMinus1 = eqH - 1;\n\n for (let y = 0; y < height; y++) {\n const v = 1.0 - y * hFactor;\n\n for (let x = 0; x < width; x++) {\n const u = x * wFactor - 1.0;\n let cx, cy, cz;\n\n switch (faceName) {\n case \"f\":\n cx = u;\n cy = v;\n cz = 1;\n break;\n case \"b\":\n cx = -u;\n cy = v;\n cz = -1;\n break;\n case \"l\":\n cx = -1;\n cy = v;\n cz = u;\n break;\n case \"r\":\n cx = 1;\n cy = v;\n cz = -u;\n break;\n case \"u\":\n cx = u;\n cy = 1;\n cz = -v;\n break;\n case \"d\":\n cx = u;\n cy = -1;\n cz = v;\n break;\n }\n\n const r = Math.sqrt(cx * cx + cy * cy + cz * cz);\n\n // Fast clamp avoiding Math.max/min\n let normY = cy / r;\n if (normY < -1.0) normY = -1.0;\n else if (normY > 1.0) normY = 1.0;\n\n const theta = Math.acos(normY);\n const phi = Math.atan2(cx, cz);\n\n lut[i++] = ((phi + pi) / pi2) * eqWMinus1;\n lut[i++] = (theta / pi) * eqHMinus1;\n }\n\n // Yield to the event loop every 128 rows.\n // This keeps the Deno networking alive and prevents the \"socket hang up\".\n if (y % 128 === 0) {\n await new Promise((res) => setTimeout(res, 0));\n }\n }\n\n return {\n lutImg: vips.Image.newFromMemory(lut, width, height, 2, \"float\"),\n lutBuffer: lut,\n };\n}\n\n// ---------------------------------------------------------\n// 5. Routes\n// ---------------------------------------------------------\napp.get(\"/\", (c) => c.html(HTML_FRONTEND));\n\napp.post(\"/api/makepano\", async (c) => {\n const body = await c.req.parseBody();\n const file = body[\"image\"];\n const baseSphereFile = body[\"basesphere\"];\n const imgBaseName = typeof file === \"string\"\n ? \"pano\"\n : file.name.replace(/\\.[^/.]+$/, \"\");\n\n if (!file || typeof file === \"string\") {\n return c.text(\"Missing image file\", 400);\n }\n\n const tileSize = parseInt(body[\"tileSize\"] || \"512\", 10);\n const levelsArg = body[\"levels\"] || \"auto\";\n\n let sourceImg;\n let baseImg;\n\n try {\n const arrayBuffer = await file.arrayBuffer();\n sourceImg = vips.Image.newFromBuffer(new Uint8Array(arrayBuffer));\n\n // 1. Nadir Patching\n if (baseSphereFile && typeof baseSphereFile !== \"string\") {\n const baseBuffer = await baseSphereFile.arrayBuffer();\n baseImg = vips.Image.newFromBuffer(new Uint8Array(baseBuffer));\n\n // Resize base to exactly match source dimensions, then blend\n const resizedBase = baseImg.resize(sourceImg.width / baseImg.width, {\n vscale: sourceImg.height / baseImg.height,\n });\n const composited = sourceImg.composite(resizedBase, \"over\"); // 'over' applies standard alpha blend\n\n sourceImg.delete();\n resizedBase.delete();\n sourceImg = composited;\n }\n\n // 2. Geometry Calculation\n const fullWidth = sourceImg.width;\n let cubeWidth = Math.floor(fullWidth / 4);\n if (cubeWidth % 2 !== 0) cubeWidth -= 1; // Ensure even width\n\n // 3. Determine Levels\n let maxLevels = parseInt(levelsArg, 10);\n if (levelsArg === \"auto\" || isNaN(maxLevels)) {\n maxLevels = Math.max(1, Math.ceil(Math.log2(cubeWidth / tileSize)));\n }\n\n const readableStream = new ReadableStream({\n async start(controller) {\n let zip;\n try {\n zip = new Zip((err, dat, final) => {\n if (err) controller.error(err);\n else {\n if (dat.length > 0) controller.enqueue(dat);\n if (final) controller.close();\n }\n });\n\n const faces = [\"l\", \"f\", \"r\", \"b\", \"u\", \"d\"];\n const previewStrips = [];\n let thumbBuffer;\n\n // 4 & 5. Loop over cube faces, extract using mapim, and Tile\n for (const face of faces) {\n const { lutImg, lutBuffer } = await createCubeFaceLUT(\n face,\n cubeWidth,\n cubeWidth,\n sourceImg.width,\n sourceImg.height,\n );\n const faceImg = sourceImg.mapim(lutImg);\n lutImg.delete(); // Free memory immediately\n\n // Create Preview & Thumb assets (256x256 shrink for preview strip)\n const previewFaceLazy = faceImg.resize(256 / cubeWidth, {\n vscale: 256 / cubeWidth,\n });\n\n // CRITICAL FIX: Force VIPS to compute the pixels into RAM right now\n // so we can safely delete the giant parent faceImg pipeline!\n const previewFace = previewFaceLazy.copyMemory();\n previewFaceLazy.delete();\n\n previewStrips.push(previewFace);\n\n if (face === \"f\") {\n const thumbImg = faceImg.resize(240 / cubeWidth, {\n vscale: 240 / cubeWidth,\n });\n thumbBuffer = thumbImg.writeToBuffer(\".jpg\");\n thumbImg.delete();\n\n const thumbFile = new ZipPassThrough(\n `panos/${imgBaseName}/thumb.jpg`,\n );\n zip.add(thumbFile);\n thumbFile.push(thumbBuffer, true);\n }\n\n // 6. Multi-resolution Tiling\n for (let l = 1; l <= maxLevels; l++) {\n const numTiles = Math.pow(2, l);\n const targetPx = numTiles * tileSize;\n\n // Scale face to the resolution required for this level\n const scale = targetPx / cubeWidth;\n const scaledFace = scale === 1 ? faceImg : faceImg.resize(scale);\n\n for (let ty = 0; ty < numTiles; ty++) {\n for (let tx = 0; tx < numTiles; tx++) {\n const tileImg = scaledFace.extractArea(\n tx * tileSize,\n ty * tileSize,\n tileSize,\n tileSize,\n );\n const outBuffer = tileImg.writeToBuffer(\".jpg\");\n tileImg.delete();\n\n // KRpano typically expects 1-indexed variables (%v and %h)\n const yIndex = ty + 1;\n const xIndex = tx + 1;\n const tileFile = new ZipPassThrough(\n `panos/${imgBaseName}/${face}/l${l}/${yIndex}/l${l}_${face}_${yIndex}_${xIndex}.jpg`,\n );\n zip.add(tileFile);\n tileFile.push(outBuffer, true);\n }\n await new Promise((r) => setTimeout(r, 1)); // Yield to edge event loop\n }\n if (scale !== 1) scaledFace.delete();\n }\n faceImg.delete();\n\n // 2. CRITICAL MEMORY LIFECYCLE FIX:\n // By referencing the buffer here, we guarantee V8 cannot garbage\n // collect it until Wasm-vips has entirely finished this face.\n void lutBuffer.byteLength;\n }\n\n // Build & Stream Preview Strip (Vertical append)\n const previewStrip = vips.Image.arrayjoin(previewStrips, {\n across: 1,\n });\n const previewBuffer = previewStrip.writeToBuffer(\".jpg\");\n previewStrip.delete();\n previewStrips.forEach((p) => p.delete());\n\n const previewFile = new ZipPassThrough(\n `panos/${imgBaseName}/preview.jpg`,\n );\n zip.add(previewFile);\n previewFile.push(previewBuffer, true);\n\n // 8. Generate and Stream krpano.xml\n let multiresStr = `${tileSize}`;\n for (let l = 1; l <= maxLevels; l++) {\n multiresStr += `,${Math.pow(2, l) * tileSize}`;\n }\n\n const xmlContent = `\n \n \n \n \n \n \n \n \n \n \n`;\n\n const xmlFile = new ZipPassThrough(`krpano.xml`);\n zip.add(xmlFile);\n xmlFile.push(new TextEncoder().encode(xmlContent), true);\n\n zip.end();\n } catch (err) {\n console.log(\"controller.error called:\", err);\n controller.error(err);\n }\n },\n });\n\n c.header(\"Content-Type\", \"application/zip\");\n c.header(\n \"Content-Disposition\",\n `attachment; filename=\"${imgBaseName}_project.zip\"`,\n );\n return c.body(readableStream);\n } catch (error) {\n if (sourceImg) sourceImg.delete();\n if (baseImg) baseImg.delete();\n console.error(\"Panorama processing error:\", error);\n return c.text(`Error: ${error.message}`, 500);\n }\n});\n\nexport default app.fetch;","label",[72],"pulls","branches","forks","envVars",{"_263":48,"_265":20},"connections",{"_263":20,"_264":20},"count","unfilledCount","emptyCount",{"_41":248,"_13":72,"_70":71,"_51":-5,"_43":44,"_249":173,"_250":190,"_45":267,"_47":166,"_73":93,"_252":253,"_75":24,"_254":-5,"_268":269,"_226":270},["D",1785412806737],"children",[],[72],["D",1785408779692],{"_11":12,"_225":78},{"_11":12,"_221":-5,"_77":78,"_25":76,"_222":223,"_224":24},{"_47":173,"_13":16,"_41":44,"_213":178,"_214":-5,"_215":-5,"_216":-5,"_217":-5,"_218":-5,"_219":14,"_220":12},"ctx",{"_59":-5,"_244":308,"_309":310,"_311":312,"_313":24,"_314":24,"_315":24,"_316":190,"_317":-5,"_318":-7,"_319":-7,"_320":20,"_321":24,"_322":24,"_323":-5,"_324":24,"_325":24,"_326":24,"_327":-5},"ENV",{"_279":280,"_281":282,"_283":16,"_284":285,"_286":287,"_288":289,"_290":291,"_292":293,"_294":295,"_296":297,"_298":299,"_300":301,"_302":303,"_304":305,"_306":307},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History