SIST ETS 300 777-3 E1:2003

Terminal Equipment (TE); End-to-end protocols for multimedia information retrieval services; Part 3: Application Programmable Interface (API) for MHEG-5

This ETS will specify an API between an MHEG-5 engine and its applications (eg scripts) which provides: - interpretation services and - access services on MHEG-5 objects. Note: MHEG-5 is a subset of MHEG-1 for basic level implementations

Terminalska oprema (TE) – Protokoli sistema konec-konec za multimedijske informacijske poiskavne storitve – 3. del: Aplikacijski programski vmesnik (API) za MHEG-5

General Information

• Status: Published
• Publication Date: 30-Nov-2003
• ICS: 33.160.60 - Multimedia systems and teleconferencing equipment
• ICS: 35.180 - IT Terminal and other peripheral equipment
• Technical Committee: SS EIT - Technical Board for the electrotechnical, information technology and telecommunications fields
• Current Stage: 6060 - National Implementation/Publication (Adopted Project)
• Start Date: 01-Dec-2003
• Due Date: 01-Dec-2003
• Completion Date: 01-Dec-2003
• Ref Project: ETSI ETS 300 777-3 ed.1 (1997-09) - Terminal Equipment (TE); End-to-end protocols for multimedia information retrieval services; Part 3: Application Programmable Interface (API) for MHEG-5

Standards Content (Sample)

SLOVENSKI STANDARD
SIST ETS 300 777-3 E1:2003
01-december-2003
Terminalska oprema (TE) – Protokoli sistema konec-konec za multimedijske
informacijske poiskavne storitve – 3. del: Aplikacijski programski vmesnik (API) za
MHEG-5
Terminal Equipment (TE); End-to-end protocols for multimedia information retrieval
services; Part 3: Application Programmable Interface (API) for MHEG-5
Ta slovenski standard je istoveten z: ETS 300 777-3 Edition 1
ICS:
33.160.60 9HþSUHGVWDYQLPXOWLPHGLMVNL Multimedia systems and
VLVWHPLLQRSUHPD]D teleconferencing equipment
WHOHNRQIHUHQFH
35.180 Terminalska in druga IT Terminal and other
periferna oprema IT peripheral equipment
SIST ETS 300 777-3 E1:2003 en
2003-01.Slovenski inštitut za standardizacijo. Razmnoževanje celote ali delov tega standarda ni dovoljeno.

---------------------- Page: 1 ----------------------

SIST ETS 300 777-3 E1:2003

---------------------- Page: 2 ----------------------

SIST ETS 300 777-3 E1:2003
EUROPEAN ETS 300 777-3
TELECOMMUNICATION September 1997
STANDARD
Source: MTA Reference: DE/MTA-011057-3
Formerly: DE/TE-010157-3
ICS: 33.020
Key words: API, MHEG, multimedia, terminal
Terminal Equipment (TE);
End-to-end protocols for, multimedia information
retrieval services;
Part 3: Application Programmable Interface (API) for MHEG-5
ETSI
European Telecommunications Standards Institute
ETSI Secretariat
Postal address: F-06921 Sophia Antipolis CEDEX - FRANCE
Office address: 650 Route des Lucioles - Sophia Antipolis - Valbonne - FRANCE
X.400: c=fr, a=atlas, p=etsi, s=secretariat - Internet: [e-mail]
Tel.: [phone] - Fax: [phone]
Copyright Notification: No part may be reproduced except as authorized by written permission. The copyright and the
foregoing restriction extend to reproduction in all media.
© European Telecommunications Standards Institute 1997. All rights reserved.

---------------------- Page: 3 ----------------------

SIST ETS 300 777-3 E1:2003
Page 2
ETS 300 777-3: September 1997
Whilst every care has been taken in the preparation and publication of this document, errors in content,
typographical or otherwise, may occur. If you have comments concerning its accuracy, please write to
"ETSI Editing and Committee Support Dept." at the address shown on the title page.

---------------------- Page: 4 ----------------------

