Merge branch 'DragonRuby:master' into masterHEADmaster

4 files changed, 437 insertions, 5 deletions

diff --git a/samples/03_rendering_sprites/01_animation_using_separate_pngs/app/main.rb b/samples/03_rendering_sprites/01_animation_using_separate_pngs/app/main.rb
index c5622e8..b25aa83 100644
--- a/samples/03_rendering_sprites/01_animation_using_separate_pngs/app/main.rb
+++ b/samples/03_rendering_sprites/01_animation_using_separate_pngs/app/main.rb
@@ -10,12 +10,15 @@
 
  - args.outputs.sprites: An array. Values in this array generate sprites on the screen.
    The parameters are [X, Y, WIDTH, HEIGHT, IMAGE PATH]
+   For more information about sprites, go to mygame/documentation/05-sprites.md.
 
  - args.outputs.labels: An array. Values in the array generate labels on the screen.
    The parameters are [X, Y, TEXT, SIZE, ALIGNMENT, RED, GREEN, BLUE, ALPHA, FONT STYLE]
+   For more information about labels, go to mygame/documentation/02-labels.md.
 
  - args.inputs.keyboard.key_down.KEY: Determines if a key is in the down state, or pressed.
    Stores the frame that key was pressed on.
+   For more information about the keyboard, go to mygame/documentation/06-keyboard.md.
 
 =end
 
@@ -28,6 +31,8 @@
 # in this tick "entry point": `looping_animation`, and the
 # second method is `one_time_animation`.
 def tick args
+  # uncomment the line below to see animation play out in slow motion
+  # args.gtk.slowmo! 6
   looping_animation args
   one_time_animation args
 end
@@ -60,22 +65,22 @@ def looping_animation args
                                               does_sprite_loop
 
   # Now that we have `sprite_index, we can present the correct file.
-  args.outputs.sprites << [100, 100, 100, 100, "sprites/dragon_fly_#{sprite_index}.png"]
+  args.outputs.sprites << { x: 100, y: 100, w: 100, h: 100, path: "sprites/dragon_fly_#{sprite_index}.png" }
 
   # Try changing the numbers below to see how the animation changes:
-  args.outputs.sprites << [100, 200, 100, 100, "sprites/dragon_fly_#{0.frame_index 6, 4, true}.png"]
+  args.outputs.sprites << { x: 100, y: 200, w: 100, h: 100, path: "sprites/dragon_fly_#{0.frame_index 6, 4, true}.png" }
 end
 
 # This function shows how to animate a sprite that executes
 # only once when the "f" key is pressed.
 def one_time_animation args
   # This is just a label the shows instructions within the game.
-  args.outputs.labels << [220, 350, "(press f to animate)"]
+  args.outputs.labels <<  { x: 220, y: 350, text: "(press f to animate)" }
 
   # If "f" is pressed on the keyboard...
   if args.inputs.keyboard.key_down.f
     # Print the frame that "f" was pressed on.
-    puts "Hello from main.rb! The \"f\" key was in the down state on frame: #{args.inputs.keyboard.key_down.f}"
+    puts "Hello from main.rb! The \"f\" key was in the down state on frame: #{args.state.tick_count}"
 
     # And MOST IMPORTANTLY set the point it time to start the animation,
     # equal to "now" which is represented as args.state.tick_count.
@@ -108,7 +113,7 @@ def one_time_animation args
   sprite_index ||= 0
 
   # Present the sprite.
-  args.outputs.sprites << [100, 300, 100, 100, "sprites/dragon_fly_#{sprite_index}.png"]
+  args.outputs.sprites << { x: 100, y: 300, w: 100, h: 100, path: "sprites/dragon_fly_#{sprite_index}.png" }
 
   tick_instructions args, "Sample app shows how to use Numeric#frame_index and string interpolation to animate a sprite over time."
 end
