|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface VideoOutputSettings
The VideoOutputSettings
interface extends the functionality of the
video outputs to support configuration of video output resolution.
In Host devices supporting this specification, all instances of VideoOutputPort
SHALL implement this interface.
An application MAY query the set of output configurations supported by a given
video output port by calling getSupportedConfigurations()
.
The supported configurations MAY be used to configure the given video output port
by calling setOutputConfiguration(org.ocap.hardware.device.VideoOutputConfiguration)
.
VideoOutputPort
Method Summary | |
---|---|
void |
addListener(VideoOutputPortListener l)
Add the given listener to monitor this video output port for status changes. |
AudioOutputPort |
getAudioOutputPort()
Get the AudioOutputPort object which can be used to control
the audio output port associated with this video output port. |
int |
getDisplayAspectRatio()
Get the aspect ratio of the display connected to this video output port. |
Hashtable |
getDisplayAttributes()
Get the set of attributes describing the display currently connected to this VideoOutputPort . |
VideoOutputConfiguration |
getOutputConfiguration()
Get the current output configuration for this video output port. |
VideoOutputConfiguration[] |
getSupportedConfigurations()
Get the fixed set of supported output configurations for this video output port. |
boolean |
isContentProtected()
Get the protection status of content on this video output port. |
boolean |
isDisplayConnected()
Get the connection status of this video output port. |
boolean |
isDynamicConfigurationSupported()
Determine if this video output port supports dynamic output configuration based upon input video attributes. |
void |
removeListener(VideoOutputPortListener l)
Remove the given listener from further notification of status changes for this video output port. |
void |
setOutputConfiguration(VideoOutputConfiguration config)
Set the output configuration for this video output port. |
Method Detail |
---|
VideoOutputConfiguration[] getSupportedConfigurations()
VideoOutputConfiguration
instances.
The returned set of configurations SHALL be the intersection of those supported by the output port of the Host device and those supported by the connected display device, where such information is known by the Host.
boolean isDynamicConfigurationSupported()
true
if instances of DynamicVideoOutputConfiguration
may be set via setOutputConfiguration(org.ocap.hardware.device.VideoOutputConfiguration)
VideoOutputConfiguration getOutputConfiguration()
setOutputResolutionConfig
.
If the returned VideoOutputConfiguration
corresponds to a
configuration returned by getSupportedConfigurations()
, that same
configuration SHALL be returned.
setOutputConfiguration(org.ocap.hardware.device.VideoOutputConfiguration)
void setOutputConfiguration(VideoOutputConfiguration config) throws FeatureNotSupportedException
VideoOutputConfiguration
s instances corresponding to
supported video configurations SHALL be accpeted; anything else results
in an exception.
The output resolution configuration is applied at method invocation time. Changes to a configuration instance SHALL have no effect on the current configuration unless applied via invocation of this method specifying the given configuration.
Changing this setting on the "main" video output port for an HScreen
MAY affect the configuration of the HScreenDevice
s of that
HScreen
to maintain consistent display aspect ratios
as described in the body of this specification.
config
- The new output configuration.
IllegalArgumentException
- if the output resolution specified
does not correspond to one of the supported configurations
FeatureNotSupportedException
- if the given configuration
corresponds to one of the supported resolutions, but cannot be satisfied
SecurityException
- if the caller does not have
MonitorAppPermission("deviceController")
getOutputConfiguration()
AudioOutputPort getAudioOutputPort()
AudioOutputPort
object which can be used to control
the audio output port associated with this video output port.
AudioOutputPort
for this video output portvoid addListener(VideoOutputPortListener l)
l
- the listener to addremoveListener(VideoOutputPortListener)
void removeListener(VideoOutputPortListener l)
l
- the listener to removeaddListener(VideoOutputPortListener)
Hashtable getDisplayAttributes()
VideoOutputPort
.
The display attributes information is returned in the form of a Hashtable
,
mapping attribute names (specified as String
s) to attribute
values (specified as attribute-specific Object
s).
For example, where EEDID (Enhanced Extended Display Identification Data) retrieval is supported, this information SHALL be accessible as attributes of the connected display. In case of EEDID, the following table describes the attribute mappings that SHALL be supported and used where appropriate.
Attribute name | Attribute value |
---|---|
"Manufacturer Name" | 3-character EISA manufacturer ID as a String |
"Product Code" | Vendor assigned product code as a Short |
"Serial Number" | Vendor assigned serial number as a Integer |
"Manufacture Week" | Week of manufacture as a Byte |
"Manufacture Year" | Year of manufacture (offset from 1990) as a Byte |
Hashtable
describing known display attributes;
null
is returned if isDisplayConnected()
would return false
boolean isDisplayConnected()
If the Host device is incapable of determining connection status (e.g.,
for component video
),
then false
SHALL be returned.
true
if a display is known to be connected;
false
otherwiseboolean isContentProtected()
This SHALL return true
if both this port and the connected
display support content protection and content is protected; false
SHALL be returned otherwise.
int getDisplayAspectRatio()
VideoFormatControl.DAR_4_3
,
VideoFormatControl.DAR_16_9
,
or -1 if unknown
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |