three-rb 0.1.0

data/lib/three/textures/texture.rb

@@ -0,0 +1,200 @@
+# frozen_string_literal: true
+
+require_relative "../core/event_dispatcher"
+require_relative "../constants"
+require_relative "../dirty"
+require_relative "../math/math_utils"
+require_relative "../math/matrix3"
+require_relative "../math/vector2"
+
+module Three
+  class Texture < EventDispatcher
+    include Dirty
+
+    @next_id = 0
+
+    class << self
+      attr_accessor :next_id
+    end
+
+    attr_reader :id, :uuid, :source, :mapping, :color_space, :flip_y, :wrap_s, :wrap_t, :mag_filter, :min_filter
+    attr_reader :offset, :repeat, :center, :rotation, :matrix_auto_update, :matrix
+    attr_accessor :user_data
+
+    def initialize(
+      source = nil,
+      mapping: Three::UVMapping,
+      color_space: Three::NoColorSpace,
+      flip_y: true,
+      wrap_s: Three::ClampToEdgeWrapping,
+      wrap_t: Three::ClampToEdgeWrapping,
+      mag_filter: Three::LinearFilter,
+      min_filter: Three::LinearMipmapLinearFilter,
+      offset: nil,
+      repeat: nil,
+      center: nil,
+      rotation: 0,
+      matrix_auto_update: true,
+      matrix: nil
+    )
+      super()
+      @id = self.class.allocate_id
+      @uuid = MathUtils.generate_uuid
+      @source = source
+      @mapping = mapping
+      @color_space = color_space
+      @flip_y = flip_y
+      @wrap_s = wrap_s
+      @wrap_t = wrap_t
+      @mag_filter = mag_filter
+      @min_filter = min_filter
+      @offset = coerce_vector2(offset || [0, 0], field: :offset)
+      @repeat = coerce_vector2(repeat || [1, 1], field: :repeat)
+      @center = coerce_vector2(center || [0, 0], field: :center)
+      @rotation = rotation
+      @matrix_auto_update = matrix_auto_update
+      @matrix = coerce_matrix3(matrix || Matrix3.new)
+      @user_data = {}
+      bind_vector_changes
+      mark_dirty!
+    end
+
+    def source=(value)
+      @source = value
+      mark_dirty!(:parameters)
+    end
+
+    def mapping=(value)
+      @mapping = value
+      mark_dirty!(:parameters)
+    end
+
+    def color_space=(value)
+      @color_space = value
+      mark_dirty!(:parameters)
+    end
+
+    def flip_y=(value)
+      @flip_y = value
+      mark_dirty!(:parameters)
+    end
+
+    def wrap_s=(value)
+      @wrap_s = value
+      mark_dirty!(:parameters)
+    end
+
+    def wrap_t=(value)
+      @wrap_t = value
+      mark_dirty!(:parameters)
+    end
+
+    def mag_filter=(value)
+      @mag_filter = value
+      mark_dirty!(:parameters)
+    end
+
+    def min_filter=(value)
+      @min_filter = value
+      mark_dirty!(:parameters)
+    end
+
+    def repeat=(value)
+      @repeat = coerce_vector2(value, field: :repeat)
+      bind_vector_changes
+      mark_dirty!(:parameters)
+    end
+
+    def offset=(value)
+      @offset = coerce_vector2(value, field: :offset)
+      bind_vector_changes
+      mark_dirty!(:parameters)
+    end
+
+    def center=(value)
+      @center = coerce_vector2(value, field: :center)
+      bind_vector_changes
+      mark_dirty!(:parameters)
+    end
+
+    def rotation=(value)
+      @rotation = value
+      mark_dirty!(:parameters)
+    end
+
+    def matrix_auto_update=(value)
+      @matrix_auto_update = value
+      mark_dirty!(:parameters)
+    end
+
+    def matrix=(value)
+      @matrix = coerce_matrix3(value)
+      mark_dirty!(:parameters)
+    end
+
+    def update_matrix
+      @matrix.set_uv_transform(@offset.x, @offset.y, @repeat.x, @repeat.y, @rotation, @center.x, @center.y)
+      mark_dirty!(:parameters)
+      self
+    end
+
+    def dispose
+      dispatch_event(:dispose)
+    end
+
+    def to_h
+      {
+        uuid: @uuid,
+        type: "Texture",
+        source: @source,
+        mapping: @mapping,
+        color_space: @color_space,
+        flip_y: @flip_y,
+        wrap_s: @wrap_s,
+        wrap_t: @wrap_t,
+        mag_filter: @mag_filter,
+        min_filter: @min_filter,
+        offset: @offset.to_a,
+        repeat: @repeat.to_a,
+        center: @center.to_a,
+        rotation: @rotation,
+        matrix_auto_update: @matrix_auto_update,
+        matrix: @matrix.to_a
+      }
+    end
+
+    def self.allocate_id
+      id = Texture.next_id
+      Texture.next_id += 1
+      id
+    end
+
+    private
+
+    def coerce_vector2(value, field:)
+      return value if value.is_a?(Vector2)
+
+      array = value.to_ary if value.respond_to?(:to_ary)
+      array ||= value.to_a if value.respond_to?(:to_a)
+      return Vector2.new(array[0], array[1]) if array && array.length >= 2
+
+      raise TypeError, "#{field} must be a Three::Vector2 or an array-like [x, y]"
+    end
+
+    def coerce_matrix3(value)
+      return value if value.is_a?(Matrix3)
+
+      array = value.to_ary if value.respond_to?(:to_ary)
+      array ||= value.to_a if value.respond_to?(:to_a)
+      return Matrix3.new.from_array(array) if array && array.length >= 9
+
+      raise TypeError, "matrix must be a Three::Matrix3 or an array-like with 9 elements"
+    end
+
+    def bind_vector_changes
+      @offset.on_change { mark_dirty!(:parameters) }
+      @repeat.on_change { mark_dirty!(:parameters) }
+      @center.on_change { mark_dirty!(:parameters) }
+    end
+  end
+end

