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
vertex = face.bounds.face.first
vertex.x #=> 28
vertex.y #=> 40

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.



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

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.



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

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) 


290
291
292
 
# File 'lib/google/cloud/vision/annotation/face.rb', line 290

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) 


299
300
301
 
# File 'lib/google/cloud/vision/annotation/face.rb', line 299

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