rgeo 0.3.3 → 0.3.4

data/lib/rgeo/feature/polygon.rb

@@ -1,15 +1,15 @@
 # -----------------------------------------------------------------------------
-# 
+#
 # Polygon feature interface
-# 
+#
 # -----------------------------------------------------------------------------
-# Copyright 2010 Daniel Azuma
-# 
+# Copyright 2010-2012 Daniel Azuma
+#
 # All rights reserved.
-# 
+#
 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are met:
-# 
+#
 # * Redistributions of source code must retain the above copyright notice,
 #   this list of conditions and the following disclaimer.
 # * Redistributions in binary form must reproduce the above copyright notice,
@@ -18,7 +18,7 @@
 # * Neither the name of the copyright holder, nor the names of any other
 #   contributors to this software, may be used to endorse or promote products
 #   derived from this software without specific prior written permission.
-# 
+#
 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -35,106 +35,106 @@
 
 
 module RGeo
-  
+
   module Feature
-    
-    
+
+
     # == SFS 1.1 Description
-    # 
+    #
     # A Polygon is a planar Surface defined by 1 exterior boundary and 0 or
     # more interior boundaries. Each interior boundary defines a hole in
     # the Polygon.
-    # 
+    #
     # The assertions for Polygons (the rules that define valid Polygons)
     # are as follows:
-    # 
+    #
     # (a) Polygons are topologically closed;
-    # 
+    #
     # (b) The boundary of a Polygon consists of a set of LinearRings that
     # make up its exterior and interior boundaries;
-    # 
+    #
     # (c) No two Rings in the boundary cross and the Rings in the boundary
     # of a Polygon may intersect at a Point but only as a tangent;
-    # 
+    #
     # (d) A Polygon may not have cut lines, spikes or punctures;
-    # 
+    #
     # (e) The interior of every Polygon is a connected point set;
-    # 
+    #
     # (f) The exterior of a Polygon with 1 or more holes is not connected.
     # Each hole defines a connected component of the exterior.
-    # 
+    #
     # In the above assertions, interior, closure and exterior have the
     # standard topological definitions. The combination of (a) and (c) make
     # a Polygon a regular closed Point set.
-    # 
+    #
     # Polygons are simple geometric objects.
-    # 
+    #
     # == Notes
-    # 
+    #
     # Polygon is defined as a module and is provided primarily
     # for the sake of documentation. Implementations need not necessarily
     # include this module itself. Therefore, you should not depend on the
     # kind_of? method to check type. Instead, use the provided check_type
     # class method (or === operator) defined in the Type module.
-    
+
     module Polygon
-      
+
       include Surface
       extend Type
-      
-      
+
+
       # === SFS 1.1 Description
-      # 
+      #
       # Returns the exterior ring of this Polygon.
-      # 
+      #
       # === Notes
-      # 
+      #
       # Returns an object that supports the LinearRing interface.
-      
+
       def exterior_ring
         raise Error::UnsupportedOperation, "Method Polygon#exterior_ring not defined."
       end
-      
-      
+
+
       # === SFS 1.1 Description
-      # 
+      #
       # Returns the number of interiorRings in this Polygon.
-      # 
+      #
       # === Notes
-      # 
+      #
       # Returns an integer.
-      
+
       def num_interior_rings
         raise Error::UnsupportedOperation, "Method Polygon#num_interior_rings not defined."
       end
-      
-      
+
+
       # === SFS 1.1 Description
-      # 
+      #
       # Returns the Nth interiorRing for this Polygon as a LineString.
-      # 
+      #
       # === Notes
-      # 
+      #
       # Returns an object that supports the LinearRing interface, or nil
       # if the given N is out of range. N is zero-based.
       # Does not support negative indexes.
-      
+
       def interior_ring_n(n_)
         raise Error::UnsupportedOperation, "Method Polygon#interior_ring_n not defined."
       end
-      
-      
+
+
       # Returns the interior rings as a (possibly empty) array of objects
       # that support the LinearRing interface.
-      
+
       def interior_rings
         raise Error::UnsupportedOperation, "Method Polygon#interior_rings not defined."
       end
-      
-      
+
+
     end
-  
-    
+
+
   end
-  
+
 end

data/lib/rgeo/feature/surface.rb

@@ -1,15 +1,15 @@
 # -----------------------------------------------------------------------------
-# 
+#
 # Surface feature interface
-# 
+#
 # -----------------------------------------------------------------------------
-# Copyright 2010 Daniel Azuma
-# 
+# Copyright 2010-2012 Daniel Azuma
+#
 # All rights reserved.
-# 
+#
 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are met:
-# 
+#
 # * Redistributions of source code must retain the above copyright notice,
 #   this list of conditions and the following disclaimer.
 # * Redistributions in binary form must reproduce the above copyright notice,
@@ -18,7 +18,7 @@
 # * Neither the name of the copyright holder, nor the names of any other
 #   contributors to this software, may be used to endorse or promote products
 #   derived from this software without specific prior written permission.
-# 
+#
 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -35,87 +35,87 @@
 
 
 module RGeo
-  
+
   module Feature
-    
-    
+
+
     # == SFS 1.1 Description
-    # 
+    #
     # A Surface is a 2-dimensional geometric object.
-    # 
+    #
     # A simple Surface consists of a single "patch" that is associated with
     # one "exterior boundary" and 0 or more "interior" boundaries. Simple
     # Surfaces in 3-dimensional space are isomorphic to planar Surfaces.
     # Polyhedral Surfaces are formed by "stitching" together simple
     # Surfaces along their boundaries, polyhedral Surfaces in 3-dimensional
     # space may not be planar as a whole.
-    # 
+    #
     # The boundary of a simple Surface is the set of closed Curves
     # corresponding to its "exterior" and "interior" boundaries.
-    # 
+    #
     # The only instantiable subclass of Surface defined in this
     # specification, Polygon, is a simple Surface that is planar.
-    # 
+    #
     # == Notes
-    # 
+    #
     # Surface is defined as a module and is provided primarily
     # for the sake of documentation. Implementations need not necessarily
     # include this module itself. Therefore, you should not depend on the
     # kind_of? method to check type. Instead, use the provided check_type
     # class method (or === operator) defined in the Type module.
-    # 
+    #
     # Some implementations may support higher dimensional points.
-    
+
     module Surface
-      
+
       include Geometry
       extend Type
-      
-      
+
+
       # === SFS 1.1 Description
-      # 
+      #
       # The area of this Surface, as measured in the spatial reference
       # system of this Surface.
-      # 
+      #
       # === Notes
-      # 
+      #
       # Returns a floating-point scalar value.
-      
+
       def area
         raise Error::UnsupportedOperation, "Method Surface#area not defined."
       end
-      
-      
+
+
       # === SFS 1.1 Description
-      # 
+      #
       # The mathematical centroid for this Surface as a Point. The result
       # is not guaranteed to be on this Surface.
-      # 
+      #
       # === Notes
-      # 
+      #
       # Returns an object that supports the Point interface.
-      
+
       def centroid
         raise Error::UnsupportedOperation, "Method Surface#centroid not defined."
       end
-      
-      
+
+
       # === SFS 1.1 Description
-      # 
+      #
       # A Point guaranteed to be on this Surface.
-      # 
+      #
       # === Notes
-      # 
+      #
       # Returns an object that supports the Point interface.
-      
+
       def point_on_surface
         raise Error::UnsupportedOperation, "Method Surface#point_on_surface not defined."
       end
-      
-      
+
+
     end
-  
-    
+
+
   end
-  
+
 end

data/lib/rgeo/feature/types.rb

@@ -1,15 +1,15 @@
 # -----------------------------------------------------------------------------
-# 
+#
 # Feature type management and casting
-# 
+#
 # -----------------------------------------------------------------------------
-# Copyright 2010 Daniel Azuma
-# 
+# Copyright 2010-2012 Daniel Azuma
+#
 # All rights reserved.
-# 
+#
 # Redistribution and use in source and binary forms, with or without
 # modification, are permitted provided that the following conditions are met:
-# 
+#
 # * Redistributions of source code must retain the above copyright notice,
 #   this list of conditions and the following disclaimer.
 # * Redistributions in binary form must reproduce the above copyright notice,
@@ -18,7 +18,7 @@
 # * Neither the name of the copyright holder, nor the names of any other
 #   contributors to this software, may be used to endorse or promote products
 #   derived from this software without specific prior written permission.
-# 
+#
 # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
 # AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
 # IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
@@ -35,108 +35,108 @@
 
 
 module RGeo
-  
+
   module Feature
-    
-    
+
+
     # All geometry implementations MUST include this submodule.
     # This serves as a marker that may be used to test an object for
     # feature-ness.