data/lib/three/version.rb

@@ -0,0 +1,5 @@
+# frozen_string_literal: true
+
+module Three
+  VERSION = "0.1.0"
+end

data/lib/three-rb.rb

@@ -0,0 +1,3 @@
+# frozen_string_literal: true
+
+require_relative "three"

data/lib/three.rb

@@ -0,0 +1,77 @@
+# frozen_string_literal: true
+
+require_relative "three/version"
+require_relative "three/constants"
+require_relative "three/dirty"
+require_relative "three/math/math_utils"
+require_relative "three/math/color"
+require_relative "three/math/vector2"
+require_relative "three/math/vector3"
+require_relative "three/math/quaternion"
+require_relative "three/math/matrix3"
+require_relative "three/math/matrix4"
+require_relative "three/math/euler"
+require_relative "three/core/event_dispatcher"
+require_relative "three/core/clock"
+require_relative "three/core/layers"
+require_relative "three/core/object3d"
+require_relative "three/core/buffer_attribute"
+require_relative "three/core/buffer_geometry"
+require_relative "three/textures/texture"
+require_relative "three/textures/cube_texture"
+require_relative "three/textures/rgbe_texture"
+require_relative "three/objects/external_object3d"
+require_relative "three/objects/group"
+require_relative "three/objects/mesh"
+require_relative "three/objects/instanced_mesh"
+require_relative "three/objects/line"
+require_relative "three/objects/points"
+require_relative "three/objects/sprite"
+require_relative "three/scenes/scene"
+require_relative "three/cameras/camera"
+require_relative "three/cameras/perspective_camera"
+require_relative "three/cameras/orthographic_camera"
+require_relative "three/lights/light"
+require_relative "three/lights/ambient_light"
+require_relative "three/lights/directional_light"
+require_relative "three/lights/point_light"
+require_relative "three/lights/hemisphere_light"
+require_relative "three/materials/material"
+require_relative "three/materials/line_basic_material"
+require_relative "three/materials/mesh_basic_material"
+require_relative "three/materials/mesh_lambert_material"
+require_relative "three/materials/mesh_matcap_material"
+require_relative "three/materials/mesh_normal_material"
+require_relative "three/materials/mesh_phong_material"
+require_relative "three/materials/mesh_standard_material"
+require_relative "three/materials/mesh_physical_material"
+require_relative "three/materials/mesh_toon_material"
+require_relative "three/materials/points_material"
+require_relative "three/materials/shadow_material"
+require_relative "three/materials/sprite_material"
+require_relative "three/loaders/texture_loader"
+require_relative "three/loaders/cube_texture_loader"
+require_relative "three/loaders/rgbe_loader"
+require_relative "three/loaders/gltf_loader"
+require_relative "three/loaders/three_json_loader"
+require_relative "three/geometries/box_geometry"
+require_relative "three/geometries/plane_geometry"
+require_relative "three/geometries/sphere_geometry"
+require_relative "three/backends/base"
+require_relative "three/backends/threejs"
+require_relative "three/core/raycaster"
+require_relative "three/animation/animation_clip"
+require_relative "three/animation/animation_action"
+require_relative "three/animation/animation_mixer"
+require_relative "three/renderers/renderer"
+require_relative "three/renderers/threejs_renderer"
+require_relative "three/controls/orbit_controls"
+require_relative "three/postprocessing/effect_composer"
+require_relative "three/postprocessing/render_pass"
+require_relative "three/postprocessing/unreal_bloom_pass"
+require_relative "three/postprocessing/dot_screen_pass"
+require_relative "three/postprocessing/output_pass"
+require_relative "three/exporters/three_json_exporter"
+
+module Three
+end

