http://my.oschina.net/ryanhoo/blog/86843
译者: Ryan Hoo
来源: http://www.androidworks.com/crop_large_photos_with_android
译者按: 在外企工作的半年多中花了不少时间在国外的网站上搜寻资料,其中有一些相当有含金量的文章,我会陆陆续续翻译成中文,与大家共享之。初次翻译,“信达雅”三境界恐怕只到信的层次,望大家见谅!
这篇文章相当经典而实用,想当初我做手机拍照截图的时候,大多都是在网上抄来抄去的内容,从来没有人考虑过实际项目中的需求。实际上,拍照传大图片,如果用普通方式会耗用极大的内存,Android一个App原则上的16M内存限制可以一下子被耗光。Android在拍照上有一个隐藏的设计,如果拍照图片过大,只返回一张缩略图。具体到不同手机,都是不一样的。
-------------------------------------------------------------------------------------
译文:
概述
我写这篇文章是为了发表我对MediaStore裁剪图片功能的一些简要研究。基本上,如果你要写一个应用程序,使用已有的Media Gallery并允许用户在你的应用里选取TA的图片的一部分(可选功能:人脸识别)。 可以使用一个Intent做到这个,但是也存在着相应的问题,总的来说也缺少这方面的文档告诉我们怎么实现它。
另外,这篇文章基于2.1并且在Nexus One上做了测试。
Nexus One上的实现似乎被这群人写在了这里:
Media Gellery for Nexus One
。
反馈
这篇文章需要使用基于我的研究所写的程序。如果你对我推荐的实现方案有所改进,请让我知道。我会相应的更新这篇文章。
Intent细节
首先,让我们探讨下Intent以及它的特点。在看了一些代码示例以后,我发现我可以很轻松的使用如下的Intent调用裁剪功能:
1
Intent intent =
new
Intent(Intent.ACTION_GET_CONTENT,
null
);
2
intent.setType(“image/*”);
3
intent.putExtra(“crop”, “
true
”);
然而,这是在我缺少附加的文档,不知道这些选项的具体含义等等情况之下的选择。所以,我将我的研究整理成一个表格 ,并写了一个演示程序,力图演示控制此功能的所有可供选项。
你可以在你的程序中使用使用我的代码,并且扩展它。我会将之附加在这篇文章上。
Exta Options Table for image/* crop:
附加选项 数据类型 描述 crop String 发送裁剪信号 aspectX int X方向上的比例 aspectY int Y方向上的比例 outputX int 裁剪区的宽 outputY int 裁剪区的高 scale boolean 是否保留比例 return-data boolean 是否将数据保留在Bitmap中返回 data Parcelable 相应的Bitmap数据 circleCrop String 圆形裁剪区域? MediaStore.EXTRA_OUTPUT ("output") URI 将URI指向相应的file:///...,详见代码示例
现在,最令人困惑的是MediaStore.EXTRA_OUTPUT以及return-data选项。
你主要有两种方式从这个Intent中取得返回的bitmap:获取内部数据或者提供一个Uri以便程序可以将数据写入。
方法1: 如果你将return-data设置为“true”,你将会获得一个与内部数据关联的Action,并且bitmap以此方式返回:(Bitmap)extras.getParcelable("data")。注意:如果你最终要获取的图片非常大,那么此方法会给你带来麻烦,所以你要控制outputX和outputY保持在较小的尺寸。鉴于此原因,在我的代码中没有使用此方法((Bitmap)extras.getParcelable("data"))。
下面是CropImage.java的源码片段:
2
Bundle myExtras = getIntent().getExtras();
3
if
(myExtras !=
null
&& (myExtras.getParcelable(
"data"
) !=
null
|| myExtras.getBoolean(
"return-data"
)))
5
Bundle extras =
new
Bundle();
6
extras.putParcelable(
"data"
, croppedImage);
7
setResult(RESULT_OK,(
new
Intent()).setAction(
"inline-data"
).putExtras(extras));
方法2:
如果你将return-data设置为“false”,那么在onActivityResult的Intent数据中你将不会接收到任何Bitmap,相反,你需要将MediaStore.EXTRA_OUTPUT关联到一个Uri,此Uri是用来存放Bitmap的。
但是还有一些条件,首先你需要有一个短暂的与此Uri相关联的文件地址,当然这不是个大问题(除非是那些没有sdcard的设备)。
下面是CropImage.java关于操作Uri的源码片段:
01
if
(mSaveUri !=
null
) {
02
OutputStream outputStream =
null
;
04
outputStream = mContentResolver.openOutputStream(mSaveUri);
05
if
(outputStream !=
null
) {
06
croppedImage.compress(mOutputFormat,
75
, outputStream);
08
}
catch
(IOException ex) {
10
Log.e(TAG,
"Cannot open file: "
+ mSaveUri, ex);
12
Util.closeSilently(outputStream);
14
Bundle extras =
new
Bundle();
15
setResult(RESULT_OK,
new
Intent(mSaveUri.toString()).putExtras(extras));
代码示例:
我已经附上了一些代码示例,应该可以让你测试多种配置。请让我知道它对你是否有用。
代码下载:
MediaStoreTest
01
/** Called when the activity is first created. */
03
public
void
onCreate(Bundle savedInstanceState) {
04
super
.onCreate(savedInstanceState);
06
setContentView(R.layout.main);
07
mBtn = (Button) findViewById(R.id.btnLaunch);
08
photo = (ImageView) findViewById(R.id.imgPhoto);
09
mBtn.setOnClickListener(
new
OnClickListener() {
11
public
void
onClick(View v) {
14
Intent intent =
new
Intent(Intent.ACTION_GET_CONTENT,
null
);
15
intent.setType(
"image/*"
);
16
intent.putExtra(
"crop"
,
"true"
);
17
intent.putExtra(
"aspectX"
, aspectX);
18
intent.putExtra(
"aspectY"
, aspectY);
19
intent.putExtra(
"outputX"
, outputX);
20
intent.putExtra(
"outputY"
, outputY);
21
intent.putExtra(
"scale"
, scale);
22
intent.putExtra(
"return-data"
, return_data);
23
intent.putExtra(MediaStore.EXTRA_OUTPUT, getTempUri());
24
intent.putExtra(
"outputFormat"
,
25
Bitmap.CompressFormat.JPEG.toString()); <span style=
"color:#48465A;font-family:monospace;font-size:11px;line-height:normal;background-color:#EFEFEF;"
>
27
intent.putExtra(
"circleCrop"
,
true
);
30
startActivityForResult(intent, PHOTO_PICKED);
31
}
catch
(ActivityNotFoundException e) {
32
Toast.makeText(thiz, R.string.photoPickerNotFoundText,
33
Toast.LENGTH_LONG).show();
40
private
Uri getTempUri() {
41
return
Uri.fromFile(getTempFile());
44
private
File getTempFile() {
45
if
(isSDCARDMounted()) {
47
File f =
new
File(Environment.getExternalStorageDirectory(),
51
}
catch
(IOException e) {
53
Toast.makeText(thiz, R.string.fileIOIssue, Toast.LENGTH_LONG)
62
private
boolean
isSDCARDMounted() {
63
String status = Environment.getExternalStorageState();
65
if
(status.equals(Environment.MEDIA_MOUNTED))
71
protected
void
onActivityResult(
int
requestCode,
int
resultCode, Intent data) {
72
super
.onActivityResult(requestCode, resultCode, data);
74
switch
(requestCode) {
76
if
(resultCode == RESULT_OK) {
78
Log.w(TAG,
"Null data, but RESULT_OK, from image picker!"
);
79
Toast t = Toast.makeText(
this
, R.string.no_photo_picked,
85
final
Bundle extras = data.getExtras();
87
File tempFile = getTempFile();
89
if
(data.getAction() !=
null
) {
90
processPhotoUpdate(tempFile);
附录:
My comments
Thank you so much! The tutorial is great! Actually the secret of cropping photos on Android is using Uri if the photo is in large size and using Bitmap if you want but make sure that the bitmap is not too big.(You can use it for cropping avatar or other requirements with a limited size of the photo. Different phones have different limits. Normally if you want to use a bitmap, the size shouldn't be bigger than 300. Otherwise the Uri is suggested.)