ToiVideoOutputService Interface Reference

Description

Service:
This is a service and can be accessed through toi.videoOutputService

The Video Output Service is used to get and set video output configurations. It is also used to setup adaptive video mode rule sets. Adaptive video mode rule sets are mainly used to handle automatic aspect ratio conversion upon changes in the currently displayed video content. Adaptive video mode rule sets are defined at build time.

The Video Output service is also used to create instances of configuration sessions to modify the current video mode settings.

import "ToiVideoOutputService.idl";

Inheritance diagram for ToiVideoOutputService:
ToiEventTarget

List of all members.

Public Member Functions

ToiVideoOutputConfiguration getVideoConfiguration ()
ToiVideoOutputConfigurationSession createVideoConfigurationSession () raises (TToiInvalidArgumentException, TToiInvalidPreconditionException)
void setVideoSafeMode () raises (TToiInvalidPreconditionException)
void loadAdaptiveRuleSets (in TToiAdaptiveRuleSetNameSequence adaptiveRuleSets) raises (TToiNotEnoughResourcesException, TToiInvalidArgumentException)
TToiAdaptiveRuleSetNameSequence getAvailableAdaptiveRuleSetNames ()
TToiAdaptiveRuleSetNameSequence getLoadedAdaptiveRuleSetNames ()

Public Attributes

Events
const long ON_ADAPTIVE_RULE_CHANGED = 3200

Public Types

typedef sequence
< ToiVideoOutputServiceAdaptiveTransition
TToiAdaptiveTransitionSequence
typedef sequence< string > TToiAdaptiveRuleSetNameSequence

Member Typedef Documentation

Sequence of adaptive video ruleset names.

Sequence of adaptive state transitions.


Member Function Documentation

ToiVideoOutputConfigurationSession ToiVideoOutputService::createVideoConfigurationSession ( ) raises (TToiInvalidArgumentException, TToiInvalidPreconditionException)

This method creates a session that makes it possible to change the video output configuration.

Return values:
IToiVideoOutputConfigurationSessionToiVideoOutputConfigurationSession interface.
Exceptions:
TToiInvalidArgumentExceptionRaised if the specified application identifier is invalid.
TToiInvalidPreconditionExceptionRaised if another session is active.
TToiAdaptiveRuleSetNameSequence ToiVideoOutputService::getAvailableAdaptiveRuleSetNames ( )

Get a sequence of rule set names based on the available adaptive video rule sets that can be loaded.

Return values:
adaptiveRuleSetsA sequence of rule sets names.
TToiAdaptiveRuleSetNameSequence ToiVideoOutputService::getLoadedAdaptiveRuleSetNames ( )

Get a sequence of rule set names based on the adaptive video rule sets that have been loaded.

Return values:
adaptiveRuleSetsA sequence of rule sets names.
ToiVideoOutputConfiguration ToiVideoOutputService::getVideoConfiguration ( )

This method returns an address to the current video output configuration.

Return values:
IToiVideoOutputConfiguration
addressAddress to an ToiVideoOutputConfiguration interface.
void ToiVideoOutputService::loadAdaptiveRuleSets ( in TToiAdaptiveRuleSetNameSequence  adaptiveRuleSets) raises (TToiNotEnoughResourcesException, TToiInvalidArgumentException)

Loads a sequence of adaptive video rule sets based on their names. An empty sequence will unload all currently loaded rule sets. Each rule within a loaded rule set is evaluated in the order it is placed and all rule sets are evaluated in parallel.

Parameters:
adaptiveRuleSetsA sequence of rule set names.
Exceptions:
TToiNotEnoughResourcesExceptionRaised if necessary resource can not be allocated.
TToiInvalidArgumentExceptionRaised if the ruleset is unavailable.
void ToiVideoOutputService::setVideoSafeMode ( ) raises (TToiInvalidPreconditionException)

Sets the video outputs into a safe mode configuration.

Exceptions:
TToiInvalidPreconditionExceptionRaised if a configuration session is active.

Member Data Documentation

This is an Event identifier for ToiVideoOutputAdaptiveRuleChangedEvent.

This constant can also be accessed from toi.consts.ToiVideoOutputService.ON_ADAPTIVE_RULE_CHANGED.