1 /*

     2 * Copyright (c) 2009 Nokia Corporation and/or its subsidiary(-ies).

     3 * All rights reserved.

     4 * This component and the accompanying materials are made available

     5 * under the terms of "Eclipse Public License v1.0"

     6 * which accompanies this distribution, and is available

     7 * at the URL "http://www.eclipse.org/legal/epl-v10.html".

     8 *

     9 * Initial Contributors:

    10 * Nokia Corporation - initial contribution.

    11 *

    12 * Contributors:

    13 *

    14 * Description:

    15 *

    16 */

    17 package javax.microedition.amms.control;

    18 

    19 import javax.microedition.media.*;

    20 

    21 /**

    22  * Please refer JSR 234 for more details.

    23  */

    24 public interface FormatControl extends Control

    25 {

    26 

    27     /**

    28      * Please refer JSR 234 for more details.

    29      */

    30     public final static int METADATA_NOT_SUPPORTED = 0;

    31 

    32     /**

    33      * Please refer JSR 234 for more details.

    34      */

    35     public final static int METADATA_SUPPORTED_FIXED_KEYS = 1;

    36 

    37     /**

    38      * Please refer JSR 234 for more details.

    39      */

    40     public final static int METADATA_SUPPORTED_FREE_KEYS = 2;

    41 

    42     /**

    43      * Please refer JSR 234 for more details.

    44      */

    45     public final static String PARAM_BITRATE = "bitrate";

    46 

    47     /**

    48      * Please refer JSR 234 for more details.

    49      */

    50     public final static String PARAM_BITRATE_TYPE = "bitrate type";

    51 

    52     /**

    53      * Please refer JSR 234 for more details.

    54      */

    55     public final static String PARAM_SAMPLERATE = "sample rate";

    56 

    57     /**

    58      * Please refer JSR 234 for more details.

    59      */

    60     public final static String PARAM_FRAMERATE = "frame rate";

    61 

    62 

    63     /**

    64      * Please refer JSR 234 for more details.

    65      */

    66     public final static String PARAM_QUALITY = "quality";

    67 

    68     /**

    69      * Please refer JSR 234 for more details.

    70      */

    71     public final static String PARAM_VERSION_TYPE = "version type";

    72 

    73 

    74 

    75     /**

    76      * Please refer JSR 234 for more details.

    77      */

    78     String[] getSupportedFormats();

    79 

    80     /**

    81      * Please refer JSR 234 for more details.

    82      */

    83     String[] getSupportedStrParameters();

    84 

    85     /**

    86      * Please refer JSR 234 for more details.

    87      */

    88     String[] getSupportedIntParameters();

    89 

    90 

    91     /**

    92      * Please refer JSR 234 for more details.

    93      */

    94     String[] getSupportedStrParameterValues(String parameter);

    95 

    96 

    97     /**

    98      * Please refer JSR 234 for more details.

    99      */

   100     int[] getSupportedIntParameterRange(String parameter);

   101 

   102     /**

   103      * Please refer JSR 234 for more details.

   104      */

   105     void setFormat(String format);

   106 

   107     /**

   108      * Please refer JSR 234 for more details.

   109      */

   110     String getFormat();

   111 

   112     /**

   113      * Please refer JSR 234 for more details.

   114      */

   115     int setParameter(String parameter, int value);

   116 

   117     /**

   118      * Please refer JSR 234 for more details.

   119      */

   120     void setParameter(String parameter, String value);

   121 

   122 

   123     /**

   124      * Please refer JSR 234 for more details.

   125      */

   126     String getStrParameterValue(String parameter);

   127 

   128     /**

   129      *Please refer JSR 234 for more details.

   130      */

   131     int getIntParameterValue(String parameter);

   132 

   133     /**

   134      * Please refer JSR 234 for more details.

   135      */

   136     int getEstimatedBitRate() throws MediaException;

   137 

   138 

   139     /**

   140      * Please refer JSR 234 for more details.

   141      */

   142     void setMetadata(String key, String value) throws MediaException;

   143 

   144     /**

   145      * Please refer JSR 234 for more details.

   146      */

   147     String[] getSupportedMetadataKeys();

   148 

   149     /**

   150      * Please refer JSR 234 for more details.

   151      */

   152     int getMetadataSupportMode();

   153 

   154     /**

   155      * Please refer JSR 234 for more details.

   156      */

   157     void setMetadataOverride(boolean override);

   158 

   159     /**

   160      * Please refer JSR 234 for more details.

   161      */

   162     boolean getMetadataOverride();

   163 

   164 }