org.dvb.media
Interface VideoFormatControl

All Superinterfaces:
Control

public interface VideoFormatControl
extends Control

This provides a means for applications to get information associated with the format and aspect ratio of the video being presented to the user. This control will only be available for Players presenting MPEG-2 video streams.

It is important to note that due to different video and display formats (and user preferences), not all of the full video frame may be displayed. Similarly, it may not always be possible to map video and graphics with perfect accuracy.

Signalling for the active format description shall be supported as defined in Annex B of TS 101 154


Field Summary
static int AFD_14_9
          Constant representing an MPEG active format description of 14:9 (centre)
static int AFD_14_9_TOP
          Constant representing an MPEG active format description of 14:9 (top)
static int AFD_16_9
          Constant representing an MPEG active format description of 16:9 (centre)
static int AFD_16_9_SP_14_9
          Constant representing an MPEG active format description of 16:9 (with shoot & protect 14:9 centre)
static int AFD_16_9_SP_4_3
          Constant representing an MPEG active format description of 16:9 (with shoot & protect 4:3 centre)
static int AFD_16_9_TOP
          Constant representing an MPEG active format description of 16:9 (top)
static int AFD_4_3
          Constant representing an MPEG active format description of 4:3 (centre)
static int AFD_4_3_SP_14_9
          Constant representing an MPEG active format description of 4:3 (with shoot & protect 14:9 centre)
static int AFD_GT_16_9
          Constant representing an MPEG active format description of greater than 16:9 (centre)
static int AFD_NOT_PRESENT
          Constant showing an MPEG active format description is not present
static int AFD_SAME
          Constant representing an MPEG active format description that is the same as the coded frame
static int ASPECT_RATIO_16_9
          Constant representing an aspect ratio of 16:9
static int ASPECT_RATIO_2_21_1
          Constant representing an aspect ratio of 2.21:1
static int ASPECT_RATIO_4_3
          Constant representing an aspect ratio of 4:3
static int ASPECT_RATIO_UNKNOWN
          Constant representing an unknown aspect ratio
static int DAR_16_9
          Constant representing a display aspect ratio of 16:9
static int DAR_4_3
          Constant representing a display aspect ratio of 4:3
static int DFC_PLATFORM
          Control over the decoder format conversions is returned to being managed by the platform.
static int DFC_PROCESSING_16_9_ZOOM
          The central 16:9 letterbox area of the 4:3 720 x 576 input grid is expanded to fill the 16:9 output frame.
static int DFC_PROCESSING_CCO
          A 4:3 central part out of the 720 x 576 input 16:9 frame is transferred into a 720 x 576 4:3 output frame
static int DFC_PROCESSING_FULL
          The full 720 x 576 frame is transferred (this may be either 4:3 or 16:9; part of this may be black, e.g. in the "pillar box" cases)
static int DFC_PROCESSING_LB_14_9
          The 720 x 576 input grid is transferred into a 14:9 LB in a 4:3 frame
static int DFC_PROCESSING_LB_16_9
          The 720 x 576 input grid is transferred into a 16:9 letterbox in a 4:3 frame
static int DFC_PROCESSING_LB_2_21_1_ON_16_9
          The 720 x 576 input grid is transferred into a 2.21:1 letterbox in a 16:9 frame.
static int DFC_PROCESSING_LB_2_21_1_ON_4_3
          The 720 x 576 input grid is transferred into a 2.21:1 letterbox in a 4:3 frame.
static int DFC_PROCESSING_NONE
          Decoder format conversion is inactive
static int DFC_PROCESSING_PAN_SCAN
          A 4:3 part out of the 720 x 576 input 16:9 or 2.21:1 frame is transferred into a 720 x 576 4:3 output frame.
static int DFC_PROCESSING_UNKNOWN
          Constant representing an unknown format conversion being performed by the decoder
 
