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();

...
     vdc.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

public static final int DECODE_OFF
Indicates that decoding and postprocessing are skipped.

See Also:
Constant Field Values

DECODE_FULL

public static final int DECODE_FULL
Indicates full decoding and postprocessing.

See Also:
Constant Field Values
Method Detail

getDecodeStatus

public int getDecodeStatus()
Get the current video decoder status.


setDecodeStatus

public int setDecodeStatus(int status)
Set the current video decoder status.

Returns:
Activated status is returned.


Copyright © 2012 Nokia Corporation. All rights reserved.

Nokia is registered trademark of Nokia Corporation. Java and all Java-based marks are trademarks or registered trademarks of Oracle Corporation. Other product and company names mentioned herein may be trademarks or trade names of their respective owners. This document is confidential information of Nokia Corporation.

Disclaimer
The information in this document is provided "as is," with no warranties whatsoever, including any warranty of merchantability, fitness for any particular purpose, or any warranty otherwise arising out of any proposal, specification, or sample. Furthermore, information provided in this document is preliminary, and may be changed substantially prior to final release.

Nokia Corporation disclaims all liability, including liability for infringement of any proprietary rights, relating to this document and implementation of any information presented in this document.

Nokia Corporation retains the right to make changes to this document at any time, without notice.

License
Subject to above disclaimer, a license is hereby granted to use this documentation solely under existing Limited License Agreement and non-disclosure agreement between the companies for the agreed application development for Series 40 Nokia phones. No other licenses e.g. to any intellectual property rights are granted herein. Any use of the screen shots of this documentation, including any icons thereof, is subject to Nokia's prior written approval.