webxr 0.1.0

data/lib/webxr/spaces/bounded_reference_space.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+module WebXR
+  # XRBoundedReferenceSpace - A reference space with defined boundaries
+  # Used for room-scale VR where the user has defined play area boundaries
+  class BoundedReferenceSpace < ReferenceSpace
+    # @param js_bounded_space [JS::Object] The XRBoundedReferenceSpace JavaScript object
+    def initialize(js_bounded_space)
+      super(js_bounded_space)
+    end
+
+    # Get the space type
+    # @return [String]
+    def type
+      "bounded-reference-space"
+    end
+
+    # Get the boundary polygon vertices
+    # The points define the floor-level boundary polygon
+    # @return [Array<Hash>] Array of points with :x, :y, :z, :w keys
+    def bounds_geometry
+      js_bounds = js_prop(:boundsGeometry)
+      return [] if js_bounds.nil?
+
+      js_array_to_a(js_bounds).map do |js_point|
+        {
+          x: js_point[:x].to_f,
+          y: js_point[:y].to_f,
+          z: js_point[:z].to_f,
+          w: js_point[:w].to_f
+        }
+      end
+    end
+
+    # Create a new bounded reference space with an offset transform
+    # @param origin_offset [RigidTransform] The offset transform
+    # @return [BoundedReferenceSpace]
+    def with_origin_offset(origin_offset)
+      js_space = js_call(:getOffsetReferenceSpace, origin_offset.js)
+      BoundedReferenceSpace.new(js_space)
+    end
+  end
+end

data/lib/webxr/spaces/reference_space.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module WebXR
+  # XRReferenceSpace - A tracked reference coordinate space
+  class ReferenceSpace < Space
+    # @param js_reference_space [JS::Object] The XRReferenceSpace JavaScript object
+    def initialize(js_reference_space)
+      super(js_reference_space)
+      @reset_callbacks = []
+    end
+
+    # Get the space type
+    # @return [String]
+    def type
+      "reference-space"
+    end
+
+    # Create a new reference space with an offset transform
+    # @param origin_offset [RigidTransform] The offset transform
+    # @return [ReferenceSpace]
+    def with_origin_offset(origin_offset)
+      js_space = js_call(:getOffsetReferenceSpace, origin_offset.js)
+      ReferenceSpace.new(js_space)
+    end
+
+    # Register a callback for reset events
+    # Reset events occur when the reference space origin changes
+    # (e.g., user recenters the view)
+    # @yield [ReferenceSpaceEvent] Called when the space is reset
+    # @return [void]
+    def on_reset(&block)
+      return unless block_given?
+
+      @reset_callbacks << block
+      setup_reset_listener if @reset_callbacks.size == 1
+    end
+
+    private
+
+    def setup_reset_listener
+      callback = ->(js_event) { dispatch_reset(js_event) }
+      js_callback = JS.eval("(function(event) { return $callback.call(event); })")
+      js_call(:addEventListener, "reset", js_callback)
+    end
+
+    def dispatch_reset(js_event)
+      event = ReferenceSpaceEvent.new(js_event)
+      @reset_callbacks.each { |cb| cb.call(event) }
+    end
+  end
+end

data/lib/webxr/spaces/space.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module WebXR
+  # XRSpace - Base class for coordinate spaces
+  # Represents a coordinate system that can be tracked in XR
+  class Space < JSWrapper
+    # @param js_space [JS::Object] The XRSpace JavaScript object
+    def initialize(js_space)
+      super(js_space)
+    end
+
+    # Get the space type (for debugging/identification)
+    # @return [String]
+    def type
+      "space"
+    end
+  end
+end

data/lib/webxr/version.rb

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

data/lib/webxr.rb

@@ -0,0 +1,73 @@
+# frozen_string_literal: true
+
+require_relative "webxr/version"
+require_relative "webxr/errors"
+require_relative "webxr/constants"
+require_relative "webxr/js_wrapper"
+
+# Core classes
+require_relative "webxr/core/system"
+require_relative "webxr/core/session"
+require_relative "webxr/core/frame"
+require_relative "webxr/core/render_state"
+
+# Spaces
+require_relative "webxr/spaces/space"
+require_relative "webxr/spaces/reference_space"
+require_relative "webxr/spaces/bounded_reference_space"
+
+# Geometry
+require_relative "webxr/geometry/rigid_transform"
+require_relative "webxr/geometry/pose"
+require_relative "webxr/geometry/viewer_pose"
+require_relative "webxr/geometry/view"
+require_relative "webxr/geometry/viewport"
+
+# Input
+require_relative "webxr/input/input_source"
+require_relative "webxr/input/input_source_array"
+require_relative "webxr/input/gamepad"
+require_relative "webxr/input/gamepad_button"
+
+# Layers
+require_relative "webxr/layers/layer"
+require_relative "webxr/layers/webgl_layer"
+require_relative "webxr/layers/webgl_binding"
+require_relative "webxr/layers/webgl_sub_image"
+
+# Events
+require_relative "webxr/events/session_event"
+require_relative "webxr/events/input_source_event"
+require_relative "webxr/events/reference_space_event"
+
+# Hand Tracking
+require_relative "webxr/hand/joint_space"
+require_relative "webxr/hand/joint_pose"
+require_relative "webxr/hand/hand"
+
+# AR Features
+require_relative "webxr/ar/ray"
+require_relative "webxr/ar/anchor"
+require_relative "webxr/ar/hit_test_source"
+require_relative "webxr/ar/hit_test_result"
+
+# Helpers
+require_relative "webxr/helpers/session_manager"
+require_relative "webxr/helpers/rendering_helper"
+require_relative "webxr/helpers/input_helper"
+
+module WebXR
+  class << self
+    # Check if WebXR is available in the current environment
+    # @return [Boolean]
+    def available?
+      System.available?
+    end
+
+    # Get the XRSystem singleton instance
+    # @return [System, nil]
+    def system
+      System.instance
+    end
+  end
+end

