Docs synced.

1 files changed, 3911 insertions, 1598 deletions

diff --git a/docs/docs.txt b/docs/docs.txt
index 0b543de..c07fbcd 100644
--- a/docs/docs.txt
+++ b/docs/docs.txt
@@ -11,8 +11,6 @@ to get fancy you can provide a ~lambda~ to filter documentation:
   docs_search { |entry| (entry.include? "Array") && (!entry.include? "Enumerable") }
 #+end_src
 
-[[docs_search.gif]]
-
 * Hello World
 
 Welcome to DragonRuby Game Toolkit. Take the steps below to get started.
@@ -37,20 +35,25 @@ Reply with:
 I am a Dragon Rider.
 #+end_quote
 
-* Watch Some Intro Videos
+* Intro Videos
+
+Here are some videos to help you get the lay of the land.
 
-Each video is only 20 minutes and all of them will fit into a lunch
-break. So please watch them:
+** Quick Api Tour
 
 1. Beginner Introduction to DragonRuby Game Toolkit: [[https://youtu.be/ixw7TJhU08E]]
-2. Intermediate Introduction to Ruby Syntax: [[https://youtu.be/HG-XRZ5Ppgc]]
-3. Intermediate Introduction to Arrays in Ruby: [[https://youtu.be/N72sEYFRqfo]]
 
-The second and third videos are not required if you are proficient
-with Ruby, but *definitely* watch the first one.
+** If You Are Completely New to Ruby and Programming
+
+1. Intermediate Introduction to Ruby Syntax: [[https://youtu.be/HG-XRZ5Ppgc]]
+2. Intermediate Introduction to Arrays in Ruby: [[https://youtu.be/N72sEYFRqfo]]
+3. You may also want to try this free course provided at [[http://dragonruby.school]].
 
-You may also want to try this free course provided at
-[[http://dragonruby.school]].
+** If You Have Game Dev Experience
+
+1. Building Tetris - Part 1: [[https://youtu.be/xZMwRSbC4rY]]
+2. Building Tetris - Part 2: [[https://youtu.be/C3LLzDUDgz4]]
+3. Low Res Game Jam Tutorial: [[https://youtu.be/pCI90ukKCME]]
 
 * Getting Started Tutorial
 
@@ -392,7 +395,7 @@ Console type: ~$wizards.ios.start~ and you will be guided through the
 deployment process.
 
 To deploy to Android, you need to have an Android emulator/device, and
-a environment that is able to run Android SDK. ~dragonruby-publish~
+an environment that is able to run Android SDK. ~dragonruby-publish~
 will create an APK for you. From there, you can sign the APK and
 install it to your device. The signing and installation procedure
 varies from OS to OS. Here's an example of what the command might look
@@ -411,7 +414,7 @@ The following tenants of DragonRuby are what set us apart from other
 game engines. Given that Game Toolkit is a relatively new engine,
 there are definitely features that are missing. So having a big check
 list of "all the cool things" is not this engine's forte. This is
-compensated with a strong commitment to the following principals.
+compensated with a strong commitment to the following principles.
 
 ** Challenge The Status Quo
 
@@ -440,10 +443,10 @@ overwhelms beginners who are new to the engine or programming in general.
 DragonRuby's philosophy is to provide multiple options across the "make it
 fast" vs "make it right" spectrum, with incremental/intuitive
 transitions between the options provided. A concrete example of this philosophy
-would be render primitives: the spectrum of options allows renderable constructs take
-the form of tuples/arrays (easy to pickup, simple, and fast to code/prototype with),
+would be render primitives: the spectrum of options allows renderable constructs that
+take the form of tuples/arrays (easy to pickup, simple, and fast to code/prototype with),
 hashes (a little more work, but gives you the ability to add additional properties),
-open and string entities (more work than hashes, but yields cleaner apis),
+open and strict entities (more work than hashes, but yields cleaner apis),
 and finally - if you really need full power/flexibility in rendering - classes
 (which take the most amount of code and programming knowledge to create).
 
@@ -570,7 +573,7 @@ The elevator pitch is:
 DragonRuby is a Multilevel Cross-platform Runtime. The "multiple levels"
 within the runtime allows us to target platforms no other Ruby can
 target: PC, Mac, Linux, Raspberry Pi, WASM, iOS, Android, Nintendo
-Switch, PS4, Xbox, and Scadia.
+Switch, PS4, Xbox, and Stadia.
 
 **** What does Multilevel Cross-platform mean?
 
@@ -648,7 +651,7 @@ file called ~repl.rb~ and put it in ~mygame/app/repl.rb~:
 
 - If you use the `repl` method, the code will be executed and the DragonRuby Console will automatically open so you can see the results (on Mac and Linux, the results will also be printed to the terminal).
 
-- All ~puts~ statements will also be saved to ~logs/log.txt~. So if you want to stay in your editor and not look at the terminal, or the DragonRuby Console, you can ~tail~ this file.
+- All ~puts~ statements will also be saved to ~logs/puts.txt~. So if you want to stay in your editor and not look at the terminal, or the DragonRuby Console, you can ~tail~ this file.
 
 4. To ignore code in ~repl.rb~, instead of commenting it out, prefix ~repl~ with the letter ~x~ and it'll be ignored.
 
@@ -684,7 +687,7 @@ challenges in creating something that is compatible.
 You can use DragonRuby's replay capabilities to troubleshoot:
 
 1. DragonRuby is hot loaded which gives you a very fast feedback loop (if the game throws an exception, it's because of the code you just added).
-2. Use ~./dragonruby mygame --record~ to create a game play recording that you can use to find the exception (you can replay a recoding by executing ~./dragonruby mygame --replay last_replay.txt~ or through the DragonRuby Console using ~$gtk.recording.start_replay "last_replay.txt"~.
+2. Use ~./dragonruby mygame --record~ to create a game play recording that you can use to find the exception (you can replay a recording by executing ~./dragonruby mygame --replay last_replay.txt~ or through the DragonRuby Console using ~$gtk.recording.start_replay "last_replay.txt"~.
 3. DragonRuby also ships with a unit testing facility. You can invoke the following command to run a test: ~./dragonruby . --eval some_ruby_file.rb --no-tick~.
 4. Get into the habit of adding debugging facilities within the game itself. You can add drawing primitives to ~args.outputs.debug~ that will render on top of your game but will be ignored in a production release.
 5. Debugging something that runs at 60fps is (imo) not that helpful. The exception you are seeing could have been because of a change that occurred many frames ago.
@@ -697,7 +700,7 @@ Let's check the official source for the answer to this question:
 isrubydead.com: [[https://isrubydead.com/]].
 
 On a more serious note, Ruby's _quantity_ levels aren't what they used
-to be. And that's totally fine. Every one chases the new and shiny.
+to be. And that's totally fine. Everyone chases the new and shiny.
 
 What really matters is _quality/maturity_. Here is the latest (StackOverflow
 Survey sorted by highest paid developers)[https://insights.stackoverflow.com/survey/2019#top-paying-technologies].
@@ -771,13 +774,11 @@ questions asked.
 
 *** But still, you should offer a free version. So I can try it out and see if I like it.
 
-You can try our [web-based sandbox environment](). But it won't do the
-runtime justice. Or just come to our [Slack]() or [Discord]() channel
-and ask questions. We'd be happy to have a one on one video chat with
-you and show off all the cool stuff we're doing.
+You can try our web-based sandbox environment at [[http://fiddle.dragonruby.org]]. But it won't do the
+runtime justice. Or just come to our Discord Channel at [[http://discord.dragonruby.org]] and ask questions.
+We'd be happy to have a one on one video chat with you and show off all the cool stuff we're doing.
 
-Seriously just buy it. Get a refund if you don't like it. We make it
-stupid easy to do so.
+Seriously just buy it. Get a refund if you don't like it. We make it stupid easy to do so.
 
 *** I still think you should do a free version. Think of all people who would give it a shot.
 
@@ -897,11 +898,15 @@ You can represent a sprite as a ~Hash~:
       flip_vertically: false,
       flip_horizontally: false,
       angle_anchor_x: 0.5,
-      angle_anchor_y: 1.0
+      angle_anchor_y: 1.0,
+      blendmode_enum: 1
     }
   end
 #+end_src
 
+The ~blendmode_enum~ value can be set to ~0~ (no blending), ~1~ (alpha blending),
+~2~ (additive blending), ~3~ (modulo blending), ~4~ (multiply blending).
+
 You can represent a sprite as an ~object~:
 
 #+begin_src ruby
@@ -911,7 +916,7 @@ You can represent a sprite as an ~object~:
                   :source_x, :source_y, :source_w, :source_h,
                   :tile_x, :tile_y, :tile_w, :tile_h,
                   :flip_horizontally, :flip_vertically,
-                  :angle_anchor_x, :angle_anchor_y
+                  :angle_anchor_x, :angle_anchor_y, :blendmode_enum
 
     def primitive_marker
       :sprite
@@ -997,16 +1002,17 @@ You can add additional metadata about your game within a label, which requires y
 #+begin_src
   def tick args
     args.outputs.labels << {
-      x:              200,
-      y:              550,
-      text:           "dragonruby",
-      size_enum:      2,
-      alignment_enum: 1,
-      r:              155,
-      g:              50,
-      b:              50,
-      a:              255,
-      font:           "fonts/manaspc.ttf",
+      x:                       200,
+      y:                       550,
+      text:                    "dragonruby",
+      size_enum:               2,
+      alignment_enum:          1,
+      r:                       155,
+      g:                       50,
+      b:                       50,
+      a:                       255,
+      font:                    "fonts/manaspc.ttf",
+      vertical_alignment_enum: 0, # 0 is bottom, 1 is middle, 2 is top
       # You can add any properties you like (this will be ignored/won't cause errors)
       game_data_one:  "Something",
       game_data_two: {
@@ -1039,6 +1045,21 @@ You can get the render size of any string using ~args.gtk.calcstringbox~.
   end
 #+end_src
 
+** Rendering Labels With New Line Characters And Wrapping
+
+You can use a strategy like the following to create multiple labels from a String.
+
+#+begin_src ruby
+  def tick args
+    long_string = "Lorem ipsum dolor sit amet, consectetur adipiscing elitteger dolor velit, ultricies vitae libero vel, aliquam imperdiet enim."
+    max_character_length = 30
+    long_strings_split = args.string.wrapped_lines long_string, max_character_length
+    args.outputs.labels << long_strings_split.map_with_index do |s, i|
+      { x: 10, y: 600 - (i * 20), text: s }
+    end
+  end
+#+end_src
+
 ** How To Play A Sound
 
 Sounds that end ~.wav~ will play once:
@@ -1195,7 +1216,7 @@ Returns ~true~ if: the ~right~ arrow or ~d~ key is pressed or held on the ~keybo
 *** ~.left_right~
 Returns ~-1~ (left), ~0~ (neutral), or ~+1~ (right) depending on results of ~args.inputs.left~ and ~args.inputs.right~.
 *** ~.up_down~
-Returns ~-1~ (down), ~0~ (neutral), or ~+1~ (right) depending on results of ~args.inputs.up~ and ~args.inputs.down~.
+Returns ~-1~ (down), ~0~ (neutral), or ~+1~ (up) depending on results of ~args.inputs.down~ and ~args.inputs.up~.
 *** ~.text~ OR ~.history~
 Returns a string that represents the last key that was pressed on the keyboard.
 *** ~.mouse~
@@ -1229,17 +1250,17 @@ The properties ~args.inputs.mouse.(click|down|previous_click|up)~ each return ~n
 that has an ~x~, ~y~ properties along with helper functions to determine collision: ~inside_rect?~, ~inside_circle~.
 *** ~.controller_one~, ~.controller_two~
 Represents controllers connected to the usb ports.
-**** ~.up
+**** ~.up~
 Returns ~true~ if ~up~ is pressed or held on the directional or left analog.
-**** ~.down
+**** ~.down~
 Returns ~true~ if ~down~ is pressed or held on the directional or left analog.
-**** ~.left
+**** ~.left~
 Returns ~true~ if ~left~ is pressed or held on the directional or left analog.
-**** ~.right
+**** ~.right~
 Returns ~true~ if ~right~ is pressed or held on the directional or left analog.
-**** ~.left_right
+**** ~.left_right~
 Returns ~-1~ (left), ~0~ (neutral), or ~+1~ (right) depending on results of ~args.inputs.controller_(one|two).left~ and ~args.inputs.controller_(one|two).right~.
-**** ~.up_down
+**** ~.up_down~
 Returns ~-1~ (down), ~0~ (neutral), or ~+1~ (up) depending on results of ~args.inputs.controller_(one|two).up~ and ~args.inputs.controller_(one|two).down~.
 **** ~.(left_analog_x_raw|right_analog_x_raw)~
 Returns the raw integer value for the analog's horizontal movement (~-32,000 to +32,000~).
@@ -1249,13 +1270,13 @@ Returns the raw integer value for the analog's vertical movement (~-32,000 to +3
 Returns a number between ~-1~ and ~1~ which represents the percentage the analog is moved horizontally as a ratio of the maximum horizontal movement.
 **** ~.left_analog_y_perc|right_analog_y_perc)~
 Returns a number between ~-1~ and ~1~ which represents the percentage the analog is moved vertically as a ratio of the maximum vertical movement.
-**** ~.directional_up)~
+**** ~.directional_up~
 Returns ~true~ if ~up~ is pressed or held on the directional.
-**** ~.directional_down)~
+**** ~.directional_down~
 Returns ~true~ if ~down~ is pressed or held on the directional.
-**** ~.directional_left)~
+**** ~.directional_left~
 Returns ~true~ if ~left~ is pressed or held on the directional.
-**** ~.directional_right)~
+**** ~.directional_right~
 Returns ~true~ if ~right~ is pressed or held on the directional.
 **** ~.(a|b|x|y|l1|r1|l2|r2|l3|r3|start|select)~
 Returns ~true~ if the specific button is pressed or held.
@@ -1411,6 +1432,14 @@ Send a Primitive to this collection to render an unfilled rectangle to the scree
 Send any Primitive to this collection which represents things you render to the screen for debugging purposes. Primitives in this collection will not be rendered in a production release of your game.
 ** ~args.geometry~
 This property contains geometric functions. Functions can be invoked via ~args.geometry.FUNCTION~.
+
+Here are some general notes with regards to the arguments these geometric functions accept.
+
+1. ~Rectangles~ can be represented as an ~Array~ with four (or more) values ~[x, y, w, h]~, as a ~Hash~ ~{ x:, y:, w:, h: }~ or an object that responds to ~x~, ~y~, ~w~, and ~h~.
+2. ~Points~ can be represent as an ~Array~ with two (or more) values ~[x, y]~, as a ~Hash~ ~{ x:, y:}~ or an object that responds to ~x~, and ~y~.
+3. ~Lines~ can be represented as an ~Array~ with four (or more) values ~[x, y, x2, y2]~, as a ~Hash~ ~{ x:, y:, x2:, y2: }~ or an object that responds to ~x~, ~y~, ~x2~, and ~y2~.
+4. ~Angles~ are represented as degrees (not radians).
+
 *** ~.inside_rect? rect_1, rect_2~
 Returns ~true~ if ~rect_1~ is inside ~rect_2~.
 *** ~.intersect_rect? rect_2, rect_2~
@@ -1975,7 +2004,7 @@ wide and 90 pixels tall.
 
 ** Rendering a solid using an Array with colors and alpha
 
-The value for the color and alpha is an number between ~0~ and ~255~. The
+The value for the color and alpha is a number between ~0~ and ~255~. The
 alpha property is optional and will be set to ~255~ if not specified.
 
 Creates a green solid rectangle with an opacity of 50%.
@@ -2011,7 +2040,7 @@ be provided in any order.
 ** Rendering a solid using a Class
 
 You can also create a class with solid/border properties and render it as a primitive.
-ALL properties must on the class. *Additionally*, a method called ~primitive_marker~
+ALL properties must be on the class. *Additionally*, a method called ~primitive_marker~
 must be defined on the class.
 
 Here is an example:
@@ -2070,6 +2099,106 @@ You have to use ~args.outputs.borders~:
 #+end_src
 
 
+* DOCS: ~GTK::Outputs#sprites~
+
+Add primitives to this collection to render a sprite to the screen.
+
+** Rendering a sprite using an Array
+
+Creates a sprite of a white circle located at 100, 100. 160 pixels
+wide and 90 pixels tall.
+
+#+begin_src
+  def tick args
+    #                         X    Y   WIDTH   HEIGHT                      PATH
+    args.outputs.sprites << [100, 100,   160,     90, "sprites/circle/white.png]
+  end
+#+end_src
+
+** Rendering a sprite using an Array with colors and alpha
+
+The value for the color and alpha is a number between ~0~ and ~255~. The
+alpha property is optional and will be set to ~255~ if not specified.
+
+Creates a green circle sprite with an opacity of 50%.
+
+#+begin_src
+  def tick args
+    #                         X    Y  WIDTH  HEIGHT           PATH                ANGLE  ALPHA  RED  GREEN  BLUE
+    args.outputs.sprites << [100, 100,  160,     90, "sprites/circle/white.png",     0,    128,   0,   255,    0]
+  end
+#+end_src
+
+** Rendering a sprite using a Hash
+
+If you want a more readable invocation. You can use the following hash to create a sprite.
+Any parameters that are not specified will be given a default value. The keys of the hash can
+be provided in any order.
+
+#+begin_src
+  def tick args
+    args.outputs.sprites << {
+      x:                             0,
+      y:                             0,
+      w:                           100,
+      h:                           100,
+      path: "sprites/circle/white.png",
+      angle:                         0,
+      a:                           255,
+      r:                             0,
+      g:                           255,
+      b:                             0
+    }
+  end
+#+end_src
+
+** Rendering a solid using a Class
+
+You can also create a class with solid/border properties and render it as a primitive.
+ALL properties must be on the class. *Additionally*, a method called ~primitive_marker~
+must be defined on the class.
+
+Here is an example:
+
+#+begin_src
+  # Create type with ALL sprite properties AND primitive_marker
+  class Sprite
+    attr_accessor :x, :y, :w, :h, :path, :angle, :angle_anchor_x, :angle_anchor_y,  :tile_x, :tile_y, :tile_w, :tile_h, :source_x, :source_y, :source_w, :source_h, :flip_horizontally, :flip_vertically, :a, :r, :g, :b
+
+    def primitive_marker
+      :sprite
+    end
+  end
+
+  # Inherit from type
+  class Circle < Sprite
+  # constructor
+    def initialize x, y, size, path
+      self.x = x
+      self.y = y
+      self.w = size
+      self.h = size
+      self.path = path
+    end
+    def serlialize
+      {x:self.x, y:self.y, w:self.w, h:self.h, path:self.path}
+    end
+
+    def inspect
+      serlialize.to_s
+    end
+
+    def to_s
+      serlialize.to_s
+    end
+  end
+  def tick args
+    # render circle sprite
+    args.outputs.sprites  << Circle.new(10, 10, 32,"sprites/circle/white.png")
+  end
+#+end_src
+
+
 * DOCS: ~GTK::Outputs#screenshots~
 
 Add a hash to this collection to take a screenshot and save as png file.
@@ -2133,12 +2262,12 @@ The ~GTK::MousePoint~ has the following properties.
 - ~x~: Integer representing the mouse's x.
 - ~y~: Integer representing the mouse's y.
 - ~point~: Array with the ~x~ and ~y~ values.
-- ~w~: Width of the point that always returns ~0~ (included so that it can seemlessly work with ~GTK::Geometry~ functions).
-- ~h~: Height of the point that always returns ~0~ (included so that it can seemlessly work with ~GTK::Geometry~ functions).
-- ~left~: This value is the same as ~x~ (included so that it can seemlessly work with ~GTK::Geometry~ functions).
-- ~right~: This value is the same as ~x~ (included so that it can seemlessly work with ~GTK::Geometry~ functions).
-- ~top~: This value is the same as ~y~ (included so that it can seemlessly work with ~GTK::Geometry~ functions).
-- ~bottom~: This value is the same as ~y~ (included so that it can seemlessly work with ~GTK::Geometry~ functions).
+- ~w~: Width of the point that always returns ~0~ (included so that it can seamlessly work with ~GTK::Geometry~ functions).
+- ~h~: Height of the point that always returns ~0~ (included so that it can seamlessly work with ~GTK::Geometry~ functions).
+- ~left~: This value is the same as ~x~ (included so that it can seamlessly work with ~GTK::Geometry~ functions).
+- ~right~: This value is the same as ~x~ (included so that it can seamlessly work with ~GTK::Geometry~ functions).
+- ~top~: This value is the same as ~y~ (included so that it can seamlessly work with ~GTK::Geometry~ functions).
+- ~bottom~: This value is the same as ~y~ (included so that it can seamlessly work with ~GTK::Geometry~ functions).
 - ~created_at~: The tick (~args.state.tick_count~) that this structure was created.
 - ~global_created_at~: The global tick (~Kernel.global_tick_count~) that this structure was created.
 
@@ -3580,7 +3709,7 @@ Follows is a source code listing for all files that have been open sourced. This
                                  g: 0,
                                  b: 200,
                                  a: 255,
-                                 font: "manaspc.ttf" }.label
+                                 font: "manaspc.ttf" }.label!
   
     # Primitives can hold anything, and can be given a label in the following forms
     args.outputs.primitives << [690 + 150, 330 - 80, "Custom font (.primitives Array)", 0, 1, 125, 0, 200, 255, "manaspc.ttf" ].label
@@ -3594,7 +3723,7 @@ Follows is a source code listing for all files that have been open sourced. This
                                  g: 0,
                                  b: 200,
                                  a: 255,
-                                 font: "manaspc.ttf" }.label
+                                 font: "manaspc.ttf" }.label!
   end
   
   def tick_instructions args, text, y = 715
@@ -3831,771 +3960,6 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
-*** Rendering Basics - Audio Mixer - main.rb
-#+begin_src ruby
-  # ./samples/01_rendering_basics/06_audio_mixer/app/main.rb
-  $gtk.reset
-  
-  $boxsize = 30
-  
-  def render_sources args
-    mouse_in_panel = (args.state.selected != 0) && args.inputs.mouse.position.inside_rect?([900, 450, 340, 250])
-    mouse_new_down = (args.state.mouse_held == 1)
-  
-    if (mouse_new_down && !mouse_in_panel)
-      args.state.selected = 0  # will reset below if we hit something.
-    end
-  
-    args.audio.keys.each { |k|
-      s = args.audio[k]
-  
-      if (mouse_new_down) && !mouse_in_panel && args.inputs.mouse.position.inside_rect?([s[:screenx], s[:screeny], $boxsize, $boxsize])
-        args.state.selected = k
-        args.state.dragging_source = true
-      end
-  
-      isselected = (k == args.state.selected)
-  
-      if isselected && args.state.dragging_source
-        # you can hang anything on the audio hashes you want, so we store the
-        #  actual screen position so it doesn't scale weirdly vs your mouse.
-        s[:screenx] = args.inputs.mouse.x - ($boxsize / 2)
-        s[:screeny] = args.inputs.mouse.y - ($boxsize / 2)
-  
-        s[:screeny] = 50 if s[:screeny] < 50
-        s[:screeny] = (719 - $boxsize) if s[:screeny] > (719 - $boxsize)
-        s[:screenx] = 0 if s[:screenx] < 0
-        s[:screenx] = (1279 - $boxsize) if s[:screenx] > (1279 - $boxsize)
-  
-        s[:x] = ((s[:screenx] / 1279.0) * 2.0) - 1.0  # scale to -1.0 - 1.0 range
-        s[:y] = ((s[:screeny] / 719.0) * 2.0) - 1.0   # scale to -1.0 - 1.0 range
-      end
-  
-      color = isselected ? [ 0, 255, 0, 255 ] : [ 0, 0, 255, 255 ]
-      args.outputs.primitives << [s[:screenx], s[:screeny], $boxsize, $boxsize, *color].solid
-    }
-  end
-  
-  def render_panel args
-    s = args.audio[args.state.selected]
-    return if s.nil?
-    mouse_down = (args.state.mouse_held > 0)
-  
-    args.outputs.primitives << [900, 450, 340, 250, 127, 127, 200, 255].solid
-    args.outputs.primitives << [1075, 690, "Source ##{args.state.selected}", 3, 1, 255, 255, 255].label
-    args.outputs.primitives << [910, 660, 1230, 660, 255, 255, 255].line
-    args.outputs.primitives << [910, 650, "screen:    (#{s[:screenx].to_i}, #{s[:screeny].to_i})", 0, 0, 255, 255, 255].label
-    args.outputs.primitives << [910, 625, "position:  (#{s[:x].round(5).to_s[0..6]}, #{s[:y].round(5).to_s[0..6]})", 0, 0, 255, 255, 255].label
-  
-    slider = [1022, 586, 200, 7]
-    if mouse_down && args.inputs.mouse.position.inside_rect?(slider)
-      s[:pitch] = ((args.inputs.mouse.x - slider[0]).to_f / (slider[2]-1.0)) * 2.0
-    end
-    slidercolor = (s[:pitch] / 2.0) * 255
-    args.outputs.primitives << [*slider, slidercolor, slidercolor, slidercolor, 255].solid
-    args.outputs.primitives << [910, 600, "pitch: #{s[:pitch].round(3).to_s[0..2]}", 0, 0, 255, 255, 255].label
-  
-    slider = [1022, 561, 200, 7]
-    if mouse_down && args.inputs.mouse.position.inside_rect?(slider)
-      s[:gain] = (args.inputs.mouse.x - slider[0]).to_f / (slider[2]-1.0)
-    end
-    slidercolor = s[:gain] * 255
-    args.outputs.primitives << [*slider, slidercolor, slidercolor, slidercolor, 255].solid
-    args.outputs.primitives << [910, 575, "gain: #{s[:gain].round(3).to_s[0..2]}", 0, 0, 255, 255, 255].label
-  
-    checkbox = [1022, 533, 10, 12]
-    if (args.state.mouse_held == 1) && args.inputs.mouse.position.inside_rect?(checkbox)
-      s[:looping] = !s[:looping]
-    end
-    checkboxcolor = s[:looping] ? 255 : 0
-    args.outputs.primitives << [*checkbox, checkboxcolor, checkboxcolor, checkboxcolor, 255].solid
-    args.outputs.primitives << [910, 550, "looping:", 0, 0, 255, 255, 255].label
-  
-    checkbox = [1022, 508, 10, 12]
-    if (args.state.mouse_held == 1) && args.inputs.mouse.position.inside_rect?(checkbox)
-      s[:paused] = !s[:paused]
-    end
-    checkboxcolor = s[:paused] ? 255 : 0
-    args.outputs.primitives << [*checkbox, checkboxcolor, checkboxcolor, checkboxcolor, 255].solid
-    args.outputs.primitives << [910, 525, "paused:", 0, 0, 255, 255, 255].label
-  
-    button = [910, 460, 320, 20]
-    if (args.state.mouse_held == 1) && args.inputs.mouse.position.inside_rect?(button)
-      args.audio.delete(args.state.selected)
-      args.state.selected = 0
-    end
-    args.outputs.primitives << [*button, 255, 0, 0, 255].solid
-    args.outputs.primitives << [button[0] + (button[2] / 2), button[1]+20, "DELETE SOURCE", 0, 1, 255, 255, 0].label
-  end
-  
-  def spawn_new_sound args, num
-    input = nil
-    input = "sounds/#{num}.#{(num == 6) ? 'ogg' : 'wav'}"
-  
-    # Spawn randomly in an area that won't be covered by UI.
-    screenx = (rand * 600.0) + 200.0
-    screeny = (rand * 400.0) + 100.0
-  
-    args.state.next_sound_index += 1
-  
-    # you can hang anything on the audio hashes you want, so we store the
-    #  actual screen position in here for convenience.
-    args.audio[args.state.next_sound_index] = {
-      input: input,
-      screenx: screenx,
-      screeny: screeny,
-      x: ((screenx / 1279.0) * 2.0) - 1.0,  # scale to -1.0 - 1.0 range
-      y: ((screeny / 719.0) * 2.0) - 1.0,   # scale to -1.0 - 1.0 range
-      z: 0.0,
-      gain: 1.0,
-      pitch: 1.0,
-      looping: true,
-      paused: false
-    }
-  
-    args.state.selected = args.state.next_sound_index
-  end
-  
-  def render_launcher args
-    total = 6
-    x = (1280 - (total * $boxsize * 3)) / 2
-    y = 10
-    args.outputs.primitives << [0, 0, 1280, ((y*2) + $boxsize), 127, 127, 127, 255].solid
-    for i in 1..total
-      args.outputs.primitives << [x, y, $boxsize, $boxsize, 255, 255, 255, 255].solid
-      args.outputs.primitives << [x+8, y+28, i.to_s, 3, 0, 0, 0, 255, 255].label
-      if args.inputs.mouse.click && args.inputs.mouse.click.point.inside_rect?([x, y, $boxsize, $boxsize])
-        spawn_new_sound args, i
-      end
-      x = x + ($boxsize * 3)
-    end
-  end
-  
-  def render_ui args
-    render_launcher args
-    render_panel args
-  end
-  
-  def tick args
-    args.state.mouse_held ||= 0
-    args.state.dragging_source ||= false
-    args.state.selected ||= 0
-    args.state.next_sound_index ||= 0
-  
-    if args.inputs.mouse.up
-      args.state.mouse_held = 0
-      args.state.dragging_source = false
-    elsif args.inputs.mouse.down || (args.state.mouse_held > 0)
-      args.state.mouse_held += 1
-    else
-    end
-  
-    args.outputs.background_color = [ 0, 0, 0, 255 ]
-    render_sources args
-    render_ui args
-  end
-
-#+end_src
-
-*** Rendering Basics - Sound Synthesis - main.rb
-#+begin_src ruby
-  # ./samples/01_rendering_basics/07_sound_synthesis/app/main.rb
-  begin # region: top level tick methods
-    def tick args
-      defaults args
-      render args
-      input args
-      process_audio_queue args
-    end
-  
-    def defaults args
-      args.state.sine_waves      ||= {}
-      args.state.square_waves    ||= {}
-      args.state.saw_tooth_waves ||= {}
-      args.state.triangle_waves  ||= {}
-      args.state.audio_queue     ||= []
-      args.state.buttons         ||= [
-        (frequency_buttons args),
-        (sine_wave_note_buttons args),
-        (bell_buttons args),
-        (square_wave_note_buttons args),
-        (saw_tooth_wave_note_buttons args),
-        (triangle_wave_note_buttons args),
-      ].flatten
-    end
-  
-    def render args
-      args.outputs.borders << args.state.buttons.map { |b| b[:border] }
-      args.outputs.labels  << args.state.buttons.map { |b| b[:label]  }
-      args.outputs.labels  << args.layout
-                                .rect(row: 0, col: 11.5)
-                                .yield_self { |r| r.merge y: r.y + r.h }
-                                .merge(text: "This is a Pro only feature. Click here to watch the YouTube video if you are on the Standard License.",
-                                       alignment_enum: 1)
-    end
-  
-  
-    def input args
-      args.state.buttons.each do |b|
-        if args.inputs.mouse.click && (args.inputs.mouse.click.inside_rect? b[:rect])
-          parameter_string = (b.slice :frequency, :note, :octave).map { |k, v| "#{k}: #{v}" }.join ", "
-          args.gtk.notify! "#{b[:method_to_call]} #{parameter_string}"
-          send b[:method_to_call], args, b
-        end
-      end
-  
-      if args.inputs.mouse.click && (args.inputs.mouse.click.inside_rect? (args.layout.rect(row: 0).yield_self { |r| r.merge y: r.y + r.h.half, h: r.h.half }))
-        args.gtk.openurl 'https://www.youtube.com/watch?v=zEzovM5jT-k&ab_channel=AmirRajan'
-      end
-    end
-  
-    def process_audio_queue args
-      to_queue = args.state.audio_queue.find_all { |v| v[:queue_at] <= args.tick_count }
-      args.state.audio_queue -= to_queue
-      to_queue.each { |a| args.audio[a[:id]] = a }
-  
-      args.audio.find_all { |k, v| v[:decay_rate] }
-        .each     { |k, v| v[:gain] -= v[:decay_rate] }
-  
-      sounds_to_stop = args.audio
-                         .find_all { |k, v| v[:stop_at] && args.state.tick_count >= v[:stop_at] }
-                         .map { |k, v| k }
-  
-      sounds_to_stop.each { |k| args.audio.delete k }
-    end
-  end
-  
-  begin # region: button definitions, ui layout, callback functions
-    def button args, opts
-      button_def = opts.merge rect: (args.layout.rect (opts.merge w: 2, h: 1))
-  
-      button_def[:border] = button_def[:rect].merge r: 0, g: 0, b: 0
-  
-      label_offset_x = 5
-      label_offset_y = 30
-  
-      button_def[:label]  = button_def[:rect].merge text: opts[:text],
-                                                    size_enum: -2.5,
-                                                    x: button_def[:rect].x + label_offset_x,
-                                                    y: button_def[:rect].y + label_offset_y
-  
-      button_def
-    end
-  
-    def play_sine_wave args, sender
-      queue_sine_wave args,
-                      frequency: sender[:frequency],
-                      duration: 1.seconds,
-                      fade_out: true
-    end
-  
-    def play_note args, sender
-      method_to_call = :queue_sine_wave
-      method_to_call = :queue_square_wave    if sender[:type] == :square
-      method_to_call = :queue_saw_tooth_wave if sender[:type] == :saw_tooth
-      method_to_call = :queue_triangle_wave  if sender[:type] == :triangle
-      method_to_call = :queue_bell           if sender[:type] == :bell
-  
-      send method_to_call, args,
-           frequency: (frequency_for note: sender[:note], octave: sender[:octave]),
-           duration: 1.seconds,
-           fade_out: true
-    end
-  
-    def frequency_buttons args
-      [
-        (button args,
-                row: 4.0, col: 0, text: "300hz",
-                frequency: 300,
-                method_to_call: :play_sine_wave),
-        (button args,
-                row: 5.0, col: 0, text: "400hz",
-                frequency: 400,
-                method_to_call: :play_sine_wave),
-        (button args,
-                row: 6.0, col: 0, text: "500hz",
-                frequency: 500,
-                method_to_call: :play_sine_wave),
-      ]
-    end
-  
-    def sine_wave_note_buttons args
-      [
-        (button args,
-                row: 1.5, col: 2, text: "Sine C4",
-                note: :c, octave: 4, type: :sine, method_to_call: :play_note),
-        (button args,
-                row: 2.5, col: 2, text: "Sine D4",
-                note: :d, octave: 4, type: :sine, method_to_call: :play_note),
-        (button args,
-                row: 3.5, col: 2, text: "Sine E4",
-                note: :e, octave: 4, type: :sine, method_to_call: :play_note),
-        (button args,
-                row: 4.5, col: 2, text: "Sine F4",
-                note: :f, octave: 4, type: :sine, method_to_call: :play_note),
-        (button args,
-                row: 5.5, col: 2, text: "Sine G4",
-                note: :g, octave: 4, type: :sine, method_to_call: :play_note),
-        (button args,
-                row: 6.5, col: 2, text: "Sine A5",
-                note: :a, octave: 5, type: :sine, method_to_call: :play_note),
-        (button args,
-                row: 7.5, col: 2, text: "Sine B5",
-                note: :b, octave: 5, type: :sine, method_to_call: :play_note),
-        (button args,
-                row: 8.5, col: 2, text: "Sine C5",
-                note: :c, octave: 5, type: :sine, method_to_call: :play_note),
-      ]
-    end
-  
-    def square_wave_note_buttons args
-      [
-        (button args,
-                row: 1.5, col: 6, text: "Square C4",
-                note: :c, octave: 4, type: :square, method_to_call: :play_note),
-        (button args,
-                row: 2.5, col: 6, text: "Square D4",
-                note: :d, octave: 4, type: :square, method_to_call: :play_note),
-        (button args,
-                row: 3.5, col: 6, text: "Square E4",
-                note: :e, octave: 4, type: :square, method_to_call: :play_note),
-        (button args,
-                row: 4.5, col: 6, text: "Square F4",
-                note: :f, octave: 4, type: :square, method_to_call: :play_note),
-        (button args,
-                row: 5.5, col: 6, text: "Square G4",
-                note: :g, octave: 4, type: :square, method_to_call: :play_note),
-        (button args,
-                row: 6.5, col: 6, text: "Square A5",
-                note: :a, octave: 5, type: :square, method_to_call: :play_note),
-        (button args,
-                row: 7.5, col: 6, text: "Square B5",
-                note: :b, octave: 5, type: :square, method_to_call: :play_note),
-        (button args,
-                row: 8.5, col: 6, text: "Square C5",
-                note: :c, octave: 5, type: :square, method_to_call: :play_note),
-      ]
-    end
-    def saw_tooth_wave_note_buttons args
-      [
-        (button args,
-                row: 1.5, col: 8, text: "Saw C4",
-                note: :c, octave: 4, type: :saw_tooth, method_to_call: :play_note),
-        (button args,
-                row: 2.5, col: 8, text: "Saw D4",
-                note: :d, octave: 4, type: :saw_tooth, method_to_call: :play_note),
-        (button args,
-                row: 3.5, col: 8, text: "Saw E4",
-                note: :e, octave: 4, type: :saw_tooth, method_to_call: :play_note),
-        (button args,
-                row: 4.5, col: 8, text: "Saw F4",
-                note: :f, octave: 4, type: :saw_tooth, method_to_call: :play_note),
-        (button args,
-                row: 5.5, col: 8, text: "Saw G4",
-                note: :g, octave: 4, type: :saw_tooth, method_to_call: :play_note),
-        (button args,
-                row: 6.5, col: 8, text: "Saw A5",
-                note: :a, octave: 5, type: :saw_tooth, method_to_call: :play_note),
-        (button args,
-                row: 7.5, col: 8, text: "Saw B5",
-                note: :b, octave: 5, type: :saw_tooth, method_to_call: :play_note),
-        (button args,
-                row: 8.5, col: 8, text: "Saw C5",
-                note: :c, octave: 5, type: :saw_tooth, method_to_call: :play_note),
-      ]
-    end
-  
-    def triangle_wave_note_buttons args
-      [
-        (button args,
-                row: 1.5, col: 10, text: "Triangle C4",
-                note: :c, octave: 4, type: :triangle, method_to_call: :play_note),
-        (button args,
-                row: 2.5, col: 10, text: "Triangle D4",
-                note: :d, octave: 4, type: :triangle, method_to_call: :play_note),
-        (button args,
-                row: 3.5, col: 10, text: "Triangle E4",
-                note: :e, octave: 4, type: :triangle, method_to_call: :play_note),
-        (button args,
-                row: 4.5, col: 10, text: "Triangle F4",
-                note: :f, octave: 4, type: :triangle, method_to_call: :play_note),
-        (button args,
-                row: 5.5, col: 10, text: "Triangle G4",
-                note: :g, octave: 4, type: :triangle, method_to_call: :play_note),
-        (button args,
-                row: 6.5, col: 10, text: "Triangle A5",
-                note: :a, octave: 5, type: :triangle, method_to_call: :play_note),
-        (button args,
-                row: 7.5, col: 10, text: "Triangle B5",
-                note: :b, octave: 5, type: :triangle, method_to_call: :play_note),
-        (button args,
-                row: 8.5, col: 10, text: "Triangle C5",
-                note: :c, octave: 5, type: :triangle, method_to_call: :play_note),
-      ]
-    end
-  
-    def bell_buttons args
-      [
-        (button args,
-                row: 1.5, col: 4, text: "Bell C4",
-                note: :c, octave: 4, type: :bell, method_to_call: :play_note),
-        (button args,
-                row: 2.5, col: 4, text: "Bell D4",
-                note: :d, octave: 4, type: :bell, method_to_call: :play_note),
-        (button args,
-                row: 3.5, col: 4, text: "Bell E4",
-                note: :e, octave: 4, type: :bell, method_to_call: :play_note),
-        (button args,
-                row: 4.5, col: 4, text: "Bell F4",
-                note: :f, octave: 4, type: :bell, method_to_call: :play_note),
-        (button args,
-                row: 5.5, col: 4, text: "Bell G4",
-                note: :g, octave: 4, type: :bell, method_to_call: :play_note),
-        (button args,
-                row: 6.5, col: 4, text: "Bell A5",
-                note: :a, octave: 5, type: :bell, method_to_call: :play_note),
-        (button args,
-                row: 7.5, col: 4, text: "Bell B5",
-                note: :b, octave: 5, type: :bell, method_to_call: :play_note),
-        (button args,
-                row: 8.5, col: 4, text: "Bell C5",
-                note: :c, octave: 5, type: :bell, method_to_call: :play_note),
-      ]
-    end
-  end
-  
-  begin # region: wave generation
-    begin # sine wave
-      def defaults_sine_wave_for
-        { frequency: 440, sample_rate: 48000 }
-      end
-  
-      def sine_wave_for opts = {}
-        opts = defaults_sine_wave_for.merge opts
-        frequency   = opts[:frequency]
-        sample_rate = opts[:sample_rate]
-        period_size = (sample_rate.fdiv frequency).ceil
-        period_size.map_with_index do |i|
-          Math::sin((2.0 * Math::PI) / (sample_rate.to_f / frequency.to_f) * i)
-        end.to_a
-      end
-  
-      def defaults_queue_sine_wave
-        { frequency: 440, duration: 60, gain: 1.0, fade_out: false, queue_in: 0 }
-      end
-  
-      def queue_sine_wave args, opts = {}
-        opts        = defaults_queue_sine_wave.merge opts
-        frequency   = opts[:frequency]
-        sample_rate = 48000
-  
-        sine_wave = sine_wave_for frequency: frequency, sample_rate: sample_rate
-        args.state.sine_waves[frequency] ||= sine_wave_for frequency: frequency, sample_rate: sample_rate
-  
-        proc = lambda do
-          generate_audio_data args.state.sine_waves[frequency], sample_rate
-        end
-  
-        audio_state = new_audio_state args, opts
-        audio_state[:input] = [1, sample_rate, proc]
-        queue_audio args, audio_state: audio_state, wave: sine_wave
-      end
-    end
-  
-    begin # region: square wave
-      def defaults_square_wave_for
-        { frequency: 440, sample_rate: 48000 }
-      end
-  
-      def square_wave_for opts = {}
-        opts = defaults_square_wave_for.merge opts
-        sine_wave = sine_wave_for opts
-        sine_wave.map do |v|
-          if v >= 0
-            1.0
-          else
-            -1.0
-          end
-        end.to_a
-      end
-  
-      def defaults_queue_square_wave
-        { frequency: 440, duration: 60, gain: 0.3, fade_out: false, queue_in: 0 }
-      end
-  
-      def queue_square_wave args, opts = {}
-        opts        = defaults_queue_square_wave.merge opts
-        frequency   = opts[:frequency]
-        sample_rate = 48000
-  
-        square_wave = square_wave_for frequency: frequency, sample_rate: sample_rate
-        args.state.square_waves[frequency] ||= square_wave_for frequency: frequency, sample_rate: sample_rate
-  
-        proc = lambda do
-          generate_audio_data args.state.square_waves[frequency], sample_rate
-        end
-  
-        audio_state = new_audio_state args, opts
-        audio_state[:input] = [1, sample_rate, proc]
-        queue_audio args, audio_state: audio_state, wave: square_wave
-      end
-    end
-  
-    begin # region: saw tooth wave
-      def defaults_saw_tooth_wave_for
-        { frequency: 440, sample_rate: 48000 }
-      end
-  
-      def saw_tooth_wave_for opts = {}
-        opts = defaults_saw_tooth_wave_for.merge opts
-        sine_wave = sine_wave_for opts
-        period_size = sine_wave.length
-        sine_wave.map_with_index do |v, i|
-          (((i % period_size).fdiv period_size) * 2) - 1
-        end
-      end
-  
-      def defaults_queue_saw_tooth_wave
-        { frequency: 440, duration: 60, gain: 0.3, fade_out: false, queue_in: 0 }
-      end
-  
-      def queue_saw_tooth_wave args, opts = {}
-        opts        = defaults_queue_saw_tooth_wave.merge opts
-        frequency   = opts[:frequency]
-        sample_rate = 48000
-  
-        saw_tooth_wave = saw_tooth_wave_for frequency: frequency, sample_rate: sample_rate
-        args.state.saw_tooth_waves[frequency] ||= saw_tooth_wave_for frequency: frequency, sample_rate: sample_rate
-  
-        proc = lambda do
-          generate_audio_data args.state.saw_tooth_waves[frequency], sample_rate
-        end
-  
-        audio_state = new_audio_state args, opts
-        audio_state[:input] = [1, sample_rate, proc]
-        queue_audio args, audio_state: audio_state, wave: saw_tooth_wave
-      end
-    end
-  
-    begin # region: triangle wave
-      def defaults_triangle_wave_for
-        { frequency: 440, sample_rate: 48000 }
-      end
-  
-      def triangle_wave_for opts = {}
-        opts = defaults_saw_tooth_wave_for.merge opts
-        sine_wave = sine_wave_for opts
-        period_size = sine_wave.length
-        sine_wave.map_with_index do |v, i|
-          ratio = (i.fdiv period_size)
-          if ratio <= 0.5
-            (ratio * 4) - 1
-          else
-            ratio -= 0.5
-            1 - (ratio * 4)
-          end
-        end
-      end
-  
-      def defaults_queue_triangle_wave
-        { frequency: 440, duration: 60, gain: 1.0, fade_out: false, queue_in: 0 }
-      end
-  
-      def queue_triangle_wave args, opts = {}
-        opts        = defaults_queue_triangle_wave.merge opts
-        frequency   = opts[:frequency]
-        sample_rate = 48000
-  
-        triangle_wave = triangle_wave_for frequency: frequency, sample_rate: sample_rate
-        args.state.triangle_waves[frequency] ||= triangle_wave_for frequency: frequency, sample_rate: sample_rate
-  
-        proc = lambda do
-          generate_audio_data args.state.triangle_waves[frequency], sample_rate
-        end
-  
-        audio_state = new_audio_state args, opts
-        audio_state[:input] = [1, sample_rate, proc]
-        queue_audio args, audio_state: audio_state, wave: triangle_wave
-      end
-    end
-  
-    begin # region: bell
-      def defaults_queue_bell
-        { frequency: 440, duration: 1.seconds, queue_in: 0 }
-      end
-  
-      def queue_bell args, opts = {}
-        (bell_to_sine_waves (defaults_queue_bell.merge opts)).each { |b| queue_sine_wave args, b }
-      end
-  
-      def bell_harmonics
-        [
-          { frequency_ratio: 0.5, duration_ratio: 1.00 },
-          { frequency_ratio: 1.0, duration_ratio: 0.80 },
-          { frequency_ratio: 2.0, duration_ratio: 0.60 },
-          { frequency_ratio: 3.0, duration_ratio: 0.40 },
-          { frequency_ratio: 4.2, duration_ratio: 0.25 },
-          { frequency_ratio: 5.4, duration_ratio: 0.20 },
-          { frequency_ratio: 6.8, duration_ratio: 0.15 }
-        ]
-      end
-  
-      def defaults_bell_to_sine_waves
-        { frequency: 440, duration: 1.seconds, queue_in: 0 }
-      end
-  
-      def bell_to_sine_waves opts = {}
-        opts = defaults_bell_to_sine_waves.merge opts
-        bell_harmonics.map do |b|
-          {
-            frequency: opts[:frequency] * b[:frequency_ratio],
-            duration:  opts[:duration] * b[:duration_ratio],
-            queue_in:  opts[:queue_in],
-            gain:      (1.fdiv bell_harmonics.length),
-            fade_out:  true
-          }
-        end
-      end
-    end
-  
-    begin # audio entity construction
-      def generate_audio_data sine_wave, sample_rate
-        sample_size = (sample_rate.fdiv (1000.fdiv 60)).ceil
-        copy_count  = (sample_size.fdiv sine_wave.length).ceil
-        sine_wave * copy_count
-      end
-  
-      def defaults_new_audio_state
-        { frequency: 440, duration: 60, gain: 1.0, fade_out: false, queue_in: 0 }
-      end
-  
-      def new_audio_state args, opts = {}
-        opts        = defaults_new_audio_state.merge opts
-        decay_rate  = 0
-        decay_rate  = 1.fdiv(opts[:duration]) * opts[:gain] if opts[:fade_out]
-        frequency   = opts[:frequency]
-        sample_rate = 48000
-  
-        {
-          id:               (new_id! args),
-          frequency:        frequency,
-          sample_rate:      48000,
-          stop_at:          args.tick_count + opts[:queue_in] + opts[:duration],
-          gain:             opts[:gain].to_f,
-          queue_at:         args.state.tick_count + opts[:queue_in],
-          decay_rate:       decay_rate,
-          pitch:            1.0,
-          looping:          true,
-          paused:           false
-        }
-      end
-  
-      def queue_audio args, opts = {}
-        graph_wave args, opts[:wave], opts[:audio_state][:frequency]
-        args.state.audio_queue << opts[:audio_state]
-      end
-  
-      def new_id! args
-        args.state.audio_id ||= 0
-        args.state.audio_id  += 1
-      end
-  
-      def graph_wave args, wave, frequency
-        if args.state.tick_count != args.state.graphed_at
-          args.outputs.static_lines.clear
-          args.outputs.static_sprites.clear
-        end
-  
-        wave = wave
-  
-        r, g, b = frequency.to_i % 85,
-                  frequency.to_i % 170,
-                  frequency.to_i % 255
-  
-        starting_rect = args.layout.rect(row: 5, col: 13)
-        x_scale    = 10
-        y_scale    = 100
-        max_points = 25
-  
-        points = wave
-        if wave.length > max_points
-          resolution = wave.length.idiv max_points
-          points = wave.find_all.with_index { |y, i| (i % resolution == 0) }
-        end
-  
-        args.outputs.static_lines << points.map_with_index do |y, x|
-          next_y = points[x + 1]
-  
-          if next_y
-            {
-              x:  starting_rect.x + (x * x_scale),
-              y:  starting_rect.y + starting_rect.h.half + y_scale * y,
-              x2: starting_rect.x + ((x + 1) * x_scale),
-              y2: starting_rect.y + starting_rect.h.half + y_scale * next_y,
-              r:  r,
-              g:  g,
-              b:  b
-            }
-          end
-        end
-  
-        args.outputs.static_sprites << points.map_with_index do |y, x|
-          {
-            x:  (starting_rect.x + (x * x_scale)) - 2,
-            y:  (starting_rect.y + starting_rect.h.half + y_scale * y) - 2,
-            w:  4,
-            h:  4,
-            path: 'sprites/square-white.png',
-            r: r,
-            g: g,
-            b: b
-          }
-        end
-  
-        args.state.graphed_at = args.state.tick_count
-      end
-    end
-  
-    begin # region: musical note mapping
-      def defaults_frequency_for
-        { note: :a, octave: 5, sharp:  false, flat:   false }
-      end
-  
-      def frequency_for opts = {}
-        opts = defaults_frequency_for.merge opts
-        octave_offset_multiplier  = opts[:octave] - 5
-        note = note_frequencies_octave_5[opts[:note]]
-        if octave_offset_multiplier < 0
-          note = note * 1 / (octave_offset_multiplier.abs + 1)
-        elsif octave_offset_multiplier > 0
-          note = note * (octave_offset_multiplier.abs + 1) / 1
-        end
-        note
-      end
-  
-      def note_frequencies_octave_5
-        {
-          a: 440.0,
-          a_sharp: 466.16, b_flat: 466.16,
-          b: 493.88,
-          c: 523.25,
-          c_sharp: 554.37, d_flat: 587.33,
-          d: 587.33,
-          d_sharp: 622.25, e_flat: 659.25,
-          e: 659.25,
-          f: 698.25,
-          f_sharp: 739.99, g_flat: 739.99,
-          g: 783.99,
-          g_sharp: 830.61, a_flat: 830.61
-        }
-      end
-    end
-  end
-  
-  $gtk.reset
-
-#+end_src
-
 *** Input Basics - Keyboard - main.rb
 #+begin_src ruby
   # ./samples/02_input_basics/01_keyboard/app/main.rb
@@ -4626,9 +3990,9 @@ Follows is a source code listing for all files that have been open sourced. This
   def tick args
     tick_instructions args, "Sample app shows how keyboard events are registered and accessed.", 360
     # Notice how small_font accounts for all the remaining parameters
-    args.outputs.labels << [460, row_to_px(args, 0), "Current game time: #{args.state.tick_count}", small_font]
-    args.outputs.labels << [460, row_to_px(args, 2), "Keyboard input: args.inputs.keyboard.key_up.h", small_font]
-    args.outputs.labels << [460, row_to_px(args, 3), "Press \"h\" on the keyboard.", small_font]
+    args.outputs.labels << { x: 460, y: row_to_px(args, 0), text: "Current game time: #{args.state.tick_count}", size_enum: -1 }
+    args.outputs.labels << { x: 460, y: row_to_px(args, 2), text: "Keyboard input: args.inputs.keyboard.key_up.h", size_enum: -1 }
+    args.outputs.labels << { x: 460, y: row_to_px(args, 3), text: "Press \"h\" on the keyboard.", size_enum: -1 }
   
     # Input on a specifc key can be found through args.inputs.keyboard.key_up followed by the key
     if args.inputs.keyboard.key_up.h
@@ -4639,27 +4003,19 @@ Follows is a source code listing for all files that have been open sourced. This
     args.state.h_pressed_at ||= false
   
     if args.state.h_pressed_at
-      args.outputs.labels << [460, row_to_px(args, 4), "\"h\" was pressed at time: #{args.state.h_pressed_at}", small_font]
+      args.outputs.labels << { x: 460, y: row_to_px(args, 4), text: "\"h\" was pressed at time: #{args.state.h_pressed_at}", size_enum: -1 }
     else
-      args.outputs.labels << [460, row_to_px(args, 4), "\"h\" has never been pressed.", small_font]
+      args.outputs.labels << { x: 460, y: row_to_px(args, 4), text: "\"h\" has never been pressed.", size_enum: -1 }
     end
   
     tick_help_text args
   end
   
-  def small_font
-    # This method provides some values for the construction of labels
-    # Specifically, Size, Alignment, & RGBA
-    # This makes it so that custom parameters don't have to be repeatedly typed.
-    # Additionally "small_font" provides programmers with more information than some numbers
-    [-2, 0, 0, 0, 0, 255]
-  end
-  
-  def row_to_px args, row_number
+  def row_to_px args, row_number, y_offset = 20
     # This takes a row_number and converts it to pixels DragonRuby understands.
     # Row 0 starts 5 units below the top of the grid
     # Each row afterward is 20 units lower
-    args.grid.top.shift_down(5).shift_down(20 * row_number)
+    args.grid.top - 5 - (y_offset * row_number)
   end
   
   # Don't worry about understanding the code within this method just yet.
@@ -4689,17 +4045,17 @@ Follows is a source code listing for all files that have been open sourced. This
       end
     end
   
-    args.outputs.labels << [10, row_to_px(args, 6), "Advanced Help:", small_font]
+    args.outputs.labels << { x: 10, y: row_to_px(args, 6), text: "This is the api for the keys you've pressed:", size_enum: -1, r: 180 }
   
     if !args.state.help_available
       args.outputs.labels << [10, row_to_px(args, 7),  "Press a key and I'll show code to access the key and what value will be returned if you used the code.", small_font]
       return
     end
   
-    args.outputs.labels << [10 , row_to_px(args, 7), "args.inputs.keyboard", small_font]
-    args.outputs.labels << [330, row_to_px(args, 7), "args.inputs.keyboard.key_down", small_font]
-    args.outputs.labels << [650, row_to_px(args, 7), "args.inputs.keyboard.key_held", small_font]
-    args.outputs.labels << [990, row_to_px(args, 7), "args.inputs.keyboard.key_up", small_font]
+    args.outputs.labels << { x: 10 , y: row_to_px(args, 7), text: "args.inputs.keyboard",          size_enum: -2 }
+    args.outputs.labels << { x: 330, y: row_to_px(args, 7), text: "args.inputs.keyboard.key_down", size_enum: -2 }
+    args.outputs.labels << { x: 650, y: row_to_px(args, 7), text: "args.inputs.keyboard.key_held", size_enum: -2 }
+    args.outputs.labels << { x: 990, y: row_to_px(args, 7), text: "args.inputs.keyboard.key_up",   size_enum: -2 }
   
     fill_history args, :key_value_history,      :down_or_held, nil
     fill_history args, :key_down_value_history, :down,        :key_down
@@ -4745,12 +4101,8 @@ Follows is a source code listing for all files that have been open sourced. This
       end
       idx += 2
       [
-        [x, row_to_px(args, idx - 2),
-         "    .#{k} is #{current_value || "nil"}",
-         small_font],
-        [x, row_to_px(args, idx - 1),
-         "       was #{v}",
-         small_font]
+        { x: x, y: row_to_px(args, idx + 0, 16), text: "    .#{k} is #{current_value || "nil"}", size_enum: -2 },
+        { x: x, y: row_to_px(args, idx + 1, 16), text: "       was #{v}", size_enum: -2 }
       ]
     end
   end
@@ -4765,10 +4117,48 @@ Follows is a source code listing for all files that have been open sourced. This
       args.state.key_event_occurred = true
     end
   
-    args.outputs.debug << [0, y - 50, 1280, 60].solid
-    args.outputs.debug << [640, y, text, 1, 1, 255, 255, 255].label
-    args.outputs.debug << [640, y - 25, "(click to dismiss instructions)" , -2, 1, 255, 255, 255].label
+    args.outputs.debug << { x: 0,   y: y - 50, w: 1280, h: 60 }.solid!
+    args.outputs.debug << { x: 640, y: y,      text: text,
+                            size_enum: 1, alignment_enum: 1, r: 255, g: 255, b: 255 }.label!
+    args.outputs.debug << { x: 640, y: y - 25, text: "(click to dismiss instructions)",
+                            size_enum: -2, alignment_enum: 1, r: 255, g: 255, b: 255 }.label!
+  end
+
+#+end_src
+
+*** Input Basics - Moving A Sprite - main.rb
+#+begin_src ruby
+  # ./samples/02_input_basics/01_moving_a_sprite/app/main.rb
+  def tick args
+    # create a player and set default values
+    # for the player's x, y, w (width), and h (height)
+    args.state.player.x ||= 100
+    args.state.player.y ||= 100
+    args.state.player.w ||=  50
+    args.state.player.h ||=  50
+  
+    # render the player to the screen
+    args.outputs.sprites << { x: args.state.player.x,
+                              y: args.state.player.y,
+                              w: args.state.player.w,
+                              h: args.state.player.h,
+                              path: 'sprites/square/green.png' }
+  
+    # move the player around using the keyboard
+    if args.inputs.up
+      args.state.player.y += 10
+    elsif args.inputs.down
+      args.state.player.y -= 10
+    end
+  
+    if args.inputs.left
+      args.state.player.x -= 10
+    elsif args.inputs.right
+      args.state.player.x += 10
+    end
   end
+  
+  $gtk.reset
 
 #+end_src
 
@@ -4838,11 +4228,7 @@ Follows is a source code listing for all files that have been open sourced. This
     # This method effectively combines the row_to_px and small_font methods
     # It changes the given row value to a DragonRuby pixel value
     # and adds the customization parameters
-    [x, row_to_px(args, row), message, small_font]
-  end
-  
-  def small_font
-    [-2, 0, 0, 0, 0, 255]
+    { x: x, y: row_to_px(args, row), text: message, alignment_enum: -2 }
   end
   
   def row_to_px args, row_number
@@ -4858,9 +4244,9 @@ Follows is a source code listing for all files that have been open sourced. This
       args.state.key_event_occurred = true
     end
   
-    args.outputs.debug << [0, y - 50, 1280, 60].solid
-    args.outputs.debug << [640, y, text, 1, 1, 255, 255, 255].label
-    args.outputs.debug << [640, y - 25, "(click to dismiss instructions)" , -2, 1, 255, 255, 255].label
+    args.outputs.debug << { x: 0,   y: y - 50, w: 1280, h: 60 }.solid!
+    args.outputs.debug << { x: 640, y: y, text: text, size_enum: 1, alignment_enum: 1, r: 255, g: 255, b: 255 }.label!
+    args.outputs.debug << { x: 640, y: y - 25, text: "(click to dismiss instructions)", size_enum: -2, alignment_enum: 1, r: 255, g: 255, b: 255 }.label!
   end
 
 #+end_src
@@ -4912,7 +4298,7 @@ Follows is a source code listing for all files that have been open sourced. This
   
     args.outputs.labels << small_label(args, x, 15, "Click inside the blue box maybe ---->")
   
-    box = [785, 370, 50, 50, 0, 0, 170]
+    box = { x: 785, y: 370, w: 50, h: 50, r: 0, g: 0, b: 170 }
     args.outputs.borders << box
   
     # Saves the most recent click into args.state
@@ -4934,11 +4320,7 @@ Follows is a source code listing for all files that have been open sourced. This
   end
   
   def small_label args, x, row, message
-    [x, row_to_px(args, row), message, small_font]
-  end
-  
-  def small_font
-    [-2, 0, 0, 0, 0, 255]
+    { x: x, y: row_to_px(args, row), text: message, size_enum: -2 }
   end
   
   def row_to_px args, row_number
@@ -4954,9 +4336,9 @@ Follows is a source code listing for all files that have been open sourced. This
       args.state.key_event_occurred = true
     end
   
-    args.outputs.debug << [0, y - 50, 1280, 60].solid
-    args.outputs.debug << [640, y, text, 1, 1, 255, 255, 255].label
-    args.outputs.debug << [640, y - 25, "(click to dismiss instructions)" , -2, 1, 255, 255, 255].label
+    args.outputs.debug << { x: 0,   y: y - 50, w: 1280, h: 60 }.solid!
+    args.outputs.debug << { x: 640, y: y, text: text, size_enum: 1, alignment_enum: 1, r: 255, g: 255, b: 255 }.label!
+    args.outputs.debug << { x: 640, y: y - 25, text: "(click to dismiss instructions)", size_enum: -2, alignment_enum: 1, r: 255, g: 255, b: 255 }.label!
   end
 
 #+end_src
@@ -5008,9 +4390,15 @@ Follows is a source code listing for all files that have been open sourced. This
     # They are stored in game so that they do not get reset every tick
     if args.inputs.mouse.click
       if !args.state.box_collision_one
-        args.state.box_collision_one = [args.inputs.mouse.click.point.x - 25, args.inputs.mouse.click.point.y - 25, 125, 125, 180, 0,   0, 180]
+        args.state.box_collision_one = { x: args.inputs.mouse.click.point.x - 25,
+                                         y: args.inputs.mouse.click.point.y - 25,
+                                         w: 125, h: 125,
+                                         r: 180, g: 0, b: 0, a: 180 }
       elsif !args.state.box_collision_two
-        args.state.box_collision_two = [args.inputs.mouse.click.point.x - 25, args.inputs.mouse.click.point.y - 25, 125, 125,   0, 0, 180, 180]
+        args.state.box_collision_two = { x: args.inputs.mouse.click.point.x - 25,
+                                         y: args.inputs.mouse.click.point.y - 25,
+                                         w: 125, h: 125,
+                                         r: 0, g: 0, b: 180, a: 180 }
       else
         args.state.box_collision_one = nil
         args.state.box_collision_two = nil
@@ -5037,15 +4425,11 @@ Follows is a source code listing for all files that have been open sourced. This
   end
   
   def small_label args, x, row, message
-    [x, row_to_px(args, row), message, small_font]
-  end
-  
-  def small_font
-    [-2, 0, 0, 0, 0, 255]
+    { x: x, y: row_to_px(args, row), text: message, size_enum: -2 }
   end
   
   def row_to_px args, row_number
-    args.grid.top.shift_down(5).shift_down(20 * row_number)
+    args.grid.top - 5 - (20 * row_number)
   end
   
   def tick_instructions args, text, y = 715
@@ -5111,57 +4495,51 @@ Follows is a source code listing for all files that have been open sourced. This
     def process_inputs
       state.buttons = []
   
-      state.buttons << [100, 500, inputs.controller_one.key_held.l1, "L1"]
-      state.buttons << [100, 600, inputs.controller_one.key_held.l2, "L2"]
-  
-      state.buttons << [1100, 500, inputs.controller_one.key_held.r1, "R1"]
-      state.buttons << [1100, 600, inputs.controller_one.key_held.r2, "R2"]
-  
-      state.buttons << [540, 450, inputs.controller_one.key_held.select, "Select"]
-      state.buttons << [660, 450, inputs.controller_one.key_held.start, "Start"]
-  
-      state.buttons << [200, 300, inputs.controller_one.key_held.left, "Left"]
-      state.buttons << [300, 400, inputs.controller_one.key_held.up, "Up"]
-      state.buttons << [400, 300, inputs.controller_one.key_held.right, "Right"]
-      state.buttons << [300, 200, inputs.controller_one.key_held.down, "Down"]
-  
-      state.buttons << [800, 300, inputs.controller_one.key_held.x, "X"]
-      state.buttons << [900, 400, inputs.controller_one.key_held.y, "Y"]
-      state.buttons << [1000, 300, inputs.controller_one.key_held.a, "A"]
-      state.buttons << [900, 200, inputs.controller_one.key_held.b, "B"]
-  
-      state.buttons << [450 + inputs.controller_one.left_analog_x_perc * 100,
-                        100 + inputs.controller_one.left_analog_y_perc * 100,
-                        inputs.controller_one.key_held.l3,
-                        "L3"]
-  
-      state.buttons << [750 + inputs.controller_one.right_analog_x_perc * 100,
-                        100 + inputs.controller_one.right_analog_y_perc * 100,
-                        inputs.controller_one.key_held.r3,
-                        "R3"]
+      state.buttons << { x: 100,  y: 500, active: inputs.controller_one.key_held.l1, text: "L1"}
+      state.buttons << { x: 100,  y: 600, active: inputs.controller_one.key_held.l2, text: "L2"}
+      state.buttons << { x: 1100, y: 500, active: inputs.controller_one.key_held.r1, text: "R1"}
+      state.buttons << { x: 1100, y: 600, active: inputs.controller_one.key_held.r2, text: "R2"}
+      state.buttons << { x: 540,  y: 450, active: inputs.controller_one.key_held.select, text: "Select"}
+      state.buttons << { x: 660,  y: 450, active: inputs.controller_one.key_held.start, text: "Start"}
+      state.buttons << { x: 200,  y: 300, active: inputs.controller_one.key_held.left, text: "Left"}
+      state.buttons << { x: 300,  y: 400, active: inputs.controller_one.key_held.up, text: "Up"}
+      state.buttons << { x: 400,  y: 300, active: inputs.controller_one.key_held.right, text: "Right"}
+      state.buttons << { x: 300,  y: 200, active: inputs.controller_one.key_held.down, text: "Down"}
+      state.buttons << { x: 800,  y: 300, active: inputs.controller_one.key_held.x, text: "X"}
+      state.buttons << { x: 900,  y: 400, active: inputs.controller_one.key_held.y, text: "Y"}
+      state.buttons << { x: 1000, y: 300, active: inputs.controller_one.key_held.a, text: "A"}
+      state.buttons << { x: 900,  y: 200, active: inputs.controller_one.key_held.b, text: "B"}
+      state.buttons << { x: 450 + inputs.controller_one.left_analog_x_perc * 100,
+                         y: 100 + inputs.controller_one.left_analog_y_perc * 100,
+                         active: inputs.controller_one.key_held.l3,
+                         text: "L3" }
+      state.buttons << { x: 750 + inputs.controller_one.right_analog_x_perc * 100,
+                         y: 100 + inputs.controller_one.right_analog_y_perc * 100,
+                         active: inputs.controller_one.key_held.r3,
+                         text: "R3" }
     end
   
     # Gives each button a square shape.
     # If the button is being pressed or held (which means it is considered active),
     # the square is filled in. Otherwise, the button simply has a border.
     def render
-      state.buttons.each do |x, y, active, text|
-        rect = [x, y, 75, 75]
+      state.buttons.each do |b|
+        rect = { x: b.x, y: b.y, w: 75, h: 75 }
   
-        if active # if button is pressed
+        if b.active # if button is pressed
           outputs.solids << rect # rect is output as solid (filled in)
         else
           outputs.borders << rect # otherwise, output as border
         end
   
         # Outputs the text of each button using labels.
-        outputs.labels << [x, y + 95, text] # add 95 to place label above button
+        outputs.labels << { x: b.x, y: b.y + 95, text: b.text } # add 95 to place label above button
       end
   
-      outputs.labels << [10, 60, "Left Analog x: #{inputs.controller_one.left_analog_x_raw} (#{inputs.controller_one.left_analog_x_perc * 100}%)"]
-      outputs.labels << [10, 30, "Left Analog y: #{inputs.controller_one.left_analog_y_raw} (#{inputs.controller_one.left_analog_y_perc * 100}%)"]
-      outputs.labels << [900, 60, "Right Analog x: #{inputs.controller_one.right_analog_x_raw} (#{inputs.controller_one.right_analog_x_perc * 100}%)"]
-      outputs.labels << [900, 30, "Right Analog y: #{inputs.controller_one.right_analog_y_raw} (#{inputs.controller_one.right_analog_y_perc * 100}%)"]
+      outputs.labels << { x:  10, y: 60, text: "Left Analog x: #{inputs.controller_one.left_analog_x_raw} (#{inputs.controller_one.left_analog_x_perc * 100}%)" }
+      outputs.labels << { x:  10, y: 30, text: "Left Analog y: #{inputs.controller_one.left_analog_y_raw} (#{inputs.controller_one.left_analog_y_perc * 100}%)" }
+      outputs.labels << { x: 900, y: 60, text: "Right Analog x: #{inputs.controller_one.right_analog_x_raw} (#{inputs.controller_one.right_analog_x_perc * 100}%)" }
+      outputs.labels << { x: 900, y: 30, text: "Right Analog y: #{inputs.controller_one.right_analog_y_raw} (#{inputs.controller_one.right_analog_y_perc * 100}%)" }
     end
   end
   
@@ -5212,10 +4590,12 @@ Follows is a source code listing for all files that have been open sourced. This
     #  the next new touch will be finger_one again, but until then, new touches
     #  don't fill in earlier slots.
     if !args.inputs.finger_one.nil?
-      args.outputs.primitives << [640, 650, "Finger #1 is touching at (#{args.inputs.finger_one.x}, #{args.inputs.finger_one.y}).", 5, 1, 255, 255, 255].label
+      args.outputs.primitives << { x: 640, y: 650, text: "Finger #1 is touching at (#{args.inputs.finger_one.x}, #{args.inputs.finger_one.y}).",
+                                   size_enum: 5, alignment_enum: 1, r: 255, g: 255, b: 255 }.label!
     end
     if !args.inputs.finger_two.nil?
-      args.outputs.primitives << [640, 600, "Finger #2 is touching at (#{args.inputs.finger_two.x}, #{args.inputs.finger_two.y}).", 5, 1, 255, 255, 255].label
+      args.outputs.primitives << { x: 640, y: 600, text: "Finger #2 is touching at (#{args.inputs.finger_two.x}, #{args.inputs.finger_two.y}).",
+                                   size_enum: 5, alignment_enum: 1, r: 255, g: 255, b: 255 }.label!
     end
   
     # Here's the more flexible interface: this will report as many simultaneous
@@ -5236,11 +4616,10 @@ Follows is a source code listing for all files that have been open sourced. This
       r = (color & 0xFF0000) >> 16
       g = (color & 0x00FF00) >> 8
       b = (color & 0x0000FF)
-      args.outputs.primitives << [v.x - (size / 2), v.y + (size / 2), size, size, r, g, b, 255].solid
-      args.outputs.primitives << [v.x, v.y + size, k.to_s, 0, 1, 0, 0, 0].label
+      args.outputs.primitives << { x: v.x - (size / 2), y: v.y + (size / 2), w: size, h: size, r: r, g: g, b: b, a: 255 }.solid!
+      args.outputs.primitives << { x: v.x, y: v.y + size, text: k.to_s, alignment_enum: 1 }.label!
     }
   end
-  
 
 #+end_src
 
@@ -5280,6 +4659,8 @@ Follows is a source code listing for all files that have been open sourced. This
   # 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
@@ -5312,22 +4693,22 @@ Follows is a source code listing for all files that have been open sourced. This
                                                 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.
@@ -5360,7 +4741,7 @@ Follows is a source code listing for all files that have been open sourced. This
     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
@@ -7353,9 +6734,9 @@ Follows is a source code listing for all files that have been open sourced. This
       mouse_overlay = mouse_overlay.merge r: 255 if state.delete_mode
   
       if state.mouse_held
-        outputs.primitives << mouse_overlay.border
+        outputs.primitives << mouse_overlay.border!
       else
-        outputs.primitives << mouse_overlay.solid
+        outputs.primitives << mouse_overlay.solid!
       end
     end
   
@@ -11650,6 +11031,1008 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
+*** Advanced Audio - Audio Mixer - main.rb
+#+begin_src ruby
+  # ./samples/07_advanced_audio/01_audio_mixer/app/main.rb
+  # these are the properties that you can sent on args.audio
+  def spawn_new_sound args, name, path
+    # Spawn randomly in an area that won't be covered by UI.
+    screenx = (rand * 600.0) + 200.0
+    screeny = (rand * 400.0) + 100.0
+  
+    id = new_sound_id! args
+    # you can hang anything on the audio hashes you want, so we store the
+    #  actual screen position in here for convenience.
+    args.audio[id] = {
+      name: name,
+      input: path,
+      screenx: screenx,
+      screeny: screeny,
+      x: ((screenx / 1279.0) * 2.0) - 1.0,  # scale to -1.0 - 1.0 range
+      y: ((screeny / 719.0) * 2.0) - 1.0,   # scale to -1.0 - 1.0 range
+      z: 0.0,
+      gain: 1.0,
+      pitch: 1.0,
+      looping: true,
+      paused: false
+    }
+  
+    args.state.selected = id
+  end
+  
+  # these are values you can change on the ~args.audio~ data structure
+  def input_panel args
+    return unless args.state.panel
+    return if args.state.dragging
+  
+    audio_entry = args.audio[args.state.selected]
+    results = args.state.panel
+  
+    if args.state.mouse_state == :held && args.inputs.mouse.position.inside_rect?(results.pitch_slider_rect.rect)
+      audio_entry.pitch = 2.0 * ((args.inputs.mouse.x - results.pitch_slider_rect.x).to_f / (results.pitch_slider_rect.w - 1.0))
+    elsif args.state.mouse_state == :held && args.inputs.mouse.position.inside_rect?(results.playtime_slider_rect.rect)
+      audio_entry.playtime = audio_entry.length_ * ((args.inputs.mouse.x - results.playtime_slider_rect.x).to_f / (results.playtime_slider_rect.w - 1.0))
+    elsif args.state.mouse_state == :held && args.inputs.mouse.position.inside_rect?(results.gain_slider_rect.rect)
+      audio_entry.gain = (args.inputs.mouse.x - results.gain_slider_rect.x).to_f / (results.gain_slider_rect.w - 1.0)
+    elsif args.inputs.mouse.click && args.inputs.mouse.position.inside_rect?(results.looping_checkbox_rect.rect)
+      audio_entry.looping = !audio_entry.looping
+    elsif args.inputs.mouse.click && args.inputs.mouse.position.inside_rect?(results.paused_checkbox_rect.rect)
+      audio_entry.paused = !audio_entry.paused
+    elsif args.inputs.mouse.click && args.inputs.mouse.position.inside_rect?(results.delete_button_rect.rect)
+      args.audio.delete args.state.selected
+    end
+  end
+  
+  def render_sources args
+    args.outputs.primitives << args.audio.keys.map do |k|
+      s = args.audio[k]
+  
+      isselected = (k == args.state.selected)
+  
+      color = isselected ? [ 0, 255, 0, 255 ] : [ 0, 0, 255, 255 ]
+      [
+        [s.screenx, s.screeny, args.state.boxsize, args.state.boxsize, *color].solid,
+  
+        {
+          x: s.screenx + args.state.boxsize.half,
+          y: s.screeny,
+          text: s.name,
+          r: 255,
+          g: 255,
+          b: 255,
+          alignment_enum: 1
+        }.label!
+      ]
+    end
+  end
+  
+  def playtime_str t
+    minutes = (t / 60.0).floor
+    seconds = t - (minutes * 60.0).to_f
+    return minutes.to_s + ':' + seconds.floor.to_s + ((seconds - seconds.floor).to_s + "000")[1..3]
+  end
+  
+  def label_with_drop_shadow x, y, text
+    [
+      { x: x + 1, y: y + 1, text: text, vertical_alignment_enum: 1, alignment_enum: 1, r:   0, g:   0, b:   0 }.label!,
+      { x: x + 2, y: y + 0, text: text, vertical_alignment_enum: 1, alignment_enum: 1, r:   0, g:   0, b:   0 }.label!,
+      { x: x + 0, y: y + 1, text: text, vertical_alignment_enum: 1, alignment_enum: 1, r: 200, g: 200, b: 200 }.label!
+    ]
+  end
+  
+  def check_box opts = {}
+    checkbox_template = opts.args.layout.rect(w: 0.5, h: 0.5, col: 2)
+    final_rect = checkbox_template.center_inside_rect_y(opts.args.layout.rect(row: opts.row, col: opts.col))
+    color = { r:   0, g:   0, b:   0 }
+    color = { r: 255, g: 255, b: 255 } if opts.checked
+  
+    {
+      rect: final_rect,
+      primitives: [
+        (final_rect.to_solid color)
+      ]
+    }
+  end
+  
+  def progress_bar opts = {}
+    outer_rect  = opts.args.layout.rect(row: opts.row, col: opts.col, w: 5, h: 1)
+    color = opts.percentage * 255
+    baseline_progress_bar = opts.args
+                                .layout
+                                .rect(w: 5, h: 0.5)
+  
+    final_rect = baseline_progress_bar.center_inside_rect(outer_rect)
+    center = final_rect.rect_center_point
+  
+    {
+      rect: final_rect,
+      primitives: [
+        final_rect.merge(r: color, g: color, b: color, a: 128).solid!,
+        label_with_drop_shadow(center.x, center.y, opts.text)
+      ]
+    }
+  end
+  
+  def panel_primitives args, audio_entry
+    results = { primitives: [] }
+  
+    return results unless audio_entry
+  
+    # this uses DRGTK's layout apis to layout the controls
+    # imagine the screen is split into equal cells (24 cells across, 12 cells up and down)
+    # args.layout.rect returns a hash which we merge values with to create primitives
+    # using args.layout.rect removes the need for pixel pushing
+  
+    # args.outputs.debug << args.layout.debug_primitives(r: 255, g: 255, b: 255)
+  
+    white_color = { r: 255, g: 255, b: 255 }
+    label_style = white_color.merge(vertical_alignment_enum: 1)
+  
+    # panel background
+    results.primitives << args.layout.rect(row: 0, col: 0, w: 7, h: 6, include_col_gutter: true, include_row_gutter: true)
+                                     .border!(r: 255, g: 255, b: 255)
+  
+    # title
+    results.primitives << args.layout.point(row: 0, col: 3.5, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text:           "Source #{args.state.selected} (#{args.audio[args.state.selected].name})",
+                                            size_enum:      3,
+                                            alignment_enum: 1)
+  
+    # seperator line
+    results.primitives << args.layout.rect(row: 1, col: 0, w: 7, h: 0)
+                                     .line!(white_color)
+  
+    # screen location
+    results.primitives << args.layout.point(row: 1.0, col: 0, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "screen:")
+  
+    results.primitives << args.layout.point(row: 1.0, col: 2, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "(#{audio_entry.screenx.to_i}, #{audio_entry.screeny.to_i})")
+  
+    # position
+    results.primitives << args.layout.point(row: 1.5, col: 0, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "position:")
+  
+    results.primitives << args.layout.point(row: 1.5, col: 2, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "(#{audio_entry[:x].round(5).to_s[0..6]}, #{audio_entry[:y].round(5).to_s[0..6]})")
+  
+    results.primitives << args.layout.point(row: 2.0, col: 0, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "pitch:")
+  
+    results.pitch_slider_rect = progress_bar(row: 2.0, col: 2,
+                                             percentage: audio_entry.pitch / 2.0,
+                                             text: "#{audio_entry.pitch.to_sf}",
+                                             args: args)
+  
+    results.primitives << results.pitch_slider_rect.primitives
+  
+    results.primitives << args.layout.point(row: 2.5, col: 0, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "playtime:")
+  
+    results.playtime_slider_rect = progress_bar(args: args,
+                                                row:  2.5,
+                                                col:  2,
+                                                percentage: audio_entry.playtime / audio_entry.length_,
+                                                text: "#{playtime_str(audio_entry.playtime)} / #{playtime_str(audio_entry.length_)}")
+  
+    results.primitives << results.playtime_slider_rect.primitives
+  
+    results.primitives << args.layout.point(row: 3.0, col: 0, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "gain:")
+  
+    results.gain_slider_rect = progress_bar(args: args,
+                                            row:  3.0,
+                                            col:  2,
+                                            percentage: audio_entry.gain,
+                                            text: "#{audio_entry.gain.to_sf}")
+  
+    results.primitives << results.gain_slider_rect.primitives
+  
+  
+    results.primitives << args.layout.point(row: 3.5, col: 0, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "looping:")
+  
+    checkbox_template = args.layout.rect(w: 0.5, h: 0.5, col: 2)
+  
+    results.looping_checkbox_rect = check_box(args: args, row: 3.5, col: 2, checked: audio_entry.looping)
+    results.primitives << results.looping_checkbox_rect.primitives
+  
+    results.primitives << args.layout.point(row: 4.0, col: 0, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "paused:")
+  
+    checkbox_template = args.layout.rect(w: 0.5, h: 0.5, col: 2)
+  
+    results.paused_checkbox_rect = check_box(args: args, row: 4.0, col: 2, checked: !audio_entry.paused)
+    results.primitives << results.paused_checkbox_rect.primitives
+  
+    results.delete_button_rect = { rect: args.layout.rect(row: 5, col: 0, w: 7, h: 1) }
+  
+    results.primitives << results.delete_button_rect.to_solid(r: 180)
+  
+    results.primitives << args.layout.point(row: 5, col: 3.5, row_anchor: 0.5)
+                                     .merge(label_style)
+                                     .merge(text: "DELETE", alignment_enum: 1)
+  
+    return results
+  end
+  
+  def render_panel args
+    args.state.panel = nil
+    audio_entry = args.audio[args.state.selected]
+    return unless audio_entry
+  
+    mouse_down = (args.state.mouse_held >= 0)
+    args.state.panel = panel_primitives args, audio_entry
+    args.outputs.primitives << args.state.panel.primitives
+  end
+  
+  def new_sound_id! args
+    args.state.sound_id ||= 0
+    args.state.sound_id  += 1
+    args.state.sound_id
+  end
+  
+  def render_launcher args
+    args.outputs.primitives << args.state.spawn_sound_buttons.map(&:primitives)
+  end
+  
+  def render_ui args
+    render_launcher args
+    render_panel args
+  end
+  
+  def tick args
+    defaults args
+    render args
+    input args
+  end
+  
+  def input args
+    if !args.audio[args.state.selected]
+      args.state.selected = nil
+      args.state.dragging = nil
+    end
+  
+    # spawn button and node interaction
+    if args.inputs.mouse.click
+      spawn_sound_button = args.state.spawn_sound_buttons.find { |b| args.inputs.mouse.inside_rect? b.rect }
+  
+      audio_click_key, audio_click_value = args.audio.find do |k, v|
+        args.inputs.mouse.inside_rect? [v.screenx, v.screeny, args.state.boxsize, args.state.boxsize]
+      end
+  
+      if spawn_sound_button
+        args.state.selected = nil
+        spawn_new_sound args, spawn_sound_button.name, spawn_sound_button.path
+      elsif audio_click_key
+        args.state.selected = audio_click_key
+      end
+    end
+  
+    if args.state.mouse_state == :held && args.state.selected
+      v = args.audio[args.state.selected]
+      if args.inputs.mouse.inside_rect? [v.screenx, v.screeny, args.state.boxsize, args.state.boxsize]
+        args.state.dragging = args.state.selected
+      end
+  
+      if args.state.dragging
+        s = args.audio[args.state.selected]
+        # you can hang anything on the audio hashes you want, so we store the
+        #  actual screen position so it doesn't scale weirdly vs your mouse.
+        s.screenx = args.inputs.mouse.x - (args.state.boxsize / 2)
+        s.screeny = args.inputs.mouse.y - (args.state.boxsize / 2)
+  
+        s.screeny = 50 if s.screeny < 50
+        s.screeny = (719 - args.state.boxsize) if s.screeny > (719 - args.state.boxsize)
+        s.screenx = 0 if s.screenx < 0
+        s.screenx = (1279 - args.state.boxsize) if s.screenx > (1279 - args.state.boxsize)
+  
+        s.x = ((s.screenx / 1279.0) * 2.0) - 1.0  # scale to -1.0 - 1.0 range
+        s.y = ((s.screeny / 719.0) * 2.0) - 1.0   # scale to -1.0 - 1.0 range
+      end
+    elsif args.state.mouse_state == :released
+      args.state.dragging = nil
+    end
+  
+    input_panel args
+  end
+  
+  def defaults args
+    args.state.mouse_state      ||= :released
+    args.state.dragging_source  ||= false
+    args.state.selected         ||= 0
+    args.state.next_sound_index ||= 0
+    args.state.boxsize          ||= 30
+    args.state.sound_files      ||= [
+      { name: :tada,   path: "sounds/tada.wav"   },
+      { name: :splash, path: "sounds/splash.wav" },
+      { name: :drum,   path: "sounds/drum.wav"   },
+      { name: :spring, path: "sounds/spring.wav" },
+      { name: :music,  path: "sounds/music.ogg"  }
+    ]
+  
+    # generate buttons based off the sound collection above
+    args.state.spawn_sound_buttons ||= begin
+      # create a group of buttons
+      # column centered (using col_offset to calculate the column offset)
+      # where each item is 2 columns apart
+      rects = args.layout.rect_group row:   11,
+                                     col_offset: {
+                                       count: args.state.sound_files.length,
+                                       w:     2
+                                     },
+                                     dcol:  2,
+                                     w:     2,
+                                     h:     1,
+                                     group: args.state.sound_files
+  
+      # now that you have the rects
+      # construct the metadata for the buttons
+      rects.map do |rect|
+        {
+          rect: rect,
+          name: rect.name,
+          path: rect.path,
+          primitives: [
+            rect.to_border(r: 255, g: 255, b: 255),
+            rect.to_label(x: rect.center_x,
+                          y: rect.center_y,
+                          text: "#{rect.name}",
+                          alignment_enum: 1,
+                          vertical_alignment_enum: 1,
+                          r: 255, g: 255, b: 255)
+          ]
+        }
+      end
+    end
+  
+    if args.inputs.mouse.up
+      args.state.mouse_state = :released
+      args.state.dragging_source = false
+    elsif args.inputs.mouse.down
+      args.state.mouse_state = :held
+    end
+  
+    args.outputs.background_color = [ 0, 0, 0, 255 ]
+  end
+  
+  def render args
+    render_ui args
+    render_sources args
+  end
+
+#+end_src
+
+*** Advanced Audio - Audio Mixer - server_ip_address.txt
+#+begin_src ruby
+  # ./samples/07_advanced_audio/01_audio_mixer/app/server_ip_address.txt
+  192.168.1.65
+#+end_src
+
+*** Advanced Audio - Audio Mixer - Metadata - ios_metadata.txt
+#+begin_src ruby
+  # ./samples/07_advanced_audio/01_audio_mixer/metadata/ios_metadata.txt
+  # ios_metadata.txt is used by the Pro version of DragonRuby Game Toolkit to create iOS apps.
+  # Information about the Pro version can be found at: http://dragonruby.org/toolkit/game#purchase
+  
+  # teamid needs to be set to your assigned Team Id which can be found at https://developer.apple.com/account/#/membership/
+  teamid=
+  # appid needs to be set to your application identifier which can be found at https://developer.apple.com/account/resources/identifiers/list
+  appid=
+  # appname is the name you want to show up underneath the app icon on the device. Keep it under 10 characters.
+  appname=
+
+#+end_src
+
+*** Advanced Audio - Sound Synthesis - main.rb
+#+begin_src ruby
+  # ./samples/07_advanced_audio/02_sound_synthesis/app/main.rb
+  begin # region: top level tick methods
+    def tick args
+      defaults args
+      render args
+      input args
+      process_audio_queue args
+    end
+  
+    def defaults args
+      args.state.sine_waves      ||= {}
+      args.state.square_waves    ||= {}
+      args.state.saw_tooth_waves ||= {}
+      args.state.triangle_waves  ||= {}
+      args.state.audio_queue     ||= []
+      args.state.buttons         ||= [
+        (frequency_buttons args),
+        (sine_wave_note_buttons args),
+        (bell_buttons args),
+        (square_wave_note_buttons args),
+        (saw_tooth_wave_note_buttons args),
+        (triangle_wave_note_buttons args),
+      ].flatten
+    end
+  
+    def render args
+      args.outputs.borders << args.state.buttons.map { |b| b[:border] }
+      args.outputs.labels  << args.state.buttons.map { |b| b[:label]  }
+      args.outputs.labels  << args.layout
+                                .rect(row: 0, col: 11.5)
+                                .yield_self { |r| r.merge y: r.y + r.h }
+                                .merge(text: "This is a Pro only feature. Click here to watch the YouTube video if you are on the Standard License.",
+                                       alignment_enum: 1)
+    end
+  
+  
+    def input args
+      args.state.buttons.each do |b|
+        if args.inputs.mouse.click && (args.inputs.mouse.click.inside_rect? b[:rect])
+          parameter_string = (b.slice :frequency, :note, :octave).map { |k, v| "#{k}: #{v}" }.join ", "
+          args.gtk.notify! "#{b[:method_to_call]} #{parameter_string}"
+          send b[:method_to_call], args, b
+        end
+      end
+  
+      if args.inputs.mouse.click && (args.inputs.mouse.click.inside_rect? (args.layout.rect(row: 0).yield_self { |r| r.merge y: r.y + r.h.half, h: r.h.half }))
+        args.gtk.openurl 'https://www.youtube.com/watch?v=zEzovM5jT-k&ab_channel=AmirRajan'
+      end
+    end
+  
+    def process_audio_queue args
+      to_queue = args.state.audio_queue.find_all { |v| v[:queue_at] <= args.tick_count }
+      args.state.audio_queue -= to_queue
+      to_queue.each { |a| args.audio[a[:id]] = a }
+  
+      args.audio.find_all { |k, v| v[:decay_rate] }
+        .each     { |k, v| v[:gain] -= v[:decay_rate] }
+  
+      sounds_to_stop = args.audio
+                         .find_all { |k, v| v[:stop_at] && args.state.tick_count >= v[:stop_at] }
+                         .map { |k, v| k }
+  
+      sounds_to_stop.each { |k| args.audio.delete k }
+    end
+  end
+  
+  begin # region: button definitions, ui layout, callback functions
+    def button args, opts
+      button_def = opts.merge rect: (args.layout.rect (opts.merge w: 2, h: 1))
+  
+      button_def[:border] = button_def[:rect].merge r: 0, g: 0, b: 0
+  
+      label_offset_x = 5
+      label_offset_y = 30
+  
+      button_def[:label]  = button_def[:rect].merge text: opts[:text],
+                                                    size_enum: -2.5,
+                                                    x: button_def[:rect].x + label_offset_x,
+                                                    y: button_def[:rect].y + label_offset_y
+  
+      button_def
+    end
+  
+    def play_sine_wave args, sender
+      queue_sine_wave args,
+                      frequency: sender[:frequency],
+                      duration: 1.seconds,
+                      fade_out: true
+    end
+  
+    def play_note args, sender
+      method_to_call = :queue_sine_wave
+      method_to_call = :queue_square_wave    if sender[:type] == :square
+      method_to_call = :queue_saw_tooth_wave if sender[:type] == :saw_tooth
+      method_to_call = :queue_triangle_wave  if sender[:type] == :triangle
+      method_to_call = :queue_bell           if sender[:type] == :bell
+  
+      send method_to_call, args,
+           frequency: (frequency_for note: sender[:note], octave: sender[:octave]),
+           duration: 1.seconds,
+           fade_out: true
+    end
+  
+    def frequency_buttons args
+      [
+        (button args,
+                row: 4.0, col: 0, text: "300hz",
+                frequency: 300,
+                method_to_call: :play_sine_wave),
+        (button args,
+                row: 5.0, col: 0, text: "400hz",
+                frequency: 400,
+                method_to_call: :play_sine_wave),
+        (button args,
+                row: 6.0, col: 0, text: "500hz",
+                frequency: 500,
+                method_to_call: :play_sine_wave),
+      ]
+    end
+  
+    def sine_wave_note_buttons args
+      [
+        (button args,
+                row: 1.5, col: 2, text: "Sine C4",
+                note: :c, octave: 4, type: :sine, method_to_call: :play_note),
+        (button args,
+                row: 2.5, col: 2, text: "Sine D4",
+                note: :d, octave: 4, type: :sine, method_to_call: :play_note),
+        (button args,
+                row: 3.5, col: 2, text: "Sine E4",
+                note: :e, octave: 4, type: :sine, method_to_call: :play_note),
+        (button args,
+                row: 4.5, col: 2, text: "Sine F4",
+                note: :f, octave: 4, type: :sine, method_to_call: :play_note),
+        (button args,
+                row: 5.5, col: 2, text: "Sine G4",
+                note: :g, octave: 4, type: :sine, method_to_call: :play_note),
+        (button args,
+                row: 6.5, col: 2, text: "Sine A5",
+                note: :a, octave: 5, type: :sine, method_to_call: :play_note),
+        (button args,
+                row: 7.5, col: 2, text: "Sine B5",
+                note: :b, octave: 5, type: :sine, method_to_call: :play_note),
+        (button args,
+                row: 8.5, col: 2, text: "Sine C5",
+                note: :c, octave: 5, type: :sine, method_to_call: :play_note),
+      ]
+    end
+  
+    def square_wave_note_buttons args
+      [
+        (button args,
+                row: 1.5, col: 6, text: "Square C4",
+                note: :c, octave: 4, type: :square, method_to_call: :play_note),
+        (button args,
+                row: 2.5, col: 6, text: "Square D4",
+                note: :d, octave: 4, type: :square, method_to_call: :play_note),
+        (button args,
+                row: 3.5, col: 6, text: "Square E4",
+                note: :e, octave: 4, type: :square, method_to_call: :play_note),
+        (button args,
+                row: 4.5, col: 6, text: "Square F4",
+                note: :f, octave: 4, type: :square, method_to_call: :play_note),
+        (button args,
+                row: 5.5, col: 6, text: "Square G4",
+                note: :g, octave: 4, type: :square, method_to_call: :play_note),
+        (button args,
+                row: 6.5, col: 6, text: "Square A5",
+                note: :a, octave: 5, type: :square, method_to_call: :play_note),
+        (button args,
+                row: 7.5, col: 6, text: "Square B5",
+                note: :b, octave: 5, type: :square, method_to_call: :play_note),
+        (button args,
+                row: 8.5, col: 6, text: "Square C5",
+                note: :c, octave: 5, type: :square, method_to_call: :play_note),
+      ]
+    end
+    def saw_tooth_wave_note_buttons args
+      [
+        (button args,
+                row: 1.5, col: 8, text: "Saw C4",
+                note: :c, octave: 4, type: :saw_tooth, method_to_call: :play_note),
+        (button args,
+                row: 2.5, col: 8, text: "Saw D4",
+                note: :d, octave: 4, type: :saw_tooth, method_to_call: :play_note),
+        (button args,
+                row: 3.5, col: 8, text: "Saw E4",
+                note: :e, octave: 4, type: :saw_tooth, method_to_call: :play_note),
+        (button args,
+                row: 4.5, col: 8, text: "Saw F4",
+                note: :f, octave: 4, type: :saw_tooth, method_to_call: :play_note),
+        (button args,
+                row: 5.5, col: 8, text: "Saw G4",
+                note: :g, octave: 4, type: :saw_tooth, method_to_call: :play_note),
+        (button args,
+                row: 6.5, col: 8, text: "Saw A5",
+                note: :a, octave: 5, type: :saw_tooth, method_to_call: :play_note),
+        (button args,
+                row: 7.5, col: 8, text: "Saw B5",
+                note: :b, octave: 5, type: :saw_tooth, method_to_call: :play_note),
+        (button args,
+                row: 8.5, col: 8, text: "Saw C5",
+                note: :c, octave: 5, type: :saw_tooth, method_to_call: :play_note),
+      ]
+    end
+  
+    def triangle_wave_note_buttons args
+      [
+        (button args,
+                row: 1.5, col: 10, text: "Triangle C4",
+                note: :c, octave: 4, type: :triangle, method_to_call: :play_note),
+        (button args,
+                row: 2.5, col: 10, text: "Triangle D4",
+                note: :d, octave: 4, type: :triangle, method_to_call: :play_note),
+        (button args,
+                row: 3.5, col: 10, text: "Triangle E4",
+                note: :e, octave: 4, type: :triangle, method_to_call: :play_note),
+        (button args,
+                row: 4.5, col: 10, text: "Triangle F4",
+                note: :f, octave: 4, type: :triangle, method_to_call: :play_note),
+        (button args,
+                row: 5.5, col: 10, text: "Triangle G4",
+                note: :g, octave: 4, type: :triangle, method_to_call: :play_note),
+        (button args,
+                row: 6.5, col: 10, text: "Triangle A5",
+                note: :a, octave: 5, type: :triangle, method_to_call: :play_note),
+        (button args,
+                row: 7.5, col: 10, text: "Triangle B5",
+                note: :b, octave: 5, type: :triangle, method_to_call: :play_note),
+        (button args,
+                row: 8.5, col: 10, text: "Triangle C5",
+                note: :c, octave: 5, type: :triangle, method_to_call: :play_note),
+      ]
+    end
+  
+    def bell_buttons args
+      [
+        (button args,
+                row: 1.5, col: 4, text: "Bell C4",
+                note: :c, octave: 4, type: :bell, method_to_call: :play_note),
+        (button args,
+                row: 2.5, col: 4, text: "Bell D4",
+                note: :d, octave: 4, type: :bell, method_to_call: :play_note),
+        (button args,
+                row: 3.5, col: 4, text: "Bell E4",
+                note: :e, octave: 4, type: :bell, method_to_call: :play_note),
+        (button args,
+                row: 4.5, col: 4, text: "Bell F4",
+                note: :f, octave: 4, type: :bell, method_to_call: :play_note),
+        (button args,
+                row: 5.5, col: 4, text: "Bell G4",
+                note: :g, octave: 4, type: :bell, method_to_call: :play_note),
+        (button args,
+                row: 6.5, col: 4, text: "Bell A5",
+                note: :a, octave: 5, type: :bell, method_to_call: :play_note),
+        (button args,
+                row: 7.5, col: 4, text: "Bell B5",
+                note: :b, octave: 5, type: :bell, method_to_call: :play_note),
+        (button args,
+                row: 8.5, col: 4, text: "Bell C5",
+                note: :c, octave: 5, type: :bell, method_to_call: :play_note),
+      ]
+    end
+  end
+  
+  begin # region: wave generation
+    begin # sine wave
+      def defaults_sine_wave_for
+        { frequency: 440, sample_rate: 48000 }
+      end
+  
+      def sine_wave_for opts = {}
+        opts = defaults_sine_wave_for.merge opts
+        frequency   = opts[:frequency]
+        sample_rate = opts[:sample_rate]
+        period_size = (sample_rate.fdiv frequency).ceil
+        period_size.map_with_index do |i|
+          Math::sin((2.0 * Math::PI) / (sample_rate.to_f / frequency.to_f) * i)
+        end.to_a
+      end
+  
+      def defaults_queue_sine_wave
+        { frequency: 440, duration: 60, gain: 1.0, fade_out: false, queue_in: 0 }
+      end
+  
+      def queue_sine_wave args, opts = {}
+        opts        = defaults_queue_sine_wave.merge opts
+        frequency   = opts[:frequency]
+        sample_rate = 48000
+  
+        sine_wave = sine_wave_for frequency: frequency, sample_rate: sample_rate
+        args.state.sine_waves[frequency] ||= sine_wave_for frequency: frequency, sample_rate: sample_rate
+  
+        proc = lambda do
+          generate_audio_data args.state.sine_waves[frequency], sample_rate
+        end
+  
+        audio_state = new_audio_state args, opts
+        audio_state[:input] = [1, sample_rate, proc]
+        queue_audio args, audio_state: audio_state, wave: sine_wave
+      end
+    end
+  
+    begin # region: square wave
+      def defaults_square_wave_for
+        { frequency: 440, sample_rate: 48000 }
+      end
+  
+      def square_wave_for opts = {}
+        opts = defaults_square_wave_for.merge opts
+        sine_wave = sine_wave_for opts
+        sine_wave.map do |v|
+          if v >= 0
+            1.0
+          else
+            -1.0
+          end
+        end.to_a
+      end
+  
+      def defaults_queue_square_wave
+        { frequency: 440, duration: 60, gain: 0.3, fade_out: false, queue_in: 0 }
+      end
+  
+      def queue_square_wave args, opts = {}
+        opts        = defaults_queue_square_wave.merge opts
+        frequency   = opts[:frequency]
+        sample_rate = 48000
+  
+        square_wave = square_wave_for frequency: frequency, sample_rate: sample_rate
+        args.state.square_waves[frequency] ||= square_wave_for frequency: frequency, sample_rate: sample_rate
+  
+        proc = lambda do
+          generate_audio_data args.state.square_waves[frequency], sample_rate
+        end
+  
+        audio_state = new_audio_state args, opts
+        audio_state[:input] = [1, sample_rate, proc]
+        queue_audio args, audio_state: audio_state, wave: square_wave
+      end
+    end
+  
+    begin # region: saw tooth wave
+      def defaults_saw_tooth_wave_for
+        { frequency: 440, sample_rate: 48000 }
+      end
+  
+      def saw_tooth_wave_for opts = {}
+        opts = defaults_saw_tooth_wave_for.merge opts
+        sine_wave = sine_wave_for opts
+        period_size = sine_wave.length
+        sine_wave.map_with_index do |v, i|
+          (((i % period_size).fdiv period_size) * 2) - 1
+        end
+      end
+  
+      def defaults_queue_saw_tooth_wave
+        { frequency: 440, duration: 60, gain: 0.3, fade_out: false, queue_in: 0 }
+      end
+  
+      def queue_saw_tooth_wave args, opts = {}
+        opts        = defaults_queue_saw_tooth_wave.merge opts
+        frequency   = opts[:frequency]
+        sample_rate = 48000
+  
+        saw_tooth_wave = saw_tooth_wave_for frequency: frequency, sample_rate: sample_rate
+        args.state.saw_tooth_waves[frequency] ||= saw_tooth_wave_for frequency: frequency, sample_rate: sample_rate
+  
+        proc = lambda do
+          generate_audio_data args.state.saw_tooth_waves[frequency], sample_rate
+        end
+  
+        audio_state = new_audio_state args, opts
+        audio_state[:input] = [1, sample_rate, proc]
+        queue_audio args, audio_state: audio_state, wave: saw_tooth_wave
+      end
+    end
+  
+    begin # region: triangle wave
+      def defaults_triangle_wave_for
+        { frequency: 440, sample_rate: 48000 }
+      end
+  
+      def triangle_wave_for opts = {}
+        opts = defaults_saw_tooth_wave_for.merge opts
+        sine_wave = sine_wave_for opts
+        period_size = sine_wave.length
+        sine_wave.map_with_index do |v, i|
+          ratio = (i.fdiv period_size)
+          if ratio <= 0.5
+            (ratio * 4) - 1
+          else
+            ratio -= 0.5
+            1 - (ratio * 4)
+          end
+        end
+      end
+  
+      def defaults_queue_triangle_wave
+        { frequency: 440, duration: 60, gain: 1.0, fade_out: false, queue_in: 0 }
+      end
+  
+      def queue_triangle_wave args, opts = {}
+        opts        = defaults_queue_triangle_wave.merge opts
+        frequency   = opts[:frequency]
+        sample_rate = 48000
+  
+        triangle_wave = triangle_wave_for frequency: frequency, sample_rate: sample_rate
+        args.state.triangle_waves[frequency] ||= triangle_wave_for frequency: frequency, sample_rate: sample_rate
+  
+        proc = lambda do
+          generate_audio_data args.state.triangle_waves[frequency], sample_rate
+        end
+  
+        audio_state = new_audio_state args, opts
+        audio_state[:input] = [1, sample_rate, proc]
+        queue_audio args, audio_state: audio_state, wave: triangle_wave
+      end
+    end
+  
+    begin # region: bell
+      def defaults_queue_bell
+        { frequency: 440, duration: 1.seconds, queue_in: 0 }
+      end
+  
+      def queue_bell args, opts = {}
+        (bell_to_sine_waves (defaults_queue_bell.merge opts)).each { |b| queue_sine_wave args, b }
+      end
+  
+      def bell_harmonics
+        [
+          { frequency_ratio: 0.5, duration_ratio: 1.00 },
+          { frequency_ratio: 1.0, duration_ratio: 0.80 },
+          { frequency_ratio: 2.0, duration_ratio: 0.60 },
+          { frequency_ratio: 3.0, duration_ratio: 0.40 },
+          { frequency_ratio: 4.2, duration_ratio: 0.25 },
+          { frequency_ratio: 5.4, duration_ratio: 0.20 },
+          { frequency_ratio: 6.8, duration_ratio: 0.15 }
+        ]
+      end
+  
+      def defaults_bell_to_sine_waves
+        { frequency: 440, duration: 1.seconds, queue_in: 0 }
+      end
+  
+      def bell_to_sine_waves opts = {}
+        opts = defaults_bell_to_sine_waves.merge opts
+        bell_harmonics.map do |b|
+          {
+            frequency: opts[:frequency] * b[:frequency_ratio],
+            duration:  opts[:duration] * b[:duration_ratio],
+            queue_in:  opts[:queue_in],
+            gain:      (1.fdiv bell_harmonics.length),
+            fade_out:  true
+          }
+        end
+      end
+    end
+  
+    begin # audio entity construction
+      def generate_audio_data sine_wave, sample_rate
+        sample_size = (sample_rate.fdiv (1000.fdiv 60)).ceil
+        copy_count  = (sample_size.fdiv sine_wave.length).ceil
+        sine_wave * copy_count
+      end
+  
+      def defaults_new_audio_state
+        { frequency: 440, duration: 60, gain: 1.0, fade_out: false, queue_in: 0 }
+      end
+  
+      def new_audio_state args, opts = {}
+        opts        = defaults_new_audio_state.merge opts
+        decay_rate  = 0
+        decay_rate  = 1.fdiv(opts[:duration]) * opts[:gain] if opts[:fade_out]
+        frequency   = opts[:frequency]
+        sample_rate = 48000
+  
+        {
+          id:               (new_id! args),
+          frequency:        frequency,
+          sample_rate:      48000,
+          stop_at:          args.tick_count + opts[:queue_in] + opts[:duration],
+          gain:             opts[:gain].to_f,
+          queue_at:         args.state.tick_count + opts[:queue_in],
+          decay_rate:       decay_rate,
+          pitch:            1.0,
+          looping:          true,
+          paused:           false
+        }
+      end
+  
+      def queue_audio args, opts = {}
+        graph_wave args, opts[:wave], opts[:audio_state][:frequency]
+        args.state.audio_queue << opts[:audio_state]
+      end
+  
+      def new_id! args
+        args.state.audio_id ||= 0
+        args.state.audio_id  += 1
+      end
+  
+      def graph_wave args, wave, frequency
+        if args.state.tick_count != args.state.graphed_at
+          args.outputs.static_lines.clear
+          args.outputs.static_sprites.clear
+        end
+  
+        wave = wave
+  
+        r, g, b = frequency.to_i % 85,
+                  frequency.to_i % 170,
+                  frequency.to_i % 255
+  
+        starting_rect = args.layout.rect(row: 5, col: 13)
+        x_scale    = 10
+        y_scale    = 100
+        max_points = 25
+  
+        points = wave
+        if wave.length > max_points
+          resolution = wave.length.idiv max_points
+          points = wave.find_all.with_index { |y, i| (i % resolution == 0) }
+        end
+  
+        args.outputs.static_lines << points.map_with_index do |y, x|
+          next_y = points[x + 1]
+  
+          if next_y
+            {
+              x:  starting_rect.x + (x * x_scale),
+              y:  starting_rect.y + starting_rect.h.half + y_scale * y,
+              x2: starting_rect.x + ((x + 1) * x_scale),
+              y2: starting_rect.y + starting_rect.h.half + y_scale * next_y,
+              r:  r,
+              g:  g,
+              b:  b
+            }
+          end
+        end
+  
+        args.outputs.static_sprites << points.map_with_index do |y, x|
+          {
+            x:  (starting_rect.x + (x * x_scale)) - 2,
+            y:  (starting_rect.y + starting_rect.h.half + y_scale * y) - 2,
+            w:  4,
+            h:  4,
+            path: 'sprites/square-white.png',
+            r: r,
+            g: g,
+            b: b
+          }
+        end
+  
+        args.state.graphed_at = args.state.tick_count
+      end
+    end
+  
+    begin # region: musical note mapping
+      def defaults_frequency_for
+        { note: :a, octave: 5, sharp:  false, flat:   false }
+      end
+  
+      def frequency_for opts = {}
+        opts = defaults_frequency_for.merge opts
+        octave_offset_multiplier  = opts[:octave] - 5
+        note = note_frequencies_octave_5[opts[:note]]
+        if octave_offset_multiplier < 0
+          note = note * 1 / (octave_offset_multiplier.abs + 1)
+        elsif octave_offset_multiplier > 0
+          note = note * (octave_offset_multiplier.abs + 1) / 1
+        end
+        note
+      end
+  
+      def note_frequencies_octave_5
+        {
+          a: 440.0,
+          a_sharp: 466.16, b_flat: 466.16,
+          b: 493.88,
+          c: 523.25,
+          c_sharp: 554.37, d_flat: 587.33,
+          d: 587.33,
+          d_sharp: 622.25, e_flat: 659.25,
+          e: 659.25,
+          f: 698.25,
+          f_sharp: 739.99, g_flat: 739.99,
+          g: 783.99,
+          g_sharp: 830.61, a_flat: 830.61
+        }
+      end
+    end
+  end
+  
+  $gtk.reset
+
+#+end_src
+
 *** Advanced Rendering - Simple Render Targets - main.rb
 #+begin_src ruby
   # ./samples/07_advanced_rendering/01_simple_render_targets/app/main.rb
@@ -12602,7 +12985,7 @@ Follows is a source code listing for all files that have been open sourced. This
       flip_horizontally: false,
       angle_anchor_x: 0.5,            # rotation center set to middle
       angle_anchor_y: 0.5
-    }.sprite
+    }.sprite!
   
     # Outputs label as primitive using a hash
     args.outputs.primitives << {
@@ -12616,7 +12999,7 @@ Follows is a source code listing for all files that have been open sourced. This
       b:         50,
       a:         255,                 # transparency
       font:      "fonts/manaspc.ttf"  # font style
-    }.label
+    }.label!
   
     # Outputs solid as primitive using a hash
     args.outputs.primitives << {
@@ -12628,7 +13011,7 @@ Follows is a source code listing for all files that have been open sourced. This
       g:  50,
       b:  50,
       a: 255                          # transparency
-    }.solid
+    }.solid!
   
     # Outputs border as primitive using a hash
     # Same parameters as solid
@@ -12641,7 +13024,7 @@ Follows is a source code listing for all files that have been open sourced. This
       g:  50,
       b:  50,
       a: 255                          # transparency
-    }.border
+    }.border!
   
     # Outputs line as primitive using a hash
     args.outputs.primitives << {
@@ -12653,7 +13036,7 @@ Follows is a source code listing for all files that have been open sourced. This
       g:   50,
       b:   50,
       a:  255                         # transparency
-    }.line
+    }.line!
   end
 
 #+end_src
@@ -12705,9 +13088,108 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
+*** Advanced Rendering - Simple Camera - main.rb
+#+begin_src ruby
+  # ./samples/07_advanced_rendering/07_simple_camera/app/main.rb
+  def tick args
+    # variables you can play around with
+    args.state.world.w      ||= 1280
+    args.state.world.h      ||= 720
+  
+    args.state.player.x     ||= 0
+    args.state.player.y     ||= 0
+    args.state.player.size  ||= 32
+  
+    args.state.enemy.x      ||= 700
+    args.state.enemy.y      ||= 700
+    args.state.enemy.size   ||= 16
+  
+    args.state.camera.x                ||= 640
+    args.state.camera.y                ||= 300
+    args.state.camera.scale            ||= 1.0
+    args.state.camera.show_empty_space ||= :yes
+  
+    # instructions
+    args.outputs.primitives << { x: 0, y:  80.from_top, w: 360, h: 80, r: 0, g: 0, b: 0, a: 128 }.solid!
+    args.outputs.primitives << { x: 10, y: 10.from_top, text: "arrow keys to move around", r: 255, g: 255, b: 255}.label!
+    args.outputs.primitives << { x: 10, y: 30.from_top, text: "+/- to change zoom of camera", r: 255, g: 255, b: 255}.label!
+    args.outputs.primitives << { x: 10, y: 50.from_top, text: "tab to change camera edge behavior", r: 255, g: 255, b: 255}.label!
+  
+    # render scene
+    args.outputs[:scene].w = args.state.world.w
+    args.outputs[:scene].h = args.state.world.h
+  
+    args.outputs[:scene].solids << { x: 0, y: 0, w: args.state.world.w, h: args.state.world.h, r: 20, g: 60, b: 80 }
+    args.outputs[:scene].solids << { x: args.state.player.x, y: args.state.player.y,
+                                     w: args.state.player.size, h: args.state.player.size, r: 80, g: 155, b: 80 }
+    args.outputs[:scene].solids << { x: args.state.enemy.x, y: args.state.enemy.y,
+                                     w: args.state.enemy.size, h: args.state.enemy.size, r: 155, g: 80, b: 80 }
+  
+    # render camera
+    scene_position = calc_scene_position args
+    args.outputs.sprites << { x: scene_position.x,
+                              y: scene_position.y,
+                              w: scene_position.w,
+                              h: scene_position.h,
+                              path: :scene }
+  
+    # move player
+    if args.inputs.directional_angle
+      args.state.player.x += args.inputs.directional_angle.vector_x * 5
+      args.state.player.y += args.inputs.directional_angle.vector_y * 5
+      args.state.player.x  = args.state.player.x.clamp(0, args.state.world.w - args.state.player.size)
+      args.state.player.y  = args.state.player.y.clamp(0, args.state.world.h - args.state.player.size)
+    end
+  
+    # +/- to zoom in and out
+    if args.inputs.keyboard.plus && args.state.tick_count.zmod?(3)
+      args.state.camera.scale += 0.05
+    elsif args.inputs.keyboard.hyphen && args.state.tick_count.zmod?(3)
+      args.state.camera.scale -= 0.05
+    elsif args.inputs.keyboard.key_down.tab
+      if args.state.camera.show_empty_space == :yes
+        args.state.camera.show_empty_space = :no
+      else
+        args.state.camera.show_empty_space = :yes
+      end
+    end
+  
+    args.state.camera.scale = args.state.camera.scale.greater(0.1)
+  end
+  
+  def calc_scene_position args
+    result = { x: args.state.camera.x - (args.state.player.x * args.state.camera.scale),
+               y: args.state.camera.y - (args.state.player.y * args.state.camera.scale),
+               w: args.state.world.w * args.state.camera.scale,
+               h: args.state.world.h * args.state.camera.scale,
+               scale: args.state.camera.scale }
+  
+    return result if args.state.camera.show_empty_space == :yes
+  
+    if result.w < args.grid.w
+      result.merge!(x: (args.grid.w - result.w).half)
+    elsif (args.state.player.x * result.scale) < args.grid.w.half
+      result.merge!(x: 10)
+    elsif (result.x + result.w) < args.grid.w
+      result.merge!(x: - result.w + (args.grid.w - 10))
+    end
+  
+    if result.h < args.grid.h
+      result.merge!(y: (args.grid.h - result.h).half)
+    elsif (result.y) > 10
+      result.merge!(y: 10)
+    elsif (result.y + result.h) < args.grid.h
+      result.merge!(y: - result.h + (args.grid.h - 10))
+    end
+  
+    result
+  end
+
+#+end_src
+
 *** Advanced Rendering - Splitscreen Camera - main.rb
 #+begin_src ruby
-  # ./samples/07_advanced_rendering/07_splitscreen_camera/app/main.rb
+  # ./samples/07_advanced_rendering/08_splitscreen_camera/app/main.rb
   class CameraMovement
     attr_accessor :state, :inputs, :outputs, :grid
   
@@ -13108,7 +13590,7 @@ Follows is a source code listing for all files that have been open sourced. This
 
 *** Advanced Rendering - Z Targeting Camera - main.rb
 #+begin_src ruby
-  # ./samples/07_advanced_rendering/08_z_targeting_camera/app/main.rb
+  # ./samples/07_advanced_rendering/09_z_targeting_camera/app/main.rb
   class Game
     attr_gtk
   
@@ -13218,6 +13700,61 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
+*** Advanced Rendering - Blend Modes - main.rb
+#+begin_src ruby
+  # ./samples/07_advanced_rendering/10_blend_modes/app/main.rb
+  $gtk.reset
+  
+  def draw_blendmode args, mode
+    w = 160
+    h = w
+    args.state.x += (1280-w) / (args.state.blendmodes.length + 1)
+    x = args.state.x
+    y = (720 - h) / 2
+    s = 'sprites/blue-feathered.png'
+    args.outputs.sprites << { blendmode_enum: mode.value, x: x, y: y, w: w, h: h, path: s }
+    args.outputs.labels << [x + (w/2), y, mode.name.to_s, 1, 1, 255, 255, 255]
+  end
+  
+  def tick args
+  
+    # Different blend modes do different things, depending on what they
+    # blend against (in this case, the pixels of the background color).
+    args.state.bg_element ||= 1
+    args.state.bg_color ||= 255
+    args.state.bg_color_direction ||= 1
+    bg_r = (args.state.bg_element == 1) ? args.state.bg_color : 0
+    bg_g = (args.state.bg_element == 2) ? args.state.bg_color : 0
+    bg_b = (args.state.bg_element == 3) ? args.state.bg_color : 0
+    args.state.bg_color += args.state.bg_color_direction
+    if (args.state.bg_color_direction > 0) && (args.state.bg_color >= 255)
+      args.state.bg_color_direction = -1
+      args.state.bg_color = 255
+    elsif (args.state.bg_color_direction < 0) && (args.state.bg_color <= 0)
+      args.state.bg_color_direction = 1
+      args.state.bg_color = 0
+      args.state.bg_element += 1
+      if args.state.bg_element >= 4
+        args.state.bg_element = 1
+      end
+    end
+  
+    args.outputs.background_color = [ bg_r, bg_g, bg_b, 255 ]
+  
+    args.state.blendmodes ||= [
+      { name: :none,  value: 0 },
+      { name: :blend, value: 1 },
+      { name: :add,   value: 2 },
+      { name: :mod,   value: 3 },
+      { name: :mul,   value: 4 }
+    ]
+  
+    args.state.x = 0  # reset this, draw_blendmode will increment it.
+    args.state.blendmodes.each { |blendmode| draw_blendmode args, blendmode }
+  end
+
+#+end_src
+
 *** Tweening Lerping Easing Functions - Easing Functions - main.rb
 #+begin_src ruby
   # ./samples/08_tweening_lerping_easing_functions/01_easing_functions/app/main.rb
@@ -13710,7 +14247,11 @@ Follows is a source code listing for all files that have been open sourced. This
   
     # sets console command when sample app initially opens
     if Kernel.global_tick_count == 0
-      puts "* INFO - Please specify the number of sprites to render."
+      puts ""
+      puts ""
+      puts "========================================================="
+      puts "* INFO: Sprites, Hashes"
+      puts "* INFO: Please specify the number of sprites to render."
       args.gtk.console.set_command "reset_with count: 100"
     end
   
@@ -13780,7 +14321,11 @@ Follows is a source code listing for all files that have been open sourced. This
   
     # sets console command when sample app initially opens
     if Kernel.global_tick_count == 0
-      puts "* INFO - Please specify the number of sprites to render."
+      puts ""
+      puts ""
+      puts "========================================================="
+      puts "* INFO: Sprites, Open Entities"
+      puts "* INFO: Please specify the number of sprites to render."
       args.gtk.console.set_command "reset_with count: 100"
     end
   
@@ -13854,7 +14399,11 @@ Follows is a source code listing for all files that have been open sourced. This
   
     # sets console command when sample app initially opens
     if Kernel.global_tick_count == 0
-      puts "* INFO - Please specify the number of sprites to render."
+      puts ""
+      puts ""
+      puts "========================================================="
+      puts "* INFO: Sprites, Strict Entities"
+      puts "* INFO: Please specify the number of sprites to render."
       args.gtk.console.set_command "reset_with count: 100"
     end
   
@@ -13911,6 +14460,11 @@ Follows is a source code listing for all files that have been open sourced. This
   def tick args
     # sets console command when sample app initially opens
     if Kernel.global_tick_count == 0
+      puts ""
+      puts ""
+      puts "========================================================="
+      puts "* INFO: Sprites, Classes"
+      puts "* INFO: Please specify the number of sprites to render."
       args.gtk.console.set_command "reset_with count: 100"
     end
   
@@ -13968,19 +14522,24 @@ Follows is a source code listing for all files that have been open sourced. This
   def tick args
     # sets console command when sample app initially opens
     if Kernel.global_tick_count == 0
+      puts ""
+      puts ""
+      puts "========================================================="
+      puts "* INFO: Static Sprites, Classes"
+      puts "* INFO: Please specify the number of sprites to render."
       args.gtk.console.set_command "reset_with count: 100"
     end
   
     # init
     if args.state.tick_count == 0
       args.state.stars = args.state.star_count.map { |i| Star.new args.grid }
+      args.outputs.static_sprites << args.state.stars
     end
   
     # update
     args.state.stars.each(&:move)
   
     # render
-    args.outputs.sprites << args.state.stars
     args.outputs.background_color = [0, 0, 0]
     args.outputs.primitives << args.gtk.current_framerate_primitives
   end
@@ -14038,10 +14597,21 @@ Follows is a source code listing for all files that have been open sourced. This
       # path,
       # angle,
       # alpha, red_saturation, green_saturation, blue_saturation
+      # tile_x, tile_y, tile_w, tile_h,
       # flip_horizontally, flip_vertically,
-      # tile_x, tile_y, tile_w, tile_h
       # angle_anchor_x, angle_anchor_y,
       # source_x, source_y, source_w, source_h
+  
+      # The argument order for ffi_draw.draw_sprite_4 is:
+      # x, y, w, h,
+      # path,
+      # angle,
+      # alpha, red_saturation, green_saturation, blue_saturation
+      # tile_x, tile_y, tile_w, tile_h,
+      # flip_horizontally, flip_vertically,
+      # angle_anchor_x, angle_anchor_y,
+      # source_x, source_y, source_w, source_h,
+      # blendmode_enum
     end
   end
   
@@ -14049,6 +14619,11 @@ Follows is a source code listing for all files that have been open sourced. This
   def tick args
     # sets console command when sample app initially opens
     if Kernel.global_tick_count == 0
+      puts ""
+      puts ""
+      puts "========================================================="
+      puts "* INFO: Static Sprites, Classes, Draw Override"
+      puts "* INFO: Please specify the number of sprites to render."
       args.gtk.console.set_command "reset_with count: 100"
     end
   
@@ -14219,6 +14794,55 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
+*** Advanced Debugging - Unit Tests - benchmark_api_tests.rb
+#+begin_src ruby
+  # ./samples/10_advanced_debugging/03_unit_tests/benchmark_api_tests.rb
+  def test_benchmark_api args, assert
+    result = args.gtk.benchmark iterations: 100,
+                                only_one: -> () {
+                                  r = 0
+                                  (1..100).each do |i|
+                                    r += 1
+                                  end
+                                }
+  
+    assert.equal! result.first_place.name, :only_one
+  
+    result = args.gtk.benchmark iterations: 100,
+                                iterations_100: -> () {
+                                  r = 0
+                                  (1..100).each do |i|
+                                    r += 1
+                                  end
+                                },
+                                iterations_50: -> () {
+                                  r = 0
+                                  (1..50).each do |i|
+                                    r += 1
+                                  end
+                                }
+  
+    assert.equal! result.first_place.name, :iterations_50
+  
+    result = args.gtk.benchmark iterations: 1,
+                                iterations_100: -> () {
+                                  r = 0
+                                  (1..100).each do |i|
+                                    r += 1
+                                  end
+                                },
+                                iterations_50: -> () {
+                                  r = 0
+                                  (1..50).each do |i|
+                                    r += 1
+                                  end
+                                }
+  
+    assert.equal! result.too_small_to_measure, true
+  end
+
+#+end_src
+
 *** Advanced Debugging - Unit Tests - exception_raising_tests.rb
 #+begin_src ruby
   # ./samples/10_advanced_debugging/03_unit_tests/exception_raising_tests.rb
@@ -14739,6 +15363,142 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
+*** Advanced Debugging - Unit Tests - pretty_format_tests.rb
+#+begin_src ruby
+  # ./samples/10_advanced_debugging/03_unit_tests/pretty_format_tests.rb
+  def H opts
+    opts
+  end
+  
+  def A *opts
+    opts
+  end
+  
+  def assert_format args, assert, hash, expected
+    actual = args.fn.pretty_format hash
+    assert.are_equal! actual, expected
+  end
+  
+  def test_pretty_print args, assert
+    # =============================
+    # hash with single value
+    # =============================
+    input = (H first_name: "John")
+    expected = <<-S
+  {:first_name "John"}
+  S
+    (assert_format args, assert, input, expected)
+  
+    # =============================
+    # hash with two values
+    # =============================
+    input = (H first_name: "John", last_name: "Smith")
+    expected = <<-S
+  {:first_name "John"
+   :last_name "Smith"}
+  S
+  
+    (assert_format args, assert, input, expected)
+  
+    # =============================
+    # hash with inner hash
+    # =============================
+    input = (H first_name: "John",
+               last_name: "Smith",
+               middle_initial: "I",
+               so: (H first_name: "Pocahontas",
+                      last_name: "Tsenacommacah"),
+               friends: (A (H first_name: "Side", last_name: "Kick"),
+                           (H first_name: "Tim", last_name: "Wizard")))
+    expected = <<-S
+  {:first_name "John"
+   :last_name "Smith"
+   :middle_initial "I"
+   :so {:first_name "Pocahontas"
+        :last_name "Tsenacommacah"}
+   :friends [{:first_name "Side"
+              :last_name "Kick"}
+             {:first_name "Tim"
+              :last_name "Wizard"}]}
+  S
+  
+    (assert_format args, assert, input, expected)
+  
+    # =============================
+    # array with one value
+    # =============================
+    input = (A 1)
+    expected = <<-S
+  [1]
+  S
+    (assert_format args, assert, input, expected)
+  
+    # =============================
+    # array with multiple values
+    # =============================
+    input = (A 1, 2, 3)
+    expected = <<-S
+  [1
+   2
+   3]
+  S
+    (assert_format args, assert, input, expected)
+  
+    # =============================
+    # array with multiple values hashes
+    # =============================
+    input = (A (H first_name: "Side", last_name: "Kick"),
+               (H first_name: "Tim", last_name: "Wizard"))
+    expected = <<-S
+  [{:first_name "Side"
+    :last_name "Kick"}
+   {:first_name "Tim"
+    :last_name "Wizard"}]
+  S
+  
+    (assert_format args, assert, input, expected)
+  end
+  
+  def test_nested_nested args, assert
+    # =============================
+    # nested array in nested hash
+    # =============================
+    input = (H type: :root,
+               text: "Root",
+               children: (A (H level: 1,
+                               text: "Level 1",
+                               children: (A (H level: 2,
+                                               text: "Level 2",
+                                               children: [])))))
+  
+    expected = <<-S
+  {:type :root
+   :text "Root"
+   :children [{:level 1
+               :text "Level 1"
+               :children [{:level 2
+                           :text "Level 2"
+                           :children []}]}]}
+  
+  S
+  
+    (assert_format args, assert, input, expected)
+  end
+  
+  def test_scene args, assert
+    script = <<-S
+  * Scene 1
+  ** Narrator
+  They say happy endings don't exist.
+  ** Narrator
+  They say true love is a lie.
+  S
+    input = parse_org args, script
+    puts (args.fn.pretty_format input)
+  end
+
+#+end_src
+
 *** Advanced Debugging - Unit Tests - require_tests.rb
 #+begin_src ruby
   # ./samples/10_advanced_debugging/03_unit_tests/require_tests.rb
@@ -18624,13 +19384,13 @@ Follows is a source code listing for all files that have been open sourced. This
   
     def tick
       defaults
-      render 
-      input  
+      render
+      input
       # If animation is playing, and max steps have not been reached
       # Move the search a step forward
       if state.play && state.current_step < state.max_steps
         # Variable that tells the program what step to recalculate up to
-        state.current_step += 1 
+        state.current_step += 1
         move_searches_one_step_forward
       end
     end
@@ -18652,7 +19412,7 @@ Follows is a source code listing for all files that have been open sourced. This
       # We store this value, because we want to remember the value even when
       # the user's cursor is no longer over what they're interacting with, but
       # they are still clicking down on the mouse.
-      state.user_input ||= :none 
+      state.user_input ||= :none
   
       # These variables allow the breadth first search to take place
       # Came_from is a hash with a key of a cell and a value of the cell that was expanded from to find the key.
@@ -18677,7 +19437,7 @@ Follows is a source code listing for all files that have been open sourced. This
       # Unless the current step has a value
       unless state.current_step
         # Set the current step to 10
-        state.current_step = 10 
+        state.current_step = 10
         # And calculate the searches up to step 10
         recalculate_searches
       end
@@ -18687,7 +19447,7 @@ Follows is a source code listing for all files that have been open sourced. This
       # This step is roughly the grid's width * height
       # When anim_steps equals max_steps no more calculations will occur
       # and the slider will be at the end
-      state.max_steps = grid.width * grid.height 
+      state.max_steps = grid.width * grid.height
   
       # Whether the animation should play or not
       # If true, every tick moves anim_steps forward one
@@ -18780,7 +19540,7 @@ Follows is a source code listing for all files that have been open sourced. This
       # If the mouse was clicked this tick
       if inputs.mouse.down
         # Determine what the user is editing and appropriately edit the state.user_input variable
-        determine_input          
+        determine_input
       end
   
       # Process user input based on user_input variable and current mouse position
@@ -18793,35 +19553,35 @@ Follows is a source code listing for all files that have been open sourced. This
       if mouse_over_slider?
         state.user_input = :slider
       # If the mouse is over the star in the first grid
-      elsif bfs_mouse_over_star?                 
+      elsif bfs_mouse_over_star?
         # The user is editing the star from the first grid
-        state.user_input = :bfs_star          
+        state.user_input = :bfs_star
       # If the mouse is over the star in the second grid
-      elsif heuristic_mouse_over_star?                 
+      elsif heuristic_mouse_over_star?
         # The user is editing the star from the second grid
-        state.user_input = :heuristic_star          
+        state.user_input = :heuristic_star
       # If the mouse is over the target in the first grid
-      elsif bfs_mouse_over_target?                 
+      elsif bfs_mouse_over_target?
         # The user is editing the target from the first grid
-        state.user_input = :bfs_target          
+        state.user_input = :bfs_target
       # If the mouse is over the target in the second grid
-      elsif heuristic_mouse_over_target?                 
+      elsif heuristic_mouse_over_target?
         # The user is editing the target from the second grid
-        state.user_input = :heuristic_target 
+        state.user_input = :heuristic_target
       # If the mouse is over a wall in the first grid
-      elsif bfs_mouse_over_wall?                 
+      elsif bfs_mouse_over_wall?
         # The user is removing a wall from the first grid
-        state.user_input = :bfs_remove_wall   
+        state.user_input = :bfs_remove_wall
       # If the mouse is over a wall in the second grid
-      elsif heuristic_mouse_over_wall?                 
+      elsif heuristic_mouse_over_wall?
         # The user is removing a wall from the second grid
         state.user_input = :heuristic_remove_wall
       # If the mouse is over the first grid
-      elsif bfs_mouse_over_grid?                 
+      elsif bfs_mouse_over_grid?
         # The user is adding a wall from the first grid
         state.user_input = :bfs_add_wall
       # If the mouse is over the second grid
-      elsif heuristic_mouse_over_grid?                 
+      elsif heuristic_mouse_over_grid?
         # The user is adding a wall from the second grid
         state.user_input = :heuristic_add_wall
       end
@@ -18831,22 +19591,22 @@ Follows is a source code listing for all files that have been open sourced. This
     def process_input
       if state.user_input == :slider
         process_input_slider
-      elsif state.user_input == :bfs_star         
-        process_input_bfs_star                            
+      elsif state.user_input == :bfs_star
+        process_input_bfs_star
       elsif state.user_input == :heuristic_star
-        process_input_heuristic_star                            
-      elsif state.user_input == :bfs_target         
-        process_input_bfs_target                            
-      elsif state.user_input == :heuristic_target         
-        process_input_heuristic_target                            
-      elsif state.user_input == :bfs_remove_wall  
-        process_input_bfs_remove_wall                     
+        process_input_heuristic_star
+      elsif state.user_input == :bfs_target
+        process_input_bfs_target
+      elsif state.user_input == :heuristic_target
+        process_input_heuristic_target
+      elsif state.user_input == :bfs_remove_wall
+        process_input_bfs_remove_wall
       elsif state.user_input == :heuristic_remove_wall
-        process_input_heuristic_remove_wall                     
-      elsif state.user_input == :bfs_add_wall     
-        process_input_bfs_add_wall                        
-      elsif state.user_input == :heuristic_add_wall     
-        process_input_heuristic_add_wall                        
+        process_input_heuristic_remove_wall
+      elsif state.user_input == :bfs_add_wall
+        process_input_bfs_add_wall
+      elsif state.user_input == :heuristic_add_wall
+        process_input_heuristic_add_wall
       end
     end
   
@@ -18923,7 +19683,7 @@ Follows is a source code listing for all files that have been open sourced. This
   
       # The horizontal grid lines
       for y in 0..grid.height
-        outputs.lines << bfs_horizontal_line(y) 
+        outputs.lines << bfs_horizontal_line(y)
       end
     end
   
@@ -18938,10 +19698,10 @@ Follows is a source code listing for all files that have been open sourced. This
   
       # The horizontal grid lines
       for y in 0..grid.height
-        outputs.lines << heuristic_horizontal_line(y) 
+        outputs.lines << heuristic_horizontal_line(y)
       end
     end
-      
+  
     # Returns a vertical line for a column of the first grid
     def bfs_vertical_line column
       bfs_scale_up([column, 0, column, grid.height])
@@ -18976,7 +19736,7 @@ Follows is a source code listing for all files that have been open sourced. This
     def render_bfs_target
       outputs.sprites << [bfs_scale_up(grid.target), 'target.png']
     end
-    
+  
     # Renders the target on the second grid
     def render_heuristic_target
       outputs.sprites << [heuristic_scale_up(grid.target), 'target.png']
@@ -18984,14 +19744,14 @@ Follows is a source code listing for all files that have been open sourced. This
   
     # Renders the walls on the first grid
     def render_bfs_walls
-      grid.walls.each_key do | wall | 
+      grid.walls.each_key do | wall |
         outputs.solids << [bfs_scale_up(wall), wall_color]
       end
     end
   
     # Renders the walls on the second grid
     def render_heuristic_walls
-      grid.walls.each_key do | wall | 
+      grid.walls.each_key do | wall |
         outputs.solids << [heuristic_scale_up(wall), wall_color]
       end
     end
@@ -19012,14 +19772,14 @@ Follows is a source code listing for all files that have been open sourced. This
   
     # Renders the frontier cells on the first grid
     def render_bfs_frontier
-      bfs.frontier.each do | frontier_cell | 
+      bfs.frontier.each do | frontier_cell |
         outputs.solids << [bfs_scale_up(frontier_cell), frontier_color, 200]
       end
     end
   
     # Renders the frontier cells on the second grid
     def render_heuristic_frontier
-      heuristic.frontier.each do | frontier_cell | 
+      heuristic.frontier.each do | frontier_cell |
         outputs.solids << [heuristic_scale_up(frontier_cell), frontier_color, 200]
       end
     end
@@ -19103,14 +19863,14 @@ Follows is a source code listing for all files that have been open sourced. This
     # Checks and handles input for the buttons
     # Called when the mouse is lifted
     def input_buttons
-      input_left_button 
-      input_center_button          
-      input_right_button     
+      input_left_button
+      input_center_button
+      input_right_button
     end
   
     # Checks if the previous step button is clicked
     # If it is, it pauses the animation and moves the search one step backward
-    def input_left_button 
+    def input_left_button
       if left_button_clicked?
         state.play = false
         state.current_step -= 1
@@ -19122,7 +19882,7 @@ Follows is a source code listing for all files that have been open sourced. This
     # Inverses whether the animation is playing or not when clicked
     def input_center_button
       if center_button_clicked? || inputs.keyboard.key_down.space
-        state.play = !state.play         
+        state.play = !state.play
       end
     end
   
@@ -19130,8 +19890,8 @@ Follows is a source code listing for all files that have been open sourced. This
     # If it is, it pauses the animation and moves the search one step forward
     def input_right_button
       if right_button_clicked?
-        state.play = false              
-        state.current_step += 1           
+        state.play = false
+        state.current_step += 1
         move_searches_one_step_forward
       end
     end
@@ -19212,12 +19972,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # on the slider
     # Changes the step of the search to be animated
     def process_input_slider
-      state.play = false 
+      state.play = false
       mouse_x = inputs.mouse.point.x
   
       # Bounds the mouse_x to the closest x value on the slider line
-      mouse_x = slider.x if mouse_x < slider.x 
-      mouse_x = slider.x + slider.w if mouse_x > slider.x + slider.w 
+      mouse_x = slider.x if mouse_x < slider.x
+      mouse_x = slider.x + slider.w if mouse_x > slider.x + slider.w
   
       # Sets the current search step to the one represented by the mouse x value
       # The slider's circle moves due to the render_slider method using anim_steps
@@ -19230,12 +19990,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # Only resets the search if the star changes position
     # Called whenever the user is editing the star (puts mouse down on star)
     def process_input_bfs_star
-      old_star = grid.star.clone 
+      old_star = grid.star.clone
       unless bfs_cell_closest_to_mouse == grid.target
-        grid.star = bfs_cell_closest_to_mouse 
+        grid.star = bfs_cell_closest_to_mouse
       end
-      unless old_star == grid.star 
-        recalculate_searches 
+      unless old_star == grid.star
+        recalculate_searches
       end
     end
   
@@ -19243,12 +20003,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # Only resets the search if the star changes position
     # Called whenever the user is editing the star (puts mouse down on star)
     def process_input_heuristic_star
-      old_star = grid.star.clone 
+      old_star = grid.star.clone
       unless heuristic_cell_closest_to_mouse == grid.target
         grid.star = heuristic_cell_closest_to_mouse
       end
-      unless old_star == grid.star 
-        recalculate_searches 
+      unless old_star == grid.star
+        recalculate_searches
       end
     end
   
@@ -19256,12 +20016,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # Only recalculate_searchess the search if the target changes position
     # Called whenever the user is editing the target (puts mouse down on target)
     def process_input_bfs_target
-      old_target = grid.target.clone 
+      old_target = grid.target.clone
       unless bfs_cell_closest_to_mouse == grid.star
         grid.target = bfs_cell_closest_to_mouse
       end
-      unless old_target == grid.target 
-        recalculate_searches 
+      unless old_target == grid.target
+        recalculate_searches
       end
     end
   
@@ -19269,12 +20029,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # Only recalculate_searchess the search if the target changes position
     # Called whenever the user is editing the target (puts mouse down on target)
     def process_input_heuristic_target
-      old_target = grid.target.clone 
+      old_target = grid.target.clone
       unless heuristic_cell_closest_to_mouse == grid.star
         grid.target = heuristic_cell_closest_to_mouse
       end
-      unless old_target == grid.target 
-        recalculate_searches 
+      unless old_target == grid.target
+        recalculate_searches
       end
     end
   
@@ -19283,10 +20043,10 @@ Follows is a source code listing for all files that have been open sourced. This
       # The mouse needs to be inside the grid, because we only want to remove walls
       # the cursor is directly over
       # Recalculations should only occur when a wall is actually deleted
-      if bfs_mouse_over_grid? 
+      if bfs_mouse_over_grid?
         if grid.walls.has_key?(bfs_cell_closest_to_mouse)
-          grid.walls.delete(bfs_cell_closest_to_mouse) 
-          recalculate_searches 
+          grid.walls.delete(bfs_cell_closest_to_mouse)
+          recalculate_searches
         end
       end
     end
@@ -19296,29 +20056,29 @@ Follows is a source code listing for all files that have been open sourced. This
       # The mouse needs to be inside the grid, because we only want to remove walls
       # the cursor is directly over
       # Recalculations should only occur when a wall is actually deleted
-      if heuristic_mouse_over_grid? 
+      if heuristic_mouse_over_grid?
         if grid.walls.has_key?(heuristic_cell_closest_to_mouse)
-          grid.walls.delete(heuristic_cell_closest_to_mouse) 
-          recalculate_searches 
+          grid.walls.delete(heuristic_cell_closest_to_mouse)
+          recalculate_searches
         end
       end
     end
     # Adds a wall in the first grid in the cell the mouse is over
     def process_input_bfs_add_wall
-      if bfs_mouse_over_grid? 
+      if bfs_mouse_over_grid?
         unless grid.walls.has_key?(bfs_cell_closest_to_mouse)
-          grid.walls[bfs_cell_closest_to_mouse] = true 
-          recalculate_searches 
+          grid.walls[bfs_cell_closest_to_mouse] = true
+          recalculate_searches
         end
       end
     end
   
     # Adds a wall in the second grid in the cell the mouse is over
     def process_input_heuristic_add_wall
-      if heuristic_mouse_over_grid? 
+      if heuristic_mouse_over_grid?
         unless grid.walls.has_key?(heuristic_cell_closest_to_mouse)
-          grid.walls[heuristic_cell_closest_to_mouse] = true 
-          recalculate_searches 
+          grid.walls[heuristic_cell_closest_to_mouse] = true
+          recalculate_searches
         end
       end
     end
@@ -19328,13 +20088,13 @@ Follows is a source code listing for all files that have been open sourced. This
     # Finding the cell closest to the mouse helps with this
     def bfs_cell_closest_to_mouse
       # Closest cell to the mouse in the first grid
-      x = (inputs.mouse.point.x / grid.cell_size).to_i 
-      y = (inputs.mouse.point.y / grid.cell_size).to_i 
+      x = (inputs.mouse.point.x / grid.cell_size).to_i
+      y = (inputs.mouse.point.y / grid.cell_size).to_i
       # Bound x and y to the grid
-      x = grid.width - 1 if x > grid.width - 1 
-      y = grid.height - 1 if y > grid.height - 1 
+      x = grid.width - 1 if x > grid.width - 1
+      y = grid.height - 1 if y > grid.height - 1
       # Return closest cell
-      [x, y] 
+      [x, y]
     end
   
     # When the user grabs the star and puts their cursor to the far right
@@ -19342,17 +20102,17 @@ Follows is a source code listing for all files that have been open sourced. This
     # Finding the cell closest to the mouse in the second grid helps with this
     def heuristic_cell_closest_to_mouse
       # Closest cell grid to the mouse in the second
-      x = (inputs.mouse.point.x / grid.cell_size).to_i 
-      y = (inputs.mouse.point.y / grid.cell_size).to_i 
+      x = (inputs.mouse.point.x / grid.cell_size).to_i
+      y = (inputs.mouse.point.y / grid.cell_size).to_i
       # Translate the cell to the first grid
       x -= grid.width + 1
       # Bound x and y to the first grid
       x = 0 if x < 0
       y = 0 if y < 0
-      x = grid.width - 1 if x > grid.width - 1 
-      y = grid.height - 1 if y > grid.height - 1 
+      x = grid.width - 1 if x > grid.width - 1
+      y = grid.height - 1 if y > grid.height - 1
       # Return closest cell
-      [x, y] 
+      [x, y]
     end
   
     def recalculate_searches
@@ -19377,22 +20137,22 @@ Follows is a source code listing for all files that have been open sourced. This
       return if bfs.came_from.has_key?(grid.target)
   
       # Only runs at the beginning of the search as setup.
-      if bfs.came_from.empty?  
-        bfs.frontier << grid.star                   
-        bfs.came_from[grid.star] = nil              
+      if bfs.came_from.empty?
+        bfs.frontier << grid.star
+        bfs.came_from[grid.star] = nil
       end
   
       # A step in the search
-      unless bfs.frontier.empty? 
+      unless bfs.frontier.empty?
         # Takes the next frontier cell
-        new_frontier = bfs.frontier.shift 
+        new_frontier = bfs.frontier.shift
         # For each of its neighbors
-        adjacent_neighbors(new_frontier).each do |neighbor| 
+        adjacent_neighbors(new_frontier).each do |neighbor|
           # That have not been visited and are not walls
-          unless bfs.came_from.has_key?(neighbor) || grid.walls.has_key?(neighbor) 
+          unless bfs.came_from.has_key?(neighbor) || grid.walls.has_key?(neighbor)
             # Add them to the frontier and mark them as visited
-            bfs.frontier << neighbor 
-            bfs.came_from[neighbor] = new_frontier 
+            bfs.frontier << neighbor
+            bfs.came_from[neighbor] = new_frontier
           end
         end
       end
@@ -19447,12 +20207,12 @@ Follows is a source code listing for all files that have been open sourced. This
         # Get the next cell to explore from
         new_frontier = heuristic.frontier.shift
         # For each of its neighbors
-        adjacent_neighbors(new_frontier).each do |neighbor| 
+        adjacent_neighbors(new_frontier).each do |neighbor|
           # That have not been visited and are not walls
-          unless heuristic.came_from.has_key?(neighbor) || grid.walls.has_key?(neighbor) 
+          unless heuristic.came_from.has_key?(neighbor) || grid.walls.has_key?(neighbor)
             # Add them to the frontier and mark them as visited
-            heuristic.frontier << neighbor 
-            heuristic.came_from[neighbor] = new_frontier 
+            heuristic.frontier << neighbor
+            heuristic.came_from[neighbor] = new_frontier
           end
         end
       end
@@ -19496,16 +20256,16 @@ Follows is a source code listing for all files that have been open sourced. This
     # Returns a list of adjacent cells
     # Used to determine what the next cells to be added to the frontier are
     def adjacent_neighbors(cell)
-      neighbors = [] 
+      neighbors = []
   
       # Gets all the valid neighbors into the array
       # From southern neighbor, clockwise
-      neighbors << [cell.x    , cell.y - 1] unless cell.y == 0 
-      neighbors << [cell.x - 1, cell.y    ] unless cell.x == 0 
-      neighbors << [cell.x    , cell.y + 1] unless cell.y == grid.height - 1 
-      neighbors << [cell.x + 1, cell.y    ] unless cell.x == grid.width - 1 
+      neighbors << [cell.x    , cell.y - 1] unless cell.y == 0
+      neighbors << [cell.x - 1, cell.y    ] unless cell.x == 0
+      neighbors << [cell.x    , cell.y + 1] unless cell.y == grid.height - 1
+      neighbors << [cell.x + 1, cell.y    ] unless cell.x == grid.width - 1
   
-      neighbors 
+      neighbors
     end
   
     # Finds the vertical and horizontal distance of a cell from the star
@@ -19554,7 +20314,7 @@ Follows is a source code listing for all files that have been open sourced. This
     def wall_color
       [134, 134, 120] # Camo Green
     end
-    
+  
     def visited_color
       [204, 191, 179] # Dark Brown
     end
@@ -19562,7 +20322,7 @@ Follows is a source code listing for all files that have been open sourced. This
     def frontier_color
       [103, 136, 204] # Blue
     end
-    
+  
     def path_color
       [231, 230, 228] # Pastel White
     end
@@ -19610,13 +20370,13 @@ Follows is a source code listing for all files that have been open sourced. This
   
     def tick
       defaults
-      render 
-      input  
+      render
+      input
       # If animation is playing, and max steps have not been reached
       # Move the search a step forward
       if state.play && state.current_step < state.max_steps
         # Variable that tells the program what step to recalculate up to
-        state.current_step += 1 
+        state.current_step += 1
         move_searches_one_step_forward
       end
     end
@@ -19671,7 +20431,7 @@ Follows is a source code listing for all files that have been open sourced. This
       # We store this value, because we want to remember the value even when
       # the user's cursor is no longer over what they're interacting with, but
       # they are still clicking down on the mouse.
-      state.user_input ||= :none 
+      state.user_input ||= :none
   
       # These variables allow the breadth first search to take place
       # Came_from is a hash with a key of a cell and a value of the cell that was expanded from to find the key.
@@ -19696,7 +20456,7 @@ Follows is a source code listing for all files that have been open sourced. This
       # Unless the current step has a value
       unless state.current_step
         # Set the current step to 10
-        state.current_step = 10 
+        state.current_step = 10
         # And calculate the searches up to step 10
         recalculate_searches
       end
@@ -19706,7 +20466,7 @@ Follows is a source code listing for all files that have been open sourced. This
       # This step is roughly the grid's width * height
       # When anim_steps equals max_steps no more calculations will occur
       # and the slider will be at the end
-      state.max_steps = grid.width * grid.height 
+      state.max_steps = grid.width * grid.height
   
       # Whether the animation should play or not
       # If true, every tick moves anim_steps forward one
@@ -19799,7 +20559,7 @@ Follows is a source code listing for all files that have been open sourced. This
       # If the mouse was clicked this tick
       if inputs.mouse.down
         # Determine what the user is editing and appropriately edit the state.user_input variable
-        determine_input          
+        determine_input
       end
   
       # Process user input based on user_input variable and current mouse position
@@ -19812,35 +20572,35 @@ Follows is a source code listing for all files that have been open sourced. This
       if mouse_over_slider?
         state.user_input = :slider
       # If the mouse is over the star in the first grid
-      elsif bfs_mouse_over_star?                 
+      elsif bfs_mouse_over_star?
         # The user is editing the star from the first grid
-        state.user_input = :bfs_star          
+        state.user_input = :bfs_star
       # If the mouse is over the star in the second grid
-      elsif heuristic_mouse_over_star?                 
+      elsif heuristic_mouse_over_star?
         # The user is editing the star from the second grid
-        state.user_input = :heuristic_star          
+        state.user_input = :heuristic_star
       # If the mouse is over the target in the first grid
-      elsif bfs_mouse_over_target?                 
+      elsif bfs_mouse_over_target?
         # The user is editing the target from the first grid
-        state.user_input = :bfs_target          
+        state.user_input = :bfs_target
       # If the mouse is over the target in the second grid
-      elsif heuristic_mouse_over_target?                 
+      elsif heuristic_mouse_over_target?
         # The user is editing the target from the second grid
-        state.user_input = :heuristic_target 
+        state.user_input = :heuristic_target
       # If the mouse is over a wall in the first grid
-      elsif bfs_mouse_over_wall?                 
+      elsif bfs_mouse_over_wall?
         # The user is removing a wall from the first grid
-        state.user_input = :bfs_remove_wall   
+        state.user_input = :bfs_remove_wall
       # If the mouse is over a wall in the second grid
-      elsif heuristic_mouse_over_wall?                 
+      elsif heuristic_mouse_over_wall?
         # The user is removing a wall from the second grid
         state.user_input = :heuristic_remove_wall
       # If the mouse is over the first grid
-      elsif bfs_mouse_over_grid?                 
+      elsif bfs_mouse_over_grid?
         # The user is adding a wall from the first grid
         state.user_input = :bfs_add_wall
       # If the mouse is over the second grid
-      elsif heuristic_mouse_over_grid?                 
+      elsif heuristic_mouse_over_grid?
         # The user is adding a wall from the second grid
         state.user_input = :heuristic_add_wall
       end
@@ -19850,22 +20610,22 @@ Follows is a source code listing for all files that have been open sourced. This
     def process_input
       if state.user_input == :slider
         process_input_slider
-      elsif state.user_input == :bfs_star         
-        process_input_bfs_star                            
+      elsif state.user_input == :bfs_star
+        process_input_bfs_star
       elsif state.user_input == :heuristic_star
-        process_input_heuristic_star                            
-      elsif state.user_input == :bfs_target         
-        process_input_bfs_target                            
-      elsif state.user_input == :heuristic_target         
-        process_input_heuristic_target                            
-      elsif state.user_input == :bfs_remove_wall  
-        process_input_bfs_remove_wall                     
+        process_input_heuristic_star
+      elsif state.user_input == :bfs_target
+        process_input_bfs_target
+      elsif state.user_input == :heuristic_target
+        process_input_heuristic_target
+      elsif state.user_input == :bfs_remove_wall
+        process_input_bfs_remove_wall
       elsif state.user_input == :heuristic_remove_wall
-        process_input_heuristic_remove_wall                     
-      elsif state.user_input == :bfs_add_wall     
-        process_input_bfs_add_wall                        
-      elsif state.user_input == :heuristic_add_wall     
-        process_input_heuristic_add_wall                        
+        process_input_heuristic_remove_wall
+      elsif state.user_input == :bfs_add_wall
+        process_input_bfs_add_wall
+      elsif state.user_input == :heuristic_add_wall
+        process_input_heuristic_add_wall
       end
     end
   
@@ -19942,7 +20702,7 @@ Follows is a source code listing for all files that have been open sourced. This
   
       # The horizontal grid lines
       for y in 0..grid.height
-        outputs.lines << bfs_horizontal_line(y) 
+        outputs.lines << bfs_horizontal_line(y)
       end
     end
   
@@ -19957,10 +20717,10 @@ Follows is a source code listing for all files that have been open sourced. This
   
       # The horizontal grid lines
       for y in 0..grid.height
-        outputs.lines << heuristic_horizontal_line(y) 
+        outputs.lines << heuristic_horizontal_line(y)
       end
     end
-      
+  
     # Returns a vertical line for a column of the first grid
     def bfs_vertical_line column
       bfs_scale_up([column, 0, column, grid.height])
@@ -19995,7 +20755,7 @@ Follows is a source code listing for all files that have been open sourced. This
     def render_bfs_target
       outputs.sprites << [bfs_scale_up(grid.target), 'target.png']
     end
-    
+  
     # Renders the target on the second grid
     def render_heuristic_target
       outputs.sprites << [heuristic_scale_up(grid.target), 'target.png']
@@ -20003,14 +20763,14 @@ Follows is a source code listing for all files that have been open sourced. This
   
     # Renders the walls on the first grid
     def render_bfs_walls
-      grid.walls.each_key do | wall | 
+      grid.walls.each_key do | wall |
         outputs.solids << [bfs_scale_up(wall), wall_color]
       end
     end
   
     # Renders the walls on the second grid
     def render_heuristic_walls
-      grid.walls.each_key do | wall | 
+      grid.walls.each_key do | wall |
         outputs.solids << [heuristic_scale_up(wall), wall_color]
       end
     end
@@ -20031,14 +20791,14 @@ Follows is a source code listing for all files that have been open sourced. This
   
     # Renders the frontier cells on the first grid
     def render_bfs_frontier
-      bfs.frontier.each do | frontier_cell | 
+      bfs.frontier.each do | frontier_cell |
         outputs.solids << [bfs_scale_up(frontier_cell), frontier_color, 200]
       end
     end
   
     # Renders the frontier cells on the second grid
     def render_heuristic_frontier
-      heuristic.frontier.each do | frontier_cell | 
+      heuristic.frontier.each do | frontier_cell |
         outputs.solids << [heuristic_scale_up(frontier_cell), frontier_color, 200]
       end
     end
@@ -20122,14 +20882,14 @@ Follows is a source code listing for all files that have been open sourced. This
     # Checks and handles input for the buttons
     # Called when the mouse is lifted
     def input_buttons
-      input_left_button 
-      input_center_button          
-      input_right_button     
+      input_left_button
+      input_center_button
+      input_right_button
     end
   
     # Checks if the previous step button is clicked
     # If it is, it pauses the animation and moves the search one step backward
-    def input_left_button 
+    def input_left_button
       if left_button_clicked?
         state.play = false
         state.current_step -= 1
@@ -20141,7 +20901,7 @@ Follows is a source code listing for all files that have been open sourced. This
     # Inverses whether the animation is playing or not when clicked
     def input_center_button
       if center_button_clicked? || inputs.keyboard.key_down.space
-        state.play = !state.play         
+        state.play = !state.play
       end
     end
   
@@ -20149,8 +20909,8 @@ Follows is a source code listing for all files that have been open sourced. This
     # If it is, it pauses the animation and moves the search one step forward
     def input_right_button
       if right_button_clicked?
-        state.play = false              
-        state.current_step += 1           
+        state.play = false
+        state.current_step += 1
         move_searches_one_step_forward
       end
     end
@@ -20231,12 +20991,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # on the slider
     # Changes the step of the search to be animated
     def process_input_slider
-      state.play = false 
+      state.play = false
       mouse_x = inputs.mouse.point.x
   
       # Bounds the mouse_x to the closest x value on the slider line
-      mouse_x = slider.x if mouse_x < slider.x 
-      mouse_x = slider.x + slider.w if mouse_x > slider.x + slider.w 
+      mouse_x = slider.x if mouse_x < slider.x
+      mouse_x = slider.x + slider.w if mouse_x > slider.x + slider.w
   
       # Sets the current search step to the one represented by the mouse x value
       # The slider's circle moves due to the render_slider method using anim_steps
@@ -20249,12 +21009,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # Only resets the search if the star changes position
     # Called whenever the user is editing the star (puts mouse down on star)
     def process_input_bfs_star
-      old_star = grid.star.clone 
+      old_star = grid.star.clone
       unless bfs_cell_closest_to_mouse == grid.target
-        grid.star = bfs_cell_closest_to_mouse 
+        grid.star = bfs_cell_closest_to_mouse
       end
-      unless old_star == grid.star 
-        recalculate_searches 
+      unless old_star == grid.star
+        recalculate_searches
       end
     end
   
@@ -20262,12 +21022,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # Only resets the search if the star changes position
     # Called whenever the user is editing the star (puts mouse down on star)
     def process_input_heuristic_star
-      old_star = grid.star.clone 
+      old_star = grid.star.clone
       unless heuristic_cell_closest_to_mouse == grid.target
         grid.star = heuristic_cell_closest_to_mouse
       end
-      unless old_star == grid.star 
-        recalculate_searches 
+      unless old_star == grid.star
+        recalculate_searches
       end
     end
   
@@ -20275,12 +21035,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # Only recalculate_searchess the search if the target changes position
     # Called whenever the user is editing the target (puts mouse down on target)
     def process_input_bfs_target
-      old_target = grid.target.clone 
+      old_target = grid.target.clone
       unless bfs_cell_closest_to_mouse == grid.star
         grid.target = bfs_cell_closest_to_mouse
       end
-      unless old_target == grid.target 
-        recalculate_searches 
+      unless old_target == grid.target
+        recalculate_searches
       end
     end
   
@@ -20288,12 +21048,12 @@ Follows is a source code listing for all files that have been open sourced. This
     # Only recalculate_searchess the search if the target changes position
     # Called whenever the user is editing the target (puts mouse down on target)
     def process_input_heuristic_target
-      old_target = grid.target.clone 
+      old_target = grid.target.clone
       unless heuristic_cell_closest_to_mouse == grid.star
         grid.target = heuristic_cell_closest_to_mouse
       end
-      unless old_target == grid.target 
-        recalculate_searches 
+      unless old_target == grid.target
+        recalculate_searches
       end
     end
   
@@ -20302,10 +21062,10 @@ Follows is a source code listing for all files that have been open sourced. This
       # The mouse needs to be inside the grid, because we only want to remove walls
       # the cursor is directly over
       # Recalculations should only occur when a wall is actually deleted
-      if bfs_mouse_over_grid? 
+      if bfs_mouse_over_grid?
         if grid.walls.has_key?(bfs_cell_closest_to_mouse)
-          grid.walls.delete(bfs_cell_closest_to_mouse) 
-          recalculate_searches 
+          grid.walls.delete(bfs_cell_closest_to_mouse)
+          recalculate_searches
         end
       end
     end
@@ -20315,29 +21075,29 @@ Follows is a source code listing for all files that have been open sourced. This
       # The mouse needs to be inside the grid, because we only want to remove walls
       # the cursor is directly over
       # Recalculations should only occur when a wall is actually deleted
-      if heuristic_mouse_over_grid? 
+      if heuristic_mouse_over_grid?
         if grid.walls.has_key?(heuristic_cell_closest_to_mouse)
-          grid.walls.delete(heuristic_cell_closest_to_mouse) 
-          recalculate_searches 
+          grid.walls.delete(heuristic_cell_closest_to_mouse)
+          recalculate_searches
         end
       end
     end
     # Adds a wall in the first grid in the cell the mouse is over
     def process_input_bfs_add_wall
-      if bfs_mouse_over_grid? 
+      if bfs_mouse_over_grid?
         unless grid.walls.has_key?(bfs_cell_closest_to_mouse)
-          grid.walls[bfs_cell_closest_to_mouse] = true 
-          recalculate_searches 
+          grid.walls[bfs_cell_closest_to_mouse] = true
+          recalculate_searches
         end
       end
     end
   
     # Adds a wall in the second grid in the cell the mouse is over
     def process_input_heuristic_add_wall
-      if heuristic_mouse_over_grid? 
+      if heuristic_mouse_over_grid?
         unless grid.walls.has_key?(heuristic_cell_closest_to_mouse)
-          grid.walls[heuristic_cell_closest_to_mouse] = true 
-          recalculate_searches 
+          grid.walls[heuristic_cell_closest_to_mouse] = true
+          recalculate_searches
         end
       end
     end
@@ -20347,13 +21107,13 @@ Follows is a source code listing for all files that have been open sourced. This
     # Finding the cell closest to the mouse helps with this
     def bfs_cell_closest_to_mouse
       # Closest cell to the mouse in the first grid
-      x = (inputs.mouse.point.x / grid.cell_size).to_i 
-      y = (inputs.mouse.point.y / grid.cell_size).to_i 
+      x = (inputs.mouse.point.x / grid.cell_size).to_i
+      y = (inputs.mouse.point.y / grid.cell_size).to_i
       # Bound x and y to the grid
-      x = grid.width - 1 if x > grid.width - 1 
-      y = grid.height - 1 if y > grid.height - 1 
+      x = grid.width - 1 if x > grid.width - 1
+      y = grid.height - 1 if y > grid.height - 1
       # Return closest cell
-      [x, y] 
+      [x, y]
     end
   
     # When the user grabs the star and puts their cursor to the far right
@@ -20361,17 +21121,17 @@ Follows is a source code listing for all files that have been open sourced. This
     # Finding the cell closest to the mouse in the second grid helps with this
     def heuristic_cell_closest_to_mouse
       # Closest cell grid to the mouse in the second
-      x = (inputs.mouse.point.x / grid.cell_size).to_i 
-      y = (inputs.mouse.point.y / grid.cell_size).to_i 
+      x = (inputs.mouse.point.x / grid.cell_size).to_i
+      y = (inputs.mouse.point.y / grid.cell_size).to_i
       # Translate the cell to the first grid
       x -= grid.width + 1
       # Bound x and y to the first grid
       x = 0 if x < 0
       y = 0 if y < 0
-      x = grid.width - 1 if x > grid.width - 1 
-      y = grid.height - 1 if y > grid.height - 1 
+      x = grid.width - 1 if x > grid.width - 1
+      y = grid.height - 1 if y > grid.height - 1
       # Return closest cell
-      [x, y] 
+      [x, y]
     end
   
     def recalculate_searches
@@ -20396,22 +21156,22 @@ Follows is a source code listing for all files that have been open sourced. This
       return if bfs.came_from.has_key?(grid.target)
   
       # Only runs at the beginning of the search as setup.
-      if bfs.came_from.empty?  
-        bfs.frontier << grid.star                   
-        bfs.came_from[grid.star] = nil              
+      if bfs.came_from.empty?
+        bfs.frontier << grid.star
+        bfs.came_from[grid.star] = nil
       end
   
       # A step in the search
-      unless bfs.frontier.empty? 
+      unless bfs.frontier.empty?
         # Takes the next frontier cell
-        new_frontier = bfs.frontier.shift 
+        new_frontier = bfs.frontier.shift
         # For each of its neighbors
-        adjacent_neighbors(new_frontier).each do |neighbor| 
+        adjacent_neighbors(new_frontier).each do |neighbor|
           # That have not been visited and are not walls
-          unless bfs.came_from.has_key?(neighbor) || grid.walls.has_key?(neighbor) 
+          unless bfs.came_from.has_key?(neighbor) || grid.walls.has_key?(neighbor)
             # Add them to the frontier and mark them as visited
-            bfs.frontier << neighbor 
-            bfs.came_from[neighbor] = new_frontier 
+            bfs.frontier << neighbor
+            bfs.came_from[neighbor] = new_frontier
           end
         end
       end
@@ -20466,12 +21226,12 @@ Follows is a source code listing for all files that have been open sourced. This
         # Get the next cell to explore from
         new_frontier = heuristic.frontier.shift
         # For each of its neighbors
-        adjacent_neighbors(new_frontier).each do |neighbor| 
+        adjacent_neighbors(new_frontier).each do |neighbor|
           # That have not been visited and are not walls
-          unless heuristic.came_from.has_key?(neighbor) || grid.walls.has_key?(neighbor) 
+          unless heuristic.came_from.has_key?(neighbor) || grid.walls.has_key?(neighbor)
             # Add them to the frontier and mark them as visited
-            heuristic.frontier << neighbor 
-            heuristic.came_from[neighbor] = new_frontier 
+            heuristic.frontier << neighbor
+            heuristic.came_from[neighbor] = new_frontier
           end
         end
       end
@@ -20515,16 +21275,16 @@ Follows is a source code listing for all files that have been open sourced. This
     # Returns a list of adjacent cells
     # Used to determine what the next cells to be added to the frontier are
     def adjacent_neighbors(cell)
-      neighbors = [] 
+      neighbors = []
   
       # Gets all the valid neighbors into the array
       # From southern neighbor, clockwise
-      neighbors << [cell.x    , cell.y - 1] unless cell.y == 0 
-      neighbors << [cell.x - 1, cell.y    ] unless cell.x == 0 
-      neighbors << [cell.x    , cell.y + 1] unless cell.y == grid.height - 1 
-      neighbors << [cell.x + 1, cell.y    ] unless cell.x == grid.width - 1 
+      neighbors << [cell.x    , cell.y - 1] unless cell.y == 0
+      neighbors << [cell.x - 1, cell.y    ] unless cell.x == 0
+      neighbors << [cell.x    , cell.y + 1] unless cell.y == grid.height - 1
+      neighbors << [cell.x + 1, cell.y    ] unless cell.x == grid.width - 1
   
-      neighbors 
+      neighbors
     end
   
     # Finds the vertical and horizontal distance of a cell from the star
@@ -20573,7 +21333,7 @@ Follows is a source code listing for all files that have been open sourced. This
     def wall_color
       [134, 134, 120] # Camo Green
     end
-    
+  
     def visited_color
       [204, 191, 179] # Dark Brown
     end
@@ -20581,7 +21341,7 @@ Follows is a source code listing for all files that have been open sourced. This
     def frontier_color
       [103, 136, 204] # Blue
     end
-    
+  
     def path_color
       [231, 230, 228] # Pastel White
     end
@@ -24345,6 +25105,444 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
+*** Crafting - Farming Game Starting Point - main.rb
+#+begin_src ruby
+  # ./samples/99_genre_crafting/farming_game_starting_point/app/main.rb
+  def tick args
+    args.state.tile_size     = 80
+    args.state.player_speed  = 4
+    args.state.player      ||= tile(args, 7, 3, 0, 128, 180)
+    generate_map args
+    #press j to plant a green onion
+    if args.inputs.keyboard.j
+    #change this part you can change what you want to plant
+     args.state.walls << tile(args, ((args.state.player.x+80)/args.state.tile_size), ((args.state.player.y)/args.state.tile_size), 255, 255, 255)
+     args.state.plants << tile(args, ((args.state.player.x+80)/args.state.tile_size), ((args.state.player.y+80)/args.state.tile_size), 0, 160, 0)
+    end
+    # Adds walls, background, and player to args.outputs.solids so they appear on screen
+    args.outputs.solids << [0,0,1280,720, 237,189,101]
+    args.outputs.sprites << [0, 0, 1280, 720, 'sprites/background.png']
+    args.outputs.solids << args.state.walls
+    args.outputs.solids << args.state.player
+    args.outputs.solids << args.state.plants
+    args.outputs.labels << [320, 640, "press J to plant", 3, 1, 255, 0, 0, 200]
+  
+    move_player args, -1,  0 if args.inputs.keyboard.left # x position decreases by 1 if left key is pressed
+    move_player args,  1,  0 if args.inputs.keyboard.right # x position increases by 1 if right key is pressed
+    move_player args,  0,  1 if args.inputs.keyboard.up # y position increases by 1 if up is pressed
+    move_player args,  0, -1 if args.inputs.keyboard.down # y position decreases by 1 if down is pressed
+  end
+  
+  # Sets position, size, and color of the tile
+  def tile args, x, y, *color
+    [x * args.state.tile_size, # sets definition for array using method parameters
+     y * args.state.tile_size, # multiplying by tile_size sets x and y to correct position using pixel values
+     args.state.tile_size,
+     args.state.tile_size,
+     *color]
+  end
+  
+  # Creates map by adding tiles to the wall, as well as a goal (that the player needs to reach)
+  def generate_map args
+    return if args.state.area
+  
+    # Creates the area of the map. There are 9 rows running horizontally across the screen
+    # and 16 columns running vertically on the screen. Any spot with a "1" is not
+    # open for the player to move into (and is green), and any spot with a "0" is available
+    # for the player to move in.
+    args.state.area = [
+      [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,],
+      [1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1,],
+      [1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1,],
+      [1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1,],
+      [1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1,],
+      [1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1,],
+      [1, 1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 1, 1,],
+      [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1,],
+      [1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1, 1 ],
+    ].reverse # reverses the order of the area collection
+  
+    # By reversing the order, the way that the area appears above is how it appears
+    # on the screen in the game. If we did not reverse, the map would appear inverted.
+  
+    #The wall starts off with no tiles.
+    args.state.walls = []
+    args.state.plants = []
+  
+    # If v is 1, a green tile is added to args.state.walls.
+    # If v is 2, a black tile is created as the goal.
+    args.state.area.map_2d do |y, x, v|
+      if    v == 1
+        args.state.walls << tile(args, x, y, 255, 160, 156) # green tile
+      end
+    end
+  end
+  
+  # Allows the player to move their box around the screen
+  def move_player args, *vector
+    box = args.state.player.shift_rect(vector) # box is able to move at an angle
+  
+    # If the player's box hits a wall, it is not able to move further in that direction
+    return if args.state.walls
+                  .any_intersect_rect?(box)
+  
+    # Player's box is able to move at angles (not just the four general directions) fast
+    args.state.player =
+      args.state.player
+          .shift_rect(vector.x * args.state.player_speed, # if we don't multiply by speed, then
+                      vector.y * args.state.player_speed) # the box will move extremely slow
+  end
+
+#+end_src
+
+*** Crafting - Farming Game Starting Point - repl.rb
+#+begin_src ruby
+  # ./samples/99_genre_crafting/farming_game_starting_point/app/repl.rb
+  # ===============================================================

+  # Welcome to repl.rb

+  # ===============================================================

+  # You can experiement with code within this file. Code in this

+  # file is only executed when you save (and only excecuted ONCE).

+  # ===============================================================

+  

+  # ===============================================================

+  # REMOVE the "x" from the word "xrepl" and save the file to RUN

+  # the code in between the do/end block delimiters.

+  # ===============================================================

+  

+  # ===============================================================

+  # ADD the "x" to the word "repl" (make it xrepl) and save the

+  # file to IGNORE the code in between the do/end block delimiters.

+  # ===============================================================

+  

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    puts "The result of 1 + 2 is: #{1 + 2}"

+  end

+  

+  # ====================================================================================

+  # Ruby Crash Course:

+  # Strings, Numeric, Booleans, Conditionals, Looping, Enumerables, Arrays

+  # ====================================================================================

+  

+  # ====================================================================================

+  #  Strings

+  # ====================================================================================

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    message = "Hello World"

+    puts "The value of message is: " + message

+    puts "Any value can be interpolated within a string using \#{}."

+    puts "Interpolated message: #{message}."

+    puts 'This #{message} is not interpolated because the string uses single quotes.'

+  end

+  

+  # ====================================================================================

+  #  Numerics

+  # ====================================================================================

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    a = 10

+    puts "The value of a is: #{a}"

+    puts "a + 1 is: #{a + 1}"

+    puts "a / 3 is: #{a / 3}"

+  end

+  

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    b = 10.12

+    puts "The value of b is: #{b}"

+    puts "b + 1 is: #{b + 1}"

+    puts "b as an integer is: #{b.to_i}"

+    puts ''

+  end

+  

+  # ====================================================================================

+  #  Booleans

+  # ====================================================================================

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    c = 30

+    puts "The value of c is #{c}."

+  

+    if c

+      puts "This if statement ran because c is truthy."

+    end

+  end

+  

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    d = false

+    puts "The value of d is #{d}."

+  

+    if !d

+      puts "This if statement ran because d is falsey, using the not operator (!) makes d evaluate to true."

+    end

+  

+    e = nil

+    puts "Nil is also considered falsey. The value of e is: #{e}."

+  

+    if !e

+      puts "This if statement ran because e is nil (a falsey value)."

+    end

+  end

+  

+  # ====================================================================================

+  #  Conditionals

+  # ====================================================================================

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    i_am_true  = true

+    i_am_nil   = nil

+    i_am_false = false

+    i_am_hi    = "hi"

+  

+    puts "======== if statement"

+    i_am_one = 1

+    if i_am_one

+      puts "This was printed because i_am_one is truthy."

+    end

+  

+    puts "======== if/else statement"

+    if i_am_false

+      puts "This will NOT get printed because i_am_false is false."

+    else

+      puts "This was printed because i_am_false is false."

+    end

+  

+    puts "======== if/elsif/else statement"

+    if i_am_false

+      puts "This will NOT get printed because i_am_false is false."

+    elsif i_am_true

+      puts "This was printed because i_am_true is true."

+    else

+      puts "This will NOT get printed i_am_true was true."

+    end

+  

+    puts "======== case statement "

+    i_am_one = 1

+    case i_am_one

+    when 10

+      puts "case equaled: 10"

+    when 9

+      puts "case equaled: 9"

+    when 5

+      puts "case equaled: 5"

+    when 1

+      puts "case equaled: 1"

+    else

+      puts "Value wasn't cased."

+    end

+  

+    puts "======== different types of comparisons"

+    if 4 == 4

+      puts "equal (4 == 4)"

+    end

+  

+    if 4 != 3

+      puts "not equal (4 != 3)"

+    end

+  

+    if 3 < 4

+      puts "less than (3 < 4)"

+    end

+  

+    if 4 > 3

+      puts "greater than (4 > 3)"

+    end

+  

+    if ((4 > 3) || (3 < 4) || false)

+      puts "or statement ((4 > 3) || (3 < 4) || false)"

+    end

+  

+    if ((4 > 3) && (3 < 4))

+      puts "and statement ((4 > 3) && (3 < 4))"

+    end

+  end

+  

+  # ====================================================================================

+  # Looping

+  # ====================================================================================

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    puts "======== times block"

+    3.times do |i|

+      puts i

+    end

+    puts "======== range block exclusive"

+    (0...3).each do |i|

+      puts i

+    end

+    puts "======== range block inclusive"

+    (0..3).each do |i|

+      puts i

+    end

+  end

+  

+  # ====================================================================================

+  #  Enumerables

+  # ====================================================================================

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    puts "======== array each"

+    colors = ["red", "blue", "yellow"]

+    colors.each do |color|

+      puts color

+    end

+  

+    puts '======== array each_with_index'

+    colors = ["red", "blue", "yellow"]

+    colors.each_with_index do |color, i|

+      puts "#{color} at index #{i}"

+    end

+  end

+  

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    puts "======== single parameter function"

+    def add_one_to n

+      n + 5

+    end

+  

+    puts add_one_to(3)

+  

+    puts "======== function with default value"

+    def function_with_default_value v = 10

+      v * 10

+    end

+  

+    puts "passing three: #{function_with_default_value(3)}"

+    puts "passing nil: #{function_with_default_value}"

+  

+    puts "======== Or Equal (||=) operator for nil values"

+    def function_with_nil_default_with_local a = nil

+      result   = a

+      result ||= "or equal operator was exected and set a default value"

+    end

+  

+    puts "passing 'hi': #{function_with_nil_default_with_local 'hi'}"

+    puts "passing nil: #{function_with_nil_default_with_local}"

+  end

+  

+  # ====================================================================================

+  #  Arrays

+  # ====================================================================================

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    puts "======== Create an array with the numbers 1 to 10."

+    one_to_ten = (1..10).to_a

+    puts one_to_ten

+  

+    puts "======== Create a new array that only contains even numbers from the previous array."

+    one_to_ten = (1..10).to_a

+    evens = one_to_ten.find_all do |number|

+      number % 2 == 0

+    end

+    puts evens

+  

+    puts "======== Create a new array that rejects odd numbers."

+    one_to_ten = (1..10).to_a

+    also_even = one_to_ten.reject do |number|

+      number % 2 != 0

+    end

+    puts also_even

+  

+    puts "======== Create an array that doubles every number."

+    one_to_ten = (1..10).to_a

+    doubled = one_to_ten.map do |number|

+      number * 2

+    end

+    puts doubled

+  

+    puts "======== Create an array that selects only odd numbers and then multiply those by 10."

+    one_to_ten = (1..10).to_a

+    odd_doubled = one_to_ten.find_all do |number|

+      number % 2 != 0

+    end.map do |odd_number|

+      odd_number * 10

+    end

+    puts odd_doubled

+  

+    puts "======== All combination of numbers 1 to 10."

+    one_to_ten = (1..10).to_a

+    all_combinations = one_to_ten.product(one_to_ten)

+    puts all_combinations

+  

+    puts "======== All uniq combinations of numbers. For example: [1, 2] is the same as [2, 1]."

+    one_to_ten = (1..10).to_a

+    uniq_combinations =

+      one_to_ten.product(one_to_ten)

+        .map do |unsorted_number|

+      unsorted_number.sort

+    end.uniq

+    puts uniq_combinations

+  end

+  

+  # ====================================================================================

+  #  Advanced Arrays

+  # ====================================================================================

+  # Remove the x from xrepl to run the code. Add the x back to ignore to code.

+  xrepl do

+    puts "======== All unique Pythagorean Triples between 1 and 40 sorted by area of the triangle."

+  

+    one_to_hundred = (1..40).to_a

+    triples =

+      one_to_hundred.product(one_to_hundred).map do |width, height|

+      [width, height, Math.sqrt(width ** 2 + height ** 2)]

+    end.find_all do |_, _, hypotenuse|

+      hypotenuse.to_i == hypotenuse

+    end.map do |triangle|

+      triangle.map(&:to_i)

+    end.uniq do |triangle|

+      triangle.sort

+    end.map do |width, height, hypotenuse|

+      [width, height, hypotenuse, (width * height) / 2]

+    end.sort_by do |_, _, _, area|

+      area

+    end

+  

+    triples.each do |width, height, hypotenuse, area|

+      puts "(#{width}, #{height}, #{hypotenuse}) = #{area}"

+    end

+  end

+
+#+end_src
+
+*** Crafting - Farming Game Starting Point - tests.rb
+#+begin_src ruby
+  # ./samples/99_genre_crafting/farming_game_starting_point/app/tests.rb
+  # For advanced users:

+  # You can put some quick verification tests here, any method

+  # that starts with the `test_` will be run when you save this file.

+  

+  # Here is an example test and game

+  

+  # To run the test: ./dragonruby mygame --eval app/tests.rb --no-tick

+  

+  class MySuperHappyFunGame

+    attr_gtk

+  

+    def tick

+      outputs.solids << [100, 100, 300, 300]

+    end

+  end

+  

+  def test_universe args, assert

+    game = MySuperHappyFunGame.new

+    game.args = args

+    game.tick

+    assert.true!  args.outputs.solids.length == 1, "failure: a solid was not added after tick"

+    assert.false! 1 == 2, "failure: some how, 1 equals 2, the world is ending"

+    puts "test_universe completed successfully"

+  end

+  

+  puts "running tests"

+  $gtk.reset 100

+  $gtk.log_level = :off

+  $gtk.tests.start

+
+#+end_src
+
 *** Dev Tools - Add Buttons To Console - main.rb
 #+begin_src ruby
   # ./samples/99_genre_dev_tools/add_buttons_to_console/app/main.rb
@@ -24515,12 +25713,12 @@ Follows is a source code listing for all files that have been open sourced. This
         label = { x: b.x + state.buttons_frame_selection.size.half,
                   y: b.y,
                   text: "#{i + 1}", r: 180, g: 180, b: 180,
-                  size_enum: -4, alignment_enum: 1 }.label
+                  size_enum: -4, alignment_enum: 1 }.label!
   
-        selection_border = b.merge(r: 40, g: 40, b: 40).border
+        selection_border = b.merge(r: 40, g: 40, b: 40).border!
   
         if i == state.animation_frames_selected_index
-          selection_border = b.merge(r: 40, g: 230, b: 200).border
+          selection_border = b.merge(r: 40, g: 230, b: 200).border!
         end
   
         [selection_border, label]
@@ -25257,6 +26455,528 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
+*** Dungeon Crawl - Classics Jam - main.rb
+#+begin_src ruby
+  # ./samples/99_genre_dungeon_crawl/classics_jam/app/main.rb
+  class Game
+    attr_gtk
+  
+    def tick
+      defaults
+      render
+      input
+      calc
+    end
+  
+    def defaults
+      player.x              ||= 640
+      player.y              ||= 360
+      player.w              ||= 16
+      player.h              ||= 16
+      player.attacked_at    ||= -1
+      player.angle          ||= 0
+      player.future_player  ||= future_player_position 0, 0
+      player.projectiles    ||= []
+      player.damage         ||= 0
+      state.level           ||= create_level level_one_template
+    end
+  
+    def render
+      outputs.sprites << level.walls.map do |w|
+        w.merge(path: 'sprites/square/gray.png')
+      end
+  
+      outputs.sprites << level.spawn_locations.map do |s|
+        s.merge(path: 'sprites/square/blue.png')
+      end
+  
+      outputs.sprites << player.projectiles.map do |p|
+        p.merge(path: 'sprites/square/blue.png')
+      end
+  
+      outputs.sprites << level.enemies.map do |e|
+        e.merge(path: 'sprites/square/red.png')
+      end
+  
+      outputs.sprites << player.merge(path: 'sprites/circle/green.png', angle: player.angle)
+  
+      outputs.labels << { x: 30, y: 30.from_top, text: "damage: #{player.damage || 0}" }
+    end
+  
+    def input
+      player.angle = inputs.directional_angle || player.angle
+      if inputs.controller_one.key_down.a || inputs.keyboard.key_down.space
+        player.attacked_at = state.tick_count
+      end
+    end
+  
+    def calc
+      calc_player
+      calc_projectiles
+      calc_enemies
+      calc_spawn_locations
+    end
+  
+    def calc_player
+      if player.attacked_at == state.tick_count
+        player.projectiles << { at: state.tick_count,
+                                x: player.x,
+                                y: player.y,
+                                angle: player.angle,
+                                w: 4,
+                                h: 4 }.center_inside_rect(player)
+      end
+  
+      if player.attacked_at.elapsed_time > 5
+        future_player = future_player_position inputs.left_right * 2, inputs.up_down * 2
+        future_player_collision = future_collision player, future_player, level.walls
+        player.x = future_player_collision.x if !future_player_collision.dx_collision
+        player.y = future_player_collision.y if !future_player_collision.dy_collision
+      end
+    end
+  
+    def calc_projectile_collisions entities
+      entities.each do |e|
+        e.damage ||= 0
+        player.projectiles.each do |p|
+          if !p.collided && (p.intersect_rect? e)
+            p.collided = true
+            e.damage  += 1
+          end
+        end
+      end
+    end
+  
+    def calc_projectiles
+      player.projectiles.map! do |p|
+        dx, dy = p.angle.vector 10
+        p.merge(x: p.x + dx, y: p.y + dy)
+      end
+  
+      calc_projectile_collisions level.walls + level.enemies + level.spawn_locations
+      player.projectiles.reject! { |p| p.at.elapsed_time > 10000 }
+      player.projectiles.reject! { |p| p.collided }
+      level.enemies.reject! { |e| e.damage > e.hp }
+      level.spawn_locations.reject! { |s| s.damage > s.hp }
+    end
+  
+    def calc_enemies
+      level.enemies.map! do |e|
+        dx =  0
+        dx =  1 if e.x < player.x
+        dx = -1 if e.x > player.x
+        dy =  0
+        dy =  1 if e.y < player.y
+        dy = -1 if e.y > player.y
+        future_e           = future_entity_position dx, dy, e
+        future_e_collision = future_collision e, future_e, level.enemies + level.walls
+        e.next_x = e.x
+        e.next_y = e.y
+        e.next_x = future_e_collision.x if !future_e_collision.dx_collision
+        e.next_y = future_e_collision.y if !future_e_collision.dy_collision
+        e
+      end
+  
+      level.enemies.map! do |e|
+        e.x = e.next_x
+        e.y = e.next_y
+        e
+      end
+  
+      level.enemies.each do |e|
+        player.damage += 1 if e.intersect_rect? player
+      end
+    end
+  
+    def calc_spawn_locations
+      level.spawn_locations.map! do |s|
+        s.merge(countdown: s.countdown - 1)
+      end
+      level.spawn_locations
+           .find_all { |s| s.countdown.neg? }
+           .each do |s|
+        s.countdown = s.rate
+        s.merge(countdown: s.rate)
+        new_enemy = create_enemy s
+        if !(level.enemies.find { |e| e.intersect_rect? new_enemy })
+          level.enemies << new_enemy
+        end
+      end
+    end
+  
+    def create_enemy spawn_location
+      to_cell(spawn_location.ordinal_x, spawn_location.ordinal_y).merge hp: 2
+    end
+  
+    def create_level level_template
+      {
+        walls:           level_template.walls.map { |w| to_cell(w.ordinal_x, w.ordinal_y).merge(w) },
+        enemies:         [],
+        spawn_locations: level_template.spawn_locations.map { |s| to_cell(s.ordinal_x, s.ordinal_y).merge(s) }
+      }
+    end
+  
+    def level_one_template
+      {
+        walls:           [{ ordinal_x: 25, ordinal_y: 20},
+                          { ordinal_x: 25, ordinal_y: 21},
+                          { ordinal_x: 25, ordinal_y: 22},
+                          { ordinal_x: 25, ordinal_y: 23}],
+        spawn_locations: [{ ordinal_x: 10, ordinal_y: 10, rate: 120, countdown: 0, hp: 5 }]
+      }
+    end
+  
+    def player
+      state.player ||= {}
+    end
+  
+    def level
+      state.level  ||= {}
+    end
+  
+    def future_collision entity, future_entity, others
+      dx_collision = others.find { |o| o != entity && (o.intersect_rect? future_entity.dx) }
+      dy_collision = others.find { |o| o != entity && (o.intersect_rect? future_entity.dy) }
+  
+      {
+        dx_collision: dx_collision,
+        x: future_entity.dx.x,
+        dy_collision: dy_collision,
+        y: future_entity.dy.y
+      }
+    end
+  
+    def future_entity_position dx, dy, entity
+      {
+        dx:   entity.merge(x: entity.x + dx),
+        dy:   entity.merge(y: entity.y + dy),
+        both: entity.merge(x: entity.x + dx, y: entity.y + dy)
+      }
+    end
+  
+    def future_player_position  dx, dy
+      future_entity_position dx, dy, player
+    end
+  
+    def to_cell ordinal_x, ordinal_y
+      { x: ordinal_x * 16, y: ordinal_y * 16, w: 16, h: 16 }
+    end
+  end
+  
+  def tick args
+    $game ||= Game.new
+    $game.args = args
+    $game.tick
+  end
+  
+  $gtk.reset
+  $game = nil
+
+#+end_src
+
+*** Fighting - Special Move Inputs - main.rb
+#+begin_src ruby
+  # ./samples/99_genre_fighting/01_special_move_inputs/app/main.rb
+  def tick args
+    #tick_instructions args, "Use LEFT and RIGHT arrow keys to move and SPACE to jump."
+    defaults args
+    render args
+    input args
+    calc args
+  end
+  
+  # sets default values and creates empty collections
+  # initialization only happens in the first frame
+  def defaults args
+    fiddle args
+  
+    args.state.tick_count = args.state.tick_count
+    args.state.bridge_top = 128
+    args.state.player.x  ||= 0                        # initializes player's properties
+    args.state.player.y  ||= args.state.bridge_top
+    args.state.player.w  ||= 64
+    args.state.player.h  ||= 64
+    args.state.player.dy ||= 0
+    args.state.player.dx ||= 0
+    args.state.player.r  ||= 0
+    args.state.game_over_at ||= 0
+    args.state.animation_time ||=0
+  
+    args.state.timeleft ||=0
+    args.state.timeright ||=0
+    args.state.lastpush ||=0
+  
+    args.state.inputlist ||=  ["j","k","l"]
+  end
+  
+  # sets enemy, player, hammer values
+  def fiddle args
+    args.state.gravity                     = -0.5
+    args.state.player_jump_power           = 10      # sets player values
+    args.state.player_jump_power_duration  = 5
+    args.state.player_max_run_speed        = 20
+    args.state.player_speed_slowdown_rate  = 0.9
+    args.state.player_acceleration         = 0.9
+  end
+  
+  # outputs objects onto the screen
+  def render args
+    if (args.state.player.dx < 0.01) && (args.state.player.dx > -0.01)
+      args.state.player.dx = 0
+    end
+  
+    #move list
+    (args.layout.rect_group row: 0, col_from_right: 8, drow: 0.3,
+                            merge: { vertical_alignment_enum: 0, size_enum: -2 },
+                            group: [
+                              { text: "move:             WASD" },
+                              { text: "jump:             Space" },
+                              { text: "attack forwards:  J (while on ground" },
+                              { text: "attack upwards:   K (while on groud)" },
+                              { text: "attack backwards: J (while on ground and holding A)" },
+                              { text: "attack downwards: K (while in air)" },
+                              { text: "dash attack:      J, K in quick succession." },
+                              { text: "shield: hold      J, K at the same time." },
+                              { text: "dash backwards:   A, A in quick succession." },
+                            ]).into args.outputs.labels
+  
+    # registered moves
+    args.outputs.labels << { x: 0.to_layout_col,
+                             y: 0.to_layout_row,
+                             text: "input history",
+                             size_enum: -2,
+                             vertical_alignment_enum: 0 }
+  
+    (args.state.inputlist.take(5)).map do |s|
+      { text: s, size_enum: -2, vertical_alignment_enum: 0 }
+    end.yield_self do |group|
+      (args.layout.rect_group row: 0.3, col: 0, drow: 0.3, group: group).into args.outputs.labels
+    end
+  
+  
+    #sprites
+    player = [args.state.player.x, args.state.player.y,
+              args.state.player.w, args.state.player.h,
+              "sprites/square/white.png",
+              args.state.player.r]
+  
+    playershield = [args.state.player.x - 20, args.state.player.y - 10,
+                    args.state.player.w + 20, args.state.player.h + 20,
+                    "sprites/square/blue.png",
+                    args.state.player.r,
+                    0]
+  
+    playerjab = [args.state.player.x + 32, args.state.player.y,
+                 args.state.player.w, args.state.player.h,
+                 "sprites/isometric/indigo.png",
+                 args.state.player.r,
+                 0]
+  
+    playerupper = [args.state.player.x, args.state.player.y + 32,
+                   args.state.player.w, args.state.player.h,
+                   "sprites/isometric/indigo.png",
+                   args.state.player.r+90,
+                   0]
+  
+    if ((args.state.tick_count - args.state.lastpush) <= 15)
+      if (args.state.inputlist[0] == "<<")
+        player = [args.state.player.x, args.state.player.y,
+                  args.state.player.w, args.state.player.h,
+                  "sprites/square/yellow.png", args.state.player.r]
+      end
+  
+      if (args.state.inputlist[0] == "shield")
+        player = [args.state.player.x, args.state.player.y,
+                  args.state.player.w, args.state.player.h,
+                  "sprites/square/indigo.png", args.state.player.r]
+  
+        playershield = [args.state.player.x - 10, args.state.player.y - 10,
+                        args.state.player.w + 20, args.state.player.h + 20,
+                        "sprites/square/blue.png", args.state.player.r, 50]
+      end
+  
+      if (args.state.inputlist[0] == "back-attack")
+        playerjab = [args.state.player.x - 20, args.state.player.y,
+                     args.state.player.w - 10, args.state.player.h,
+                     "sprites/isometric/indigo.png", args.state.player.r, 255]
+      end
+  
+      if (args.state.inputlist[0] == "forward-attack")
+        playerjab = [args.state.player.x + 32, args.state.player.y,
+                     args.state.player.w, args.state.player.h,
+                     "sprites/isometric/indigo.png", args.state.player.r, 255]
+      end
+  
+      if (args.state.inputlist[0] == "up-attack")
+        playerupper = [args.state.player.x, args.state.player.y + 32,
+                       args.state.player.w, args.state.player.h,
+                       "sprites/isometric/indigo.png", args.state.player.r + 90, 255]
+      end
+  
+      if (args.state.inputlist[0] == "dair")
+        playerupper = [args.state.player.x, args.state.player.y - 32,
+                       args.state.player.w, args.state.player.h,
+                       "sprites/isometric/indigo.png", args.state.player.r + 90, 255]
+      end
+  
+      if (args.state.inputlist[0] == "dash-attack")
+        playerupper = [args.state.player.x, args.state.player.y + 32,
+                       args.state.player.w, args.state.player.h,
+                       "sprites/isometric/violet.png", args.state.player.r + 90, 255]
+  
+        playerjab = [args.state.player.x + 32, args.state.player.y,
+                     args.state.player.w, args.state.player.h,
+                     "sprites/isometric/violet.png", args.state.player.r, 255]
+      end
+    end
+  
+    args.outputs.sprites << playerjab
+    args.outputs.sprites << playerupper
+    args.outputs.sprites << player
+    args.outputs.sprites << playershield
+  
+    args.outputs.solids << 20.map_with_index do |i| # uses 20 squares to form bridge
+      [i * 64, args.state.bridge_top - 64, 64, 64]
+    end
+  end
+  
+  # Performs calculations to move objects on the screen
+  def calc args
+    # Since velocity is the change in position, the change in x increases by dx. Same with y and dy.
+    args.state.player.x  += args.state.player.dx
+    args.state.player.y  += args.state.player.dy
+  
+    # Since acceleration is the change in velocity, the change in y (dy) increases every frame
+    args.state.player.dy += args.state.gravity
+  
+    # player's y position is either current y position or y position of top of
+    # bridge, whichever has a greater value
+    # ensures that the player never goes below the bridge
+    args.state.player.y  = args.state.player.y.greater(args.state.bridge_top)
+  
+    # player's x position is either the current x position or 0, whichever has a greater value
+    # ensures that the player doesn't go too far left (out of the screen's scope)
+    args.state.player.x  = args.state.player.x.greater(0)
+  
+    # player is not falling if it is located on the top of the bridge
+    args.state.player.falling = false if args.state.player.y == args.state.bridge_top
+    #args.state.player.rect = [args.state.player.x, args.state.player.y, args.state.player.h, args.state.player.w] # sets definition for player
+  end
+  
+  # Resets the player by changing its properties back to the values they had at initialization
+  def reset_player args
+    args.state.player.x = 0
+    args.state.player.y = args.state.bridge_top
+    args.state.player.dy = 0
+    args.state.player.dx = 0
+    args.state.enemy.hammers.clear # empties hammer collection
+    args.state.enemy.hammer_queue.clear # empties hammer_queue
+    args.state.game_over_at = args.state.tick_count # game_over_at set to current frame (or passage of time)
+  end
+  
+  # Processes input from the user to move the player
+  def input args
+    if args.state.inputlist.length > 5
+      args.state.inputlist.pop
+    end
+  
+    should_process_special_move = (args.inputs.keyboard.key_down.j)           ||
+                                  (args.inputs.keyboard.key_down.k)           ||
+                                  (args.inputs.keyboard.key_down.a)           ||
+                                  (args.inputs.keyboard.key_down.d)           ||
+                                  (args.inputs.controller_one.key_down.y)     ||
+                                  (args.inputs.controller_one.key_down.x)     ||
+                                  (args.inputs.controller_one.key_down.left)  ||
+                                  (args.inputs.controller_one.key_down.right)
+  
+    if (should_process_special_move)
+      if (args.inputs.keyboard.key_down.j && args.inputs.keyboard.key_down.k) ||
+         (args.inputs.controller_one.key_down.x && args.inputs.controller_one.key_down.y)
+        args.state.inputlist.unshift("shield")
+      elsif (args.inputs.keyboard.key_down.k || args.inputs.controller_one.key_down.y) &&
+            (args.state.inputlist[0] == "forward-attack") && ((args.state.tick_count - args.state.lastpush) <= 15)
+        args.state.inputlist.unshift("dash-attack")
+        args.state.player.dx = 20
+      elsif (args.inputs.keyboard.key_down.j && args.inputs.keyboard.a) ||
+            (args.inputs.controller_one.key_down.x && args.inputs.controller_one.key_down.left)
+        args.state.inputlist.unshift("back-attack")
+      elsif ( args.inputs.controller_one.key_down.x || args.inputs.keyboard.key_down.j)
+        args.state.inputlist.unshift("forward-attack")
+      elsif (args.inputs.keyboard.key_down.k || args.inputs.controller_one.key_down.y) &&
+            (args.state.player.y > 128)
+        args.state.inputlist.unshift("dair")
+      elsif (args.inputs.keyboard.key_down.k || args.inputs.controller_one.key_down.y)
+        args.state.inputlist.unshift("up-attack")
+      elsif (args.inputs.controller_one.key_down.left || args.inputs.keyboard.key_down.a) &&
+            (args.state.inputlist[0] == "<") &&
+            ((args.state.tick_count - args.state.lastpush) <= 10)
+        args.state.inputlist.unshift("<<")
+        args.state.player.dx = -15
+      elsif (args.inputs.controller_one.key_down.left || args.inputs.keyboard.key_down.a)
+        args.state.inputlist.unshift("<")
+        args.state.timeleft = args.state.tick_count
+      elsif (args.inputs.controller_one.key_down.right || args.inputs.keyboard.key_down.d)
+        args.state.inputlist.unshift(">")
+      end
+  
+      args.state.lastpush = args.state.tick_count
+    end
+  
+    if args.inputs.keyboard.space || args.inputs.controller_one.r2   # if the user presses the space bar
+      args.state.player.jumped_at ||= args.state.tick_count # jumped_at is set to current frame
+  
+      # if the time that has passed since the jump is less than the player's jump duration and
+      # the player is not falling
+      if args.state.player.jumped_at.elapsed_time < args.state.player_jump_power_duration && !args.state.player.falling
+        args.state.player.dy = args.state.player_jump_power # change in y is set to power of player's jump
+      end
+    end
+  
+    # if the space bar is in the "up" state (or not being pressed down)
+    if args.inputs.keyboard.key_up.space || args.inputs.controller_one.key_up.r2
+      args.state.player.jumped_at = nil # jumped_at is empty
+      args.state.player.falling = true # the player is falling
+    end
+  
+    if args.inputs.left # if left key is pressed
+      if args.state.player.dx < -5
+        args.state.player.dx = args.state.player.dx
+      else
+        args.state.player.dx = -5
+      end
+  
+    elsif args.inputs.right # if right key is pressed
+      if args.state.player.dx > 5
+        args.state.player.dx = args.state.player.dx
+      else
+        args.state.player.dx = 5
+      end
+    else
+      args.state.player.dx *= args.state.player_speed_slowdown_rate # dx is scaled down
+    end
+  
+    if ((args.state.player.dx).abs > 5) #&& ((args.state.tick_count - args.state.lastpush) <= 10)
+      args.state.player.dx *= 0.95
+    end
+  end
+  
+  def tick_instructions args, text, y = 715
+    return if args.state.key_event_occurred
+    if args.inputs.mouse.click ||
+       args.inputs.keyboard.directional_vector ||
+       args.inputs.keyboard.key_down.enter ||
+       args.inputs.keyboard.key_down.space ||
+       args.inputs.keyboard.key_down.escape
+      args.state.key_event_occurred = true
+    end
+  
+    args.outputs.debug << [0, y - 50, 1280, 60].solid
+    args.outputs.debug << [640, y, text, 1, 1, 255, 255, 255].label
+    args.outputs.debug << [640, y - 25, "(click to dismiss instructions)" , -2, 1, 255, 255, 255].label
+  end
+
+#+end_src
+
 *** Lowrez - Nokia 3310 - main.rb
 #+begin_src ruby
   # ./samples/99_genre_lowrez/nokia_3310/app/main.rb
@@ -25867,7 +27587,7 @@ Follows is a source code listing for all files that have been open sourced. This
         text: text,
         size_enum: -1.5,
         r: 255, g: 255, b: 255
-      }.label
+      }.label!
     end
   
     args.outputs.debug << {
@@ -25877,7 +27597,7 @@ Follows is a source code listing for all files that have been open sourced. This
       size_enum: -0.5,
       alignment_enum: 1,
       r: 255, g: 255, b: 255
-    }.label
+    }.label!
   end
   
   def snake_demo args
@@ -26129,7 +27849,7 @@ Follows is a source code listing for all files that have been open sourced. This
               g: 240,
               b: 216,
               a: 100
-            }.line
+            }.line!
           end
   
           (NOKIA_WIDTH + 1).map_with_index do |i|
@@ -26142,7 +27862,7 @@ Follows is a source code listing for all files that have been open sourced. This
               g: 240,
               b: 216,
               a: 100
-            }.line
+            }.line!
           end
   
           @args.state.overlay_rendered = true
@@ -26894,7 +28614,7 @@ Follows is a source code listing for all files that have been open sourced. This
           g: 128,
           b: 128,
           a: 80
-        }.line
+        }.line!
   
         args.outputs.static_debug << {
           x:  LOWREZ_X_OFFSET + (i * 10),
@@ -26905,7 +28625,7 @@ Follows is a source code listing for all files that have been open sourced. This
           g: 128,
           b: 128,
           a: 80
-        }.line
+        }.line!
       end
     end
   
@@ -26932,7 +28652,7 @@ Follows is a source code listing for all files that have been open sourced. This
         y: 720 - (i * 20),
         text: text,
         size_enum: -1.5
-      }.label
+      }.label!
     end
   
     args.outputs.debug << {
@@ -26941,7 +28661,7 @@ Follows is a source code listing for all files that have been open sourced. This
       text: "INFO: dev mode is currently enabled. Comment out the invocation of ~render_debug~ within the ~tick~ method to hide the debug layer.",
       size_enum: -0.5,
       alignment_enum: 1
-    }.label
+    }.label!
   end
   
   $gtk.reset
@@ -35432,58 +37152,21 @@ Follows is a source code listing for all files that have been open sourced. This
     class Args
       include ArgsDeprecated
       include Serialize
-  
-      # Contains information related to input devices and input events.
-      #
-      # @return [Inputs]
       attr_accessor :inputs
-  
-      # Contains the means to interact with output devices such as the screen.
-      #
-      # @return [Outputs]
       attr_accessor :outputs
-  
-      # Contains the means to interact with the audio mixer.
-      #
-      # @return [Hash]
       attr_accessor :audio
-  
-      # Contains display size information to assist in positioning things on the screen.
-      #
-      # @return [Grid]
       attr_accessor :grid
-  
-      # Provides access to game play recording facilities within Game Toolkit.
-      #
-      # @return [Recording]
       attr_accessor :recording
-  
-      # Gives you access to geometry related functions.
-      #
-      # @return [Geometry]
       attr_accessor :geometry
-  
       attr_accessor :fn
-  
-      # This is where you'll put state associated with your video game.
-      #
-      # @return [OpenEntity]
       attr_accessor :state
-  
-      # Gives you access to the top level DragonRuby runtime.
-      #
-      # @return [Runtime]
+      attr_accessor :temp_state
       attr_accessor :runtime
       alias_method :gtk, :runtime
-  
       attr_accessor :passes
-  
       attr_accessor :wizards
-  
       attr_accessor :layout
-  
       attr_accessor :easing
-  
       attr_accessor :string
   
       def initialize runtime, recording
@@ -35492,6 +37175,7 @@ Follows is a source code listing for all files that have been open sourced. This
         @audio = {}
         @passes = []
         @state = OpenEntity.new
+        @temp_state = OpenEntity.new
         @state.tick_count = -1
         @runtime = runtime
         @recording = recording
@@ -35521,11 +37205,12 @@ Follows is a source code listing for all files that have been open sourced. This
   
       def serialize
         {
-          state: state.as_hash,
-          inputs: inputs.serialize,
-          passes: passes.serialize,
-          outputs: outputs.serialize,
-          grid: grid.serialize
+          state:      state.as_hash,
+          temp_state: temp_state.as_hash,
+          inputs:     inputs.serialize,
+          passes:     passes.serialize,
+          outputs:    outputs.serialize,
+          grid:       grid.serialize
         }
       end
   
@@ -35691,10 +37376,10 @@ Follows is a source code listing for all files that have been open sourced. This
   
   class Assert
     def custom_assertion actual, expected, message = nil
-      # this tell Game Toolkit that an assertion was performed (so that the test isn't marked inconclusive).
+      # this tells Game Toolkit that an assertion was performed (so that the test isn't marked inconclusive).
       @assertion_performed = true
   
-      # perform your custom logic here and rais an exception to denote a failure.
+      # perform your custom logic here and raise an exception to denote a failure.
   
       raise "Some Error. #{message}."
     end
@@ -35704,14 +37389,14 @@ Follows is a source code listing for all files that have been open sourced. This
       attr :assertion_performed
   
   =begin
-  Us this if you are throwing your own exceptions and you want to mark the tests as ran (so that it wont be marked as inconclusive).
+  Use this if you are throwing your own exceptions and you want to mark the tests as ran (so that it wont be marked as inconclusive).
   =end
       def ok!
         @assertion_performed = true
       end
   
   =begin
-  Assert if a value is a thruthy value. All assert method take an optional final parameter that is the message to display to the user.
+  Assert if a value is a truthy value. All assert methods take an optional final parameter that is the message to display to the user.
   
   @example
   
@@ -35765,7 +37450,7 @@ Follows is a source code listing for all files that have been open sourced. This
         @assertion_performed = true
         if actual != expected
           actual_string = "#{actual}#{actual.nil? ? " (nil) " : " " }".strip
-          message = "actual:\n#{actual_string}\n\ndid not equal\n\nexpected:\n#{expected}.\n#{message}"
+          message = "actual:\n#{actual_string}\n\ndid not equal\n\nexpected:\n#{expected}\n#{message}"
           raise message
         end
         nil
@@ -35775,7 +37460,7 @@ Follows is a source code listing for all files that have been open sourced. This
         @assertion_performed = true
         if actual == expected
           actual_string = "#{actual}#{actual.nil? ? " (nil) " : " " }".strip
-          message = "actual:\n#{actual_string}\n\nequaled\n\nexpected:\n#{expected}.\n#{message}"
+          message = "actual:\n#{actual_string}\n\nequaled\n\nexpected:\n#{expected}\n#{message}"
           raise message
         end
         nil
@@ -35830,6 +37515,10 @@ Follows is a source code listing for all files that have been open sourced. This
       args.state
     end
   
+    def temp_state
+      args.temp_state
+    end
+  
     def inputs
       args.inputs
     end
@@ -35857,6 +37546,14 @@ Follows is a source code listing for all files that have been open sourced. This
     def layout
       args.layout
     end
+  
+    def new_entity entity_type, init_hash = nil, &block
+      args.state.new_entity entity_type, init_hash, &block
+    end
+  
+    def new_entity_strict entity_type, init_hash = nil, &block
+      args.state.new_entity_strict entity_type, init_hash, &block
+    end
   end
 
 #+end_src
@@ -35903,7 +37600,7 @@ Follows is a source code listing for all files that have been open sourced. This
     attr_accessor :x, :y, :w, :h, :path, :angle, :a, :r, :g, :b, :tile_x,
                   :tile_y, :tile_w, :tile_h, :flip_horizontally,
                   :flip_vertically, :angle_anchor_x, :angle_anchor_y, :id,
-                  :source_x, :source_y, :source_w, :source_h
+                  :source_x, :source_y, :source_w, :source_h, :blendmode_enum
   
     def primitive_marker
       :sprite
@@ -35948,7 +37645,7 @@ Follows is a source code listing for all files that have been open sourced. This
                     :font_style, :menu
   
       def initialize
-        @font_style = FontStyle.new(font: 'font.ttf', size_enum: -1, line_height: 1.1)
+        @font_style = FontStyle.new(font: 'font.ttf', size_enum: -1.5, line_height: 1.1)
         @menu = Menu.new self
         @disabled = false
         @log_offset = 0
@@ -35968,6 +37665,8 @@ Follows is a source code listing for all files that have been open sourced. This
         @text_color = Color.new [255, 255, 255]
         @error_color = Color.new [200, 50, 50]
         @header_color = Color.new [100, 200, 220]
+        @code_color = Color.new [210, 168, 255]
+        @comment_color    = Color.new [0, 200, 100]
         @animation_duration = 1.seconds
         @shown_at = -1
         load_history
@@ -36242,6 +37941,8 @@ Follows is a source code listing for all files that have been open sourced. This
   
           if cmd == 'quit' || cmd == ':wq' || cmd == ':q!' || cmd == ':q' || cmd == ':wqa'
             $gtk.request_quit
+          elsif cmd.start_with? ':'
+            send ((cmd.gsub '-', '_').gsub ':', '')
           else
             puts "-> #{cmd}"
             begin
@@ -36250,13 +37951,19 @@ Follows is a source code listing for all files that have been open sourced. This
               if $results.nil?
                 puts "=> nil"
               elsif $results == :console_silent_eval
+                # do nothing since the console is silent
               else
                 puts "=> #{$results}"
               end
               @last_command_errored = false
             rescue Exception => e
               try_search_docs e
-              puts  "* EXCEPTION: #{e}"
+              # if an exception is thrown and the bactrace includes something helpful, then show it
+              if (e.backtrace || []).first && (e.backtrace.first.include? "(eval)")
+                puts  "* EXCEPTION: #{e}"
+              else
+                puts  "* EXCEPTION: #{e}\n#{e.__backtrace_to_org__}"
+              end
             end
           end
         end
@@ -36483,6 +38190,11 @@ Follows is a source code listing for all files that have been open sourced. This
         end
   
         render_log_offset args
+  
+        args.outputs.reserved << { x: 10.from_right, y: @bottom + 10,
+                                   text: "Press CTRL+g or ESCAPE to clear the prompt.",
+                                   vertical_alignment_enum: 0,
+                                   alignment_enum: 2, r: 80, g: 80, b: 80 }.label!
       end
   
       def render_log_offset args
@@ -36505,7 +38217,7 @@ Follows is a source code listing for all files that have been open sourced. This
       end
   
       def include_subdued_markers? text
-        include_any_words? text, subdued_markers
+        (text.start_with? "* INFO: ") && (include_any_words? text, subdued_markers)
       end
   
       def include_any_words? text, words
@@ -36651,8 +38363,32 @@ Follows is a source code listing for all files that have been open sourced. This
         (log_entry.start_with? "**** ")
       end
   
+      def code? log_entry
+        (just_symbol? log_entry) || (codeblock_marker? log_entry)
+      end
+  
+      def just_symbol? log_entry
+        scrubbed = log_entry.gsub("*", "").strip
+        (scrubbed.start_with? ":") && (!scrubbed.include? " ") && (!scrubbed.include? "=>")
+      end
+  
+      def code_comment? log_entry
+        return true  if log_entry.strip.start_with?("# ")
+        return false
+      end
+  
+      def codeblock_marker? log_entry
+        return true if log_entry.strip.start_with?("#+begin_src")
+        return true if log_entry.strip.start_with?("#+end_src")
+        return false
+      end
+  
       def color_for_log_entry(log_entry)
-        if include_row_marker? log_entry
+        if code? log_entry
+          @code_color
+        elsif code_comment? log_entry
+          @comment_color
+        elsif include_row_marker? log_entry
           @text_color
         elsif include_error_marker? log_entry
           @error_color
@@ -36727,6 +38463,10 @@ Follows is a source code listing for all files that have been open sourced. This
           @color
         end
   
+        def to_s
+          "GTK::Console::Color #{to_h}"
+        end
+  
         def to_h
           { r: @color[0], g: @color[1], b: @color[2], a: @color[3] }
         end
@@ -36774,7 +38514,7 @@ Follows is a source code listing for all files that have been open sourced. This
             size_enum: size_enum,
             alignment_enum: alignment_enum,
             **color.to_h,
-          }.label
+          }.label!
         end
       end
     end
