Module: Processing::HelperMethods

Included in:
App
Defined in:
lib/ruby-processing/helper_methods.rb

Instance Method Summary collapse

Instance Method Details

#buffer(buf_width = width, buf_height = height, renderer = @render_mode) {|buf| ... } ⇒ 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.

Yields:

  • (buf) 


7
8
9
10
11
12
13
 
# File 'lib/ruby-processing/helper_methods.rb', line 7

def buffer(buf_width=width, buf_height=height, renderer=@render_mode)
  buf = create_graphics(buf_width, buf_height, renderer)
  buf.begin_draw
  yield buf
  buf.end_draw
  buf
end

#color(*args) ⇒ Object 



31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
 
# File 'lib/ruby-processing/helper_methods.rb', line 31

def color(*args)
  a = args[0]
  # convert to signed int
  if args.length == 1 
    if a.is_a?(Fixnum) && a >= 2**31
      args = [ a - 2**32 ]
    elsif a.is_a?(String) && a[0] == ?#
      h = a[1..-1]
      # add opaque alpha channel
      if h.size <= 6
        h = "ff" + "0"*(6-h.size) + h
      end
      return color(h.hex)
    end
  end
  super(*args)
end

#find_method(method_name) ⇒ Object

There’s just so many functions in Processing, Here’s a convenient way to look for them.



61
62
63
64
 
# File 'lib/ruby-processing/helper_methods.rb', line 61

def find_method(method_name)
  reg = Regexp.new("#{method_name}", true)
  self.methods.sort.select {|meth| reg.match(meth)}
end

#frame_count ⇒ Object 



106
 
# File 'lib/ruby-processing/helper_methods.rb', line 106

def frame_count;  frameCount;   end

#frame_rate(fps = nil) ⇒ Object

frame_rate needs to support reading and writing



123
124
125
126
 
# File 'lib/ruby-processing/helper_methods.rb', line 123

def frame_rate(fps = nil)
  return @declared_fields['frameRate'].value(java_self) unless fps
  super(fps)
end

#grid(cols, rows, col_size = 1, row_size = 1) ⇒ Object

A nice method to run a given block for a grid. Lifted from action_coding/Nodebox.



17
18
19
20
21
22
23
 
# File 'lib/ruby-processing/helper_methods.rb', line 17

def grid(cols, rows, col_size=1, row_size=1)
  (0...cols*rows).map do |i|
    x = col_size * (i % cols)
    y = row_size * i.div(cols)
    yield x, y
  end
end

#java_self ⇒ Object

Provide a convenient handle for the Java-space version of self.



91
92
93
 
# File 'lib/ruby-processing/helper_methods.rb', line 91

def java_self
  @java_self ||= Java.ruby_to_java self
end

#key ⇒ Object

Fix java conversion problems getting the last key If it’s ASCII, return the character, otherwise the integer



85
86
87
88
 
# File 'lib/ruby-processing/helper_methods.rb', line 85

def key
  int = @declared_fields['key'].value(java_self)
  int < 256 ? int.chr : int
end

#key_code ⇒ Object 



108
 
# File 'lib/ruby-processing/helper_methods.rb', line 108

def key_code;     keyCode;      end

#key_pressed? ⇒ Boolean

Is a key pressed for this frame?

Returns:

  • (Boolean) 


134
135
136
 
# File 'lib/ruby-processing/helper_methods.rb', line 134

def key_pressed?
  Java.java_to_primitive(java_class.field("keyPressed").value(java_object))
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:



27
28
29
 
# File 'lib/ruby-processing/helper_methods.rb', line 27

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



112
113
114
 
# File 'lib/ruby-processing/helper_methods.rb', line 112

def load_strings(file_or_url)
  loadStrings(file_or_url).to_a
end

#loop(&block) ⇒ Object 



49
50
51
52
53
54
55
56
57
 
# File 'lib/ruby-processing/helper_methods.rb', line 49

def loop(&block)
  if block_given?
    while true do
      yield
    end
  else
    super
  end
end

#mouse_button ⇒ Object 



107
 
# File 'lib/ruby-processing/helper_methods.rb', line 107

def mouse_button; mouseButton;  end

#mouse_pressed? ⇒ Boolean

Is the mouse pressed for this frame?

Returns:

  • (Boolean) 


129
130
131
 
# File 'lib/ruby-processing/helper_methods.rb', line 129

def mouse_pressed?
  Java.java_to_primitive(java_class.field("mousePressed").value(java_object))
end

#mouse_x ⇒ Object

Fields that should be made accessible as under_scored.



102
 
# File 'lib/ruby-processing/helper_methods.rb', line 102

def mouse_x;      mouseX;       end

#mouse_y ⇒ Object 



103
 
# File 'lib/ruby-processing/helper_methods.rb', line 103

def mouse_y;      mouseY;       end

#pmouse_x ⇒ Object 



104
 
# File 'lib/ruby-processing/helper_methods.rb', line 104

def pmouse_x;     pmouseX;      end

#pmouse_y ⇒ Object 



105
 
# File 'lib/ruby-processing/helper_methods.rb', line 105

def pmouse_y;     pmouseY;      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.



68
69
70
71
72
 
# File 'lib/ruby-processing/helper_methods.rb', line 68

def proxy_java_fields
  @declared_fields = {}
  fields = %w(sketchPath key frameRate frame)
  fields.each {|f| @declared_fields[f] = java_class.declared_field(f) }
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



118
119
120
 
# File 'lib/ruby-processing/helper_methods.rb', line 118

def save_strings(filename, strings)
  saveStrings(filename, [strings].flatten.to_java(:String))
end

#set_sketch_path(path = nil) ⇒ Object

By default, your sketch path is the folder that your sketch is in. If you’d like to do something fancy, feel free.



76
77
78
79
 
# File 'lib/ruby-processing/helper_methods.rb', line 76

def set_sketch_path(path=nil)
  field = @declared_fields['sketchPath']
  field.set_value(java_self, path || SKETCH_ROOT)
end

#sketch_path ⇒ Object

Get the sketch path



97
98
99
 
# File 'lib/ruby-processing/helper_methods.rb', line 97

def sketch_path
  @declared_fields['sketchPath'].value(java_self)
end