SIST ETS 300 777-3 E1:2003
Page 3
ETS 300 777-3: September 1997
Contents
Foreword .5
1 Scope .7
2 Normative references.7
3 Definitions and abbreviations .7
3.1 Definitions .7
3.2 Abbreviations .8
4 Overview .8
4.1 The DAVIC application interchange format .8
4.2 Core set of Java APIs .8
5 The MHEG-5 API .9
6 Map between MHEG-5 elementary actions and MHEG-5 API operations.26
History.29

---------------------- Page: 5 ----------------------

SIST ETS 300 777-3 E1:2003
Page 4
ETS 300 777-3: September 1997
Blank page

---------------------- Page: 6 ----------------------

SIST ETS 300 777-3 E1:2003
Page 5
ETS 300 777-3: September 1997
Foreword
This European Telecommunication Standard (ETS) has been produced by the Terminal Equipment (TE)
Technical Committee of the European Telecommunications Standards Institute (ETSI).
This ETS consists of four parts as follows:
Part 1: "Coding of multimedia and hypermedia information for basic multimedia applications
(MHEG-5)";
Part 2: "Use of Digital Storage Media Command and Control (DSM-CC) for basic multimedia
applications ";
Part 3: "Application Programmable Interface (API) for MHEG-5";
Part 4: "Videotex Man Machine Interface (VEMMI) enhancements to support broadband multimedia
information retrieval services".
Transposition dates
Date of adoption: 5 September 1997
Date of latest announcement of this ETS (doa): 31 December 1997
Date of latest publication of new National Standard
or endorsement of this ETS (dop/e): 30 June 1998
Date of withdrawal of any conflicting National Standard (dow): 30 June 1998

---------------------- Page: 7 ----------------------

SIST ETS 300 777-3 E1:2003
Page 6
ETS 300 777-3: September 1997
Blank page

---------------------- Page: 8 ----------------------

SIST ETS 300 777-3 E1:2003
Page 7
ETS 300 777-3: September 1997
1 Scope
This European Telecommunications Standard (ETS) specifies the Application Programmable Interface
(API) for the manipulation of multimedia and hypermedia information objects, i.e. the API that shall be
provided by MHEG-5 engines for their control by applications running on a DAVIC 1.1 compliant terminal.
MHEG part 5 (ISO/IEC 13522-5 [1]) is a standard, which specifies the coded representation of
interchanged multimedia/hypermedia information objects (MHEG-5 objects) for base level applications.
These so-called MHEG-5 objects are handled, interpreted and presented by MHEG-5 engines.
2 Normative references
This ETS incorporates by dated and undated reference, provisions from other publications. These
references are cited at the appropriate places in the text and the publications are listed hereafter. For
dated references, subsequent amendments to or revisions of any of these publications apply to this ETS
only when incorporated in it by amendment or revision. For undated references the latest edition of the
publication referred to applies.
[1] ISO/IEC IS 13522-5 (1997): "Information technology - Coding of Multimedia and
Hypermedia Information - Part 5: Support for Base-Level Interactive
Applications".
[2] ETS 300 777-1: "Terminal Equipment (TE); End-to-end protocols for multimedia
information retrieval services; Part 1: Coding of multimedia and hypermedia
information for basic multimedia applications (MHEG-5)".
[3] ETS 300 777-2: "Terminal Equipment (TE); End-to-end protocols for multimedia
information retrieval services; Part 2: Use of Digital Storage Media Command
and Control (DSM-CC) for basic multimedia applications".
[4] ISO/IEC 13522-6 : "Information technology - Coding of Multimedia and
Hypermedia Information - Part 6: Support for enhanced interactive applications".
3 Definitions and abbreviations
3.1 Definitions
For the purposes of this ETS, the definitions of the standards referenced below apply. Should any
ambiguity occur, definitions of the following standards apply, in decreasing order:
- ISO/IEC IS 13522-5 [1] MHEG-5;
- any other standard part of ISO/IEC 13522 MHEG.
Application Programmable Interface (API): A boundary across which a software application uses
facilities of programming languages to invoke software services. These facilities may include procedures
or operations, shared data objects and resolution of identifiers.
local application: A piece of software which is part of the (telecommunication) application and is running
on the considered equipment.
MHEG-5 API: The API provided by an MHEG-5 engine to local applications for the manipulation of
MHEG-5 objects, as defined in this ETS.
MHEG-5 engine: A process or a set of processes that interpret MHEG-5 objects encoded according to
the encoding specifications of ETS 300 777-1 [2] or the MHEG-5 textual notation.