data/webxr.gemspec

@@ -0,0 +1,33 @@
+# frozen_string_literal: true
+
+require_relative "lib/webxr/version"
+
+Gem::Specification.new do |spec|
+  spec.name = "webxr"
+  spec.version = WebXR::VERSION
+  spec.authors = ["Yudai Takada"]
+  spec.email = ["t.yudai92@gmail.com"]
+
+  spec.summary = "WebXR Device API bindings for Ruby"
+  spec.description = "Complete Ruby bindings for the WebXR Device API, enabling VR/AR application development in Ruby via ruby.wasm"
+  spec.homepage = "https://github.com/ydah/webxr-ruby"
+  spec.license = "MIT"
+  spec.required_ruby_version = ">= 3.2.0"
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/blob/main/CHANGELOG.md"
+  spec.metadata["rubygems_mfa_required"] = "true"
+
+  spec.files = Dir.chdir(__dir__) do
+    `git ls-files -z`.split("\x0").reject do |f|
+      (File.expand_path(f) == __FILE__) ||
+        f.start_with?(*%w[bin/ test/ spec/ features/ .git .github appveyor Gemfile])
+    end
+  end
+  spec.bindir = "exe"
+  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "js", "~> 2.0"
+end

metadata

@@ -0,0 +1,111 @@
+--- !ruby/object:Gem::Specification
+name: webxr
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Yudai Takada
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: js
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: Complete Ruby bindings for the WebXR Device API, enabling VR/AR application
+  development in Ruby via ruby.wasm
+email:
+- t.yudai92@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rspec"
+- CHANGELOG.md
+- README.md
+- Rakefile
+- examples/ar_demo.html
+- examples/ar_hit_test.rb
+- examples/basic_vr.rb
+- examples/controller_input.rb
+- examples/hand_tracking.rb
+- examples/hello_webxr.html
+- examples/inline_demo.html
+- examples/server.rb
+- examples/vr_scene_demo.html
+- lib/webxr.rb
+- lib/webxr/ar/anchor.rb
+- lib/webxr/ar/hit_test_result.rb
+- lib/webxr/ar/hit_test_source.rb
+- lib/webxr/ar/ray.rb
+- lib/webxr/constants.rb
+- lib/webxr/core/frame.rb
+- lib/webxr/core/render_state.rb
+- lib/webxr/core/session.rb
+- lib/webxr/core/system.rb
+- lib/webxr/errors.rb
+- lib/webxr/events/input_source_event.rb
+- lib/webxr/events/reference_space_event.rb
+- lib/webxr/events/session_event.rb
+- lib/webxr/geometry/pose.rb
+- lib/webxr/geometry/rigid_transform.rb
+- lib/webxr/geometry/view.rb
+- lib/webxr/geometry/viewer_pose.rb
+- lib/webxr/geometry/viewport.rb
+- lib/webxr/hand/hand.rb
+- lib/webxr/hand/joint_pose.rb
+- lib/webxr/hand/joint_space.rb
+- lib/webxr/helpers/input_helper.rb
+- lib/webxr/helpers/rendering_helper.rb
+- lib/webxr/helpers/session_manager.rb
+- lib/webxr/input/gamepad.rb
+- lib/webxr/input/gamepad_button.rb
+- lib/webxr/input/input_source.rb
+- lib/webxr/input/input_source_array.rb
+- lib/webxr/js_wrapper.rb
+- lib/webxr/layers/layer.rb
+- lib/webxr/layers/webgl_binding.rb
+- lib/webxr/layers/webgl_layer.rb
+- lib/webxr/layers/webgl_sub_image.rb
+- lib/webxr/spaces/bounded_reference_space.rb
+- lib/webxr/spaces/reference_space.rb
+- lib/webxr/spaces/space.rb
+- lib/webxr/version.rb
+- webxr.gemspec
+homepage: https://github.com/ydah/webxr-ruby
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/ydah/webxr-ruby
+  source_code_uri: https://github.com/ydah/webxr-ruby
+  changelog_uri: https://github.com/ydah/webxr-ruby/blob/main/CHANGELOG.md
+  rubygems_mfa_required: 'true'
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.2.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.3
+specification_version: 4
+summary: WebXR Device API bindings for Ruby
+test_files: []