three-rb 0.1.0 → 0.2.0

data/lib/three/math/matrix4.rb

@@ -13,6 +13,7 @@ module Three
         0, 0, 1, 0,
         0, 0, 0, 1
       ]
+      @on_change_callback = proc {}
 
       set(*values) unless values.empty?
     end
@@ -34,6 +35,7 @@ module Three
       @elements[7] = n42
       @elements[11] = n43
       @elements[15] = n44
+      changed!
       self
     end
 
@@ -52,6 +54,7 @@ module Three
 
     def copy(matrix)
       @elements = matrix.elements.dup
+      changed!
       self
     end
 
@@ -59,6 +62,7 @@ module Three
       @elements[12] = matrix.elements[12]
       @elements[13] = matrix.elements[13]
       @elements[14] = matrix.elements[14]
+      changed!
       self
     end
 
@@ -101,6 +105,7 @@ module Three
         @elements[14] = z
       end
 
+      changed!
       self
     end
 
@@ -169,11 +174,13 @@ module Three
       @elements[7] = a41 * b12 + a42 * b22 + a43 * b32 + a44 * b42
       @elements[11] = a41 * b13 + a42 * b23 + a43 * b33 + a44 * b43
       @elements[15] = a41 * b14 + a42 * b24 + a43 * b34 + a44 * b44
+      changed!
       self
     end
 
     def multiply_scalar(scalar)
       @elements.map! { |value| value * scalar }
+      changed!
       self
     end
 
@@ -215,6 +222,7 @@ module Three
       @elements[3], @elements[12] = @elements[12], @elements[3]
       @elements[7], @elements[13] = @elements[13], @elements[7]
       @elements[11], @elements[14] = @elements[14], @elements[11]
+      changed!
       self
     end
 
@@ -270,6 +278,7 @@ module Three
       @elements[13] = (n11 * t10 - n21 * t8 + n31 * t7) * det_inv
       @elements[14] = (n24 * t2 - n14 * t4 - n34 * t1) * det_inv
       @elements[15] = (n13 * t4 - n23 * t2 + n33 * t1) * det_inv
+      changed!
       self
     end
 
@@ -286,6 +295,7 @@ module Three
       @elements[3] *= vector.x
       @elements[7] *= vector.y
       @elements[11] *= vector.z
+      changed!
       self
     end
 
@@ -313,6 +323,7 @@ module Three
       @elements[7] = 0
       @elements[11] = -1
       @elements[15] = 0
+      changed!
       self
     end
 
@@ -340,6 +351,7 @@ module Three
       @elements[7] = 0
       @elements[11] = 0
       @elements[15] = 1
+      changed!
       self
     end
 
@@ -383,6 +395,7 @@ module Three
       @elements[13] = position.y
       @elements[14] = position.z
       @elements[15] = 1
+      changed!
       self
     end
 
@@ -419,9 +432,17 @@ module Three
 
     def from_array(array, offset = 0)
       16.times { |index| @elements[index] = array[index + offset] }
+      changed!
       self
     end
 
+    def on_change(&callback)
+      @on_change_callback = callback || proc {}
+      self
+    end
+
+    alias _on_change on_change
+
     def to_a
       @elements.dup
     end
@@ -444,5 +465,11 @@ module Three
     def inspect
       "#<#{self.class} elements=#{@elements.inspect}>"
     end
+
+    private
+
+    def changed!
+      @on_change_callback.call
+    end
   end
 end

data/lib/three/renderers/threejs_renderer.rb

@@ -33,6 +33,16 @@ module Three
         self
       end
 
+      def tone_mapping=(value)
+        @backend.set_renderer_tone_mapping(@handle, value)
+        value
+      end
+
+      def tone_mapping_exposure=(value)
+        @backend.set_renderer_tone_mapping_exposure(@handle, value)
+        value
+      end
+
       def configure_shadow_map(enabled: nil, type: nil, auto_update: nil)
         @backend.set_renderer_shadow_map(@handle, enabled: enabled, type: type, auto_update: auto_update)
         self
@@ -55,6 +65,15 @@ module Three
         self
       end
 
+      def on_dispose(object, &block)
+        @backend.add_event_listener(object, :dispose, block)
+        self
+      end
+
+      def cached?(object)
+        @backend.cached?(object)
+      end
+
       def traverse_handles(object, &block)
         return enum_for(:traverse_handles, object) unless block
 

data/lib/three/scenes/fog.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+require_relative "../dirty"
+require_relative "../math/color"
+require_relative "../math/math_utils"
+
+module Three
+  class Fog
+    include Dirty
+
+    attr_reader :uuid, :color, :name, :type, :near, :far
+
+    def initialize(color = 0xffffff, near: 1, far: 1000, name: "")
+      @uuid = MathUtils.generate_uuid
+      @type = "Fog"
+      @name = name
+      @color = color.is_a?(Color) ? color : Color.new(color)
+      @near = near
+      @far = far
+      bind_color_changes
+      mark_dirty!
+    end
+
+    def name=(value)
+      @name = value
+      mark_dirty!(:parameters)
+    end
+
+    def color=(value)
+      @color = value.is_a?(Color) ? value : Color.new(value)
+      bind_color_changes
+      mark_dirty!(:parameters)
+    end
+
+    def near=(value)
+      @near = value
+      mark_dirty!(:parameters)
+    end
+
+    def far=(value)
+      @far = value
+      mark_dirty!(:parameters)
+    end
+
+    def to_h
+      {
+        type: @type,
+        name: @name,
+        color: @color.hex,
+        near: @near,
+        far: @far
+      }
+    end
+
+    private
+
+    def bind_color_changes
+      @color.on_change { mark_dirty!(:parameters) }
+    end
+  end
+
+  class FogExp2 < Fog
+    attr_reader :density
+
+    def initialize(color = 0xffffff, density: 0.00025, name: "")
+      super(color, near: nil, far: nil, name: name)
+      @type = "FogExp2"
+      @density = density
+      mark_dirty!
+    end
+
+    def density=(value)
+      @density = value
+      mark_dirty!(:parameters)
+    end
+
+    def to_h
+      {
+        type: @type,
+        name: name,
+        color: color.hex,
+        density: @density
+      }
+    end
+  end
+end

