Records

Tracks contain records. A record is a collection of metadata that contains information about the media content. For example, face recognition produces records for each recognized face. All records in a track contain the same type of information and have the same schema.

When you process images or office documents, records contain a page number that indicates which page of the image or document the record is related to:

<record>
   <pageNumber>1</pageNumber>
   <trackname>OCR.Result</trackname>
   <OCRResult>
      <id>bcba9983-8dee-450e-9d67-3234e1a0c17a</id>
      <text>FOCUS ON ECONOMY</text>
      <region>
         <left>114</left>
         <top>476</top>
         <width>194</width>
         <height>19</height>
      </region>
      <confidence>84</confidence>
      <angle>0</angle>
      <source>image</source>
   </OCRResult>
</record>

When you process video, a record can represent data extracted from a single frame, or span multiple frames. Records created during video processing contain a timestamp that indicates which part of the video is described by the record. The timestamp includes a start time, peak time, duration, and end time. All of these values are provided in both epoch microseconds and ISO 8601 time format.

The peak time describes the time at which the event was most clearly visible in the video. For example, if you are running face recognition a face might appear in the video, remain in the scene for several seconds, and then leave the scene. The peak time describes the time at which the face was most clearly visible and at which face recognition recorded the highest confidence score.

The following is an example record produced by OCR, and shows an example timestamp:

<record>
   <timestamp>
      <startTime iso8601="2015-09-22T14:30:35.531005Z">1442932235531005</startTime>
      <duration iso8601="PT00H01M16.820000S">76820000</duration>
      <peakTime iso8601="2015-09-22T14:30:35.531005Z">1442932235531005</peakTime>
      <endTime iso8601="2015-09-22T14:31:52.351005Z">1442932312351005</endTime>
   </timestamp>
   <trackname>OCR.Result</trackname>
   <OCRResult>
      <id>bcba9983-8dee-450e-9d67-3234e1a0c17a</id>
      <text>FOCUS ON ECONOMY</text>
      <region>
         <left>114</left>
         <top>476</top>
         <width>194</width>
         <height>19</height>
      </region>
      <confidence>84</confidence>
      <angle>0</angle>
      <source>image</source>
   </OCRResult>
</record>

_HP_HTML5_bannerTitle.htm