-    
+
     module Instance
     end
-    
-    
+
+
     # These methods are available as module methods (not instance methods)
     # of the various feature types.
     # For example, you may determine whether a feature object is a
     # point by calling:
-    # 
+    #
     #   ::RGeo::Feature::Point.check_type(object)
-    # 
+    #
     # A corresponding === operator is provided so you can use the type
     # modules in a case-when clause.
-    # 
+    #
     # You may also use the presence of this module to determine whether
     # a particular object is a feature type:
-    # 
+    #
     #   object.kind_of?(::RGeo::Feature::Type)
-    
+
     module Type
-      
-      
+
+
       # Deprecated alias for RGeo::Feature::Instance
       Instance = Feature::Instance
-      
-      
+
+
       # Returns true if the given object is this type or a subtype
       # thereof, or if it is a feature object whose geometry_type is
       # this type or a subtype thereof.
-      # 
+      #
       # Note that feature objects need not actually include this module.
-      
+
       def check_type(rhs_)
         rhs_ = rhs_.geometry_type if rhs_.kind_of?(Feature::Instance)
         rhs_.kind_of?(Type) && (rhs_ == self || rhs_.include?(self))
       end
       alias_method :===, :check_type
-      
-      
+
+
       # Returns true if this type is the same type or a subtype of the
       # given type.
-      
+
       def subtype_of?(type_)
         self == type_ || self.include?(type_)
       end
-      
-      
+
+
       # Returns the supertype of this type. The supertype of Geometry
       # is nil.
-      
+
       def supertype
         @supertype
       end
-      
-      
+
+
       # Iterates over the known immediate subtypes of this type.
-      
+
       def each_immediate_subtype(&block_)
         @subtypes.each(&block_) if @subtypes
       end
-      
-      
+
+
       # Returns the OpenGIS type name of this type.
-      
+
       def type_name
         self.name.sub('RGeo::Feature::', '')
       end
-      
-      
+
+
       def _add_subtype(type_)  # :nodoc:
         (@subtypes ||= []) << type_
       end
-      
-      
+
+
       def self.extended(type_)  # :nodoc:
         supertype_ = type_.included_modules.find{ |m_| m_.kind_of?(self) }
         type_.instance_variable_set(:@supertype, supertype_)
         supertype_._add_subtype(type_) if supertype_
       end
-      
-      
+
+
     end
-    
-    
+
+
     class << self
-      
-      
+
+
       # Cast the given object according to the given parameters, if
       # possible, and return the resulting object. If the requested cast
       # is not possible, nil is returned.
-      # 
+      #
       # Parameters may be provided as a hash, or as separate arguments.
       # Hash keys are as follows:
-      # 
+      #
       # [<tt>:factory</tt>]
       #   Set the factory to the given factory. If this argument is not
       #   given, the original object's factory is kept.
@@ -172,16 +172,16 @@ module RGeo
       # passed as symbols, and their effect is the same as setting their
       # values to true. You can even combine separate arguments and hash
       # arguments. For example, the following three calls are equivalent:
-      # 
+      #
       #  RGeo::Feature.cast(geom, :type => RGeo::Feature::Point, :project => true)
       #  RGeo::Feature.cast(geom, RGeo::Feature::Point, :project => true)
       #  RGeo::Feature.cast(geom, RGeo::Feature::Point, :project)
-      # 
+      #
       # RGeo provides a default casting algorithm. Individual feature
       # implementation factories may override this and customize the
       # casting behavior by defining the override_cast method. See
       # ::RGeo::Feature::Factory#override_cast for more details.
-      
+
       def cast(obj_, *params_)
         # Interpret params
         factory_ = obj_.factory
@@ -204,13 +204,13 @@ module RGeo
         project_ = opts_[:project]
         nfactory_ = opts_.delete(:factory) || factory_
         ntype_ = opts_.delete(:type) || type_
-        
+
         # Let the factory override
         if nfactory_.respond_to?(:override_cast)
           override_ = nfactory_.override_cast(obj_, ntype_, opts_)
           return override_ unless override_ == false
         end
-        
+
         # Default algorithm
         ntype_ = type_ if keep_subtype_ && type_.include?(ntype_)
         if ntype_ == type_
@@ -322,11 +322,11 @@ module RGeo
           end
         end
       end
-      
-      
+
+
     end
-  
-    
+
+
   end
-  
+
 end