diff --git a/samples/03_rendering_sprites/02_animation_using_sprite_sheet/replay.txt b/samples/03_rendering_sprites/02_animation_using_sprite_sheet/replay.txt
new file mode 100644
index 0000000..8927ef0
--- /dev/null
+++ b/samples/03_rendering_sprites/02_animation_using_sprite_sheet/replay.txt
@@ -0,0 +1,241 @@
+replay_version 2.0
+stopped_at 805
+seed 100
+recorded_at Sat Jul 17 09:26:10 2021
+[:mouse_button_up, 1, 0, 1, 1, 6]
+[:key_down_raw, 1073741906, 0, 2, 2, 69]
+[:key_down_raw, 1073741906, 0, 2, 3, 83]
+[:key_down_raw, 1073741906, 0, 2, 4, 85]
+[:key_down_raw, 1073741906, 0, 2, 5, 87]
+[:key_down_raw, 1073741906, 0, 2, 6, 89]
+[:key_down_raw, 1073741906, 0, 2, 7, 91]
+[:key_down_raw, 1073741906, 0, 2, 8, 93]
+[:key_down_raw, 1073741906, 0, 2, 9, 95]
+[:key_down_raw, 1073741906, 0, 2, 10, 97]
+[:key_down_raw, 1073741906, 0, 2, 11, 99]
+[:key_down_raw, 1073741906, 0, 2, 12, 101]
+[:key_down_raw, 1073741906, 0, 2, 13, 103]
+[:key_down_raw, 1073741906, 0, 2, 14, 105]
+[:key_down_raw, 1073741906, 0, 2, 15, 107]
+[:key_down_raw, 1073741906, 0, 2, 16, 109]
+[:key_down_raw, 1073741906, 0, 2, 17, 111]
+[:key_down_raw, 1073741906, 0, 2, 18, 113]
+[:key_down_raw, 1073741906, 0, 2, 19, 115]
+[:key_down_raw, 1073741906, 0, 2, 20, 117]
+[:key_down_raw, 1073741906, 0, 2, 21, 119]
+[:key_down_raw, 1073741906, 0, 2, 22, 121]
+[:key_down_raw, 1073741906, 0, 2, 23, 123]
+[:key_down_raw, 1073741906, 0, 2, 24, 125]
+[:key_down_raw, 1073741906, 0, 2, 25, 127]
+[:key_down_raw, 1073741906, 0, 2, 26, 129]
+[:key_up_raw, 1073741906, 0, 2, 27, 130]
+[:key_down_raw, 1073741903, 0, 2, 28, 131]
+[:key_down_raw, 1073741903, 0, 2, 29, 146]
+[:key_down_raw, 1073741903, 0, 2, 30, 148]
+[:key_down_raw, 1073741903, 0, 2, 31, 150]
+[:key_down_raw, 1073741903, 0, 2, 32, 152]
+[:key_down_raw, 1073741903, 0, 2, 33, 154]
+[:key_down_raw, 1073741903, 0, 2, 34, 156]
+[:key_down_raw, 1073741903, 0, 2, 35, 158]
+[:key_down_raw, 1073741903, 0, 2, 36, 160]
+[:key_down_raw, 1073741903, 0, 2, 37, 162]
+[:key_down_raw, 1073741903, 0, 2, 38, 164]
+[:key_down_raw, 1073741903, 0, 2, 39, 166]
+[:key_down_raw, 1073741903, 0, 2, 40, 168]
+[:key_down_raw, 1073741903, 0, 2, 41, 170]
+[:key_down_raw, 1073741903, 0, 2, 42, 172]
+[:key_down_raw, 1073741903, 0, 2, 43, 174]
+[:key_down_raw, 1073741903, 0, 2, 44, 176]
+[:key_down_raw, 1073741903, 0, 2, 45, 178]
+[:key_down_raw, 1073741903, 0, 2, 46, 180]
+[:key_down_raw, 1073741903, 0, 2, 47, 182]
+[:key_down_raw, 1073741903, 0, 2, 48, 184]
+[:key_down_raw, 1073741903, 0, 2, 49, 186]
+[:key_down_raw, 1073741903, 0, 2, 50, 189]
+[:key_down_raw, 1073741903, 0, 2, 51, 190]
+[:key_down_raw, 1073741903, 0, 2, 52, 192]
+[:key_down_raw, 1073741903, 0, 2, 53, 194]
+[:key_down_raw, 1073741903, 0, 2, 54, 196]
+[:key_down_raw, 1073741903, 0, 2, 55, 198]
+[:key_down_raw, 1073741903, 0, 2, 56, 200]
+[:key_down_raw, 1073741903, 0, 2, 57, 203]
+[:key_down_raw, 1073741903, 0, 2, 58, 204]
+[:key_down_raw, 1073741903, 0, 2, 59, 206]
+[:key_down_raw, 1073741903, 0, 2, 60, 208]
+[:key_down_raw, 1073741903, 0, 2, 61, 210]
+[:key_down_raw, 1073741903, 0, 2, 62, 212]
+[:key_down_raw, 1073741903, 0, 2, 63, 214]
+[:key_down_raw, 1073741903, 0, 2, 64, 216]
+[:key_down_raw, 1073741903, 0, 2, 65, 218]
+[:key_down_raw, 1073741903, 0, 2, 66, 220]
+[:key_down_raw, 1073741904, 0, 2, 67, 221]
+[:key_up_raw, 1073741903, 0, 2, 68, 225]
+[:key_down_raw, 1073741904, 0, 2, 69, 236]
+[:key_down_raw, 1073741904, 0, 2, 70, 238]
+[:key_down_raw, 1073741904, 0, 2, 71, 240]
+[:key_down_raw, 1073741904, 0, 2, 72, 242]
+[:key_down_raw, 1073741904, 0, 2, 73, 244]
+[:key_down_raw, 1073741904, 0, 2, 74, 246]
+[:key_down_raw, 1073741904, 0, 2, 75, 248]
+[:key_down_raw, 1073741904, 0, 2, 76, 250]
+[:key_up_raw, 1073741904, 0, 2, 77, 251]
+[:key_down_raw, 1073741906, 0, 2, 78, 253]
+[:key_down_raw, 1073741906, 0, 2, 79, 268]
+[:key_down_raw, 1073741906, 0, 2, 80, 270]
+[:key_down_raw, 1073741906, 0, 2, 81, 272]
+[:key_down_raw, 1073741906, 0, 2, 82, 275]
+[:key_down_raw, 1073741906, 0, 2, 83, 276]
+[:key_down_raw, 1073741906, 0, 2, 84, 278]
+[:key_down_raw, 1073741906, 0, 2, 85, 280]
+[:key_down_raw, 1073741906, 0, 2, 86, 283]
+[:key_down_raw, 1073741906, 0, 2, 87, 285]
+[:key_down_raw, 1073741906, 0, 2, 88, 287]
+[:key_down_raw, 1073741906, 0, 2, 89, 289]
+[:key_down_raw, 1073741906, 0, 2, 90, 291]
+[:key_down_raw, 1073741906, 0, 2, 91, 293]
+[:key_down_raw, 1073741906, 0, 2, 92, 294]
+[:key_down_raw, 1073741906, 0, 2, 93, 296]
+[:key_down_raw, 1073741906, 0, 2, 94, 299]
+[:key_down_raw, 1073741906, 0, 2, 95, 301]
+[:key_down_raw, 1073741906, 0, 2, 96, 303]
+[:key_up_raw, 1073741906, 0, 2, 97, 303]
+[:key_down_raw, 1073741905, 0, 2, 98, 307]
+[:key_down_raw, 1073741905, 0, 2, 99, 322]
+[:key_down_raw, 1073741905, 0, 2, 100, 324]
+[:key_down_raw, 1073741905, 0, 2, 101, 326]
+[:key_down_raw, 1073741905, 0, 2, 102, 328]
+[:key_down_raw, 1073741905, 0, 2, 103, 330]
+[:key_down_raw, 1073741905, 0, 2, 104, 332]
+[:key_down_raw, 1073741905, 0, 2, 105, 334]
+[:key_down_raw, 1073741905, 0, 2, 106, 336]
+[:key_up_raw, 1073741905, 0, 2, 107, 336]
+[:key_down_raw, 1073741903, 0, 2, 108, 337]
+[:key_down_raw, 1073741906, 0, 2, 109, 342]
+[:key_down_raw, 1073741906, 0, 2, 110, 357]
+[:key_down_raw, 1073741906, 0, 2, 111, 359]
+[:key_down_raw, 1073741906, 0, 2, 112, 361]
+[:key_down_raw, 1073741906, 0, 2, 113, 363]
+[:key_down_raw, 1073741906, 0, 2, 114, 365]
+[:key_down_raw, 1073741906, 0, 2, 115, 367]
+[:key_down_raw, 1073741906, 0, 2, 116, 369]
+[:key_down_raw, 1073741906, 0, 2, 117, 371]
+[:key_down_raw, 1073741906, 0, 2, 118, 373]
+[:key_down_raw, 1073741906, 0, 2, 119, 375]
+[:key_down_raw, 1073741906, 0, 2, 120, 377]
+[:key_down_raw, 1073741906, 0, 2, 121, 379]
+[:key_down_raw, 1073741906, 0, 2, 122, 381]
+[:key_down_raw, 1073741906, 0, 2, 123, 383]
+[:key_down_raw, 1073741906, 0, 2, 124, 385]
+[:key_down_raw, 1073741906, 0, 2, 125, 387]
+[:key_down_raw, 1073741906, 0, 2, 126, 389]
+[:key_down_raw, 1073741906, 0, 2, 127, 391]
+[:key_up_raw, 1073741903, 0, 2, 128, 392]
+[:key_down_raw, 1073741906, 0, 2, 129, 393]
+[:key_up_raw, 1073741906, 0, 2, 130, 394]
+[:key_down_raw, 1073741904, 0, 2, 131, 404]
+[:key_down_raw, 1073741905, 0, 2, 132, 407]
+[:key_down_raw, 1073741905, 0, 2, 133, 421]
+[:key_down_raw, 1073741905, 0, 2, 134, 423]
+[:key_down_raw, 1073741905, 0, 2, 135, 425]
+[:key_down_raw, 1073741905, 0, 2, 136, 428]
+[:key_down_raw, 1073741905, 0, 2, 137, 429]
+[:key_down_raw, 1073741905, 0, 2, 138, 431]
+[:key_down_raw, 1073741905, 0, 2, 139, 433]
+[:key_down_raw, 1073741905, 0, 2, 140, 435]
+[:key_down_raw, 1073741905, 0, 2, 141, 437]
+[:key_down_raw, 1073741905, 0, 2, 142, 439]
+[:key_down_raw, 1073741905, 0, 2, 143, 441]
+[:key_down_raw, 1073741905, 0, 2, 144, 443]
+[:key_down_raw, 1073741905, 0, 2, 145, 445]
+[:key_down_raw, 1073741905, 0, 2, 146, 447]
+[:key_down_raw, 1073741905, 0, 2, 147, 449]
+[:key_up_raw, 1073741905, 0, 2, 148, 451]
+[:key_up_raw, 1073741904, 0, 2, 149, 453]
+[:key_down_raw, 1073741904, 0, 2, 150, 456]
+[:key_up_raw, 1073741904, 0, 2, 151, 462]
+[:key_down_raw, 1073741905, 0, 2, 152, 464]
+[:key_down_raw, 1073741905, 0, 2, 153, 479]
+[:key_down_raw, 1073741905, 0, 2, 154, 481]
+[:key_down_raw, 1073741905, 0, 2, 155, 483]
+[:key_down_raw, 1073741905, 0, 2, 156, 485]
+[:key_down_raw, 1073741905, 0, 2, 157, 487]
+[:key_down_raw, 1073741905, 0, 2, 158, 489]
+[:key_down_raw, 1073741905, 0, 2, 159, 491]
+[:key_down_raw, 1073741905, 0, 2, 160, 493]
+[:key_down_raw, 1073741905, 0, 2, 161, 495]
+[:key_down_raw, 1073741905, 0, 2, 162, 497]
+[:key_down_raw, 1073741905, 0, 2, 163, 499]
+[:key_down_raw, 1073741906, 0, 2, 164, 500]
+[:key_down_raw, 1073741906, 0, 2, 165, 515]
+[:key_down_raw, 1073741906, 0, 2, 166, 517]
+[:key_down_raw, 1073741906, 0, 2, 167, 519]
+[:key_down_raw, 1073741906, 0, 2, 168, 521]
+[:key_down_raw, 1073741906, 0, 2, 169, 523]
+[:key_down_raw, 1073741906, 0, 2, 170, 525]
+[:key_down_raw, 1073741906, 0, 2, 171, 527]
+[:key_down_raw, 1073741906, 0, 2, 172, 529]
+[:key_down_raw, 1073741906, 0, 2, 173, 531]
+[:key_down_raw, 1073741906, 0, 2, 174, 533]
+[:key_down_raw, 1073741906, 0, 2, 175, 535]
+[:key_down_raw, 1073741906, 0, 2, 176, 537]
+[:key_down_raw, 1073741906, 0, 2, 177, 539]
+[:key_down_raw, 1073741906, 0, 2, 178, 541]
+[:key_down_raw, 1073741906, 0, 2, 179, 543]
+[:key_down_raw, 1073741906, 0, 2, 180, 545]
+[:key_down_raw, 1073741903, 0, 2, 181, 547]
+[:key_up_raw, 1073741905, 0, 2, 182, 555]
+[:key_down_raw, 1073741905, 0, 2, 183, 558]
+[:key_up_raw, 1073741906, 0, 2, 184, 564]
+[:key_down_raw, 1073741905, 0, 2, 185, 573]
+[:key_down_raw, 1073741905, 0, 2, 186, 575]
+[:key_down_raw, 1073741905, 0, 2, 187, 577]
+[:key_down_raw, 1073741905, 0, 2, 188, 579]
+[:key_down_raw, 1073741905, 0, 2, 189, 581]
+[:key_down_raw, 1073741905, 0, 2, 190, 583]
+[:key_down_raw, 1073741905, 0, 2, 191, 585]
+[:key_down_raw, 1073741905, 0, 2, 192, 587]
+[:key_down_raw, 1073741905, 0, 2, 193, 589]
+[:key_down_raw, 1073741905, 0, 2, 194, 591]
+[:key_down_raw, 1073741905, 0, 2, 195, 593]
+[:key_down_raw, 1073741905, 0, 2, 196, 595]
+[:key_down_raw, 1073741905, 0, 2, 197, 597]
+[:key_down_raw, 1073741905, 0, 2, 198, 599]
+[:key_down_raw, 1073741905, 0, 2, 199, 601]
+[:key_down_raw, 1073741905, 0, 2, 200, 603]
+[:key_down_raw, 1073741905, 0, 2, 201, 605]
+[:key_up_raw, 1073741905, 0, 2, 202, 605]
+[:key_up_raw, 1073741903, 0, 2, 203, 606]
+[:key_down_raw, 96, 0, 2, 204, 640]
+[:key_up_raw, 96, 0, 2, 205, 646]
+[:mouse_move, 796, 95, 2, 206, 683]
+[:mouse_move, 798, 95, 2, 207, 684]
+[:mouse_move, 808, 94, 2, 208, 685]
+[:mouse_move, 814, 94, 2, 209, 686]
+[:mouse_move, 826, 94, 2, 210, 687]
+[:mouse_move, 832, 94, 2, 211, 688]
+[:mouse_move, 842, 94, 2, 212, 689]
+[:mouse_move, 846, 94, 2, 213, 690]
+[:mouse_move, 856, 93, 2, 214, 691]
+[:mouse_move, 860, 93, 2, 215, 692]
+[:mouse_move, 867, 93, 2, 216, 693]
+[:mouse_move, 869, 93, 2, 217, 694]
+[:mouse_move, 870, 93, 2, 218, 695]
+[:mouse_move, 871, 93, 2, 219, 697]
+[:mouse_move, 872, 93, 2, 220, 698]
+[:mouse_move, 873, 93, 2, 221, 699]
+[:mouse_move, 874, 93, 2, 222, 701]
+[:mouse_move, 875, 93, 2, 223, 703]
+[:mouse_move, 877, 94, 2, 224, 704]
+[:mouse_move, 878, 94, 2, 225, 705]
+[:mouse_move, 879, 94, 2, 226, 706]
+[:mouse_move, 869, 95, 2, 227, 758]
+[:mouse_move, 864, 96, 2, 228, 759]
+[:mouse_move, 856, 96, 2, 229, 760]
+[:mouse_move, 852, 96, 2, 230, 761]
+[:mouse_move, 834, 96, 2, 231, 762]
+[:mouse_move, 821, 96, 2, 232, 763]
+[:mouse_move, 797, 96, 2, 233, 764]
+[:mouse_move, 789, 96, 2, 234, 765]
+[:mouse_move, 780, 94, 2, 235, 766]
+[:mouse_move, 779, 94, 2, 236, 767]
+[:key_down_raw, 13, 0, 2, 237, 805]
diff --git a/samples/03_rendering_sprites/03_animation_states/replay.txt b/samples/03_rendering_sprites/03_animation_states/replay.txt
new file mode 100644
index 0000000..f9d1962
--- /dev/null
+++ b/samples/03_rendering_sprites/03_animation_states/replay.txt
@@ -0,0 +1,182 @@
+replay_version 2.0
+stopped_at 770
+seed 100
+recorded_at Sat Jul 17 09:29:30 2021
+[:mouse_button_up, 1, 0, 1, 1, 4]
+[:key_down_raw, 1073741903, 0, 2, 2, 75]
+[:key_down_raw, 1073741903, 0, 2, 3, 89]
+[:key_down_raw, 1073741903, 0, 2, 4, 91]
+[:key_down_raw, 1073741903, 0, 2, 5, 93]
+[:key_down_raw, 1073741903, 0, 2, 6, 95]
+[:key_down_raw, 1073741903, 0, 2, 7, 97]
+[:key_down_raw, 1073741903, 0, 2, 8, 99]
+[:key_down_raw, 1073741903, 0, 2, 9, 101]
+[:key_down_raw, 1073741903, 0, 2, 10, 103]
+[:key_down_raw, 1073741903, 0, 2, 11, 105]
+[:key_down_raw, 1073741903, 0, 2, 12, 107]
+[:key_down_raw, 1073741903, 0, 2, 13, 109]
+[:key_down_raw, 1073741903, 0, 2, 14, 111]
+[:key_down_raw, 1073741903, 0, 2, 15, 113]
+[:key_down_raw, 1073741903, 0, 2, 16, 115]
+[:key_down_raw, 1073741903, 0, 2, 17, 117]
+[:key_down_raw, 1073741903, 0, 2, 18, 119]
+[:key_down_raw, 1073741903, 0, 2, 19, 121]
+[:key_down_raw, 1073741903, 0, 2, 20, 123]
+[:key_down_raw, 1073741903, 0, 2, 21, 125]
+[:key_down_raw, 1073741903, 0, 2, 22, 127]
+[:key_down_raw, 1073741903, 0, 2, 23, 129]
+[:key_down_raw, 1073741903, 0, 2, 24, 131]
+[:key_down_raw, 1073741903, 0, 2, 25, 133]
+[:key_down_raw, 1073741903, 0, 2, 26, 135]
+[:key_down_raw, 1073741903, 0, 2, 27, 137]
+[:key_down_raw, 1073741903, 0, 2, 28, 139]
+[:key_down_raw, 1073741903, 0, 2, 29, 141]
+[:key_down_raw, 1073741903, 0, 2, 30, 143]
+[:key_down_raw, 1073741903, 0, 2, 31, 145]
+[:key_down_raw, 1073741903, 0, 2, 32, 147]
+[:key_down_raw, 1073741903, 0, 2, 33, 149]
+[:key_down_raw, 1073741903, 0, 2, 34, 151]
+[:key_down_raw, 1073741903, 0, 2, 35, 153]
+[:key_down_raw, 1073741903, 0, 2, 36, 155]
+[:key_down_raw, 1073741903, 0, 2, 37, 157]
+[:key_down_raw, 1073741903, 0, 2, 38, 159]
+[:key_down_raw, 1073741903, 0, 2, 39, 161]
+[:key_down_raw, 1073741903, 0, 2, 40, 163]
+[:key_down_raw, 1073741903, 0, 2, 41, 165]
+[:key_down_raw, 1073741903, 0, 2, 42, 167]
+[:key_down_raw, 1073741903, 0, 2, 43, 169]
+[:key_down_raw, 1073741903, 0, 2, 44, 171]
+[:key_down_raw, 1073741903, 0, 2, 45, 173]
+[:key_down_raw, 1073741903, 0, 2, 46, 175]
+[:key_down_raw, 1073741903, 0, 2, 47, 177]
+[:key_down_raw, 1073741903, 0, 2, 48, 179]
+[:key_down_raw, 1073741903, 0, 2, 49, 181]
+[:key_down_raw, 1073741903, 0, 2, 50, 183]
+[:key_down_raw, 1073741903, 0, 2, 51, 185]
+[:key_down_raw, 1073741903, 0, 2, 52, 187]
+[:key_down_raw, 1073741903, 0, 2, 53, 189]
+[:key_down_raw, 1073741903, 0, 2, 54, 191]
+[:key_down_raw, 1073741903, 0, 2, 55, 193]
+[:key_down_raw, 1073741903, 0, 2, 56, 195]
+[:key_down_raw, 1073741903, 0, 2, 57, 197]
+[:key_down_raw, 1073741903, 0, 2, 58, 199]
+[:key_down_raw, 1073741903, 0, 2, 59, 201]
+[:key_down_raw, 1073741903, 0, 2, 60, 203]
+[:key_down_raw, 1073741903, 0, 2, 61, 205]
+[:key_down_raw, 1073741903, 0, 2, 62, 207]
+[:key_down_raw, 1073741903, 0, 2, 63, 209]
+[:key_down_raw, 1073741903, 0, 2, 64, 211]
+[:key_down_raw, 1073741903, 0, 2, 65, 213]
+[:key_down_raw, 1073741903, 0, 2, 66, 215]
+[:key_down_raw, 1073741903, 0, 2, 67, 217]
+[:key_down_raw, 1073741903, 0, 2, 68, 219]
+[:key_down_raw, 1073741903, 0, 2, 69, 221]
+[:key_down_raw, 1073741903, 0, 2, 70, 223]
+[:key_down_raw, 1073741903, 0, 2, 71, 225]
+[:key_down_raw, 1073741903, 0, 2, 72, 227]
+[:key_down_raw, 1073741903, 0, 2, 73, 229]
+[:key_down_raw, 1073741903, 0, 2, 74, 231]
+[:key_down_raw, 1073741903, 0, 2, 75, 233]
+[:key_down_raw, 1073741903, 0, 2, 76, 235]
+[:key_down_raw, 1073741903, 0, 2, 77, 237]
+[:key_down_raw, 1073741903, 0, 2, 78, 239]
+[:key_down_raw, 1073741903, 0, 2, 79, 241]
+[:key_down_raw, 1073741903, 0, 2, 80, 243]
+[:key_down_raw, 1073741903, 0, 2, 81, 245]
+[:key_down_raw, 1073741903, 0, 2, 82, 247]
+[:key_down_raw, 1073741903, 0, 2, 83, 249]
+[:key_up_raw, 1073741903, 0, 2, 84, 250]
+[:key_down_raw, 106, 0, 2, 85, 269]
+[:key_up_raw, 106, 0, 2, 86, 277]
+[:key_down_raw, 1073741905, 0, 2, 87, 299]
+[:key_down_raw, 1073741905, 0, 2, 88, 314]
+[:key_down_raw, 1073741905, 0, 2, 89, 316]
+[:key_down_raw, 1073741905, 0, 2, 90, 318]
+[:key_down_raw, 1073741905, 0, 2, 91, 320]
+[:key_down_raw, 1073741905, 0, 2, 92, 322]
+[:key_down_raw, 1073741905, 0, 2, 93, 324]
+[:key_down_raw, 1073741905, 0, 2, 94, 326]
+[:key_down_raw, 1073741905, 0, 2, 95, 328]
+[:key_down_raw, 1073741905, 0, 2, 96, 330]
+[:key_down_raw, 1073741905, 0, 2, 97, 332]
+[:key_down_raw, 1073741905, 0, 2, 98, 334]
+[:key_down_raw, 1073741905, 0, 2, 99, 336]
+[:key_down_raw, 1073741905, 0, 2, 100, 338]
+[:key_down_raw, 1073741905, 0, 2, 101, 340]
+[:key_down_raw, 1073741904, 0, 2, 102, 341]
+[:key_down_raw, 1073741904, 0, 2, 103, 356]
+[:key_down_raw, 1073741904, 0, 2, 104, 358]
+[:key_down_raw, 1073741904, 0, 2, 105, 360]
+[:key_down_raw, 1073741904, 0, 2, 106, 362]
+[:key_down_raw, 1073741904, 0, 2, 107, 364]
+[:key_down_raw, 1073741904, 0, 2, 108, 366]
+[:key_down_raw, 1073741904, 0, 2, 109, 368]
+[:key_down_raw, 1073741904, 0, 2, 110, 370]
+[:key_up_raw, 1073741904, 0, 2, 111, 371]
+[:key_up_raw, 1073741905, 0, 2, 112, 373]
+[:key_down_raw, 1073741906, 0, 2, 113, 378]
+[:key_down_raw, 1073741906, 0, 2, 114, 393]
+[:key_down_raw, 1073741906, 0, 2, 115, 395]
+[:key_down_raw, 1073741906, 0, 2, 116, 397]
+[:key_down_raw, 1073741906, 0, 2, 117, 399]
+[:key_up_raw, 1073741906, 0, 2, 118, 401]
+[:key_down_raw, 1073741904, 0, 2, 119, 402]
+[:key_down_raw, 1073741904, 0, 2, 120, 419]
+[:key_down_raw, 1073741904, 0, 2, 121, 421]
+[:key_down_raw, 1073741904, 0, 2, 122, 423]
+[:key_down_raw, 1073741904, 0, 2, 123, 425]
+[:key_down_raw, 1073741904, 0, 2, 124, 427]
+[:key_up_raw, 1073741904, 0, 2, 125, 429]
+[:key_down_raw, 1073741904, 0, 2, 126, 434]
+[:key_up_raw, 1073741904, 0, 2, 127, 437]
+[:key_down_raw, 106, 0, 2, 128, 457]
+[:key_up_raw, 106, 0, 2, 129, 463]
+[:key_down_raw, 1073741903, 0, 2, 130, 490]
+[:key_up_raw, 1073741903, 0, 2, 131, 500]
+[:key_down_raw, 1073741906, 0, 2, 132, 501]
+[:key_down_raw, 1073741906, 0, 2, 133, 516]
+[:key_down_raw, 1073741906, 0, 2, 134, 518]
+[:key_down_raw, 1073741906, 0, 2, 135, 520]
+[:key_up_raw, 1073741906, 0, 2, 136, 521]
+[:key_down_raw, 1073741904, 0, 2, 137, 532]
+[:key_down_raw, 1073741904, 0, 2, 138, 547]
+[:key_down_raw, 1073741904, 0, 2, 139, 549]
+[:key_up_raw, 1073741904, 0, 2, 140, 550]
+[:key_down_raw, 1073741903, 0, 2, 141, 552]
+[:key_down_raw, 1073741903, 0, 2, 142, 567]
+[:key_up_raw, 1073741903, 0, 2, 143, 568]
+[:key_down_raw, 106, 0, 2, 144, 574]
+[:key_up_raw, 106, 0, 2, 145, 580]
+[:key_down_raw, 96, 0, 2, 146, 661]
+[:key_up_raw, 96, 0, 2, 147, 666]
+[:mouse_move, 799, 92, 2, 148, 693]
+[:mouse_move, 803, 92, 2, 149, 694]
+[:mouse_move, 811, 91, 2, 150, 695]
+[:mouse_move, 816, 90, 2, 151, 696]
+[:mouse_move, 827, 88, 2, 152, 697]
+[:mouse_move, 830, 87, 2, 153, 698]
+[:mouse_move, 835, 87, 2, 154, 699]
+[:mouse_move, 837, 87, 2, 155, 700]
+[:mouse_move, 838, 87, 2, 156, 701]
+[:mouse_move, 838, 86, 2, 157, 702]
+[:mouse_move, 839, 86, 2, 158, 704]
+[:mouse_move, 838, 86, 2, 159, 712]
+[:mouse_move, 838, 87, 2, 160, 713]
+[:mouse_move, 835, 87, 2, 161, 714]
+[:mouse_move, 832, 87, 2, 162, 715]
+[:mouse_move, 824, 87, 2, 163, 716]
+[:mouse_move, 820, 87, 2, 164, 717]
+[:mouse_move, 809, 87, 2, 165, 718]
+[:mouse_move, 805, 87, 2, 166, 719]
+[:mouse_move, 800, 86, 2, 167, 720]
+[:mouse_move, 799, 86, 2, 168, 721]
+[:mouse_move, 798, 86, 2, 169, 722]
+[:mouse_move, 797, 86, 2, 170, 723]
+[:mouse_move, 796, 86, 2, 171, 724]
+[:mouse_move, 798, 86, 2, 172, 742]
+[:mouse_move, 805, 86, 2, 173, 743]
+[:mouse_move, 807, 86, 2, 174, 744]
+[:mouse_move, 810, 86, 2, 175, 745]
+[:mouse_move, 811, 86, 2, 176, 747]
+[:mouse_move, 811, 85, 2, 177, 760]
+[:key_down_raw, 13, 0, 2, 178, 770]
diff --git a/samples/03_rendering_sprites/04_color_and_rotation/app/main.rb b/samples/03_rendering_sprites/04_color_and_rotation/app/main.rb
index 072feaf..c3f2d8f 100644
--- a/samples/03_rendering_sprites/04_color_and_rotation/app/main.rb
+++ b/samples/03_rendering_sprites/04_color_and_rotation/app/main.rb
@@ -21,10 +21,14 @@
 
  - args.outputs.sprites: An array. The values generate a sprite.
    The parameters are [X, Y, WIDTH, HEIGHT, PATH, ANGLE, ALPHA, RED, GREEN, BLUE]
+   Before continuing with this sample app, it is HIGHLY recommended that you look
+   at mygame/documentation/05-sprites.md.
 
  - args.inputs.keyboard.key_held.KEY: Determines if a key is being pressed.
+   For more information about the keyboard, go to mygame/documentation/06-keyboard.md.
 
  - args.inputs.controller_one: Takes input from the controller based on what key is pressed.
+   For more information about the controller, go to mygame/documentation/08-controllers.md.
 
  - num1.lesser(num2): Finds the lower value of the given options.