@@ -36838,7 +38578,7 @@ Follows is a source code listing for all files that have been open sourced. This
   
         def itch_wizard_clicked
           @console.scroll_to_bottom
-          $wizards.itch.start
+          $wizards.itch.restart
         end
   
         def docs_clicked
@@ -36863,6 +38603,7 @@ Follows is a source code listing for all files that have been open sourced. This
             @buttons = [
               (button id: :record,      row: 0, col:   9, text: "record gameplay",       method: :record_clicked),
               (button id: :replay,      row: 0, col:  10, text: "start replay",          method: :replay_clicked),
+              *custom_buttons
             ]
           elsif @menu_shown == :hidden
             @buttons = [
@@ -36921,8 +38662,8 @@ Follows is a source code listing for all files that have been open sourced. This
             method: method
           }.let do |entity|
             primitives = []
-            primitives << entity[:rect].merge(a: 164).solid
-            primitives << entity[:rect].merge(r: 255, g: 255, b: 255).border
+            primitives << entity[:rect].solid!(a: 164)
+            primitives << entity[:rect].border!(r: 255, g: 255, b: 255)
             primitives << text.wrapped_lines(5)
                               .map_with_index do |l, i|
                                 [
@@ -37023,14 +38764,14 @@ Follows is a source code listing for all files that have been open sourced. This
           return if @cursor_position.zero?
   
           new_pos = @cursor_position - 1
-          (is_word_boundary? @current_input_str[new_pos]) ? 
+          (is_word_boundary? @current_input_str[new_pos]) ?
               (new_pos -= 1 until !(is_word_boundary? @current_input_str[new_pos - 1]) || new_pos.zero?):
               (new_pos -= 1 until (is_word_boundary? @current_input_str[new_pos - 1]) || new_pos.zero?)
   
           @cursor_position = new_pos
           update_cursor_position_px
         end
-          
+  
         def move_cursor_right
           @cursor_position += 1 if @cursor_position < current_input_str.length
           update_cursor_position_px
@@ -37043,7 +38784,7 @@ Follows is a source code listing for all files that have been open sourced. This
           (is_word_boundary? @current_input_str[new_pos]) ?
               (new_pos += 1 until !(is_word_boundary? @current_input_str[new_pos]) || (new_pos.equal? str_len)):
               (new_pos += 1 until (is_word_boundary? @current_input_str[new_pos]) || (new_pos.equal? str_len))
-          
+  
           @cursor_position = new_pos
           update_cursor_position_px
         end
@@ -37126,17 +38867,17 @@ Follows is a source code listing for all files that have been open sourced. This
             "#{" " * (string_width.length - c.length) } #{c} |"
           end.join
   
-          # remove seperators between empty values
+          # remove separators between empty values
           formated_row = formated_row.gsub("  |  ", "     ")
   
           puts formated_row
         end
   
-        def pretty_print_row_seperator string_width, cell_width, column_width, columns
+        def pretty_print_row_separator string_width, cell_width, column_width, columns
           # this is a joint: +--------
           column_joint = "+#{"-" * cell_width}"
   
-          # multiple joints create a row seperator: +----+----+
+          # multiple joints create a row separator: +----+----+
           puts (column_joint * columns) + "+"
         end
   
@@ -37145,12 +38886,12 @@ Follows is a source code listing for all files that have been open sourced. This
           args.outputs.reserved << (@cursor_color.to_h.merge x: x + @cursor_position_px + 0.5,
                                                              y: y + 5,
                                                              x2: x + @cursor_position_px + 0.5,
-                                                             y2: y + @font_style.letter_size.y + 5)
+                                                             y2: y + @font_style.letter_size.y + 4)
   
           args.outputs.reserved << (@cursor_color.to_h.merge x: x + @cursor_position_px + 1,
                                                              y: y + 5,
                                                              x2: x + @cursor_position_px + 1,
-                                                             y2: y + @font_style.letter_size.y + 5)
+                                                             y2: y + @font_style.letter_size.y + 4)
   
           # debugging rectangle for string
           # args.outputs.reserved << (@cursor_color.to_h.merge x: x,
