RubyGems - three-rb - Versions diffs - 0.1.0 - Mend

three-rb 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (145) hide show

checksums.yaml +7 -0
data/CHANGELOG.md +19 -0
data/LICENSE +21 -0
data/README.md +153 -0
data/docs/browser-runtime.md +153 -0
data/docs/implementation-plan.md +874 -0
data/docs/loaded-assets-design.md +400 -0
data/docs/next-work.md +107 -0
data/docs/publishing.md +64 -0
data/docs/release-readiness.md +83 -0
data/examples/browser/README.md +54 -0
data/examples/browser/assets/animated_triangle.gltf +123 -0
data/examples/browser/assets/checker.svg +11 -0
data/examples/browser/assets/compressed_triangle.gltf +74 -0
data/examples/browser/assets/studio.hdr +5 -0
data/examples/browser/assets/triangle.gltf +67 -0
data/examples/browser/composition/README.md +35 -0
data/examples/browser/composition/boot.mjs +6 -0
data/examples/browser/composition/index.html +136 -0
data/examples/browser/composition/main.rb +216 -0
data/examples/browser/composition/smoke_test.mjs +266 -0
data/examples/browser/cube/README.md +41 -0
data/examples/browser/cube/boot.mjs +6 -0
data/examples/browser/cube/index.html +142 -0
data/examples/browser/cube/main.rb +62 -0
data/examples/browser/cube/smoke_test.mjs +99 -0
data/examples/browser/cubemap/README.md +23 -0
data/examples/browser/cubemap/boot.mjs +6 -0
data/examples/browser/cubemap/index.html +142 -0
data/examples/browser/cubemap/main.rb +84 -0
data/examples/browser/cubemap/smoke_test.mjs +91 -0
data/examples/browser/gltf/README.md +23 -0
data/examples/browser/gltf/boot.mjs +6 -0
data/examples/browser/gltf/index.html +142 -0
data/examples/browser/gltf/main.rb +105 -0
data/examples/browser/gltf/smoke_test.mjs +162 -0
data/examples/browser/picking/README.md +33 -0
data/examples/browser/picking/boot.mjs +6 -0
data/examples/browser/picking/index.html +142 -0
data/examples/browser/picking/main.rb +113 -0
data/examples/browser/picking/smoke_test.mjs +78 -0
data/examples/browser/postprocessing/README.md +26 -0
data/examples/browser/postprocessing/boot.mjs +6 -0
data/examples/browser/postprocessing/index.html +142 -0
data/examples/browser/postprocessing/main.rb +117 -0
data/examples/browser/postprocessing/smoke_test.mjs +121 -0
data/examples/browser/primitives/README.md +33 -0
data/examples/browser/primitives/boot.mjs +6 -0
data/examples/browser/primitives/index.html +142 -0
data/examples/browser/primitives/main.rb +116 -0
data/examples/browser/primitives/smoke_test.mjs +113 -0
data/examples/browser/serialization/README.md +33 -0
data/examples/browser/serialization/boot.mjs +6 -0
data/examples/browser/serialization/index.html +142 -0
data/examples/browser/serialization/main.rb +97 -0
data/examples/browser/serialization/smoke_test.mjs +67 -0
data/examples/browser/shared/boot.mjs +79 -0
data/examples/browser/shared/smoke_test_helpers.mjs +151 -0
data/examples/browser/textures/README.md +35 -0
data/examples/browser/textures/boot.mjs +6 -0
data/examples/browser/textures/index.html +142 -0
data/examples/browser/textures/main.rb +142 -0
data/examples/browser/textures/smoke_test.mjs +189 -0
data/lib/three/animation/animation_action.rb +57 -0
data/lib/three/animation/animation_clip.rb +22 -0
data/lib/three/animation/animation_mixer.rb +43 -0
data/lib/three/backends/base.rb +87 -0
data/lib/three/backends/threejs/materialization.rb +143 -0
data/lib/three/backends/threejs/parameters.rb +97 -0
data/lib/three/backends/threejs/resource_management.rb +69 -0
data/lib/three/backends/threejs/ruby_wasm_adapter.rb +873 -0
data/lib/three/backends/threejs/synchronization.rb +224 -0
data/lib/three/backends/threejs.rb +365 -0
data/lib/three/cameras/camera.rb +39 -0
data/lib/three/cameras/orthographic_camera.rb +107 -0
data/lib/three/cameras/perspective_camera.rb +137 -0
data/lib/three/constants.rb +40 -0
data/lib/three/controls/orbit_controls.rb +118 -0
data/lib/three/core/buffer_attribute.rb +151 -0
data/lib/three/core/buffer_geometry.rb +181 -0
data/lib/three/core/clock.rb +58 -0
data/lib/three/core/event_dispatcher.rb +57 -0
data/lib/three/core/layers.rb +75 -0
data/lib/three/core/object3d.rb +331 -0
data/lib/three/core/raycaster.rb +73 -0
data/lib/three/dirty.rb +58 -0
data/lib/three/exporters/three_json_exporter.rb +187 -0
data/lib/three/geometries/box_geometry.rb +97 -0
data/lib/three/geometries/plane_geometry.rb +70 -0
data/lib/three/geometries/sphere_geometry.rb +107 -0
data/lib/three/lights/ambient_light.rb +12 -0
data/lib/three/lights/directional_light.rb +38 -0
data/lib/three/lights/hemisphere_light.rb +34 -0
data/lib/three/lights/light.rb +85 -0
data/lib/three/lights/point_light.rb +33 -0
data/lib/three/loaders/cube_texture_loader.rb +13 -0
data/lib/three/loaders/gltf_loader.rb +48 -0
data/lib/three/loaders/rgbe_loader.rb +15 -0
data/lib/three/loaders/texture_loader.rb +13 -0
data/lib/three/loaders/three_json_loader.rb +409 -0
data/lib/three/materials/line_basic_material.rb +65 -0
data/lib/three/materials/material.rb +158 -0
data/lib/three/materials/mesh_basic_material.rb +64 -0
data/lib/three/materials/mesh_lambert_material.rb +71 -0
data/lib/three/materials/mesh_matcap_material.rb +86 -0
data/lib/three/materials/mesh_normal_material.rb +42 -0
data/lib/three/materials/mesh_phong_material.rb +119 -0
data/lib/three/materials/mesh_physical_material.rb +155 -0
data/lib/three/materials/mesh_standard_material.rb +149 -0
data/lib/three/materials/mesh_toon_material.rb +98 -0
data/lib/three/materials/points_material.rb +74 -0
data/lib/three/materials/shadow_material.rb +45 -0
data/lib/three/materials/sprite_material.rb +75 -0
data/lib/three/math/color.rb +133 -0
data/lib/three/math/euler.rb +197 -0
data/lib/three/math/math_utils.rb +36 -0
data/lib/three/math/matrix3.rb +255 -0
data/lib/three/math/matrix4.rb +448 -0
data/lib/three/math/quaternion.rb +277 -0
data/lib/three/math/vector2.rb +95 -0
data/lib/three/math/vector3.rb +396 -0
data/lib/three/objects/external_object3d.rb +28 -0
data/lib/three/objects/group.rb +12 -0
data/lib/three/objects/instanced_mesh.rb +110 -0
data/lib/three/objects/line.rb +41 -0
data/lib/three/objects/mesh.rb +45 -0
data/lib/three/objects/points.rb +41 -0
data/lib/three/objects/sprite.rb +57 -0
data/lib/three/postprocessing/dot_screen_pass.rb +83 -0
data/lib/three/postprocessing/effect_composer.rb +56 -0
data/lib/three/postprocessing/output_pass.rb +40 -0
data/lib/three/postprocessing/render_pass.rb +42 -0
data/lib/three/postprocessing/unreal_bloom_pass.rb +56 -0
data/lib/three/renderers/renderer.rb +11 -0
data/lib/three/renderers/threejs_renderer.rb +85 -0
data/lib/three/scenes/scene.rb +29 -0
data/lib/three/textures/cube_texture.rb +72 -0
data/lib/three/textures/rgbe_texture.rb +45 -0
data/lib/three/textures/texture.rb +200 -0
data/lib/three/version.rb +5 -0
data/lib/three-rb.rb +3 -0
data/lib/three.rb +77 -0
data/package.json +30 -0
data/pnpm-lock.yaml +86 -0
metadata +216 -0

