rays-video 0.1.2

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 5cb509bb4eb254fc941b27cf407d366a6ff89bee5f2393056ef846f9771f6888
+  data.tar.gz: 7e666166ba3371544280889621ddcf24f4c5474317a7523393fc7eb29acf4315
+SHA512:
+  metadata.gz: ae9ca108005e2729028cfa31f721ea729cc608dc6ad228c51b90b564379ecd4e821b15ae6dd8812088b2e288fd2e1187fa033b0fcdf43dae0ef228eaf3ab8d54
+  data.tar.gz: a5839a31f749ea2daa8f6af8e421149e2c3ab5f7fa1a6a1eacdbcf7a9a4dda523ead71e95ca291c2a49080d10a08709b3a47dfc821e9ee5e35e4a8ac6a727b70

data/.doc/ext/rays-video/native.cpp

@@ -0,0 +1,17 @@
+#include "defs.h"
+
+
+void Init_rays_video ();
+
+
+extern "C" void
+Init_rays_video_ext ()
+{
+	RUCY_TRY
+
+	Rucy::init();
+
+	Init_rays_video();
+
+	RUCY_CATCH
+}

data/.doc/ext/rays-video/video.cpp

@@ -0,0 +1,257 @@
+#include "rays-video/ruby/video.h"
+
+
+#include "rays/ruby/image.h"
+#include "defs.h"
+
+
+RUCY_DEFINE_VALUE_FROM_TO(RAYS_VIDEO_EXPORT, Rays::Video)
+
+#define THIS  to<Rays::Video*>(self)
+
+#define CHECK RUCY_CHECK_OBJECT(Rays::Video, self)
+
+
+static
+VALUE alloc(VALUE klass)
+{
+	return new_type<Rays::Video>(klass);
+}
+
+static
+VALUE initialize(VALUE self, VALUE width, VALUE height, VALUE fps, VALUE pixel_density)
+{
+	RUCY_CHECK_OBJ(Rays::Video, self);
+
+	float fps_ = to<float>(fps);
+	*THIS = Rays::Video(
+		to<int>(width),
+		to<int>(height),
+		fps_ > 0 ? fps_ : (float) Rays::Video::DEFAULT_FPS,
+		to<float>(pixel_density));
+}
+
+static
+VALUE initialize_copy(VALUE self, VALUE obj)
+{
+	RUCY_CHECK_OBJ(Rays::Video, self);
+
+	*THIS = to<Rays::Video&>(obj).dup();
+}
+
+static
+VALUE insert(VALUE self, VALUE index, VALUE image)
+{
+	CHECK;
+	THIS->insert(to<size_t>(index), to<const Rays::Image&>(image));
+	return self;
+}
+
+static
+VALUE append(VALUE self, VALUE image)
+{
+	CHECK;
+	THIS->append(to<const Rays::Image&>(image));
+	return self;
+}
+
+static
+VALUE remove(VALUE self, VALUE index)
+{
+	CHECK;
+	THIS->remove(to<size_t>(index));
+	return self;
+}
+
+static
+VALUE save(VALUE self, VALUE path)
+{
+	CHECK;
+	THIS->save(path.c_str());
+	return self;
+}
+
+static
+VALUE width(VALUE self)
+{
+	CHECK;
+	return value(THIS->width());
+}
+
+static
+VALUE height(VALUE self)
+{
+	CHECK;
+	return value(THIS->height());
+}
+
+static
+VALUE fps(VALUE self)
+{
+	CHECK;
+	return value(THIS->fps());
+}
+
+static
+VALUE pixel_density(VALUE self)
+{
+	CHECK;
+	return value(THIS->pixel_density());
+}
+
+static
+VALUE size(VALUE self)
+{
+	CHECK;
+	return value(THIS->size());
+}
+
+static
+VALUE empty(VALUE self)
+{
+	CHECK;
+	return value(THIS->empty());
+}
+
+static
+VALUE set_position(VALUE self, VALUE position)
+{
+	CHECK;
+	THIS->set_position(to<size_t>(position));
+	return position;
+}
+
+static
+VALUE get_position(VALUE self)
+{
+	CHECK;
+	return value(THIS->position());
+}
+
+static
+VALUE each(VALUE self)
+{
+	CHECK;
+	Value ret;
+	for (auto it = THIS->begin(), end = THIS->end(); it != end; ++it)
+		ret = rb_yield(value(*it));
+	return ret;
+}
+
+static
+VALUE to_image(VALUE self)
+{
+	CHECK;
+	return value((Rays::Image) *THIS);
+}
+
+static
+VALUE at(VALUE self, VALUE index)
+{
+	CHECK;
+	return value((*THIS)[(size_t) to<int>(index)]);
+}
+
+static
+VALUE play(VALUE self)
+{
+	CHECK;
+	THIS->play();
+	return self;
+}
+
+static
+VALUE pause(VALUE self)
+{
+	CHECK;
+	THIS->pause();
+	return self;
+}
+
+static
+VALUE stop(VALUE self)
+{
+	CHECK;
+	THIS->stop();
+	return self;
+}
+
+static
+VALUE set_time_scale(VALUE self, VALUE scale)
+{
+	CHECK;
+	THIS->set_time_scale(to<float>(scale));
+	return scale;
+}
+
+static
+VALUE get_time_scale(VALUE self)
+{
+	CHECK;
+	return value(THIS->time_scale());
+}
+
+static
+VALUE load(VALUE self, VALUE path)
+{
+	return value(Rays::load_video(path.c_str()));
+}
+
+static
+VALUE exts(VALUE self)
+{
+	std::vector<Value> list;
+	for (const auto& ext : Rays::get_video_exts())
+		list.emplace_back(ext.c_str());
+	return array(list.data(), list.size());
+}
+
+
+static Class cVideo;
+
+void
+Init_rays_video ()
+{
+	Module mRays = rb_define_module("Rays");
+
+	cVideo = rb_define_class_under(mRays, "Video", rb_cObject);
+	rb_define_alloc_func(cVideo, alloc);
+	cVideo.define_private_method("initialize!",     initialize);
+	rb_define_private_method(cVideo, "initialize_copy", RUBY_METHOD_FUNC(initialize_copy), 1);
+	cVideo.define_method("insert!", insert);
+	cVideo.define_method("append!", append);
+	cVideo.define_method("remove!", remove);
+	rb_define_method(cVideo, "save", RUBY_METHOD_FUNC(save), 1);
+	rb_define_method(cVideo, "width", RUBY_METHOD_FUNC(width), 0);
+	rb_define_method(cVideo, "height", RUBY_METHOD_FUNC(height), 0);
+	rb_define_method(cVideo, "fps", RUBY_METHOD_FUNC(fps), 0);
+	rb_define_method(cVideo, "pixel_density", RUBY_METHOD_FUNC(pixel_density), 0);
+	rb_define_method(cVideo, "size", RUBY_METHOD_FUNC(size), 0);
+	cVideo.define_method("empty?",        empty);
+	rb_define_method(cVideo, "position=", RUBY_METHOD_FUNC(set_position), 1);
+	rb_define_method(cVideo, "position", RUBY_METHOD_FUNC(get_position), 0);
+	rb_define_method(cVideo, "play", RUBY_METHOD_FUNC(play), 0);
+	rb_define_method(cVideo, "pause", RUBY_METHOD_FUNC(pause), 0);
+	rb_define_method(cVideo, "stop", RUBY_METHOD_FUNC(stop), 0);
+	rb_define_method(cVideo, "time_scale=", RUBY_METHOD_FUNC(set_time_scale), 1);
+	rb_define_method(cVideo, "time_scale", RUBY_METHOD_FUNC(get_time_scale), 0);
+	cVideo.define_method("each!", each);
+	rb_define_method(cVideo, "to_image", RUBY_METHOD_FUNC(to_image), 0);
+	cVideo.define_method("[]", at);
+	rb_define_module_function(cVideo, "load", RUBY_METHOD_FUNC(load), 1);
+	rb_define_module_function(cVideo, "exts", RUBY_METHOD_FUNC(exts), 0);
+}
+
+
+namespace Rays
+{
+
+
+	Class
+	video_class ()
+	{
+		return cVideo;
+	}
+
+
+}// Rays