@@ -37778,7 +39519,7 @@ Follows is a source code listing for all files that have been open sourced. This
           :l1, :r1,
           :l2, :r2,
           :l3, :r3,
-          :start, :select,
+          :start, :select, :home,
           :directional_up, :directional_down, :directional_left, :directional_right
         ].freeze
   
@@ -37786,6 +39527,22 @@ Follows is a source code listing for all files that have been open sourced. This
           attr label
         end
   
+        def back
+          @select
+        end
+  
+        def back= value
+          @select = value
+        end
+  
+        def guide
+          @home
+        end
+  
+        def guide= value
+          @home = value
+        end
+  
         # Activate a key.
         #
         # @return [void]
@@ -37834,7 +39591,7 @@ Follows is a source code listing for all files that have been open sourced. This
   
         error_message = <<-S
   * ERROR
-  The GTK::DirectionalKeys module should only be included in objects that respond to the following api heirarchy:
+  The GTK::DirectionalKeys module should only be included in objects that respond to the following api hierarchy:
   
   - (#{ directional_methods.join("|") })
   - key_held.(#{ directional_methods.join("|") })
@@ -37891,6 +39648,12 @@ Follows is a source code listing for all files that have been open sourced. This
         end
       end
   
+      def directional_angle
+        return nil unless directional_vector
+  
+        Math.atan2(up_down, left_right).to_degrees
+      end
+  
       def method_missing m, *args
         # combine the key with ctrl_
         if m.to_s.start_with?("ctrl_")
@@ -38123,6 +39886,22 @@ Follows is a source code listing for all files that have been open sourced. This
   
   module GTK
     module Geometry
+      def self.rotate_point point, angle, around = nil
+        s = Math.sin a.to_radians
+        c = Math.cos a.to_radians
+        px = point.x
+        py = point.y
+        cx = 0
+        cy = 0
+        if around
+          cx = around.x
+          cy = around.y
+        end
+  
+        point.merge(x: ((px - cx) * c - (py - cy) * s) + cx,
+                    y: ((px - cx) * s + (py - cy) * c) + cy)
+      end
+  
       # Returns f(t) for a cubic Bezier curve.
       def self.cubic_bezier t, a, b, c, d
         s  = 1 - t
@@ -38204,7 +39983,7 @@ Follows is a source code listing for all files that have been open sourced. This
       rescue Exception => e
         raise e, <<-S
   * ERROR:
-  center_inside_rect for self #{self} and other_rect #{other_rect}. Failed with exception #{e}.
+  center_inside_rect for self #{self} and other_rect #{other_rect}.\n#{e}.
   S
       end
   
@@ -38221,7 +40000,7 @@ Follows is a source code listing for all files that have been open sourced. This
       rescue Exception => e
         raise e, <<-S
   * ERROR:
-  center_inside_rect_x for self #{self} and other_rect #{other_rect}. Failed with exception #{e}.
+  center_inside_rect_x for self #{self} and other_rect #{other_rect}.\n#{e}.
   S
       end
   
@@ -38238,7 +40017,7 @@ Follows is a source code listing for all files that have been open sourced. This
       rescue Exception => e
         raise e, <<-S
   * ERROR:
-  center_inside_rect_y for self #{self} and other_rect #{other_rect}. Failed with exception #{e}.
+  center_inside_rect_y for self #{self} and other_rect #{other_rect}.\n#{e}.
   S
       end
   
@@ -38247,7 +40026,7 @@ Follows is a source code listing for all files that have been open sourced. This
       end
   
   
-      # Returns a primitive that is anchored/repositioned based off its retangle.
+      # Returns a primitive that is anchored/repositioned based off its rectangle.
       # @gtk
       def anchor_rect anchor_x, anchor_y
         current_w = self.w
@@ -38383,10 +40162,10 @@ Follows is a source code listing for all files that have been open sourced. This
   
       # @gtk
       def self.intersect_rect? rect_one, rect_two, tolerance = 0.1
-        return false if rect_one.right - tolerance < rect_two.left + tolerance
-        return false if rect_one.left + tolerance > rect_two.right - tolerance
-        return false if rect_one.top - tolerance < rect_two.bottom + tolerance
-        return false if rect_one.bottom + tolerance > rect_two.top - tolerance
+        return false if ((rect_one.x + rect_one.w) - tolerance) < (rect_two.x + tolerance)
+        return false if (rect_one.x + tolerance) > ((rect_two.x + rect_two.w) - tolerance)
+        return false if ((rect_one.y + rect_one.h) - tolerance) < (rect_two.y + tolerance)
+        return false if (rect_one.y + tolerance) > ((rect_two.y + rect_two.h) - tolerance)
         return true
       rescue Exception => e
         context_help_rect_one = (rect_one.__help_contract_implementation contract_intersect_rect?)[:not_implemented_methods]
@@ -38414,6 +40193,7 @@ Follows is a source code listing for all files that have been open sourced. This
   - rect_one: #{rect_one}
   - rect_two: #{rect_two}
   #{context_help}
+  \n#{e}
   S
       end
   
@@ -38424,14 +40204,14 @@ Follows is a source code listing for all files that have been open sourced. This
         y = y.shift_down(size * anchor_y)
         [x, y, size, size]
       rescue Exception => e
-        raise e, ":to_square failed for size: #{size} x: #{x} y: #{y} anchor_x: #{anchor_x} anchor_y: #{anchor_y}."
+        raise e, ":to_square failed for size: #{size} x: #{x} y: #{y} anchor_x: #{anchor_x} anchor_y: #{anchor_y}.\n#{e}"
       end
   
       # @gtk
       def self.distance point_one, point_two
         Math.sqrt((point_two.x - point_one.x)**2 + (point_two.y - point_one.y)**2)
       rescue Exception => e
-        raise e, ":distance failed for point_one: #{point_one} point_two #{point_two}."
+        raise e, ":distance failed for point_one: #{point_one} point_two #{point_two}.\n#{e}"
       end
   
       # @gtk
@@ -38440,31 +40220,34 @@ Follows is a source code listing for all files that have been open sourced. This
         d_x = end_point.x - start_point.x
         Math::PI.+(Math.atan2(d_y, d_x)).to_degrees
       rescue Exception => e
-        raise e, ":angle_from failed for start_point: #{start_point} end_point: #{end_point}."
+        raise e, ":angle_from failed for start_point: #{start_point} end_point: #{end_point}.\n#{e}"
       end
   
       # @gtk
       def self.angle_to start_point, end_point
         angle_from end_point, start_point
       rescue Exception => e
-        raise e, ":angle_to failed for start_point: #{start_point} end_point: #{end_point}."
+        raise e, ":angle_to failed for start_point: #{start_point} end_point: #{end_point}.\n#{e}"
       end
   
       # @gtk
       def self.point_inside_circle? point, circle_center_point, radius
         (point.x - circle_center_point.x) ** 2 + (point.y - circle_center_point.y) ** 2 < radius ** 2
       rescue Exception => e
-        raise e, ":point_inside_circle? failed for point: #{point} circle_center_point: #{circle_center_point} radius: #{radius}"
+        raise e, ":point_inside_circle? failed for point: #{point} circle_center_point: #{circle_center_point} radius: #{radius}.\n#{e}"
       end
   
       # @gtk
       def self.inside_rect? inner_rect, outer_rect, tolerance = 0.0
+        return nil if !inner_rect
+        return nil if !outer_rect
+  
         inner_rect.x     + tolerance >= outer_rect.x     - tolerance &&
-        inner_rect.right - tolerance <= outer_rect.right + tolerance &&
+        (inner_rect.x + inner_rect.w) - tolerance <= (outer_rect.x + outer_rect.w) + tolerance &&
         inner_rect.y     + tolerance >= outer_rect.y     - tolerance &&
-        inner_rect.top   - tolerance <= outer_rect.top   + tolerance
+        (inner_rect.y + inner_rect.h) - tolerance <= (outer_rect.y + outer_rect.h) + tolerance
       rescue Exception => e
-        raise e, ":inside_rect? failed for inner_rect: #{inner_rect} outer_rect: #{outer_rect}."
+        raise e, ":inside_rect? failed for inner_rect: #{inner_rect} outer_rect: #{outer_rect}.\n#{e}"
       end
   
       # @gtk
@@ -38499,7 +40282,7 @@ Follows is a source code listing for all files that have been open sourced. This
           return rect
         end
       rescue Exception => e
-        raise e, ":scale_rect_extended failed for rect: #{rect} percentage_x: #{percentage_x} percentage_y: #{percentage_y} anchors_x: #{anchor_x} anchor_y: #{anchor_y}."
+        raise e, ":scale_rect_extended failed for rect: #{rect} percentage_x: #{percentage_x} percentage_y: #{percentage_y} anchors_x: #{anchor_x} anchor_y: #{anchor_y}.\n#{e}"
       end
   
       # @gtk
@@ -38513,7 +40296,21 @@ Follows is a source code listing for all files that have been open sourced. This
                                      anchor_x: anchor_x,
                                      anchor_y: anchor_y
       rescue Exception => e
-        raise e, ":scale_rect failed for rect: #{rect} percentage: #{percentage} anchors [#{anchor_x} (x), #{anchor_y} (y)]."
+        raise e, ":scale_rect failed for rect: #{rect} percentage: #{percentage} anchors [#{anchor_x} (x), #{anchor_y} (y)].\n#{e}"
+      end
+  
+      def self.rect_to_line rect
+        l = rect.to_hash.line
+        l.merge(x2: l.x + l.w - 1,
+                y2: l.y + l.h)
+      end
+  
+      def self.rect_center_point rect
+        { x: rect.x + rect.w.half, y: rect.y + rect.h.half }
+      end
+  
+      def rect_center_point
+        Geometry.rect_center_point self
       end
     end # module Geometry
   end # module GTK
@@ -38710,6 +40507,14 @@ Follows is a source code listing for all files that have been open sourced. This
       def bottom_right
         [@right, @bottom].point
       end
+  
+      def x
+        0
+      end
+  
+      def y
+        0
+      end
     end
   end
 
@@ -38911,6 +40716,30 @@ Follows is a source code listing for all files that have been open sourced. This
         }
       end
   
+      def self.method_to_key_hash
+        return @method_to_key_hash if @method_to_key_hash
+        @method_to_key_hash = {}
+        string_representation_overrides ||= {
+          backspace: '\b'
+        }
+        char_to_method_hash.each do |k, v|
+          v.each do |vi|
+            t = { char_or_raw_key: k }
+  
+            if k.is_a? Numeric
+              t[:raw_key] = k
+              t[:string_representation] = "raw_key == #{k}"
+            else
+              t[:char] = k
+              t[:string_representation] = "\"#{k.strip}\""
+            end
+  
+            @method_to_key_hash[vi] = t
+          end
+        end
+        @method_to_key_hash
+      end
+  
       def self.char_to_method char, int = nil
         methods = char_to_method_hash[char] || char_to_method_hash[int]
         methods ? methods.dup : [char.to_sym || int]
@@ -39025,24 +40854,32 @@ Follows is a source code listing for all files that have been open sourced. This
       end
   
       def method_missing m, *args
-        begin
-          define_singleton_method(m) do
-            r = self.instance_variable_get("@#{m.without_ending_bang}".to_sym)
-            clear_key m
-            return r
-          end
+        if KeyboardKeys.method_to_key_hash[m.without_ending_bang]
+          begin
+            define_singleton_method(m) do
+              r = self.instance_variable_get("@#{m.without_ending_bang}".to_sym)
+              clear_key m
+              return r
+            end
   
-          return self.send m
-        rescue Exception => e
-          log_important "#{e}"
+            return self.send m
+          rescue Exception => e
+            log_important "#{e}"
+          end
         end
   
+        did_you_mean = KeyboardKeys.method_to_key_hash.find_all do |k, v|
+          k.to_s[0..1] == m.to_s[0..1]
+        end.map {|k, v| ":#{k} (#{v[:string_representation]})" }
+        did_you_mean_string = ""
+        did_you_mean_string = ". Did you mean #{did_you_mean.join ", "}?"
+  
         raise <<-S
   * ERROR:
-  There is no member on the keyboard called #{m}. Here is a to_s representation of what's available:
-  
-  #{KeyboardKeys.char_to_method_hash.map { |k, v| "[#{k} => #{v.join(",")}]" }.join("  ")}
+  #{KeyboardKeys.method_to_key_hash.map { |k, v| "** :#{k} #{v.string_representation}" }.join("\n")}
   
+  There is no key on the keyboard called :#{m}#{did_you_mean_string}.
+  Full list of available keys =:points_up:=.
   S
       end
   
@@ -39426,6 +41263,10 @@ Follows is a source code listing for all files that have been open sourced. This
           (controller_one && controller_one.directional_vector)
       end
   
+      def directional_angle
+        keyboard.directional_angle || (controller_one && controller_one.directional_angle)
+      end
+  
       # Returns a signal indicating right (`1`), left (`-1`), or neither ('0').
       #
       # @return [Integer]
@@ -39497,19 +41338,12 @@ Follows is a source code listing for all files that have been open sourced. This
 *** ios_wizard.rb
 #+begin_src ruby
   # ./dragon/ios_wizard.rb
+  # Contributors outside of DragonRuby who also hold Copyright: Michał Dudziński
   # Copyright 2019 DragonRuby LLC
   # MIT License
   # ios_wizard.rb has been released under MIT (*only this file*).
   
-  class WizardException < Exception
-    attr_accessor :console_primitives
-  
-    def initialize *console_primitives
-      @console_primitives = console_primitives
-    end
-  end
-  
-  class IOSWizard
+  class IOSWizard < Wizard
     def initialize
       @doctor_executed_at = 0
     end
@@ -39522,23 +41356,45 @@ Follows is a source code listing for all files that have been open sourced. This
       @steps ||= []
     end
   
-    def steps_development_build
+    def prerequisite_steps
       [
         :check_for_xcode,
         :check_for_brew,
         :check_for_certs,
-        :check_for_device,
-        :check_for_dev_profile,
+      ]
+    end
+  
+    def app_metadata_retrieval_steps
+      [
         :determine_team_identifier,
         :determine_app_name,
         :determine_app_id,
-        :blow_away_temp,
+      ]
+    end
+  
+    def steps_development_build
+      [
+        *prerequisite_steps,
+  
+        :check_for_device,
+        :check_for_dev_profile,
+  
+        *app_metadata_retrieval_steps,
+  
+        :clear_tmp_directory,
         :stage_app,
+  
         :development_write_info_plist,
+  
         :write_entitlements_plist,
         :compile_icons,
-        :create_payload_directory,
+        :clear_payload_directory,
+  
+        :create_payload_directory_dev,
+  
+        :create_payload,
         :code_sign_payload,
+  
         :create_ipa,
         :deploy
       ]
@@ -39546,20 +41402,27 @@ Follows is a source code listing for all files that have been open sourced. This
   
     def steps_production_build
       [
-        :check_for_xcode,
-        :check_for_brew,
-        :check_for_certs,
+        *prerequisite_steps,
+  
         :check_for_distribution_profile,
-        :determine_team_identifier,
-        :determine_app_name,
-        :determine_app_id,
-        :blow_away_temp,
+        :determine_app_version,
+  
+        *app_metadata_retrieval_steps,
+  
+        :clear_tmp_directory,
         :stage_app,
+  
         :production_write_info_plist,
+  
         :write_entitlements_plist,
         :compile_icons,
-        :create_payload_directory,
+        :clear_payload_directory,
+  
+        :create_payload_directory_prod,
+  
+        :create_payload,
         :code_sign_payload,
+  
         :create_ipa,
         :print_publish_help
       ]
@@ -39595,6 +41458,8 @@ Follows is a source code listing for all files that have been open sourced. This
       @steps = steps_development_build
       @steps = steps_production_build if @production_build
       @certificate_name = nil
+      @app_version = opts[:version]
+      @app_version = "1.0" if @opts[:env] == :dev && !@app_version
       init_wizard_status
       log_info "Starting iOS Wizard so we can deploy to your device."
       @start_at = Kernel.global_tick_count
@@ -39616,8 +41481,10 @@ Follows is a source code listing for all files that have been open sourced. This
         log "=" * $console.console_text_width
       else
         log_error e.to_s
+        log e.__backtrace_to_org__
       end
   
+      init_wizard_status
       $console.set_command "$wizards.ios.start env: :#{@opts[:env]}"
     end
   
@@ -39724,13 +41591,66 @@ Follows is a source code listing for all files that have been open sourced. This
       return "profiles/development.mobileprovision"
     end
   
+    def ios_metadata_template
+      <<-S
+  # ios_metadata.txt is used by the Pro version of DragonRuby Game Toolkit to create iOS apps.
+  # Information about the Pro version can be found at: http://dragonruby.org/toolkit/game#purchase
+  
+  # teamid needs to be set to your assigned Team Id which can be found at https://developer.apple.com/account/#/membership/
+  teamid=
+  # appid needs to be set to your application identifier which can be found at https://developer.apple.com/account/resources/identifiers/list
+  appid=
+  # appname is the name you want to show up underneath the app icon on the device. Keep it under 10 characters.
+  appname=
+  S
+    end
+  
+    def ios_metadata
+      contents = $gtk.read_file 'metadata/ios_metadata.txt'
+  
+      if !contents
+        $gtk.write_file 'metadata/ios_metadata.txt', ios_metadata_template
+        contents = $gtk.read_file 'metadata/ios_metadata.txt'
+      end
+  
+      kvps = contents.each_line
+                     .reject { |l| l.strip.length == 0 || (l.strip.start_with? "#") }
+                     .map do |l|
+                       key, value = l.split("=")
+                       [key.strip.to_sym, value.strip]
+                     end.flatten
+      Hash[*kvps]
+    end
+  
+    def game_metadata
+      contents = $gtk.read_file 'metadata/game_metadata.txt'
+  
+      kvps = contents.each_line
+                     .reject { |l| l.strip.length == 0 || (l.strip.start_with? "#") }
+                     .map do |l|
+                       key, value = l.split("=")
+                       [key.strip.to_sym, value.strip]
+                     end.flatten
+      Hash[*kvps]
+    end
+  
+    def raise_ios_metadata_required
+      raise WizardException.new(
+              "* mygame/metadata/ios_metadata.txt needs to be filled out.",
+              "You need to update metadata/ios_metadata.txt with a valid teamid, appname, and appid.",
+              "Instructions for where the values should come from are within metadata/ios_metadata.txt."
+            )
+    end
+  
     def determine_team_identifier
-      @team_name = (team_identifier_from_provisioning_profile @opts[:env])
-      log_info "Team Identifer is: #{@team_name}"
+      @team_id = (ios_metadata.teamid || "")
+      raise_ios_metadata_required if @team_id.strip.length == 0
+      log_info "Team Identifer is: #{@team_id}"
     end
   
     def determine_app_name
-      @app_name = (provisioning_profile_xml @opts[:env])[:children].first[:children].first[:children][1][:children].first[:data]
+      @app_name = (ios_metadata.appname || "")
+      raise_ios_metadata_required if @app_name.strip.length == 0
       log_info "App name is: #{@app_name}."
     end
   
@@ -39754,36 +41674,9 @@ Follows is a source code listing for all files that have been open sourced. This
       $gtk.parse_xml scrubbed
     end
   
-    def app_id_from_provisioning_profile environment
-      application_identifier_index = (provisioning_profile_xml environment)[:children][0][:children][0][:children][13][:children][0][:children][0][:data]
-      (provisioning_profile_xml environment)[:children][0][:children][0][:children][13][:children].each.with_index do |node, i|
-        if node[:children] && node[:children][0] && node[:children][0][:data] == "application-identifier"
-          application_identifier_index = i
-          break
-        end
-      end
-  
-      app_id_with_team_identifier = (provisioning_profile_xml environment)[:children].first[:children].first[:children][13][:children][application_identifier_index + 1][:children].first[:data]
-      team_identifer = team_identifier_from_provisioning_profile environment
-      app_id_with_team_identifier.gsub "#{team_identifer}.", ""
-    end
-  
-    def team_identifier_from_provisioning_profile environment
-      team_identifer_index = (provisioning_profile_xml environment)[:children][0][:children][0][:children][13][:children][0][:children][0][:data]
-  
-      (provisioning_profile_xml environment)[:children][0][:children][0][:children][13][:children].each.with_index do |node, i|
-        if node[:children] && node[:children][0] && node[:children][0][:data] == "com.apple.developer.team-identifier"
-          team_identifer_index = i
-          break
-        end
-      end
-  
-      (provisioning_profile_xml environment)[:children].first[:children].first[:children][13][:children][team_identifer_index + 1][:children].first[:data]
-    end
-  
     def determine_app_id
-      @app_id = app_id_from_provisioning_profile @opts[:env]
-  
+      @app_id = ios_metadata.appid
+      raise_ios_metadata_required if @app_id.strip.length == 0
       log_info "App Identifier is set to : #{@app_id}"
     end
   
@@ -39802,7 +41695,7 @@ Follows is a source code listing for all files that have been open sourced. This
       end
     end
   
-    def blow_away_temp
+    def clear_tmp_directory
       sh "rm -rf #{tmp_directory}"
     end
   
@@ -39943,7 +41836,8 @@ Follows is a source code listing for all files that have been open sourced. This
   
       log_info "Creating Entitlements.plist"
   
-      $gtk.write_file_root "tmp/ios/Entitlements.plist", entitlement_plist_string.gsub(":app_id", "#{@team_name}.#{@app_id}").strip
+      $gtk.write_file_root "tmp/ios/Entitlements.plist", entitlement_plist_string.gsub(":app_id", "#{@team_id}.#{@app_id}").strip
+      $gtk.write_file_root "tmp/ios/Entitlements.txt", entitlement_plist_string.gsub(":app_id", "#{@team_id}.#{@app_id}").strip
   
       sh "/usr/bin/plutil -convert binary1 \"#{tmp_directory}/Entitlements.plist\""
       sh "/usr/bin/plutil -convert xml1 \"#{tmp_directory}/Entitlements.plist\""
@@ -39981,15 +41875,15 @@ Follows is a source code listing for all files that have been open sourced. This
           <key>CFBundleExecutable</key>
           <string>:app_name</string>
           <key>CFBundleInfoDictionaryVersion</key>
-          <string>6.0</string>
+          <string>:app_version</string>
           <key>CFBundlePackageType</key>
           <string>APPL</string>
           <key>CFBundleShortVersionString</key>
-          <string>5.6</string>
+          <string>:app_version</string>
           <key>CFBundleSignature</key>
           <string>????</string>
           <key>CFBundleVersion</key>
-          <string>5.6</string>
+          <string>:app_version</string>
           <key>CFBundleIcons</key>
           <dict>
               <key>CFBundlePrimaryIcon</key>
@@ -40138,13 +42032,13 @@ Follows is a source code listing for all files that have been open sourced. This
           <key>CFBundleIdentifier</key>
           <string>:app_id</string>
           <key>CFBundleInfoDictionaryVersion</key>
-          <string>6.0</string>
+          <string>:app_version</string>
           <key>CFBundleName</key>
           <string>:app_name</string>
           <key>CFBundlePackageType</key>
           <string>APPL</string>
           <key>CFBundleShortVersionString</key>
-          <string>5.2</string>
+          <string>:app_version</string>
           <key>CFBundleSignature</key>
           <string>????</string>
           <key>CFBundleSupportedPlatforms</key>
@@ -40152,7 +42046,7 @@ Follows is a source code listing for all files that have been open sourced. This
                   <string>iPhoneOS</string>
           </array>
           <key>CFBundleVersion</key>
-          <string>5.2</string>
+          <string>:app_version</string>
           <key>DTCompiler</key>
           <string>com.apple.compilers.llvm.clang.1_0</string>
           <key>DTPlatformBuild</key>
@@ -40238,6 +42132,7 @@ Follows is a source code listing for all files that have been open sourced. This
       info_plist_string.gsub!(":app_id", @app_id)
   
       $gtk.write_file_root "tmp/ios/#{@app_name}.app/Info.plist", info_plist_string.strip
+      $gtk.write_file_root "tmp/ios/Info.txt", info_plist_string.strip
   
       @info_plist_written = true
     end
@@ -40291,13 +42186,13 @@ Follows is a source code listing for all files that have been open sourced. This
           <key>CFBundleIdentifier</key>
           <string>:app_id</string>
           <key>CFBundleInfoDictionaryVersion</key>
-          <string>6.0</string>
+          <string>:app_version</string>
           <key>CFBundleName</key>
           <string>:app_name</string>
           <key>CFBundlePackageType</key>
           <string>APPL</string>
           <key>CFBundleShortVersionString</key>
-          <string>5.2</string>
+          <string>:app_version</string>
           <key>CFBundleSignature</key>
           <string>????</string>
           <key>CFBundleSupportedPlatforms</key>
@@ -40305,7 +42200,7 @@ Follows is a source code listing for all files that have been open sourced. This
                   <string>iPhoneOS</string>
           </array>
           <key>CFBundleVersion</key>
-          <string>5.2</string>
+          <string>:app_version</string>
           <key>DTCompiler</key>
           <string>com.apple.compilers.llvm.clang.1_0</string>
           <key>DTPlatformBuild</key>
@@ -40389,8 +42284,10 @@ Follows is a source code listing for all files that have been open sourced. This
   
       info_plist_string.gsub!(":app_name", @app_name)
       info_plist_string.gsub!(":app_id", @app_id)
+      info_plist_string.gsub!(":app_version", @app_version)
   
       $gtk.write_file_root "tmp/ios/#{@app_name}.app/Info.plist", info_plist_string.strip
+      $gtk.write_file_root "tmp/ios/Info.txt", info_plist_string.strip
   
       @info_plist_written = true
     end
@@ -40412,28 +42309,53 @@ Follows is a source code listing for all files that have been open sourced. This
       "#{relative_path}/#{$gtk.cli_arguments[:dragonruby]}"
     end
   
-    def write_ip_address
+    def embed_mobileprovision
+      sh %Q[cp #{@provisioning_profile_path} "#{app_path}/embedded.mobileprovision"]
+      sh %Q[/usr/bin/plutil -convert binary1 "#{app_path}/Info.plist"]
+    end
+  
+    def clear_payload_directory
+      sh %Q[rm "#{@app_name}".ipa]
+      sh %Q[rm -rf "#{app_path}/app"]
+      sh %Q[rm -rf "#{app_path}/sounds"]
+      sh %Q[rm -rf "#{app_path}/sprites"]
+      sh %Q[rm -rf "#{app_path}/data"]
+      sh %Q[rm -rf "#{app_path}/fonts"]
+    end
+  
+    def stage_app
+      sh %Q[cp -r "#{root_folder}/app/" "#{app_path}/app/"]
+      sh %Q[cp -r "#{root_folder}/sounds/" "#{app_path}/sounds/"]
+      sh %Q[cp -r "#{root_folder}/sprites/" "#{app_path}/sprites/"]
+      sh %Q[cp -r "#{root_folder}/data/" "#{app_path}/data/"]
+      sh %Q[cp -r "#{root_folder}/fonts/" "#{app_path}/fonts/"]
+    end
+  
+    def create_payload
+      sh %Q[mkdir -p #{tmp_directory}/ipa_root/Payload]
+      sh %Q[cp -r "#{app_path}" "#{tmp_directory}/ipa_root/Payload"]
+      sh %Q[chmod -R 755 "#{tmp_directory}/ipa_root/Payload"]
+    end
+  
+    def create_payload_directory_dev
+      # write dev machine's ip address for hotloading
       $gtk.write_file "app/server_ip_address.txt", $gtk.ffi_misc.get_local_ip_address.strip
+  
+      embed_mobileprovision
+      clear_payload_directory
+      stage_app
     end
   
-    def create_payload_directory
-      sh "cp #{@provisioning_profile_path} \"#{app_path}/embedded.mobileprovision\""
-      sh "/usr/bin/plutil -convert binary1 \"#{app_path}/Info.plist\""
-      write_ip_address
-      sh "rm \"#{@app_name}\".ipa"
-      sh "rm -rf \"#{app_path}/app\""
-      sh "rm -rf \"#{app_path}/sounds\""
-      sh "rm -rf \"#{app_path}/sprites\""
-      sh "rm -rf \"#{app_path}/data\""
-      sh "rm -rf \"#{app_path}/fonts\""
-      sh "cp -r \"#{root_folder}/app/\" \"#{app_path}/app/\""
-      sh "cp -r \"#{root_folder}/sounds/\" \"#{app_path}/sounds/\""
-      sh "cp -r \"#{root_folder}/sprites/\" \"#{app_path}/sprites/\""
-      sh "cp -r \"#{root_folder}/data/\" \"#{app_path}/data/\""
-      sh "cp -r \"#{root_folder}/fonts/\" \"#{app_path}/fonts/\""
-      sh "mkdir -p #{tmp_directory}/ipa_root/Payload"
-      sh "cp -r \"#{app_path}\" \"#{tmp_directory}/ipa_root/Payload\""
-      sh "chmod -R 755 \"#{tmp_directory}/ipa_root/Payload\""
+    def create_payload_directory_prod
+      # production builds does not hotload ip address
+      sh %Q[rm "#{root_folder}/app/server_ip_address.txt"]
+  
+      embed_mobileprovision
+      stage_app
+  
+      # production build marker
+      sh %Q[mkdir -p "#{app_path}/metadata/"]
+      sh %Q[touch metadata/DRAGONRUBY_PRODUCTION_BUILD]
     end
   
     def create_ipa
@@ -40466,10 +42388,22 @@ Follows is a source code listing for all files that have been open sourced. This
     end
   
     def print_publish_help
-        log_info "Go to https://appstoreconnect.apple.com/apps and create an App if you haven't already done so."
-        log_info "Go to https://appleid.apple.com and create a 'Application Specific Password'."
-        log_info "To upload your app, Download Transporter from the App Store https://apps.apple.com/us/app/transporter/id1450874784?mt=12."
-        log_info "Your app is located at ./tmp/ios/#{@app_name}.ipa"
+      has_transporter = (sh "ls /Applications/Transporter.app").include? "Contents"
+      if !has_transporter
+        $gtk.openurl "https://apps.apple.com/us/app/transporter/id1450874784?mt=12"
+        $console.set_command "$wizards.ios.start env: :#{@opts[:env]}, version: \"#{@opts[:version]}\""
+        raise WizardException.new(
+          "* To upload your app, Download Transporter from the App Store https://apps.apple.com/us/app/transporter/id1450874784?mt=12."
+        )
+      else
+        sh "mkdir ./tmp/ios/intermediary_artifacts"
+        sh "mv \"#{tmp_directory}/#{@app_name}.app\" #{tmp_directory}/intermediary_artifacts/"
+        sh "mv \"#{tmp_directory}/do_zip.sh\" #{tmp_directory}/intermediary_artifacts"
+        sh "mv \"#{tmp_directory}/Entitlements.plist\" #{tmp_directory}/intermediary_artifacts"
+        sh "mv \"#{tmp_directory}/ipa_root\" #{tmp_directory}/intermediary_artifacts/"
+        sh "open /Applications/Transporter.app"
+        sh "open ./tmp/ios/"
+      end
     end
   
     def compile_icons
@@ -40490,6 +42424,26 @@ Follows is a source code listing for all files that have been open sourced. This
       sh "cp -r \"#{root_folder}/native/\" \"#{app_path}/native/\""
       sh "CODESIGN_ALLOCATE=\"/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/bin/codesign_allocate\" /usr/bin/codesign -f -s \"#{@certificate_name}\" --entitlements #{tmp_directory}/Entitlements.plist \"#{tmp_directory}/#{@app_name}.app/native/ios-device/ext.dylib\""
     end
+  
+    def set_version version
+      @app_version = version
+      start env: @opts[:env], version: version
+    end
+  
+    def app_version
+      log_info "Attempting to retrieve App Version from metadata/ios_metadata.txt."
+      ios_version_number = (ios_metadata.version || "").strip
+      if ios_version_number.length == 0
+        log_info "Not found. Attempting to retrieve App Version from metadata/game_metadata.txt."
+        ios_version_number = (game_metadata.version || "").strip
+      end
+      ios_version_number
+    end
+  
+    def determine_app_version
+      @app_version = app_version
+      return if @app_version
+    end
   end
 
 #+end_src
@@ -40501,38 +42455,14 @@ Follows is a source code listing for all files that have been open sourced. This
   # MIT License
   # itch_wizard.rb has been released under MIT (*only this file*).
   
-  class ItchWizard
+  class ItchWizard < Wizard
     def steps
       [
         :check_metadata,
-        :deploy
+        :deploy,
       ]
     end
   
-    def metadata_file_path
-      "metadata/game_metadata.txt"
-    end
-  
-    def get_metadata
-      metadata = $gtk.read_file metadata_file_path
-  
-      if !metadata
-        write_blank_metadata
-        metadata = $gtk.read_file metadata_file_path
-      end
-  
-      dev_id, dev_title, game_id, game_title, version, icon = *metadata.each_line.to_a
-  
-      {
-        dev_id: dev_id.strip,
-        dev_title: dev_title.strip,
-        game_id: game_id.strip,
-        game_title: game_title.strip,
-        version: version.strip,
-        icon: icon.strip
-      }
-    end
-  
     def write_blank_metadata
         $gtk.write_file metadata_file_path, <<-S.strip
   #devid=myname
@@ -40550,7 +42480,7 @@ Follows is a source code listing for all files that have been open sourced. This
         write_blank_metadata
       end
   
-      if metadata_text.each_line.to_a.length != 6
+      if metadata_text.strip.each_line.to_a.length < 6
         write_blank_metadata
       end
   
@@ -40562,70 +42492,67 @@ Follows is a source code listing for all files that have been open sourced. This
   
       if metadata[:dev_id].start_with?("#") || !@dev_id
         log "* PROMPT: Please provide your username for Itch."
-        $console.set_command "$wizards.itch.set_dev_id \"your-itch-username\""
+        $console.set_command "$wizards.itch.set_dev_id \"#{metadata[:dev_id]}\""
         return :need_dev_id
       end
   
       if metadata[:dev_title].start_with?("#") || !@dev_title
         log "* PROMPT: Please provide developer's/company's name that you want displayed."
-        $console.set_command "$wizards.itch.set_dev_title \"Your Name\""
+        $console.set_command "$wizards.itch.set_dev_title \"#{metadata[:dev_title]}\""
         return :need_dev_title
       end
   
       if metadata[:game_id].start_with?("#") || !@game_id
         log "* PROMPT: Please provide the id for you game. This is the id you specified when you set up a new game page on Itch."
-        $console.set_command "$wizards.itch.set_game_id \"your-game-id\""
+        $console.set_command "$wizards.itch.set_game_id \"#{metadata[:game_id]}\""
         return :need_game_id
       end
   
       if metadata[:game_title].start_with?("#") || !@game_title
         log "* PROMPT: Please provide the display name for your game. (This can include spaces)"
-        $console.set_command "$wizards.itch.set_game_title \"Your Game\""
+        $console.set_command "$wizards.itch.set_game_title \"#{metadata[:game_title]}\""
         return :need_game_title
       end
   
       if metadata[:version].start_with?("#") || !@version
         log "* PROMPT: Please provide the version for your game."
-        $console.set_command "$wizards.itch.set_version \"1.0\""
+        $console.set_command "$wizards.itch.set_version \"#{metadata[:version]}\""
         return :need_version
       end
   
       if metadata[:icon].start_with?("#") || !@icon
         log "* PROMPT: Please provide icon path for your game."
-        $console.set_command "$wizards.itch.set_icon \"icon.png\""
+        $console.set_command "$wizards.itch.set_icon \"#{metadata[:icon]}\""
         return :need_icon
       end
   
+      puts "here!! success!!!"
+  
       return :success
     end
   
     def set_dev_id value
       @dev_id = value
-      write_metadata
       start
     end
   
     def set_dev_title value
       @dev_title = value
-      write_metadata
       start
     end
   
     def set_game_id value
       @game_id = value
-      write_metadata
       start
     end
   
     def set_game_title value
       @game_title = value
-      write_metadata
       start
     end
   
     def set_version value
       @version = value
-      write_metadata
       start
     end
   
@@ -40668,7 +42595,7 @@ Follows is a source code listing for all files that have been open sourced. This
       end
   
       if @icon
-        text += "icon=metadata/#{@icon}\n"
+        text += "icon=#{@icon}\n"
       else
         text += "#icon=metadata/icon.png\n"
       end
@@ -40686,10 +42613,25 @@ Follows is a source code listing for all files that have been open sourced. This
   
     def deploy
       log_info "* Running dragonruby-publish: #{package_command}"
-      results = $gtk.exec package_command
+      $gtk.openurl "http://itch.io/dashboard" if $gtk.platform == "Mac OS X"
+      if $gtk.platform? :mac
+        $gtk.exec "rm -rf ./builds"
+      end
+      results = $gtk.exec "#{package_command} --only-package"
+      puts File.expand_path("./builds")
+  
       log "#+begin_src"
       log results
       log "#+end_src"
+  
+      if $gtk.platform? :mac
+        $gtk.exec "open ./builds/"
+      elsif $gtk.platform? :windows
+        $gtk.exec "powershell \"ii .\""
+      end
+  
+      $gtk.openurl "https://itch.io/dashboard"
+  
       :success
     end
   
@@ -40700,7 +42642,7 @@ Follows is a source code listing for all files that have been open sourced. This
       steps.each do |m|
         begin
           log_info "Running Itch Wizard Step: ~$wizards.itch.#{m}~"
-          result = (send m) || :success if @wizard_status[m][:result] != :success
+          result = (send m) || :success
           @wizard_status[m][:result] = result
           if result != :success
             log_info "Exiting wizard. :#{result}"
@@ -41049,10 +42991,18 @@ Follows is a source code listing for all files that have been open sourced. This
         device.grid_area.row_count
       end
   
+      def row_max_index
+        row_count - 1
+      end
+  
       def col_count
         device.grid_area.col_count
       end
   
+      def col_max_index
+        col_count - 1
+      end
+  
       def gutter_height
         device.grid_area.gutter
       end
@@ -41075,18 +43025,124 @@ Follows is a source code listing for all files that have been open sourced. This
   
       def rect_defaults
         {
-          row: nil,
-          col: nil,
-          h:   1,
-          w:   1,
-          dx:  0,
-          dy:  0,
-          rect: :control_rect
+          row:      nil,
+          col:      nil,
+          h:        1,
+          w:        1,
+          dx:       0,
+          dx_ratio: 1,
+          dy:       0,
+          dy_ratio: 1,
+          dh_ratio: 1,
+          dw_ratio: 1,
+          merge:    nil,
+          rect:     :control_rect
         }
       end
   
-      def rect opts
+      def row n
+        (rect row: n, col: 0, w: 0, h: 0).x
+      end
+  
+      def row_from_bottom n
+        (rect row: row_count - n, col: 0, w: 0, h: 0).x
+      end
+  
+      def col n
+        (rect row: 0, col: n, w: 0, h: 0).y
+      end
+  
+      def col_from_right n
+        (rect row: 0, col: col_max_index - n, w: 0, h: 0).y
+      end
+  
+      def w n
+        (rect row: 0, col: 0, w: n, h: 1).w
+      end
+  
+      def h n
+        (rect row: 0, col: 0, w: 1, h: n).h
+      end
+  
+      def rect_group opts
+        group = opts.group
+        r     = opts.row || 0
+        r     = row_max_index - opts.row_from_bottom if opts.row_from_bottom
+        c     = opts.col || 0
+        c     = col_max_index - opts.col_from_right  if opts.col_from_right
+        drow  = opts.drow || 0
+        dcol  = opts.dcol || 0
+        w     = opts.w    || 0
+        h     = opts.h    || 0
+        merge = opts[:merge]
+  
+        running_row = r
+        running_col = c
+  
+        running_col = calc_col_offset(opts.col_offset) if opts.col_offset
+        running_row = calc_row_offset(opts.row_offset) if opts.row_offset
+  
+        group.map do |i|
+          group_layout_opts = i.layout || {}
+          group_layout_opts = group_layout_opts.merge row: running_row,
+                                                      col: running_col,
+                                                      merge: merge,
+                                                      w: w, h: h
+          result = (rect group_layout_opts).merge i
+  
+          if (i.is_a? Hash) && (i.primitive_marker == :label)
+            if    i.alignment_enum == 1
+              result.x += result.w.half
+            elsif i.alignment_enum == 2
+              result.x += result.w
+            end
+          end
+  
+          running_row += drow
+          running_col += dcol
+          result
+        end
+      end
+  
+      def calc_row_offset opts = {}
+        count = opts[:count] || opts[:length] || 0
+        h     = opts.h || 1
+        (row_count - (count * h)) / 2.0
+      end
+  
+      def calc_col_offset opts = {}
+        count = opts[:count] || opts[:length] || 0
+        w     = opts.w || 1
+        (col_count - (count * w)) / 2.0
+      end
+  
+      def point opts = {}
+        opts.w = 1
+        opts.h = 1
+        opts.row ||= 0
+        opts.col ||= 0
+        r = rect opts
+        r.x  += r.w * opts.col_anchor if opts.col_anchor
+        r.y  += r.h * opts.row_anchor if opts.row_anchor
+        r
+      end
+  
+      def rect *all_opts
+        if all_opts.length == 1
+          opts = all_opts.first
+        else
+          opts = {}
+          all_opts.each do |o|
+            opts.merge! o
+          end
+        end
+  
+        opts.row = row_max_index - opts.row_from_bottom if opts.row_from_bottom
+        opts.col = col_max_index - opts.col_from_right if opts.col_from_right
         opts = rect_defaults.merge opts
+        opts.row ||= 0
+        opts.col ||= 0
+  
         result = send opts[:rect]
         if opts[:row] && opts[:col] && opts[:w] && opts[:h]
           col = rect_col opts[:col], opts[:w]
@@ -41094,7 +43150,9 @@ Follows is a source code listing for all files that have been open sourced. This
           result = control_rect.merge x: col.x,
                                       y: row.y,
                                       w: col.w,
-                                      h: row.h
+                                      h: row.h,
+                                      center_x: col.center_x,
+                                      center_y: row.center_y
         elsif opts[:row] && !opts[:col]
           result = rect_row opts[:row], opts[:h]
         elsif !opts[:row] && opts[:col]
@@ -41132,13 +43190,21 @@ Follows is a source code listing for all files that have been open sourced. This
           result[:h] += device.grid_area.gutter * 2
         end
   
-        result[:x] += opts[:dx] if opts[:dx]
-        result[:y] += opts[:dy] if opts[:dy]
-        result[:w] += opts[:dw] if opts[:dw]
-        result[:h] += opts[:dh] if opts[:dh]
+        result[:x] += opts[:dx]       if opts[:dx]
+        result[:x] *= opts[:dx_ratio] if opts[:dx_ratio]
+        result[:y] += opts[:dy]       if opts[:dy]
+        result[:y] *= opts[:dy_ratio] if opts[:dy_ratio]
+        result[:w] += opts[:dw]       if opts[:dw]
+        result[:w] *= opts[:dw_ratio] if opts[:dw_ratio]
+        result[:h] += opts[:dh]       if opts[:dh]
+        result[:h] *= opts[:dh_ratio] if opts[:dh_ratio]
+        result.merge! opts[:merge]    if opts[:merge]
         result[:row] = opts[:row]
         result[:col] = opts[:col]
   
+        result[:h] = result[:h].clamp 0
+        result[:w] = result[:w].clamp 0
+  
         if $gtk.args.grid.name == :center
           result[:x] -= 640
           result[:y] -= 360
@@ -41173,7 +43239,7 @@ Follows is a source code listing for all files that have been open sourced. This
   
         row_y = device.h - row_y - row_h
   
-        result = control_rect.merge y: row_y, h: row_h
+        result = control_rect.merge y: row_y, h: row_h, center_y: (row_y + row_h.half)
         @rect_cache[:row][index][h] = result
         @rect_cache[:row][index][h]
       end
@@ -41196,7 +43262,7 @@ Follows is a source code listing for all files that have been open sourced. This
         col_w = col_w.to_i
         col_w -= 1 if col_w.odd?
   
-        result = control_rect.merge x: col_x, w: col_w
+        result = control_rect.merge x: col_x, w: col_w, center_x: (col_x + col_w.half)
         @rect_cache[:col][index][w] = result
         @rect_cache[:col][index][w]
       end
@@ -41247,6 +43313,26 @@ Follows is a source code listing for all files that have been open sourced. This
         @device
       end
   
+      def debug_primitives opts = {}
+        @primitives ||= col_count.map_with_index do |col|
+                          row_count.map_with_index do |row|
+                            cell   = rect row: row, col: col
+                            center = Geometry.rect_center_point cell
+                            [
+                              cell.merge(opts).border,
+                              cell.merge(opts)
+                                  .label!(x: center.x,
+                                          y: center.y,
+                                          text: "#{row},#{col}",
+                                          size_enum: -3,
+                                          vertical_alignment_enum: 1,
+                                          alignment_enum: 1)
+                            ]
+                          end
+                        end
+                        @primitives
+      end
+  
       def serialize
         {
           device: @device.serialize,
@@ -41260,6 +43346,13 @@ Follows is a source code listing for all files that have been open sourced. This
       def to_s
         serialize.to_s
       end
+  
+      def reset
+        @primitives = nil
+        @rect_cache ||= {}
+        @rect_cache.clear
+      end
+  
     end
   end
 
@@ -41399,6 +43492,11 @@ Follows is a source code listing for all files that have been open sourced. This
         self.puts message
       end
   
+      def self.reset
+        @once = {}
+        nil
+      end
+  
       def self.puts_once *ids, message
         id = "#{ids}"
         @once ||= {}
@@ -41535,6 +43633,53 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
+*** metadata.rb
+#+begin_src ruby
+  # ./dragon/metadata.rb
+  # Contributors outside of DragonRuby who also hold Copyright: Michał Dudziński
+  # Copyright 2021 DragonRuby LLC
+  # MIT License
+  # metadata.rb has been released under MIT (*only this file*).
+  
+  module Metadata
+    def metadata_file_path
+      "metadata/game_metadata.txt"
+    end
+  
+    def get_metadata
+      metadata = $gtk.read_file metadata_file_path
+  
+      if !metadata
+        write_blank_metadata
+        metadata = $gtk.read_file metadata_file_path
+      end
+  
+      dev_id, dev_title, game_id, game_title, version, icon = *metadata.each_line.to_a
+  
+      {
+        dev_id: dev_id.strip,
+        dev_title: dev_title.strip,
+        game_id: game_id.strip,
+        game_title: game_title.strip,
+        version: version.strip,
+        icon: icon.strip
+      }
+    end
+  
+    def write_blank_metadata
+        $gtk.write_file metadata_file_path, <<-S.strip
+  #devid=myname
+  #devtitle=My Name
+  #gameid=mygame
+  #gametitle=My Game
+  #version=0.1
+  #icon=metadata/icon.png
+  S
+    end
+  end
+
+#+end_src
+
 *** numeric.rb
 #+begin_src ruby
   # ./dragon/numeric.rb
@@ -41553,6 +43698,35 @@ Follows is a source code listing for all files that have been open sourced. This
     alias_method :lte, :<=
     alias_method :__original_eq_eq__, :== unless Numeric.instance_methods.include? :__original_eq_eq__
   
+    def to_layout_row opts = {}
+      $layout.rect(row: self,
+                   col: opts.col || 0,
+                   w:   opts.w || 0,
+                   h:   opts.h || 0).y
+    end
+  
+    def to_layout_col opts = {}
+      $layout.rect(row: 0,
+                   col: self,
+                   w:   opts.w || 0,
+                   h:   opts.h || 0).x
+    end
+  
+    def to_layout_w
+      $layout.rect(row: 0, col: 0, w: self, h: 1).w
+    end
+  
+    def to_layout_h
+      $layout.rect(row: 0, col: 0, w: 1, h: self).h
+    end
+  
+    def to_layout_row_from_bottom opts = {}
+      ($layout.row_max_index - self).to_layout_row opts
+    end
+  
+    def to_layout_col_from_right opts = {}
+      ($layout.col_max_index - self).to_layout_col opts
+    end
   
     # Converts a numeric value representing seconds into frames.
     #
@@ -41568,10 +43742,26 @@ Follows is a source code listing for all files that have been open sourced. This
       self / 2.0
     end
   
+    def third
+      self / 3.0
+    end
+  
+    def quarter
+      self / 4.0
+    end
+  
     def to_byte
       clamp(0, 255).to_i
     end
   
+    def clamp *opts
+      min = (opts.at 0)
+      max = (opts.at 1)
+      return min if min && self < min
+      return max if max && self > max
+      return self
+    end
+  
     def clamp_wrap min, max
       max, min = min, max if min > max
       return self if self >= min && self <= max
@@ -41796,7 +43986,7 @@ Follows is a source code listing for all files that have been open sourced. This
       self * Math::PI.fdiv(180)
     end
   
-    # Converts a number representing an angle in radians to degress.
+    # Converts a number representing an angle in radians to degrees.
     #
     # @gtk
     def to_degrees
@@ -41813,21 +44003,21 @@ Follows is a source code listing for all files that have been open sourced. This
       GTK::Geometry.to_square(self, x, y, anchor_x, anchor_y)
     end
   
-    # Returns a normal vector for a number that represents an angle in degress.
+    # Returns a normal vector for a number that represents an angle in degrees.
     #
     # @gtk
     def vector max_value = 1
       [vector_x(max_value), vector_y(max_value)]
     end
   
-    # Returns the y component of a normal vector for a number that represents an angle in degress.
+    # Returns the y component of a normal vector for a number that represents an angle in degrees.
     #
     # @gtk
     def vector_y max_value = 1
       max_value * Math.sin(self.to_radians)
     end
   
-    # Returns the x component of a normal vector for a number that represents an angle in degress.
+    # Returns the x component of a normal vector for a number that represents an angle in degrees.
     #
     # @gtk
     def vector_x max_value = 1
@@ -41854,6 +44044,18 @@ Follows is a source code listing for all files that have been open sourced. This
       (self % n) == 0
     end
   
+    def multiply n
+      self * n
+    end
+  
+    def fmult n
+      self * n.to_f
+    end
+  
+    def imult n
+      (self * n).to_i
+    end
+  
     def mult n
       self * n
     end
@@ -41975,12 +44177,6 @@ Follows is a source code listing for all files that have been open sourced. This
       return gt other
     end
   
-    def == other
-      return true if __original_eq_eq__ other
-      return __original_eq_eq__ other.entity_id if other.is_a? OpenEntity
-      return false
-    end
-  
     # @gtk
     def map
       unless block_given?
@@ -42067,29 +44263,29 @@ Follows is a source code listing for all files that have been open sourced. This
     end
   
     def - other
-      return nil unless other
-      super
+      return self unless other
+      self - other
     rescue Exception => e
       __raise_arithmetic_exception__ other, :-, e
     end
   
     def + other
-      return nil unless other
-      super
+      return self unless other
+      self + other
     rescue Exception => e
       __raise_arithmetic_exception__ other, :+, e
     end
   
     def * other
-      return nil unless other
-      super
+      return self unless other
+      self * other
     rescue Exception => e
       __raise_arithmetic_exception__ other, :*, e
     end
   
     def / other
-      return nil unless other
-      super
+      return self unless other
+      self / other
     rescue Exception => e
       __raise_arithmetic_exception__ other, :/, e
     end
@@ -42119,6 +44315,10 @@ Follows is a source code listing for all files that have been open sourced. This
     def self.clamp n, min, max
       n.clamp min, max
     end
+  
+    def mid? l, r
+      (between? l, r) || (between? r, l)
+    end
   end
   
   class Fixnum
@@ -42145,39 +44345,33 @@ Follows is a source code listing for all files that have been open sourced. This
     end
   
     def + other
-      return nil unless other
-      super
+      return self unless other
+      self + other
     rescue Exception => e
       __raise_arithmetic_exception__ other, :+, e
     end
   
     def * other
-      return nil unless other
-      super
+      return self unless other
+      self * other
     rescue Exception => e
       __raise_arithmetic_exception__ other, :*, e
     end
   
     def / other
-      return nil unless other
-      super
+      return self unless other
+      self / other
     rescue Exception => e
       __raise_arithmetic_exception__ other, :/, e
     end
   
     def - other
-      return nil unless other
-      super
+      return self unless other
+      self - other
     rescue Exception => e
       __raise_arithmetic_exception__ other, :-, e
     end
   
-    def == other
-      return true if __original_eq_eq__ other
-      return __original_eq_eq__ other.entity_id if other.is_a? GTK::OpenEntity
-      return false
-    end
-  
     # Returns `-1` if the number is less than `0`. `+1` if the number
     # is greater than `0`. Returns `0` if the number is equal to `0`.
     #
@@ -42234,28 +44428,28 @@ Follows is a source code listing for all files that have been open sourced. This
     alias_method :__original_divide__,   :- unless Float.instance_methods.include? :__original_divide__
   
     def - other
-      return nil unless other
+      return self unless other
       super
     rescue Exception => e
       __raise_arithmetic_exception__ other, :-, e
     end
   
     def + other
-      return nil unless other
+      return self unless other
       super
     rescue Exception => e
       __raise_arithmetic_exception__ other, :+, e
     end
   
     def * other
-      return nil unless other
+      return self unless other
       super
     rescue Exception => e
       __raise_arithmetic_exception__ other, :*, e
     end
   
     def / other
-      return nil unless other
+      return self unless other
       super
     rescue Exception => e
       __raise_arithmetic_exception__ other, :/, e
@@ -42302,6 +44496,10 @@ Follows is a source code listing for all files that have been open sourced. This
     def nan?
       false
     end
+  
+    def center other
+      (self - other).abs.fdiv(2)
+    end
   end
 
 #+end_src
@@ -42358,7 +44556,7 @@ Follows is a source code listing for all files that have been open sourced. This
       def local_state
         @local_state ||= OpenEntity.new
         @local_state.hotload_client ||= @local_state.new_entity(:hotload_client,
-                                                                notes: "This enitity is used by DragonRuby Game Toolkit to provide you hotloading on remote machines.",
+                                                                notes: "This entity is used by DragonRuby Game Toolkit to provide you hotloading on remote machines.",
                                                                 changes: { },
                                                                 changes_queue: [],
                                                                 reloaded_files_times: [])
@@ -42534,7 +44732,7 @@ Follows is a source code listing for all files that have been open sourced. This
             sub_index       = index - previous_line[:sum]
             word            = (cursor_line[:line][0..sub_index - 1]).strip
             token           = (word.split " ")[-1]
-            dots            = (token.split ".")
+            dots            = (token.split ".").flat_map { |s| s.split "[" }.flat_map { |s| s.split "]" }.flat_map { |s| s.split "(" }.flat_map { |s| s.split ")" }
             dot             = dots[-1]
           end
   
@@ -42555,6 +44753,10 @@ Follows is a source code listing for all files that have been open sourced. This
           ignores ||= []
           ignores   = [ignores].flatten
           keys   = keys.map { |k| k.to_s }
+          keys   = keys.reject { |k| k.include? '"' }
+                       .reject { |k| k.start_with? "'" }
+                       .reject { |k| k.include? "," }
+                       .reject { |k| k.start_with? "#" }
           others = ["def", "end"] +
                    [ :entity_keys_by_ref,
                      :entity_name,
@@ -42612,6 +44814,10 @@ Follows is a source code listing for all files that have been open sourced. This
   
             return autocomplete_filter_methods lookup_result.call if lookup_result
   
+            if dot[0].upcase == dot[0] && (Object.const_defined? dot.to_sym)
+              return (Object.const_get dot.to_sym).autocomplete_methods
+            end
+  
             start_collecting = false
             dots_after_state = dots.find_all do |s|
               if s == "state"
@@ -42627,10 +44833,16 @@ Follows is a source code listing for all files that have been open sourced. This
               target = target.as_hash[k.to_sym] if target.respond_to? :as_hash
             end
   
-            return autocomplete_filter_methods target.as_hash.keys
+            if target.respond_to? :as_hash
+              return autocomplete_filter_methods target.as_hash.keys
+            else
+              return autocomplete_filter_methods target.autocomplete_methods
+            end
           end
   
   
+          text = text.each_line.reject { |l| l.strip.start_with? "#" }.join "\n"
+          text = text.each_line.map { |l| l.split("#").first }.join "\n"
           text.gsub!("[", " ")
           text.gsub!("]", " ")
           text.gsub!("(", " ")
@@ -42647,154 +44859,158 @@ Follows is a source code listing for all files that have been open sourced. This
 
 #+end_src
 
-*** runtime/draw.rb
+*** runtime/benchmark.rb
 #+begin_src ruby
-  # ./dragon/runtime/draw.rb
+  # ./dragon/runtime/benchmark.rb
   # Copyright 2019 DragonRuby LLC
   # MIT License
-  # draw.rb has been released under MIT (*only this file*).
+  # benchmark.rb has been released under MIT (*only this file*).
   
   module GTK
     class Runtime
-      module Draw
-        def primitives pass
-          if $top_level.respond_to? :primitives_override
-            return $top_level.tick_render @args, pass
-          end
-  
-          # Don't change this draw order unless you understand
-          # the implications.
-  
-          # pass.solids.each            { |s| draw_solid s }
-          # while loops are faster than each with block
-          idx = 0
-          length = pass.solids.length
-          while idx < pass.solids.length
-            draw_solid (pass.solids.at idx) # accessing an array using .value instead of [] is faster
-            idx += 1
-          end
-  
-          # pass.static_solids.each     { |s| draw_solid s }
+      module Benchmark
+        def benchmark_single iterations, name, proc
+          log <<-S
+  ** Invoking :#{name}...
+  S
+          time_start = Time.now
           idx = 0
-          length = pass.static_solids.length
-          while idx < length
-            draw_solid (pass.static_solids.at idx)
+          r = nil
+          while idx < iterations
+            r = proc.call
             idx += 1
           end
   
-          # pass.sprites.each           { |s| draw_sprite s }
-          idx = 0
-          length = pass.sprites.length
-          while idx < length
-            draw_sprite (pass.sprites.at idx)
-            idx += 1
-          end
+          result = (Time.now - time_start).round 3
   
-          # pass.static_sprites.each    { |s| draw_sprite s }
-          idx = 0
-          length = pass.static_sprites.length
-          while idx < length
-            draw_sprite (pass.static_sprites.at idx)
-            idx += 1
-          end
+          { name: name,
+            time: result,
+            time_ms: (result * 1000).to_i }
+        end
   
-          # pass.primitives.each        { |p| draw_primitive p }
-          idx = 0
-          length = pass.primitives.length
-          while idx < length
-            draw_primitive (pass.primitives.at idx)
-            idx += 1
-          end
+        def benchmark opts = {}
+          iterations = opts.iterations
   
-          # pass.static_primitives.each { |p| draw_primitive p }
-          idx = 0
-          length = pass.static_primitives.length
-          while idx < length
-            draw_primitive (pass.static_primitives.at idx)
-            idx += 1
-          end
+          log <<-S
+  * BENCHMARK: Started
+  ** Caller: #{(caller || []).first}
+  ** Iterations: #{iterations}
+  S
+          procs = opts.find_all { |k, v| v.respond_to? :call }
+  
+          times = procs.map do |(name, proc)|
+            benchmark_single iterations, name, proc
+          end.sort_by { |r| r.time }
+  
+          first_place = times.first
+          second_place = times.second || first_place
+  
+          times = times.map do |candidate|
+            average_time = first_place.time
+                             .add(candidate.time)
+                             .abs
+                             .fdiv(2)
+  
+            difference_percentage = 0
+            if average_time == 0
+              difference_percentage = 0
+            else
+              difference_percentage = first_place.time
+                                        .subtract(candidate.time)
+                                        .abs
+                                        .fdiv(average_time)
+                                        .imult(100)
+            end
   
-          # pass.labels.each            { |l| draw_label l }
-          idx = 0
-          length = pass.labels.length
-          while idx < length
-            draw_label (pass.labels.at idx)
-            idx += 1
+            difference_time = ((first_place.time - candidate.time) * 1000).round
+            candidate.merge(difference_percentage: difference_percentage,
+                            difference_time: difference_time)
           end
   
-          # pass.static_labels.each     { |l| draw_label l }
-          idx = 0
-          length = pass.static_labels.length
-          while idx < length
-            draw_label (pass.static_labels.at idx)
-            idx += 1
+          too_small_to_measure = false
+          if (first_place.time + second_place.time) == 0
+            too_small_to_measure = true
+            difference_percentage = 0
+            log <<-S
+  * BENCHMARK: Average time for experiments were too small. Increase the number of iterations.
+  S
+          else
+            difference_percentage = (((first_place.time - second_place.time).abs.fdiv((first_place.time + second_place.time).abs.fdiv(2))) * 100).round
           end
   
-          # pass.lines.each             { |l| draw_line l }
-          idx = 0
-          length = pass.lines.length
-          while idx < length
-            draw_line (pass.lines.at idx)
-            idx += 1
-          end
+          difference_time = first_place.time.-(second_place.time).*(1000).abs.round
   
-          # pass.static_lines.each      { |l| draw_line l }
-          idx = 0
-          length = pass.static_lines.length
-          while idx < pass.static_lines.length
-            draw_line (pass.static_lines.at idx)
-            idx += 1
-          end
+          r = {
+            iterations: iterations,
+            first_place: first_place,
+            second_place: second_place,
+            difference_time: difference_time,
+            difference_percentage: difference_percentage,
+            times: times,
+            too_small_to_measure: too_small_to_measure
+          }
   
-          # pass.borders.each           { |b| draw_border b }
-          idx = 0
-          length = pass.borders.length
-          while idx < length
-            draw_border (pass.borders.at idx)
-            idx += 1
-          end
+          log_message = []
+          only_one_result = first_place.name == second_place.name
   
-          # pass.static_borders.each    { |b| draw_border b }
-          idx = 0
-          length = pass.static_borders.length
-          while idx < length
-            draw_border (pass.static_borders.at idx)
-            idx += 1
+          if only_one_result
+            log <<-S
+  * BENCHMARK: #{r.first_place.name} completed in #{r.first_place.time_ms}ms."
+  S
+          else
+            log <<-S
+  * BENCHMARK: #{r.message}
+  ** Fastest: #{r.first_place.name.inspect}
+  ** Second:  #{r.second_place.name.inspect}
+  ** Margin:  #{r.difference_percentage}% (#{r.difference_time.abs}ms) #{r.first_place.time_ms}ms vs #{r.second_place.time_ms}ms.
+  ** Times:
+  #{r.times.map { |t| "*** #{t.name}: #{t.time_ms}ms (#{t.difference_percentage}% #{t.difference_time.abs}ms)." }.join("\n")}
+  S
           end
   
-          if !$gtk.production
-            # pass.debug.each        { |r| draw_primitive r }
-            idx = 0
-            length = pass.debug.length
-            while idx < length
-              draw_primitive (pass.debug.at idx)
-              idx += 1
-            end
+          r
+        end
+      end
+    end
+  end
+
+#+end_src
+
+*** runtime/draw.rb
+#+begin_src ruby
+  # ./dragon/runtime/draw.rb
+  # Copyright 2019 DragonRuby LLC
+  # MIT License
+  # draw.rb has been released under MIT (*only this file*).
   
-            # pass.static_debug.each { |r| draw_primitive r }
-            idx = 0
-            length = pass.static_debug.length
-            while idx < length
-              draw_primitive (pass.static_debug.at idx)
-              idx += 1
-            end
+  module GTK
+    class Runtime
+      module Draw
+        def primitives pass
+          if $top_level.respond_to? :primitives_override
+            return $top_level.tick_render @args, pass
           end
   
-          # pass.reserved.each          { |r| draw_primitive r }
-          idx = 0
-          length = pass.reserved.length
-          while idx < length
-            draw_primitive (pass.reserved.at idx)
-            idx += 1
-          end
+          fn.each_send pass.solids,            self, :draw_solid
+          fn.each_send pass.static_solids,     self, :draw_solid
+          fn.each_send pass.sprites,           self, :draw_sprite
+          fn.each_send pass.static_sprites,    self, :draw_sprite
+          fn.each_send pass.primitives,        self, :draw_primitive
+          fn.each_send pass.static_primitives, self, :draw_primitive
+          fn.each_send pass.labels,            self, :draw_label
+          fn.each_send pass.static_labels,     self, :draw_label
+          fn.each_send pass.lines,             self, :draw_line
+          fn.each_send pass.static_lines,      self, :draw_line
+          fn.each_send pass.borders,           self, :draw_border
+          fn.each_send pass.static_borders,    self, :draw_border
   
-          # pass.static_reserved.each   { |r| draw_primitive r }
-          idx = 0
-          length = pass.static_reserved.length
-          while idx < length
-            draw_primitive (pass.static_reserved.at idx)
-            idx += 1
+          if !$gtk.production
+            fn.each_send pass.debug,           self, :draw_primitive
+            fn.each_send pass.static_debug,    self, :draw_primitive
           end
+  
+          fn.each_send pass.reserved,          self, :draw_primitive
+          fn.each_send pass.static_reserved,   self, :draw_primitive
         rescue Exception => e
           pause!
           pretty_print_exception_and_export! e
@@ -42805,7 +45021,9 @@ Follows is a source code listing for all files that have been open sourced. This
           if s.respond_to? :draw_override
             s.draw_override @ffi_draw
           else
-            @ffi_draw.draw_solid s.x, s.y, s.w, s.h, s.r, s.g, s.b, s.a
+            @ffi_draw.draw_solid_2 s.x, s.y, s.w, s.h,
+                                   s.r, s.g, s.b, s.a,
+                                   (s.blendmode_enum || 1)
           end
         rescue Exception => e
           raise_conversion_for_rendering_failed s, e, :solid
@@ -42816,14 +45034,15 @@ Follows is a source code listing for all files that have been open sourced. This
           if s.respond_to? :draw_override
             s.draw_override @ffi_draw
           else
-            @ffi_draw.draw_sprite_3 s.x, s.y, s.w, s.h,
-                                    s.path.s_or_default,
+            @ffi_draw.draw_sprite_4 s.x, s.y, s.w, s.h,
+                                    (s.path || '').to_s,
                                     s.angle,
                                     s.a, s.r, s.g, s.b,
                                     s.tile_x, s.tile_y, s.tile_w, s.tile_h,
                                     !!s.flip_horizontally, !!s.flip_vertically,
                                     s.angle_anchor_x, s.angle_anchor_y,
-                                    s.source_x, s.source_y, s.source_w, s.source_h
+                                    s.source_x, s.source_y, s.source_w, s.source_h,
+                                    (s.blendmode_enum || 1)
           end
         rescue Exception => e
           raise_conversion_for_rendering_failed s, e, :sprite
@@ -42834,7 +45053,7 @@ Follows is a source code listing for all files that have been open sourced. This
           if s.respond_to? :draw_override
             s.draw_override @ffi_draw
           else
-            @ffi_draw.draw_screenshot s.path.s_or_default,
+            @ffi_draw.draw_screenshot (s.path || '').to_s,
                                       s.x, s.y, s.w, s.h,
                                       s.angle,
                                       s.a, s.r, s.g, s.b,
@@ -42852,10 +45071,13 @@ Follows is a source code listing for all files that have been open sourced. This
           if l.respond_to? :draw_override
             l.draw_override @ffi_draw
           else
-            @ffi_draw.draw_label l.x, l.y, l.text.s_or_default,
-                                 l.size_enum, l.alignment_enum,
-                                 l.r, l.g, l.b, l.a,
-                                 l.font.s_or_default(nil)
+            @ffi_draw.draw_label_3 l.x, l.y,
+                                   (l.text || '').to_s,
+                                   l.size_enum, l.alignment_enum,
+                                   l.r, l.g, l.b, l.a,
+                                   l.font,
+                                   (l.vertical_alignment_enum || 2),
+                                   (l.blendmode_enum || 1)
           end
         rescue Exception => e
           raise_conversion_for_rendering_failed l, e, :label
@@ -42866,7 +45088,21 @@ Follows is a source code listing for all files that have been open sourced. This
           if l.respond_to? :draw_override
             l.draw_override @ffi_draw
           else
-            @ffi_draw.draw_line l.x, l.y, l.x2, l.y2, l.r, l.g, l.b, l.a
+            if l.x2
+              @ffi_draw.draw_line_2 l.x, l.y, l.x2, l.y2,
+                                    l.r, l.g, l.b, l.a,
+                                    (l.blendmode_enum || 1)
+            else
+              w = l.w || 0
+              w = 1 if w == 0
+              h = l.h || 0
+              h = 1 if h == 0
+              @ffi_draw.draw_line_2 l.x, l.y,
+                                    l.x + w - 1,
+                                    l.y + h - 1,
+                                    l.r, l.g, l.b, l.a,
+                                    (l.blendmode_enum || 1)
+            end
           end
         rescue Exception => e
           raise_conversion_for_rendering_failed l, e, :line
@@ -42877,7 +45113,9 @@ Follows is a source code listing for all files that have been open sourced. This
           if s.respond_to? :draw_override
             s.draw_override @ffi_draw
           else
-            @ffi_draw.draw_border s.x, s.y, s.w, s.h, s.r, s.g, s.b, s.a
+            @ffi_draw.draw_border_2 s.x, s.y, s.w, s.h,
+                                    s.r, s.g, s.b, s.a,
+                                    (s.blendmode_enum || 1)
           end
         rescue Exception => e
           raise_conversion_for_rendering_failed s, e, :border
@@ -42897,7 +45135,6 @@ Follows is a source code listing for all files that have been open sourced. This
           pause!
           pretty_print_exception_and_export! e
         end
-  
       end
     end
   end
@@ -43113,7 +45350,7 @@ Follows is a source code listing for all files that have been open sourced. This
   
         def framerate_diagnostics_primitives
           [
-            { x: 0, y: 93.from_top, w: 500, h: 93, a: 128 }.solid,
+            { x: 0, y: 93.from_top, w: 500, h: 93, a: 128 }.solid!,
             {
               x: 5,
               y: 5.from_top,
@@ -43122,7 +45359,7 @@ Follows is a source code listing for all files that have been open sourced. This
               g: 255,
               b: 255,
               size_enum: -2
-            }.label,
+            }.label!,
             {
               x: 5,
               y: 20.from_top,
@@ -43131,7 +45368,7 @@ Follows is a source code listing for all files that have been open sourced. This
               g: 255,
               b: 255,
               size_enum: -2
-            }.label,
+            }.label!,
             {
               x: 5,
               y: 35.from_top,
@@ -43140,7 +45377,7 @@ Follows is a source code listing for all files that have been open sourced. This
               g: 255,
               b: 255,
               size_enum: -2
-            }.label,
+            }.label!,
             {
               x: 5,
               y: 50.from_top,
@@ -43149,7 +45386,7 @@ Follows is a source code listing for all files that have been open sourced. This
               g: 255,
               b: 255,
               size_enum: -2
-            }.label,
+            }.label!,
             {
               x: 5,
               y: 65.from_top,
@@ -43158,7 +45395,7 @@ Follows is a source code listing for all files that have been open sourced. This
               g: 255,
               b: 255,
               size_enum: -2
-            }.label,
+            }.label!,
           ]
         end
   
