Stream Compiler Objects

[This is preliminary documentation and subject to change.]

The stream compiler objects are a set of Component Object Model (COM) objects that provide functionality to create, edit, and save enhancement streams. You can use these objects to create authoring tools to work with enhancement streams. For example, using these objects you can create tools such as a custom editor for enhancement streams or a stream player to view and test your interactive show.

Essentially, the stream compiler objects wrap the stream compiler syntax, exposing the syntax so its component parts can be easily accessed by applications. In addition, the compiler objects provide some syntax validation. While it is possible to write authoring tools that do not use the stream compiler objects, using them greatly simplifies the task.

The stream compiler's object library contains the following objects:

• EnhEvent, an object that wraps information about a particular enhancement event, such as an announcement, File Transfer Service (FTS) transmissions, or trigger.
• EnhEvents, a collection of EnhEvent objects. Using the EnhEvents object, you can manipulate the entire stream of events. You can rearrange events, search for a specific event, set default values, load or save the stream to a file, and so on.
• Annc, an object that wraps an enhancement announcement.

Another object useful when writing enhancement tools is the enhancement sender object, ipsend. This object connects to the broadcast medium and can transmit all three types of enhancement events: announcements, FTS transmissions, and triggers.