perfect-shape 0.5.3 → 0.5.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d107db62b52ceb89ecb570f5bb1b77a8adde17cd6d2000e55d0ede5c88c37170
-  data.tar.gz: a785b27dd723cb869b64b37eb3bceef4e159f78e37b0a95816c05c340b7def8a
+  metadata.gz: 98226e1aac4fbac06b162630c2dbaa5ca2f749d24590cc0bd0cca9924f760635
+  data.tar.gz: 3d7d5be2905838db9ff1b3f2876e8437e0df90d9ac6b2316c1347aa4f58db626
 SHA512:
-  metadata.gz: aef22594d36b2dec69b4685b3040530b838f7eb37749e74ec9ad58a9586b55a302298c68a9ef7f11639975d5284899975059aa3e33b76506ef5e749be7ea11a7
-  data.tar.gz: 9a59946ad112068bd8e74ff49f843c58b2e73b07216d5ac6d06e5a3911ce006587cc895ba961b5e1eacb26bd997c43aebbba1a3640efee753fab093e4131087d
+  metadata.gz: 686a5054b13bd3adf1176e779e80d2ef758c4cf9cc25625633151628a724c1b802c03847301a447fb14155b570ee0fe0fdf8fe4d357b92186bdd7df83d6de240
+  data.tar.gz: e05c4a2eb8d2efa7feef615dc5dd3d522778d8aa98b60845726de0d3a0e68bf84ffa173984d0a907401838a16432b725ed1e0ac5ac1d4239ed66596181dac324

data/CHANGELOG.md

@@ -1,21 +1,36 @@
 # Change Log
 
+## 0.5.4
+
+- `PerfectShape::Rectangle#intersect?(rectangle)`
+- `PerfectShape::Square#intersect?(rectangle)`
+- `PerfectShape::Rectangle#empty?`
+- `PerfectShape::Square#empty?`
+- `PerfectShape::Square#size`/`PerfectShape::Square#size=` aliases for `#length`/`#length=`
+
 ## 0.5.3
 
-- `CubicBezierCurve#intersect?(rectangle)`
+- `PerfectShape::CubicBezierCurve#intersect?(rectangle)`
+- `PerfectShape::CubicBezierCurve#rectangle_crossings(rectangle)`
+- `PerfectShape::CubicBezierCurve#rect_crossings(rxmin, rymin, rxmax, rymax, level, crossings = 0)`
+- `PerfectShape::Line#rect_crossings(rxmin, rymin, rxmax, rymax, crossings = 0)`
 
 ## 0.5.2
 
-- `QuadraticBezierCurve#intersect?(rectangle)`
+- `PerfectShape::QuadraticBezierCurve#intersect?(rectangle)`
+- `PerfectShape::QuadraticBezierCurve::tag(coord, low, high)`
+- `PerfectShape::QuadraticBezierCurve::eqn(val, c1, cp, c2)`
+- `PerfectShape::QuadraticBezierCurve::solve_quadratic(eqn)`
+- `PerfectShape::QuadraticBezierCurve::eval_quadratic(vals, num, include0, include1, inflect, c1, ctrl, c2)`
 
 ## 0.5.1
 
-- `Point#intersect?(rectangle)` (equivalent to `Rectangle#contain?(point)`)
+- `PerfectShape::Point#intersect?(rectangle)` (equivalent to `PerfectShape::Rectangle#contain?(point)`)
 
 ## 0.5.0
 
-- `Line#intersect?(rectangle)`
-- `Rectangle#out_state(x_or_point, y = nil)`
+- `PerfectShape::Line#intersect?(rectangle)`
+- `PerfectShape::Rectangle#out_state(x_or_point, y = nil)`
 
 ## 0.4.0
 

data/README.md