---------------------- Page: 9 ----------------------

SIST ETS 300 777-3 E1:2003
Page 8
ETS 300 777-3: September 1997
3.2 Abbreviations
For the purposes of this ETS, the following abbreviations apply:
API Application Programmable Interface
ASN.1 Abstract Syntax Notation One
DAVIC Digital Audio Visual Council
DSM-CC Digital Storage Media Command and Control
MHEG Multimedia and Hypermedia information coding Experts Group
SI Service Information
STU Set Top Unit
U-U User to User
VM Virtual Machine
4 Overview
The following subclause positions the API defined by this ETS in the framework of the DAVIC
specifications.
4.1 The DAVIC application interchange format
To deliver multimedia information to STUs in an interoperable way, applications shall use the MHEG-5
final form interchange format, as defined by ISO/IEC 13522-5 [1]. The ASN.1 notation and encoding, as
defined by ETS 300 777-1 [2], shall be used to interchange MHEG-5 objects. This format defines the
semantics and the encoding of the multimedia and hypermedia objects.
To deliver program code to STUs in an interoperable way, applications shall use the MHEG-5
Interchanged Program class to encapsulate DAVIC VM code, according to the semantics and encoding
defined by ISO/IEC 13522-6 [4]. Java VM classes are called from MHEG-5 objects using the MHEG-5 call
and fork elementary actions.
The Java VM code interchange unit is a Java VM class. Java VM classes shall be encoded as defined by
the Class File Format section of the Java Virtual Machine specification. A Java class encapsulates data
and methods that consist of sequences of instructions. The instruction set is defined by the Java Virtual
Machine instruction set section of the Java Virtual Machine specification.
4.2 Core set of Java APIs
The following set of APIs are used by Java VM code in the DAVIC 1.1 specifications to express access to
basic functions of the STU in an interoperable way:
- the java.lang package;
- the java.util package;
- the iso.mheg5 package;
- the davic.dsmccuu package;
- the etsi.si package.
NOTE 1: The Java VM specification provides flexible mechanisms to call upon external
functions whose interface is defined as a Java package. The DAVIC 1.1 specification
only includes a minimum core set of packages required for Java VM code to be useful
in a DAVIC environment. It is anticipated that additional Java packages will be
standardized at a later stage.
NOTE 2: Especially, the java.io package, although strictly speaking not necessary to the useful
performance of the VM environment, is part of the Java foundation classes. It is
intended that the java.io package be added to the DAVIC core set of Java APIs
together with an adequate specification of its semantics in a DAVIC environment.
The java.lang package, as defined by the Java API documentation, consists of the minimal set of Java
VM classes needed to run Java VM code, supporting the following functionality: basic data types, object,
mathematical operations, security, thread management, string manipulation, exception handling.

---------------------- Page: 10 ----------------------

