AddObjectClassImages

Adds training images to an object class recognizer.

Type: synchronous

Parameter Description Required
recognizer The name of the recognizer to add the images to. Yes
imagedata The training images to add. Send files to Media Server using a multipart/form-data HTTP POST request. Set this or imagepath.
imagelabels A comma-separated list of labels to identify the images that you are adding (maximum 254 bytes for each label). Every image added to the same recognizer must have a unique label, so the number of labels must match the number of images provided using either imagedata or imagepath. If you do not set this parameter, Media Server generates labels automatically. No
imagepath A comma-separated list of paths to the training images to add. The paths must be absolute, or relative to the Media Server executable file. Set this or imagedata.

Example

The following example adds training images to an object class recognizer by specifying the paths of the images using the imagepath parameter:

curl http://localhost:14000/action=AddObjectClassImages
                            -F recognizer=vehicles
                            -F imagepath=image1.jpg,image2.jpg
                            -F imagelabels=image1,image2

Alternatively, you can add training images by sending the image data, for example:

curl http://localhost:14000/action=AddObjectClassImages
                            -F recognizer=vehicles
                            -F imagedata=@image1.jpg,image2.jpg
                            -F imagelabels=image1,image2

Response

<autnresponse>
  <action>ADDOBJECTCLASSIMAGES</action>
  <response>SUCCESS</response>
  <responsedata>
    <image>
      <index>1</index>
      <label>image1</label>
    </image>
    <image>
      <index>2</index>
      <label>image2</label>
    </image>
  </responsedata>
</autnresponse>

See Also

  • The object class recognizer must already exist. To create one, use the action CreateObjectClassRecognizer.
  • After adding training images you can annotate them. An annotation identifies a region of a training image that contains an object, and the class that the object belongs to. Media Server can then use that region of the image to train the recognizer. To add annotations, use the action AddObjectClassAnnotations.