Camera.Parameters
Cette classe
est dépréciée à partir de l'API
21 d'android. Il est recommandé d'utiliser android.hardware.camera2.
Cette classe Camera.Parameters permet de lire ou de modifier les paramètres d'une caméra.
Pour pouvoir lire/modifier les paramètres d'une caméra, il faut avoir une instance caméra sur la ressource correpondante. Il faut donc s'attribuer la ressource avant toutes choses. Lorsque vous avez terminé d'utiliser cette ressource, n'oubliez pas de la libérer pour que les autres applications puissent s'en servir !
Pour récupérer une instance Parameters correspondant récupérants les paramètres de la caméra, il suffit d'utiliser:
Parameters param = camera.getParameters();
Vous pouvez ensuite positionner ou lire les paramètres.
Mais si
vous modifiez l'un des paramètres de cette instance Parameters, il ne
faudra pas oublier d'utiliser le setter de Camera
pour que ceux-ci prennent effectivement effet sur cette Camera:
camera.setParameters(param);
Voici quelques paramètres que vous pourrez positionner dans votre instance Parameters:
- getMaxNumDetectedFaces() pour indiquer le nombre maximum de visages que l'appareil peut détecter via les cameras en mode preview. Une valeur à 0 indiquant que l'appareil n'est pas capable d'en détecter.
- public List<String> getSupportedFlashModes (), les différents modes possibles du flash. Cf. chapitre sur le flash pour plus de détails.
- get/set FlashMode(String flashMode): pour positionner le flash d'une caméra dans un mode. Cf. chapitre sur le flash pour plus de détails.
- get/set JpegQuality () pour définir la qualité du jpeg lors de la prise de photos. 100 étant la meilleur résolution, donc un fichier image de volume important, à 0 donc un fichier image petit mais de moins bonne résolution.
- get/set PreviewSize pour connaître/définir la taille de l'image de prévisualisation restituée par la caméra. Le getter retournant une instance Size, le setter attendant une largeur et une hauteur. Cf. Définir la taille de l'image généré par la caméra pour une prévisualisation pour plus de détail.
- getSupportedPreviewSizes() permet de connaître la liste des tailles des images de prévisualisation autorisées pour une restitution par la caméra. Cf. Définir la taille de l'image généré par la caméra pour une prévisualisation pour plus de détail.
- get/set JpegThumbnailQuality permet de connaître ou définir la qualité de compression de la vignette contenu dans un fichier jpeg. Valeur variant de 0 à 100 (100 étant la meilleur qualité.
- get/set JpegThumbnailSize permet de connaître ou définir la taille de la vignette.
- public List<Camera.Size> getSupportedJpegThumbnailSizes () permet de connaître la liste des tailles de vignette autorisée. Cette liste sera composée d'au moins 2 éléments, celle comprenant la (0,0) pour ne pas créer de vignette et au moins une autre avec des valeurs différentes de 0.
- get/setWhiteBalance pour connaître ou modifier le mode de balance des blancs, get/setAutoWhiteBalanceLock () pour le mode automatique...ainsi que des méthodes pour vérifier ce qui est supporté par l'appareil.
- get/setColorEffect pour modifier l'effet à appliquer sur les couleurs, getSupportedColorEffects pour connaître la liste des effets disponibles sur l'appareil.