Rekognition for Processing

A quick Processing library to make using Rekognition API easy to use in Processing.

Rekognition is an open API platform provided by Orbeus, which helps developers easily incorporate the state-of-the-art computer vision capabilities of facial recognition, object recognition and scene understanding into your app or software.

Getting Started

To use the library, you'll need to:

• Register for an API Key with Orbeus, Inc.
• Install the HTTP Requests for Processing library.

How-to

Create library instance

Rekognition rekog = new Rekognition(this, APIKEY, APISECRET);
// Optionall set namespace and app name
rekog.setNamespace("processing");
rekog.setUserID("demo");

Basic Face Detection

// Get a list of faces
RFace[] faces = rekog.detectFacesPath(filename);
// Get face meta data
for (int i = 0; i < faces.length; i++) {
  PVector center = faces[i].center;
  PVector eye_right = faces[i].eye_right;
  PVector eye_right = faces[i].eye_right;
  PVector eye_left = faces[i].eye_left;
  PVector mouth_right = faces[i].mouth_right;
  PVector mouth_left = faces[i].mouth_left;
  PVector nose = faces[i].nose;

  String gender = faces[i].gender;
  float age = faces[i].age;

  // and more!
}

Train Face Recognition

// Here we tell Rekognition that the face in this image associated with this name
rekog.addFace("pitt.jpg", "Pitt");

// We need a second API call to train Rekognition of whatever faces have been added
// Here it's one face, then train, but you could add a lot of faces before training
rekog.train();

Face Recognize

for (int i = 0; i < faces.length; i++) {
  // Possible face matches come back in a FloatDict
  // A string (name of face) is paired with a float from 0 to 1 (how likely is it that face)
  FloatDict matches = faces[i].getMatches();
  for (String key : matches.keys()) {
    float likely = matches.get(key);
    println(key + ": " + likely);
  }
}