joonsrenderer gem for JRubyArt and propane

Installing the gem

Sun, 08 Jan 2017 06:31:13 +0000

Requirements

Requires JRubyArt or propane

Install the joonsrenderer gem

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

Create basic sketch

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:-

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

The raytraced output

Usage with propane is very similar

Animation using raytraced images

Sun, 08 Jan 2017 05:31:13 +0000

Sunflow is an open source global illumination rendering system written in Java written by Christopher Kulla. I have recently updated to build with maven using jdk-8 and to use the latest janino jars. This is gem makes sunflow rendering easily available to JRubyArt and propane users using Joon Hylub Lees joons-renderer:-

test.rb (JRubyArt Sketch)

require 'joonsrenderer'
include_package 'joons'

attr_reader :jr, :eye, :center, :up, :count, :radius, :file_name

def settings
  size(800, 600, P3D)
end

def setup
  sketch_title 'Animation'
  @file_name = 'Animation'
  @jr = JoonsRenderer.new(self)
  # Camera Setting.
  @eye = Vec3D.new(0, 0, 120)
  @center = Vec3D.new(0, 0, -1)
  @up = Vec3D.new(0, 1, 0)
  @count = 0
  @radius = 35
end

def draw
  jr.render # The draw loop that comes next is rendered
  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_ambient_occlusion') # Global illumination.
  # Sun.
  translate(0, -15, 0)
  jr.fill('light', 1, 60, 60)
  sphere(5)
  # Planet, revolving at +3 degrees per frame.
  translate(radius * DegLut.cos(count * 3), 0, radius * DegLut.sin(count * 3))
  jr.fill('mirror')
  sphere(5)
  jr.end_record # Make sure to end record.
  # Display rendered image if render is completed, and the argument is true.
  jr.display_rendered(true)
  save_frame(format("%s%s", file_name, "_###.png"))
  @count += 1
  no_loop if (count > 120)
end

The Animated Ray Trace Sketch

Now you hava a bunch of *.png images that you need to zip up to create a video

png2yuv -j Animation_%0.3d.png -f 25 -I p -b 1 > tmp.yuv # zip it all up
ffmpeg2theora --optimize --videobitrate 16778 -o Animation.ogv tmp.yuv # convert

Resource References

Sun, 08 Jan 2017 05:00:13 +0000

Get some inspiration on flickr and vimeo (and by Joon Hyub Lee). See also this tutorial by Joon Hyub Lee and this link to a pdf of a defunct wiki from a sunflow developer.

Media Demo

Sun, 08 Jan 2017 04:31:13 +0000

media_demo.rb (JRubyArt Sketch)

require 'joonsrenderer'
include_package 'joons'

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

def setup
  sketch_title 'Media Demo'
  @jr = JoonsRenderer.new(self)
  jr.set_sampler('ipr') # Rendering mode, either 'ipr' or 'bucket'.
  jr.set_size_multiplier(2) # Set size of PNG file as a multiple of Processing sketch size.
  jr.setAA(-2, 0) # Set anti aliasing, (aaMin, aaMax, aaSamples). aaMin & aaMax = .. -2, -1, .. , 1, 2 .. aaMin < aaMax.
  jr.set_caustics(10) # Set caustics. 1, 5, 10 .., affects quality of light reflected & refracted through glass.
  # 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('gi_instant') # Global illumination.
  jr.background('cornell_box', 100, 100, 100) # Cornell box, width, height, depth.
  push_matrix
  translate(-40, 20, -20)
  push_matrix
  rotateY(-PI / 8)
  # jr.fill('light', r, g, b)
  jr.fill('light', 5, 5, 5)
  sphere(13)
  translate(27, 0, 0)
  # jr.fill('mirror', r, g, b)
  jr.fill('mirror', 255, 255, 255)
  sphere(13)
  translate(27, 0, 0)
  # jr.fill('diffuse', r, g, b)
  jr.fill('diffuse', 150, 255, 255)
  sphere(13)
  translate(27, 0, 0)
  # jr.fill('shiny', r, g, b, shininess)
  jr.fill('shiny', 150, 255, 255, 0.1)
  sphere(13)
  translate(27, 0, 0)
  pop_matrix
  rotateY(PI / 8)
  translate(-10, -27, 30)
  # jr.fill('ambient occlusion', bright r, g, b, dark r, g, b, maximum distance, int samples)
  jr.fill('ambient_occlusion', 150, 255, 255, 0, 0, 255, 50, 16)
  sphere(13)
  translate(27, 0, 0)
  # jr.fill('phong', r, g, b)
  jr.fill('phong', 150, 255, 255)
  sphere(13)
  translate(27, 0, 0)
  # jr.fill('glass', r, g, b)
  jr.fill('glass', 255, 255, 255)
  sphere(13)
  translate(27, 0, 0)
  # jr.fill('constant', r, g, b)
  jr.fill('constant', 150, 255, 255)
  sphere(13)
  pop_matrix
  jr.end_record # Make sure to end record.
  # Display rendered image if render is completed, and the argument is true.
  jr.display_rendered(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