12 CI Plus Application Level MMI
12.2 Application MMI Profile
The CI Plus Application shall conform with the MHEG-5 profile version 1.06 [D-Book 5.0, Sections 12-18][23] with some reduced functionality for a CI Plus compliant Host.
12.2.1
Application Domain
This specification is an application domain in the terms set out in Annex D of ISO 13522-5 [16] and D-Book 5.0 [23], Section 13. The CI Plus application domain is referred to "CIEngineProfile1".
12.2.2
Set of Classes
The set of classes is defined in D-Book 5.0 [23], 13.3 with the exceptions stated in Table 12.1:
Background Video Planes
Optional Application Plane(s) CI Plus Application MMI Plane Native Graphics Plane(s)
Viewer
Table 12.1: Class exceptions to D-Book 5.0
Class Notes
Font Required (see note)
Dynamic Line Art Not Required
HyperText Not Required
Note: See D-Book [23] and Section 12.5.1 Downloadable Fonts.
Receivers may optionally support "Not Required" classes but they shall not be used by a CI Plus Application unless referenced in the context of a different application domain or the application has confirmed the class exists.
12.2.3
Set of Features
The set of features is defined in D-Book 5.0 [23], section 13.4 with the following exceptions in Table 12.2:
Table 12.2: CIEngineProfile1 GetEngineSupport behaviour exceptions to D-Book 5.0
Feature Notes
Caching Not Required
Video Scaling Not Required
Scene Aspect Ratio Not Required
UniversalEngineProfile Shall adhere to D-Book and also support the CI Plus profile value
A full MHEG profile typically includes the stream object providing control of the audio and video components. To maintain the current video and audio an application typically creates a stream object containing active audio and video set to the default components. The application may then change the component tags to select the audio and video components. For the CI Plus profile the application is only allowed to use the default audio and video components. The CI Plus application is allowed to stop and start the stream in order to display an I-frame if it has permission using the resident program RequestMPEGDecoder.
The default components are taken to be whatever components are currently active on the receiver. The loading of a CI Plus application with default components set shall not change them. The current components may have been set by another application environment, such as MHP, and shall not be interfered with by the CI Plus application.
12.2.3.1
CI Plus Engine Profile
UniversalEngineProfile shall respond with a true response to a string argument of "CIPLUS001" which identifies the MHEG engine as being CI Plus Profile 1 compliant.
12.2.3.2
Not required features
Features identified as not required in this profile may be optionally implemented by Hosts conforming to this profile. This permits the CI Plus profile to co-exist with other MHEG-5 broadcast profiles.
CI Plus Applications shall not use any features identified as not required unless the application first checks that they are supported by the engine using the UniversalEngineProfile() or any other standard method to determine the capabilities of the environment.
The engine may only provide optional features from another profile(s) which have been certified i.e. features of the New Zealand MHEG profile may be active if the Host is certified for New Zealand.
12.2.3.3
Stream Objects
The application shall start with the default components active by specifying a stream object containing active audio and video objects set to the default component. Should the CI Plus application wish to stop the stream then it shall first gain permission using the resident program RequestMPEGDecoder, see section 12.3.6.
Any application that does not start with an active stream object with default components shall behave in an undefined way.
Any attempt to stop the video object or the whole stream without permission shall behave in an undefined way. Once permission has been granted, control of the MPEG decoder shall persist according to the normal resident application rules or until the CI Plus application releases it using RequestMPEGDecoder. Before releasing the MPEG decoder the application shall return the MPEG decoder to its normal state by removing any I-frame from the screen and restarting the stream objects with default audio and video component tags.
This mechanism ensures that the application operates in a predictable manner even if another application environment is active.
The CI Plus profile does not require stream objects to generate stream events.
12.2.3.4
RTGraphics / Subtitles
On launching the CI Plus Application MMI the subtitle state shall be determined from the CICAM Request Start message defined in section 12.6.2. Where subtitling is stopped to enable the launch of the CI Plus Application MMI then subtitling shall be re-enabled automatically when the CI Plus Application terminates.
12.2.4
GetEngineSupport
The GetEngineSupport "feature" strings of D-Book 5.0 [23] section 13.4.1 with the exception in table 12.3:
Table 12.3: GetEngineSupport "feature" strings
String Constraint
Standard Short
MultipleAudioStreams(N) MAS(N) May return "true" for N≤1 MultipleVideoStreams(N) MVS(N) May return "true" for N≤1
VideoScaling(CHook,X,Y)[a] VSc(CHook,X,Y)[a] May return "false" for all combinations of CHook, X & Y VideoDecodeOffset(CHook,Level) VDO(CHook,Level) May return "false" for all combinations of CHook, X & Y DownloadableFont(CHook) DLF(CHook) Shall return "true" for the values of CHook that are
supported by the Font class. Shall return "false" for all other values of N
12.3
Content Data Encoding
The content data encoding is defined in D-Book 5.0 [23], section 13.5 with exceptions defined in this and subsequent sections.
12.3.1
Content Table
In CIEngineProfile1 the table 13.7 will be as per D-Book 5.0 [23] with the following exception:
Table 12.4: Content Table
Attribute Permissible Values
Font See 12.5.1 "Downloadable Fonts"
12.3.2
Stream "memory" formats
In CIEngineProfile1 there is no requirement for stream memory formats, D-Book 5.0 [23] section 13.5.3.
12.3.3
User Input
The CI Plus Application shall have input focus and display priority if the CI Plus Application MMI co-exists with any other application engine (i.e. running simultaneously).
The UK Profile authoring requirement to always start in user input register 3 in the first scene shall not apply to the CI Plus application.
12.3.4
Engine Events
The minimum set of engine events that the engine shall support is defined in D-Book 5.0 [23] section 13.8, with the exception that the following EngineEvents are not required by CIEngineProfile1.
Table 12.5: CIEngineProfile1 EventData exceptions to D-Book 5.0
EventData Value Notes
VideoPrefChanged 6 Not Required NetworkBootInfo 9 Not Required
12.3.5
Protocol Mapping and External Connection
The protocol mapping and external connections of D-Book 5.0 [23] section 13.9 with the exception that Stream Actions and Stream Events are not required by CIEngineProfile1.
12.3.6
Resident Programs
The Resident Programs of D-Book 5.0 [23] section 13.10 with the exception of the following Resident Programs that are not required by CIEngineProfile1.
Table 12.6: CIEngineProfile1 Resident Program exceptions to D-Book 5.0
Resident Program Name Notes
SI_TuneIndex Tin Not Required
SI_TuneIndexInfo TII Not Required
GetBootInfo GBI Not Required
VideoToGraphics VTG Not Required
SetWidescreenAlignment SWA Not Required
SetSubtitleMode SSM Not Required
RequestMPEGDecoder RMD Note: Call only, See section 12.3.6.1.
12.3.6.1
RequestMPEGDecoder
Requests exclusive access to a MPEG decoder and video plane to display I-frames. The MPEG decoder shall be available when no other application environment is active.
Synopsis RMD(result) Arguments
in/out/ in-out
type name comment
in GenericBool request If 'true' then the MHEG application is requesting exclusive use of the MPEG decoder and video plane. If 'false' it is releasing use of said decoder.
output GenericBool result If request is 'true' then:
If the result is 'true' then I-frames may be used and shall remain available until the application exits, a new application starts (See D-Book 5.0 [23] section 13.10.12) or RequestMPEGDecoder is invoked again with request='false'.
If the result is false then the MPEG decoder is not available and I-frames may not be used.
If request is 'false' then:
result shall be 'false', the MPEG decoder is not available and I-frames may not be used.
Description If the CI Plus application requires to stop the broadcast stream and display an I-frame then it must first get permission to use the MPEG decoder. When the application has finished with the MPEG decoder it may release it by calling RequestMPEGDecoder with
request='false' however the application must have removed any I-frames from the display and restarted the stream with default components otherwise the results will be
unpredictable.