Prévisualiser l'image avant de prendre une photo

Il est obligatoire de prévisualiser ce qui passe par la caméra avant de pouvoir prendre une photo avec une caméra.

Pour effectuer cette prévisualisation, vous pourrez utiliser une SurfaceView.

Il suffit ensuite d'indiquer à la caméra l'instance de SurfaceHolder associée à la SurfaceView pour permettre à la caméra de modifier/synchroniser le contenu de la SurfaceView avec le buffer de la caméra.

Préparer l'activité

Avant tout, il faut préparer l'activité à gérer la surfaceView.

Cela se fait en deux étapes:

Implémenter les procédures callback de la surfaceholder:

implements SurfaceHolder.Callback

Ce qui permettra d'avoir 3 méthodes supplémentaires de gestion de la surface:

• public void surfaceCreated(SurfaceHolder holder)
  • Pour indiquer le gestionnaire de surfaces à utiliser par la caméra pour accéder à la surfaceView: camera.setPreviewDisplay(holder);
  • Pour éventuellement démarrer la preview de la caméra:camera.startPreview();
  • Tout ce dont vous aurez vous même besoin de faire...
• public void surfaceChanged(SurfaceHolder holder, int format, int width, int height)
  • Rien de particulier pour la caméra pour le moment...
• public void surfaceDestroyed(SurfaceHolder holder)
  • Si la surface vient à disparaître, il faut stopper la preview de la caméra avant et lui indiquer en passant que la surface n'est plus accessible ! La méthode se nomme tout simplement camera.stopPreview()

Paramétrer l'instance de SurfaceHolder avec la SurfaceView utilisée.

Il est plus que probable que l'activité passe dans la méthode onPause avant que sa surface ne soit détruite. Dans ce cas, il faut faire un stopPreview dans le onPause avant un release de la camera et tester la validité de la caméra dans surfaceDestroyed en testant par exemple la valeur null dans l'instance de camera positionnée lors du onPause !

Exemple de code

En reprenant le code déjà vu pour permettre la gestion d'une caméra dans le cycle de vie d'une activité, vous obtenez le code suivant:

package fr.free.supertos.essaicamera; import java.io.IOException; import android.app.Activity; import android.hardware.Camera; import android.os.Build; import android.os.Bundle; import android.view.SurfaceHolder; import android.view.SurfaceView; public class MainActivity extends Activity implements SurfaceHolder.Callback { private Camera camera; @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); // Récupération de l'objet SurfaceView positionné dans le layout SurfaceView surface = (SurfaceView)findViewById(R.id.surfaceView1); SurfaceHolder holder = surface.getHolder(); holder.addCallback(this); // Si version d'android avant HONEYCOMB, il faut faire ce qui suit. // Sinon rien à faire, c'est fait automatiquement if(Build.VERSION.SDK_INT < Build.VERSION_CODES.HONEYCOMB) { holder.setType(SurfaceHolder.SURFACE_TYPE_PUSH_BUFFERS); } // Fixer la taille de la surface d'affichage holder.setFixedSize(400, 300); } @Override protected void onPause() { super.onPause(); // Libérer la camera, une autre activité peut en avoir besoin ! camera.stopPreview(); camera.release(); camera=null; } @Override protected void onResume() { super.onResume(); // Notre activité est créée ou relancée, prennons le contrôle de la caméra camera = Camera.open(); } @Override public void surfaceCreated(SurfaceHolder holder) { // Indiquer à la caméra la zone de preview, ici le gestionnaire de la surfaceView ! try { // Associer la surfaceView à la caméra vie son holder camera.setPreviewDisplay(holder); // Démarrer la preview camera.startPreview(); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } } @Override public void surfaceChanged(SurfaceHolder holder, int format, int width, int height) { // TODO Auto-generated method stub // Rien pour le moment ! } @Override public void surfaceDestroyed(SurfaceHolder holder) { // Il faut arrêter la preview sur cette surface qui ne va bientôt plus exister ! // Mais peut-être déjà arrêté à cause d'un onPause ? if (camera!=null) { camera.stopPreview(); } } }