Method Summary
 void addVideoFormatListener(VideoFormatListener l)
          Add a listener for VideoFormatChangedEvents
 int getActiveFormatDefinition()
          Return the value of the active_format field of the MPEG Active Format Description of the video if it is transmitted (one of the constants AFD_* above).
 int getAspectRatio()
          Return the aspect ratio of the video as it is transmitted.
 int getDecoderFormatConversion()
          Return a value representing what format conversion is being done by the decoder in the platform (one of the constants DFC_* above).
 int getDisplayAspectRatio()
          Return the aspect ratio of the display device connected to this MHP decoder (one of the constants DAR_* above)
 VideoTransformation getVideoTransformation(int dfc)
          This method returns a VideoTransformation object that corresponds with the specified Decoder Format Conversion when applied to the currently selected video.
 boolean isPlatform()
          Test if control over the decoder format conversions is being managed by the platform as defined by DFC_PLATFORM.
 void removeVideoFormatListener(VideoFormatListener l)
          Remove a listener for VideoFormatChangedEvents
 
Methods inherited from interface javax.media.Control
getControlComponent
 

Field Detail

ASPECT_RATIO_UNKNOWN

public static final int ASPECT_RATIO_UNKNOWN
Constant representing an unknown aspect ratio

See Also:
Constant Field Values

ASPECT_RATIO_4_3

public static final int ASPECT_RATIO_4_3
Constant representing an aspect ratio of 4:3

See Also:
Constant Field Values

ASPECT_RATIO_16_9

public static final int ASPECT_RATIO_16_9
Constant representing an aspect ratio of 16:9

See Also:
Constant Field Values

ASPECT_RATIO_2_21_1

public static final int ASPECT_RATIO_2_21_1
Constant representing an aspect ratio of 2.21:1

See Also:
Constant Field Values

AFD_NOT_PRESENT

public static final int AFD_NOT_PRESENT
Constant showing an MPEG active format description is not present

See Also:
Constant Field Values

AFD_16_9_TOP

public static final int AFD_16_9_TOP
Constant representing an MPEG active format description of 16:9 (top)

See Also:
Constant Field Values

AFD_14_9_TOP

public static final int AFD_14_9_TOP
Constant representing an MPEG active format description of 14:9 (top)

See Also:
Constant Field Values

AFD_GT_16_9

public static final int AFD_GT_16_9
Constant representing an MPEG active format description of greater than 16:9 (centre)

See Also:
Constant Field Values

AFD_SAME

public static final int AFD_SAME
Constant representing an MPEG active format description that is the same as the coded frame

See Also:
Constant Field Values

AFD_4_3

public static final int AFD_4_3
Constant representing an MPEG active format description of 4:3 (centre)

See Also:
Constant Field Values

AFD_16_9

public static final int AFD_16_9
Constant representing an MPEG active format description of 16:9 (centre)

See Also:
Constant Field Values

AFD_14_9

public static final int AFD_14_9
Constant representing an MPEG active format description of 14:9 (centre)

See Also:
Constant Field Values

AFD_4_3_SP_14_9

public static final int AFD_4_3_SP_14_9
Constant representing an MPEG active format description of 4:3 (with shoot & protect 14:9 centre)

See Also:
Constant Field Values

AFD_16_9_SP_14_9

public static final int AFD_16_9_SP_14_9
Constant representing an MPEG active format description of 16:9 (with shoot & protect 14:9 centre)

See Also:
Constant Field Values

AFD_16_9_SP_4_3

public static final int AFD_16_9_SP_4_3
Constant representing an MPEG active format description of 16:9 (with shoot & protect 4:3 centre)

See Also:
Constant Field Values

DFC_PROCESSING_UNKNOWN

public static final int DFC_PROCESSING_UNKNOWN
Constant representing an unknown format conversion being performed by the decoder

See Also:
Constant Field Values

DFC_PROCESSING_NONE

public static final int DFC_PROCESSING_NONE
Decoder format conversion is inactive

See Also:
Constant Field Values

DFC_PROCESSING_FULL

public static final int DFC_PROCESSING_FULL
The full 720 x 576 frame is transferred (this may be either 4:3 or 16:9; part of this may be black, e.g. in the "pillar box" cases)

See Also:
Constant Field Values

DFC_PROCESSING_LB_16_9

public static final int DFC_PROCESSING_LB_16_9
The 720 x 576 input grid is transferred into a 16:9 letterbox in a 4:3 frame

See Also:
Constant Field Values

DFC_PROCESSING_LB_14_9

public static final int DFC_PROCESSING_LB_14_9
The 720 x 576 input grid is transferred into a 14:9 LB in a 4:3 frame

See Also:
Constant Field Values

DFC_PROCESSING_CCO

public static final int DFC_PROCESSING_CCO
A 4:3 central part out of the 720 x 576 input 16:9 frame is transferred into a 720 x 576 4:3 output frame