data/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "three-rb",
+  "private": true,
+  "type": "module",
+  "packageManager": "pnpm@11.1.1",
+  "scripts": {
+    "test:browser": "pnpm test:browser:cube && pnpm test:browser:composition && pnpm test:browser:textures && pnpm test:browser:cubemap && pnpm test:browser:gltf && pnpm test:browser:serialization && pnpm test:browser:picking && pnpm test:browser:primitives && pnpm test:browser:postprocessing",
+    "test:browser:cube": "node examples/browser/cube/smoke_test.mjs",
+    "test:browser:composition": "node examples/browser/composition/smoke_test.mjs",
+    "test:browser:textures": "node examples/browser/textures/smoke_test.mjs",
+    "test:browser:cubemap": "node examples/browser/cubemap/smoke_test.mjs",
+    "test:browser:gltf": "node examples/browser/gltf/smoke_test.mjs",
+    "test:browser:serialization": "node examples/browser/serialization/smoke_test.mjs",
+    "test:browser:picking": "node examples/browser/picking/smoke_test.mjs",
+    "test:browser:primitives": "node examples/browser/primitives/smoke_test.mjs",
+    "test:browser:postprocessing": "node examples/browser/postprocessing/smoke_test.mjs",
+    "benchmark:browser": "pnpm benchmark:browser:mesh-sync && pnpm benchmark:browser:instanced-mesh-sync",
+    "benchmark:browser:mesh-sync": "node benchmarks/browser/mesh_sync/run.mjs",
+    "benchmark:browser:instanced-mesh-sync": "node benchmarks/browser/instanced_mesh_sync/run.mjs"
+  },
+  "dependencies": {
+    "@bjorn3/browser_wasi_shim": "0.4.2",
+    "@ruby/3.4-wasm-wasi": "2.9.4-2026-05-11-a",
+    "@ruby/wasm-wasi": "2.9.4-2026-05-11-a",
+    "three": "0.184.0"
+  },
+  "devDependencies": {
+    "playwright": "^1.60.0"
+  }
+}

data/pnpm-lock.yaml