data/examples/browser/textures/README.md ADDED Viewed

@@ -0,0 +1,35 @@
+# Browser Textures Example
+This example renders Ruby-authored textured meshes through ruby.wasm and the JavaScript three.js renderer. It focuses on `TextureLoader`, `RGBELoader`, repeat/wrap/filter settings, `MeshPhysicalMaterial`, `MeshMatcapMaterial`, `MeshToonMaterial`, standard plus physical material texture maps, matcap and toon gradient texture assignment, and an HDR environment texture.
+Install browser dependencies and serve the repository root over HTTP:
+```sh
+pnpm install
+ruby -run -e httpd . -p 8000
+```
+Then open:
+```text
+http://localhost:8000/examples/browser/textures/
+```
+The repository root must be served, not only this directory, because `boot.mjs` loads browser packages from `node_modules/` and `main.rb` loads the library source from `lib/`.
+## Browser Smoke Test
+Install the optional Node dependency and browser binary:
+```sh
+pnpm install
+pnpm exec playwright install chromium
+```
+Run the browser smoke test:
+```sh
+pnpm test:browser:textures
+```
+The smoke test serves the repository root, waits for the Ruby scene to reach `Running`, samples the WebGL canvas for nonblank pixels, verifies the textured meshes, physical, matcap, and toon material parameters, RGBE environment mapping, and checks that repeat/wrap/filter settings reach the three.js texture.

