Module: Processing::HelperMethods
Overview
Provides some convenience methods
Instance Method Summary collapse
-
#blend_color(c1, c2, mode) ⇒ Object
Uses PImage class method under hood.
-
#buffer(buf_width = width, buf_height = height, renderer = @render_mode) ⇒ Object
Nice block method to draw to a buffer.
- #color(*args) ⇒ Object
-
#dist(*args) ⇒ Object
explicitly provide ‘processing.org’ dist instance method.
-
#find_method(method_name) ⇒ Object
There’s just so many functions in Processing, Here’s a convenient way to look for them.
-
#frame_rate(fps = nil) ⇒ Object
frame_rate needs to support reading and writing.
-
#hsb_color(hue, sat, brightness) ⇒ Object
hue, sat, brightness in range 0..1.0 returns RGB color int.
- #int_to_ruby_colors(p5color) ⇒ Object
-
#java_self ⇒ Object
Provide a convenient handle for the Java-space version of self.
- #kamera(eye: Vec3D.new(width / 2.0, height / 2.0, (height / 2.0) / tan(PI * 30.0 / 180.0)), center: Vec3D.new(width / 2.0, height / 2.0, 0), up: Vec3D.new(0, 1.0, 0)) ⇒ Object
-
#key ⇒ Object
Fix java conversion problems getting the last key If it’s ASCII, return the character, otherwise the integer.
-
#key_pressed? ⇒ Boolean
Is a key pressed for this frame?.
-
#lerp_color(*args) ⇒ Object
lerp_color takes three or four arguments, in Java that’s two different methods, one regular and one static, so:.
-
#load_strings(file_or_url) ⇒ Object
Ensure that load_strings returns a real Ruby array.
-
#max(*args) ⇒ Object
explicitly provide ‘processing.org’ max instance method to return a float:- a, b and c need to be floats see above.
-
#min(*args) ⇒ Object
explicitly provide ‘processing.org’ min instance method to return a float:- a, b and c need to be floats you might choose to use ruby method directly and then provide a block to alter comparator eg args.min(&block) # { |a, b| a.value <=> b.value }.
-
#mouse_pressed? ⇒ Boolean
Is the mouse pressed for this frame?.
- #p52ruby(p5color) ⇒ Object
- #perspektiv(fov: Math::PI / 3.0, aspect_ratio: width.to_f / height, near_z: (height / 20.0) / tan(fov / 2.0), far_z: (height * 5) / tan(fov / 2.0)) ⇒ Object
-
#proxy_java_fields ⇒ Object
Proxy over a list of Java declared fields that have the same name as some methods.
-
#save_strings(filename, strings) ⇒ Object
Writes an array of strings to a file, one line per string.
-
#thread(&block) ⇒ Object
Overrides Processing convenience function thread, which takes a String arg (for a function) to more rubylike version, takes a block…
- #web_to_color_array(web) ⇒ Object
Instance Method Details
#blend_color(c1, c2, mode) ⇒ Object
Uses PImage class method under hood
112 113 114 |
# File 'lib/jruby_art/helper_methods.rb', line 112 def blend_color(c1, c2, mode) Java::ProcessingCore::PImage.blendColor(c1, c2, mode) end |
#buffer(buf_width = width, buf_height = height, renderer = @render_mode) ⇒ Object
Nice block method to draw to a buffer. You can optionally pass it a width, a height, and a renderer. Takes care of starting and ending the draw for you.
13 14 15 16 17 18 19 |
# File 'lib/jruby_art/helper_methods.rb', line 13 def buffer(buf_width = width, buf_height = height, renderer = @render_mode) create_graphics(buf_width, buf_height, renderer).tap do |buffer| buffer.begin_draw yield buffer buffer.end_draw end end |
#color(*args) ⇒ Object
54 55 56 57 |
# File 'lib/jruby_art/helper_methods.rb', line 54 def color(*args) return super(*args) unless args.length == 1 super(hex_color(args[0])) end |
#dist(*args) ⇒ Object
explicitly provide ‘processing.org’ dist instance method
100 101 102 103 104 105 106 107 108 109 |
# File 'lib/jruby_art/helper_methods.rb', line 100 def dist(*args) case args.length when 4 return dist2d(*args) when 6 return dist3d(*args) else raise ArgumentError, 'takes 4 or 6 parameters' end end |
#find_method(method_name) ⇒ Object
There’s just so many functions in Processing, Here’s a convenient way to look for them.
118 119 120 121 |
# File 'lib/jruby_art/helper_methods.rb', line 118 def find_method(method_name) reg = Regexp.new(method_name.to_s, true) methods.sort.select { |meth| reg.match(meth) } end |
#frame_rate(fps = nil) ⇒ Object
frame_rate needs to support reading and writing
170 171 172 173 |
# File 'lib/jruby_art/helper_methods.rb', line 170 def frame_rate(fps = nil) return @declared_fields['frameRate'].value(java_self) unless fps super(fps) end |
#hsb_color(hue, sat, brightness) ⇒ Object
hue, sat, brightness in range 0..1.0 returns RGB color int
50 51 52 |
# File 'lib/jruby_art/helper_methods.rb', line 50 def hsb_color(hue, sat, brightness) Java::Monkstone::ColorUtil.hsbToRgB(hue, sat, brightness) end |
#int_to_ruby_colors(p5color) ⇒ Object
63 64 65 66 |
# File 'lib/jruby_art/helper_methods.rb', line 63 def int_to_ruby_colors(p5color) warn "[DEPRECATION] `int_to_ruby_colors` is deprecated. Please use `p52ruby` instead." p52ruby(p5color) end |
#java_self ⇒ Object
Provide a convenient handle for the Java-space version of self.
139 140 141 |
# File 'lib/jruby_art/helper_methods.rb', line 139 def java_self @java_self ||= to_java(Java::ProcessingCore::PApplet) end |
#kamera(eye: Vec3D.new(width / 2.0, height / 2.0, (height / 2.0) / tan(PI * 30.0 / 180.0)), center: Vec3D.new(width / 2.0, height / 2.0, 0), up: Vec3D.new(0, 1.0, 0)) ⇒ Object
21 22 23 24 25 26 27 |
# File 'lib/jruby_art/helper_methods.rb', line 21 def kamera( eye: Vec3D.new(width / 2.0, height / 2.0, (height / 2.0) / tan(PI * 30.0 / 180.0)), center: Vec3D.new(width / 2.0, height / 2.0, 0), up: Vec3D.new(0, 1.0, 0) ) camera(eye.x, eye.y, eye.z, center.x, center.y, center.z, up.x, up.y, up.z) end |
#key ⇒ Object
Fix java conversion problems getting the last key If it’s ASCII, return the character, otherwise the integer
133 134 135 136 |
# File 'lib/jruby_art/helper_methods.rb', line 133 def key int = @declared_fields['key'].value(java_self) int < 256 ? int.chr : int end |
#key_pressed? ⇒ Boolean
Is a key pressed for this frame?
181 182 183 |
# File 'lib/jruby_art/helper_methods.rb', line 181 def key_pressed? @declared_fields['keyPressed'].value(java_self) end |
#lerp_color(*args) ⇒ Object
lerp_color takes three or four arguments, in Java that’s two different methods, one regular and one static, so:
45 46 47 |
# File 'lib/jruby_art/helper_methods.rb', line 45 def lerp_color(*args) args.length > 3 ? self.class.lerp_color(*args) : super(*args) end |
#load_strings(file_or_url) ⇒ Object
Ensure that load_strings returns a real Ruby array
159 160 161 |
# File 'lib/jruby_art/helper_methods.rb', line 159 def load_strings(file_or_url) loadStrings(file_or_url).to_a end |
#max(*args) ⇒ Object
explicitly provide ‘processing.org’ max instance method to return a float:- a, b and c need to be floats see above
95 96 97 |
# File 'lib/jruby_art/helper_methods.rb', line 95 def max(*args) args.max end |
#min(*args) ⇒ Object
explicitly provide ‘processing.org’ min instance method to return a float:- a, b and c need to be floats you might choose to use ruby method directly and then provide a block to alter comparator eg args.min(&block) # { |a, b| a.value <=> b.value }
88 89 90 |
# File 'lib/jruby_art/helper_methods.rb', line 88 def min(*args) args.min end |
#mouse_pressed? ⇒ Boolean
Is the mouse pressed for this frame?
176 177 178 |
# File 'lib/jruby_art/helper_methods.rb', line 176 def mouse_pressed? @declared_fields['mousePressed'].value(java_self) end |
#p52ruby(p5color) ⇒ Object
68 69 70 |
# File 'lib/jruby_art/helper_methods.rb', line 68 def p52ruby(p5color) Java::Monkstone::ColorUtil.rubyString(p5color) end |
#perspektiv(fov: Math::PI / 3.0, aspect_ratio: width.to_f / height, near_z: (height / 20.0) / tan(fov / 2.0), far_z: (height * 5) / tan(fov / 2.0)) ⇒ Object
29 30 31 32 33 34 35 36 |
# File 'lib/jruby_art/helper_methods.rb', line 29 def perspektiv( fov: Math::PI / 3.0, aspect_ratio: width.to_f / height, near_z: (height / 20.0) / tan(fov / 2.0), far_z: (height * 5) / tan(fov / 2.0) ) perspective(fov, aspect_ratio, near_z, far_z) end |
#proxy_java_fields ⇒ Object
Proxy over a list of Java declared fields that have the same name as some methods. Add to this list as needed.
125 126 127 128 129 |
# File 'lib/jruby_art/helper_methods.rb', line 125 def proxy_java_fields fields = %w(key frameRate mousePressed keyPressed) methods = fields.map { |field| java_class.declared_field(field) } @declared_fields = Hash[fields.zip(methods)] end |
#save_strings(filename, strings) ⇒ Object
Writes an array of strings to a file, one line per string. This file is saved to the sketch’s data folder
165 166 167 |
# File 'lib/jruby_art/helper_methods.rb', line 165 def save_strings(filename, strings) saveStrings(filename, [strings].flatten.to_java(:String)) end |
#thread(&block) ⇒ Object
Overrides Processing convenience function thread, which takes a String arg (for a function) to more rubylike version, takes a block…
74 75 76 77 78 79 80 |
# File 'lib/jruby_art/helper_methods.rb', line 74 def thread(&block) if block_given? Thread.new(&block) else raise ArgumentError, 'thread must be called with a block', caller end end |
#web_to_color_array(web) ⇒ Object
59 60 61 |
# File 'lib/jruby_art/helper_methods.rb', line 59 def web_to_color_array(web) Java::Monkstone::ColorUtil.webArray(web) end |