data/lib/three/scenes/scene.rb

@@ -5,7 +5,7 @@ require_relative "../core/object3d"
 module Three
   class Scene < Object3D
     attr_reader :background, :environment
-    attr_accessor :fog, :override_material
+    attr_reader :fog, :override_material
 
     def initialize
       super
@@ -25,5 +25,23 @@ module Three
       @environment = value
       mark_dirty!(:scene)
     end
+
+    def fog=(value)
+      replace_scene_resource(:fog, value)
+    end
+
+    def override_material=(value)
+      replace_scene_resource(:override_material, value)
+    end
+
+    private
+
+    def replace_scene_resource(name, value)
+      current = instance_variable_get(:"@#{name}")
+      current.remove_dirty_dependent(self) if current.respond_to?(:remove_dirty_dependent)
+      instance_variable_set(:"@#{name}", value)
+      value.add_dirty_dependent(self) if value.respond_to?(:add_dirty_dependent)
+      mark_dirty!(:scene)
+    end
   end
 end

data/lib/three/textures/texture.rb

@@ -159,7 +159,8 @@ module Three
         center: @center.to_a,
         rotation: @rotation,
         matrix_auto_update: @matrix_auto_update,
-        matrix: @matrix.to_a
+        matrix: @matrix.to_a,
+        user_data: @user_data
       }
     end
 

data/lib/three/version.rb

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

data/lib/three.rb

@@ -27,6 +27,7 @@ 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/fog"
 require_relative "three/scenes/scene"
 require_relative "three/cameras/camera"
 require_relative "three/cameras/perspective_camera"
@@ -52,11 +53,13 @@ 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/font_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/geometries/text_geometry"
 require_relative "three/backends/base"
 require_relative "three/backends/threejs"
 require_relative "three/core/raycaster"
@@ -72,6 +75,7 @@ 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"
+require_relative "three/browser"
 
 module Three
 end

data/package.json

@@ -4,7 +4,8 @@
   "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": "pnpm test:browser:ruby && 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:ruby": "node examples/browser/ruby/smoke_test.mjs",
     "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",

metadata

@@ -1,11 +1,11 @@
 --- !ruby/object:Gem::Specification
 name: three-rb
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - LEF
-bindir: bin
+bindir: exe
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
@@ -40,7 +40,8 @@ dependencies:
 description: three-rb provides Ruby APIs for building 3D scenes, with browser rendering
   through ruby.wasm and three.js.
 email: []
-executables: []
+executables:
+- three-rb
 extensions: []
 extra_rdoc_files: []
 files:
@@ -53,6 +54,7 @@ files:
 - docs/next-work.md
 - docs/publishing.md
 - docs/release-readiness.md
+- docs/standalone-browser-app.md
 - examples/browser/README.md
 - examples/browser/assets/animated_triangle.gltf
 - examples/browser/assets/checker.svg
@@ -94,6 +96,11 @@ files:
 - examples/browser/primitives/index.html
 - examples/browser/primitives/main.rb
 - examples/browser/primitives/smoke_test.mjs
+- examples/browser/ruby/README.md
+- examples/browser/ruby/boot.mjs
+- examples/browser/ruby/index.html
+- examples/browser/ruby/main.rb
+- examples/browser/ruby/smoke_test.mjs
 - examples/browser/serialization/README.md
 - examples/browser/serialization/boot.mjs
 - examples/browser/serialization/index.html
@@ -106,6 +113,7 @@ files:
 - examples/browser/textures/index.html
 - examples/browser/textures/main.rb
 - examples/browser/textures/smoke_test.mjs
+- exe/three-rb
 - lib/three-rb.rb
 - lib/three.rb
 - lib/three/animation/animation_action.rb
@@ -118,6 +126,7 @@ files:
 - lib/three/backends/threejs/resource_management.rb
 - lib/three/backends/threejs/ruby_wasm_adapter.rb
 - lib/three/backends/threejs/synchronization.rb
+- lib/three/browser.rb
 - lib/three/cameras/camera.rb
 - lib/three/cameras/orthographic_camera.rb
 - lib/three/cameras/perspective_camera.rb
@@ -132,15 +141,18 @@ files:
 - lib/three/core/raycaster.rb
 - lib/three/dirty.rb
 - lib/three/exporters/three_json_exporter.rb
+- lib/three/generators/browser_example.rb
 - lib/three/geometries/box_geometry.rb
 - lib/three/geometries/plane_geometry.rb
 - lib/three/geometries/sphere_geometry.rb
+- lib/three/geometries/text_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/font_loader.rb
 - lib/three/loaders/gltf_loader.rb
 - lib/three/loaders/rgbe_loader.rb
 - lib/three/loaders/texture_loader.rb
@@ -180,6 +192,7 @@ files:
 - lib/three/postprocessing/unreal_bloom_pass.rb
 - lib/three/renderers/renderer.rb
 - lib/three/renderers/threejs_renderer.rb
+- lib/three/scenes/fog.rb
 - lib/three/scenes/scene.rb
 - lib/three/textures/cube_texture.rb
 - lib/three/textures/rgbe_texture.rb