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菜单有三项,分别为Normal,Fine和SuperFine。
下面我们看看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";
由注释,我们可以知道这里设置的值在[1,100]之间。通过mPreferences.getString(),我们获取的是字符串,比如normal, fine和superfine,而mParameters.setJpegQuality()所设置的字符串却应该是[0,100]之间的值,这个转换就需要
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)的参数如果没在normal,fine和superfine之间就返回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;
这表示jpeg的quality分为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中的值如何得来呢?接着往下看。
(待续)