See Also:
Constant Field Values

DFC_PROCESSING_PAN_SCAN

public static final int DFC_PROCESSING_PAN_SCAN
A 4:3 part out of the 720 x 576 input 16:9 or 2.21:1 frame is transferred into a 720 x 576 4:3 output frame. The horizontal position of this part is determined by pan&scan vectors from the MPEG video stream.

See Also:
Constant Field Values

DFC_PROCESSING_LB_2_21_1_ON_4_3

public static final int DFC_PROCESSING_LB_2_21_1_ON_4_3
The 720 x 576 input grid is transferred into a 2.21:1 letterbox in a 4:3 frame.

See Also:
Constant Field Values

DFC_PROCESSING_LB_2_21_1_ON_16_9

public static final int DFC_PROCESSING_LB_2_21_1_ON_16_9
The 720 x 576 input grid is transferred into a 2.21:1 letterbox in a 16:9 frame.

See Also:
Constant Field Values

DFC_PLATFORM

public static final int DFC_PLATFORM
Control over the decoder format conversions is returned to being managed by the platform. This is the same as the value used if no MHP application has set a video transformation. It is not required to correspond to a single decoder format conversion and may change over time as the video input format & signalling change. This constant can only be used to set the decoder format conversion. Reading the decoder format conversion shall always return the DFC used at the time concerned.

See Also:
Constant Field Values

DFC_PROCESSING_16_9_ZOOM

public static final int DFC_PROCESSING_16_9_ZOOM
The central 16:9 letterbox area of the 4:3 720 x 576 input grid is expanded to fill the 16:9 output frame.

See Also:
Constant Field Values

DAR_4_3

public static final int DAR_4_3
Constant representing a display aspect ratio of 4:3

See Also:
Constant Field Values

DAR_16_9

public static final int DAR_16_9
Constant representing a display aspect ratio of 16:9

See Also:
Constant Field Values
Method Detail

getAspectRatio

public int getAspectRatio()
Return the aspect ratio of the video as it is transmitted. If the aspect ratio is not known, ASPECT_RATIO_UNKNOWN is returned

Returns:
the aspect ratio of the video

getActiveFormatDefinition

public int getActiveFormatDefinition()
Return the value of the active_format field of the MPEG Active Format Description of the video if it is transmitted (one of the constants AFD_* above). If this field is not available then AFD_NOT_PRESENT is returned. The constant values for the constants representing the active format description should be identical to the values specified in ETR154, annex B.

Returns:
the value of the active_format field of the MPEG Active Format Description of the video if it is transmitted. If this field is not available, or the video is not MPEG, then AFD_NOT_PRESENT is returned.

getDecoderFormatConversion

public int getDecoderFormatConversion()
Return a value representing what format conversion is being done by the decoder in the platform (one of the constants DFC_* above). A receiver may implement only a subset of the available options. This decoder format conversion may be active or not depending upon the mode of operation.

Returns:
the decoder format conversion being performed or DFC_PROCESSING_UNKNOWN if this is not known

getVideoTransformation

public VideoTransformation getVideoTransformation(int dfc)
This method returns a VideoTransformation object that corresponds with the specified Decoder Format Conversion when applied to the currently selected video. If the specified Decoder Format Conversion is not supported for the currently selected video, then this method returns null.

Parameters:
dfc - the Decoder Format Conversion (one of the DFC_* constants specified in this interface)
Returns:
the video transformation, or null if the specified Decoder Format Conversion is not supported for the currently selected video.

getDisplayAspectRatio

public int getDisplayAspectRatio()
Return the aspect ratio of the display device connected to this MHP decoder (one of the constants DAR_* above)

Returns:
the aspect ratio of the display device connected to the decoder

isPlatform

public boolean isPlatform()
Test if control over the decoder format conversions is being managed by the platform as defined by DFC_PLATFORM.

Returns:
true if control over the decoder format conversions is being managed by the platform, false otherwise
See Also:
DFC_PLATFORM

addVideoFormatListener

public void addVideoFormatListener(VideoFormatListener l)
Add a listener for VideoFormatChangedEvents

Parameters:
l - the listener to add

removeVideoFormatListener

public void removeVideoFormatListener(VideoFormatListener l)
Remove a listener for VideoFormatChangedEvents

Parameters:
l - the listener to remove