Un layout activity_main.xml rudimentaire:

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:id="@+id/container" android:layout_width="match_parent" android:layout_height="match_parent" tools:context="fr.free.supertos.MainActivity" android:keepScreenOn="true" > <TextView android:id="@+id/textView1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_alignParentLeft="true" android:layout_alignParentTop="true" android:layout_marginLeft="59dp" android:layout_marginTop="22dp" android:text="Test caméra !" /> <SurfaceView android:id="@+id/surfaceView1" android:layout_width="wrap_content" android:layout_height="wrap_content" android:layout_alignParentLeft="true" android:layout_below="@+id/textView1" android:layout_marginLeft="25dp" android:layout_marginTop="23dp" /> </RelativeLayout>

Et ne pas oublier les permissions dans le fichier manifest !

<?xml version="1.0" encoding="utf-8"?> <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="fr.free.supertos.essaicamera" android:versionCode="1" android:versionName="1.0" > <uses-permission android:name="android.permission.CAMERA"/> <uses-feature android:name="android.hardware.camera.autofocus" /> <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/> <uses-sdk android:minSdkVersion="8" android:targetSdkVersion="19" /> <application android:allowBackup="true" android:icon="@drawable/ic_launcher" android:label="@string/app_name" android:theme="@style/AppTheme" > <activity android:name="fr.free.supertos.essaicamera.MainActivity" android:label="@string/app_name" > <intent-filter> <action android:name="android.intent.action.MAIN" /> <category android:name="android.intent.category.LAUNCHER" /> </intent-filter> </activity> </application> </manifest>

Définir l'orientation de la caméra à l'affichage

La caméra ne retourne pas forcement son rendu (preview) dans le même sens que celui où vous regardez l'écran. Et c'est encore pire avec la caméra frontale avec un effet miroir (il faudra déterminer la caméra utilisée: frontale, ou arrière).

Pour résoudre ce problème, il faudra indiquer à l'instance de la classe Camera l'orientation de l'affichage.

Voici une solution de méthode (proposé par Google) pour déterminer cette rotation:

public static void setCameraDisplayOrientation(Activity activity, int cameraId, android.hardware.Camera camera) { android.hardware.Camera.CameraInfo info = new android.hardware.Camera.CameraInfo(); android.hardware.Camera.getCameraInfo(cameraId, info); // Récupération de l'orientation de l'écran int rotationEcran = activity.getWindowManager().getDefaultDisplay().getRotation(); // Et positionner ainsi le nombre de degrés de rotation pour la caméra int degrees = 0; switch (rotationEcran) { case Surface.ROTATION_0: degrees = 0; break; case Surface.ROTATION_90: degrees = 90; break; case Surface.ROTATION_180: degrees = 180; break; case Surface.ROTATION_270: degrees = 270; break; } int rotationAffichage; if (info.facing == Camera.CameraInfo.CAMERA_FACING_FRONT) { // Cas de la caméra frontale, il y a un effet miroire à compenser ! rotationAffichage = (info.orientation + degrees) % 360; rotationAffichage = (360 - rotationAffichage) % 360; } else { // back-facing // Correction de la rotation rotationAffichage = (info.orientation - degrees + 360) % 360; } camera.setDisplayOrientation(rotationAffichage); }

Exemple de Google pour traiter le cas de la rotation de l'écran.

Avant l'API 14, cette méthode ne doit pas être appelée lorsque la caméra est en mode preview mais avant de passer en mode preview...Sinon, il est trop tard pour pouvoir prendre en compte cette information !

Cette rotation de l'image ne change en rien l'orientation définie lors de la prise de la photo. Elle ne sert donc bien qu'à l'affichage lors du preview. Elle n'affecte donc pas l'image JPEG que vous sauverez !

annexe

Rotation de l'écran