metaco-ext 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 679fd4c4e31f510d21e5f91cef3646bdcf41341ca31358c8c5f012bbf05c0e4f
+  data.tar.gz: a4029522783974d02d9b46b05ae33dea97a84bfce1bd5dc1abbc7b33cbc3506d
+SHA512:
+  metadata.gz: c5b588f4859b3a44543ee2c60f961efffe9829e6065f37d78cd0be09dd53587a707c32a6686876b684700348ff73246377ad9fbc91f07a5623ba6782f4e15696
+  data.tar.gz: 1e66134660ea5509ef3278e0c9a5edbcb7759db66fb602c4f30c78addc4dfc18f96a0284f3a604808ee3123ef91c1a213d8fa331d092dc8798ee7a5cfbbf28f7

data/CHANGELOG.md

@@ -0,0 +1,7 @@
+# Changelog
+
+## [Unreleased]
+
+## [0.1.0] - 2026-09-23
+
+- Initial release.

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2026 ydah
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.md

@@ -0,0 +1,83 @@
+# metaco-ext
+
+[![Gem version](https://badge.fury.io/rb/metaco-ext.svg)](https://rubygems.org/gems/metaco-ext)
+[![Downloads](https://img.shields.io/gem/dt/metaco-ext?label=downloads)](https://rubygems.org/gems/metaco-ext)
+[![CI](https://github.com/rbgfx/metaco-ext/actions/workflows/ci.yml/badge.svg)](https://github.com/rbgfx/metaco-ext/actions/workflows/ci.yml)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D3.1-CC342D?logo=ruby&logoColor=white)](https://www.ruby-lang.org/)
+[![License](https://img.shields.io/badge/license-MIT-750014.svg)](LICENSE.txt)
+
+> Small Ruby adapters for metaco textures, pixels, events, and resize data.
+
+metaco-ext adds the Ruby-side helpers that sit next to the native
+[metaco](https://github.com/rbgfx/metaco) API. Resource methods delegate to
+metaco, while event helpers provide a stable, normalized shape for graphics
+applications.
+
+**[Features](#features) · [Installation](#installation) · [Quick start](#quick-start) · [Requirements](#requirements) · [Development](#development)**
+
+## Features
+
+- Texture create, update, bind, and destroy helpers.
+- Compute and framebuffer pixel readback delegation.
+- Frozen, symbol-keyed event normalization.
+- Logical and framebuffer dimensions in resize events.
+- No in-memory substitute for native texture resources.
+
+## Installation
+
+Add both gems to your Gemfile:
+
+~~~ruby
+gem "metaco"
+gem "metaco-ext"
+~~~
+
+Then run:
+
+~~~sh
+bundle install
+~~~
+
+Or install the released extension:
+
+~~~sh
+gem install metaco-ext
+~~~
+
+## Quick start
+
+~~~ruby
+require "metaco/ext"
+
+resize = Metaco::Ext.resize_event(
+  width: 800,
+  height: 450,
+  framebuffer_width: 1600,
+  framebuffer_height: 900
+)
+
+puts resize[:framebuffer_width]
+~~~
+
+Native texture operations require a metaco build with texture support:
+
+~~~ruby
+texture = Metaco::Ext.texture_create(handle, 2, 2, rgba_bytes)
+Metaco::Ext.bind_compute_texture(handle, 0, texture)
+~~~
+
+## Requirements
+
+Native Metal calls are available on macOS only. Calling a resource method
+without a compatible metaco installation raises <code>LoadError</code>.
+
+## Development
+
+~~~sh
+bundle install
+bundle exec rake verify
+~~~
+
+## License
+
+[MIT](LICENSE.txt)

data/Rakefile

@@ -0,0 +1,9 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "rspec/core/rake_task"
+
+RSpec::Core::RakeTask.new(:spec)
+
+task default: :spec
+task verify: :spec

data/lib/metaco/ext/version.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+module Metaco
+  module Ext
+    VERSION = "0.1.0"
+  end
+end

data/lib/metaco/ext.rb

@@ -0,0 +1,46 @@
+# frozen_string_literal: true
+
+require_relative "ext/version"
+
+module Metaco
+  module Ext
+    module_function
+
+    def texture_create(handle, width, height, bytes, **options)
+      native.texture_create(handle, width, height, bytes, **options)
+    end
+
+    def texture_update(texture, bytes)
+      native.texture_update(texture, bytes)
+    end
+
+    def texture_destroy(texture)
+      native.texture_destroy(texture)
+    end
+
+    def bind_compute_texture(handle, index, texture)
+      native.bind_compute_texture(handle, index, texture)
+    end
+
+    def read_pixels(handle, source: :compute)
+      native.read_pixels(handle, source: source)
+    end
+
+    def normalize_event(event)
+      event = event.transform_keys(&:to_sym)
+      event[:modifiers] = Array(event[:modifiers]).map(&:to_sym).freeze if event.key?(:modifiers)
+      event.freeze
+    end
+
+    def resize_event(width:, height:, framebuffer_width: width, framebuffer_height: height)
+      normalize_event(type: :resize, width: width, height: height, framebuffer_width: framebuffer_width, framebuffer_height: framebuffer_height)
+    end
+
+    def native
+      require "metaco" unless Metaco.respond_to?(:texture_create)
+      raise LoadError, "metaco with texture support is required" unless Metaco.respond_to?(:texture_create)
+      Metaco
+    end
+    private_class_method :native
+  end
+end

data/sig/metaco/ext.rbs

@@ -0,0 +1,6 @@
+module Metaco
+  module Ext
+    VERSION: String
+    # See the writing guide of rbs: https://github.com/ruby/rbs#guides
+  end
+end

metadata

@@ -0,0 +1,49 @@
+--- !ruby/object:Gem::Specification
+name: metaco-ext
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- ydah
+bindir: exe
+cert_chain: []
+date: 1980-01-02 00:00:00.000000000 Z
+dependencies: []
+description: Validated texture, pixel, event, and resize adapters for metaco.
+email:
+- t.yudai92@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CHANGELOG.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- lib/metaco/ext.rb
+- lib/metaco/ext/version.rb
+- sig/metaco/ext.rbs
+homepage: https://github.com/rbgfx/metaco-ext
+licenses:
+- MIT
+metadata:
+  homepage_uri: https://github.com/rbgfx/metaco-ext
+  source_code_uri: https://github.com/rbgfx/metaco-ext/tree/main
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.1.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 4.0.16
+specification_version: 4
+summary: Ruby helpers for metaco resources and events
+test_files: []