@needle-tools/usd 0.0.2-next.d90870e → 1.0.0-next.d536d99

package/examples/package.json

@@ -1,24 +0,0 @@
-{
-  "name": "@needle-tools/usd-example-three",
-  "private": true,
-  "version": "0.0.0",
-  "type": "module",
-  "scripts": {
-    "start": "npm run dev",
-    "dev": "vite",
-    "build": "tsc && vite build",
-    "preview": "vite preview"
-  },
-  "devDependencies": {
-    "typescript": "^5.2.2",
-    "vite": "^5.0.8",
-    "vite-plugin-static-copy": "^1.0.5"
-  },
-  "dependencies": {
-    "@needle-tools/usd": "file:..",
-    "@types/three": "^0.165.0",
-    "three": "^0.164.1",
-    "vite-plugin-top-level-await": "^1.4.1",
-    "vite-plugin-wasm": "^3.3.0"
-  }
-}

package/examples/public/HttpReferences copy.usda

@@ -1,46 +0,0 @@
-#usda 1.0
-(
-    customLayerData = {
-        string creator = "Mira Ly Herbst, Binh Minh Herbst, Felix Herbst, 2025"
-    }
-    defaultPrim = "Scenery"
-    metersPerUnit = 1
-    upAxis = "Z"
-)
-
-def Xform "Scenery"
-{
-    def "GingerBreadHouse" (
-        prepend references = @https://cloud-staging.needle.tools/-/assets/Z23hmXB22WdG2-22WdG2/house/GingerBreadHouse.usdc@
-        displayName = "Gingerbread House"
-    )
-    {
-        quatf xformOp:orient = (0.5092794, 0, 0, -0.8606013)
-        float3 xformOp:scale = (1, 0.99999994, 0.9999998)
-        float3 xformOp:translate = (0.04039519, -0.0057177544, 0)
-        uniform token[] xformOpOrder = ["xformOp:translate", "xformOp:orient", "xformOp:scale"]
-    }
-
-    def "Snowman" (
-        prepend references = @gingerbread/snowman/Snowman.usdc@
-        displayName = "Snowman"
-    )
-    {
-        quatf xformOp:orient = (0.8868096, 0, 0, -0.46213505)
-        float3 xformOp:scale = (0.99999994, 0.99999994, 0.9999998)
-        float3 xformOp:translate = (-0.03819806, -0.0054023676, 0)
-        uniform token[] xformOpOrder = ["xformOp:translate", "xformOp:orient", "xformOp:scale"]
-
-        # make an over here with /root/_materials/material/Principled_BSDF
-
-            over "_materials" {
-                over "material" {
-                    over "Principled_BSDF" {
-                        color3f inputs:diffuseColor = (1.0, 0.0, 0.0)
-                        float inputs:specular = 0.0
-                    }
-                }
-            }
-    }
-
-}

package/examples/public/HttpReferences.usda

@@ -1,44 +0,0 @@
-#usda 1.0
-(
-    customLayerData = {
-        string creator = "Mira Ly Herbst, Binh Minh Herbst, Felix Herbst, 2025"
-    }
-    defaultPrim = "Scenery"
-    metersPerUnit = 1
-    upAxis = "Z"
-)
-
-def Xform "Scenery"
-{
-    def "GingerBreadHouse" (
-        prepend references = @https://cloud-staging.needle.tools/-/assets/Z23hmXB22WdG2-22WdG2/house/GingerBreadHouse.usdc@
-        displayName = "Gingerbread House"
-    )
-    {
-        quatf xformOp:orient = (0.5092794, 0, 0, -0.8606013)
-        float3 xformOp:scale = (1, 0.99999994, 0.9999998)
-        float3 xformOp:translate = (0.04039519, -0.0057177544, 0)
-        uniform token[] xformOpOrder = ["xformOp:translate", "xformOp:orient", "xformOp:scale"]
-    }
-
-    def "Snowman" (
-        prepend references = @https://cloud-staging.needle.tools/-/assets/Z23hmXB22WdG2-22WdG2/snowman/Snowman.usdc@
-        displayName = "Snowman"
-    )
-    {
-        quatf xformOp:orient = (0.8868096, 0, 0, -0.46213505)
-        float3 xformOp:scale = (0.99999994, 0.99999994, 0.9999998)
-        float3 xformOp:translate = (-0.03819806, -0.0054023676, 0)
-        uniform token[] xformOpOrder = ["xformOp:translate", "xformOp:orient", "xformOp:scale"]
-
-        # make an over here with /root/_materials/material/Principled_BSDF
-            over "_materials" {
-                over "material" {
-                    over "Principled_BSDF" {
-                        color3f inputs:diffuseColor = (1.0, 0.0, 0.0)
-                        float inputs:specular = 0.0
-                    }
-                }
-            }
-    }
-}

