@viji-dev/core 0.20.0 → 0.21.0

package/README.md

@@ -246,6 +246,11 @@ await core.setParameters({
   'enabled': false
 });
 
+// Image and 3D model parameters take files, URLs or null
+await core.setParameter('texture', imageFile);           // File / Blob / URL; host value: ImageBitmap | null
+await core.setParameter('statue', modelFile);            // File / Blob / ArrayBuffer / { bytes, format } / URL
+                                                         // host value: ModelDescriptor ({ format }) | null, never the bytes
+
 // Get current parameter values
 const values = core.getParameterValues();
 const color = core.getParameter('color');
@@ -574,6 +579,17 @@ const resetPosition = viji.button({
   group: 'interaction',
   category: 'interaction'
 });
+
+// Binary assets: the host supplies the file, the scene consumes it
+const texture = viji.image(null, { label: 'Texture' });   // value: ImageBitmap | null
+
+const statue = viji.model(null, {                           // value: { bytes, url, format } | null
+  label: 'Statue',
+  formats: ['glb', 'obj']  // required: only what your loader parses; the host filters its picker by it
+});
+// Core never parses the model: pass statue.value.bytes to a loader's parse() or
+// statue.value.url to its load() (three.js loaders, p5 loadModel()). Read the value
+// where you load it; replacing the model revokes the old url.
 ```
 
 #### Parameter Usage in Render Loop
@@ -1158,6 +1174,7 @@ function render(viji, p5) {
 - ❌ p5.sound (use `viji.audio` instead)
 - ❌ P5.js events (use `viji.mouse`/`keyboard`/`touches`/`pointer` instead)
 - ❌ Direct image loading (use Viji image parameters instead)
+- ❌ `preload()` and file loaders, except `loadModel(statue.value.url, true, ok, err, '.' + statue.value.format)` with a `viji.model()` parameter
 
 ### Audio Reactive P5.js Example