rubysketch 0.2.3 → 0.3.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/ChangeLog.md +21 -0
- data/VERSION +1 -1
- data/examples/clock.rb +4 -13
- data/lib/rubysketch-processing.rb +12 -1
- data/lib/rubysketch.rb +0 -1
- data/lib/rubysketch/glsl.rb +0 -2
- data/lib/rubysketch/processing.rb +1348 -1057
- data/lib/rubysketch/window.rb +27 -10
- metadata +3 -3
- data/lib/rubysketch/starter.rb +0 -67
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 6a044fb62451ebcd69c89a5a9cb2781c747d4298142a9e6828f71cdbc63da999
|
4
|
+
data.tar.gz: 6dade74829619df93d947160f930fdc19563cc9042b826ef7b8b4bd6015cfb00
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 7801ba15e151b5c519047b2145b71e820428b2b9601c9fccaffd1eb6d6b67ff344b6aa7b0cd12c9151d431df01d201c5cc63e3a8ffa92d854b5934a2357fb8ec
|
7
|
+
data.tar.gz: 44f7ad0c273aa88974356dfcc3fbc7d080d8bccb023ab4137db23f2d7b85b0fa2b06b590a97b487f803575d903a87a8747f26ff3e0518b5c76623f26dcafd35d
|
data/ChangeLog.md
ADDED
@@ -0,0 +1,21 @@
|
|
1
|
+
# RubySketch ChangeLog
|
2
|
+
|
3
|
+
|
4
|
+
## [0.2.7] - 2020-04-17
|
5
|
+
|
6
|
+
- add strokeCap() and strokeJoin()
|
7
|
+
|
8
|
+
|
9
|
+
## [0.2.6] - 2020-04-17
|
10
|
+
|
11
|
+
- push(), pushMatrix() and pushStyle() take block to automatic pop
|
12
|
+
- refine startup process
|
13
|
+
- add curve() and bezier()
|
14
|
+
- add imageMode(), Image#resize(), Image#copy() and copy()
|
15
|
+
- add loop(), noLoop() and redraw()
|
16
|
+
|
17
|
+
|
18
|
+
## [0.2.5] - 2020-03-29
|
19
|
+
|
20
|
+
- delete debug prints
|
21
|
+
- show unsupported image type
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
0.
|
1
|
+
0.3.0
|
data/examples/clock.rb
CHANGED
@@ -20,12 +20,10 @@ end
|
|
20
20
|
draw do
|
21
21
|
background 0
|
22
22
|
|
23
|
-
|
24
|
-
pushMatrix
|
23
|
+
pushMatrix do
|
25
24
|
translate width / 2, height / 2
|
26
25
|
|
27
|
-
|
28
|
-
pushMatrix
|
26
|
+
pushMatrix do
|
29
27
|
fill COLORS[0]
|
30
28
|
ellipse 0, 0, 20, 20
|
31
29
|
rotate (now - start) / 60.0 * 360
|
@@ -33,32 +31,25 @@ draw do
|
|
33
31
|
strokeWeight 5
|
34
32
|
line 0, 0, 200, 0
|
35
33
|
fill 1
|
36
|
-
popMatrix
|
37
34
|
end
|
38
35
|
|
39
|
-
|
40
|
-
pushMatrix
|
36
|
+
pushMatrix do
|
41
37
|
strokeWeight 3
|
42
38
|
60.times do
|
43
39
|
rotate 6
|
44
40
|
stroke COLORS[1]
|
45
41
|
line 200, 0, 210, 0
|
46
42
|
end
|
47
|
-
popMatrix
|
48
43
|
end
|
49
44
|
|
50
|
-
|
51
|
-
pushMatrix
|
45
|
+
pushMatrix do
|
52
46
|
strokeWeight 5
|
53
47
|
12.times do
|
54
48
|
rotate 30
|
55
49
|
stroke COLORS[3]
|
56
50
|
line 190, 0, 210, 0
|
57
51
|
end
|
58
|
-
popMatrix
|
59
52
|
end
|
60
|
-
|
61
|
-
popMatrix
|
62
53
|
end
|
63
54
|
|
64
55
|
textSize 20
|
@@ -1,4 +1,15 @@
|
|
1
1
|
require 'rubysketch'
|
2
2
|
|
3
3
|
|
4
|
-
|
4
|
+
begin
|
5
|
+
include RubySketch::Processing::Context
|
6
|
+
|
7
|
+
window = RubySketch::Window.new {start}
|
8
|
+
setup__ window
|
9
|
+
|
10
|
+
window.__send__ :begin_draw
|
11
|
+
at_exit do
|
12
|
+
window.__send__ :end_draw
|
13
|
+
Reflex.start {window.show} unless $!
|
14
|
+
end
|
15
|
+
end
|
data/lib/rubysketch.rb
CHANGED
data/lib/rubysketch/glsl.rb
CHANGED
@@ -3,1183 +3,1474 @@ module RubySketch
|
|
3
3
|
|
4
4
|
# Processing compatible API
|
5
5
|
#
|
6
|
-
|
6
|
+
module Processing
|
7
7
|
|
8
|
-
include Math
|
9
8
|
|
10
|
-
|
9
|
+
# Image object.
|
10
|
+
#
|
11
|
+
class Image
|
11
12
|
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
13
|
+
# @private
|
14
|
+
def initialize (image)
|
15
|
+
@image__ = image
|
16
|
+
end
|
16
17
|
|
17
|
-
|
18
|
-
|
19
|
-
|
18
|
+
# Gets width of image.
|
19
|
+
#
|
20
|
+
# @return [Numeric] width of image
|
21
|
+
#
|
22
|
+
def width ()
|
23
|
+
@image__.width
|
24
|
+
end
|
20
25
|
|
21
|
-
|
22
|
-
|
23
|
-
|
26
|
+
# Gets height of image.
|
27
|
+
#
|
28
|
+
# @return [Numeric] height of image
|
29
|
+
#
|
30
|
+
def height ()
|
31
|
+
@image__.height
|
32
|
+
end
|
24
33
|
|
25
|
-
|
26
|
-
|
27
|
-
|
34
|
+
# Resizes image.
|
35
|
+
#
|
36
|
+
# @param width [Numeric] width for resized image
|
37
|
+
# @param height [Numeric] height for resized image
|
38
|
+
#
|
39
|
+
# @return [nil] nil
|
40
|
+
#
|
41
|
+
def resize (width, height)
|
42
|
+
@image__ = Rays::Image.new(width, height).paint do |painter|
|
43
|
+
painter.image @image__, 0, 0, width, height
|
44
|
+
end
|
45
|
+
nil
|
46
|
+
end
|
28
47
|
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
33
|
-
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
38
|
-
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
45
|
-
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
@mouseX__ =
|
53
|
-
@mouseY__ =
|
54
|
-
@mousePrevX__ =
|
55
|
-
@mousePrevY__ = 0
|
56
|
-
@mousePressed__ = false
|
57
|
-
|
58
|
-
colorMode RGB, 255
|
59
|
-
angleMode RADIANS
|
60
|
-
rectMode CORNER
|
61
|
-
ellipseMode CENTER
|
62
|
-
end
|
63
|
-
|
64
|
-
# @private
|
65
|
-
def on_start__ (window)
|
66
|
-
@window__ = window
|
67
|
-
@painter__ = window.canvas_painter
|
68
|
-
|
69
|
-
setupDrawBlock__
|
70
|
-
setupMousePressedBlock__
|
71
|
-
setupMouseReleasedBlock__
|
72
|
-
setupMouseMovedBlock__
|
73
|
-
setupMouseDraggedBlock__
|
74
|
-
end
|
75
|
-
|
76
|
-
# Returns the absolute number of the value.
|
77
|
-
#
|
78
|
-
# @param value [Numeric] number
|
79
|
-
#
|
80
|
-
# @return [Numeric] absolute number
|
81
|
-
#
|
82
|
-
def abs (value)
|
83
|
-
value.abs
|
84
|
-
end
|
48
|
+
# Copies image.
|
49
|
+
#
|
50
|
+
# @overload copy(sx, sy, sw, sh, dx, dy, dw, dh)
|
51
|
+
# @overload copy(img, sx, sy, sw, sh, dx, dy, dw, dh)
|
52
|
+
#
|
53
|
+
# @param img [Image] image for copy source
|
54
|
+
# @param sx [Numrtic] x position of source region
|
55
|
+
# @param sy [Numrtic] y position of source region
|
56
|
+
# @param sw [Numrtic] width of source region
|
57
|
+
# @param sh [Numrtic] height of source region
|
58
|
+
# @param dx [Numrtic] x position of destination region
|
59
|
+
# @param dy [Numrtic] y position of destination region
|
60
|
+
# @param dw [Numrtic] width of destination region
|
61
|
+
# @param dh [Numrtic] height of destination region
|
62
|
+
#
|
63
|
+
# @return [nil] nil
|
64
|
+
#
|
65
|
+
def copy (img = nil, sx, sy, sw, sh, dx, dy, dw, dh)
|
66
|
+
img ||= self
|
67
|
+
@image__.paint do |painter|
|
68
|
+
painter.image img.getInternal__, sx, sy, sw, sh, dx, dy, dw, dh
|
69
|
+
end
|
70
|
+
end
|
85
71
|
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
value.ceil
|
94
|
-
end
|
72
|
+
# Saves image to file.
|
73
|
+
#
|
74
|
+
# @param filename [String] file name to save image
|
75
|
+
#
|
76
|
+
def save (filename)
|
77
|
+
@image__.save filename
|
78
|
+
end
|
95
79
|
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
# @return [Numeric] rounded down number
|
101
|
-
#
|
102
|
-
def floor (value)
|
103
|
-
value.floor
|
104
|
-
end
|
80
|
+
# @private
|
81
|
+
def getInternal__ ()
|
82
|
+
@image__
|
83
|
+
end
|
105
84
|
|
106
|
-
#
|
107
|
-
#
|
108
|
-
# @param value [Numeric] number
|
109
|
-
#
|
110
|
-
# @return [Numeric] rounded number
|
111
|
-
#
|
112
|
-
def round (value)
|
113
|
-
value.round
|
114
|
-
end
|
85
|
+
end# Image
|
115
86
|
|
116
|
-
# Returns value raised to the power of exponent.
|
117
|
-
#
|
118
|
-
# @param value [Numeric] base number
|
119
|
-
# @param exponent [Numeric] exponent number
|
120
|
-
#
|
121
|
-
# @return [Numeric] value ** exponent
|
122
|
-
#
|
123
|
-
def pow (value, exponent)
|
124
|
-
value ** exponent
|
125
|
-
end
|
126
87
|
|
127
|
-
#
|
128
|
-
#
|
129
|
-
# @param value [Numeric] number
|
88
|
+
# Font object.
|
130
89
|
#
|
131
|
-
|
132
|
-
#
|
133
|
-
def sq (value)
|
134
|
-
value * value
|
135
|
-
end
|
90
|
+
class Font
|
136
91
|
|
137
|
-
|
138
|
-
|
139
|
-
|
140
|
-
# @overload mag(x, y, z)
|
141
|
-
#
|
142
|
-
# @param x [Numeric] x of point
|
143
|
-
# @param y [Numeric] y of point
|
144
|
-
# @param z [Numeric] z of point
|
145
|
-
#
|
146
|
-
# @return [Numeric] magnitude
|
147
|
-
#
|
148
|
-
def mag (*args)
|
149
|
-
x, y, z = *args
|
150
|
-
case args.size
|
151
|
-
when 2 then sqrt x * x + y * y
|
152
|
-
when 3 then sqrt x * x + y * y + z * z
|
153
|
-
else raise ArgumentError
|
92
|
+
# @private
|
93
|
+
def initialize (font)
|
94
|
+
@font = font
|
154
95
|
end
|
155
|
-
end
|
156
96
|
|
157
|
-
|
158
|
-
|
159
|
-
|
160
|
-
|
161
|
-
|
162
|
-
|
163
|
-
|
164
|
-
|
165
|
-
|
166
|
-
|
167
|
-
|
168
|
-
|
169
|
-
|
170
|
-
|
171
|
-
|
172
|
-
|
173
|
-
when 4
|
174
|
-
x1, y1, x2, y2 = *args
|
175
|
-
xx, yy = x2 - x1, y2 - y1
|
176
|
-
sqrt xx * xx + yy * yy
|
177
|
-
when 3
|
178
|
-
x1, y1, z1, x2, y2, z2 = *args
|
179
|
-
xx, yy, zz = x2 - x1, y2 - y1, z2 - z1
|
180
|
-
sqrt xx * xx + yy * yy + zz * zz
|
181
|
-
else raise ArgumentError
|
97
|
+
# Returns bounding box.
|
98
|
+
#
|
99
|
+
# @overload textBounds(str)
|
100
|
+
# @overload textBounds(str, x, y)
|
101
|
+
# @overload textBounds(str, x, y, fontSize)
|
102
|
+
#
|
103
|
+
# @param str [String] text to calculate bounding box
|
104
|
+
# @param x [Numeric] horizontal position of bounding box
|
105
|
+
# @param y [Numeric] vertical position of bounding box
|
106
|
+
# @param fontSize [Numeric] font size
|
107
|
+
#
|
108
|
+
# @return [TextBounds] bounding box for text
|
109
|
+
#
|
110
|
+
def textBounds (str, x = 0, y = 0, fontSize = nil)
|
111
|
+
f = fontSize ? Rays::Font.new(@font.name, fontSize) : @font
|
112
|
+
TextBounds.new x, y, x + f.width(str), y + f.height
|
182
113
|
end
|
183
|
-
end
|
184
|
-
|
185
|
-
# Normalize the value from range start..stop into 0..1.
|
186
|
-
#
|
187
|
-
# @param value [Numeric] number to be normalized
|
188
|
-
# @param start [Numeric] lower bound of the range
|
189
|
-
# @param stop [Numeric] upper bound of the range
|
190
|
-
#
|
191
|
-
# @return [Numeric] normalized value between 0..1
|
192
|
-
#
|
193
|
-
def norm (value, start, stop)
|
194
|
-
(value.to_f - start.to_f) / (stop.to_f - start.to_f)
|
195
|
-
end
|
196
114
|
|
197
|
-
#
|
198
|
-
#
|
199
|
-
# @param start [Numeric] lower bound of the range
|
200
|
-
# @param stop [Numeric] upper bound of the range
|
201
|
-
# @param amount [Numeric] amount to interpolate
|
202
|
-
#
|
203
|
-
# @return [Numeric] interporated number
|
204
|
-
#
|
205
|
-
def lerp (start, stop, amount)
|
206
|
-
start + (stop - start) * amount
|
207
|
-
end
|
115
|
+
end# Font
|
208
116
|
|
209
|
-
# Maps a number from range start1..stop1 to range start2..stop2.
|
210
|
-
#
|
211
|
-
# @param value [Numeric] number to be mapped
|
212
|
-
# @param start1 [Numeric] lower bound of the range1
|
213
|
-
# @param stop1 [Numeric] upper bound of the range1
|
214
|
-
# @param start2 [Numeric] lower bound of the range2
|
215
|
-
# @param stop2 [Numeric] upper bound of the range2
|
216
|
-
#
|
217
|
-
# @return [Numeric] mapped number
|
218
|
-
#
|
219
|
-
def map (value, start1, stop1, start2, stop2)
|
220
|
-
lerp start2, stop2, norm(value, start1, stop1)
|
221
|
-
end
|
222
117
|
|
223
|
-
#
|
224
|
-
#
|
225
|
-
# @overload min(a, b)
|
226
|
-
# @overload min(a, b, c)
|
227
|
-
# @overload min(array)
|
228
|
-
#
|
229
|
-
# @param a [Numeric] value to compare
|
230
|
-
# @param b [Numeric] value to compare
|
231
|
-
# @param c [Numeric] value to compare
|
232
|
-
# @param array [Numeric] values to compare
|
118
|
+
# Bounding box for text.
|
233
119
|
#
|
234
|
-
|
235
|
-
#
|
236
|
-
def min (*args)
|
237
|
-
args.flatten.min
|
238
|
-
end
|
120
|
+
class TextBounds
|
239
121
|
|
240
|
-
|
241
|
-
|
242
|
-
|
243
|
-
# @overload max(a, b, c)
|
244
|
-
# @overload max(array)
|
245
|
-
#
|
246
|
-
# @param a [Numeric] value to compare
|
247
|
-
# @param b [Numeric] value to compare
|
248
|
-
# @param c [Numeric] value to compare
|
249
|
-
# @param array [Numeric] values to compare
|
250
|
-
#
|
251
|
-
# @return [Numeric] maximum value
|
252
|
-
#
|
253
|
-
def max (*args)
|
254
|
-
args.flatten.max
|
255
|
-
end
|
122
|
+
# Horizontal position
|
123
|
+
#
|
124
|
+
attr_reader :x
|
256
125
|
|
257
|
-
|
258
|
-
|
259
|
-
|
260
|
-
# @param min [Numeric] lower bound of the range
|
261
|
-
# @param max [Numeric] upper bound of the range
|
262
|
-
#
|
263
|
-
# @return [Numeric] constrained number
|
264
|
-
#
|
265
|
-
def constrain (value, min, max)
|
266
|
-
value < min ? min : (value > max ? max : value)
|
267
|
-
end
|
126
|
+
# Vertical position
|
127
|
+
#
|
128
|
+
attr_reader :y
|
268
129
|
|
269
|
-
|
270
|
-
|
271
|
-
|
272
|
-
#
|
273
|
-
# @return [Numeric] radian
|
274
|
-
#
|
275
|
-
def radians (degree)
|
276
|
-
degree * DEG2RAD__
|
277
|
-
end
|
130
|
+
# Width of bounding box
|
131
|
+
#
|
132
|
+
attr_reader :w
|
278
133
|
|
279
|
-
|
280
|
-
|
281
|
-
|
282
|
-
#
|
283
|
-
# @return [Numeric] degree
|
284
|
-
#
|
285
|
-
def degrees (radian)
|
286
|
-
radian * RAD2DEG__
|
287
|
-
end
|
134
|
+
# Height of bounding box
|
135
|
+
#
|
136
|
+
attr_reader :h
|
288
137
|
|
289
|
-
|
290
|
-
|
291
|
-
|
292
|
-
@window__.setup = block
|
293
|
-
nil
|
294
|
-
end
|
295
|
-
|
296
|
-
# @private
|
297
|
-
private def setupDrawBlock__ ()
|
298
|
-
@window__.draw = proc do |e, painter|
|
299
|
-
@painter__ = painter
|
300
|
-
@matrixStack__.clear
|
301
|
-
@styleStack__.clear
|
302
|
-
begin
|
303
|
-
push
|
304
|
-
@drawBlock__.call e if @drawBlock__
|
305
|
-
ensure
|
306
|
-
pop
|
307
|
-
end
|
308
|
-
@frameCount__ += 1
|
309
|
-
updateMousePrevPos__
|
138
|
+
# @private
|
139
|
+
def initialize (x, y, w, h)
|
140
|
+
@x, @y, @w, @h = x, y, w, h
|
310
141
|
end
|
311
|
-
end
|
312
142
|
|
313
|
-
#
|
314
|
-
#
|
315
|
-
def draw (&block)
|
316
|
-
@drawBlock__ = block if block
|
317
|
-
nil
|
318
|
-
end
|
319
|
-
|
320
|
-
def key (&block)
|
321
|
-
@window__.key = block
|
322
|
-
nil
|
323
|
-
end
|
324
|
-
|
325
|
-
# @private
|
326
|
-
private def setupMousePressedBlock__ ()
|
327
|
-
@window__.pointer_down = proc do |e|
|
328
|
-
updateMouseState__ e.x, e.y, true
|
329
|
-
@mousePressedBlock__.call e if @mousePressedBlock__
|
330
|
-
end
|
331
|
-
end
|
332
|
-
|
333
|
-
def mousePressed (&block)
|
334
|
-
@mousePressedBlock__ = block if block
|
335
|
-
@mousePressed__
|
336
|
-
end
|
337
|
-
|
338
|
-
# @private
|
339
|
-
private def setupMouseReleasedBlock__ ()
|
340
|
-
@window__.pointer_up = proc do |e|
|
341
|
-
updateMouseState__ e.x, e.y, false
|
342
|
-
@mouseReleasedBlock__.call e if @mouseReleasedBlock__
|
343
|
-
end
|
344
|
-
end
|
345
|
-
|
346
|
-
def mouseReleased (&block)
|
347
|
-
@mouseReleasedBlock__ = block if block
|
348
|
-
nil
|
349
|
-
end
|
350
|
-
|
351
|
-
# @private
|
352
|
-
private def setupMouseMovedBlock__ ()
|
353
|
-
@window__.pointer_move = proc do |e|
|
354
|
-
updateMouseState__ e.x, e.y
|
355
|
-
@mouseMovedBlock__.call e if @mouseMovedBlock__
|
356
|
-
end
|
357
|
-
end
|
358
|
-
|
359
|
-
def mouseMoved (&block)
|
360
|
-
@mouseMovedBlock__ = block if block
|
361
|
-
nil
|
362
|
-
end
|
363
|
-
|
364
|
-
# @private
|
365
|
-
private def setupMouseDraggedBlock__ ()
|
366
|
-
@window__.pointer_drag = proc do |e|
|
367
|
-
updateMouseState__ e.x, e.y
|
368
|
-
@mouseDraggedBlock__.call e if @mouseDraggedBlock__
|
369
|
-
end
|
370
|
-
end
|
371
|
-
|
372
|
-
def mouseDragged (&block)
|
373
|
-
@mouseDraggedBlock__ = block if block
|
374
|
-
nil
|
375
|
-
end
|
376
|
-
|
377
|
-
# @private
|
378
|
-
private def updateMouseState__ (x, y, pressed = nil)
|
379
|
-
@mouseX__ = x
|
380
|
-
@mouseY__ = y
|
381
|
-
@mousePressed__ = pressed if pressed != nil
|
382
|
-
end
|
383
|
-
|
384
|
-
# @private
|
385
|
-
private def updateMousePrevPos__ ()
|
386
|
-
@mousePrevX__ = @mouseX__
|
387
|
-
@mousePrevY__ = @mouseY__
|
388
|
-
end
|
389
|
-
|
390
|
-
# @private
|
391
|
-
private def size__ (width, height)
|
392
|
-
raise 'size() must be called on startup or setup block' if @started__
|
393
|
-
|
394
|
-
@painter__.send :end_paint
|
395
|
-
reset_canvas width, height
|
396
|
-
@painter__.send :begin_paint
|
397
|
-
|
398
|
-
@auto_resize__ = false
|
399
|
-
end
|
400
|
-
|
401
|
-
def width ()
|
402
|
-
@window__.canvas.width
|
403
|
-
end
|
404
|
-
|
405
|
-
def height ()
|
406
|
-
@window__.canvas.height
|
407
|
-
end
|
408
|
-
|
409
|
-
def windowWidth ()
|
410
|
-
@window__.width
|
411
|
-
end
|
412
|
-
|
413
|
-
def windowHeight ()
|
414
|
-
@window__.height
|
415
|
-
end
|
416
|
-
|
417
|
-
# Returns number of frames since program started.
|
418
|
-
#
|
419
|
-
# @return [Integer] total number of frames
|
420
|
-
#
|
421
|
-
def frameCount ()
|
422
|
-
@frameCount__
|
423
|
-
end
|
143
|
+
end# TextBounds
|
424
144
|
|
425
|
-
# Returns number of frames per second.
|
426
|
-
#
|
427
|
-
# @return [Float] frames per second
|
428
|
-
#
|
429
|
-
def frameRate ()
|
430
|
-
@window__.event.fps
|
431
|
-
end
|
432
145
|
|
433
|
-
#
|
434
|
-
#
|
435
|
-
# @return [Numeric] pixel density
|
146
|
+
# Drawing context
|
436
147
|
#
|
437
|
-
|
438
|
-
@painter__.pixel_density
|
439
|
-
end
|
148
|
+
module GraphicsContext
|
440
149
|
|
441
|
-
|
442
|
-
|
443
|
-
|
444
|
-
#
|
445
|
-
def mouseX ()
|
446
|
-
@mouseX__
|
447
|
-
end
|
150
|
+
# PI / 2
|
151
|
+
#
|
152
|
+
HALF_PI = Math::PI / 2
|
448
153
|
|
449
|
-
|
450
|
-
|
451
|
-
|
452
|
-
#
|
453
|
-
def mouseY ()
|
454
|
-
@mouseY__
|
455
|
-
end
|
154
|
+
# PI / 4
|
155
|
+
#
|
156
|
+
QUARTER_PI = Math::PI / 4
|
456
157
|
|
457
|
-
|
458
|
-
|
459
|
-
|
460
|
-
#
|
461
|
-
def pmouseX ()
|
462
|
-
@mousePrevX__
|
463
|
-
end
|
158
|
+
# PI * 2
|
159
|
+
#
|
160
|
+
TWO_PI = Math::PI * 2
|
464
161
|
|
465
|
-
|
466
|
-
|
467
|
-
|
468
|
-
#
|
469
|
-
def pmouseY ()
|
470
|
-
@mousePrevY__
|
471
|
-
end
|
162
|
+
# PI * 2
|
163
|
+
#
|
164
|
+
TAU = Math::PI * 2
|
472
165
|
|
473
|
-
|
474
|
-
|
475
|
-
|
476
|
-
|
477
|
-
|
478
|
-
|
479
|
-
|
480
|
-
|
481
|
-
|
482
|
-
|
483
|
-
|
484
|
-
|
485
|
-
|
486
|
-
|
487
|
-
|
488
|
-
|
489
|
-
|
490
|
-
|
491
|
-
|
166
|
+
# RGB mode for colorMode().
|
167
|
+
#
|
168
|
+
RGB = :RGB
|
169
|
+
|
170
|
+
# HSB mode for colorMode().
|
171
|
+
#
|
172
|
+
HSB = :HSB
|
173
|
+
|
174
|
+
# Radian mode for angleMode().
|
175
|
+
#
|
176
|
+
RADIANS = :RADIANS
|
177
|
+
|
178
|
+
# Degree mode for angleMode().
|
179
|
+
#
|
180
|
+
DEGREES = :DEGREES
|
181
|
+
|
182
|
+
# Mode for rectMode(), ellipseMode() and imageMode().
|
183
|
+
#
|
184
|
+
CORNER = :CORNER
|
185
|
+
|
186
|
+
# Mode for rectMode(), ellipseMode() and imageMode().
|
187
|
+
#
|
188
|
+
CORNERS = :CORNERS
|
189
|
+
|
190
|
+
# Mode for rectMode(), ellipseMode() and imageMode().
|
191
|
+
#
|
192
|
+
CENTER = :CENTER
|
193
|
+
|
194
|
+
# Mode for rectMode() and ellipseMode().
|
195
|
+
#
|
196
|
+
RADIUS = :RADIUS
|
197
|
+
|
198
|
+
# Mode for strokeCap().
|
199
|
+
#
|
200
|
+
BUTT = :butt
|
492
201
|
|
493
|
-
|
494
|
-
|
202
|
+
# Mode for strokeJoin().
|
203
|
+
#
|
204
|
+
MITER = :miter
|
205
|
+
|
206
|
+
# Mode for strokeCap() and strokeJoin().
|
207
|
+
#
|
208
|
+
ROUND = :round
|
209
|
+
|
210
|
+
# Mode for strokeCap() and strokeJoin().
|
211
|
+
#
|
212
|
+
SQUARE = :square
|
213
|
+
|
214
|
+
def setup__ ()
|
215
|
+
@drawing = false
|
216
|
+
@hsbColor__ = false
|
217
|
+
@colorMaxes__ = [1.0] * 4
|
218
|
+
@angleScale__ = 1.0
|
219
|
+
@rectMode__ = nil
|
220
|
+
@ellipseMode__ = nil
|
221
|
+
@imageMode__ = nil
|
222
|
+
@matrixStack__ = []
|
223
|
+
@styleStack__ = []
|
224
|
+
|
225
|
+
colorMode RGB, 255
|
226
|
+
angleMode RADIANS
|
227
|
+
rectMode CORNER
|
228
|
+
ellipseMode CENTER
|
229
|
+
imageMode CORNER
|
230
|
+
end
|
231
|
+
|
232
|
+
def beginDraw ()
|
233
|
+
@matrixStack__.clear
|
234
|
+
@styleStack__.clear
|
235
|
+
@drawing = true
|
236
|
+
end
|
237
|
+
|
238
|
+
def endDraw ()
|
239
|
+
@drawing = false
|
240
|
+
end
|
241
|
+
|
242
|
+
def width ()
|
243
|
+
@image__.width
|
244
|
+
end
|
245
|
+
|
246
|
+
def height ()
|
247
|
+
@image__.height
|
248
|
+
end
|
249
|
+
|
250
|
+
# Sets color mode and max color values.
|
251
|
+
#
|
252
|
+
# @overload colorMode(mode)
|
253
|
+
# @overload colorMode(mode, max)
|
254
|
+
# @overload colorMode(mode, max1, max2, max3)
|
255
|
+
# @overload colorMode(mode, max1, max2, max3, maxA)
|
256
|
+
#
|
257
|
+
# @param mode [RGB, HSB] RGB or HSB
|
258
|
+
# @param max [Numeric] max values for all color values
|
259
|
+
# @param max1 [Numeric] max value for red or hue
|
260
|
+
# @param max2 [Numeric] max value for green or saturation
|
261
|
+
# @param max3 [Numeric] max value for blue or brightness
|
262
|
+
# @param maxA [Numeric] max value for alpha
|
263
|
+
#
|
264
|
+
# @return [nil] nil
|
265
|
+
#
|
266
|
+
def colorMode (mode, *maxes)
|
267
|
+
raise ArgumentError, "invalid color mode: #{mode}" unless [RGB, HSB].include?(mode)
|
268
|
+
raise ArgumentError unless [0, 1, 3, 4].include?(maxes.size)
|
269
|
+
|
270
|
+
@hsbColor__ = mode.upcase == HSB
|
271
|
+
case maxes.size
|
495
272
|
when 1 then @colorMaxes__ = [maxes.first.to_f] * 4
|
496
273
|
when 3, 4 then @colorMaxes__[0...maxes.size] = maxes.map &:to_f
|
274
|
+
end
|
275
|
+
nil
|
497
276
|
end
|
498
|
-
nil
|
499
|
-
end
|
500
277
|
|
501
|
-
|
502
|
-
|
503
|
-
|
504
|
-
|
278
|
+
# @private
|
279
|
+
private def toRGBA__ (*args)
|
280
|
+
a, b, c, d = args
|
281
|
+
return parseColor__(a, b || alphaMax__) if a.kind_of?(String)
|
505
282
|
|
506
|
-
|
507
|
-
|
508
|
-
|
509
|
-
|
283
|
+
rgba = case args.size
|
284
|
+
when 1, 2 then [a, a, a, b || alphaMax__]
|
285
|
+
when 3, 4 then [a, b, c, d || alphaMax__]
|
286
|
+
else raise ArgumentError
|
287
|
+
end
|
288
|
+
rgba = rgba.map.with_index {|value, i| value / @colorMaxes__[i]}
|
289
|
+
color = @hsbColor__ ? Rays::Color.hsv(*rgba) : Rays::Color.new(*rgba)
|
290
|
+
color.to_a
|
510
291
|
end
|
511
|
-
rgba = rgba.map.with_index {|value, i| value / @colorMaxes__[i]}
|
512
|
-
color = @hsbColor__ ? Rays::Color.hsv(*rgba) : Rays::Color.new(*rgba)
|
513
|
-
color.to_a
|
514
|
-
end
|
515
292
|
|
516
|
-
|
517
|
-
|
518
|
-
|
519
|
-
|
293
|
+
# @private
|
294
|
+
private def parseColor__ (str, alpha)
|
295
|
+
result = str.match /^\s*##{'([0-9a-f]{2})' * 3}\s*$/i
|
296
|
+
raise ArgumentError, "invalid color code: '#{str}'" unless result
|
520
297
|
|
521
|
-
|
522
|
-
|
523
|
-
|
298
|
+
rgb = result[1..3].map.with_index {|hex, i| hex.to_i(16) / 255.0}
|
299
|
+
return *rgb, (alpha / alphaMax__)
|
300
|
+
end
|
524
301
|
|
525
|
-
|
526
|
-
|
527
|
-
|
528
|
-
|
302
|
+
# @private
|
303
|
+
private def alphaMax__ ()
|
304
|
+
@colorMaxes__[3]
|
305
|
+
end
|
529
306
|
|
530
|
-
|
531
|
-
|
532
|
-
|
533
|
-
|
534
|
-
|
535
|
-
|
536
|
-
|
537
|
-
|
538
|
-
|
539
|
-
|
540
|
-
|
307
|
+
# Sets angle mode.
|
308
|
+
#
|
309
|
+
# @param mode [RADIANS, DEGREES] RADIANS or DEGREES
|
310
|
+
#
|
311
|
+
# @return [nil] nil
|
312
|
+
#
|
313
|
+
def angleMode (mode)
|
314
|
+
@angleScale__ = case mode
|
315
|
+
when RADIANS then Utility::RAD2DEG__
|
316
|
+
when DEGREES then 1.0
|
317
|
+
else raise ArgumentError, "invalid angle mode: #{mode}"
|
318
|
+
end
|
319
|
+
nil
|
320
|
+
end
|
321
|
+
|
322
|
+
# @private
|
323
|
+
private def toAngle__ (angle)
|
324
|
+
angle * @angleScale__
|
541
325
|
end
|
542
|
-
nil
|
543
|
-
end
|
544
326
|
|
545
|
-
|
546
|
-
|
547
|
-
|
548
|
-
|
327
|
+
# Sets rect mode. Default is CORNER.
|
328
|
+
#
|
329
|
+
# CORNER -> rect(left, top, width, height)
|
330
|
+
# CORNERS -> rect(left, top, right, bottom)
|
331
|
+
# CENTER -> rect(center_x, center_y, width, height)
|
332
|
+
# RADIUS -> rect(center_x, center_y, radius_h, radius_v)
|
333
|
+
#
|
334
|
+
# @param mode [CORNER, CORNERS, CENTER, RADIUS]
|
335
|
+
#
|
336
|
+
# @return [nil] nil
|
337
|
+
#
|
338
|
+
def rectMode (mode)
|
339
|
+
@rectMode__ = mode
|
340
|
+
end
|
549
341
|
|
550
|
-
|
551
|
-
|
552
|
-
|
553
|
-
|
554
|
-
|
555
|
-
|
556
|
-
|
557
|
-
|
558
|
-
|
559
|
-
|
560
|
-
|
561
|
-
|
562
|
-
|
563
|
-
|
342
|
+
# Sets ellipse mode. Default is CENTER.
|
343
|
+
#
|
344
|
+
# CORNER -> ellipse(left, top, width, height)
|
345
|
+
# CORNERS -> ellipse(left, top, right, bottom)
|
346
|
+
# CENTER -> ellipse(center_x, center_y, width, height)
|
347
|
+
# RADIUS -> ellipse(center_x, center_y, radius_h, radius_v)
|
348
|
+
#
|
349
|
+
# @param mode [CORNER, CORNERS, CENTER, RADIUS]
|
350
|
+
#
|
351
|
+
# @return [nil] nil
|
352
|
+
#
|
353
|
+
def ellipseMode (mode)
|
354
|
+
@ellipseMode__ = mode
|
355
|
+
end
|
564
356
|
|
565
|
-
|
566
|
-
|
567
|
-
|
568
|
-
|
569
|
-
|
570
|
-
|
571
|
-
|
572
|
-
|
573
|
-
|
574
|
-
|
575
|
-
|
576
|
-
|
577
|
-
|
578
|
-
|
579
|
-
|
580
|
-
|
581
|
-
|
582
|
-
|
583
|
-
|
584
|
-
|
585
|
-
|
586
|
-
|
587
|
-
else raise ArgumentError # ToDo: refine error message
|
588
|
-
end
|
589
|
-
end
|
590
|
-
|
591
|
-
# Clears screen.
|
592
|
-
#
|
593
|
-
# @overload background(str)
|
594
|
-
# @overload background(str, alpha)
|
595
|
-
# @overload background(gray)
|
596
|
-
# @overload background(gray, alpha)
|
597
|
-
# @overload background(r, g, b)
|
598
|
-
# @overload background(r, g, b, alpha)
|
599
|
-
#
|
600
|
-
# @param str [String] color code like '#00AAFF'
|
601
|
-
# @param gray [Integer] gray value (0..255)
|
602
|
-
# @param r [Integer] red value (0..255)
|
603
|
-
# @param g [Integer] green value (0..255)
|
604
|
-
# @param b [Integer] blue value (0..255)
|
605
|
-
# @param alpha [Integer] alpha value (0..255)
|
606
|
-
#
|
607
|
-
# @return [nil] nil
|
608
|
-
#
|
609
|
-
def background (*args)
|
610
|
-
rgba = toRGBA__ *args
|
611
|
-
if rgba[3] == 1
|
612
|
-
@painter__.background *rgba
|
613
|
-
else
|
614
|
-
@painter__.push fill: rgba, stroke: nil do |_|
|
615
|
-
@painter__.rect 0, 0, width, height
|
357
|
+
# Sets image mode. Default is CORNER.
|
358
|
+
#
|
359
|
+
# CORNER -> image(img, left, top, width, height)
|
360
|
+
# CORNERS -> image(img, left, top, right, bottom)
|
361
|
+
# CENTER -> image(img, center_x, center_y, width, height)
|
362
|
+
#
|
363
|
+
# @param mode [CORNER, CORNERS, CENTER]
|
364
|
+
#
|
365
|
+
# @return [nil] nil
|
366
|
+
#
|
367
|
+
def imageMode (mode)
|
368
|
+
@imageMode__ = mode
|
369
|
+
end
|
370
|
+
|
371
|
+
# @private
|
372
|
+
private def toXYWH__ (mode, a, b, c, d)
|
373
|
+
case mode
|
374
|
+
when CORNER then [a, b, c, d]
|
375
|
+
when CORNERS then [a, b, c - a, d - b]
|
376
|
+
when CENTER then [a - c / 2.0, b - d / 2.0, c, d]
|
377
|
+
when RADIUS then [a - c, b - d, c * 2, d * 2]
|
378
|
+
else raise ArgumentError # ToDo: refine error message
|
616
379
|
end
|
617
380
|
end
|
618
|
-
nil
|
619
|
-
end
|
620
381
|
|
621
|
-
|
622
|
-
|
623
|
-
|
624
|
-
|
625
|
-
|
626
|
-
|
627
|
-
|
628
|
-
|
629
|
-
|
630
|
-
|
631
|
-
|
632
|
-
|
633
|
-
|
634
|
-
|
635
|
-
|
636
|
-
|
637
|
-
|
638
|
-
|
639
|
-
|
640
|
-
|
641
|
-
|
642
|
-
|
382
|
+
# Sets fill color.
|
383
|
+
#
|
384
|
+
# @overload fill(rgb)
|
385
|
+
# @overload fill(rgb, alpha)
|
386
|
+
# @overload fill(gray)
|
387
|
+
# @overload fill(gray, alpha)
|
388
|
+
# @overload fill(r, g, b)
|
389
|
+
# @overload fill(r, g, b, alpha)
|
390
|
+
#
|
391
|
+
# @param rgb [String] color code like '#00AAFF'
|
392
|
+
# @param gray [Integer] gray value (0..255)
|
393
|
+
# @param r [Integer] red value (0..255)
|
394
|
+
# @param g [Integer] green value (0..255)
|
395
|
+
# @param b [Integer] blue value (0..255)
|
396
|
+
# @param alpha [Integer] alpha value (0..255)
|
397
|
+
#
|
398
|
+
# @return [nil] nil
|
399
|
+
#
|
400
|
+
def fill (*args)
|
401
|
+
@painter__.fill(*toRGBA__(*args))
|
402
|
+
nil
|
403
|
+
end
|
643
404
|
|
644
|
-
|
645
|
-
|
646
|
-
|
647
|
-
|
648
|
-
|
649
|
-
|
650
|
-
|
651
|
-
|
652
|
-
|
653
|
-
|
654
|
-
|
655
|
-
|
656
|
-
|
657
|
-
|
658
|
-
|
659
|
-
|
660
|
-
|
661
|
-
|
662
|
-
|
663
|
-
|
664
|
-
|
665
|
-
|
405
|
+
# Sets stroke color.
|
406
|
+
#
|
407
|
+
# @overload stroke(rgb)
|
408
|
+
# @overload stroke(rgb, alpha)
|
409
|
+
# @overload stroke(gray)
|
410
|
+
# @overload stroke(gray, alpha)
|
411
|
+
# @overload stroke(r, g, b)
|
412
|
+
# @overload stroke(r, g, b, alpha)
|
413
|
+
#
|
414
|
+
# @param rgb [String] color code like '#00AAFF'
|
415
|
+
# @param gray [Integer] gray value (0..255)
|
416
|
+
# @param r [Integer] red value (0..255)
|
417
|
+
# @param g [Integer] green value (0..255)
|
418
|
+
# @param b [Integer] blue value (0..255)
|
419
|
+
# @param alpha [Integer] alpha value (0..255)
|
420
|
+
#
|
421
|
+
# @return [nil] nil
|
422
|
+
#
|
423
|
+
def stroke (*args)
|
424
|
+
@painter__.stroke(*toRGBA__(*args))
|
425
|
+
nil
|
426
|
+
end
|
666
427
|
|
667
|
-
|
668
|
-
|
669
|
-
|
670
|
-
|
671
|
-
|
672
|
-
|
673
|
-
|
674
|
-
|
675
|
-
|
676
|
-
|
428
|
+
# Sets stroke weight.
|
429
|
+
#
|
430
|
+
# @param weight [Numeric] width of stroke
|
431
|
+
#
|
432
|
+
# @return [nil] nil
|
433
|
+
#
|
434
|
+
def strokeWeight (weight)
|
435
|
+
@painter__.stroke_width weight
|
436
|
+
nil
|
437
|
+
end
|
677
438
|
|
678
|
-
|
679
|
-
|
680
|
-
|
681
|
-
|
682
|
-
|
683
|
-
|
684
|
-
|
685
|
-
|
439
|
+
# Sets stroke cap mode.
|
440
|
+
#
|
441
|
+
# @param cap [BUTT, ROUND, SQUARE]
|
442
|
+
#
|
443
|
+
# @return [nil] nil
|
444
|
+
#
|
445
|
+
def strokeCap (cap)
|
446
|
+
@painter__.stroke_cap cap
|
447
|
+
nil
|
448
|
+
end
|
686
449
|
|
687
|
-
|
688
|
-
|
689
|
-
|
690
|
-
|
691
|
-
|
692
|
-
|
693
|
-
|
694
|
-
|
450
|
+
# Sets stroke join mode.
|
451
|
+
#
|
452
|
+
# @param join [MITER, ROUND, SQUARE]
|
453
|
+
#
|
454
|
+
# @return [nil] nil
|
455
|
+
#
|
456
|
+
def strokeJoin (join)
|
457
|
+
@painter__.stroke_join join
|
458
|
+
nil
|
459
|
+
end
|
695
460
|
|
696
|
-
|
697
|
-
|
698
|
-
|
699
|
-
|
700
|
-
|
701
|
-
|
702
|
-
|
703
|
-
|
704
|
-
@painter__.font name, size if name || size
|
705
|
-
Font.new @painter__.font
|
706
|
-
end
|
461
|
+
# Disables filling.
|
462
|
+
#
|
463
|
+
# @return [nil] nil
|
464
|
+
#
|
465
|
+
def noFill ()
|
466
|
+
@painter__.fill nil
|
467
|
+
nil
|
468
|
+
end
|
707
469
|
|
708
|
-
|
709
|
-
|
710
|
-
|
711
|
-
|
712
|
-
|
713
|
-
|
714
|
-
|
715
|
-
|
716
|
-
nil
|
717
|
-
end
|
470
|
+
# Disables drawing stroke.
|
471
|
+
#
|
472
|
+
# @return [nil] nil
|
473
|
+
#
|
474
|
+
def noStroke ()
|
475
|
+
@painter__.stroke nil
|
476
|
+
nil
|
477
|
+
end
|
718
478
|
|
719
|
-
|
720
|
-
|
721
|
-
|
722
|
-
|
723
|
-
|
724
|
-
|
725
|
-
|
726
|
-
|
727
|
-
|
728
|
-
|
729
|
-
|
730
|
-
nil
|
731
|
-
end
|
732
|
-
|
733
|
-
# Draws a line.
|
734
|
-
#
|
735
|
-
# @param x1 [Numeric] horizontal position for first point
|
736
|
-
# @param y1 [Numeric] vertical position for first point
|
737
|
-
# @param x2 [Numeric] horizontal position for second point
|
738
|
-
# @param y2 [Numeric] vertical position for second point
|
739
|
-
#
|
740
|
-
# @return [nil] nil
|
741
|
-
#
|
742
|
-
def line (x1, y1, x2, y2)
|
743
|
-
@painter__.line x1, y1, x2, y2
|
744
|
-
nil
|
745
|
-
end
|
479
|
+
# Sets font.
|
480
|
+
#
|
481
|
+
# @param name [String] font name
|
482
|
+
# @param size [Numeric] font size
|
483
|
+
#
|
484
|
+
# @return [Font] current font
|
485
|
+
#
|
486
|
+
def textFont (name = nil, size = nil)
|
487
|
+
@painter__.font name, size if name || size
|
488
|
+
Font.new @painter__.font
|
489
|
+
end
|
746
490
|
|
747
|
-
|
748
|
-
|
749
|
-
|
750
|
-
|
751
|
-
|
752
|
-
|
753
|
-
|
754
|
-
|
755
|
-
|
756
|
-
|
757
|
-
|
758
|
-
|
759
|
-
|
760
|
-
|
761
|
-
|
762
|
-
|
763
|
-
|
764
|
-
|
765
|
-
|
766
|
-
|
767
|
-
|
491
|
+
# Sets text size.
|
492
|
+
#
|
493
|
+
# @param size [Numeric] font size
|
494
|
+
#
|
495
|
+
# @return [nil] nil
|
496
|
+
#
|
497
|
+
def textSize (size)
|
498
|
+
@painter__.font @painter__.font.name, size
|
499
|
+
nil
|
500
|
+
end
|
501
|
+
|
502
|
+
# Clears screen.
|
503
|
+
#
|
504
|
+
# @overload background(str)
|
505
|
+
# @overload background(str, alpha)
|
506
|
+
# @overload background(gray)
|
507
|
+
# @overload background(gray, alpha)
|
508
|
+
# @overload background(r, g, b)
|
509
|
+
# @overload background(r, g, b, alpha)
|
510
|
+
#
|
511
|
+
# @param str [String] color code like '#00AAFF'
|
512
|
+
# @param gray [Integer] gray value (0..255)
|
513
|
+
# @param r [Integer] red value (0..255)
|
514
|
+
# @param g [Integer] green value (0..255)
|
515
|
+
# @param b [Integer] blue value (0..255)
|
516
|
+
# @param alpha [Integer] alpha value (0..255)
|
517
|
+
#
|
518
|
+
# @return [nil] nil
|
519
|
+
#
|
520
|
+
def background (*args)
|
521
|
+
assertDrawing__
|
522
|
+
rgba = toRGBA__ *args
|
523
|
+
if rgba[3] == 1
|
524
|
+
@painter__.background *rgba
|
525
|
+
else
|
526
|
+
@painter__.push fill: rgba, stroke: nil do |_|
|
527
|
+
@painter__.rect 0, 0, width, height
|
528
|
+
end
|
529
|
+
end
|
530
|
+
nil
|
531
|
+
end
|
532
|
+
|
533
|
+
# Draws a point.
|
534
|
+
#
|
535
|
+
# @param x [Numeric] horizontal position
|
536
|
+
# @param y [Numeric] vertical position
|
537
|
+
#
|
538
|
+
# @return [nil] nil
|
539
|
+
#
|
540
|
+
def point (x, y)
|
541
|
+
assertDrawing__
|
542
|
+
w = @painter__.stroke_width
|
543
|
+
w = 1 if w == 0
|
544
|
+
@painter__.ellipse x - (w / 2.0), y - (w / 2.0), w, w
|
545
|
+
nil
|
546
|
+
end
|
547
|
+
|
548
|
+
# Draws a line.
|
549
|
+
#
|
550
|
+
# @param x1 [Numeric] horizontal position of first point
|
551
|
+
# @param y1 [Numeric] vertical position of first point
|
552
|
+
# @param x2 [Numeric] horizontal position of second point
|
553
|
+
# @param y2 [Numeric] vertical position of second point
|
554
|
+
#
|
555
|
+
# @return [nil] nil
|
556
|
+
#
|
557
|
+
def line (x1, y1, x2, y2)
|
558
|
+
assertDrawing__
|
559
|
+
@painter__.line x1, y1, x2, y2
|
560
|
+
nil
|
561
|
+
end
|
562
|
+
|
563
|
+
# Draws a rectangle.
|
564
|
+
#
|
565
|
+
# @overload rect(a, b, c, d)
|
566
|
+
# @overload rect(a, b, c, d, r)
|
567
|
+
# @overload rect(a, b, c, d, tl, tr, br, bl)
|
568
|
+
#
|
569
|
+
# @param a [Numeric] horizontal position of the shape by default
|
570
|
+
# @param b [Numeric] vertical position of the shape by default
|
571
|
+
# @param c [Numeric] width of the shape by default
|
572
|
+
# @param d [Numeric] height of the shape by default
|
573
|
+
# @param r [Numeric] radius for all corners
|
574
|
+
# @param tl [Numeric] radius for top-left corner
|
575
|
+
# @param tr [Numeric] radius for top-right corner
|
576
|
+
# @param br [Numeric] radius for bottom-right corner
|
577
|
+
# @param bl [Numeric] radius for bottom-left corner
|
578
|
+
#
|
579
|
+
# @return [nil] nil
|
580
|
+
#
|
581
|
+
def rect (a, b, c, d, *args)
|
582
|
+
assertDrawing__
|
583
|
+
x, y, w, h = toXYWH__ @rectMode__, a, b, c, d
|
584
|
+
case args.size
|
768
585
|
when 0 then @painter__.rect x, y, w, h
|
769
586
|
when 1 then @painter__.rect x, y, w, h, round: args[0]
|
770
587
|
when 4 then @painter__.rect x, y, w, h, lt: args[0], rt: args[1], rb: args[2], lb: args[3]
|
771
588
|
else raise ArgumentError # ToDo: refine error message
|
589
|
+
end
|
590
|
+
nil
|
772
591
|
end
|
773
|
-
nil
|
774
|
-
end
|
775
592
|
|
776
|
-
|
777
|
-
|
778
|
-
|
779
|
-
|
780
|
-
|
781
|
-
|
782
|
-
|
783
|
-
|
784
|
-
|
785
|
-
|
786
|
-
|
787
|
-
|
788
|
-
|
789
|
-
|
593
|
+
# Draws an ellipse.
|
594
|
+
#
|
595
|
+
# @param a [Numeric] horizontal position of the shape
|
596
|
+
# @param b [Numeric] vertical position of the shape
|
597
|
+
# @param c [Numeric] width of the shape
|
598
|
+
# @param d [Numeric] height of the shape
|
599
|
+
#
|
600
|
+
# @return [nil] nil
|
601
|
+
#
|
602
|
+
def ellipse (a, b, c, d)
|
603
|
+
assertDrawing__
|
604
|
+
x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
|
605
|
+
@painter__.ellipse x, y, w, h
|
606
|
+
nil
|
607
|
+
end
|
790
608
|
|
791
|
-
|
792
|
-
|
793
|
-
|
794
|
-
|
795
|
-
|
796
|
-
|
797
|
-
|
798
|
-
|
799
|
-
|
800
|
-
|
801
|
-
|
609
|
+
# Draws a circle.
|
610
|
+
#
|
611
|
+
# @param x [Numeric] horizontal position of the shape
|
612
|
+
# @param y [Numeric] vertical position of the shape
|
613
|
+
# @param extent [Numeric] width and height of the shape
|
614
|
+
#
|
615
|
+
# @return [nil] nil
|
616
|
+
#
|
617
|
+
def circle (x, y, extent)
|
618
|
+
ellipse x, y, extent, extent
|
619
|
+
end
|
802
620
|
|
803
|
-
|
804
|
-
|
805
|
-
|
806
|
-
|
807
|
-
|
808
|
-
|
809
|
-
|
810
|
-
|
811
|
-
|
812
|
-
|
813
|
-
|
814
|
-
|
815
|
-
|
816
|
-
|
817
|
-
|
818
|
-
|
819
|
-
|
820
|
-
|
821
|
-
|
822
|
-
# Draws a square.
|
823
|
-
#
|
824
|
-
# @param x [Numeric] horizontal position of the shape
|
825
|
-
# @param y [Numeric] vertical position of the shape
|
826
|
-
# @param extent [Numeric] width and height of the shape
|
827
|
-
#
|
828
|
-
# @return [nil] nil
|
829
|
-
#
|
830
|
-
def square (x, y, extent)
|
831
|
-
rect x, y, extent, extent
|
832
|
-
end
|
621
|
+
# Draws an arc.
|
622
|
+
#
|
623
|
+
# @param a [Numeric] horizontal position of the shape
|
624
|
+
# @param b [Numeric] vertical position of the shape
|
625
|
+
# @param c [Numeric] width of the shape
|
626
|
+
# @param d [Numeric] height of the shape
|
627
|
+
# @param start [Numeric] angle to start the arc
|
628
|
+
# @param stop [Numeric] angle to stop the arc
|
629
|
+
#
|
630
|
+
# @return [nil] nil
|
631
|
+
#
|
632
|
+
def arc (a, b, c, d, start, stop)
|
633
|
+
assertDrawing__
|
634
|
+
x, y, w, h = toXYWH__ @ellipseMode__, a, b, c, d
|
635
|
+
start = toAngle__ start
|
636
|
+
stop = toAngle__ stop
|
637
|
+
@painter__.ellipse x, y, w, h, from: start, to: stop
|
638
|
+
nil
|
639
|
+
end
|
833
640
|
|
834
|
-
|
835
|
-
|
836
|
-
|
837
|
-
|
838
|
-
|
839
|
-
|
840
|
-
|
841
|
-
|
842
|
-
|
843
|
-
|
844
|
-
|
845
|
-
def triangle (x1, y1, x2, y2, x3, y3)
|
846
|
-
@painter__.line x1, y1, x2, y2, x3, y3, loop: true
|
847
|
-
nil
|
848
|
-
end
|
641
|
+
# Draws a square.
|
642
|
+
#
|
643
|
+
# @param x [Numeric] horizontal position of the shape
|
644
|
+
# @param y [Numeric] vertical position of the shape
|
645
|
+
# @param extent [Numeric] width and height of the shape
|
646
|
+
#
|
647
|
+
# @return [nil] nil
|
648
|
+
#
|
649
|
+
def square (x, y, extent)
|
650
|
+
rect x, y, extent, extent
|
651
|
+
end
|
849
652
|
|
850
|
-
|
851
|
-
|
852
|
-
|
853
|
-
|
854
|
-
|
855
|
-
|
856
|
-
|
857
|
-
|
858
|
-
|
859
|
-
|
860
|
-
|
861
|
-
|
862
|
-
|
863
|
-
|
864
|
-
|
865
|
-
|
866
|
-
end
|
653
|
+
# Draws a triangle.
|
654
|
+
#
|
655
|
+
# @param x1 [Numeric] horizontal position of first point
|
656
|
+
# @param y1 [Numeric] vertical position of first point
|
657
|
+
# @param x2 [Numeric] horizontal position of second point
|
658
|
+
# @param y2 [Numeric] vertical position of second point
|
659
|
+
# @param x3 [Numeric] horizontal position of third point
|
660
|
+
# @param y3 [Numeric] vertical position of third point
|
661
|
+
#
|
662
|
+
# @return [nil] nil
|
663
|
+
#
|
664
|
+
def triangle (x1, y1, x2, y2, x3, y3)
|
665
|
+
assertDrawing__
|
666
|
+
@painter__.line x1, y1, x2, y2, x3, y3, loop: true
|
667
|
+
nil
|
668
|
+
end
|
867
669
|
|
868
|
-
|
869
|
-
|
870
|
-
|
871
|
-
|
872
|
-
|
873
|
-
|
874
|
-
|
875
|
-
|
876
|
-
|
877
|
-
|
878
|
-
|
879
|
-
|
880
|
-
|
881
|
-
|
882
|
-
|
670
|
+
# Draws a quad.
|
671
|
+
#
|
672
|
+
# @param x1 [Numeric] horizontal position of first point
|
673
|
+
# @param y1 [Numeric] vertical position of first point
|
674
|
+
# @param x2 [Numeric] horizontal position of second point
|
675
|
+
# @param y2 [Numeric] vertical position of second point
|
676
|
+
# @param x3 [Numeric] horizontal position of third point
|
677
|
+
# @param y3 [Numeric] vertical position of third point
|
678
|
+
# @param x4 [Numeric] horizontal position of fourth point
|
679
|
+
# @param y4 [Numeric] vertical position of fourth point
|
680
|
+
#
|
681
|
+
# @return [nil] nil
|
682
|
+
#
|
683
|
+
def quad (x1, y1, x2, y2, x3, y3, x4, y4)
|
684
|
+
assertDrawing__
|
685
|
+
@painter__.line x1, y1, x2, y2, x3, y3, x4, y4, loop: true
|
686
|
+
nil
|
687
|
+
end
|
883
688
|
|
884
|
-
|
885
|
-
|
886
|
-
|
887
|
-
|
888
|
-
|
889
|
-
|
890
|
-
|
891
|
-
|
892
|
-
|
893
|
-
|
894
|
-
|
895
|
-
|
896
|
-
|
897
|
-
|
898
|
-
|
899
|
-
|
900
|
-
|
901
|
-
|
902
|
-
end
|
903
|
-
|
904
|
-
# Applies translation matrix to current transformation matrix.
|
905
|
-
#
|
906
|
-
# @param x [Numeric] horizontal transformation
|
907
|
-
# @param y [Numeric] vertical transformation
|
908
|
-
#
|
909
|
-
# @return [nil] nil
|
910
|
-
#
|
911
|
-
def translate (x, y)
|
912
|
-
@painter__.translate x, y
|
913
|
-
nil
|
914
|
-
end
|
689
|
+
# Draws a Catmull-Rom spline curve.
|
690
|
+
#
|
691
|
+
# @param cx1 [Numeric] horizontal position of beginning control point
|
692
|
+
# @param cy1 [Numeric] vertical position of beginning control point
|
693
|
+
# @param x1 [Numeric] horizontal position of first point
|
694
|
+
# @param y1 [Numeric] vertical position of first point
|
695
|
+
# @param x2 [Numeric] horizontal position of second point
|
696
|
+
# @param y2 [Numeric] vertical position of second point
|
697
|
+
# @param cx2 [Numeric] horizontal position of ending control point
|
698
|
+
# @param cy2 [Numeric] vertical position of ending control point
|
699
|
+
#
|
700
|
+
# @return [nil] nil
|
701
|
+
#
|
702
|
+
def curve (cx1, cy1, x1, y1, x2, y2, cx2, cy2)
|
703
|
+
assertDrawing__
|
704
|
+
@painter__.curve cx1, cy1, x1, y1, x2, y2, cx2, cy2
|
705
|
+
nil
|
706
|
+
end
|
915
707
|
|
916
|
-
|
917
|
-
|
918
|
-
|
919
|
-
|
920
|
-
|
921
|
-
|
922
|
-
|
923
|
-
|
924
|
-
|
925
|
-
|
926
|
-
|
927
|
-
|
928
|
-
|
929
|
-
|
930
|
-
|
708
|
+
# Draws a Bezier spline curve.
|
709
|
+
#
|
710
|
+
# @param x1 [Numeric] horizontal position of first point
|
711
|
+
# @param y1 [Numeric] vertical position of first point
|
712
|
+
# @param cx1 [Numeric] horizontal position of first control point
|
713
|
+
# @param cy1 [Numeric] vertical position of first control point
|
714
|
+
# @param cx2 [Numeric] horizontal position of second control point
|
715
|
+
# @param cy2 [Numeric] vertical position of second control point
|
716
|
+
# @param x2 [Numeric] horizontal position of second point
|
717
|
+
# @param y2 [Numeric] vertical position of second point
|
718
|
+
#
|
719
|
+
# @return [nil] nil
|
720
|
+
#
|
721
|
+
def bezier (x1, y1, cx1, cy1, cx2, cy2, x2, y2)
|
722
|
+
assertDrawing__
|
723
|
+
@painter__.bezier x1, y1, cx1, cy1, cx2, cy2, x2, y2
|
724
|
+
nil
|
725
|
+
end
|
931
726
|
|
932
|
-
|
933
|
-
|
934
|
-
|
935
|
-
|
936
|
-
|
937
|
-
|
938
|
-
|
939
|
-
@
|
940
|
-
|
941
|
-
|
727
|
+
# Draws a text.
|
728
|
+
#
|
729
|
+
# @overload text(str)
|
730
|
+
# @overload text(str, x, y)
|
731
|
+
#
|
732
|
+
# @param str [String] text to draw
|
733
|
+
# @param x [Numeric] horizontal position of the text
|
734
|
+
# @param y [Numeric] vertical position of the text
|
735
|
+
#
|
736
|
+
# @return [nil] nil
|
737
|
+
#
|
738
|
+
def text (str, x, y)
|
739
|
+
assertDrawing__
|
740
|
+
@painter__.text str, x, y
|
741
|
+
nil
|
742
|
+
end
|
942
743
|
|
943
|
-
|
944
|
-
|
945
|
-
|
946
|
-
|
947
|
-
|
948
|
-
@
|
949
|
-
|
950
|
-
|
744
|
+
# Draws an image.
|
745
|
+
#
|
746
|
+
# @overload image(img, a, b)
|
747
|
+
# @overload image(img, a, b, c, d)
|
748
|
+
#
|
749
|
+
# @param img [Image] image to draw
|
750
|
+
# @param a [Numeric] horizontal position of the image
|
751
|
+
# @param b [Numeric] vertical position of the image
|
752
|
+
# @param c [Numeric] width of the image
|
753
|
+
# @param d [Numeric] height of the image
|
754
|
+
#
|
755
|
+
# @return [nil] nil
|
756
|
+
#
|
757
|
+
def image (img, a, b, c = nil, d = nil)
|
758
|
+
assertDrawing__
|
759
|
+
x, y, w, h = toXYWH__ @imageMode__, a, b, c || img.width, d || img.height
|
760
|
+
@painter__.image img.getInternal__, x, y, w, h
|
761
|
+
nil
|
762
|
+
end
|
951
763
|
|
952
|
-
|
953
|
-
|
954
|
-
|
955
|
-
|
956
|
-
|
957
|
-
|
958
|
-
@
|
959
|
-
|
960
|
-
|
764
|
+
# Copies image.
|
765
|
+
#
|
766
|
+
# @overload copy(sx, sy, sw, sh, dx, dy, dw, dh)
|
767
|
+
# @overload copy(img, sx, sy, sw, sh, dx, dy, dw, dh)
|
768
|
+
#
|
769
|
+
# @param img [Image] image for copy source
|
770
|
+
# @param sx [Numrtic] x position of source region
|
771
|
+
# @param sy [Numrtic] y position of source region
|
772
|
+
# @param sw [Numrtic] width of source region
|
773
|
+
# @param sh [Numrtic] height of source region
|
774
|
+
# @param dx [Numrtic] x position of destination region
|
775
|
+
# @param dy [Numrtic] y position of destination region
|
776
|
+
# @param dw [Numrtic] width of destination region
|
777
|
+
# @param dh [Numrtic] height of destination region
|
778
|
+
#
|
779
|
+
# @return [nil] nil
|
780
|
+
#
|
781
|
+
def copy (img = nil, sx, sy, sw, sh, dx, dy, dw, dh)
|
782
|
+
assertDrawing__
|
783
|
+
src = img&.getInternal__ || @window__.canvas
|
784
|
+
@painter__.image src, sx, sy, sw, sh, dx, dy, dw, dh
|
785
|
+
end
|
961
786
|
|
962
|
-
|
963
|
-
|
964
|
-
|
965
|
-
|
966
|
-
|
967
|
-
@
|
968
|
-
|
969
|
-
|
787
|
+
# Applies translation matrix to current transformation matrix.
|
788
|
+
#
|
789
|
+
# @param x [Numeric] horizontal transformation
|
790
|
+
# @param y [Numeric] vertical transformation
|
791
|
+
#
|
792
|
+
# @return [nil] nil
|
793
|
+
#
|
794
|
+
def translate (x, y)
|
795
|
+
assertDrawing__
|
796
|
+
@painter__.translate x, y
|
797
|
+
nil
|
798
|
+
end
|
970
799
|
|
971
|
-
|
972
|
-
|
973
|
-
|
974
|
-
|
975
|
-
|
976
|
-
@
|
800
|
+
# Applies scale matrix to current transformation matrix.
|
801
|
+
#
|
802
|
+
# @overload scale(s)
|
803
|
+
# @overload scale(x, y)
|
804
|
+
#
|
805
|
+
# @param s [Numeric] horizontal and vertical scale
|
806
|
+
# @param x [Numeric] horizontal scale
|
807
|
+
# @param y [Numeric] vertical scale
|
808
|
+
#
|
809
|
+
# @return [nil] nil
|
810
|
+
#
|
811
|
+
def scale (x, y)
|
812
|
+
assertDrawing__
|
813
|
+
@painter__.scale x, y
|
814
|
+
nil
|
815
|
+
end
|
816
|
+
|
817
|
+
# Applies rotation matrix to current transformation matrix.
|
818
|
+
#
|
819
|
+
# @param angle [Numeric] angle for rotation
|
820
|
+
#
|
821
|
+
# @return [nil] nil
|
822
|
+
#
|
823
|
+
def rotate (angle)
|
824
|
+
assertDrawing__
|
825
|
+
@painter__.rotate toAngle__ angle
|
826
|
+
nil
|
827
|
+
end
|
828
|
+
|
829
|
+
# Pushes the current transformation matrix to stack.
|
830
|
+
#
|
831
|
+
# @return [nil] nil
|
832
|
+
#
|
833
|
+
def pushMatrix (&block)
|
834
|
+
assertDrawing__
|
835
|
+
@matrixStack__.push @painter__.matrix
|
836
|
+
if block
|
837
|
+
block.call
|
838
|
+
popMatrix
|
839
|
+
end
|
840
|
+
nil
|
841
|
+
end
|
842
|
+
|
843
|
+
# Pops the current transformation matrix from stack.
|
844
|
+
#
|
845
|
+
# @return [nil] nil
|
846
|
+
#
|
847
|
+
def popMatrix ()
|
848
|
+
assertDrawing__
|
849
|
+
raise "matrix stack underflow" if @matrixStack__.empty?
|
850
|
+
@painter__.matrix = @matrixStack__.pop
|
851
|
+
nil
|
852
|
+
end
|
853
|
+
|
854
|
+
# Reset current transformation matrix with identity matrix.
|
855
|
+
#
|
856
|
+
# @return [nil] nil
|
857
|
+
#
|
858
|
+
def resetMatrix ()
|
859
|
+
assertDrawing__
|
860
|
+
@painter__.matrix = 1
|
861
|
+
nil
|
862
|
+
end
|
863
|
+
|
864
|
+
# Save current style values to the style stack.
|
865
|
+
#
|
866
|
+
# @return [nil] nil
|
867
|
+
#
|
868
|
+
def pushStyle (&block)
|
869
|
+
assertDrawing__
|
870
|
+
@styleStack__.push [
|
871
|
+
@painter__.fill,
|
872
|
+
@painter__.stroke,
|
873
|
+
@painter__.stroke_width,
|
874
|
+
@painter__.stroke_cap,
|
875
|
+
@painter__.stroke_join,
|
876
|
+
@painter__.font,
|
877
|
+
@hsbColor__,
|
878
|
+
@colorMaxes__,
|
879
|
+
@angleScale__,
|
880
|
+
@rectMode__,
|
881
|
+
@ellipseMode__,
|
882
|
+
@imageMode__
|
883
|
+
]
|
884
|
+
if block
|
885
|
+
block.call
|
886
|
+
popStyle
|
887
|
+
end
|
888
|
+
nil
|
889
|
+
end
|
890
|
+
|
891
|
+
# Restore style values from the style stack.
|
892
|
+
#
|
893
|
+
# @return [nil] nil
|
894
|
+
#
|
895
|
+
def popStyle ()
|
896
|
+
assertDrawing__
|
897
|
+
raise "style stack underflow" if @styleStack__.empty?
|
977
898
|
@painter__.fill,
|
978
899
|
@painter__.stroke,
|
979
900
|
@painter__.stroke_width,
|
901
|
+
@painter__.stroke_cap,
|
902
|
+
@painter__.stroke_join,
|
980
903
|
@painter__.font,
|
981
904
|
@hsbColor__,
|
982
905
|
@colorMaxes__,
|
983
906
|
@angleScale__,
|
984
907
|
@rectMode__,
|
985
|
-
@ellipseMode__
|
986
|
-
|
987
|
-
|
988
|
-
|
908
|
+
@ellipseMode__,
|
909
|
+
@imageMode__ = @styleStack__.pop
|
910
|
+
nil
|
911
|
+
end
|
989
912
|
|
990
|
-
|
991
|
-
|
992
|
-
|
993
|
-
|
994
|
-
|
995
|
-
|
996
|
-
|
997
|
-
|
998
|
-
|
999
|
-
|
1000
|
-
|
1001
|
-
|
1002
|
-
@angleScale__,
|
1003
|
-
@rectMode__,
|
1004
|
-
@ellipseMode__ = @styleStack__.pop
|
1005
|
-
nil
|
1006
|
-
end
|
1007
|
-
|
1008
|
-
# Save current styles and transformations to stack.
|
1009
|
-
#
|
1010
|
-
# @return [nil] nil
|
1011
|
-
#
|
1012
|
-
def push ()
|
1013
|
-
pushMatrix
|
1014
|
-
pushStyle
|
1015
|
-
end
|
913
|
+
# Save current styles and transformations to stack.
|
914
|
+
#
|
915
|
+
# @return [nil] nil
|
916
|
+
#
|
917
|
+
def push (&block)
|
918
|
+
pushMatrix
|
919
|
+
pushStyle
|
920
|
+
if block
|
921
|
+
block.call
|
922
|
+
pop
|
923
|
+
end
|
924
|
+
end
|
1016
925
|
|
1017
|
-
|
1018
|
-
|
1019
|
-
|
1020
|
-
|
1021
|
-
|
1022
|
-
|
1023
|
-
|
1024
|
-
|
926
|
+
# Restore styles and transformations from stack.
|
927
|
+
#
|
928
|
+
# @return [nil] nil
|
929
|
+
#
|
930
|
+
def pop ()
|
931
|
+
popMatrix
|
932
|
+
popStyle
|
933
|
+
end
|
1025
934
|
|
1026
|
-
|
1027
|
-
|
1028
|
-
|
1029
|
-
|
1030
|
-
#
|
1031
|
-
# @param x [Numeric] horizontal point in noise space
|
1032
|
-
# @param y [Numeric] vertical point in noise space
|
1033
|
-
#
|
1034
|
-
# @return [Numeric] noise value (0.0..1.0)
|
1035
|
-
#
|
1036
|
-
def noise (x, y = 0)
|
1037
|
-
Rays.perlin(x, y) / 2.0 + 1.0
|
1038
|
-
end
|
935
|
+
# @private
|
936
|
+
def getInternal__ ()
|
937
|
+
@image__
|
938
|
+
end
|
1039
939
|
|
1040
|
-
|
1041
|
-
|
1042
|
-
|
1043
|
-
|
940
|
+
# @private
|
941
|
+
def assertDrawing__ ()
|
942
|
+
raise "call beginDraw() before drawing" unless @drawing
|
943
|
+
end
|
944
|
+
|
945
|
+
end# GraphicsContext
|
946
|
+
|
947
|
+
|
948
|
+
# Draws graphics into an offscreen buffer
|
1044
949
|
#
|
1045
|
-
|
1046
|
-
|
1047
|
-
|
1048
|
-
|
1049
|
-
|
1050
|
-
|
1051
|
-
|
1052
|
-
|
1053
|
-
|
1054
|
-
|
1055
|
-
|
1056
|
-
|
1057
|
-
|
1058
|
-
|
1059
|
-
|
1060
|
-
|
1061
|
-
|
1062
|
-
|
1063
|
-
|
1064
|
-
|
1065
|
-
|
950
|
+
class Graphics
|
951
|
+
|
952
|
+
include GraphicsContext
|
953
|
+
|
954
|
+
def initialize (width, height)
|
955
|
+
setup__
|
956
|
+
@image__ = Rays::Image.new width, height
|
957
|
+
@painter__ = @image__.painter
|
958
|
+
end
|
959
|
+
|
960
|
+
def beginDraw ()
|
961
|
+
@painter__.__send__ :begin_paint
|
962
|
+
super
|
963
|
+
push
|
964
|
+
end
|
965
|
+
|
966
|
+
def endDraw ()
|
967
|
+
pop
|
968
|
+
super
|
969
|
+
@painter__.__send__ :end_paint
|
970
|
+
end
|
971
|
+
|
972
|
+
end# Graphics
|
973
|
+
|
974
|
+
|
975
|
+
module Utility
|
976
|
+
|
977
|
+
# @private
|
978
|
+
DEG2RAD__ = Math::PI / 180.0
|
979
|
+
|
980
|
+
# @private
|
981
|
+
RAD2DEG__ = 180.0 / Math::PI
|
982
|
+
|
983
|
+
# Converts degree to radian.
|
984
|
+
#
|
985
|
+
# @param degree [Numeric] degree to convert
|
986
|
+
#
|
987
|
+
# @return [Numeric] radian
|
988
|
+
#
|
989
|
+
def radians (degree)
|
990
|
+
degree * DEG2RAD__
|
991
|
+
end
|
992
|
+
|
993
|
+
# Converts radian to degree.
|
994
|
+
#
|
995
|
+
# @param radian [Numeric] radian to convert
|
996
|
+
#
|
997
|
+
# @return [Numeric] degree
|
998
|
+
#
|
999
|
+
def degrees (radian)
|
1000
|
+
radian * RAD2DEG__
|
1001
|
+
end
|
1002
|
+
|
1003
|
+
# Returns the absolute number of the value.
|
1004
|
+
#
|
1005
|
+
# @param value [Numeric] number
|
1006
|
+
#
|
1007
|
+
# @return [Numeric] absolute number
|
1008
|
+
#
|
1009
|
+
def abs (value)
|
1010
|
+
value.abs
|
1011
|
+
end
|
1012
|
+
|
1013
|
+
# Returns the closest integer number greater than or equal to the value.
|
1014
|
+
#
|
1015
|
+
# @param value [Numeric] number
|
1016
|
+
#
|
1017
|
+
# @return [Numeric] rounded up number
|
1018
|
+
#
|
1019
|
+
def ceil (value)
|
1020
|
+
value.ceil
|
1021
|
+
end
|
1022
|
+
|
1023
|
+
# Returns the closest integer number less than or equal to the value.
|
1024
|
+
#
|
1025
|
+
# @param value [Numeric] number
|
1026
|
+
#
|
1027
|
+
# @return [Numeric] rounded down number
|
1028
|
+
#
|
1029
|
+
def floor (value)
|
1030
|
+
value.floor
|
1031
|
+
end
|
1032
|
+
|
1033
|
+
# Returns the closest integer number.
|
1034
|
+
#
|
1035
|
+
# @param value [Numeric] number
|
1036
|
+
#
|
1037
|
+
# @return [Numeric] rounded number
|
1038
|
+
#
|
1039
|
+
def round (value)
|
1040
|
+
value.round
|
1041
|
+
end
|
1042
|
+
|
1043
|
+
# Returns value raised to the power of exponent.
|
1044
|
+
#
|
1045
|
+
# @param value [Numeric] base number
|
1046
|
+
# @param exponent [Numeric] exponent number
|
1047
|
+
#
|
1048
|
+
# @return [Numeric] value ** exponent
|
1049
|
+
#
|
1050
|
+
def pow (value, exponent)
|
1051
|
+
value ** exponent
|
1052
|
+
end
|
1053
|
+
|
1054
|
+
# Returns squared value.
|
1055
|
+
#
|
1056
|
+
# @param value [Numeric] number
|
1057
|
+
#
|
1058
|
+
# @return [Numeric] squared value
|
1059
|
+
#
|
1060
|
+
def sq (value)
|
1061
|
+
value * value
|
1062
|
+
end
|
1063
|
+
|
1064
|
+
# Returns the magnitude (or length) of a vector.
|
1065
|
+
#
|
1066
|
+
# @overload mag(x, y)
|
1067
|
+
# @overload mag(x, y, z)
|
1068
|
+
#
|
1069
|
+
# @param x [Numeric] x of point
|
1070
|
+
# @param y [Numeric] y of point
|
1071
|
+
# @param z [Numeric] z of point
|
1072
|
+
#
|
1073
|
+
# @return [Numeric] magnitude
|
1074
|
+
#
|
1075
|
+
def mag (*args)
|
1076
|
+
x, y, z = *args
|
1077
|
+
case args.size
|
1078
|
+
when 2 then Math.sqrt x * x + y * y
|
1079
|
+
when 3 then Math.sqrt x * x + y * y + z * z
|
1080
|
+
else raise ArgumentError
|
1081
|
+
end
|
1082
|
+
end
|
1083
|
+
|
1084
|
+
# Returns distance between 2 points.
|
1085
|
+
#
|
1086
|
+
# @overload dist(x1, y1, x2, y2)
|
1087
|
+
# @overload dist(x1, y1, z1, x2, y2, z2)
|
1088
|
+
#
|
1089
|
+
# @param x1 [Numeric] x of first point
|
1090
|
+
# @param y1 [Numeric] y of first point
|
1091
|
+
# @param z1 [Numeric] z of first point
|
1092
|
+
# @param x2 [Numeric] x of second point
|
1093
|
+
# @param y2 [Numeric] y of second point
|
1094
|
+
# @param z2 [Numeric] z of second point
|
1095
|
+
#
|
1096
|
+
# @return [Numeric] distance between 2 points
|
1097
|
+
#
|
1098
|
+
def dist (*args)
|
1099
|
+
case args.size
|
1100
|
+
when 4
|
1101
|
+
x1, y1, x2, y2 = *args
|
1102
|
+
xx, yy = x2 - x1, y2 - y1
|
1103
|
+
Math.sqrt xx * xx + yy * yy
|
1104
|
+
when 3
|
1105
|
+
x1, y1, z1, x2, y2, z2 = *args
|
1106
|
+
xx, yy, zz = x2 - x1, y2 - y1, z2 - z1
|
1107
|
+
Math.sqrt xx * xx + yy * yy + zz * zz
|
1108
|
+
else raise ArgumentError
|
1109
|
+
end
|
1110
|
+
end
|
1111
|
+
|
1112
|
+
# Normalize the value from range start..stop into 0..1.
|
1113
|
+
#
|
1114
|
+
# @param value [Numeric] number to be normalized
|
1115
|
+
# @param start [Numeric] lower bound of the range
|
1116
|
+
# @param stop [Numeric] upper bound of the range
|
1117
|
+
#
|
1118
|
+
# @return [Numeric] normalized value between 0..1
|
1119
|
+
#
|
1120
|
+
def norm (value, start, stop)
|
1121
|
+
(value.to_f - start.to_f) / (stop.to_f - start.to_f)
|
1122
|
+
end
|
1123
|
+
|
1124
|
+
# Returns the interpolated number between range start..stop.
|
1125
|
+
#
|
1126
|
+
# @param start [Numeric] lower bound of the range
|
1127
|
+
# @param stop [Numeric] upper bound of the range
|
1128
|
+
# @param amount [Numeric] amount to interpolate
|
1129
|
+
#
|
1130
|
+
# @return [Numeric] interporated number
|
1131
|
+
#
|
1132
|
+
def lerp (start, stop, amount)
|
1133
|
+
start + (stop - start) * amount
|
1134
|
+
end
|
1135
|
+
|
1136
|
+
# Maps a number from range start1..stop1 to range start2..stop2.
|
1137
|
+
#
|
1138
|
+
# @param value [Numeric] number to be mapped
|
1139
|
+
# @param start1 [Numeric] lower bound of the range1
|
1140
|
+
# @param stop1 [Numeric] upper bound of the range1
|
1141
|
+
# @param start2 [Numeric] lower bound of the range2
|
1142
|
+
# @param stop2 [Numeric] upper bound of the range2
|
1143
|
+
#
|
1144
|
+
# @return [Numeric] mapped number
|
1145
|
+
#
|
1146
|
+
def map (value, start1, stop1, start2, stop2)
|
1147
|
+
lerp start2, stop2, norm(value, start1, stop1)
|
1148
|
+
end
|
1149
|
+
|
1150
|
+
# Returns minimum value.
|
1151
|
+
#
|
1152
|
+
# @overload min(a, b)
|
1153
|
+
# @overload min(a, b, c)
|
1154
|
+
# @overload min(array)
|
1155
|
+
#
|
1156
|
+
# @param a [Numeric] value to compare
|
1157
|
+
# @param b [Numeric] value to compare
|
1158
|
+
# @param c [Numeric] value to compare
|
1159
|
+
# @param array [Numeric] values to compare
|
1160
|
+
#
|
1161
|
+
# @return [Numeric] minimum value
|
1162
|
+
#
|
1163
|
+
def min (*args)
|
1164
|
+
args.flatten.min
|
1165
|
+
end
|
1166
|
+
|
1167
|
+
# Returns maximum value.
|
1168
|
+
#
|
1169
|
+
# @overload max(a, b)
|
1170
|
+
# @overload max(a, b, c)
|
1171
|
+
# @overload max(array)
|
1172
|
+
#
|
1173
|
+
# @param a [Numeric] value to compare
|
1174
|
+
# @param b [Numeric] value to compare
|
1175
|
+
# @param c [Numeric] value to compare
|
1176
|
+
# @param array [Numeric] values to compare
|
1177
|
+
#
|
1178
|
+
# @return [Numeric] maximum value
|
1179
|
+
#
|
1180
|
+
def max (*args)
|
1181
|
+
args.flatten.max
|
1182
|
+
end
|
1183
|
+
|
1184
|
+
# Constrains the number between min..max.
|
1185
|
+
#
|
1186
|
+
# @param value [Numeric] number to be constrained
|
1187
|
+
# @param min [Numeric] lower bound of the range
|
1188
|
+
# @param max [Numeric] upper bound of the range
|
1189
|
+
#
|
1190
|
+
# @return [Numeric] constrained number
|
1191
|
+
#
|
1192
|
+
def constrain (value, min, max)
|
1193
|
+
value < min ? min : (value > max ? max : value)
|
1194
|
+
end
|
1195
|
+
|
1196
|
+
# Returns the perlin noise value.
|
1197
|
+
#
|
1198
|
+
# @overload noise(x)
|
1199
|
+
# @overload noise(x, y)
|
1200
|
+
# @overload noise(x, y, z)
|
1201
|
+
#
|
1202
|
+
# @param x [Numeric] horizontal point in noise space
|
1203
|
+
# @param y [Numeric] vertical point in noise space
|
1204
|
+
# @param z [Numeric] depth point in noise space
|
1205
|
+
#
|
1206
|
+
# @return [Numeric] noise value (0.0..1.0)
|
1207
|
+
#
|
1208
|
+
def noise (x, y = 0, z = 0)
|
1209
|
+
Rays.perlin(x, y, z) / 2.0 + 0.5
|
1210
|
+
end
|
1211
|
+
|
1212
|
+
# Loads image.
|
1213
|
+
#
|
1214
|
+
# @param filename [String] file name to load image
|
1215
|
+
# @param extension [String] type of image to load (ex. 'png')
|
1216
|
+
#
|
1217
|
+
# @return [Image] loaded image object
|
1218
|
+
#
|
1219
|
+
def loadImage (filename, extension = nil)
|
1220
|
+
filename = getImage__ filename, extension if filename =~ %r|^https?://|
|
1221
|
+
Image.new Rays::Image.load filename
|
1222
|
+
end
|
1223
|
+
|
1224
|
+
# @private
|
1225
|
+
private def getImage__ (uri, ext)
|
1226
|
+
ext ||= File.extname uri
|
1227
|
+
raise "unsupported image type -- #{ext}" unless ext =~ /^\.?(png)$/i
|
1228
|
+
|
1229
|
+
tmpdir = Pathname(Dir.tmpdir) + Digest::SHA1.hexdigest(self.class.name)
|
1230
|
+
path = tmpdir + Digest::SHA1.hexdigest(uri)
|
1231
|
+
path = path.sub_ext ext
|
1232
|
+
|
1233
|
+
unless path.file?
|
1234
|
+
URI.open uri do |input|
|
1235
|
+
tmpdir.mkdir unless tmpdir.directory?
|
1236
|
+
path.open('w') do |output|
|
1237
|
+
while buf = input.read(2 ** 16)
|
1238
|
+
output.write buf
|
1239
|
+
end
|
1066
1240
|
end
|
1067
1241
|
end
|
1068
1242
|
end
|
1243
|
+
path.to_s
|
1069
1244
|
end
|
1070
|
-
path.to_s
|
1071
|
-
end
|
1072
1245
|
|
1073
|
-
|
1246
|
+
def createGraphics (width, height)
|
1247
|
+
Graphics.new width, height
|
1248
|
+
end
|
1074
1249
|
|
1250
|
+
end# Utility
|
1075
1251
|
|
1076
|
-
# Image object.
|
1077
|
-
#
|
1078
|
-
class Processing::Image
|
1079
1252
|
|
1080
|
-
#
|
1253
|
+
# Processing context
|
1081
1254
|
#
|
1082
|
-
|
1083
|
-
@image = image
|
1084
|
-
end
|
1255
|
+
module Context
|
1085
1256
|
|
1086
|
-
|
1087
|
-
#
|
1088
|
-
# @return [Numeric] width of image
|
1089
|
-
#
|
1090
|
-
def width ()
|
1091
|
-
@image.width
|
1092
|
-
end
|
1257
|
+
include GraphicsContext, Utility, Math
|
1093
1258
|
|
1094
|
-
|
1095
|
-
|
1096
|
-
|
1097
|
-
|
1098
|
-
|
1099
|
-
|
1100
|
-
|
1259
|
+
# @private
|
1260
|
+
def setup__ (window)
|
1261
|
+
super()
|
1262
|
+
@loop__ = true
|
1263
|
+
@redraw__ = false
|
1264
|
+
@frameCount__ = 0
|
1265
|
+
@mouseX__ =
|
1266
|
+
@mouseY__ =
|
1267
|
+
@mousePrevX__ =
|
1268
|
+
@mousePrevY__ = 0
|
1269
|
+
@mousePressed__ = false
|
1101
1270
|
|
1102
|
-
|
1103
|
-
|
1104
|
-
|
1105
|
-
#
|
1106
|
-
def save (filename)
|
1107
|
-
@image.save filename
|
1108
|
-
end
|
1271
|
+
@window__ = window
|
1272
|
+
@image__ = @window__.canvas
|
1273
|
+
@painter__ = @window__.canvas_painter
|
1109
1274
|
|
1110
|
-
|
1111
|
-
def internal ()
|
1112
|
-
@image
|
1113
|
-
end
|
1275
|
+
@painter__.miter_limit = 10
|
1114
1276
|
|
1115
|
-
|
1277
|
+
drawFrame = -> event {
|
1278
|
+
@image__ = @window__.canvas
|
1279
|
+
@painter__ = @window__.canvas_painter
|
1280
|
+
begin
|
1281
|
+
push
|
1282
|
+
@drawBlock__.call event if @drawBlock__
|
1283
|
+
ensure
|
1284
|
+
pop
|
1285
|
+
@frameCount__ += 1
|
1286
|
+
end
|
1287
|
+
}
|
1288
|
+
|
1289
|
+
updateMouseState = -> x, y, pressed = nil {
|
1290
|
+
@mouseX__ = x
|
1291
|
+
@mouseY__ = y
|
1292
|
+
@mousePressed__ = pressed if pressed != nil
|
1293
|
+
}
|
1294
|
+
|
1295
|
+
updateMousePrevPos = -> {
|
1296
|
+
@mousePrevX__ = @mouseX__
|
1297
|
+
@mousePrevY__ = @mouseY__
|
1298
|
+
}
|
1299
|
+
|
1300
|
+
@window__.before_draw = proc {beginDraw}
|
1301
|
+
@window__.after_draw = proc {endDraw}
|
1302
|
+
|
1303
|
+
@window__.draw = proc do |e|
|
1304
|
+
if @loop__ || @redraw__
|
1305
|
+
@redraw__ = false
|
1306
|
+
drawFrame.call e
|
1307
|
+
end
|
1308
|
+
updateMousePrevPos.call
|
1309
|
+
end
|
1116
1310
|
|
1311
|
+
@window__.pointer_down = proc do |e|
|
1312
|
+
updateMouseState.call e.x, e.y, true
|
1313
|
+
@mousePressedBlock__.call e if @mousePressedBlock__
|
1314
|
+
end
|
1117
1315
|
|
1118
|
-
|
1119
|
-
|
1120
|
-
|
1316
|
+
@window__.pointer_up = proc do |e|
|
1317
|
+
updateMouseState.call e.x, e.y, false
|
1318
|
+
@mouseReleasedBlock__.call e if @mouseReleasedBlock__
|
1319
|
+
end
|
1121
1320
|
|
1122
|
-
|
1123
|
-
|
1124
|
-
|
1125
|
-
|
1126
|
-
def initialize (font)
|
1127
|
-
@font = font
|
1128
|
-
end
|
1321
|
+
@window__.pointer_move = proc do |e|
|
1322
|
+
updateMouseState.call e.x, e.y
|
1323
|
+
@mouseMovedBlock__.call e if @mouseMovedBlock__
|
1324
|
+
end
|
1129
1325
|
|
1130
|
-
|
1131
|
-
|
1132
|
-
|
1133
|
-
|
1134
|
-
|
1135
|
-
#
|
1136
|
-
# @param str [String] text to calculate bounding box
|
1137
|
-
# @param x [Numeric] horizontal position of bounding box
|
1138
|
-
# @param y [Numeric] vertical position of bounding box
|
1139
|
-
# @param fontSize [Numeric] font size
|
1140
|
-
#
|
1141
|
-
# @return [TextBounds] bounding box for text
|
1142
|
-
#
|
1143
|
-
def textBounds (str, x = 0, y = 0, fontSize = nil)
|
1144
|
-
f = fontSize ? Rays::Font.new(@font.name, fontSize) : @font
|
1145
|
-
TextBounds.new x, y, x + f.width(str), y + f.height
|
1146
|
-
end
|
1326
|
+
@window__.pointer_drag = proc do |e|
|
1327
|
+
updateMouseState.call e.x, e.y
|
1328
|
+
@mouseDraggedBlock__.call e if @mouseDraggedBlock__
|
1329
|
+
end
|
1330
|
+
end
|
1147
1331
|
|
1148
|
-
|
1332
|
+
# Define setup block.
|
1333
|
+
#
|
1334
|
+
def setup (&block)
|
1335
|
+
@window__.setup = block
|
1336
|
+
nil
|
1337
|
+
end
|
1149
1338
|
|
1339
|
+
# Define draw block.
|
1340
|
+
#
|
1341
|
+
def draw (&block)
|
1342
|
+
@drawBlock__ = block if block
|
1343
|
+
nil
|
1344
|
+
end
|
1150
1345
|
|
1151
|
-
|
1152
|
-
|
1153
|
-
|
1346
|
+
def key (&block)
|
1347
|
+
@window__.key = block
|
1348
|
+
nil
|
1349
|
+
end
|
1154
1350
|
|
1155
|
-
|
1156
|
-
|
1157
|
-
|
1351
|
+
def mousePressed (&block)
|
1352
|
+
@mousePressedBlock__ = block if block
|
1353
|
+
@mousePressed__
|
1354
|
+
end
|
1158
1355
|
|
1159
|
-
|
1160
|
-
|
1161
|
-
|
1356
|
+
def mouseReleased (&block)
|
1357
|
+
@mouseReleasedBlock__ = block if block
|
1358
|
+
nil
|
1359
|
+
end
|
1162
1360
|
|
1163
|
-
|
1164
|
-
|
1165
|
-
|
1361
|
+
def mouseMoved (&block)
|
1362
|
+
@mouseMovedBlock__ = block if block
|
1363
|
+
nil
|
1364
|
+
end
|
1166
1365
|
|
1167
|
-
|
1168
|
-
|
1169
|
-
|
1366
|
+
def mouseDragged (&block)
|
1367
|
+
@mouseDraggedBlock__ = block if block
|
1368
|
+
nil
|
1369
|
+
end
|
1170
1370
|
|
1171
|
-
|
1172
|
-
|
1173
|
-
|
1174
|
-
|
1175
|
-
|
1176
|
-
|
1177
|
-
|
1178
|
-
|
1179
|
-
|
1180
|
-
|
1371
|
+
# @private
|
1372
|
+
private def size__ (width, height)
|
1373
|
+
raise 'size() must be called on startup or setup block' if @started__
|
1374
|
+
|
1375
|
+
@painter__.__send__ :end_paint
|
1376
|
+
@window__.__send__ :reset_canvas, width, height
|
1377
|
+
@painter__.__send__ :begin_paint
|
1378
|
+
|
1379
|
+
@auto_resize__ = false
|
1380
|
+
end
|
1381
|
+
|
1382
|
+
def windowWidth ()
|
1383
|
+
@window__.width
|
1384
|
+
end
|
1385
|
+
|
1386
|
+
def windowHeight ()
|
1387
|
+
@window__.height
|
1388
|
+
end
|
1389
|
+
|
1390
|
+
# Returns number of frames since program started.
|
1391
|
+
#
|
1392
|
+
# @return [Integer] total number of frames
|
1393
|
+
#
|
1394
|
+
def frameCount ()
|
1395
|
+
@frameCount__
|
1396
|
+
end
|
1397
|
+
|
1398
|
+
# Returns number of frames per second.
|
1399
|
+
#
|
1400
|
+
# @return [Float] frames per second
|
1401
|
+
#
|
1402
|
+
def frameRate ()
|
1403
|
+
@window__.event.fps
|
1404
|
+
end
|
1405
|
+
|
1406
|
+
# Returns pixel density
|
1407
|
+
#
|
1408
|
+
# @return [Numeric] pixel density
|
1409
|
+
#
|
1410
|
+
def displayDensity ()
|
1411
|
+
@painter__.pixel_density
|
1412
|
+
end
|
1413
|
+
|
1414
|
+
# Returns mouse x position
|
1415
|
+
#
|
1416
|
+
# @return [Numeric] horizontal position of mouse
|
1417
|
+
#
|
1418
|
+
def mouseX ()
|
1419
|
+
@mouseX__
|
1420
|
+
end
|
1421
|
+
|
1422
|
+
# Returns mouse y position
|
1423
|
+
#
|
1424
|
+
# @return [Numeric] vertical position of mouse
|
1425
|
+
#
|
1426
|
+
def mouseY ()
|
1427
|
+
@mouseY__
|
1428
|
+
end
|
1181
1429
|
|
1182
|
-
|
1430
|
+
# Returns mouse x position in previous frame
|
1431
|
+
#
|
1432
|
+
# @return [Numeric] horizontal position of mouse
|
1433
|
+
#
|
1434
|
+
def pmouseX ()
|
1435
|
+
@mousePrevX__
|
1436
|
+
end
|
1437
|
+
|
1438
|
+
# Returns mouse y position in previous frame
|
1439
|
+
#
|
1440
|
+
# @return [Numeric] vertical position of mouse
|
1441
|
+
#
|
1442
|
+
def pmouseY ()
|
1443
|
+
@mousePrevY__
|
1444
|
+
end
|
1445
|
+
|
1446
|
+
# Enables calling draw block on every frame.
|
1447
|
+
#
|
1448
|
+
# @return [nil] nil
|
1449
|
+
#
|
1450
|
+
def loop ()
|
1451
|
+
@loop__ = true
|
1452
|
+
end
|
1453
|
+
|
1454
|
+
# Disables calling draw block on every frame.
|
1455
|
+
#
|
1456
|
+
# @return [nil] nil
|
1457
|
+
#
|
1458
|
+
def noLoop ()
|
1459
|
+
@loop__ = false
|
1460
|
+
end
|
1461
|
+
|
1462
|
+
# Calls draw block to redraw frame.
|
1463
|
+
#
|
1464
|
+
# @return [nil] nil
|
1465
|
+
#
|
1466
|
+
def redraw ()
|
1467
|
+
@redraw__ = true
|
1468
|
+
end
|
1469
|
+
|
1470
|
+
end# Context
|
1471
|
+
|
1472
|
+
|
1473
|
+
end# Processing
|
1183
1474
|
|
1184
1475
|
|
1185
1476
|
end# RubySketch
|