package/examples/public/gingerbread/GingerbreadHouse.usda

@@ -1,35 +0,0 @@
-#usda 1.0
-(
-    customLayerData = {
-        string creator = "Mira Ly Herbst, Binh Minh Herbst, Felix Herbst, 2025"
-    }
-    defaultPrim = "Scenery"
-    metersPerUnit = 1
-    upAxis = "Z"
-)
-
-def Xform "Scenery"
-{
-    def "GingerBreadHouse" (
-        prepend references = @house/GingerBreadHouse.usdc@
-        displayName = "Gingerbread House"
-    )
-    {
-        quatf xformOp:orient = (0.5092794, 0, 0, -0.8606013)
-        float3 xformOp:scale = (1, 0.99999994, 0.9999998)
-        float3 xformOp:translate = (0.04039519, -0.0057177544, 0)
-        uniform token[] xformOpOrder = ["xformOp:translate", "xformOp:orient", "xformOp:scale"]
-    }
-
-    def "Snowman" (
-        prepend references = @snowman/Snowman.usdc@
-        displayName = "Snowman"
-    )
-    {
-        quatf xformOp:orient = (0.8868096, 0, 0, -0.46213505)
-        float3 xformOp:scale = (0.99999994, 0.99999994, 0.9999998)
-        float3 xformOp:translate = (-0.03819806, -0.0054023676, 0)
-        uniform token[] xformOpOrder = ["xformOp:translate", "xformOp:orient", "xformOp:scale"]
-    }
-}
-

package/examples/public/vite.svg

@@ -1 +0,0 @@
-<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="31.88" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 257"><defs><linearGradient id="IconifyId1813088fe1fbc01fb466" x1="-.828%" x2="57.636%" y1="7.652%" y2="78.411%"><stop offset="0%" stop-color="#41D1FF"></stop><stop offset="100%" stop-color="#BD34FE"></stop></linearGradient><linearGradient id="IconifyId1813088fe1fbc01fb467" x1="43.376%" x2="50.316%" y1="2.242%" y2="89.03%"><stop offset="0%" stop-color="#FFEA83"></stop><stop offset="8.333%" stop-color="#FFDD35"></stop><stop offset="100%" stop-color="#FFA800"></stop></linearGradient></defs><path fill="url(#IconifyId1813088fe1fbc01fb466)" d="M255.153 37.938L134.897 252.976c-2.483 4.44-8.862 4.466-11.382.048L.875 37.958c-2.746-4.814 1.371-10.646 6.827-9.67l120.385 21.517a6.537 6.537 0 0 0 2.322-.004l117.867-21.483c5.438-.991 9.574 4.796 6.877 9.62Z"></path><path fill="url(#IconifyId1813088fe1fbc01fb467)" d="M185.432.063L96.44 17.501a3.268 3.268 0 0 0-2.634 3.014l-5.474 92.456a3.268 3.268 0 0 0 3.997 3.378l24.777-5.718c2.318-.535 4.413 1.507 3.936 3.838l-7.361 36.047c-.495 2.426 1.782 4.5 4.151 3.78l15.304-4.649c2.372-.72 4.652 1.36 4.15 3.788l-11.698 56.621c-.732 3.542 3.979 5.473 5.943 2.437l1.313-2.028l72.516-144.72c1.215-2.423-.88-5.186-3.54-4.672l-25.505 4.922c-2.396.462-4.435-1.77-3.759-4.114l16.646-57.705c.677-2.35-1.37-4.583-3.769-4.113Z"></path></svg>

