Contents

---
layout: post
title:  "Installing the gem"
date:   2017-01-08 06:31:13
categories: joonsrenderer update
---

### Requirements

Requires JRubyArt or propane

### Install the joonsrenderer gem

```bash
jgem install joonsrenderer # safe way
gem install joonsrenderer # using rvm rbenv to choose jruby
```

Create basic sketch

```bash
mkdir 'my_sketch'
cd my_sketch
k9 -c my_sketch 800 600 P3D # JRubyArt
propane -c my_sketch 800 600 P3D # propane
```

Edit the JRubyArt sketch as follows:-

```ruby
require 'joonsrender'
include_package 'joons'

attr_reader :jr, :eye, :center, :up

def setup
  sketch_title 'My Sketch'
  @jr = JoonsRenderer.new(self)
  # Camera Setting.
  @eye = Vec3D.new(0, 0, 120)
  @center = Vec3D.new(0, 0, -1)
  @up = Vec3D.new(0, 1, 0)
end

def draw
  jr.begin_record # Make sure to include things you want rendered.
  kamera(eye: eye, center: center, up: up)
  perspektiv(fov: PI / 4.0, aspect_ratio: 4 / 3.0, near_z: 5, far_z: 10_000)
  jr.background('cornell_box', 100, 100, 100) # Cornell Box: width, height, depth.
  jr.background('gi_instant') # Global illumination.
  translate(0, 10, -10)
  rotate_y(-PI / 8)
  rotate_x(-PI / 8)
  jr.fill('diffuse', 255, 255, 255)
  box(20)
  jr.end_record # Make sure to end record.
  jr.display_rendered(true) # Display rendered image if render is completed, and the argument is true.
end

def key_pressed
  jr.render if (key == 'r' || key == 'R')  # Press 'r' key to start rendering.
end

def settings
  size(800, 600, P3D)
end

```

### The processing sketch ###

![basic.png]({{site.github.url}}/assets/basic.png)

### The raytraced output ###

![basic_traced.png]({{site.github.url}}/assets/basic_traced.png)

Usage with propane is very similar

Version data entries

6 entries across 6 versions & 1 rubygems

Version	Path
joonsrenderer-1.3.1-java	docs/_posts/2017-01-08-welcome.md
joonsrenderer-1.2.0-java	docs/_posts/2017-01-08-welcome.md
joonsrenderer-1.1.3-java	docs/_posts/2017-01-08-welcome.md
joonsrenderer-1.1.2-java	docs/_posts/2017-01-08-welcome.md
joonsrenderer-1.1.1-java	docs/_posts/2017-01-08-welcome.md
joonsrenderer-1.1-java	docs/_posts/2017-01-08-welcome.md