@@ -0,0 +1,86 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    dependencies:
+      '@bjorn3/browser_wasi_shim':
+        specifier: 0.4.2
+        version: 0.4.2
+      '@ruby/3.4-wasm-wasi':
+        specifier: 2.9.4-2026-05-11-a
+        version: 2.9.4-2026-05-11-a
+      '@ruby/wasm-wasi':
+        specifier: 2.9.4-2026-05-11-a
+        version: 2.9.4-2026-05-11-a
+      three:
+        specifier: 0.184.0
+        version: 0.184.0
+    devDependencies:
+      playwright:
+        specifier: ^1.60.0
+        version: 1.60.0
+
+packages:
+
+  '@bjorn3/browser_wasi_shim@0.4.2':
+    resolution: {integrity: sha512-/iHkCVUG3VbcbmEHn5iIUpIrh7a7WPiwZ3sHy4HZKZzBdSadwdddYDZAII2zBvQYV0Lfi8naZngPCN7WPHI/hA==}
+
+  '@ruby/3.4-wasm-wasi@2.9.4-2026-05-11-a':
+    resolution: {integrity: sha512-qI32iuHxb1onVbbbfnZHOI109P13ZpvQf4KEMk4XyzVIDKYNHzJzwvRcZm6uPjtv9ekLeJBSSeqqImRP/sDNqQ==}
+
+  '@ruby/wasm-wasi@2.9.4-2026-05-11-a':
+    resolution: {integrity: sha512-DpS1BJFYldhSmy1gGa0GwD4cYw8qTu6FblQq6JVF0VVh+3ONPcvMGPHpVvwPeMve4tEsMkM6hOyTO8HshTcQ8Q==}
+
+  fsevents@2.3.2:
+    resolution: {integrity: sha512-xiqMQR4xAeHTuB9uWm+fFRcIOgKBMiOBP+eXiyT7jsgVCq1bkVygt00oASowB7EdtpOHaaPgKt812P9ab+DDKA==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  playwright-core@1.60.0:
+    resolution: {integrity: sha512-9bW6zvX/m0lEbgTKJ6YppOKx8H3VOPBMOCFh2irXFOT4BbHgrx5hPjwJYLT40Lu+4qtD36qKc/Hn56StUW57IA==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  playwright@1.60.0:
+    resolution: {integrity: sha512-hheHdokM8cdqCb0lcE3s+zT4t4W+vvjpGxsZlDnikarzx8tSzMebh3UiFtgqwFwnTnjYQcsyMF8ei2mCO/tpeA==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  three@0.184.0:
+    resolution: {integrity: sha512-wtTRjG92pM5eUg/KuUnHsqSAlPM296brTOcLgMRqEeylYTh/CdtvKUvCyyCQTzFuStieWxvZb8mVTMvdPyUpxg==}
+
+  tslib@2.8.1:
+    resolution: {integrity: sha512-oJFu94HQb+KVduSUQL7wnpmqnfmLsOA/nAh6b6EH0wCEoK0/mPeXU6c3wKDV83MkOuHPRHtSXKKU99IBazS/2w==}
+
+snapshots:
+
+  '@bjorn3/browser_wasi_shim@0.4.2': {}
+
+  '@ruby/3.4-wasm-wasi@2.9.4-2026-05-11-a':
+    dependencies:
+      '@ruby/wasm-wasi': 2.9.4-2026-05-11-a
+
+  '@ruby/wasm-wasi@2.9.4-2026-05-11-a':
+    dependencies:
+      '@bjorn3/browser_wasi_shim': 0.4.2
+      tslib: 2.8.1
+
+  fsevents@2.3.2:
+    optional: true
+
+  playwright-core@1.60.0: {}
+
+  playwright@1.60.0:
+    dependencies:
+      playwright-core: 1.60.0
+    optionalDependencies:
+      fsevents: 2.3.2
+
+  three@0.184.0: {}
+
+  tslib@2.8.1: {}

metadata

@@ -0,0 +1,216 @@
+--- !ruby/object:Gem::Specification
+name: three-rb
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- LEF
+bindir: bin
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: minitest
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '6.0'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '13.0'
+description: three-rb provides Ruby APIs for building 3D scenes, with browser rendering
+  through ruby.wasm and three.js.
+email: []
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE
+- README.md
+- docs/browser-runtime.md
+- docs/implementation-plan.md
+- docs/loaded-assets-design.md
+- docs/next-work.md
+- docs/publishing.md
+- docs/release-readiness.md
+- examples/browser/README.md
+- examples/browser/assets/animated_triangle.gltf
+- examples/browser/assets/checker.svg
+- examples/browser/assets/compressed_triangle.gltf
+- examples/browser/assets/studio.hdr
+- examples/browser/assets/triangle.gltf
+- examples/browser/composition/README.md
+- examples/browser/composition/boot.mjs
+- examples/browser/composition/index.html
+- examples/browser/composition/main.rb
+- examples/browser/composition/smoke_test.mjs
+- examples/browser/cube/README.md
+- examples/browser/cube/boot.mjs
+- examples/browser/cube/index.html
+- examples/browser/cube/main.rb
+- examples/browser/cube/smoke_test.mjs
+- examples/browser/cubemap/README.md
+- examples/browser/cubemap/boot.mjs
+- examples/browser/cubemap/index.html
+- examples/browser/cubemap/main.rb
+- examples/browser/cubemap/smoke_test.mjs
+- examples/browser/gltf/README.md
+- examples/browser/gltf/boot.mjs
+- examples/browser/gltf/index.html
+- examples/browser/gltf/main.rb
+- examples/browser/gltf/smoke_test.mjs
+- examples/browser/picking/README.md
+- examples/browser/picking/boot.mjs
+- examples/browser/picking/index.html
+- examples/browser/picking/main.rb
+- examples/browser/picking/smoke_test.mjs
+- examples/browser/postprocessing/README.md
+- examples/browser/postprocessing/boot.mjs
+- examples/browser/postprocessing/index.html
+- examples/browser/postprocessing/main.rb
+- examples/browser/postprocessing/smoke_test.mjs
+- examples/browser/primitives/README.md
+- examples/browser/primitives/boot.mjs
+- examples/browser/primitives/index.html
+- examples/browser/primitives/main.rb
+- examples/browser/primitives/smoke_test.mjs
+- examples/browser/serialization/README.md
+- examples/browser/serialization/boot.mjs
+- examples/browser/serialization/index.html
+- examples/browser/serialization/main.rb
+- examples/browser/serialization/smoke_test.mjs
+- examples/browser/shared/boot.mjs
+- examples/browser/shared/smoke_test_helpers.mjs
+- examples/browser/textures/README.md
+- examples/browser/textures/boot.mjs
+- examples/browser/textures/index.html
+- examples/browser/textures/main.rb
+- examples/browser/textures/smoke_test.mjs
+- lib/three-rb.rb
+- lib/three.rb
+- lib/three/animation/animation_action.rb
+- lib/three/animation/animation_clip.rb
+- lib/three/animation/animation_mixer.rb
+- lib/three/backends/base.rb
+- lib/three/backends/threejs.rb
+- lib/three/backends/threejs/materialization.rb
+- lib/three/backends/threejs/parameters.rb
+- lib/three/backends/threejs/resource_management.rb
+- lib/three/backends/threejs/ruby_wasm_adapter.rb
+- lib/three/backends/threejs/synchronization.rb
+- lib/three/cameras/camera.rb
+- lib/three/cameras/orthographic_camera.rb
+- lib/three/cameras/perspective_camera.rb
+- lib/three/constants.rb
+- lib/three/controls/orbit_controls.rb
+- lib/three/core/buffer_attribute.rb
+- lib/three/core/buffer_geometry.rb
+- lib/three/core/clock.rb
+- lib/three/core/event_dispatcher.rb
+- lib/three/core/layers.rb
+- lib/three/core/object3d.rb
+- lib/three/core/raycaster.rb
+- lib/three/dirty.rb
+- lib/three/exporters/three_json_exporter.rb
+- lib/three/geometries/box_geometry.rb
+- lib/three/geometries/plane_geometry.rb
+- lib/three/geometries/sphere_geometry.rb
+- lib/three/lights/ambient_light.rb
+- lib/three/lights/directional_light.rb
+- lib/three/lights/hemisphere_light.rb
+- lib/three/lights/light.rb
+- lib/three/lights/point_light.rb
+- lib/three/loaders/cube_texture_loader.rb
+- lib/three/loaders/gltf_loader.rb
+- lib/three/loaders/rgbe_loader.rb
+- lib/three/loaders/texture_loader.rb
+- lib/three/loaders/three_json_loader.rb
+- lib/three/materials/line_basic_material.rb
+- lib/three/materials/material.rb
+- lib/three/materials/mesh_basic_material.rb
+- lib/three/materials/mesh_lambert_material.rb
+- lib/three/materials/mesh_matcap_material.rb
+- lib/three/materials/mesh_normal_material.rb
+- lib/three/materials/mesh_phong_material.rb
+- lib/three/materials/mesh_physical_material.rb
+- lib/three/materials/mesh_standard_material.rb
+- lib/three/materials/mesh_toon_material.rb
+- lib/three/materials/points_material.rb
+- lib/three/materials/shadow_material.rb
+- lib/three/materials/sprite_material.rb
+- lib/three/math/color.rb
+- lib/three/math/euler.rb
+- lib/three/math/math_utils.rb
+- lib/three/math/matrix3.rb
+- lib/three/math/matrix4.rb
+- lib/three/math/quaternion.rb
+- lib/three/math/vector2.rb
+- lib/three/math/vector3.rb
+- lib/three/objects/external_object3d.rb
+- lib/three/objects/group.rb
+- lib/three/objects/instanced_mesh.rb
+- lib/three/objects/line.rb
+- lib/three/objects/mesh.rb
+- lib/three/objects/points.rb
+- lib/three/objects/sprite.rb
+- lib/three/postprocessing/dot_screen_pass.rb
+- lib/three/postprocessing/effect_composer.rb
+- lib/three/postprocessing/output_pass.rb
+- lib/three/postprocessing/render_pass.rb
+- lib/three/postprocessing/unreal_bloom_pass.rb
+- lib/three/renderers/renderer.rb
+- lib/three/renderers/threejs_renderer.rb
+- lib/three/scenes/scene.rb
+- lib/three/textures/cube_texture.rb
+- lib/three/textures/rgbe_texture.rb
+- lib/three/textures/texture.rb
+- lib/three/version.rb
+- package.json
+- pnpm-lock.yaml
+homepage: https://github.com/lef237/three-rb
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/lef237/three-rb
+  source_code_uri: https://github.com/lef237/three-rb/tree/main
+  changelog_uri: https://github.com/lef237/three-rb/blob/main/CHANGELOG.md
+  bug_tracker_uri: https://github.com/lef237/three-rb/issues
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '3.2'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.6.9
+specification_version: 4
+summary: Ruby 3D library inspired by three.js.
+test_files: []