Description

The ToiVideoOutputConfigurationSession interface allows session based changes of video output settings. If a display is (dis)connected or changed during a session (see ToiVideoOutputConfigurationDisplayChangedEvent ) while ToiVideoOutputConfigurationSession::apply() is not called for outstanding changes, the session must be either cleared or released. A call to ToiVideoOutputConfigurationSession::apply() in other cases result in undefined behavior. Releasing the session instance has the benefit of a new revert-point that matches the fall-back settings of the new display.

import "ToiVideoOutputConfigurationSession.idl";

Inheritance diagram for ToiVideoOutputConfigurationSession:

List of all members.

Public Member Functions
void	setDisplayInfo (in ToiVideoOutputConfiguration::TToiVideoOutputId outputId, in ToiVideoOutputConfiguration::TToiVideoModeSequence modes, in ToiVideoOutputConfiguration::TToiAspectRatio aspectRatio) raises (TToiInvalidArgumentException)
void	resetDisplayInfo (in ToiVideoOutputConfiguration::TToiVideoOutputId outputId)
void	setDefaultVideoMode (in ToiVideoOutputConfiguration::TToiVideoOutputId outputId, in ToiVideoOutputConfiguration::TToiVideoMode mode) raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)
void	setColorSpace (in ToiVideoOutputConfiguration::TToiVideoOutputId outputId, in ToiVideoOutputConfiguration::TToiColorSpace colorSpace) raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)
void	setSharpness (in ToiVideoOutputConfiguration::TToiVideoOutputId outputId, in long sharpness) raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)
void	setScartMode (in ToiVideoOutputConfiguration::TToiVideoOutputId outputId, in ToiVideoOutputConfiguration::TToiScartMode mode) raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)
void	setScartLoopThroughMode (in ToiVideoOutputConfiguration::TToiVideoOutputId outputId, in ToiVideoOutputConfiguration::TToiValueMode mode) raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)
void	setDviMode (in ToiVideoOutputConfiguration::TToiVideoOutputId outputId, in ToiVideoOutputConfiguration::TToiValueMode mode) raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)
void	setColorSystem (in ToiVideoOutputConfiguration::TToiColorSystem colorSystem) raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)
void	revert () raises (TToiOperationNotSupportedException)
void	clear ()
void	apply () raises (TToiOperationNotSupportedException)
void	releaseInstance ()

Member Function Documentation

void ToiVideoOutputConfigurationSession::apply ( ) raises (TToiOperationNotSupportedException)

Applies the changes made in the configuration session and makes the changes permanent.

Exceptions:

TToiOperationNotSupportedException Raised if apply cannot be performed.

void ToiVideoOutputConfigurationSession::clear ( )

Clears this configuration session to a clean state.

void ToiVideoOutputConfigurationSession::releaseInstance ( )

This function releases the resources used by this instance and ends the configuration session. If ToiVideoOutputConfigurationSession::apply() has not been called, the session configuration is lost. When this function returns all observers has also been released.

void ToiVideoOutputConfigurationSession::resetDisplayInfo ( in ToiVideoOutputConfiguration::TToiVideoOutputId outputId )

Resets display information that has been overridden using ToiVideoOutputConfigurationSession::setDisplayInfo(). The overridden values are reset to values retrieved from the EDID if one is available, otherwise default values.

Parameters:

outputId Video output identifier.

void ToiVideoOutputConfigurationSession::revert ( ) raises (TToiOperationNotSupportedException)

Reverts a configuration session to the state it had when first being created, even if changes have been applied. The reverted configuration is not applied until ToiVideoOutputConfigurationSession::apply() is called.

Exceptions:

TToiOperationNotSupportedException Raised if a revert cannot be performed.

void ToiVideoOutputConfigurationSession::setColorSpace	(	in ToiVideoOutputConfiguration::TToiVideoOutputId	outputId,
		in ToiVideoOutputConfiguration::TToiColorSpace	colorSpace
	)		raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)

Configures the color space of the video.

Parameters:

outputId	Output identifier.
colorSpace	The new color space.

Exceptions:

TToiOperationNotSupportedException	Raised if output can not be set.
TToiInvalidArgumentException	Raised if outputId is an invalid output.

