src/com/android/contacts/detail/PhotoSelectionHandler.java - platform/packages/apps/Contacts - Git at Google

 /*
  * Copyright (C) 2011 The Android Open Source Project
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
  * you may not use this file except in compliance with the License.
  * You may obtain a copy of the License at
  *
  *      http://www.apache.org/licenses/LICENSE-2.0
  *
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */

 package com.android.contacts.detail;

 import android.app.Activity;
 import android.content.ActivityNotFoundException;
 import android.content.ContentValues;
 import android.content.Context;
 import android.content.Intent;
 import android.database.Cursor;
 import android.graphics.Bitmap;
 import android.graphics.BitmapFactory;
 import android.media.MediaScannerConnection;
 import android.net.Uri;
 import android.provider.ContactsContract.CommonDataKinds.Photo;
 import android.provider.ContactsContract.DisplayPhoto;
 import android.provider.ContactsContract.RawContacts;
 import android.provider.MediaStore;
 import android.util.Log;
 import android.view.View;
 import android.view.View.OnClickListener;
 import android.widget.ListPopupWindow;
 import android.widget.PopupWindow.OnDismissListener;
 import android.widget.Toast;

 import com.android.contacts.R;
 import com.android.contacts.editor.PhotoActionPopup;
 import com.android.contacts.common.model.AccountTypeManager;
 import com.android.contacts.model.RawContactModifier;
 import com.android.contacts.model.RawContactDelta;
 import com.android.contacts.common.model.ValuesDelta;
 import com.android.contacts.common.model.account.AccountType;
 import com.android.contacts.model.RawContactDeltaList;
 import com.android.contacts.util.ContactPhotoUtils;
 import com.android.contacts.util.UiClosables;

 import java.io.File;

 /**
  * Handles displaying a photo selection popup for a given photo view and dealing with the results
  * that come back.
  */
 public abstract class PhotoSelectionHandler implements OnClickListener {

     private static final String TAG = PhotoSelectionHandler.class.getSimpleName();

     private static final int REQUEST_CODE_CAMERA_WITH_DATA = 1001;
     private static final int REQUEST_CODE_PHOTO_PICKED_WITH_DATA = 1002;

     protected final Context mContext;
     private final View mPhotoView;
     private final int mPhotoMode;
     private final int mPhotoPickSize;
     private final RawContactDeltaList mState;
     private final boolean mIsDirectoryContact;
     private ListPopupWindow mPopup;

     public PhotoSelectionHandler(Context context, View photoView, int photoMode,
             boolean isDirectoryContact, RawContactDeltaList state) {
         mContext = context;
         mPhotoView = photoView;
         mPhotoMode = photoMode;
         mIsDirectoryContact = isDirectoryContact;
         mState = state;
         mPhotoPickSize = getPhotoPickSize();
     }

     public void destroy() {
         UiClosables.closeQuietly(mPopup);
     }

     public abstract PhotoActionListener getListener();

     @Override
     public void onClick(View v) {
         final PhotoActionListener listener = getListener();
         if (listener != null) {
             if (getWritableEntityIndex() != -1) {
                 mPopup = PhotoActionPopup.createPopupMenu(
                         mContext, mPhotoView, listener, mPhotoMode);
                 mPopup.setOnDismissListener(new OnDismissListener() {
                     @Override
                     public void onDismiss() {
                         listener.onPhotoSelectionDismissed();
                     }
                 });
                 mPopup.show();
             }
         }
     }

     /**
      * Attempts to handle the given activity result.  Returns whether this handler was able to
      * process the result successfully.
      * @param requestCode The request code.
      * @param resultCode The result code.
      * @param data The intent that was returned.
      * @return Whether the handler was able to process the result.
      */
     public boolean handlePhotoActivityResult(int requestCode, int resultCode, Intent data) {
         final PhotoActionListener listener = getListener();
         if (resultCode == Activity.RESULT_OK) {
             switch (requestCode) {
                 // Photo was chosen (either new or existing from gallery), and cropped.
                 case REQUEST_CODE_PHOTO_PICKED_WITH_DATA: {
                     final String path = ContactPhotoUtils.pathForCroppedPhoto(
                             mContext, listener.getCurrentPhotoFile());
                     Bitmap bitmap = BitmapFactory.decodeFile(path);
                     listener.onPhotoSelected(bitmap);
                     return true;
                 }
                 // Photo was successfully taken, now crop it.
                 case REQUEST_CODE_CAMERA_WITH_DATA: {
                     doCropPhoto(listener.getCurrentPhotoFile());
                     return true;
                 }
             }
         }
         return false;
     }

     /**
      * Return the index of the first entity in the contact data that belongs to a contact-writable
      * account, or -1 if no such entity exists.
      */
     private int getWritableEntityIndex() {
         // Directory entries are non-writable.
         if (mIsDirectoryContact) return -1;
         return mState.indexOfFirstWritableRawContact(mContext);
     }

     /**
      * Return the raw-contact id of the first entity in the contact data that belongs to a
      * contact-writable account, or -1 if no such entity exists.
      */
     protected long getWritableEntityId() {
         int index = getWritableEntityIndex();
         if (index == -1) return -1;
         return mState.get(index).getValues().getId();
     }

     /**
      * Utility method to retrieve the entity delta for attaching the given bitmap to the contact.
      * This will attach the photo to the first contact-writable account that provided data to the
      * contact.  It is the caller's responsibility to apply the delta.
      * @return An entity delta list that can be applied to associate the bitmap with the contact,
      *     or null if the photo could not be parsed or none of the accounts associated with the
      *     contact are writable.
      */
     public RawContactDeltaList getDeltaForAttachingPhotoToContact() {
         // Find the first writable entity.
         int writableEntityIndex = getWritableEntityIndex();
         if (writableEntityIndex != -1) {
             // We are guaranteed to have contact data if we have a writable entity index.
             final RawContactDelta delta = mState.get(writableEntityIndex);

             // Need to find the right account so that EntityModifier knows which fields to add
             final ContentValues entityValues = delta.getValues().getCompleteValues();
             final String type = entityValues.getAsString(RawContacts.ACCOUNT_TYPE);
             final String dataSet = entityValues.getAsString(RawContacts.DATA_SET);
             final AccountType accountType = AccountTypeManager.getInstance(mContext).getAccountType(
                         type, dataSet);

             final ValuesDelta child = RawContactModifier.ensureKindExists(
                     delta, accountType, Photo.CONTENT_ITEM_TYPE);
             child.setFromTemplate(false);
             child.setSuperPrimary(true);

             return mState;
         }
         return null;
     }

     /** Used by subclasses to delegate to their enclosing Activity or Fragment. */
     protected abstract void startPhotoActivity(Intent intent, int requestCode, String photoFile);

     /**
      * Sends a newly acquired photo to Gallery for cropping
      */
     private void doCropPhoto(String fileName) {
         try {
             // Obtain the absolute paths for the newly-taken photo, and the destination
             // for the soon-to-be-cropped photo.
             final String newPath = ContactPhotoUtils.pathForNewCameraPhoto(fileName);
             final String croppedPath = ContactPhotoUtils.pathForCroppedPhoto(mContext, fileName);

             // Add the image to the media store
             MediaScannerConnection.scanFile(
                     mContext,
                     new String[] { newPath },
                     new String[] { null },
                     null);

             // Launch gallery to crop the photo
             final Intent intent = getCropImageIntent(newPath, croppedPath);
             startPhotoActivity(intent, REQUEST_CODE_PHOTO_PICKED_WITH_DATA, fileName);
         } catch (Exception e) {
             Log.e(TAG, "Cannot crop image", e);
             Toast.makeText(mContext, R.string.photoPickerNotFoundText, Toast.LENGTH_LONG).show();
         }
     }

     /**
      * Should initiate an activity to take a photo using the camera.
      * @param photoFile The file path that will be used to store the photo.  This is generally
      *     what should be returned by
      *     {@link PhotoSelectionHandler.PhotoActionListener#getCurrentPhotoFile()}.
      */
     private void startTakePhotoActivity(String photoFile) {
         final Intent intent = getTakePhotoIntent(photoFile);
         startPhotoActivity(intent, REQUEST_CODE_CAMERA_WITH_DATA, photoFile);
     }

     /**
      * Should initiate an activity pick a photo from the gallery.
      * @param photoFile The temporary file that the cropped image is written to before being
      *     stored by the content-provider.
      *     {@link PhotoSelectionHandler#handlePhotoActivityResult(int, int, Intent)}.
      */
     private void startPickFromGalleryActivity(String photoFile) {
         final Intent intent = getPhotoPickIntent(photoFile);
         startPhotoActivity(intent, REQUEST_CODE_PHOTO_PICKED_WITH_DATA, photoFile);
     }

     private int getPhotoPickSize() {
         // Note that this URI is safe to call on the UI thread.
         Cursor c = mContext.getContentResolver().query(DisplayPhoto.CONTENT_MAX_DIMENSIONS_URI,
                 new String[]{DisplayPhoto.DISPLAY_MAX_DIM}, null, null, null);
         try {
             c.moveToFirst();
             return c.getInt(0);
         } finally {
             c.close();
         }
     }

     /**
      * Constructs an intent for picking a photo from Gallery, cropping it and returning the bitmap.
      */
     private Intent getPhotoPickIntent(String photoFile) {
         final String croppedPhotoPath = ContactPhotoUtils.pathForCroppedPhoto(mContext, photoFile);
         final Uri croppedPhotoUri = Uri.fromFile(new File(croppedPhotoPath));
         final Intent intent = new Intent(Intent.ACTION_GET_CONTENT, null);
         intent.setType("image/*");
         ContactPhotoUtils.addGalleryIntentExtras(intent, croppedPhotoUri, mPhotoPickSize);
         return intent;
     }

     /**
      * Constructs an intent for image cropping.
      */
     private Intent getCropImageIntent(String inputPhotoPath, String croppedPhotoPath) {
         final Uri inputPhotoUri = Uri.fromFile(new File(inputPhotoPath));
         final Uri croppedPhotoUri = Uri.fromFile(new File(croppedPhotoPath));
         Intent intent = new Intent("com.android.camera.action.CROP");
         intent.setDataAndType(inputPhotoUri, "image/*");
         ContactPhotoUtils.addGalleryIntentExtras(intent, croppedPhotoUri, mPhotoPickSize);
         return intent;
     }

     /**
      * Constructs an intent for capturing a photo and storing it in a temporary file.
      */
     private static Intent getTakePhotoIntent(String fileName) {
         Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE, null);
         final String newPhotoPath = ContactPhotoUtils.pathForNewCameraPhoto(fileName);
         intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(new File(newPhotoPath)));
         return intent;
     }

     public abstract class PhotoActionListener implements PhotoActionPopup.Listener {
         @Override
         public void onUseAsPrimaryChosen() {
             // No default implementation.
         }

         @Override
         public void onRemovePictureChosen() {
             // No default implementation.
         }

         @Override
         public void onTakePhotoChosen() {
             try {
                 // Launch camera to take photo for selected contact
                 startTakePhotoActivity(ContactPhotoUtils.generateTempPhotoFileName());
             } catch (ActivityNotFoundException e) {
                 Toast.makeText(
                         mContext, R.string.photoPickerNotFoundText, Toast.LENGTH_LONG).show();
             }
         }

         @Override
         public void onPickFromGalleryChosen() {
             try {
                 // Launch picker to choose photo for selected contact
                 startPickFromGalleryActivity(ContactPhotoUtils.generateTempPhotoFileName());
             } catch (ActivityNotFoundException e) {
                 Toast.makeText(
                         mContext, R.string.photoPickerNotFoundText, Toast.LENGTH_LONG).show();
             }
         }

         /**
          * Called when the user has completed selection of a photo.
          * @param bitmap The selected and cropped photo.
          */
         public abstract void onPhotoSelected(Bitmap bitmap);

         /**
          * Gets the current photo file that is being interacted with.  It is the activity or
          * fragment's responsibility to maintain this in saved state, since this handler instance
          * will not survive rotation.
          */
         public abstract String getCurrentPhotoFile();

         /**
          * Called when the photo selection dialog is dismissed.
          */
         public abstract void onPhotoSelectionDismissed();
     }
 }
	/*
	* Copyright (C) 2011 The Android Open Source Project
	*
	* Licensed under the Apache License, Version 2.0 (the "License");
	* you may not use this file except in compliance with the License.
	* You may obtain a copy of the License at
	*
	* http://www.apache.org/licenses/LICENSE-2.0
	*
	* Unless required by applicable law or agreed to in writing, software
	* distributed under the License is distributed on an "AS IS" BASIS,
	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
	* See the License for the specific language governing permissions and
	* limitations under the License.
	*/

	package com.android.contacts.detail;

	import android.app.Activity;
	import android.content.ActivityNotFoundException;
	import android.content.ContentValues;
	import android.content.Context;
	import android.content.Intent;
	import android.database.Cursor;
	import android.graphics.Bitmap;
	import android.graphics.BitmapFactory;
	import android.media.MediaScannerConnection;
	import android.net.Uri;
	import android.provider.ContactsContract.CommonDataKinds.Photo;
	import android.provider.ContactsContract.DisplayPhoto;
	import android.provider.ContactsContract.RawContacts;
	import android.provider.MediaStore;
	import android.util.Log;
	import android.view.View;
	import android.view.View.OnClickListener;
	import android.widget.ListPopupWindow;
	import android.widget.PopupWindow.OnDismissListener;
	import android.widget.Toast;

	import com.android.contacts.R;
	import com.android.contacts.editor.PhotoActionPopup;
	import com.android.contacts.common.model.AccountTypeManager;
	import com.android.contacts.model.RawContactModifier;
	import com.android.contacts.model.RawContactDelta;
	import com.android.contacts.common.model.ValuesDelta;
	import com.android.contacts.common.model.account.AccountType;
	import com.android.contacts.model.RawContactDeltaList;
	import com.android.contacts.util.ContactPhotoUtils;
	import com.android.contacts.util.UiClosables;

	import java.io.File;

	/**
	* Handles displaying a photo selection popup for a given photo view and dealing with the results
	* that come back.
	*/
	public abstract class PhotoSelectionHandler implements OnClickListener {

	private static final String TAG = PhotoSelectionHandler.class.getSimpleName();

	private static final int REQUEST_CODE_CAMERA_WITH_DATA = 1001;
	private static final int REQUEST_CODE_PHOTO_PICKED_WITH_DATA = 1002;

	protected final Context mContext;
	private final View mPhotoView;
	private final int mPhotoMode;
	private final int mPhotoPickSize;
	private final RawContactDeltaList mState;
	private final boolean mIsDirectoryContact;
	private ListPopupWindow mPopup;

	public PhotoSelectionHandler(Context context, View photoView, int photoMode,
	boolean isDirectoryContact, RawContactDeltaList state) {
	mContext = context;
	mPhotoView = photoView;
	mPhotoMode = photoMode;
	mIsDirectoryContact = isDirectoryContact;
	mState = state;
	mPhotoPickSize = getPhotoPickSize();
	}

	public void destroy() {
	UiClosables.closeQuietly(mPopup);
	}

	public abstract PhotoActionListener getListener();

	@Override
	public void onClick(View v) {
	final PhotoActionListener listener = getListener();
	if (listener != null) {
	if (getWritableEntityIndex() != -1) {
	mPopup = PhotoActionPopup.createPopupMenu(
	mContext, mPhotoView, listener, mPhotoMode);
	mPopup.setOnDismissListener(new OnDismissListener() {
	@Override
	public void onDismiss() {
	listener.onPhotoSelectionDismissed();
	}
	});
	mPopup.show();
	}
	}
	}

	/**
	* Attempts to handle the given activity result. Returns whether this handler was able to
	* process the result successfully.
	* @param requestCode The request code.
	* @param resultCode The result code.
	* @param data The intent that was returned.
	* @return Whether the handler was able to process the result.
	*/
	public boolean handlePhotoActivityResult(int requestCode, int resultCode, Intent data) {
	final PhotoActionListener listener = getListener();
	if (resultCode == Activity.RESULT_OK) {
	switch (requestCode) {
	// Photo was chosen (either new or existing from gallery), and cropped.
	case REQUEST_CODE_PHOTO_PICKED_WITH_DATA: {
	final String path = ContactPhotoUtils.pathForCroppedPhoto(
	mContext, listener.getCurrentPhotoFile());
	Bitmap bitmap = BitmapFactory.decodeFile(path);
	listener.onPhotoSelected(bitmap);
	return true;
	}
	// Photo was successfully taken, now crop it.
	case REQUEST_CODE_CAMERA_WITH_DATA: {
	doCropPhoto(listener.getCurrentPhotoFile());
	return true;
	}
	}
	}
	return false;
	}

	/**
	* Return the index of the first entity in the contact data that belongs to a contact-writable
	* account, or -1 if no such entity exists.
	*/
	private int getWritableEntityIndex() {
	// Directory entries are non-writable.
	if (mIsDirectoryContact) return -1;
	return mState.indexOfFirstWritableRawContact(mContext);
	}

	/**
	* Return the raw-contact id of the first entity in the contact data that belongs to a
	* contact-writable account, or -1 if no such entity exists.
	*/
	protected long getWritableEntityId() {
	int index = getWritableEntityIndex();
	if (index == -1) return -1;
	return mState.get(index).getValues().getId();
	}

	/**
	* Utility method to retrieve the entity delta for attaching the given bitmap to the contact.
	* This will attach the photo to the first contact-writable account that provided data to the
	* contact. It is the caller's responsibility to apply the delta.
	* @return An entity delta list that can be applied to associate the bitmap with the contact,
	* or null if the photo could not be parsed or none of the accounts associated with the
	* contact are writable.
	*/
	public RawContactDeltaList getDeltaForAttachingPhotoToContact() {
	// Find the first writable entity.
	int writableEntityIndex = getWritableEntityIndex();
	if (writableEntityIndex != -1) {
	// We are guaranteed to have contact data if we have a writable entity index.
	final RawContactDelta delta = mState.get(writableEntityIndex);

	// Need to find the right account so that EntityModifier knows which fields to add
	final ContentValues entityValues = delta.getValues().getCompleteValues();
	final String type = entityValues.getAsString(RawContacts.ACCOUNT_TYPE);
	final String dataSet = entityValues.getAsString(RawContacts.DATA_SET);
	final AccountType accountType = AccountTypeManager.getInstance(mContext).getAccountType(
	type, dataSet);

	final ValuesDelta child = RawContactModifier.ensureKindExists(
	delta, accountType, Photo.CONTENT_ITEM_TYPE);
	child.setFromTemplate(false);
	child.setSuperPrimary(true);

	return mState;
	}
	return null;
	}

	/** Used by subclasses to delegate to their enclosing Activity or Fragment. */
	protected abstract void startPhotoActivity(Intent intent, int requestCode, String photoFile);

	/**
	* Sends a newly acquired photo to Gallery for cropping
	*/
	private void doCropPhoto(String fileName) {
	try {
	// Obtain the absolute paths for the newly-taken photo, and the destination
	// for the soon-to-be-cropped photo.
	final String newPath = ContactPhotoUtils.pathForNewCameraPhoto(fileName);
	final String croppedPath = ContactPhotoUtils.pathForCroppedPhoto(mContext, fileName);

	// Add the image to the media store
	MediaScannerConnection.scanFile(
	mContext,
	new String[] { newPath },
	new String[] { null },
	null);

	// Launch gallery to crop the photo
	final Intent intent = getCropImageIntent(newPath, croppedPath);
	startPhotoActivity(intent, REQUEST_CODE_PHOTO_PICKED_WITH_DATA, fileName);
	} catch (Exception e) {
	Log.e(TAG, "Cannot crop image", e);
	Toast.makeText(mContext, R.string.photoPickerNotFoundText, Toast.LENGTH_LONG).show();
	}
	}

	/**
	* Should initiate an activity to take a photo using the camera.
	* @param photoFile The file path that will be used to store the photo. This is generally
	* what should be returned by
	* {@link PhotoSelectionHandler.PhotoActionListener#getCurrentPhotoFile()}.
	*/
	private void startTakePhotoActivity(String photoFile) {
	final Intent intent = getTakePhotoIntent(photoFile);
	startPhotoActivity(intent, REQUEST_CODE_CAMERA_WITH_DATA, photoFile);
	}

	/**
	* Should initiate an activity pick a photo from the gallery.
	* @param photoFile The temporary file that the cropped image is written to before being
	* stored by the content-provider.
	* {@link PhotoSelectionHandler#handlePhotoActivityResult(int, int, Intent)}.
	*/
	private void startPickFromGalleryActivity(String photoFile) {
	final Intent intent = getPhotoPickIntent(photoFile);
	startPhotoActivity(intent, REQUEST_CODE_PHOTO_PICKED_WITH_DATA, photoFile);
	}

	private int getPhotoPickSize() {
	// Note that this URI is safe to call on the UI thread.
	Cursor c = mContext.getContentResolver().query(DisplayPhoto.CONTENT_MAX_DIMENSIONS_URI,
	new String[]{DisplayPhoto.DISPLAY_MAX_DIM}, null, null, null);
	try {
	c.moveToFirst();
	return c.getInt(0);
	} finally {
	c.close();
	}
	}

	/**
	* Constructs an intent for picking a photo from Gallery, cropping it and returning the bitmap.
	*/
	private Intent getPhotoPickIntent(String photoFile) {
	final String croppedPhotoPath = ContactPhotoUtils.pathForCroppedPhoto(mContext, photoFile);
	final Uri croppedPhotoUri = Uri.fromFile(new File(croppedPhotoPath));
	final Intent intent = new Intent(Intent.ACTION_GET_CONTENT, null);
	intent.setType("image/*");
	ContactPhotoUtils.addGalleryIntentExtras(intent, croppedPhotoUri, mPhotoPickSize);
	return intent;
	}

	/**
	* Constructs an intent for image cropping.
	*/
	private Intent getCropImageIntent(String inputPhotoPath, String croppedPhotoPath) {
	final Uri inputPhotoUri = Uri.fromFile(new File(inputPhotoPath));
	final Uri croppedPhotoUri = Uri.fromFile(new File(croppedPhotoPath));
	Intent intent = new Intent("com.android.camera.action.CROP");
	intent.setDataAndType(inputPhotoUri, "image/*");
	ContactPhotoUtils.addGalleryIntentExtras(intent, croppedPhotoUri, mPhotoPickSize);
	return intent;
	}

	/**
	* Constructs an intent for capturing a photo and storing it in a temporary file.
	*/
	private static Intent getTakePhotoIntent(String fileName) {
	Intent intent = new Intent(MediaStore.ACTION_IMAGE_CAPTURE, null);
	final String newPhotoPath = ContactPhotoUtils.pathForNewCameraPhoto(fileName);
	intent.putExtra(MediaStore.EXTRA_OUTPUT, Uri.fromFile(new File(newPhotoPath)));
	return intent;
	}

	public abstract class PhotoActionListener implements PhotoActionPopup.Listener {
	@Override
	public void onUseAsPrimaryChosen() {
	// No default implementation.
	}

	@Override
	public void onRemovePictureChosen() {
	// No default implementation.
	}

	@Override
	public void onTakePhotoChosen() {
	try {
	// Launch camera to take photo for selected contact
	startTakePhotoActivity(ContactPhotoUtils.generateTempPhotoFileName());
	} catch (ActivityNotFoundException e) {
	Toast.makeText(
	mContext, R.string.photoPickerNotFoundText, Toast.LENGTH_LONG).show();
	}
	}

	@Override
	public void onPickFromGalleryChosen() {
	try {
	// Launch picker to choose photo for selected contact
	startPickFromGalleryActivity(ContactPhotoUtils.generateTempPhotoFileName());
	} catch (ActivityNotFoundException e) {
	Toast.makeText(
	mContext, R.string.photoPickerNotFoundText, Toast.LENGTH_LONG).show();
	}
	}

	/**
	* Called when the user has completed selection of a photo.
	* @param bitmap The selected and cropped photo.
	*/
	public abstract void onPhotoSelected(Bitmap bitmap);

	/**
	* Gets the current photo file that is being interacted with. It is the activity or
	* fragment's responsibility to maintain this in saved state, since this handler instance
	* will not survive rotation.
	*/
	public abstract String getCurrentPhotoFile();

	/**
	* Called when the photo selection dialog is dismissed.
	*/
	public abstract void onPhotoSelectionDismissed();
	}
	}