@@ -43183,7 +45420,14 @@ Follows is a source code listing for all files that have been open sourced. This
         def hotload_init
           @hotload_if_needed = 0
           @mailbox_if_needed = 0
+  
+          # schema for file_mtimes
+          # { FILE_PATH: { current: (Time as Fixnum),
+          #                last:    (Time as Fixnum) },
+          #   FILE_PATH: { current: (Time as Fixnum),
+          #                last:    (Time as Fixnum) } }
           @file_mtimes = { }
+  
           @suppress_mailbox = true
           files_to_reload.each { |f| init_mtimes f }
           init_mtimes 'app/mailbox.rb'
@@ -43221,6 +45465,7 @@ Follows is a source code listing for all files that have been open sourced. This
               'dragon/symbol.rb',
               'dragon/numeric_deprecated.rb',
               'dragon/numeric.rb',
+              'dragon/hash_deprecated.rb',
               'dragon/hash.rb',
               'dragon/outputs_deprecated.rb',
               'dragon/array_docs.rb',
@@ -43253,6 +45498,7 @@ Follows is a source code listing for all files that have been open sourced. This
               'dragon/trace.rb',
               'dragon/readme_docs.rb',
               'dragon/hotload_client.rb',
+              'dragon/wizards.rb',
               'dragon/ios_wizard.rb',
               'dragon/itch_wizard.rb',
             ] + core_files_to_reload + @required_files
