google-cloud-vision 0.31.0 → 0.32.0

data/lib/google/cloud/vision/annotation/normalized_vertex.rb

@@ -1,76 +0,0 @@
-# Copyright 2016 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-module Google
-  module Cloud
-    module Vision
-      class Annotation
-        ##
-        # # NormalizedVertex
-        #
-        # A normalized vertex in a set of bounding polygon vertices.
-        #
-        # @attr_reader [Float] x The X coordinate.
-        # @attr_reader [Float] y The Y coordinate.
-        #
-        class NormalizedVertex
-          attr_reader :x, :y
-
-          ##
-          # @private Creates a new NormalizedVertex instance.
-          def initialize x, y
-            @x = x
-            @y = y
-          end
-
-          ##
-          # Returns the object's property values as an array.
-          #
-          # @return [Array]
-          #
-          def to_a
-            [x, y]
-          end
-
-          ##
-          # Converts object to a hash. All keys will be symbolized.
-          #
-          # @return [Hash]
-          #
-          def to_h
-            { x: x, y: y }
-          end
-
-          # @private
-          def to_s
-            "(x: #{x.inspect}, y: #{y.inspect})"
-          end
-
-          # @private
-          def inspect
-            "#<NormalizedVertex #{self}>"
-          end
-
-          ##
-          # @private New Annotation::Entity::Bounds::Vertex from a Google API
-          # Client object.
-          def self.from_grpc grpc
-            new grpc.x, grpc.y
-          end
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/vision/annotation/object_localization.rb

@@ -1,115 +0,0 @@
-# Copyright 2018 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-require "google/cloud/vision/annotation/normalized_vertex"
-
-module Google
-  module Cloud
-    module Vision
-      class Annotation
-        class ObjectLocalization
-          ##
-          # @private The LocalizedObjectAnnotation GRPC object.
-          attr_accessor :grpc
-
-          ##
-          # @private Creates a new Web instance.
-          def initialize
-            @grpc = nil
-          end
-
-          ##
-          # Opaque entity ID. Should align with {Entity#mid}.
-          #
-          # @return [String] The opaque entity ID.
-          #
-          def mid
-            @grpc.mid
-          end
-
-          ##
-          # The BCP-47 language code, such as "en-US" or "sr-Latn".
-          #
-          # @see http://www.unicode.org/reports/tr35/#Unicode_locale_identifier
-          #
-          # @return [String] The language code.
-          #
-          def code
-            @grpc.language_code
-          end
-
-          ##
-          # Object name, expressed in its {#code} language.
-          #
-          # @return [String] The object name.
-          #
-          def name
-            @grpc.name
-          end
-
-          ##
-          # The score of the result. Range [0, 1].
-          #
-          # @return [Float] A value in the range [0, 1].
-          #
-          def score
-            @grpc.score
-          end
-
-          ##
-          # Image region to which this entity belongs.
-          #
-          # @return [Array<NormalizedVertex>] An array of normalized vertices.
-          #
-          def bounds
-            return [] unless @grpc.bounding_poly
-            @bounds ||= @grpc.bounding_poly.normalized_vertices.map do |v|
-              NormalizedVertex.from_grpc v
-            end
-          end
-
-          ##
-          # Deeply converts object to a hash. All keys will be symbolized.
-          #
-          # @return [Hash]
-          #
-          def to_h
-            { mid: mid, code: code, name: name, score: score,
-              bounds: bounds.map(&:to_h) }
-          end
-
-          # @private
-          def to_s
-            tmplt = "mid: %s, code: %s, name: %s, score: %s, " \
-                    " bounds: %i"
-            format tmplt, mid.inspect, code.inspect, name.inspect,
-                   score.inspect, bounds.count
-          end
-
-          # @private
-          def inspect
-            "#<#{self.class.name} #{self}>"
-          end
-
-          ##
-          # @private New Annotation::Face from a GRPC object.
-          def self.from_grpc grpc
-            new.tap { |ol| ol.instance_variable_set :@grpc, grpc }
-          end
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/vision/annotation/properties.rb