@@ -1,4 +1,4 @@
-# Perfect Shape 0.5.3
+# Perfect Shape 0.5.4
 ## Geometric Algorithms
 [![Gem Version](https://badge.fury.io/rb/perfect-shape.svg)](http://badge.fury.io/rb/perfect-shape)
 [![Test](https://github.com/AndyObtiva/perfect-shape/actions/workflows/ruby.yml/badge.svg)](https://github.com/AndyObtiva/perfect-shape/actions/workflows/ruby.yml)
@@ -14,13 +14,13 @@ To ensure high accuracy, this library does all its mathematical operations with
 Run:
 
 ```
-gem install perfect-shape -v 0.5.3
+gem install perfect-shape -v 0.5.4
 ```
 
 Or include in Bundler `Gemfile`:
 
 ```ruby
-gem 'perfect-shape', '~> 0.5.3'
+gem 'perfect-shape', '~> 0.5.4'
 ```
 
 And, run:
@@ -372,8 +372,10 @@ Includes `PerfectShape::RectangularShape`
 - `#bounding_box`: bounding box is a rectangle with x = min x, y = min y, and width/height of shape
 - `#==(other)`: Returns `true` if equal to `other` or `false` otherwise
 - `#contain?(x_or_point, y=nil, outline: false, distance_tolerance: 0)`: checks if point is inside when `outline` is `false` or if point is on the outline when `outline` is `true`. `distance_tolerance` can be used as a fuzz factor when `outline` is `true`, for example, to help GUI users mouse-click-select a rectangle shape from its outline more successfully
+- `#intersect?(rectangle)`: Returns `true` if intersecting with interior of rectangle or `false` otherwise. This is useful for GUI optimization checks of whether a shape appears in a GUI viewport rectangle and needs redrawing
 - `#edges`: edges of rectangle as `PerfectShape::Line` objects
 - `#out_state(x_or_point, y = nil)`: Returns "out state" of specified point (x,y) (whether it lies to the left, right, top, bottom of rectangle). If point is outside rectangle, it returns a bit mask combination of `Rectangle::OUT_LEFT`, `Rectangle::OUT_RIGHT`, `Rectangle::OUT_TOP`, or `Rectangle::OUT_BOTTOM`. Otherwise, it returns `0` if point is inside the rectangle.
+- `#empty?`: Returns `true` if width or height are 0 (or negative) and `false` otherwise
 
 Example:
 
@@ -402,7 +404,7 @@ Extends `PerfectShape::Rectangle`
 
 ![square](https://raw.githubusercontent.com/AndyObtiva/perfect-shape/master/images/square.png)
 
-- `::new(x: 0, y: 0, length: 1)`: constructs a square
+- `::new(x: 0, y: 0, length: 1)` (`length` alias: `size`): constructs a square
 - `#x`: top-left x
 - `#y`: top-left y
 - `#length`: length
@@ -418,7 +420,9 @@ Extends `PerfectShape::Rectangle`
 - `#bounding_box`: bounding box is a rectangle with x = min x, y = min y, and width/height of shape
 - `#==(other)`: Returns `true` if equal to `other` or `false` otherwise
 - `#contain?(x_or_point, y=nil, outline: false, distance_tolerance: 0)`: checks if point is inside when `outline` is `false` or if point is on the outline when `outline` is `true`. `distance_tolerance` can be used as a fuzz factor when `outline` is `true`, for example, to help GUI users mouse-click-select a square shape from its outline more successfully
+- `#intersect?(rectangle)`: Returns `true` if intersecting with interior of rectangle or `false` otherwise. This is useful for GUI optimization checks of whether a shape appears in a GUI viewport rectangle and needs redrawing
 - `#edges`: edges of square as `PerfectShape::Line` objects
+- `#empty?`: Returns `true` if length is 0 (or negative) and `false` otherwise
 
 Example:
 

data/VERSION

@@ -1 +1 @@
-0.5.3
+0.5.4

data/lib/perfect_shape/rectangle.rb

@@ -97,5 +97,24 @@ module PerfectShape
       end
       out
     end
+    
+    # A rectangle is empty if its width or height is 0 (or less)
+    def empty?
+      width <= 0.0 || height <= 0.0
+    end
+    
+    def intersect?(rectangle)
+      x = rectangle.x
+      y = rectangle.y
+      w = rectangle.width
+      h = rectangle.height
+      return false if empty? || w <= 0 || h <= 0
+      x0 = self.x
+      y0 = self.y
+      (x + w) > x0 &&
+        (y + h) > y0 &&
+        x < (x0 + self.width) &&
+        y < (y0 + self.height)
+    end
   end
 end

data/lib/perfect_shape/square.rb

@@ -23,12 +23,15 @@ require 'perfect_shape/rectangle'
 
 module PerfectShape
   class Square < Rectangle
-    MESSAGE_WIDTH_AND_HEIGHT_AND_LENGTH_NOT_EQUAL = 'Square width, height, and length must all be equal if more than one is specified; or otherwise keep only one of them in arguments!'
+    MESSAGE_WIDTH_AND_HEIGHT_AND_LENGTH_NOT_EQUAL = 'Square width, height, and length must all be equal if more than one is specified; or otherwise keep only one of them in constructor arguments!'
   
     attr_reader :length
+    alias size length
     
     # Constructs with x, y, length (optionally width or height can be passed as alias for length)
-    def initialize(x: 0, y: 0, length: nil, width: nil, height: nil)
+    def initialize(x: 0, y: 0, length: nil, size: nil, width: nil, height: nil)
+      raise MESSAGE_WIDTH_AND_HEIGHT_AND_LENGTH_NOT_EQUAL if (length && size && length != size)
+      length ||= size
       raise MESSAGE_WIDTH_AND_HEIGHT_AND_LENGTH_NOT_EQUAL if (length && width && length != width) || (length && height && length != height) || (width && height && width != height)
       length ||= width || height || 1
       super(x: x, y: y, width: length, height: length)
@@ -40,6 +43,7 @@ module PerfectShape
       self.width = value unless width == value
       self.height = value unless height == value
     end
+    alias size= length=
     
     def width=(value)
       super

data/perfect-shape.gemspec

@@ -2,11 +2,11 @@
 # DO NOT EDIT THIS FILE DIRECTLY
 # Instead, edit Juwelier::Tasks in Rakefile, and run 'rake gemspec'
 # -*- encoding: utf-8 -*-
-# stub: perfect-shape 0.5.3 ruby lib
+# stub: perfect-shape 0.5.4 ruby lib
 
 Gem::Specification.new do |s|
   s.name = "perfect-shape".freeze
-  s.version = "0.5.3"
+  s.version = "0.5.4"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0".freeze) if s.respond_to? :required_rubygems_version=
   s.require_paths = ["lib".freeze]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: perfect-shape
 version: !ruby/object:Gem::Version
-  version: 0.5.3
+  version: 0.5.4
 platform: ruby
 authors:
 - Andy Maleh