void ToiVideoOutputConfigurationSession::setColorSystem ( in ToiVideoOutputConfiguration::TToiColorSystem colorSystem ) raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)

Set color system, e.g. NTSC or PAL.

Parameters:

colorSystem Color system setting.

Exceptions:

TToiOperationNotSupportedException	Raised if color system can not be changed.
TToiInvalidArgumentException	Raised if colorSystemSetting not is supported.

void ToiVideoOutputConfigurationSession::setDefaultVideoMode	(	in ToiVideoOutputConfiguration::TToiVideoOutputId	outputId,
		in ToiVideoOutputConfiguration::TToiVideoMode	mode
	)		raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)

Configures the default video output mode. This will be used when no adaptive video mode rules are applicable.

Parameters:

outputId	Output identifier.
mode	The new output mode.

Exceptions:

TToiOperationNotSupportedException	Raised if output can not be set.
TToiInvalidArgumentException	Raised if outputId is an invalid output.

void ToiVideoOutputConfigurationSession::setDisplayInfo	(	in ToiVideoOutputConfiguration::TToiVideoOutputId	outputId,
		in ToiVideoOutputConfiguration::TToiVideoModeSequence	modes,
		in ToiVideoOutputConfiguration::TToiAspectRatio	aspectRatio
	)		raises (TToiInvalidArgumentException)

Sets information about the display connected to a video output. This is primarily used to give information about displays that cannot provide this information themselves, but can also be used to override the video output capabilites of a display, e.g. if a TV set supports other settings than the EDID indicates.

Parameters:

outputId	Video output identifier.
modes	The supported video modes.
aspectRatio	The aspect ratio of the display.

Exceptions:

TToiInvalidArgumentException Raised if outputId is an invalid output.

void ToiVideoOutputConfigurationSession::setDviMode	(	in ToiVideoOutputConfiguration::TToiVideoOutputId	outputId,
		in ToiVideoOutputConfiguration::TToiValueMode	mode
	)		raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)

Sets the DVI mode for a video output. Only supported for HDMI outputs.

Parameters:

outputId	Output identifier.
mode	The new DVI mode.

Exceptions:

TToiOperationNotSupportedException	Raised if output can not be set.
TToiInvalidArgumentException	Raised if outputId is an invalid output.

void ToiVideoOutputConfigurationSession::setScartLoopThroughMode	(	in ToiVideoOutputConfiguration::TToiVideoOutputId	outputId,
		in ToiVideoOutputConfiguration::TToiValueMode	mode
	)		raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)

Sets the SCART standby loop through mode for a video output. Only supported for SCART outputs.

Parameters:

outputId	Output identifier.
mode	The new SCART standby loop through mode.

Exceptions:

TToiOperationNotSupportedException	Raised if output can not be set.
TToiInvalidArgumentException	Raised if outputId is an invalid output.

void ToiVideoOutputConfigurationSession::setScartMode	(	in ToiVideoOutputConfiguration::TToiVideoOutputId	outputId,
		in ToiVideoOutputConfiguration::TToiScartMode	mode
	)		raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)

Sets the SCART mode for a video output. Only supported for SCART outputs.

Parameters:

outputId	Output identifier.
mode	The new SCART mode.

Exceptions:

TToiOperationNotSupportedException	Raised if output can not be set.
TToiInvalidArgumentException	Raised if outputId is an invalid output.

void ToiVideoOutputConfigurationSession::setSharpness	(	in ToiVideoOutputConfiguration::TToiVideoOutputId	outputId,
		in long	sharpness
	)		raises (TToiOperationNotSupportedException, TToiInvalidArgumentException)

Technical Preview:: This method is a TECHNICAL PREVIEW, it may change.

Configures the sharpness of the HD video output ports.

Parameters:

outputId	Output identifier.
sharpness	Level of sharpness, given in percent, value between 0-100.

Exceptions:

TToiOperationNotSupportedException	Raised if output can not be set or if sharpness can not be configured for the selected output.
TToiInvalidArgumentException	Raised if outputId invalid.

Description

Public Member Functions

Member Function Documentation