SIST ETS 300 777-3 E1:2003
Page 9
ETS 300 777-3: September 1997
The java.util package, as defined by the Java API documentation, consists of Java VM classes
supporting a number of utility features common to all Java VM programs.
The iso.mheg5 package, as defined by this ETS, provides Java VM code with access to and
manipulation of the MHEG-5 multimedia presentation and interaction objects, i.e. access to the dynamic
attributes of MHEG-5 objects and invocation of elementary actions on MHEG-5 objects.
The davic.dsmccuu package, together with the associated davic.CosNaming and
davic.CosNaming.NamingContext_ packages, as defined by ETS 300 777-2 [3], enables Java VM
code to use the DSM-CC U-U interface objects for network data access.
The davic.dsmccuu package implements a subset of the DSM-CC U-U API. Access to the following Core
SetTop services is provided:
- interface Base: operations Close and Destroy;
- interface File: operations Read and Write;
- interface Directory: operations Open, Close and Get;
- interface ServiceGateway: operations Attach and Detach;
- interface CosNaming::NamingContext: operations List and Resolve;
- interface CosNaming::BindingIterator: operations Next_One and Next_N.
The etsi.si package enables Java VM code to access information transmitted in the DAVIC Service
Information (SI) stream.
5 The MHEG-5 API
// -----------------------------------------------------------------------------
// Package
// -----------------------------------------------------------------------------
package iso.mheg5;
// -----------------------------------------------------------------------------
// Useful definitions
// -----------------------------------------------------------------------------
public class ObjectReference
{
/* Attributes */
// The groupIdentifier attribute is optional (it may be empty)
public byte[] groupIdentifier;
public int objectNumber;
/* Constructors */
public ObjectReference();
public ObjectReference(
int objectNumber);
public ObjectReference(
byte[] groupIdentifier,
int objectNumber);
}
// -----------------------------------------------------------------------------
public class ContentReference
{
/* Attributes */
byte[] reference;
/* Constructors */
public ContentReference();
public ContentReference(
byte[] reference);
}
// -----------------------------------------------------------------------------
public class MhegException extends java.lang.Exception
{

---------------------- Page: 11 ----------------------

SIST ETS 300 777-3 E1:2003
Page 10
ETS 300 777-3: September 1997
/* Attributes */
// Constant declarations for exceptionCode
public static final short TARGET_NOT_AVAILABLE = 1;
public static final short INVALID_TARGET = 2;
public static final short INVALID_PARAMETER = 3;
public short exceptionCode;
public short parameterRank;
/* Constructors */
protected MhegException();
// Construct an MhegException with exceptionCode identified by the reason parameter
public MhegException(
short reason)
{
exceptionCode = reason;
parameterRank = -1;
}
// Construct an MhegException with exceptionCode identified by the reason parameter and
parameterRank
// by the position parameter
public MhegException(
short reason,
short position)
{
exceptionCode = reason;
parameterRank = position;
}
}
// -----------------------------------------------------------------------------
abstract public class Root
{
/* Constructors */
protected Root();
/* Methods */
// Return the reference of the Java object associated with the MHEG-5 object whose identification
is
// mheg5ObjectReference
// If the Java object does not exist, create it first
public static final Root getObject(
ObjectReference mheg5ObjectReference)
throws MhegException;
// Correspond to the GetAvailabilityStatus MHEG-5 elementary action
public Boolean getAvailabilityStatus()
throws MhegException;
// Correspond to the GetRunningStatus MHEG-5 elementary action
public Boolean getRunningStatus()
throws MhegException;
}
// -----------------------------------------------------------------------------
abstract public class Group extends Root
{
/* Constructors */
protected Group();
/* Methods */
// Correspond to the SetCachePriority MHEG-5 elementary action
// The cachePriority parameter value shall be within the range [0,255]
public void setCachePriority(
byte cachePriority)
throws MhegException;
// Retrieve the value of the GroupCachePriority attribute
public Integer getCachePriority()
throws MhegException;
}

---------------------- Page: 12 ----------------------

