voxelamming 0.2.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: fd127d3be01c9626c89f8c30261e386d693f003e4fd5d98ada6e429d768d64df
+  data.tar.gz: 424aaa454b52aeee6fd8a4d2c986422e31824e1e66949d4d4dedf94806038799
+SHA512:
+  metadata.gz: 8affe5c143e5f915ff5d19bf9763c01474ea091431c3d77e62dc0d2b2728cbe8f19e03dcd74a5b86f6460baac0a1f157a57929debacc9d92e38918b81ab300a9
+  data.tar.gz: 9705d0420d514da88f9551ccdb74b06f5260fbb18afef47f89fe74589917897e85aa5c84560388a24c3f7b017da0d3681d63e94edabfb9cd5a87743a702e4608

data/CODE_OF_CONDUCT.md

@@ -0,0 +1,132 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+We as members, contributors, and leaders pledge to make participation in our
+community a harassment-free experience for everyone, regardless of age, body
+size, visible or invisible disability, ethnicity, sex characteristics, gender
+identity and expression, level of experience, education, socio-economic status,
+nationality, personal appearance, race, caste, color, religion, or sexual
+identity and orientation.
+
+We pledge to act and interact in ways that contribute to an open, welcoming,
+diverse, inclusive, and healthy community.
+
+## Our Standards
+
+Examples of behavior that contributes to a positive environment for our
+community include:
+
+* Demonstrating empathy and kindness toward other people
+* Being respectful of differing opinions, viewpoints, and experiences
+* Giving and gracefully accepting constructive feedback
+* Accepting responsibility and apologizing to those affected by our mistakes,
+  and learning from the experience
+* Focusing on what is best not just for us as individuals, but for the overall
+  community
+
+Examples of unacceptable behavior include:
+
+* The use of sexualized language or imagery, and sexual attention or advances of
+  any kind
+* Trolling, insulting or derogatory comments, and personal or political attacks
+* Public or private harassment
+* Publishing others' private information, such as a physical or email address,
+  without their explicit permission
+* Other conduct which could reasonably be considered inappropriate in a
+  professional setting
+
+## Enforcement Responsibilities
+
+Community leaders are responsible for clarifying and enforcing our standards of
+acceptable behavior and will take appropriate and fair corrective action in
+response to any behavior that they deem inappropriate, threatening, offensive,
+or harmful.
+
+Community leaders have the right and responsibility to remove, edit, or reject
+comments, commits, code, wiki edits, issues, and other contributions that are
+not aligned to this Code of Conduct, and will communicate reasons for moderation
+decisions when appropriate.
+
+## Scope
+
+This Code of Conduct applies within all community spaces, and also applies when
+an individual is officially representing the community in public spaces.
+Examples of representing our community include using an official email address,
+posting via an official social media account, or acting as an appointed
+representative at an online or offline event.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported to the community leaders responsible for enforcement at
+[INSERT CONTACT METHOD].
+All complaints will be reviewed and investigated promptly and fairly.
+
+All community leaders are obligated to respect the privacy and security of the
+reporter of any incident.
+
+## Enforcement Guidelines
+
+Community leaders will follow these Community Impact Guidelines in determining
+the consequences for any action they deem in violation of this Code of Conduct:
+
+### 1. Correction
+
+**Community Impact**: Use of inappropriate language or other behavior deemed
+unprofessional or unwelcome in the community.
+
+**Consequence**: A private, written warning from community leaders, providing
+clarity around the nature of the violation and an explanation of why the
+behavior was inappropriate. A public apology may be requested.
+
+### 2. Warning
+
+**Community Impact**: A violation through a single incident or series of
+actions.
+
+**Consequence**: A warning with consequences for continued behavior. No
+interaction with the people involved, including unsolicited interaction with
+those enforcing the Code of Conduct, for a specified period of time. This
+includes avoiding interactions in community spaces as well as external channels
+like social media. Violating these terms may lead to a temporary or permanent
+ban.
+
+### 3. Temporary Ban
+
+**Community Impact**: A serious violation of community standards, including
+sustained inappropriate behavior.
+
+**Consequence**: A temporary ban from any sort of interaction or public
+communication with the community for a specified period of time. No public or
+private interaction with the people involved, including unsolicited interaction
+with those enforcing the Code of Conduct, is allowed during this period.
+Violating these terms may lead to a permanent ban.
+
+### 4. Permanent Ban
+
+**Community Impact**: Demonstrating a pattern of violation of community
+standards, including sustained inappropriate behavior, harassment of an
+individual, or aggression toward or disparagement of classes of individuals.
+
+**Consequence**: A permanent ban from any sort of public interaction within the
+community.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage],
+version 2.1, available at
+[https://www.contributor-covenant.org/version/2/1/code_of_conduct.html][v2.1].
+
+Community Impact Guidelines were inspired by
+[Mozilla's code of conduct enforcement ladder][Mozilla CoC].
+
+For answers to common questions about this code of conduct, see the FAQ at
+[https://www.contributor-covenant.org/faq][FAQ]. Translations are available at
+[https://www.contributor-covenant.org/translations][translations].
+
+[homepage]: https://www.contributor-covenant.org
+[v2.1]: https://www.contributor-covenant.org/version/2/1/code_of_conduct.html
+[Mozilla CoC]: https://github.com/mozilla/diversity
+[FAQ]: https://www.contributor-covenant.org/faq
+[translations]: https://www.contributor-covenant.org/translations

data/LICENSE.txt

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2024 creativival
+
+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,95 @@
+# VoxelammingGem
+
+This Ruby package converts Python code into JSON format and sends it to the Voxelamming app using WebSockets, allowing users to create 3D voxel models by writing Ruby scripts.
+
+## What's Voxelamming?
+
+<p align="center"><img src="https://creativival.github.io/voxelamming/image/voxelamming_icon.png" alt="Voxelamming Logo" width="200"/></p>
+
+Voxelamming is an AR programming learning app. Even programming beginners can learn programming visually and enjoyably. Voxelamming supports iPhones and iPads with iOS 16 or later, and Apple Vision Pro.
+
+## Resources
+
+* **Homepage:** https://creativival.github.io/voxelamming/index.en
+* **Samples:** https://github.com/creativival/voxelamming/tree/main/sample/ruby
+
+
+## Installation
+
+```bash
+gem install voxelamming
+```
+
+## Usage
+
+```ruby
+require 'voxelamming'
+
+room_name = '1000'
+build_box = Voxelamming::BuildBox.new(room_name)
+
+build_box.set_box_size(0.5)
+build_box.set_build_interval(0.01)
+
+for i in 0...100
+  build_box.create_box(-1, i, 0, r: 0, g: 1, b: 1)
+  build_box.create_box(0, i, 0, r: 1, g: 0, b: 0)
+  build_box.create_box(1, i, 0, r: 1, g: 1, b: 0)
+  build_box.create_box(2, i, 0, r: 0, g: 1, b: 1)
+end
+
+for i in 0...50
+  build_box.remove_box(0, i * 2, 0)
+  build_box.remove_box(1, i * 2 + 1, 0)
+end
+
+build_box.send_data
+```
+
+This code snippet demonstrates a simple example where a red voxel is created at a specific location. You can use various functions provided by the `BuildBox` class to build more complex models.
+
+#### Method description
+
+| Method name | Description | Arguments |
+|---|---|---|
+| `set_room_name(room_name)` | Sets the room name for communicating with the device. | `room_name`: Room name (string) |
+| `set_box_size(size)` | Sets the size of the voxel (default: 1.0). | `size`: Size (float) |
+| `set_build_interval(interval)` | Sets the placement interval of the voxels (default: 0.01 seconds). | `interval`: Interval (float) |
+| `change_shape(shape)` | Changes the shape of the voxel. | `shape`: Shape ("box", "square", "plane") |
+| `change_material(is_metallic, roughness)` | Changes the material of the voxel. | `is_metallic`: Whether to make it metallic (boolean), `roughness`: Roughness (float) |
+| `create_box(x, y, z, r, g, b, alpha)` | Places a voxel. | `x`, `y`, `z`: Position (float), `r`, `g`, `b`, `alpha`: Color (float, 0-1) |
+| `create_box(x, y, z, texture)` | Places a voxel with texture. | `x`, `y`, `z`: Position (float), `texture`: Texture name (string) |
+| `remove_box(x, y, z)` | Removes a voxel. | `x`, `y`, `z`: Position (float) |
+| `write_sentence(sentence, x, y, z, r, g, b, alpha)` | Draws a string with voxels. | `sentence`: String (string), `x`, `y`, `z`: Position (float), `r`, `g`, `b`, `alpha`: Color (float, 0-1) |
+| `set_light(x, y, z, r, g, b, alpha, intensity, interval, light_type)` | Places a light. | `x`, `y`, `z`: Position (float), `r`, `g`, `b`, `alpha`: Color (float, 0-1), `intensity`: Intensity (float), `interval`: Blinking interval (float), `light_type`: Type of light ("point", "spot", "directional") |
+| `set_command(command)` | Executes a command. | `command`: Command ("axis", "japaneseCastle", "float", "liteRender") |
+| `draw_line(x1, y1, z1, x2, y2, z2, r, g, b, alpha)` | Draws a line between two points. | `x1`, `y1`, `z1`: Starting point (float), `x2`, `y2`, `z2`: Ending point (float), `r`, `g`, `b`, `alpha`: Color (float, 0-1) |
+| `send_data(name)` | Sends voxel data to the device; if the name argument is set, the voxel data can be stored and reproduced as history. | |
+| `clear_data()` | Initializes voxel data. | |
+| `transform(x, y, z, pitch, yaw, roll)` | Moves and rotates the coordinate system of the voxel. | `x`, `y`, `z`: Translation amount (float), `pitch`, `yaw`, `roll`: Rotation amount (float) |
+| `animate(x, y, z, pitch, yaw, roll, scale, interval)` | Animates a voxel. | `x`, `y`, `z`: Translation amount (float), `pitch`, `yaw`, `roll`: Rotation amount (float), `scale`: Scale (float), `interval`: Interval (float) |
+| `animate_global(x, y, z, pitch, yaw, roll, scale, interval)` | Animates all voxels. | `x`, `y`, `z`: Translation amount (float), `pitch`, `yaw`, `roll`: Rotation amount (float), `scale`: Scale (float), `interval`: Interval (float) |
+| `push_matrix()` | Saves the current coordinate system to the stack. | |
+| `pop_matrix()` | Restores the coordinate system from the stack. | |
+| `frame_in()` | Starts recording a frame. | |
+| `frame_out()` | Ends recording a frame. | |
+| `set_frame_fps(fps)` | Sets the frame rate (default: 2). | `fps`: Frame rate (int) |
+| `set_frame_repeats(repeats)` | Sets the number of frame repetitions (default: 10). | `repeats`: Number of repetitions (int) |
+
+## Development
+
+After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
+
+To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and the created tag, and push the `.gem` file to [rubygems.org](https://rubygems.org).
+
+## Contributing
+
+Bug reports and pull requests are welcome on GitHub at https://github.com/creativival/voxelamming_ruby_gem. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [code of conduct](https://github.com/[USERNAME]/voxelamming_gem/blob/master/CODE_OF_CONDUCT.md).
+
+## License
+
+The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
+
+## Code of Conduct
+
+Everyone interacting in the VoxelammingGem project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the [code of conduct](https://github.com/[USERNAME]/voxelamming_gem/blob/master/CODE_OF_CONDUCT.md).

data/Rakefile

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+require "bundler/gem_tasks"
+require "minitest/test_task"
+
+Minitest::TestTask.create
+
+task default: :test

data/index.html

@@ -0,0 +1,139 @@
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="UTF-8">
+    <title>VoxelammingGem</title>
+    <style>
+        body {
+            font-family: sans-serif;
+            line-height: 1.6;
+            margin: 2rem auto;
+            max-width: 800px;
+            padding: 0 1rem;
+        }
+
+        h1, h2, h3 {
+            margin-top: 1.5rem;
+        }
+
+        a {
+            color: #0645ad;
+            text-decoration: none;
+        }
+
+        a:hover {
+            text-decoration: underline;
+        }
+
+        img {
+            max-width: 100%;
+            height: auto;
+        }
+
+        pre {
+            background-color: #f5f5f5;
+            border: 1px solid #ccc;
+            overflow-x: auto;
+            padding: 1rem;
+        }
+
+        code {
+            font-family: monospace;
+        }
+
+        table {
+            border-collapse: collapse;
+            width: 100%;
+        }
+
+        th, td {
+            border: 1px solid #ccc;
+            padding: 0.5rem;
+        }
+
+        th {
+            background-color: #f0f0f0;
+            font-weight: bold;
+        }
+    </style>
+</head>
+<body>
+<h1><a href="#voxelamminggem" id="voxelamminggem"></a>VoxelammingGem</h1>
+<p>This Ruby package converts Python code into JSON format and sends it to the Voxelamming app using WebSockets, allowing users to create 3D voxel models by writing Ruby scripts.</p>
+<h2><a href="#whats-voxelamming" id="whats-voxelamming"></a>What's Voxelamming?</h2>
+<p align="center"><img src="https://creativival.github.io/voxelamming/image/voxelamming_icon.png" alt="Voxelamming Logo" width="200"/></p>
+<p>Voxelamming is an AR programming learning app. Even programming beginners can learn programming visually and enjoyably. Voxelamming supports iPhones and iPads with iOS 16 or later, and Apple Vision Pro.</p>
+<h2><a href="#resources" id="resources"></a>Resources</h2>
+<ul>
+    <li><strong>Homepage:</strong> <a href="https://creativival.github.io/voxelamming/index.en">https://creativival.github.io/voxelamming/index.en</a></li>
+    <li><strong>Samples:</strong> <a href="https://github.com/creativival/voxelamming/tree/main/sample/ruby">https://github.com/creativival/voxelamming/tree/main/sample/ruby</a></li>
+</ul>
+<h2><a href="#installation" id="installation"></a>Installation</h2>
+<pre><code class="bash">gem install voxelamming
+</code></pre>
+<h2><a href="#usage" id="usage"></a>Usage</h2>
+<pre><code class="ruby">require 'voxelamming'
+
+room_name = '1000'
+build_box = Voxelamming::BuildBox.new(room_name)
+
+build_box.set_box_size(0.5)
+build_box.set_build_interval(0.01)
+
+for i in 0...100
+  build_box.create_box(-1, i, 0, r: 0, g: 1, b: 1)
+  build_box.create_box(0, i, 0, r: 1, g: 0, b: 0)
+  build_box.create_box(1, i, 0, r: 1, g: 1, b: 0)
+  build_box.create_box(2, i, 0, r: 0, g: 1, b: 1)
+end
+
+for i in 0...50
+  build_box.remove_box(0, i * 2, 0)
+  build_box.remove_box(1, i * 2 + 1, 0)
+end
+
+build_box.send_data
+</code></pre>
+<p>This code snippet demonstrates a simple example where a red voxel is created at a specific location. You can use various functions provided by the <code>BuildBox</code> class to build more complex models.</p>
+<h4><a href="#method-description" id="method-description"></a>Method description</h4>
+<table>
+    <thead>
+    <tr><th> Method name </th><th> Description </th><th> Arguments </th></tr>
+    </thead>
+    <tbody>
+    <tr><td> <code>set_room_name(room_name)</code> </td><td> Sets the room name for communicating with the device. </td><td> <code>room_name</code>: Room name (string) </td></tr>
+    <tr><td> <code>set_box_size(size)</code> </td><td> Sets the size of the voxel (default: 1.0). </td><td> <code>size</code>: Size (float) </td></tr>
+    <tr><td> <code>set_build_interval(interval)</code> </td><td> Sets the placement interval of the voxels (default: 0.01 seconds). </td><td> <code>interval</code>: Interval (float) </td></tr>
+    <tr><td> <code>change_shape(shape)</code> </td><td> Changes the shape of the voxel. </td><td> <code>shape</code>: Shape ("box", "square", "plane") </td></tr>
+    <tr><td> <code>change_material(is_metallic, roughness)</code> </td><td> Changes the material of the voxel. </td><td> <code>is_metallic</code>: Whether to make it metallic (boolean), <code>roughness</code>: Roughness (float) </td></tr>
+    <tr><td> <code>create_box(x, y, z, r, g, b, alpha)</code> </td><td> Places a voxel. </td><td> <code>x</code>, <code>y</code>, <code>z</code>: Position (float), <code>r</code>, <code>g</code>, <code>b</code>, <code>alpha</code>: Color (float, 0-1) </td></tr>
+    <tr><td> <code>create_box(x, y, z, texture)</code> </td><td> Places a voxel with texture. </td><td> <code>x</code>, <code>y</code>, <code>z</code>: Position (float), <code>texture</code>: Texture name (string) </td></tr>
+    <tr><td> <code>remove_box(x, y, z)</code> </td><td> Removes a voxel. </td><td> <code>x</code>, <code>y</code>, <code>z</code>: Position (float) </td></tr>
+    <tr><td> <code>write_sentence(sentence, x, y, z, r, g, b, alpha)</code> </td><td> Draws a string with voxels. </td><td> <code>sentence</code>: String (string), <code>x</code>, <code>y</code>, <code>z</code>: Position (float), <code>r</code>, <code>g</code>, <code>b</code>, <code>alpha</code>: Color (float, 0-1) </td></tr>
+    <tr><td> <code>set_light(x, y, z, r, g, b, alpha, intensity, interval, light_type)</code> </td><td> Places a light. </td><td> <code>x</code>, <code>y</code>, <code>z</code>: Position (float), <code>r</code>, <code>g</code>, <code>b</code>, <code>alpha</code>: Color (float, 0-1), <code>intensity</code>: Intensity (float), <code>interval</code>: Blinking interval (float), <code>light_type</code>: Type of light ("point", "spot", "directional") </td></tr>
+    <tr><td> <code>set_command(command)</code> </td><td> Executes a command. </td><td> <code>command</code>: Command ("axis", "japaneseCastle", "float", "liteRender") </td></tr>
+    <tr><td> <code>draw_line(x1, y1, z1, x2, y2, z2, r, g, b, alpha)</code> </td><td> Draws a line between two points. </td><td> <code>x1</code>, <code>y1</code>, <code>z1</code>: Starting point (float), <code>x2</code>, <code>y2</code>, <code>z2</code>: Ending point (float), <code>r</code>, <code>g</code>, <code>b</code>, <code>alpha</code>: Color (float, 0-1) </td></tr>
+    <tr><td> <code>send_data(name)</code> </td><td> Sends voxel data to the device; if the name argument is set, the voxel data can be stored and reproduced as history. </td><td> </td></tr>
+    <tr><td> <code>clear_data()</code> </td><td> Initializes voxel data. </td><td> </td></tr>
+    <tr><td> <code>transform(x, y, z, pitch, yaw, roll)</code> </td><td> Moves and rotates the coordinate system of the voxel. </td><td> <code>x</code>, <code>y</code>, <code>z</code>: Translation amount (float), <code>pitch</code>, <code>yaw</code>, <code>roll</code>: Rotation amount (float) </td></tr>
+    <tr><td> <code>animate(x, y, z, pitch, yaw, roll, scale, interval)</code> </td><td> Animates a voxel. </td><td> <code>x</code>, <code>y</code>, <code>z</code>: Translation amount (float), <code>pitch</code>, <code>yaw</code>, <code>roll</code>: Rotation amount (float), <code>scale</code>: Scale (float), <code>interval</code>: Interval (float) </td></tr>
+    <tr><td> <code>animate_global(x, y, z, pitch, yaw, roll, scale, interval)</code> </td><td> Animates all voxels. </td><td> <code>x</code>, <code>y</code>, <code>z</code>: Translation amount (float), <code>pitch</code>, <code>yaw</code>, <code>roll</code>: Rotation amount (float), <code>scale</code>: Scale (float), <code>interval</code>: Interval (float) </td></tr>
+    <tr><td> <code>push_matrix()</code> </td><td> Saves the current coordinate system to the stack. </td><td> </td></tr>
+    <tr><td> <code>pop_matrix()</code> </td><td> Restores the coordinate system from the stack. </td><td> </td></tr>
+    <tr><td> <code>frame_in()</code> </td><td> Starts recording a frame. </td><td> </td></tr>
+    <tr><td> <code>frame_out()</code> </td><td> Ends recording a frame. </td><td> </td></tr>
+    <tr><td> <code>set_frame_fps(fps)</code> </td><td> Sets the frame rate (default: 2). </td><td> <code>fps</code>: Frame rate (int) </td></tr>
+    <tr><td> <code>set_frame_repeats(repeats)</code> </td><td> Sets the number of frame repetitions (default: 10). </td><td> <code>repeats</code>: Number of repetitions (int) </td></tr>
+    </tbody>
+</table>
+<h2><a href="#development" id="development"></a>Development</h2>
+<p>After checking out the repo, run <code>bin/setup</code> to install dependencies. Then, run <code>rake test</code> to run the tests. You can also run <code>bin/console</code> for an interactive prompt that will allow you to experiment.</p>
+<p>To install this gem onto your local machine, run <code>bundle exec rake install</code>. To release a new version, update the version number in <code>version.rb</code>, and then run <code>bundle exec rake release</code>, which will create a git tag for the version, push git commits and the created tag, and push the <code>.gem</code> file to <a href="https://rubygems.org">rubygems.org</a>.</p>
+<h2><a href="#contributing" id="contributing"></a>Contributing</h2>
+<p>Bug reports and pull requests are welcome on GitHub at <a href="https://github.com/[USERNAME]/voxelamming_gem">https://github.com/[USERNAME]/voxelamming_gem</a>. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the <a href="https://github.com/[USERNAME]/voxelamming_gem/blob/master/CODE_OF_CONDUCT.md">code of conduct</a>.</p>
+<h2><a href="#license" id="license"></a>License</h2>
+<p>The gem is available as open source under the terms of the <a href="https://opensource.org/licenses/MIT">MIT License</a>.</p>
+<h2><a href="#code-of-conduct" id="code-of-conduct"></a>Code of Conduct</h2>
+<p>Everyone interacting in the VoxelammingGem project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the <a href="https://github.com/[USERNAME]/voxelamming_gem/blob/master/CODE_OF_CONDUCT.md">code of conduct</a>.</p>
+</body>
+</html>

data/lib/matrix_util.rb

@@ -0,0 +1,65 @@
+include Math
+
+def get_rotation_matrix(pitch, yaw, roll)
+  pitch, yaw, roll = [pitch, yaw, roll].map { |angle| degrees_to_radians(angle) }
+  # Pitch (Rotation around X-axis)
+  rx = [
+    [1, 0, 0],
+    [0, cos(pitch), -sin(pitch)],
+    [0, sin(pitch), cos(pitch)]
+  ]
+
+  # Yaw (Rotation around Y-axis)
+  ry = [
+    [cos(yaw), 0, sin(yaw)],
+    [0, 1, 0],
+    [-sin(yaw), 0, cos(yaw)]
+  ]
+
+  # Roll (Rotation around Z-axis)
+  rz = [
+    [cos(roll), -sin(roll), 0],
+    [sin(roll), cos(roll), 0],
+    [0, 0, 1]
+  ]
+
+  # Multiplication of matrices in the order Rx * Rz * Ry
+  r = matrix_multiply(rx, matrix_multiply(rz, ry))
+  return r
+end
+
+def matrix_multiply(a, b)
+  result = Array.new(3) { Array.new(3, 0) }
+  for i in 0...3
+    for j in 0...3
+      for k in 0...3
+        result[i][j] += a[i][k] * b[k][j]
+      end
+    end
+  end
+  return result
+end
+
+def transform_point_by_rotation_matrix(point, r)
+  x, y, z = point
+  x_new = r[0][0] * x + r[0][1] * y + r[0][2] * z
+  y_new = r[1][0] * x + r[1][1] * y + r[1][2] * z
+  z_new = r[2][0] * x + r[2][1] * y + r[2][2] * z
+  return [x_new, y_new, z_new]
+end
+
+def add_vectors(vector1, vector2)
+  vector1.zip(vector2).map { |v1, v2| v1 + v2 }
+end
+
+def transpose_3x3(matrix)
+  return [
+    [matrix[0][0], matrix[1][0], matrix[2][0]],
+    [matrix[0][1], matrix[1][1], matrix[2][1]],
+    [matrix[0][2], matrix[1][2], matrix[2][2]]
+  ]
+end
+
+def degrees_to_radians(degrees)
+  degrees * Math::PI / 180.0
+end

data/lib/voxelamming/version.rb

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

data/lib/voxelamming.rb

@@ -0,0 +1,549 @@
+# frozen_string_literal: true
+
+require_relative "voxelamming/version"
+require 'json'
+require 'faye/websocket'
+require 'eventmachine'
+require 'date'
+require_relative 'matrix_util'
+require 'csv'
+
+module Voxelamming
+  class Error < StandardError; end
+
+  # test
+  def self.greet(name)
+    puts "Hello, #{name}! I'm Ruby!"
+  end
+
+  # Main process
+  class BuildBox
+    @@texture_names = ["grass", "stone", "dirt", "planks", "bricks"]
+    @@model_names = ["Mercury", "Venus", "Earth", "Mars", "Jupiter", "Saturn", "Uranus", "Neptune", "Pluto", "Sun",
+                     "Moon", "ToyBiplane", "ToyCar", "Drummer", "Robot", "ToyRocket", "RocketToy1", "RocketToy2", "Skull"]
+
+    def initialize(room_name)
+      @room_name = room_name
+      @is_allowed_matrix = 0
+      @saved_matrices = []
+      @node_transform = [0, 0, 0, 0, 0, 0]
+      @matrix_transform = [0, 0, 0, 0, 0, 0]
+      @frame_transforms = []
+      @global_animation = [0, 0, 0, 0, 0, 0, 1, 0]
+      @animation = [0, 0, 0, 0, 0, 0, 1, 0]
+      @boxes = []
+      @frames = []
+      @sentence = []
+      @lights = []
+      @commands = []
+      @models = []
+      @model_moves = []
+      @size = 1
+      @shape = 'box'
+      @is_metallic = 0
+      @roughness = 0.5
+      @is_allowed_float = 0
+      @build_interval = 0.01
+      @is_framing = false
+      @frame_id = 0
+    end
+
+    def clear_data
+      @is_allowed_matrix = 0
+      @saved_matrices = []
+      @node_transform = [0, 0, 0, 0, 0, 0]
+      @matrix_transform = [0, 0, 0, 0, 0, 0]
+      @frame_transforms = []
+      @global_animation = [0, 0, 0, 0, 0, 0, 1, 0]
+      @animation = [0, 0, 0, 0, 0, 0, 1, 0]
+      @boxes = []
+      @frames = []
+      @sentence = []
+      @lights = []
+      @commands = []
+      @models = []
+      @model_moves = []
+      @size = 1
+      @shape = 'box'
+      @is_metallic = 0
+      @roughness = 0.5
+      @is_allowed_float = 0
+      @build_interval = 0.01
+      @is_framing = false
+      @frame_id = 0
+    end
+
+    def set_frame_fps(fps = 2)
+      @commands << "fps #{fps}"
+    end
+
+    def set_frame_repeats(repeats = 10)
+      @commands << "repeats #{repeats}"
+    end
+
+    def frame_in
+      @is_framing = true
+    end
+
+    def frame_out
+      @is_framing = false
+      @frame_id += 1
+    end
+
+    def push_matrix
+      @is_allowed_matrix += 1
+      @saved_matrices.push(@matrix_transform)
+    end
+
+    def pop_matrix
+      @is_allowed_matrix -= 1
+      @matrix_transform = @saved_matrices.pop
+    end
+
+    def transform(x, y, z, pitch: 0, yaw: 0, roll: 0)
+      if @is_allowed_matrix > 0
+        # 移動用のマトリックスを計算する
+        matrix = @saved_matrices.last
+        puts "before matrix: #{matrix}"
+        base_position = matrix[0..2]
+
+        if matrix.length == 6
+          base_rotation_matrix = get_rotation_matrix(matrix[3], matrix[4], matrix[5])
+        else
+          base_rotation_matrix = [matrix[3..5], matrix[6..8], matrix[9..11]]
+        end
+
+        # Compute the new position after transform
+        add_x, add_y, add_z = transform_point_by_rotation_matrix([x, y, z], transpose_3x3(base_rotation_matrix))
+        x, y, z = add_vectors(base_position, [add_x, add_y, add_z])
+        x, y, z = round_numbers([x, y, z])
+
+        # Compute the rotation after transform
+        translate_rotation_matrix = get_rotation_matrix(-pitch, -yaw, -roll)
+        rotate_matrix = matrix_multiply(translate_rotation_matrix, base_rotation_matrix)
+        @matrix_transform = [x, y, z, *rotate_matrix[0], *rotate_matrix[1], *rotate_matrix[2]]
+      else
+        x, y, z = round_numbers([x, y, z])
+
+        if @is_framing
+          @frame_transforms.append([x, y, z, pitch, yaw, roll, @frame_id])
+        else
+          @node_transform = [x, y, z, pitch, yaw, roll]
+        end
+      end
+    end
+
+    def create_box(x, y, z, r: 1, g: 1, b: 1, alpha: 1, texture: '')
+      if @is_allowed_matrix > 0
+        # 移動用のマトリックスにより位置を計算する
+        matrix = @matrix_transform
+        base_position = matrix[0..2]
+
+        if matrix.length == 6
+          base_rotation_matrix = get_rotation_matrix(matrix[3], matrix[4], matrix[5])
+        else
+          base_rotation_matrix = [matrix[3..5], matrix[6..8], matrix[9..11]]
+        end
+
+        # Compute the new position after transform
+        add_x, add_y, add_z = transform_point_by_rotation_matrix([x, y, z], transpose_3x3(base_rotation_matrix))
+        x, y, z = add_vectors(base_position, [add_x, add_y, add_z])
+      end
+
+      x, y, z = round_numbers([x, y, z])
+      r, g, b, alpha = round_two_decimals([r, g, b, alpha])
+
+      # 重ねておくことを防止
+      remove_box(x, y, z)
+      if !@@texture_names.include?(texture)
+        texture_id = -1
+      else
+        texture_id = @@texture_names.index(texture)
+      end
+
+      if @is_framing
+        @frames.append([x, y, z, r, g, b, alpha, texture_id, @frame_id])
+      else
+        @boxes.append([x, y, z, r, g, b, alpha, texture_id])
+      end
+    end
+
+    def remove_box(x, y, z)
+      x, y, z = round_numbers([x, y, z])
+
+      if @is_framing
+        @frames.reject! { |frame| frame[0] == x && frame[1] == y && frame[2] == z && frame[8] == @frame_id }
+      else
+        @boxes.reject! { |box| box[0] == x && box[1] == y && box[2] == z }
+      end
+    end
+
+    def animate_global(x, y, z, pitch: 0, yaw: 0, roll: 0, scale: 1, interval: 10)
+      x, y, z = round_numbers([x, y, z])
+      @global_animation = [x, y, z, pitch, yaw, roll, scale, interval]
+    end
+
+    def animate(x, y, z, pitch: 0, yaw: 0, roll: 0, scale: 1, interval: 10)
+      x, y, z = round_numbers([x, y, z])
+      @animation = [x, y, z, pitch, yaw, roll, scale, interval]
+    end
+
+    def set_box_size(box_size)
+      @size = box_size
+    end
+
+    def set_build_interval(interval)
+      @build_interval = interval
+    end
+
+    def write_sentence(sentence, x, y, z, r: 1, g: 1, b: 1, alpha: 1)
+      x, y, z = round_numbers([x, y, z]).map(&:to_s)
+      r, g, b, alpha = round_two_decimals([r, g, b, alpha])
+      r, g, b, alpha =  [r, g, b, alpha].map(&:floor).map(&:to_s)
+      @sentence = [sentence, x, y, z, r, g, b, alpha]
+    end
+
+    def set_light(x, y, z, r: 1, g: 1, b: 1, alpha: 1, intensity: 1000, interval: 1, light_type: 'point')
+      x, y, z = round_numbers([x, y, z])
+      r, g, b, alpha = round_two_decimals([r, g, b, alpha])
+
+      if light_type == 'point'
+        light_type = 1
+      elsif light_type == 'spot'
+        light_type = 2
+      elsif light_type == 'directional'
+        light_type = 3
+      else
+        light_type = 1
+      end
+      @lights << [x, y, z, r, g, b, alpha, intensity, interval, light_type]
+    end
+
+    def set_command(command)
+      @commands << command
+
+      if command == 'float'
+        @is_allowed_float = 1
+      end
+    end
+
+    def draw_line(x1, y1, z1, x2, y2, z2, r: 1, g: 1, b: 1, alpha: 1)
+      x1, y1, z1, x2, y2, z2 = [x1, y1, z1, x2, y2, z2].map(&:floor)
+      diff_x = x2 - x1
+      diff_y = y2 - y1
+      diff_z = z2 - z1
+      max_length = [diff_x.abs, diff_y.abs, diff_z.abs].max
+
+      return false if diff_x == 0 && diff_y == 0 && diff_z == 0
+
+      if diff_x.abs == max_length
+        if x2 > x1
+          (x1..x2).each do |x|
+            y = y1 + (x - x1) * diff_y.to_f / diff_x
+            z = z1 + (x - x1) * diff_z.to_f / diff_x
+            create_box(x, y, z, r: r, g: g, b: b, alpha: alpha)
+          end
+        else
+          x1.downto(x2 + 1) do |x|
+            y = y1 + (x - x1) * diff_y.to_f / diff_x
+            z = z1 + (x - x1) * diff_z.to_f / diff_x
+            create_box(x, y, z, r: r, g: g, b: b, alpha: alpha)
+          end
+        end
+      elsif diff_y.abs == max_length
+        if y2 > y1
+          (y1..y2).each do |y|
+            x = x1 + (y - y1) * diff_x.to_f / diff_y
+            z = z1 + (y - y1) * diff_z.to_f / diff_y
+            create_box(x, y, z, r: r, g: g, b: b, alpha: alpha)
+          end
+        else
+          y1.downto(y2 + 1) do |y|
+            x = x1 + (y - y1) * diff_x.to_f / diff_y
+            z = z1 + (y - y1) * diff_z.to_f / diff_y
+            create_box(x, y, z, r: r, g: g, b: b, alpha: alpha)
+          end
+        end
+      elsif diff_z.abs == max_length
+        if z2 > z1
+          (z1..z2).each do |z|
+            x = x1 + (z - z1) * diff_x.to_f / diff_z
+            y = y1 + (z - z1) * diff_y.to_f / diff_z
+            create_box(x, y, z, r: r, g: g, b: b, alpha: alpha)
+          end
+        else
+          z1.downto(z2 + 1) do |z|
+            x = x1 + (z - z1) * diff_x.to_f / diff_z
+            y = y1 + (z - z1) * diff_y.to_f / diff_z
+            create_box(x, y, z, r: r, g: g, b: b, alpha: alpha)
+          end
+        end
+      end
+    end
+
+    def change_shape(shape)
+      @shape = shape
+    end
+
+    def change_material(is_metallic: false, roughness: 0.5)
+      @is_metallic = is_metallic ? 1 : 0
+      @roughness = roughness
+    end
+
+    def create_model(model_name, x: 0, y: 0, z: 0, pitch: 0, yaw: 0, roll: 0, scale: 1, entity_name: '')
+      if @@model_names.include?(model_name)
+        x, y, z, pitch, yaw, roll, scale = round_two_decimals([x, y, z, pitch, yaw, roll, scale])
+        x, y, z, pitch, yaw, roll, scale = [x, y, z, pitch, yaw, roll, scale].map(&:to_s)
+
+        @models << [model_name, x, y, z, pitch, yaw, roll, scale, entity_name]
+      else
+        puts "No model name: #{model_name}"
+      end
+    end
+
+    def move_model(entity_name, x: 0, y: 0, z: 0, pitch: 0, yaw: 0, roll: 0, scale: 1)
+      x, y, z, pitch, yaw, roll, scale = round_two_decimals([x, y, z, pitch, yaw, roll, scale])
+      x, y, z, pitch, yaw, roll, scale = [x, y, z, pitch, yaw, roll, scale].map(&:to_s)
+
+      @model_moves << [entity_name, x, y, z, pitch, yaw, roll, scale]
+    end
+
+
+    def send_data(name: '')
+      puts 'send_data'
+      now = DateTime.now
+      data_to_send = {
+        "nodeTransform": @node_transform,
+        "frameTransforms": @frame_transforms,
+        "globalAnimation": @global_animation,
+        "animation": @animation,
+        "boxes": @boxes,
+        "frames": @frames,
+        "sentence": @sentence,
+        "lights": @lights,
+        "commands": @commands,
+        "models": @models,
+        "modelMoves": @model_moves,
+        "size": @size,
+        "shape": @shape,
+        "interval": @build_interval,
+        "isMetallic": @is_metallic,
+        "roughness": @roughness,
+        "isAllowedFloat": @is_allowed_float,
+        "name": name,
+        "date": now.to_s
+      }.to_json
+
+      EM.run do
+        ws = Faye::WebSocket::Client.new('wss://websocket.voxelamming.com')
+
+        ws.on :open do |_event|
+          p [:open]
+          puts 'WebSocket connection open'
+          ws.send(@room_name)
+          puts "Joined room: #{@room_name}"
+          ws.send(data_to_send)
+          puts data_to_send
+          puts 'Sent data to server'
+
+          EM.add_timer(1) do
+            ws.close
+            EM.stop
+          end
+        end
+
+        ws.on :error do |event|
+          puts "WebSocket error: #{event.message}"
+          EM.stop
+        end
+
+        ws.on :close do |_event|
+          puts 'WebSocket connection closed'
+          EM.stop
+        end
+      end
+    end
+
+    def round_numbers(num_list)
+      if @is_allowed_float == 1
+        round_two_decimals(num_list)
+      else
+        num_list.map { |val| val.round(1).floor }
+      end
+    end
+
+    def round_two_decimals(num_list)
+      num_list.map { |val| val.round(2) }
+    end
+  end
+
+  # Turtle graphics
+  class Turtle
+    include Math
+
+    def initialize(build_box)
+      @build_box = build_box
+      @x = 0
+      @y = 0
+      @z = 0
+      @polar_theta = 90
+      @polar_phi = 0
+      @drawable = true
+      @color = [0, 0, 0, 1]
+      @size = 1
+    end
+
+    def forward(length)
+      z = @z + length * sin(radians(@polar_theta)) * cos(radians(@polar_phi))
+      x = @x + length * sin(radians(@polar_theta)) * sin(radians(@polar_phi))
+      y = @y + length * cos(radians(@polar_theta))
+      x, y, z = x.round(3), y.round(3), z.round(3)
+
+      if @drawable
+        @build_box.draw_line(@x, @y, @z, x, y, z, r: @color[0], g: @color[1], b: @color[2])
+      end
+
+      @x = x
+      @y = y
+      @z = z
+    end
+
+    def backward(length)
+      forward(-length)
+    end
+
+    def up(degree)
+      @polar_theta -= degree
+    end
+
+    def down(degree)
+      @polar_theta += degree
+    end
+
+    def right(degree)
+      @polar_phi -= degree
+    end
+
+    def left(degree)
+      @polar_phi += degree
+    end
+
+    def set_color(r, g, b, alpha = 1)
+      @color = [r, g, b, alpha]
+    end
+
+    def pen_down
+      @drawable = true
+    end
+
+    def pen_up
+      @drawable = false
+    end
+
+    def set_pos(x, y, z)
+      @x = x
+      @y = y
+      @z = z
+    end
+
+    def reset
+      @x = 0
+      @y = 0
+      @z = 0
+      @polar_theta = 90
+      @polar_phi = 0
+      @drawable = true
+      @color = [0, 0, 0, 1]
+      @size = 1
+    end
+
+    private
+
+    def radians(degrees)
+      degrees * Math::PI / 180
+    end
+  end
+
+  # Make model
+  def self.get_boxes_from_ply(ply_file)
+    box_positions = Set.new
+    File.open(ply_file, 'r') do |f|
+      lines = f.read
+      lines = lines.gsub("\r\n", "\n")
+      lines = lines.strip
+      positions = lines.split("\n").select { |ln| self.is_included_six_numbers(ln) }.map { |ln| ln.split.map(&:to_f) }
+
+      number_of_faces = positions.length / 4
+      (0...number_of_faces).each do |i|
+        vertex1 = positions[i * 4]
+        vertex2 = positions[i * 4 + 1]
+        vertex3 = positions[i * 4 + 2]
+        vertex4 = positions[i * 4 + 3] # no need
+        x = [vertex1[0], vertex2[0], vertex3[0]].min
+        y = [vertex1[1], vertex2[1], vertex3[1]].min
+        z = [vertex1[2], vertex2[2], vertex3[2]].min
+        r = vertex1[3] / 255.0
+        g = vertex1[4] / 255.0
+        b = vertex1[5] / 255.0
+        alpha = 1
+
+        # ボックスを置く方向を解析
+        if vertex1[0] == vertex2[0] && vertex2[0] == vertex3[0] # y-z plane
+          step = [vertex1[1], vertex2[1], vertex3[1]].max - y
+          x -= step if vertex1[1] != vertex2[1]
+        elsif vertex1[1] == vertex2[1] && vertex2[1] == vertex3[1] # z-x plane
+          step = [vertex1[2], vertex2[2], vertex3[2]].max - z
+          y -= step if vertex1[2] != vertex2[2]
+        else # x-y plane
+          step = [vertex1[0], vertex2[0], vertex3[0]].max - x
+          z -= step if vertex1[0] != vertex2[0]
+        end
+
+        # minimum unit: 0.1
+        position_x = (x * 10.0 / step).round / 10.0
+        position_y = (y * 10.0 / step).round / 10.0
+        position_z = (z * 10.0 / step).round / 10.0
+        box_positions.add([position_x, position_z, -position_y, r, g, b, alpha])
+      end
+    end
+
+    box_positions
+  end
+
+  def self.is_included_six_numbers(line)
+    line_list = line.split
+    return false if line_list.length != 6
+
+    line_list.all? { |num| Float(num) rescue false }
+  end
+
+  # Map
+  def self.get_map_data_from_csv(csv_file, height_scale, column_num = 257, row_num = 257)
+    # csvファイルから地図データを読み込み
+    heights = []
+
+    CSV.foreach(csv_file) do |row|
+      for h in row
+        h = h.to_f
+        h = h != 0 ? (h * height_scale).floor : -1
+        heights << h
+      end
+    end
+    #   puts "heights: #{heights}"
+
+    max_height = heights.max.floor
+    box_positions = (0...row_num).map { |i| heights[i * column_num, column_num] }
+    puts "max_height: #{max_height}"
+    #   puts "box_positions: #{box_positions}"
+    { 'boxes' => box_positions, 'max_height' => max_height }
+  end
+
+  def self.get_box_color(height, max_height, high_color, low_color)
+    # 高さによって色を変える
+    r = (high_color[0] - low_color[0]) * height * 1.0 / max_height + low_color[0]
+    g = (high_color[1] - low_color[1]) * height * 1.0 / max_height + low_color[1]
+    b = (high_color[2] - low_color[2]) * height * 1.0 / max_height + low_color[2]
+
+    [r, g, b]
+  end
+end

data/sig/voxelamming.rbs

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

metadata

@@ -0,0 +1,74 @@
+--- !ruby/object:Gem::Specification
+name: voxelamming
+version: !ruby/object:Gem::Version
+  version: 0.2.0
+platform: ruby
+authors:
+- creativival
+autorequire:
+bindir: exe
+cert_chain: []
+date: 2024-08-10 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: faye-websocket
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.11.3
+description: Voxelamming is an AR programming learning app. Even programming beginners
+  can learn programming visually and enjoyably. Voxelamming supports iPhones and iPads
+  with iOS 16 or later, and Apple Vision Pro.
+email:
+- creativival@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- CODE_OF_CONDUCT.md
+- LICENSE.txt
+- README.md
+- Rakefile
+- index.html
+- lib/matrix_util.rb
+- lib/voxelamming.rb
+- lib/voxelamming/version.rb
+- sig/voxelamming.rbs
+homepage: https://creativival.github.io/voxelamming
+licenses:
+- MIT
+metadata:
+  allowed_push_host: https://rubygems.org
+  homepage_uri: https://creativival.github.io/voxelamming
+  source_code_uri: https://github.com/creativival/voxelamming_gem
+  changelog_uri: https://creativival.github.io/voxelamming_gem/CHANGELOG.md
+post_install_message:
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: 3.0.0
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubygems_version: 3.5.16
+signing_key:
+specification_version: 4
+summary: This Ruby package converts Ruby code into JSON format and sends it to the
+  Voxelamming app using WebSockets, allowing users to create 3D voxel models by writing
+  Ruby scripts..
+test_files: []