data/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,12 @@
+## Pull Requests Not Accepted 🚫
+
+Thank you for your interest in contributing!
+However, this repository does not accept pull requests directly.
+
+### Where to Contribute?
+
+Please submit your changes to the [xord/all](https://github.com/xord/all) monorepo, which serves as the primary repository for all our main libraries.
+
+For more details, please refer to our [contribution guidelines](../CONTRIBUTING.md).
+
+Thanks for your understanding! 🙌

data/.github/workflows/release-gem.yml

@@ -0,0 +1,51 @@
+name: Release Gem
+
+on:
+  push:
+    tags: ['v[0-9]*']
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: macos-latest
+
+    steps:
+      - name: ruby 3.2
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: setup gems
+        run: bundle install
+
+      - name: setup dependencies
+        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies'"
+
+      - name: test
+        run: bundle exec rake packages test
+
+      - name: create gem
+        id: gem
+        run: |
+          bundle exec rake gem
+          echo path=$(ruby -e 'print Dir.glob("*.gem").first') >> $GITHUB_OUTPUT
+
+      - name: create github release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        run: ruby -I.github/workflows -rutils -e 'release(*ARGV)' ./${{ steps.gem.outputs.path }}
+
+      - name: upload to rubygems
+        env:
+          GEM_HOST_API_KEY: ${{ secrets.RUBYGEMS_AUTH_TOKEN }}
+        run: |
+          mkdir -p $HOME/.gem
+          touch $HOME/.gem/credentials
+          chmod 0600 $HOME/.gem/credentials
+          printf -- "---\n:rubygems_api_key: ${GEM_HOST_API_KEY}\n" > $HOME/.gem/credentials
+          bundle exec rake upload

data/.github/workflows/tag.yml

@@ -0,0 +1,35 @@
+name: Tag
+
+on:
+  push:
+    branches: [master]
+
+jobs:
+  tag:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: ruby 3.2
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+
+      - name: checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          token: ${{ secrets.PAT }}
+
+      - name: setup dependencies
+        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies only: :xot'"
+
+      - name: setup user name and email
+        run: |
+          git config --global user.email "xordog@gmail.com"
+          git config --global user.name "xord"
+
+      - name: tag versions
+        run: "ruby -I.github/workflows -rutils -e 'tag_versions'"
+
+      - name: push tags
+        run: git push origin --tags

data/.github/workflows/test.yml

@@ -0,0 +1,37 @@
+name: Test
+
+on:
+  push:
+    branches: [master]
+  pull_request:
+
+jobs:
+  test:
+    runs-on: macos-latest
+
+    steps:
+      - name: ruby 3.2
+        uses: ruby/setup-ruby@v1
+        with:
+          ruby-version: 3.2
+
+      - name: checkout
+        uses: actions/checkout@v4
+
+      - name: setup gems
+        run: bundle install
+
+      - name: setup dependencies
+        run: "ruby -I.github/workflows -rutils -e 'setup_dependencies'"
+
+      - name: packages
+        run: bundle exec rake verbose packages
+
+      - name: lib
+        run: bundle exec rake verbose lib
+
+      - name: ext
+        run: bundle exec rake verbose ext
+
+      - name: test
+        run: bundle exec rake verbose test

data/.github/workflows/utils.rb

@@ -0,0 +1,127 @@
+require 'shellwords'
+
+ALL_REPO        = 'xord/all'
+ALL_DIR         = '../all'
+ALL_FETCH_DEPTH = 100
+
+RENAMES = {reflex: 'reflexion'}
+
+def sh(cmd)
+  puts cmd
+  system cmd
+end
+
+def setup_dependencies(only: nil)
+  gemspec_path = `git ls-files`.lines(chomp: true).find {|l| l =~ /\.gemspec$/}
+  return unless gemspec_path
+
+  gemspec = File.read gemspec_path
+  name    = File.basename gemspec_path, '.gemspec'
+
+  exts = File.readlines('Rakefile')
+    .map {|l| l[%r|^\s*require\W+([\w\-\_]+)/extension\W+$|, 1]}
+    .compact
+    .reject {|ext| ext == name}
+  exts = exts & [only].flatten.map(&:to_s) if only
+  return if exts.empty?
+
+  unless setup_dependencies_via_monorepo(exts)
+    setup_dependencies_via_each_repo_by_version(gemspec, exts)
+  end
+
+  exts.each {|ext| sh %( cd ../#{ext} && rake ext )}
+end
+
+def setup_dependencies_via_monorepo(exts)
+  return false unless checkout_monorepo
+  exts.each {|ext| sh %( ln -snf all/#{ext} ../#{ext} )}
+  true
+end
+
+def checkout_monorepo()
+  uuid = `git log -1 --format=%B`[/^\[\[([0-9a-fA-F-]+)\]\]$/, 1]
+  return false unless uuid
+
+  commit = setup_monorepo uuid
+  return false unless commit
+
+  Dir.chdir(ALL_DIR) {sh %( git checkout -q #{commit} )}
+  true
+end
+
+def setup_monorepo(uuid)
+  unless File.directory? ALL_DIR
+    url = "https://github.com/#{ALL_REPO}.git"
+    sh %( git clone --no-tags --depth #{ALL_FETCH_DEPTH} #{url} #{ALL_DIR} )
+  end
+  loop do
+    commit = find_monorepo_commit uuid
+    return commit if commit
+
+    deepened = Dir.chdir ALL_DIR do
+      before = `git rev-list --count HEAD`.to_i
+      sh %( git fetch --deepen #{ALL_FETCH_DEPTH} )
+      `git rev-list --count HEAD`.to_i > before
+    end
+    return nil unless deepened
+  end
+end
+
+def find_monorepo_commit(uuid)
+  Dir.chdir ALL_DIR do
+    out = `git log origin/HEAD -F --grep="[[#{uuid}]]" --format=%H -1`.strip
+    out.empty? ? nil : out
+  end
+end
+
+def setup_dependencies_via_each_repo_by_version(gemspec, exts)
+  exts.each do |ext|
+    gem   = RENAMES[ext.to_sym].then {|s| s || ext}
+    ver   = gemspec[/add_dependency.*['"]#{gem}['"].*['"]\s*~>\s*([\d\.]+)\s*['"]/, 1]
+    opts  = '-c advice.detachedHead=false --depth 1'
+    clone = "git clone #{opts} https://github.com/xord/#{ext}.git ../#{ext}"
+
+    # 'rake subtree:push' pushes all subrepos, so cloning by new tag
+    # often fails before tagging each new tag
+    sh %( #{clone} --branch v#{ver} || #{clone} )
+  end
+end
+
+def tag_versions()
+  changes = changelogs
+  tags    = `git tag`.lines chomp: true
+  vers    = `git log --oneline ./VERSION`
+    .lines(chomp: true)
+    .map {|line| line.split.first[/^\w+$/]}
+    .map {|sha| [`git cat-file -p #{sha}:./VERSION 2>/dev/null`[/[\d\.]+/], sha]}
+    .select {|ver, sha| ver && sha}
+    .reverse
+    .to_h
+
+  vers.to_a.reverse.each do |ver, sha|
+    tag = "v#{ver}"
+    break if tags.include?(tag)
+    sh %( git tag -a -m \"#{changes[tag]&.gsub '"', '\\"'}\" #{tag} #{sha} )
+  end
+end
+
+def release(*paths)
+  tag   = ENV['GITHUB_REF']&.sub(%r|^refs/tags/|, '') || raise('GITHUB_REF tag not set')
+  notes = (changelogs[tag] || '').shellescape
+  paths = paths.flatten.join ' '
+
+  sh(%( gh release create #{tag} #{paths} --notes #{notes} )) ||
+    sh(%( gh release upload #{tag} #{paths} --clobber )) ||
+    raise('failed to upload to releases')
+end
+
+def changelogs()
+  File.read('ChangeLog.md')
+    .split(/^\s*##\s*\[\s*(v[\d\.]+)\s*\].*$/)
+    .slice(1..)
+    .each_slice(2)
+    .to_h
+    .transform_values(&:strip!)
+rescue Errno::ENOENT
+  raise 'failed to get changelogs'
+end

data/CONTRIBUTING.md

@@ -0,0 +1,7 @@
+# Contribution Guide
+
+Thank you for your interest in contributing!
+However, this repository does not accept pull requests.
+Instead, please submit your changes to the [xord/all](https://github.com/xord/all) monorepo, which serves as the primary repository for all our main libraries.
+
+For any questions, feel free to open an issue.

data/ChangeLog.md

@@ -0,0 +1,19 @@
+# rays-video ChangeLog
+
+
+## [v0.1.2] - 2026-05-17
+
+- Rewrite README.md
+- Add PR template
+- CI: Migrate release-gem.yml from actions/create-release to gh release create
+
+
+## [v0.1.1] - 2026-05-10
+
+- Add VideoAudioIn to support audio playback in Video class
+- Remove deprecated has_rdoc= from gemspecs
+
+
+## [v0.1] - 2026-04-23
+
+- Initial version

data/Gemfile

@@ -0,0 +1,5 @@
+source 'https://rubygems.org'
+
+gem 'rake'
+gem 'test-unit'
+gem 'yard'

data/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 xordog
+
+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.