Image Processing Objects

These objects allow you to detect and recognized objects in an individual image.

ARKImage

You create image instances to represent an image that you want to hand off to the image analyzer. An image may be created from a JPEG file or an in-memory buffer of RGBA or BGRA 32-bit pixels.

ARKImageAnalyzerConfiguration

An image analyzer configuration object stores the configuration information for an image analyzer, the object detector, face recognizer, badge detector, and shape detector. The configuration object is initialized with default values allowing the image analyzer to detect and recognize faces. You may also instantiate a configuration object based on one of a number of predefined configuration presets. A preset encapsulates all the configuration information needed to use the image analyzer for a specific type of task. (e.g. to recognize faces or to recognize and learn faces)

After you have instantiated a configuration object, set the cloud account, cloud environment, and the face recognizer directory name. This is the minimum required information you need to provide to allow the object tracker to successfully detect and recognize faces.

If you want to detect faces only without recognizing them, turn off the face recognizer stage by setting the Recognizer.Enabled property to false.

ARKImageAnalyzer

The image analyzer processes images in order to find objects like shapes, badges, and faces. Object detection and recognition are executed in real time. An image analyzer is connected to a delegate defined by a set of C callback functions passed to the image analyzer at creation time. The image analyzer informs its delegate when analysis is completed. The delegate can then use the image analyzer APIs to learn what kind of objects the image analyzer found and what their current spatial location, size, and state are.

ARKImageAnalysisResult

An image analysis result object contains a snapshot of the what was detected in an image. The image analyzer result contains a list of objects that have appeared in the current image.

ARKImageAnalyzedObject

An analyzed object represents a single and unique instance of an object the image analyzer has been able to detect in the image. An analyzed object has an axis-aligned bounding box that tells you where in the input video frame the tracked object can be found and what its size is.

ARKImageAnalyzedFace

An analyzed face represents a human face. An analyzed object may be linked to a person. If the image analyzer is able to recognize the face as belonging to a specific person, the tracked face provides a reference to the corresponding person object.

ARKImageAnalyzedBadge

An analyzed badge represents a rhino tags-style badge.

ARKImageAnalyzedShape

An analyzed shape represents an object such as a car or a person.

See Also