data/examples/browser/textures/boot.mjs ADDED Viewed

@@ -0,0 +1,6 @@
+import { bootRubyExample } from "../shared/boot.mjs";
+await bootRubyExample({
+  main: "examples/browser/textures/main",
+  clearColor: 0x11161a
+});

data/examples/browser/textures/index.html ADDED Viewed

@@ -0,0 +1,142 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>three-rb textures</title>
+    <style>
+      :root {
+        color-scheme: dark;
+        font-family:
+          Inter, ui-sans-serif, system-ui, -apple-system, BlinkMacSystemFont,
+          "Segoe UI", sans-serif;
+        background: #11161a;
+        color: #eef3f7;
+      }
+      * {
+        box-sizing: border-box;
+      }
+      html,
+      body {
+        width: 100%;
+        height: 100%;
+        margin: 0;
+      }
+      body {
+        display: grid;
+        place-items: stretch;
+        overflow: hidden;
+      }
+      .viewport {
+        position: relative;
+        width: 100%;
+        height: 100%;
+        min-width: 320px;
+        min-height: 320px;
+        background:
+          linear-gradient(rgba(255, 255, 255, 0.035) 1px, transparent 1px),
+          linear-gradient(90deg, rgba(255, 255, 255, 0.035) 1px, transparent 1px),
+          linear-gradient(135deg, #11161a 0%, #18211d 54%, #121318 100%);
+        background-size: 34px 34px, 34px 34px, auto;
+      }
+      canvas {
+        display: block;
+        width: 100%;
+        height: 100%;
+      }
+      .hud {
+        position: absolute;
+        top: 16px;
+        left: 16px;
+        display: flex;
+        align-items: center;
+        gap: 8px;
+        max-width: calc(100% - 32px);
+        padding: 8px 10px;
+        border: 1px solid rgba(255, 255, 255, 0.14);
+        border-radius: 6px;
+        background: rgba(9, 13, 17, 0.72);
+        box-shadow: 0 12px 30px rgba(0, 0, 0, 0.24);
+        color: #dce7ef;
+        font-size: 13px;
+        line-height: 1.3;
+        backdrop-filter: blur(10px);
+      }
+      .status-dot {
+        width: 8px;
+        height: 8px;
+        flex: 0 0 auto;
+        border-radius: 999px;
+        background: #f2b84b;
+        box-shadow: 0 0 14px rgba(242, 184, 75, 0.72);
+      }
+      .status-dot[data-state="running"] {
+        background: #60d394;
+        box-shadow: 0 0 14px rgba(96, 211, 148, 0.72);
+      }
+      .status-dot[data-state="error"] {
+        background: #f15b5b;
+        box-shadow: 0 0 14px rgba(241, 91, 91, 0.72);
+      }
+    </style>
+    <script type="importmap">
+      {
+        "imports": {
+          "@bjorn3/browser_wasi_shim": "/node_modules/@bjorn3/browser_wasi_shim/dist/index.js",
+          "@ruby/wasm-wasi/browser": "/node_modules/@ruby/wasm-wasi/dist/esm/browser.js",
+          "three": "/node_modules/three/build/three.module.js",
+          "three/addons/": "/node_modules/three/examples/jsm/"
+        }
+      }
+    </script>
+    <script type="module">
+      const status = document.querySelector("#status");
+      const statusDot = document.querySelector("#status-dot");
+      globalThis.__threeRbSetStatus = (message, state) => {
+        if (status) status.textContent = message;
+        if (statusDot) statusDot.dataset.state = state;
+      };
+      globalThis.__threeRbBootFailed = (message) => {
+        globalThis.__threeRbSetStatus(message, "error");
+      };
+      globalThis.addEventListener("error", (event) => {
+        globalThis.__threeRbBootFailed(event.message || "Browser error");
+      });
+      globalThis.addEventListener("unhandledrejection", (event) => {
+        const reason = event.reason;
+        globalThis.__threeRbBootFailed(reason && reason.message ? reason.message : "Ruby boot failed");
+      });
+      globalThis.setTimeout(() => {
+        if (status && status.textContent === "Loading ruby.wasm") {
+          status.textContent = "Still loading ruby.wasm";
+        }
+      }, 15000);
+      globalThis.__threeRbSetStatus("Loading ruby.wasm", "loading");
+    </script>
+    <script type="module" src="./boot.mjs"></script>
+  </head>
+  <body>
+    <main class="viewport" id="viewport">
+      <canvas id="scene" data-testid="scene-canvas"></canvas>
+      <div class="hud" aria-live="polite">
+        <span class="status-dot" id="status-dot"></span>
+        <span id="status" data-testid="status">Loading ruby.wasm</span>
+      </div>
+    </main>
+  </body>
+</html>

data/examples/browser/textures/main.rb ADDED Viewed

@@ -0,0 +1,142 @@
+# frozen_string_literal: true
+require "js"
+begin
+  JS.global[:__threeReady].await
+  require_relative "../../../lib/three"
+  document = JS.global[:document]
+  window = JS.global[:window]
+  viewport = document.call(:querySelector, "#viewport")
+  status = document.call(:querySelector, "#status")
+  status_dot = document.call(:querySelector, "#status-dot")
+  status[:textContent] = "Starting Ruby scene"
+  scene = Three::Scene.new
+  camera = Three::OrthographicCamera.new(-2.5, 2.5, 1.6, -1.6, near: 0.1, far: 100)
+  camera.position.z = 5
+  environment_texture = Three::Loaders::RGBELoader.new.load("/examples/browser/assets/studio.hdr")
+  scene.environment = environment_texture
+  scene.add(Three::AmbientLight.new(0xffffff, 0.45))
+  key_light = Three::DirectionalLight.new(0xffffff, 1.1)
+  key_light.position.set(2.5, 3.0, 4.0)
+  scene.add(key_light)
+  texture = Three::Loaders::TextureLoader.new.load("/examples/browser/assets/checker.svg")
+  texture.wrap_s = Three::RepeatWrapping
+  texture.wrap_t = Three::RepeatWrapping
+  texture.mag_filter = Three::NearestFilter
+  texture.min_filter = Three::NearestMipmapNearestFilter
+  texture.offset.set(0.125, 0.25)
+  texture.repeat.set(4, 3)
+  texture.center.set(0.5, 0.5)
+  texture.rotation = 0.35
+  material = Three::MeshPhysicalMaterial.new(
+    color: 0xffffff,
+    roughness: 0.42,
+    metalness: 0.08,
+    anisotropy: 0.25,
+    anisotropy_rotation: 0.15,
+    clearcoat: 0.65,
+    clearcoat_roughness: 0.18,
+    ior: 1.45,
+    specular_intensity: 0.75,
+    specular_color: 0xe8f1ff,
+    map: texture,
+    roughness_map: texture,
+    metalness_map: texture,
+    anisotropy_map: texture,
+    clearcoat_map: texture
+  )
+  mesh = Three::Mesh.new(Three::BoxGeometry.new(1.8, 1.15, 0.32), material)
+  mesh.position.x = -0.75
+  mesh.rotation.x = -0.25
+  mesh.rotation.y = 0.38
+  scene.add(mesh)
+  matcap_material = Three::MeshMatcapMaterial.new(color: 0xffffff, matcap: texture, map: texture, flat_shading: true)
+  matcap_mesh = Three::Mesh.new(
+    Three::SphereGeometry.new(0.52, width_segments: 32, height_segments: 16),
+    matcap_material
+  )
+  matcap_mesh.position.x = 1.35
+  matcap_mesh.rotation.y = -0.28
+  scene.add(matcap_mesh)
+  toon_material = Three::MeshToonMaterial.new(
+    color: 0xf6c85f,
+    emissive: 0x101820,
+    map: texture,
+    gradient_map: texture,
+    flat_shading: true
+  )
+  toon_mesh = Three::Mesh.new(
+    Three::SphereGeometry.new(0.42, width_segments: 24, height_segments: 12),
+    toon_material
+  )
+  toon_mesh.position.set(0.32, -0.9, 0.18)
+  scene.add(toon_mesh)
+  renderer = Three::Renderers::ThreeJSRenderer.new(
+    canvas: "#scene",
+    antialias: true,
+    alpha: false,
+    preserveDrawingBuffer: true
+  )
+  renderer.set_clear_color(0x11161a, 1)
+  resize = proc do
+    width = [viewport[:clientWidth].to_i, 1].max
+    height = [viewport[:clientHeight].to_i, 1].max
+    view_height = 3.4
+    view_width = view_height * width.to_f / height
+    camera.left = -view_width / 2
+    camera.right = view_width / 2
+    camera.top = view_height / 2
+    camera.bottom = -view_height / 2
+    camera.update_projection_matrix
+    renderer.set_size(width, height)
+  end
+  resize.call
+  window.call(:addEventListener, "resize", resize)
+  renderer.render(scene, camera)
+  JS.global[:__threeRbRenderer] = renderer.handle
+  JS.global[:__threeRbScene] = renderer.backend.materialize(scene)
+  JS.global[:__threeRbCamera] = renderer.backend.materialize(camera)
+  JS.global[:__threeRbTexturedMesh] = renderer.backend.materialize(mesh)
+  JS.global[:__threeRbTextureMaterial] = renderer.backend.materialize(material)
+  JS.global[:__threeRbMatcapMesh] = renderer.backend.materialize(matcap_mesh)
+  JS.global[:__threeRbMatcapMaterial] = renderer.backend.materialize(matcap_material)
+  JS.global[:__threeRbToonMesh] = renderer.backend.materialize(toon_mesh)
+  JS.global[:__threeRbToonMaterial] = renderer.backend.materialize(toon_material)
+  JS.global[:__threeRbTextureExampleTexture] = renderer.backend.materialize(texture)
+  JS.global[:__threeRbTextureExampleEnvironment] = renderer.backend.materialize(environment_texture)
+  JS.global[:__threeRbTextureExampleFrame] = 0
+  frame = 0
+  renderer.animation_loop do
+    frame += 1
+    mesh.rotation.x -= 0.006
+    mesh.rotation.y += 0.011
+    matcap_mesh.rotation.x += 0.005
+    matcap_mesh.rotation.y -= 0.009
+    toon_mesh.rotation.y += 0.012
+    JS.global[:__threeRbTextureExampleFrame] = frame
+    renderer.render(scene, camera)
+  end
+  status[:textContent] = "Running"
+  status_dot[:dataset][:state] = "running"
+rescue StandardError => error
+  JS.global.call(:__threeRbBootFailed, error.message) if JS.global[:__threeRbBootFailed]
+  raise
+end

data/examples/browser/textures/smoke_test.mjs ADDED Viewed

@@ -0,0 +1,189 @@
+import {
+  assertNoDiagnostics,
+  assertNonBlankCanvas,
+  createDiagnostics,
+  createSmokePage,
+  loadPlaywright,
+  sampleCanvas,
+  startServer,
+  waitForRunning
+} from "../shared/smoke_test_helpers.mjs";
+async function main() {
+  const { chromium } = await loadPlaywright();
+  const server = await startServer();
+  const browser = await chromium.launch({ headless: process.env.HEADLESS !== "0" });
+  const diagnostics = createDiagnostics();
+  try {
+    const page = await createSmokePage(browser, diagnostics);
+    await page.goto(`${server.url}/examples/browser/textures/`, { waitUntil: "load" });
+    await waitForRunning(page, diagnostics);
+    await page.waitForFunction(
+      () => globalThis.__threeRbTextureMaterial?.map?.source?.data?.complete === true &&
+        globalThis.__threeRbTextureExampleEnvironment?.isDataTexture === true,
+      null,
+      { timeout: 10_000 }
+    );
+    await page.waitForTimeout(1_000);
+    assertNonBlankCanvas(await sampleCanvas(page));
+    const scene = await page.evaluate(() => ({
+      frame: globalThis.__threeRbTextureExampleFrame,
+      renderInfo: globalThis.__threeRbRenderer?.info?.render,
+      cameraType: globalThis.__threeRbCamera?.type,
+      sceneChildren: globalThis.__threeRbScene?.children?.length,
+      meshType: globalThis.__threeRbTexturedMesh?.type,
+      geometryType: globalThis.__threeRbTexturedMesh?.geometry?.type,
+      materialType: globalThis.__threeRbTexturedMesh?.material?.type,
+      materialMapType: globalThis.__threeRbTexturedMesh?.material?.map?.isTexture,
+      matcapMeshType: globalThis.__threeRbMatcapMesh?.type,
+      matcapGeometryType: globalThis.__threeRbMatcapMesh?.geometry?.type,
+      matcapMaterialType: globalThis.__threeRbMatcapMesh?.material?.type,
+      matcapMaterialColor: globalThis.__threeRbMatcapMaterial?.color?.getHex?.(),
+      matcapMaterialFlatShading: globalThis.__threeRbMatcapMaterial?.flatShading,
+      matcapTextureType: globalThis.__threeRbMatcapMaterial?.matcap?.isTexture,
+      matcapMapType: globalThis.__threeRbMatcapMaterial?.map?.isTexture,
+      matcapTextureSame: globalThis.__threeRbMatcapMaterial?.matcap === globalThis.__threeRbTextureExampleTexture,
+      matcapMapSame: globalThis.__threeRbMatcapMaterial?.map === globalThis.__threeRbTextureExampleTexture,
+      toonMeshType: globalThis.__threeRbToonMesh?.type,
+      toonGeometryType: globalThis.__threeRbToonMesh?.geometry?.type,
+      toonMaterialType: globalThis.__threeRbToonMesh?.material?.type,
+      toonMaterialColor: globalThis.__threeRbToonMaterial?.color?.getHex?.(),
+      toonMaterialEmissive: globalThis.__threeRbToonMaterial?.emissive?.getHex?.(),
+      toonMaterialFlatShading: globalThis.__threeRbToonMaterial?.flatShading,
+      toonGradientMapType: globalThis.__threeRbToonMaterial?.gradientMap?.isTexture,
+      toonMapType: globalThis.__threeRbToonMaterial?.map?.isTexture,
+      toonGradientMapSame: globalThis.__threeRbToonMaterial?.gradientMap === globalThis.__threeRbTextureExampleTexture,
+      toonMapSame: globalThis.__threeRbToonMaterial?.map === globalThis.__threeRbTextureExampleTexture,
+      materialRoughnessMapType: globalThis.__threeRbTextureMaterial?.roughnessMap?.isTexture,
+      materialMetalnessMapType: globalThis.__threeRbTextureMaterial?.metalnessMap?.isTexture,
+      materialAnisotropyMapType: globalThis.__threeRbTextureMaterial?.anisotropyMap?.isTexture,
+      materialClearcoatMapType: globalThis.__threeRbTextureMaterial?.clearcoatMap?.isTexture,
+      materialRoughness: globalThis.__threeRbTextureMaterial?.roughness,
+      materialMetalness: globalThis.__threeRbTextureMaterial?.metalness,
+      materialAnisotropy: globalThis.__threeRbTextureMaterial?.anisotropy,
+      materialAnisotropyRotation: globalThis.__threeRbTextureMaterial?.anisotropyRotation,
+      materialClearcoat: globalThis.__threeRbTextureMaterial?.clearcoat,
+      materialClearcoatRoughness: globalThis.__threeRbTextureMaterial?.clearcoatRoughness,
+      materialIor: globalThis.__threeRbTextureMaterial?.ior,
+      materialSpecularIntensity: globalThis.__threeRbTextureMaterial?.specularIntensity,
+      materialSpecularColor: globalThis.__threeRbTextureMaterial?.specularColor?.getHex?.(),
+      textureType: globalThis.__threeRbTextureExampleTexture?.isTexture,
+      textureWidth: globalThis.__threeRbTextureExampleTexture?.source?.data?.naturalWidth,
+      textureWrapS: globalThis.__threeRbTextureExampleTexture?.wrapS,
+      textureWrapT: globalThis.__threeRbTextureExampleTexture?.wrapT,
+      textureMagFilter: globalThis.__threeRbTextureExampleTexture?.magFilter,
+      textureMinFilter: globalThis.__threeRbTextureExampleTexture?.minFilter,
+      textureOffset: globalThis.__threeRbTextureExampleTexture?.offset?.toArray?.(),
+      textureRepeat: globalThis.__threeRbTextureExampleTexture?.repeat?.toArray?.(),
+      textureCenter: globalThis.__threeRbTextureExampleTexture?.center?.toArray?.(),
+      textureRotation: globalThis.__threeRbTextureExampleTexture?.rotation,
+      textureMatrixAutoUpdate: globalThis.__threeRbTextureExampleTexture?.matrixAutoUpdate,
+      environmentType: globalThis.__threeRbTextureExampleEnvironment?.isDataTexture,
+      environmentMapping: globalThis.__threeRbTextureExampleEnvironment?.mapping,
+      environmentColorSpace: globalThis.__threeRbTextureExampleEnvironment?.colorSpace,
+      environmentMagFilter: globalThis.__threeRbTextureExampleEnvironment?.magFilter,
+      environmentMinFilter: globalThis.__threeRbTextureExampleEnvironment?.minFilter,
+      sceneEnvironmentSame: globalThis.__threeRbScene?.environment === globalThis.__threeRbTextureExampleEnvironment
+    }));
+    if (scene.cameraType !== "OrthographicCamera") {
+      throw new Error(`expected an OrthographicCamera texture view: ${JSON.stringify(scene)}`);
+    }
+    if (scene.meshType !== "Mesh" || scene.geometryType !== "BoxGeometry") {
+      throw new Error(`expected a textured box mesh: ${JSON.stringify(scene)}`);
+    }
+    if (scene.materialType !== "MeshPhysicalMaterial" || scene.materialMapType !== true) {
+      throw new Error(`expected MeshPhysicalMaterial with a texture map: ${JSON.stringify(scene)}`);
+    }
+    if (scene.matcapMeshType !== "Mesh" || scene.matcapGeometryType !== "SphereGeometry") {
+      throw new Error(`expected a matcap sphere mesh: ${JSON.stringify(scene)}`);
+    }
+    if (
+      scene.matcapMaterialType !== "MeshMatcapMaterial" ||
+      scene.matcapMaterialColor !== 0xffffff ||
+      scene.matcapMaterialFlatShading !== true ||
+      scene.matcapTextureType !== true ||
+      scene.matcapMapType !== true ||
+      scene.matcapTextureSame !== true ||
+      scene.matcapMapSame !== true
+    ) {
+      throw new Error(`expected MeshMatcapMaterial with shared matcap/map texture: ${JSON.stringify(scene)}`);
+    }
+    if (scene.toonMeshType !== "Mesh" || scene.toonGeometryType !== "SphereGeometry") {
+      throw new Error(`expected a toon sphere mesh: ${JSON.stringify(scene)}`);
+    }
+    if (
+      scene.toonMaterialType !== "MeshToonMaterial" ||
+      scene.toonMaterialColor !== 0xf6c85f ||
+      scene.toonMaterialEmissive !== 0x101820 ||
+      scene.toonMaterialFlatShading !== true ||
+      scene.toonGradientMapType !== true ||
+      scene.toonMapType !== true ||
+      scene.toonGradientMapSame !== true ||
+      scene.toonMapSame !== true
+    ) {
+      throw new Error(`expected MeshToonMaterial with shared map/gradient texture: ${JSON.stringify(scene)}`);
+    }
+    if (scene.materialRoughnessMapType !== true || scene.materialMetalnessMapType !== true || scene.materialAnisotropyMapType !== true || scene.materialClearcoatMapType !== true) {
+      throw new Error(`expected MeshPhysicalMaterial with PBR and physical texture maps: ${JSON.stringify(scene)}`);
+    }
+    if (scene.materialRoughness !== 0.42 || scene.materialMetalness !== 0.08) {
+      throw new Error(`expected configured PBR material values: ${JSON.stringify(scene)}`);
+    }
+    if (scene.materialAnisotropy !== 0.25 || scene.materialAnisotropyRotation !== 0.15) {
+      throw new Error(`expected configured anisotropy material values: ${JSON.stringify(scene)}`);
+    }
+    if (scene.materialClearcoat !== 0.65 || scene.materialClearcoatRoughness !== 0.18 || scene.materialIor !== 1.45) {
+      throw new Error(`expected configured physical material values: ${JSON.stringify(scene)}`);
+    }
+    if (scene.materialSpecularIntensity !== 0.75 || scene.materialSpecularColor !== 0xe8f1ff) {
+      throw new Error(`expected configured physical specular values: ${JSON.stringify(scene)}`);
+    }
+    if (scene.textureType !== true || scene.textureWidth <= 0) {
+      throw new Error(`expected a loaded texture: ${JSON.stringify(scene)}`);
+    }
+    if (scene.textureWrapS !== 1000 || scene.textureWrapT !== 1000 || scene.textureMagFilter !== 1003 || scene.textureMinFilter !== 1004) {
+      throw new Error(`expected configured texture wrapping and filters: ${JSON.stringify(scene)}`);
+    }
+    if (!Array.isArray(scene.textureRepeat) || scene.textureRepeat[0] !== 4 || scene.textureRepeat[1] !== 3) {
+      throw new Error(`expected configured texture repeat: ${JSON.stringify(scene)}`);
+    }
+    if (!Array.isArray(scene.textureOffset) || scene.textureOffset[0] !== 0.125 || scene.textureOffset[1] !== 0.25) {
+      throw new Error(`expected configured texture offset: ${JSON.stringify(scene)}`);
+    }
+    if (!Array.isArray(scene.textureCenter) || scene.textureCenter[0] !== 0.5 || scene.textureCenter[1] !== 0.5) {
+      throw new Error(`expected configured texture center: ${JSON.stringify(scene)}`);
+    }
+    if (Math.abs(scene.textureRotation - 0.35) > 1e-12 || scene.textureMatrixAutoUpdate !== true) {
+      throw new Error(`expected configured texture transform state: ${JSON.stringify(scene)}`);
+    }
+    if (scene.environmentType !== true || scene.environmentMapping !== 303 || scene.environmentColorSpace !== "srgb-linear") {
+      throw new Error(`expected an RGBE environment texture with equirectangular mapping: ${JSON.stringify(scene)}`);
+    }
+    if (scene.environmentMagFilter !== 1006 || scene.environmentMinFilter !== 1006 || scene.sceneEnvironmentSame !== true) {
+      throw new Error(`expected configured RGBE environment texture filters and scene binding: ${JSON.stringify(scene)}`);
+    }
+    if (!scene.renderInfo || scene.renderInfo.triangles < 12) {
+      throw new Error(`renderer did not draw the textured cube triangles: ${JSON.stringify(scene)}`);
+    }
+    if (!scene.frame) {
+      throw new Error(`texture example animation did not advance: ${JSON.stringify(scene)}`);
+    }
+    assertNoDiagnostics(diagnostics);
+    console.log(`textures smoke test passed at ${server.url}/examples/browser/textures/`);
+  } finally {
+    await browser.close();
+    await new Promise((resolve) => server.instance.close(resolve));
+  }
+}
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

data/lib/three/animation/animation_action.rb ADDED Viewed

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+module Three
+  class AnimationAction
+    PROPERTY_NAMES = {
+      enabled: "enabled",
+      paused: "paused",
+      time: "time",
+      time_scale: "timeScale",
+      weight: "weight",
+      loop: "loop",
+      repetitions: "repetitions",
+      clamp_when_finished: "clampWhenFinished"
+    }.freeze
+    attr_reader :handle, :backend
+    attr_reader(*PROPERTY_NAMES.keys)
+    def initialize(handle, backend:)
+      @handle = handle
+      @backend = backend
+    end
+    def play
+      @backend.play_animation_action(@handle)
+      self
+    end
+    def stop
+      @backend.stop_animation_action(@handle)
+      self
+    end
+    def reset
+      @backend.reset_animation_action(@handle)
+      self
+    end
+    def fade_in(duration)
+      @backend.fade_in_animation_action(@handle, duration)
+      self
+    end
+    def fade_out(duration)
+      @backend.fade_out_animation_action(@handle, duration)
+      self
+    end
+    PROPERTY_NAMES.each do |ruby_name, js_name|
+      define_method("#{ruby_name}=") do |value|
+        instance_variable_set("@#{ruby_name}", value)
+        @backend.set_animation_action_property(@handle, js_name, value)
+        value
+      end
+    end
+  end
+end

data/lib/three/animation/animation_clip.rb ADDED Viewed

@@ -0,0 +1,22 @@
+# frozen_string_literal: true
+require_relative "../backends/threejs"
+module Three
+  class AnimationClip
+    attr_reader :handle, :adapter
+    def initialize(handle, adapter: Backends::ThreeJS::RubyWasmAdapter.new)
+      @handle = handle
+      @adapter = adapter
+    end
+    def name
+      @adapter.animation_clip_name(@handle)
+    end
+    def duration
+      @adapter.animation_clip_duration(@handle)
+    end
+  end
+end

data/lib/three/animation/animation_mixer.rb ADDED Viewed

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+require_relative "../backends/threejs"
+require_relative "animation_action"
+module Three
+  class AnimationMixer
+    attr_reader :root, :backend, :handle
+    def initialize(root, backend: Backends::ThreeJS.new)
+      @root = root
+      @backend = backend
+      @handle = @backend.create_animation_mixer(@backend.sync(root))
+    end
+    def clip_action(clip, root: nil)
+      root_handle = root ? @backend.sync(root) : nil
+      handle = @backend.animation_mixer_clip_action(@handle, animation_clip_handle(clip), root_handle)
+      AnimationAction.new(handle, backend: @backend)
+    end
+    def update(delta)
+      @backend.update_animation_mixer(@handle, delta)
+      self
+    end
+    def stop_all_action
+      @backend.stop_all_animation_actions(@handle)
+      self
+    end
+    def uncache_root(root = @root)
+      @backend.uncache_animation_root(@handle, @backend.sync(root))
+      self
+    end
+    private
+    def animation_clip_handle(clip)
+      clip.respond_to?(:handle) ? clip.handle : clip
+    end
+  end
+end