package/examples/src/fileHandling.ts

@@ -1,256 +0,0 @@
-document.addEventListener("dragover", function (ev) {
-	ev.preventDefault();
-});
-
-document.addEventListener("drop", function (ev) {
-	ev.preventDefault();
-
-    if (ev.dataTransfer?.items)
-    {
-        /** @type {FileSystemEntry[]} */
-        const allEntries = [];
-
-        let haveGetAsFileSystemHandle = false;
-        let haveGetAsEntry = false;
-        if (ev.dataTransfer.items.length > 0) {
-          haveGetAsEntry = ("getAsEntry" in ev.dataTransfer.items[0]) || ("webkitGetAsEntry" in ev.dataTransfer.items[0]);
-          haveGetAsFileSystemHandle = ("getAsFileSystemHandle" in ev.dataTransfer.items[0]);
-        }
-
-        /*
-        async function* getFilesRecursively(entry) {
-          if (entry.kind === "file") {
-            const file = await entry.getFile();
-            if (file !== null) {
-              file.relativePath = getRelativePath(entry);
-              yield file;
-            }
-          } else if (entry.kind === "directory") {
-            for await (const handle of entry.values()) {
-              yield* getFilesRecursively(handle);
-            }
-          }
-        }
-
-        if (haveGetAsFileSystemHandle) {
-          for (var i = 0; i < ev.dataTransfer.items.length; i++)
-          {
-              let item = ev.dataTransfer.items[i];
-              let handle = item.getAsFileSystemHandle();
-              allEntries.push(handle);
-          }
-          handleFilesystemEntries(allEntries);
-          return;
-        }
-        */
-
-        if (haveGetAsEntry) {
-          for (var i = 0; i < ev.dataTransfer.items.length; i++)
-          {
-              let item = ev.dataTransfer.items[i];
-              /** @type {FileSystemEntry} */
-              let entry = ("getAsEntry" in item) ? item.getAsEntry() : item.webkitGetAsEntry();
-              allEntries.push(entry);
-          }
-          handleFilesystemEntries(allEntries);
-          return;
-        }
-
-        for (var i = 0; i < ev.dataTransfer.items.length; i++)
-        {
-          let item = ev.dataTransfer.items[i];
-          
-          // API when there's no "getAsEntry" support
-          console.log(item.kind, item, entry);
-          if (item.kind === 'file')
-          {
-              var file = item.getAsFile();
-              testAndLoadFile(file);
-          }
-          // could also be a directory
-          else if (item.kind === 'directory')
-          {
-              var dirReader = item.createReader();
-              dirReader.readEntries(function(entries) {
-                  for (var i = 0; i < entries.length; i++) {
-                      console.log(entries[i].name);
-                      var entry = entries[i];
-                      if (entry.isFile) {
-                          entry.file(function(file) {
-                              testAndLoadFile(file);
-                          });
-                      }
-                  }
-              });
-          }
-        }
-    } else {
-        for (var i = 0; i < ev.dataTransfer.files.length; i++) {
-            let file = ev.dataTransfer.files[i];
-            testAndLoadFile(file);
-        }
-    }
-});
-
-/**
- * @param {FileSystemEntry[]} entries
- */
-async function handleFilesystemEntries(entries) {
-    /** @type {FileSystemEntry[]} */
-    const allFiles = [];
-    const fileIgnoreList = [
-      '.gitignore',
-      'README.md',
-      '.DS_Store',
-    ]
-    const dirIgnoreList = [
-      '.git',
-      'node_modules',
-    ]
-    const debugFileHandling = false;
-  
-    for (let entry of entries) {
-      if (debugFileHandling) console.log("file entry", entry)
-      if (entry.isFile) {
-        if (debugFileHandling) console.log("single file", entry);
-        if (fileIgnoreList.includes(entry.name)) {
-          continue;
-        }
-        allFiles.push(entry);
-      }
-      else if (entry.isDirectory) {
-        if (dirIgnoreList.includes(entry.name)) {
-          continue;
-        }
-        const files = await readDirectory(entry);
-        if (debugFileHandling) console.log("all files", files);
-        for (const file of files) {
-          if (fileIgnoreList.includes(file.name)) {
-            continue;
-          }
-          allFiles.push(file);
-        }
-      }
-    }
-  
-    // determine which of these is likely the root file
-    let rootFileCandidates = [];
-    let usdaCandidates = [];
-    
-    // sort so shorter paths come first
-    allFiles.sort((a, b) => {
-      const diff = a.fullPath.split('/').length - b.fullPath.split('/').length;
-      if (diff !== 0) return diff;
-      return a.fullPath.localeCompare(b.fullPath);
-    });
-  
-    // console.log("path candidates", allFiles);
-  
-    for (const file of allFiles) {
-      let ext = file.name.split('.').pop();
-      if(ext == 'usd' || ext == 'usdz' || ext == 'usda' || ext == 'usdc') {
-        rootFileCandidates.push(file);
-      }
-      if(ext == 'usda') {
-        usdaCandidates.push(file);
-      }
-    }
-  
-    let rootFile = undefined;
-  
-    // if there's multiple, use the first usda
-    if (rootFileCandidates.length > 1) {
-      if (usdaCandidates.length > 0) {
-        rootFile = usdaCandidates[0];
-      }
-      else {
-        rootFile = rootFileCandidates[0];
-      }
-    }
-    else {
-      // find the first usda file
-      for (const file of allFiles) {
-        let ext = file.name.split('.').pop();
-        if(ext == 'usda' || ext == 'usdc' || ext == 'usdz' || ext == 'usd') {
-          rootFile = file;
-          break;
-        }
-      }
-    }
-  
-    if (!rootFile && allFiles.length > 0) {
-      // use first file
-      rootFile = allFiles[0];
-    }
-  
-    // TODO if there are still multiple candidates we should ask the user which one to use
-    console.log("Assuming this is the root file: " + rootFile?.name); // + ". Total: " + allFiles.length, allFiles.map(f => f.fullPath).join('\n'));
-  
-  
-    async function getFile(fileEntry) {
-      try {
-        return new Promise((resolve, reject) => fileEntry.file(resolve, reject));
-      } catch (err) {
-        console.log(err);
-      }
-    }
-  
-    console.log("All files", allFiles);
-
-    allDroppedFiles = allFiles;
-  
-    return;
-  }
-
-  /**
- * @param {FileSystemDirectoryEntry} directory
- */
-async function readDirectory(directory) {
-    let entries = [];
-  
-    let getAllDirectoryEntries = async (dirReader) => {
-      let entries = [];
-      let readEntries = async () => {
-        let result = await new Promise((resolve, reject) => dirReader.readEntries(resolve, reject));
-        if (result.length === 0)
-          return entries;
-        else
-          return entries.concat(result, await readEntries());
-      }
-      return await readEntries();
-    }
-  
-    /**
-     * @param {FileSystemDirectoryReader} dirReader
-     * @param {FileSystemDirectoryEntry} directory
-     * @returns {Promise<number>}
-     */
-    let getEntries = async (directory) => {
-      let dirReader = directory.createReader();
-      await new Promise(async (resolve, reject) => {
-        // Call the reader.readEntries() until no more results are returned.
-  
-          const results = await getAllDirectoryEntries(dirReader);
-  
-          if (results.length) {
-            // entries = entries.concat(results);
-            for (let entry of results) {
-              if (entry.isDirectory) {
-                const foundFiles = await getEntries(entry);
-                if (foundFiles === 100)
-                  console.warn("Found more than 100 files in directory", entry);
-              }
-              else {
-                entries.push(entry);
-              }
-            }
-          }
-          resolve(results.length);
-      });
-    };
-  
-    await getEntries(directory);
-    return entries;
-}
-
-export let allDroppedFiles: FileSystemFileEntry[] = [];

