mirror of https://gitee.com/shuto/customCamera.git synced 2024-10-06 18:32:07 +08:00

ChristopheBoucaut da0c65fb4e MAJ doc.

Mise à jour de la doc pour l'ajout des options sur le flash.

2015-02-03 11:58:07 +01:00

6.0 KiB

Raw Blame History

org.geneanet.customcamera

Ce plugin cordova est une alternative au plugin cordova officiel (camera). Il permet de démarrer un appareil photo personnalisé (image en surimpression de l'appareil photo avec réglage de l'opacité, barre de zoom) et customisable (couleur des boutons, activation/désactivation de fonctions).

Ce plugin définit une variable globale navigator.GeneanetCustomCamera.

Installation

cordova plugin add https://github.com/geneanet/customCamera.git
cordova build `platform`

Plateformes supportées

Android

Utilisation

Commande

navigator.GeneanetCustomCamera.startCamera(options, onSuccess, onFail);

Paramètres

{Object} options

L'objet options contient les options de configuration de l'appareil photo.

imgBackgroundBase64 : Image qui sera présente en surimpression de l'appareil photo. Elle doit être en base64.
- Type : string
- Valeur par défaut : null
imgBackgroundBase64OtherOrientation : Image qui sera présente en surimpression de l'appareil photo lorsque l'on tourne l'appareil dans l'autre sens que celui de démarrage du plugin. Elle doit être en base64. Si à null, on utilisera imgBackgroundBase64 en redimensionnant l'image.
- Type : string
- Valeur par défaut : null
miniature : Permet d'activer ou non la fonction de miniature. true : Active l'option. false : Désactive l'option.
- Type : boolean
- Valeur par défaut : true
saveInGallery : Permet de stocker la photo dans la gallery du téléphone. true : Active l'option. false : Désactive l'option.
- Type : boolean
- Valeur par défaut : false
cameraBackgroundColor : Couleur pour le bouton de prise de photo.
- Type : string
- Valeur par défaut : "#e26760"
- Notes :
  - Une mauvaise valeur ou une valeur null produit un effet de transparance.
  - Pour connaitre les formats de couleurs, consulter la méthode parseColor().
cameraBackgroundColorPressed : Couleur pour le bouton de prise de photo lorsqu'il est pressé.
- Type : string
- Valeur par défaut : "#dc453d"
- Notes :
  - Une mauvaise valeur ou une valeur null produit un effet de transparance.
  - Pour connaitre les formats de couleurs, consulter la méthode parseColor().
quality : Qualité de la photo.
- Type : integer
- Valeur par défaut : 100
- Notes :
  - La valeur doit être comprise entre 0 et 100. Si la valeur n'est pas dans cet interval, la valeur par défaut est utilisée.
  - Pour plus d'information, consulter la méthode compress().
opacity : Permet d'activer ou non la fonction d'opacité de l'image en surimpression. true : Active l'option. false : Désactive l'option.
- Type : boolean
- Valeur par défaut : true
defaultFlash : Séléctionne un mode par défaut pour le flash.
- Type : integer
- Valeur par défaut : 0
switchFlash : Permet d'activer ou non le bouton pour changer le mode du flash. true : Active l'option. false : Désactive l'option.
- Type : boolean
- Valeur par défaut : true

{Function} onSuccess

La fonction onSuccess est appelée lorsque la prise de vue a réussie.

Paramètres :
- result :
  - Type : string
  - Note : Contient l'image prise au format base64.

{Function} onFail

La fonction onFail est appelée lorsque la prise de vue a échouée.

Paramètres :
- code :
  - Type : integer
  - Note : Contient le code d'erreur.
    - Code "2" : Erreur lors de l'exécution de l'appareil photo.
    - Code "3" : L'utilisateur a fermé l'appareil photo sans prendre de photo.
- message :
  - Type : string
  - Note : Contient un message détaillant l'erreur.

Constantes

CustomCamera.FlashModes.DISABLE :
- Type : integer
- Valeur : 0
CustomCamera.FlashModes.ACTIVE :
- Type : integer
- Valeur : 1
CustomCamera.FlashModes.AUTO :
- Type : integer
- Valeur : 2

Implémentation

Exemple

var base64 = "...";
navigator.GeneanetCustomCamera.startCamera(
    {
        imgBackgroundBase64: base64,
        saveInGallery: true,
        miniature: false,
        quality: 70,
        cameraBackgroundColor: "#ffffff",
        cameraBackgroundColorPressed: null
    },
    function(result) {
        window.console.log("success");
        $("#imgTaken").attr("src", "data:image/jpeg;base64,"+result);
    },
    function(code, message) {
        window.console.log("fail");
        window.console.log(code);
        window.console.log(message);
    }
);

Application de code barre

Voir le code

Application avec grille