ListObjectClassAnnotations
Lists the annotations that you have added to your training images. 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.
Type: synchronous
Parameter | Description | Required |
---|---|---|
recognizer
|
The name of the recognizer to list annotations for. | Yes |
imagelabels
|
A comma-separated list of image labels to list the annotations for. Set this parameter to list annotations only for selected images. | No |
identifiers
|
A comma-separated list of object class identifiers to list the annotations for. Set this parameter to list annotations only for selected object classes. | No |
Example
The following example lists all annotations for the vehicles
recognizer.
/action=ListObjectClassAnnotations&recognizer=vehicles
This action can return a significant amount of data, so you might use the imagelabels
parameter to return the annotations for a single image:
/action=ListObjectClassAnnotations&recognizer=vehicles&imagelabels=image1
Response
The following XML is an example response that shows the annotations for a single image. There are two annotations. The first identifies a region to use to train the car
object class and the second identifies a region to use to train the van
object class. The left
, top
, width
, and height
values for the region are always returned in pixels, even if the values were set using percentages.
<autnresponse> <action>LISTOBJECTCLASSANNOTATIONS</action> <response>SUCCESS</response> <responsedata> <image> <imagelabel>image1</imagelabel> <annotations> <annotation> <annotationlabel>annotation1</annotationlabel> <identifier>car</identifier> <region> <left>0</left> <top>50</top> <width>50</width> <height>50</height> </region> </annotation> <annotation> <annotationlabel>annotation2</annotationlabel> <identifier>van</identifier> <region> <left>50</left> <top>0</top> <width>50</width> <height>50</height> </region> </annotation> </annotations> </image> </responsedata> </autnresponse>