net.rim.device.api.media.control
Interface AdvancedVideoControl

All Superinterfaces:
Control, GUIControl, VideoControl

public interface AdvancedVideoControl
extends VideoControl

Provides advanced video control capabilities.

Since:
BlackBerry API 7.0.0

Field Summary
static int USE_GUI_ADVANCED
          This defines a mode on how the video is displayed.
 
Fields inherited from interface javax.microedition.media.control.VideoControl
USE_DIRECT_VIDEO
 
Fields inherited from interface javax.microedition.media.control.GUIControl
USE_GUI_PRIMITIVE
 
Method Summary
 
Methods inherited from interface javax.microedition.media.control.VideoControl
getDisplayHeight, getDisplayWidth, getDisplayX, getDisplayY, getSnapshot, getSourceHeight, getSourceWidth, initDisplayMode, setDisplayFullScreen, setDisplayLocation, setDisplaySize, setVisible
 



Field Detail

USE_GUI_ADVANCED

static final int USE_GUI_ADVANCED
This defines a mode on how the video is displayed. It is used in conjunction with VideoControl.initDisplayMode(int, java.lang.Object).

USE_GUI_ADVANCED mode can only be used on platforms with Native Window Management support.

When USE_GUI_ADVANCED is specified for initDisplayMode, the arg argument must not be null and must be a java.lang.String equal to "net.rim.device.api.ui.Field". In this mode, the video is rendered onto a Native Window. The region where the video is rendered can be set by the setDisplayLocation method. By default, the location is (0,0). This mode does not support drawing other graphics at the same region on the canvas.

initDisplayMode returns an instance of net.rim.device.api.ui.Field in this mode.

Here is one sample usage scenario:

    import net.rim.device.api.Field;
    import net.rim.device.api.media.control.AdvancedVideoControl;
    
    Field field;

    try {
        Player p = Manager.createPlayer("http://mymachine/abc.mpg");
        p.realize();
        AdvancedVideoControl vc;
        if ((vc = (AdvancedVideoControl)p.getControl("net.rim.device.api.media.control.AdvancedVideoControl")) != null) {
            field = (Field)vc.initDisplayMode(AdvancedVideoControl.USE_GUI_ADVANCED, "net.rim.device.api.ui.Field");
            vc.setVisible(true);
        }
        p.start();
    } catch (MediaException pe) {
    } catch (IOException ioe) {
    }
 

Value 2 is assigned to USE_GUI_ADVANCED.

See Also:
Constant Field Values
Since:
BlackBerry API 7.0.0





Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal