Project

mittsu

0.18
There's a lot of open issues
A long-lived project that still receives updates
Mittsu is a 3D Graphics Library for Ruby, based heavily on Three.js
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 13.0
= 0.17.1
~> 2.0
~> 5.0

Runtime

 Project Readme

Mittsu

Gem Version Test Coverage Maintainability Build Status

3D Graphics Library for Ruby

Mittsu is a 3D Graphics Library for Ruby, based heavily on Three.js

GIFs!

Normal-mapped Earth Point Light Tank Demo

(You can find the source for the Tank Demo here)

Installation

Add this line to your application's Gemfile:

gem 'mittsu'

And then execute:

$ bundle

Or install it yourself as:

$ gem install mittsu

Usage

Create a basic scene with a perspective camera and a green box:

require 'mittsu'

scene = Mittsu::Scene.new

camera = Mittsu::PerspectiveCamera.new(75.0, 1.0, 0.1, 1000.0)
camera.position.z = 5.0

box = Mittsu::Mesh.new(
  Mittsu::BoxGeometry.new(1.0, 1.0, 1.0),
  Mittsu::MeshBasicMaterial.new(color: 0x00ff00)
)

scene.add(box)

More Resources

Mittsu follows a similar structure to THREE.js, so you can generally use the same documentation for a description of the various classes and how they work.

If you want to actually render scenes, you'll need a renderer. There is a reference OpenGL renderer here.

See also

Where is Mittsu used?

  • Manyfold - A self-hosted digital asset manager for 3d print files.

Where you can help

  1. Testing!

    Currently the only unit tests are for most of the maths library.

  2. Refactoring!

    The code is unfortunately still a mess. Mittsu started out as a direct port of THREE.js, and JavaScript to Ruby is not an exact science.

  3. Find Bugs!

    Mittsu is still very young, and there are plenty of small bugs and glitches that need to be ironed out. If you find a bug, create an issue so we can track it and squash it.

  4. Add all the features!

    Some of the things I'd like to see ported from THREE.js include:

    • Picking (clicking on 3D objects in a scene)
    • Bone structure/animation (e.g. for character movements)
    • Lens Flares! (for JJ Abrams)
    • All the Extras and Helpers (who doesn't need extra help?)
  5. Write documentation!

    You can use the same docs as THREE.js for now, but I would like to provide Mittsu-specific documentation so devs don't have to keep replacing new THREE.Thing() with Mittsu::Thing.new.

Contributing

  1. Fork it ( https://github.com/danini-the-panini/mittsu/fork )
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create a new Pull Request

Thank you for helping me help you help us all. ;)