@@ -43271,10 +45517,8 @@ Follows is a source code listing for all files that have been open sourced. This
         end
   
         def init_mtimes file
-          current_key = "current_#{file}".to_sym
-          last_key = "last_#{file}".to_sym
-          @file_mtimes[current_key] ||= @ffi_file.mtime(file)
-          @file_mtimes[last_key] ||= @ffi_file.mtime(file)
+          @file_mtimes[file] ||= { current: @ffi_file.mtime(file),
+                                   last: @ffi_file.mtime(file) }
         end
   
         def hotload_source_files
@@ -43306,25 +45550,36 @@ Follows is a source code listing for all files that have been open sourced. This
         end
   
         def hotload_if_needed
+          return if Kernel.tick_count < 0
           hotload_source_files
           check_mailbox
         end
   
         def on_load_succeeded file
-          @rcb_sender.files_reloaded << file
-          @rcb_sender.reloaded_files << file
+          self.files_reloaded << file
+          self.reloaded_files << file
           Trace.untrace_classes!
         end
   
+        def reset_all_mtimes
+          @file_mtimes.each do |file, _|
+            @file_mtimes[file].current = @ffi_file.mtime(file)
+            @file_mtimes[file].last    = @file_mtimes[file].current
+          end
+  
+          files_to_reload.each do |file, _|
+            @file_mtimes[file] ||= {}
+            @file_mtimes[file].current = @ffi_file.mtime(file)
+            @file_mtimes[file].last    = @file_mtimes[file].current
+          end
+        end
+  
         def reload_if_needed file, force = false
-          current_key = "current_#{file}".to_sym
-          last_key = "last_#{file}".to_sym
-          @file_mtimes[current_key] ||= nil
-          @file_mtimes[last_key] ||= nil
-          @file_mtimes[current_key] = @ffi_file.mtime(file)
-          return if !force && @file_mtimes[last_key] == @file_mtimes[current_key]
+          @file_mtimes[file] ||= { current: @ffi_file.mtime(file), last: @ffi_file.mtime(file) }
+          @file_mtimes[file].current = @ffi_file.mtime(file)
+          return if !force && @file_mtimes[file].current == @file_mtimes[file].last
           on_load_succeeded file if reload_ruby_file file
-          @file_mtimes[last_key] = @file_mtimes[current_key]
+          @file_mtimes[file].last = @file_mtimes[file].current
         end
       end
     end
@@ -43366,6 +45621,30 @@ Follows is a source code listing for all files that have been open sourced. This
       end
     end
   
+    def char_byte
+      return nil if self.length == 0
+      c = self.each_char.first.bytes
+      c = c.first if c.is_a? Enumerable
+      c
+    end
+  
+    def insert_character_at index, char
+      t = each_char.to_a
+      t = (t.insert index, char)
+      t.join
+    end
+  
+    def excluding_character_at index
+      t = each_char.to_a
+      t.delete_at index
+      t.join
+    end
+  
+    def excluding_last_character
+      return "" if self.length <= 1
+      return excluding_character_at(self.length - 1)
+    end
+  
     def end_with_bang?
       self[-1] == "!"
     end
@@ -43583,7 +45862,7 @@ Follows is a source code listing for all files that have been open sourced. This
         log "#{self.failed.length} test(s) failed."
         self.failed.each do |h|
           log "**** Test name: :#{h[:m]}"
-          log "#{h[:e].to_s.gsub("* ERROR:", "").strip}"
+          log "#{h[:e].to_s.gsub("* ERROR:", "").strip}\n#{h[:e].__backtrace_to_org__}"
         end
       end
     end
@@ -43788,6 +46067,40 @@ Follows is a source code listing for all files that have been open sourced. This
   # MIT License
   # wizards.rb has been released under MIT (*only this file*).
   
+  class Wizard
+    def metadata_file_path
+      "metadata/game_metadata.txt"
+    end
+  
+    def get_metadata
+      metadata = $gtk.read_file metadata_file_path
+  
+      if !metadata
+        write_blank_metadata
+        metadata = $gtk.read_file metadata_file_path
+      end
+  
+      dev_id, dev_title, game_id, game_title, version, icon = *metadata.each_line.to_a
+  
+      {
+        dev_id:     dev_id.strip.gsub("#", "").gsub("devid=", ""),
+        dev_title:  dev_title.strip.gsub("#", "").gsub("devtitle=", ""),
+        game_id:    game_id.strip.gsub("#", "").gsub("gameid=", ""),
+        game_title: game_title.strip.gsub("#", "").gsub("gametitle=", ""),
+        version:    version.strip.gsub("#", "").gsub("version=", ""),
+        icon:       icon.strip.gsub("#", "").gsub("icon=", "")
+      }
+    end
+  end
+  
+  class WizardException < Exception
+    attr_accessor :console_primitives
+  
+    def initialize *console_primitives
+      @console_primitives = console_primitives
+    end
+  end
+  
   module GTK
     class Wizards
       attr_accessor :ios, :itch