SIST ETS 300 777-3 E1:2003
Page 11
ETS 300 777-3: September 1997
// -----------------------------------------------------------------------------
public class Application extends Group
{
/* Constructors */
protected Application();
/* Methods */
// Correspond to the LockScreen MHEG-5 elementary action
public void lockScreen()
throws MhegException;
// Correspond to the UnlockScreen MHEG-5 elementary action
public void unlockScreen()
throws MhegException;
// Retrieve the value of the LockCount attribute
// The wrapped returned value shall be positive or equal to zero
public Integer getLockCount()
throws MhegException;
// Correspond to the GetEngineSupport MHEG-5 elementary action
public Boolean getEngineSupport(byte[] feature)
throws MhegException;
}
// -----------------------------------------------------------------------------
public class Scene extends Group
{
/* Constructors */
protected Scene();
/* Methods */
// Correspond to the TransitionTo MHEG-5 elementary action
public void transitionTo()
throws MhegException;
public void transitionTo(
int connectionTag)
throws MhegException;
public void transitionTo(
byte transitionEffect)
throws MhegException;
public void transitionTo(
int connectionTag,
byte transitionEffect)
throws MhegException;
// Correspond to the SetTimer MHEG-5 elementary action
public void setTimer(
int timerId)
throws MhegException;
public void setTimer(
int timerId,
int timerValue)
throws MhegException;
public void setTimer(
int timerId,
int timerValue,
boolean absoluteTime)
throws MhegException;
// Retrieve the value of the TimerPosition (in the timerPosition parameter) and AbsoluteTime (in
the
// absoluteTime parameter) fields of the timer whose identification is timerId in the Timers
attribute
// If the targetted timer exists, the method returns true otherwise false
public boolean getTimer(
int timerId,
Integer timerPosition,
Boolean absoluteTime)
throws MhegException;
// Correspond to the SendEvent MHEG-5 elementary action
public void sendEvent(
ObjectReference eventSource,
byte eventType)
throws MhegException;
public void sendEvent(

---------------------- Page: 13 ----------------------

SIST ETS 300 777-3 E1:2003
Page 12
ETS 300 777-3: September 1997
ObjectReference eventSource,
byte eventType,
boolean eventData)
throws MhegException;
public void sendEvent(
ObjectReference eventSource,
byte eventType,
int eventData)
throws MhegException;
public void sendEvent(
ObjectReference eventSource,
byte eventType,
byte[] eventData)
throws MhegException;
// Correspond to the SetCursorShape MHEG-5 elementary action
public void setCursorShape()
throws MhegException;
public void setCursorShape(
ObjectReference cursorShape)
throws MhegException;
// Retrieve the shape of the cursor
// A returned null object reference indicates that the cursor has been removed from the scene
public ObjectReference getCursorShape()
throws MhegException;
// Correspond to the SetCursorPosition MHEG-5 elementary action
public void setCursorPosition(
short xCursor,
short yCursor)
throws MhegException;
// Correspond to the GetCursorPosition MHEG-5 elementary action
public void getCursorPosition(
Integer xCursor,
Integer yCursor)
throws MhegException;
}
// -----------------------------------------------------------------------------
abstract public class Ingredient extends Root
{
/* Constructors */
protected Ingredient();
/* Methods */
// Correspond to the SetData MHEG-5 elementary action
public void setData(
byte[] includedContent)
throws MhegException;
public void setData(
ContentReference referencedContent)
throws MhegException;
public void setData(
ContentReference referencedContent,
int contentSize)
throws MhegException;
public void setData(
ContentReference referencedContent,
byte contentCachePriority)
throws MhegException;
public void setData(
ContentReference referencedContent,
int contentSize,
byte contentCachePriority)
throws MhegException;
// Retrieve the value of the ContentData attribute
// The returned value shall be true and content shall be of type byte[] for an included content
// The returned value shall be false and content shall be of type ContentReference for a
referenced content
// contentSize and contentCachePriority are output parameters which are valid only for a
referenced content
public boolean getData(
Object content,
Integer contentSize,
Integer contentCachePriority)
throws MhegException;
// Correspond to the Clone MHEG-5 elementary action

---------------------- Page: 14 ----------------------

SIST ETS 300 777-3 E1:2003
Page 13
ETS 300 777-3: September 1997
public ObjectReference clone()
throws MhegException;
// Correspond to the Preload MHEG-5 elementary action
public void preload()
throws MhegException;
// Correspond to the Unload MHEG-5 elementary action
public void unload()
throws MhegException;
}
// -----------------------------------------------------------------------------
public class Link extends Ingredient
{
/* Constructors */
protected Link();
/* Methods */
// Correspond to the Activate MHEG-5 elementary action
public void activate()
throws MhegException;
// Correspond to the Deactivate MHEG-5 elementary action
public void deactivate()
throws MhegException;
}
// -----------------------------------------------------------------------------
public class Program extends Ingredient
{
/* Constructors */
protected Program();
/* Methods */
// Correspond to the Call MHEG-5 elementary action
// Every element of the parameters array shall be of one of the following types: Boolean,
Integer, byte[],
// ObjectReference or ContentReference; otherwise, an exception is raised
public boolean call(
Object[] parameters)
throws MhegException;
// Correspond to the Fork MHEG-5 elementary action
// Every element of the parameters array shall be of one of the following types: Boolean,
Integer, byte[],
// ObjectReference or ContentReference; otherwise, an exception is raised
public boolean fork(
Object[] parameters)
throws MhegException;
// Correspond to the Stop MHEG-5 elementary action
public void stop()
throws MhegException;
}
// -----------------------------------------------------------------------------
public class ResidentProgram extends Program
{
/* Constructors */
protected ResidentProgram();
}
// -----------------------------------------------------------------------------
public class RemoteProgram extends Program
{
/* Constructors */
protected RemoteProgram();

---------------------- Page: 15 ----------------------

SIST ETS 300 777-3 E1:2003
Page 14
ETS 300 777-3: September 1997
}
// -----------------------------------------------------------------------------
public class InterchangedProgram extends Program
{
/* Constructors */
protected InterchangedProgram();
}
// -----------------------------------------------------------------------------
public class Palette extends Ingredient
{
/* Constructors */
protected Palette();
}
// -----------------------------------------------------------------------------
public class Font extends Ingredient
{
/* Constructors */
protected Font();
}
// -----------------------------------------------------------------------------
public class CursorShape extends Ingredient
{
/* Constructors */
protected CursorShape();
}
// -----------------------------------------------------------------------------
public class Variable extends Ingredient
{
/* Constructors */
protected Variable();
}
// -----------------------------------------------------------------------------
public class BooleanVariable extends Variable
{
/* Constructors */
protected BooleanVariable();
/* Methods */
// Correspond to the SetVariable MHEG-5 elementary action targetted at a BooleanVariable object
public void setVariable(
boolean value)
throws MhegException;
// Retrieve the value of the variable
public Boolean getVariable()
throws MhegException;
}
// -----------------------------------------------------------------------------
public class IntegerVariable extends Variable
{
/* Constructors */
protected IntegerVariable();
/* Methods */
// Correspond to the SetVariable MHEG-5 elementary action targetted at an IntegerVariable object
public void setVariable(

---------------------- Page: 16 ----------------------

SIST ETS 300 777-3 E1:2003
Page 15
ETS 300 777-3: September 1997
int value)
throws MhegException;
// Retrieve the value of the variable
public Integer getVariable()
throws MhegException;
// Correspond to the Add MHEG-5 elementary action
public void add(
int value)
throws MhegException;
// Correspond to the Subtract MHEG-5 elementary action
public void subtract(
int value)
throws MhegException;
// Correspond to the Multiply MHEG-5 elementary action
public void multiply(
int value)
throws MhegException;
// Correspond to the Divide MHEG-5 elementary action
public void divide(
int value)
throws MhegException;
// Correspond to the Modulo MHEG-5 elementary action
public void modulo(
int value)
throws MhegException;
}
// -----------------------------------------------------------------------------
public class OctetStringVariable extends Variable
{
/* Constructors */
protected OctetStringVariable();
/* Methods */
// Correspond to the SetVariable MHEG-5 elementary action targetted at an OctetStringVariable
object
public void setVariable(
byte[] value)
throws MhegException;
// Retrieve the value of the variable
public byte[] getVariable()
throws MhegException;
// Correspond to the Append MHEG-5 elementary action
public void append(
byte[] value)
throws MhegException;
}
// -----------------------------------------------------------------------------
public class ObjectRefVariable extends Variable
{
/* Constructors */
protected ObjectRefVariable();
/* Methods */
// Correspond to the SetVariable MHEG-5 elementary action targetted at an ObjectRefVariable
object
public void setVariable(
ObjectReference value)
throws MhegException;
// Retrieve the value of the variable
public ObjectReference getVariable()
throws MhegException;
}
// -----------------------------------------------------------------------------

