|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface VideoFormatControl
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 player instances presenting video formats.
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. |
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_PILLARBOX_4_3
Constant representing the pillarbox conversion of the 4:3 input video to 16:9 output video. |
static int |
DFC_PROCESSING_UNKNOWN
Constant representing an unknown format conversion being performed by the decoder |
static int |
DFC_PROCESSING_WIDE_4_3
Constant representing the wide conversion of the 4:3 input video to 16:9 output video. |
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 GEM 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 |
---|
static final int ASPECT_RATIO_UNKNOWN
static final int ASPECT_RATIO_4_3
static final int ASPECT_RATIO_16_9
static final int ASPECT_RATIO_2_21_1
static final int AFD_NOT_PRESENT
static final int AFD_16_9_TOP
static final int AFD_14_9_TOP
static final int AFD_GT_16_9
static final int AFD_SAME
static final int AFD_4_3
static final int AFD_16_9
static final int AFD_14_9
static final int AFD_4_3_SP_14_9
static final int AFD_16_9_SP_14_9
static final int AFD_16_9_SP_4_3
static final int DFC_PROCESSING_UNKNOWN
static final int DFC_PROCESSING_NONE
static final int DFC_PROCESSING_FULL
static final int DFC_PROCESSING_LB_16_9
static final int DFC_PROCESSING_LB_14_9
static final int DFC_PROCESSING_CCO
static final int DFC_PROCESSING_PAN_SCAN
static final int DFC_PROCESSING_LB_2_21_1_ON_4_3
static final int DFC_PROCESSING_LB_2_21_1_ON_16_9
static final int DFC_PLATFORM
static final int DFC_PROCESSING_16_9_ZOOM
static final int DFC_PROCESSING_PILLARBOX_4_3
static final int DFC_PROCESSING_WIDE_4_3
static final int DAR_4_3
static final int DAR_16_9
Method Detail |
---|
int getAspectRatio()
int getActiveFormatDefinition()
int getDecoderFormatConversion()
VideoTransformation getVideoTransformation(int dfc)
dfc
- the Decoder Format Conversion (one of the DFC_* constants
specified in this interface)
int getDisplayAspectRatio()
boolean isPlatform()
DFC_PLATFORM
.
DFC_PLATFORM
void addVideoFormatListener(VideoFormatListener l)
l
- the listener to addvoid removeVideoFormatListener(VideoFormatListener l)
l
- the listener to remove
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |