Class: Google::Cloud::Vision::Annotation::Face::Bounds

Inherits:
Object
  • Object
show all
Defined in:
lib/google/cloud/vision/annotation/face.rb

Overview

Bounds

Bounding polygons around the face.

See Google::Cloud::Vision::Annotation::Face.

Examples:

require "google/cloud/vision"

vision = Google::Cloud::Vision.new

image = vision.image "path/to/face.jpg"
face = image.face

face.bounds.face.count #=> 4
face.bounds.face.first #=> #<Vertex (x: 153, y: 34)>

Instance Method Summary collapse

Instance Method Details

#face ⇒ Object

This bounding polygon is tighter than the #head, and encloses only the skin part of the face. Typically, it is used to eliminate the face from any image annotation that detects the "amount of skin" visible in an image. It is not based on the landmarks, only on the initial face detection.



276
277
278
279
280
281
 
# File 'lib/google/cloud/vision/annotation/face.rb', line 276

def face
  return [] unless @grpc.fd_bounding_poly
  @face ||= Array(@grpc.fd_bounding_poly.vertices).map do |v|
    Vertex.from_grpc v
  end
end

#head ⇒ Object

The bounding polygon around the face. The coordinates of the bounding box are in the original image's scale, as returned in ImageParams. The bounding box is computed to "frame" the face in accordance with human expectations. It is based on the landmarker results. Note that one or more x and/or y coordinates may not be generated in the BoundingPoly (the polygon will be unbounded) if only a partial face appears in the image to be annotated.



263
264
265
266
267
268
 
# File 'lib/google/cloud/vision/annotation/face.rb', line 263

def head
  return [] unless @grpc.bounding_poly
  @head ||= Array(@grpc.bounding_poly.vertices).map do |v|
    Vertex.from_grpc v
  end
end

#to_a ⇒ Array

Returns the object's property values as an array.

Returns:

  • (Array) 


288
289
290
 
# File 'lib/google/cloud/vision/annotation/face.rb', line 288

def to_a
  [head.map(&:to_a), face.map(&:to_a)]
end

#to_h ⇒ Hash

Deeply converts object to a hash. All keys will be symbolized.

Returns:

  • (Hash) 


297
298
299
 
# File 'lib/google/cloud/vision/annotation/face.rb', line 297

def to_h
  { head: head.map(&:to_h), face: face.map(&:to_h) }
end