@@ -1,220 +0,0 @@
-# Copyright 2016 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-module Google
-  module Cloud
-    module Vision
-      class Annotation
-        ##
-        # # Properties
-        #
-        # A set of properties about an image, such as the image's dominant
-        # colors.
-        #
-        # See {Google::Cloud::Vision::Image#properties}.
-        #
-        # @example
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   image = vision.image "path/to/logo.jpg"
-        #
-        #   properties = image.properties
-        #   properties.colors.count #=> 10
-        #
-        class Properties
-          ##
-          # @private The ImageProperties GRPC object.
-          attr_accessor :grpc
-
-          ##
-          # @private Creates a new Properties instance.
-          def initialize
-            @grpc = nil
-          end
-
-          ##
-          # The image's dominant colors, including their corresponding scores.
-          #
-          # @return [Array<Color>] An array of the image's dominant colors.
-          #
-          def colors
-            return [] unless @grpc.dominant_colors
-            @colors ||= Array(@grpc.dominant_colors.colors).map do |c|
-              Color.from_grpc c
-            end
-          end
-
-          ##
-          # Returns the object's property values as an array.
-          #
-          # @return [Array]
-          #
-          def to_a
-            colors.map(&:rgb)
-          end
-
-          ##
-          # Deeply converts object to a hash. All keys will be symbolized.
-          #
-          # @return [Hash]
-          #
-          def to_h
-            { colors: colors.map(&:to_h) }
-          end
-
-          # @private
-          def to_s
-            "(colors: #{colors.count})"
-          end
-
-          # @private
-          def inspect
-            "#<Properties #{self}>"
-          end
-
-          ##
-          # @private New Annotation::Properties from a GRPC object.
-          def self.from_grpc grpc
-            new.tap { |f| f.instance_variable_set :@grpc, grpc }
-          end
-
-          ##
-          # # Color
-          #
-          # Color information consisting of RGB channels, score, and fraction of
-          # image the color occupies in the image.
-          #
-          # @example
-          #   require "google/cloud/vision"
-          #
-          #   vision = Google::Cloud::Vision.new
-          #
-          #   image = vision.image "path/to/logo.jpg"
-          #   properties = image.properties
-          #
-          #   color = properties.colors.first
-          #   color.red #=> 247.0
-          #   color.green #=> 236.0
-          #   color.blue #=> 20.0
-          #   color.rgb #=> "f7ec14"
-          #   color.alpha #=> 1.0
-          #   color.score #=> 0.20301803946495056
-          #   color.pixel_fraction #=> 0.007264957297593355
-          #
-          class Color
-            ##
-            # @private The ColorInfo GRPC object.
-            attr_accessor :grpc
-
-            ##
-            # @private Creates a new Color instance.
-            def initialize
-              @grpc = nil
-            end
-
-            ##
-            # The amount of red in the color.
-            #
-            # @return [Float] A value in the interval [0, 255].
-            #
-            def red
-              @grpc.color.red
-            end
-
-            ##
-            # The amount of green in the color.
-            #
-            # @return [Float] A value in the interval [0, 255].
-            #
-            def green
-              @grpc.color.green
-            end
-
-            ##
-            # The amount of blue in the color.
-            #
-            # @return [Float] A value in the interval [0, 255].
-            #
-            def blue
-              @grpc.color.blue
-            end
-
-            ##
-            # The amount this color that should be applied to the pixel. A value
-            # of 1.0 corresponds to a solid color, whereas a value of 0.0
-            # corresponds to a completely transparent color.
-            #
-            # @return [Float] A value in the range [0, 1].
-            #
-            def alpha
-              @grpc.color.alpha || 1.0
-            end
-
-            def rgb
-              red.to_i.to_s(16).rjust(2, "0") +
-                green.to_i.to_s(16).rjust(2, "0") +
-                blue.to_i.to_s(16).rjust(2, "0")
-            end
-
-            ##
-            # Image-specific score for this color.
-            #
-            # @return [Float] A value in the range [0, 1].
-            #
-            def score
-              @grpc.score
-            end
-
-            ##
-            # Stores the fraction of pixels the color occupies in the image.
-            #
-            # @return [Float] A value in the range [0, 1].
-            #
-            def pixel_fraction
-              @grpc.pixel_fraction
-            end
-
-            ##
-            # Converts object to a hash. All keys will be symbolized.
-            #
-            # @return [Hash]
-            #
-            def to_h
-              { red: red, green: green, blue: blue, alpha: alpha, rgb: rgb,
-                score: score, pixel_fraction: pixel_fraction }
-            end
-
-            def to_s
-              "(colors: #{rgb})"
-            end
-
-            def inspect
-              "#<Color #{self}>"
-            end
-
-            ##
-            # @private New Annotation::Properties from a GRPC
-            # object.
-            def self.from_grpc grpc
-              new.tap { |f| f.instance_variable_set :@grpc, grpc }
-            end
-          end
-        end
-      end
-    end
-  end
-end

data/lib/google/cloud/vision/annotation/safe_search.rb

@@ -1,153 +0,0 @@
-# Copyright 2016 Google LLC
-#
-# Licensed under the Apache License, Version 2.0 (the "License");
-# you may not use this file except in compliance with the License.
-# You may obtain a copy of the License at
-#
-#     https://www.apache.org/licenses/LICENSE-2.0
-#
-# Unless required by applicable law or agreed to in writing, software
-# distributed under the License is distributed on an "AS IS" BASIS,
-# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
-# See the License for the specific language governing permissions and
-# limitations under the License.
-
-
-require "google/cloud/vision/annotation/vertex"
-
-module Google
-  module Cloud
-    module Vision
-      class Annotation
-        ##
-        # # SafeSearch
-        #
-        # A set of features pertaining to the image, computed by various
-        # computer vision methods over safe-search verticals (for example,
-        # adult, spoof, medical, violence).
-        #
-        # @example
-        #   require "google/cloud/vision"
-        #
-        #   vision = Google::Cloud::Vision.new
-        #
-        #   image = vision.image "path/to/face.jpg"
-        #
-        #   safe_search = image.safe_search
-        #   safe_search.spoof? #=> false
-        #   safe_search.spoof #=> :VERY_UNLIKELY
-        #
-        class SafeSearch
-          POSITIVE_RATINGS = %i[POSSIBLE LIKELY VERY_LIKELY].freeze
-
-          ##
-          # @private The SafeSearchAnnotation GRPC object.
-          attr_accessor :grpc
-
-          ##
-          # @private Creates a new SafeSearch instance.
-          def initialize
-            @grpc = nil
-          end
-
-          ##
-          # Adult likelihood rating. Possible values are `VERY_UNLIKELY`,
-          # `UNLIKELY`, `POSSIBLE`, `LIKELY`, and `VERY_LIKELY`.
-          def adult
-            @grpc.adult
-          end
-
-          ##
-          # Adult likelihood. Returns `true` if {#adult} is `POSSIBLE`,
-          # `LIKELY`, or `VERY_LIKELY`.
-          #
-          # @return [Boolean]
-          #
-          def adult?
-            POSITIVE_RATINGS.include? adult
-          end
-
-          ##
-          # Spoof likelihood rating. Possible values are `VERY_UNLIKELY`,
-          # `UNLIKELY`, `POSSIBLE`, `LIKELY`, and `VERY_LIKELY`.
-          def spoof
-            @grpc.spoof
-          end
-
-          ##
-          # Spoof likelihood. Returns `true` if {#spoof} is `POSSIBLE`,
-          # `LIKELY`, or `VERY_LIKELY`.
-          #
-          # @return [Boolean]
-          #
-          def spoof?
-            POSITIVE_RATINGS.include? spoof
-          end
-
-          ##
-          # Medical likelihood rating. Possible values are `VERY_UNLIKELY`,
-          # `UNLIKELY`, `POSSIBLE`, `LIKELY`, and `VERY_LIKELY`.
-          def medical
-            @grpc.medical
-          end
-
-          ##
-          # Medical likelihood. Returns `true` if {#medical} is `POSSIBLE`,
-          # `LIKELY`, or `VERY_LIKELY`.
-          #
-          # @return [Boolean]
-          #
-          def medical?
-            POSITIVE_RATINGS.include? medical
-          end
-
-          ##
-          # Violence likelihood rating. Possible values are `VERY_UNLIKELY`,
-          # `UNLIKELY`, `POSSIBLE`, `LIKELY`, and `VERY_LIKELY`.
-          def violence
-            @grpc.violence
-          end
-
-          ##
-          # Violence likelihood. Returns `true` if {#violence} is `POSSIBLE`,
-          # `LIKELY`, or `VERY_LIKELY`.
-          #
-          # @return [Boolean]
-          #
-          def violence?
-            POSITIVE_RATINGS.include? violence
-          end
-
-          ##
-          # Converts object to a hash. All keys will be symbolized.
-          #
-          # @return [Hash]
-          #
-          def to_h
-            { adult: adult?, spoof: spoof?, medical: medical?,
-              violence: violence? }
-          end
-
-          # @private
-          def to_s
-            tmplt = "(adult?: %s, spoof?: %s, medical?: %s, " \
-                      "violence?: %s)"
-            format tmplt, adult?.inspect, spoof?.inspect, medical?.inspect,
-                   violence?.inspect
-          end
-
-          # @private
-          def inspect
-            "#<SafeSearch #{self}>"
-          end
-
-          ##
-          # @private New Annotation::SafeSearch from a GRPC object.
-          def self.from_grpc grpc
-            new.tap { |f| f.instance_variable_set :@grpc, grpc }
-          end
-        end
-      end
-    end
-  end
-end