Android平台上从Camera的jpegquality菜单研究JNI接口(一)

Jpeg quality菜单与picture size菜单等有些区别,在该菜单中,调用了JNI接口。第一次接触JNI接口,所以写个小文档,做个记录。

 

一、        应用程序层介绍

1、  jpeg quality菜单项及其初始化

首先,介绍一下jpeg quality菜单及其菜单项。在文件

/packages/apps/Camera/res/xml/camera_preferences.xml中,有如下的code

<PreferenceGroup xmlns:camera=

"http://schemas.android.com/apk/res/com.android.camera">

<PreferenceGroup camera:title="@string/pref_camera_settings_category">

    ……

 <ListPreference camera:key="pref_camera_jpegquality_key"

    amera:defaultValue="@string/pref_camera_jpegquality_default" camera:title="@string/pref_camera_jpegquality_title" camera:entries="@array/pref_camera_jpegquality_entries" camera:entryValues="@array/pref_camera_jpegquality_entryvalues" />

   

  </PreferenceGroup>

  </PreferenceGroup>

Jpeg quality菜单与picture size同样都属于preferenceGroup,但是它们的初始化方式却是不一样的。在文件/packages/apps/Camera/src/com/android/camera/CameraSetting.java中,有一个函数private void initPreference(PreferenceGroup group)用来初始化picture size等菜单,但是其并没有对jpeg quality菜单做初始化。在另一个函数upgradePreferences()中,对jpeg quality菜单做了初始化。其具体定义为:

public static void upgradePreferences(SharedPreferences pref) {

        int version;

        try {

            version = pref.getInt(KEY_VERSION, 0);

        } catch (Exception ex) {

            version = 0;

        }

        if (version == CURRENT_VERSION) return;

 

        SharedPreferences.Editor editor = pref.edit();

        if (version == 0) {

            // We won't use the preference which change in version 1.

            // So, just upgrade to version 1 directly

            version = 1;

        }

        if (version == 1) {

            // Change jpeg quality {65,75,85} to {normal,fine,superfine}

            String quality = pref.getString(KEY_JPEG_QUALITY, "85");

            if (quality.equals("65")) {

                quality = "normal";

            } else if (quality.equals("75")) {

                quality = "fine";

            } else {

                quality = "superfine";

            }

            editor.putString(KEY_JPEG_QUALITY, quality);

            version = 2;

        }

        if (version == 2) {

            editor.putString(KEY_RECORD_LOCATION,

                    pref.getBoolean(KEY_RECORD_LOCATION, false)

                    ? RecordLocationPreference.VALUE_ON

                    : RecordLocationPreference.VALUE_NONE);

            version = 3;

        }

        if (version == 3) {

            // Just use video quality to replace it and

            // ignore the current settings.

            editor.remove("pref_camera_videoquality_key");

            editor.remove("pref_camera_video_duration_key");

        }

        editor.putInt(KEY_VERSION, CURRENT_VERSION);

        editor.commit();

    }

该函数在文件/packages/apps/Camera/src/com/android/camera/Camera.java中被调用,其具体code为:

public void onCreate(Bundle icicle) {

        super.onCreate(icicle);

        setContentView(R.layout.camera);

        mSurfaceView = (SurfaceView) findViewById(R.id.camera_preview);

        mPreferences = PreferenceManager.getDefaultSharedPreferences(this);

        CameraSettings.upgradePreferences(mPreferences);   

        mQuickCapture = getQuickCaptureSettings();

        // comment out -- unused now.

        //mQuickCapture = getQuickCaptureSettings();

      ……

在文件 /packages/apps/Camera/res/values/arrays.xml中有如下的code

- <!--

 Camera Preferences JPEG quality dialog box entries 

  -->

  <string name="pref_camera_jpegquality_entry_superfine">Super fine</string>

  <string name="pref_camera_jpegquality_entry_fine">Fine</string>

  <string name="pref_camera_jpegquality_entry_normal">Normal</string>

由此,我们可以知道jpeg quality菜单有三项,分别为NormalFineSuperFine

下面我们看看jpeg quality菜单的更新。

 

2、  jpeg quality菜单的更新

在文件/packages/apps/Camera/src/com/android/camera/Camera.java有个函数

updateCameraParametersPreference(),它负责更新camera应用程序的菜单。其定义如下:

  private void updateCameraParametersPreference() {

        // Set picture size.

        ……

        // Set the preview frame aspect ratio according to the picture size.

        ……

        // Set a preview size that is closest to the viewfinder height and has

        // the right aspect ratio.

        ……

        // Since change scene mode may change supported values,

        // Set scene mode first,

        ……

        // Set JPEG quality.

        String jpegQuality = mPreferences.getString(

                CameraSettings.KEY_JPEG_QUALITY,

                getString(R.string.pref_camera_jpegquality_default));

        mParameters.setJpegQuality(JpegEncodingQualityMappings.getQualityNumber(jpegQuality));

 

        // Set color effect parameter.

        ……

    }

 

通过String jpegQuality = mPreferences.getString(),我们获取当前jpeg quality菜单所选中的项对应的字符串,然后通过mParameters.setJpegQuality()去设置该值,底层可以得知菜单中所选中的项对应的值。mParameters.setJpegQuality()的定义在文件

/framework/base/core/java/android/hardware/camera.java中,其具体code

     /**

         * Sets Jpeg quality of captured picture.

         *

         * @param quality the JPEG quality of captured picture. The range is 1

         *                to 100, with 100 being the best.

         */

        public void setJpegQuality(int quality) {

            set(KEY_JPEG_QUALITY, quality);

        }

其中,KEY_JPEG_QUALITY定义为:

private static final String KEY_JPEG_QUALITY = "jpeg-quality";

由注释,我们可以知道这里设置的值在[1100]之间。通过mPreferences.getString(),我们获取的是字符串,比如normal, finesuperfine,mParameters.setJpegQuality()所设置的字符串却应该是[0100]之间的值,这个转换就需要

JpegEncodingQualityMappings.getQualityNumber(jpegQuality)来实现了。

       JpegEncodingQualityMappings是一个类,定义在文件

/packages/apps/Camera/src/com/android/camera/Camera.java中,具体定义为:

/*

 * Provide a mapping for Jpeg encoding quality levels

 * from String representation to numeric representation.

 */

class JpegEncodingQualityMappings {

    private static final String TAG = "JpegEncodingQualityMappings";

    private static final int DEFAULT_QUALITY = 85;

    private static HashMap<String, Integer> mHashMap =

            new HashMap<String, Integer>();

 

    static {

        mHashMap.put("normal",    CameraProfile.QUALITY_LOW);

        mHashMap.put("fine",      CameraProfile.QUALITY_MEDIUM);

        mHashMap.put("superfine", CameraProfile.QUALITY_HIGH);

    }

 

    // Retrieve and return the Jpeg encoding quality number

    // for the given quality level.

    public static int getQualityNumber(String jpegQuality) {

        Integer quality = mHashMap.get(jpegQuality);

        if (quality == null) {

            Log.w(TAG, "Unknown Jpeg quality: " + jpegQuality);

            return DEFAULT_QUALITY;

        }

        return CameraProfile.getJpegEncodingQualityParameter(quality.intValue());

    }

}

很清楚,getQualityNumber(jpegQuality)的参数如果没在normalfinesuperfine之间就返回DEFAULT_QUALITY,默认的数值;如果在,则调用

CameraProfile.getJpegEncodingQualityParameter(quality.intValue())。这个函数定义在文件

/framework/base/media/java/android/media/CameraProfile.java中。

在该文件中,定义了:

    public static final int QUALITY_LOW    = 0;

    public static final int QUALITY_MEDIUM = 1;

public static final int QUALITY_HIGH   = 2;

这表示jpegquality分为3个等级,它们做为getJpegEncodingQualityParameter()的参数。

    /**

     * Returns a pre-defined still image capture (jpeg) quality level

     * used for the given quality level in the Camera application.

     *

     * @param quality The target quality level

     */

    public static int getJpegEncodingQualityParameter(int quality) {

        if (quality < QUALITY_LOW || quality > QUALITY_HIGH) {

            throw new IllegalArgumentException("Unsupported quality level: " + quality);

        }

        return sJpegEncodingQualityParameters[quality];

    }

       sJpegEncodingQualityParameters的定义为:

/*

     * Cache the Jpeg encoding quality parameters

     */

    private static final int[] sJpegEncodingQualityParameters;

       数组sJpegEncodingQualityParameters中的值如何得来呢?接着往下看。

 (待续)

  • 0
    点赞
  • 6
    收藏
    觉得还不错? 一键收藏
  • 0
    评论

“相关推荐”对你有帮助么?

  • 非常没帮助
  • 没帮助
  • 一般
  • 有帮助
  • 非常有帮助
提交
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值