Class: Gcloud::Vision::Annotation::Face::Features::Nose

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

Overview

# Nose

The landmarks of the nose in the features of a face.

Left and right are defined from the vantage of the viewer of the image, without considering mirror projections typical of photos. So ‘face.features.eyes.left` typically is the person’s right eye.

See Gcloud::Vision::Annotation::Face::Features and Gcloud::Vision::Annotation::Face.

Examples:

require "gcloud"

gcloud = Gcloud.new
vision = gcloud.vision

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

nose = face.features.nose

nose.tip
#=> #<Landmark (x: 225.23511, y: 122.47372, z: -25.817825)>

See Also:

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(left, bottom, tip, top, right) ⇒ Nose

Returns a new instance of Nose.



1487
1488
1489
1490
1491
1492
1493
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1487

def initialize left, bottom, tip, top, right
  @left   = left
  @bottom = bottom
  @tip    = tip
  @top    = top
  @right  = right
end

Instance Attribute Details

#bottom ⇒ Landmark (readonly)

The nose, bottom center.

Returns:

  • (Landmark) —

    the current value of bottom



1482
1483
1484
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1482

def bottom
  @bottom
end

#left ⇒ Landmark (readonly)

The nose, bottom left.

Returns:

  • (Landmark) —

    the current value of left



1482
1483
1484
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1482

def left
  @left
end

#right ⇒ Landmark (readonly)

The nose, bottom right.

Returns:

  • (Landmark) —

    the current value of right



1482
1483
1484
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1482

def right
  @right
end

#tip ⇒ Landmark (readonly)

The nose tip.

Returns:

  • (Landmark) —

    the current value of tip



1482
1483
1484
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1482

def tip
  @tip
end

#top ⇒ Landmark (readonly)

The midpoint between the eyes.

Returns:

  • (Landmark) —

    the current value of top



1482
1483
1484
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1482

def top
  @top
end

Instance Method Details

#inspect ⇒ Object 



1541
1542
1543
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1541

def inspect
  "#<Nose #{self}>"
end

#to_a ⇒ Array

Returns the object’s property values as an array.

Returns:

  • (Array) 


1500
1501
1502
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1500

def to_a
  to_ary
end

#to_ary ⇒ Array

Returns the object’s property values as an array.

Returns:

  • (Array) 


1509
1510
1511
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1509

def to_ary
  [left, bottom, tip, top, right]
end

#to_h ⇒ Hash

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

Returns:

  • (Hash) 


1518
1519
1520
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1518

def to_h
  to_hash
end

#to_hash ⇒ Hash

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

Returns:

  • (Hash) 


1527
1528
1529
1530
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1527

def to_hash
  { left: left.to_h, bottom: bottom.to_h, tip: tip.to_h,
    top: top.to_h, right: right.to_h }
end

#to_s ⇒ Object 



1533
1534
1535
1536
1537
1538
 
# File 'lib/gcloud/vision/annotation/face.rb', line 1533

def to_s
  tmplt = "(left: %s, bottom: %s, tip: %s, " \
            "top: %s, right: %s)"
  format tmplt, left.inspect, bottom.inspect, tip.inspect,
         top.inspect, right.inspect
end