---------------------- Page: 17 ----------------------

SIST ETS 300 777-3 E1:2003
Page 16
ETS 300 777-3: September 1997
public class ContentRefVariable extends Variable
{
/* Constructors */
protected ContentRefVariable();
/* Methods */
// Correspond to the SetVariable MHEG-5 elementary action targetted at an ContentRefVariable
object
public void setVariable(
ContentReference value)
throws MhegException;
// Retrieve the value of the variable
public ContentReference getVariable()
throws MhegException;
}
// -----------------------------------------------------------------------------
abstract public class Presentable extends Ingredient
{
/* Constructors */
protected Presentable();
/* Methods */
// Correspond to the Run MHEG-5 elementary action
public void run()
throws MhegException;
// Correspond to the Stop MHEG-5 elementary action
public void stop()
throws MhegException;
}
// -----------------------------------------------------------------------------
public interface TokenManager
{
/* Methods */
// Correspond to the Move MHEG-5 elementary action
public void move(
short movementId)
throws MhegException;
// Correspond to the MoveTo MHEG-5 elementary action
// The index parameter value shall be within the range [0, number of elements in the group]
public void moveTo(
short index)
throws MhegException;
// Correspond to the GetTokenPosition MHEG-5 elementary action
public Integer getTokenPosition()
throws MhegException;
}
// -----------------------------------------------------------------------------
public class TokenGroup extends Presentable implements TokenManager
{
/* Constructors */
protected TokenGroup();
/* Methods */
// Correspond to the implementation of the TokenManager.move method
public void move(
short movementId)
throws MhegException;
// Correspond to the implementation of the TokenManager.moveTo method
// The index parameter value shall be within the range [0, number of elements in the group]
public void moveTo(
short index)
throws MhegException;
// Correspond to the implementation of the TokenManager.getTokenPosition method

---------------------- Page: 18 ----------------------

SIST ETS 300 777-3 E1:2003
Page 17
ETS 300 777-3: September 1997
public Integer getTokenPosition()
throws MhegException;
// Correspond to the CallActionSlot MHEG-5 elementary action
// The index parameter value shall be within the range [0, number of elements in the group]
public void callActionSlot(
short index)
throws MhegException;
}
// -----------------------------------------------------------------------------
public class ListGroup extends TokenGroup
{
/* Constructors */
protected ListGroup();
/* Methods */
// Correspond to the AddItem MHEG-5 elementary action
public void addItem(
short itemIndex,
ObjectReference visibleReference)
throws MhegException;
// Correspond to the DelItem MHEG-5 elementary action
public void delItem(
ObjectReference visibleReference)
throws MhegException;
// Correspond to the GetListItem MHEG-5 elementary action
public ObjectReference getListItem(
short itemIndex)
throws MhegException;
// Correspond to the GetCellItem MHEG-5 elementary action
public ObjectReference getCellItem(
short cellIndex)
throws MhegException;
// Correspond to the GetItemStatus MHEG-5 elementary action
public Boolean getItemStatus(
short itemIndex)
throws MhegException;
// Correspond to the SelectItem MHEG-5 elementary action
public void selectItem(
short itemIndex)
throws MhegException;
// Correspond to the DeselectItem MHEG-5 elementary action
public void deselectItem(
short itemIndex)
throws MhegException;
// Correspond to the ToggleItem MHEG-5 elementary action
public void toggleItem(
short itemIndex)
throws MhegException;
// Correspond to the ScrollItems MHEG-5 elementary action
public void scrollItems(
short itemsToScroll)
throws MhegException;
// Correspond to the SetFirstItem MHEG-5 elementary action
public void setFirstIte
...