Media Server 25.1
Media Server Help

# 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>

Copyright 2024 Open Text
Version 25.1 | Last updated January 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: Knowledge Discovery Media Server 25.1

Topic Title: ListObjectClassAnnotations