Cuepoint Information File

"Cuepoint" is a feature to place timing information (event points) into a movie. Upon reaching the timing during playback that is defined for each event point, the callback function is invoked. And "Cuepoint Information File" is a text file defining these event points.

Format of a Cuepoint Information File

  1. The time unit (integer) is defined at the first line.
  2. At the second line or greater, "Time", "Value", "EventPointName" and String" are defined in a line and these data are separated by ',' (comma).
  3. The first parameter "Time" specifies when to publish an event and "Time" divided by the time unit becomes seconds.
  4. The second parameter "Value" is numerical value which can be used in an application.
  5. The third parameter "EventPointName" is the name of the event point.
  6. The fourth parameter "String" is a character string which can be used in an application. The library does not analyze this parameter and it should be handled by the application.
  7. The line starting from ';' (semi-colon) is processed as a comment.
  8. Supported character codes are ASCII, Shift JIS, UTF-8 and UTF-16 (UTF-16LE).

Cuepoint Information File Example

Example 1

In this example, the time unit is 1000. Events are published at 0, 5, 7, 8, 15, and 25 seconds, respectively. Strings for event point #3 and #4 are separated by comma and they should be analyzed on the application side.

;Time, Value, EventPointName, String
1000
0,0,navi1
5000,0,navi2
7000,1,evpt1,param,test
8000,1,evpt2,param1,300,param2,500
15000,0,navi3
15000,1,evpt3
25000,0,navi4