package/examples/src/main.ts

@@ -1,167 +0,0 @@
-
-import { getUsdModule, createThreeHydra, USD, createThreeHydraReturnType } from '@needle-tools/usd';
-import { loadEnvMap, run } from './three';
-import { Object3D, Scene, WebGLRenderer } from 'three';
-
-import { allDroppedFiles } from './fileHandling';
-
-let hydraDelegate: createThreeHydraReturnType | null;
-let scene: Scene;
-let usdContent: Object3D;
-let usd: USD;
-let app: { fitCamera: () => void };
-
-getUsdModule({
-  debug: true,
-  urlModifier: async (url: string) => {
-    // Resolve GitHub-specific URLs
-    // rewrite GitHub links in the form https://github.com/usd-wg/assets/blob/main/full_assets/ElephantWithMonochord/SoC-ElephantWithMonochord.usdc
-    // to the raw version https://raw.githubusercontent.com/usd-wg/assets/main/full_assets/ElephantWithMonochord/SoC-ElephantWithMonochord.usdc
-    if (url.startsWith("https://github.com")) {
-      url = url.replace("github.com", "raw.githubusercontent.com");
-      url = url.replace("/blob/", "/");
-    }
-
-    console.log(url);
-
-    // Check if we find this URL in the dropped files, if there are any
-    if (allDroppedFiles && allDroppedFiles.length > 0) {
-      const found = allDroppedFiles.find(f => f.fullPath == url);
-
-      if (found) {
-        console.log("found file, returning handle", url, found);
-        if ("file" in found) {
-          return await new Promise((resolve, reject) => found.file(resolve, reject));
-        }
-        else if ("getFile" in found) {
-          return await found.getFile();
-        }
-      }
-      else {
-        console.warn("File not found", url, allDroppedFiles);
-      }
-    }
-
-    // return "./gingerbread/house/" + url;
-    return url;
-  }
-}).then(async (USD: USD) => {
-
-  const testUrls = [
-    { label: "USDZ Cube", url: "/test.usdz" },
-    { label: "Gingerbread House USDC", url: "/gingerbread/house/GingerBreadHouse.usdc" },
-    { label: "Gingerbread House USDA", url: "/gingerbread/GingerbreadHouse.usda", },
-    { label: "USDA file with HTTPS references", url: "/HttpReferences.usda" },
-    { label: "Gingerbread House from Needle Cloud", url: "https://cloud-staging.needle.tools/-/assets/Z23hmXB22WdG2-22WdG2/file.usda" },
-    { label: "Gingerbread House Subasset from Needle Cloud", url: "https://cloud-staging.needle.tools/-/assets/Z23hmXB22WdG2-22WdG2/house/GingerBreadHouse.usdc" },
-    { label: "USD Kitchen from Needle Cloud", url: "https://cloud-staging.needle.tools/-/assets/Z23hmXBZCdB4p-ZCdB4p/file.usdz" },
-    { label: "Car with Variants", url: "https://github.com/usd-wg/assets/blob/main/full_assets/Vehicles/USD_Mini_Car_Kit/assets/vehicles/vehicleVariants.usda" },
-    { label: "Carbon Frame Bike USDZ", url: "https://github.com/usd-wg/assets/blob/jcowles/discoverability/full_assets/CarbonFrameBike/CarbonFrameBike.usdz" },
-    { label: "Carbon Frame Bike USDA", url: "https://github.com/usd-wg/assets/blob/jcowles/discoverability/full_assets/CarbonFrameBike/index.usda" },
-    { label: "McUsd USDA", url: "https://github.com/usd-wg/assets/blob/jcowles/discoverability/full_assets/McUsd/McUsd.usda" },
-    { label: "Teapot USD", url: "https://github.com/usd-wg/assets/blob/main/full_assets/Teapot/Teapot.usd" },
-  ];
-
-  const div = document.createElement("div");
-  div.className = "test-buttons";
-  
-  for (const url of testUrls) {
-    const button = document.createElement("button");
-    button.innerText = url.label;
-    button.onclick = () => loadFile(url.url);
-    div.appendChild(button);
-  }
-
-  document.body.appendChild(div);
-
-  const div2 = document.createElement("div");
-  div2.className = "options";
-  const frameButton = document.createElement("button");
-  frameButton.innerText = "Fit Camera";
-  frameButton.onclick = () => app.fitCamera();
-  div2.appendChild(frameButton);
-  div.appendChild(div2);
-
-  // const url = "test.usdz"; // local file
-  // const url = "/gingerbread/house/GingerBreadHouse.usdc";
-  // const url = "/gingerbread/GingerbreadHouse.usda";
-  const url = "/HttpReferences.usda";
-  // ... all the URLs
-  // --> put them all into the virtual file system
-  // --> load the first one (assume which one that actually is)
-
-  // const url = "https://cloud-staging.needle.tools/-/assets/Z23hmXB22WdG2-22WdG2/file.usda"; // remote file
-  // const url = "https://cloud-staging.needle.tools/-/assets/Z23hmXB22WdG2-22WdG2/house/GingerBreadHouse.usdc"; // remote file
-  
-  // using a file/buffer
-  /* 
-  const buffer = await fetch(url).then(response => response.arrayBuffer());
-  const file = new File([buffer], url, { type: "model/usd" });
-  file.path = url; // used to determine the directory structure
-  */
-
-  const renderer = new WebGLRenderer({ antialias: true, alpha: true });
-  const envmapUrl = "https://dl.polyhaven.org/file/ph-assets/HDRIs/exr/1k/studio_small_09_1k.exr";
-  const envmap = await loadEnvMap(envmapUrl, renderer);
-
-  scene = new Scene();
-  scene.environment = envmap;
-  scene.background = envmap;
-  scene.backgroundBlurriness = 0.8;
-  scene.backgroundIntensity = 0.2;
-
-  usd = USD;
-
-  /*
-    usdContent = new Object3D();
-    scene.add(usdContent);
-    hydraDelegate = await createThreeHydra({
-      debug: true,
-      USD,
-      url: url,
-      // files: [file],
-      // @ts-ignore
-      scene: usdContent,
-    })
-    */
-
-  // loadFile(url);
-
-  app = run({
-    renderer,
-    scene: scene,
-    onRender: (dt) => {
-      hydraDelegate?.update(dt);
-    }
-  });
-})
-
-async function loadFile(url: string) {
-
-  if (hydraDelegate)
-    hydraDelegate.dispose();
-  hydraDelegate = null;
-
-  if (usdContent) {
-    scene.remove(usdContent);
-    // TODO dispose as well
-  }
-
-  usdContent = new Object3D();
-  scene.add(usdContent);
-
-  const delegate = await createThreeHydra({
-    debug: true,
-    USD: usd,
-    url: url,
-    // @ts-ignore
-    scene: usdContent,
-  })
-
-  hydraDelegate = delegate;
-
-  console.log("Scene content", usdContent);
-  app.fitCamera();
-}
-
-window.loadFile = loadFile;