com.nokia.mid.media
Interface VideoDecodeControl

All Superinterfaces:

javax.microedition.media.Control

public interface VideoDecodeControl
extends javax.microedition.media.Control

VideoDecodeControl interface is a control interface for setting and getting the status of the video decoder of the Player during video playback. Requesting the decoder to stop decoding or post processing saves MCU time and power consumption, for example when video is not shown (e.g. background playback).

Example:

 try {
     Player p = Manager.createPlayer("http://abc.mpg");
     p.realize();
     VideoControl vc;
     VideoDecodeControl vdc;

     if ((vc = (VideoControl)p.getControl("VideoControl")) != null)
         add((Component)vc.initDisplayMode(vc.USE_GUI_PRIMITIVE, null));

     p.start();

...
     vc.setVisible(false);

      // Deactivate decoding for the decoder
     if ((vdc = (VideoDecodeControl)p.getControl("VideoDecodeControl")) != null)
        vdc.setDecodeStatus(vdc.DECODE_OFF);

 } catch (MediaException pe) {
 } catch (IOException ioe) {
 }

Field Summary

static int	DECODE_FULL Indicates full decoding and postprocessing.
static int	DECODE_OFF Indicates that decoding and postprocessing are skipped.

Method Summary

int	getDecodeStatus() Get the current video decoder status.
int	setDecodeStatus(int status) Set the current video decoder status.

Field Detail

DECODE_OFF

static final int DECODE_OFF

Indicates that decoding and postprocessing are skipped.

See Also:

Constant Field Values

DECODE_FULL

static final int DECODE_FULL

Indicates full decoding and postprocessing.

See Also:

Constant Field Values

Method Detail

getDecodeStatus

int getDecodeStatus()

Get the current video decoder status.

setDecodeStatus

int setDecodeStatus(int status)

Set the current video decoder status. Activated status is returned.