Create Bounding Box method

Author: DSchaedler

Dinraal

@@ -1,9 +1,5 @@
 {
   "folders": [
-    {
-      "retained": "E64A95092FCA80853577321769BF33F7:Dinraal",
-      "path": "/Dinraal"
-    },
     {
       "retained": "B8B47FE13002C6AF8FBD52C24767660C:dinraal",
       "path": "/dinraal"

README.md

@@ -15,32 +15,45 @@ def tick args
 end
 ```
 
-The library source file can be found at [https://github.com/DSchaedler/dinraal/blob/main/app/lib/dinraal.rb](https://github.com/DSchaedler/dinraal/blob/main/app/lib/dinraal.rb).  
-(app/lib/dinraal.rb)
+The library source file can be found at [app/lib/dinraal.rb](https://github.com/DSchaedler/dinraal/blob/main/app/lib/dinraal.rb).
 
-A more detailed sample app is at [https://github.com/DSchaedler/dinraal/blob/main/app/main.rb](https://github.com/DSchaedler/dinraal/blob/main/app/main.rb).  
-(app/main.rb)
+A more detailed sample app is at [app/main.rb](https://github.com/DSchaedler/dinraal/blob/main/app/main.rb).
 
 # Common Parameters
 
 All methods in Dinraal accept their options in hash notation. This allows for extra or missing options to be ignored or inferred.
 
 ## Usually Required
-x =  (int, float) x position of point 1 on the triangle.  
-y =  (int, float) y position of point 1 on the triangle.  
-x2 = (int, float) x position of point 2 on the triangle.  
-y2 = (int, float) y position of point 2 on the triangle.  
-x3 = (int, float) x position of point 3 on the triangle.  
-y3 = (int, float) y position of point 3 on the triangle.  
+```
+x =  (int, float) x position of point 1 on the triangle.
+y =  (int, float) y position of point 1 on the triangle.
+x2 = (int, float) x position of point 2 on the triangle.
+y2 = (int, float) y position of point 2 on the triangle.
+x3 = (int, float) x position of point 3 on the triangle.
+y3 = (int, float) y position of point 3 on the triangle.
+```
 
 ## Usually Optional
-r =  (int, float) red portion of the triangle's color.  
-g =  (int, float) green portion of the triangle's color.  
-b =  (int, float) blue portion of the triangle's color.  
-a =  (int, float) alpha portion of the triangle's color.  
+```
+r =  (int, float) red portion of the triangle's color.
+g =  (int, float) green portion of the triangle's color.
+b =  (int, float) blue portion of the triangle's color.
+a =  (int, float) alpha portion of the triangle's color.
+```
 
 # Methods
 
+## `bounding_box`
+```ruby
+Dinraal.bounding_box( { x: point1_x, y: point1_y, x2: point2_x, y2: point2_y, x3: point3_x, y3: point3_y } )
+```
+
+Returns a rectangle that contains the given triangle.
+
+```ruby
+{ x: x, y: y, w: width, h: height }
+```
+
 ## `center`
 ```ruby
 Dinraal.center( { x: point1_x, y: point1_y, x2: point2_x, y2: point2_y, x3: point3_x, y3: point3_y } )
@@ -96,4 +109,21 @@ It is recommended to call this method and cache it's result, as it will lag with
 
 # TODO
 
-- Create `bounding_box` method.
+- Create `tri_intersects?` method
+- Create `rect_intersects?` method
+- Create `tri_inside?` method
+- Create `rect_inside?` method
+- Create `inradius` method - [Incircle Math Breakdown](https://artofproblemsolving.com/wiki/index.php/Incircle)
+- Create `area` method - [Heron's Formula](https://artofproblemsolving.com/wiki/index.php/Heron%27s_Formula)
+- - Vector based calculations will be faster, but less straightforward to impliment
+- Create `perimiter` method
+-
+
+# How to contribute
+- Submit a Pull Request with any code improvements
+- Impliment any item from the TODO list.
+- Write a sample app that more clearly shows all methods
+- Write a tutorial
+- Submit improved calculation methods
+- - Speed improvements to the `raster` method
+- - Vector calculations for area over Heron's Formula

app/lib/dinraal.rb

@@ -2,6 +2,23 @@
 # By D Schaedler. Released under MIT License.
 # https://github.com/DSchaedler/dinraal
 module Dinraal
+  def bounding_box(options = {})
+    x = options[:x]
+    y = options[:y]
+    x2 = options[:x2]
+    y2 = options[:y2]
+    x3 = options[:x3]
+    y3 = options[:y3]
+
+    x_min = [x, x2, x3].min
+    x_max = [x, x2, x3].max
+
+    y_min = [y, y2, y3].min
+    y_max = [y, y2, y3].max
+
+    { x: x_min, y: y_min, w: x_max - x_min, h: y_max - y_min }
+  end
+
   def center(options = {})
     x = options[:x]
     y = options[:y]

app/main.rb

@@ -26,6 +26,8 @@ def tick(args)
   # Draw a label to display if the mouse inside the red triangle
   args.outputs.labels << { x: args.grid.center_x, y: 720, text: "Mouse inside red: #{mouse_inside}", alignment_enum: 1 }
 
+  args.outputs.borders << Dinraal.bounding_box(tri2)
+
   # Optional Debug Information. Uncomment to show
   # args.outputs.debug << args.gtk.framerate_diagnostics_primitives
 end