DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Caméra
  • Tableau de correspondance entre le paramètre à modifier et les valeurs possibles pour ce paramètre
  • Permissions requises
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Renvoie ou modifie la valeur d'un paramètre de la caméra de l'appareil.
Avertissement
AndroidiPhone/iPad A partir de la version 27, cette fonction est ignorée pour les applications Android et iOS. Cette fonction est conservée uniquement pour les champs Caméra provenant de versions inférieures et ayant l'option "Mode compatible 26" cochée (onglet "Général" de la fenêtre de description du champ).
Remarques :
  • Pour connaître la liste des valeurs supportées par la caméra pour un paramètre donné, utilisez la fonction CaméraListeParamètre.
  • Android La fonction CaméraParamètre peut être utilisée dans l'émulateur Android mais pas dans le simulateur.
  • Cette fonction est équivalente à la fonction VidéoParamètre.
Exemple
// Utilisation de la résolution maximale pour prendre une photo
sListeRésolution est une chaîne
sListeRésolution = CaméraListeParamètre(vipRésolutionPhoto)
SI ErreurDétectée = Faux ALORS
CaméraParamètre(vipRésolutionPhoto, ExtraitChaîne(sListeRésolution, rangDernier, RC))
SINON
Erreur("Erreur durant la récupération des résolutions supportées par la caméra.")
FIN
 
// Utilisation de la valeur maximale du zoom
sListeZoom est une chaîne
sListeZoom = CaméraListeParamètre(vipZoom)
SI ErreurDétectée = Faux ALORS
nZoom est un entier = Val(ExtraitChaîne(sListeZoom, rangDernier, RC))
SI CaméraParamètre(vipZoom, nZoom) = Faux ALORS
Erreur("La caméra ne peut pas zoomer.")
FIN
FIN
 
// Géolocalisation des photos prises par la caméra
MaPosition est une géoPosition = GPSRécupèrePosition()
CaméraParamètre(vipGéoPosition, MaPosition)
 
// Réglage de la sensibilité ISO
CaméraParamètre(vipISO, 800)
Syntaxe

Récupérer la valeur d'un paramètre de la caméra de l'appareil Masquer les détails

<Résultat> = CaméraParamètre(<Paramètre>)
<Résultat> : Type du paramètre récupéré
  • Valeur du paramètre,
  • Chaîne vide ("") si le paramètre spécifié n'est pas supporté par la caméra ou en cas d'erreur lors de la récupération des paramètres de la caméra.
En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Paramètre> : Constante de type chaîne de caractères ou chaîne de caractères
Paramètre pour lequel la valeur doit être récupérée. Ce paramètre peut correspondre :
  • soit à une des constantes prédéfinies. Ces constantes correspondent aux paramètres les plus courants.
  • soit à une Chaîne de caractères correspondant au nom du paramètre voulu.
    Attention : le nom du paramètre est sensible à la casse et à l'accentuation. Consultez la documentation du SDK Android ou de l'appareil pour connaître le nom des paramètres supplémentaires supportés. Si le nom spécifié ne correspond pas à un paramètre supporté par la caméra, la fonction retournera chaîne vide.
Les constantes disponibles sont les suivantes :
vipBalanceMode de balance des blancs actuellement supporté par la caméra : automatique, lumière du jour, nuageux, ...
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipCaméraIndice de la caméra en cours d'utilisation :
  • Indice compris entre 1 et le nombre de caméras présentes sur l'appareil.
  • -1 si aucune caméra n'est en cours d'utilisation.
vipCompressionJPEGCompression des images JPEG, correspondant à un entier compris entre 1 et 100.
  • 1 : Compression maximale (qualité faible)
  • 100 : Pas de compression (très haute qualité)
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipEffetEffet de couleurs actuellement pris en compte : noir et blanc, poster, sépia, ...
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipFlashEtat actuel du flash de la caméra : automatique, sans, anti yeux rouges, ...
vipFocusEtat actuel du focus de la caméra : automatique, macro, fixe, ...
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipGéoPositionInformations de géolocalisation actuelles : la valeur retournée est une variable de type géoPosition. Les propriétés suivantes peuvent être renseignées en fonction de ce que gère la caméra : latitude, longitude, altitude, date de mesure.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipISOSensibilité ISO actuellement utilisée par la caméra : automatique, 100, 200, 400, ...
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipRésolutionPhotoRésolution des photos prises par la caméra.
La valeur renvoyée est au format :
<Largeur><TAB><Hauteur>
Exemple :
640<TAB>480
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipRotationAutoRotation automatique des photos en fonction de l'orientation de l'appareil au moment de la capture.
  • Vrai : la rotation automatique est activée.
  • Faux : la rotation automatique est désactivée.
Si la rotation automatique est activée, la photo sera enregistrée en tenant compte de l'orientation de l'appareil au moment de la capture.

La rotation automatique est activée par défaut, cependant certains appareils ne supportent pas la prise de photos en mode portrait. Dans ce cas, il est conseillé de désactiver la rotation automatique et de gérer a posteriori la rotation de l'image par programmation.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipScèneType de scènes actuellement utilisé par la caméra : automatique, nuit, sport, ...
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipScintillementAjustement du scintillement (antibanding) actuellement utilisé par la caméra : automatique, aucun, 50Hz, 60Hz, ...
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipZoomValeur de zoom actuellement utilisée par la caméra.
Les valeurs retournées sont de la forme :
  • 100 (Zoom 1x = pas de zoom)
  • 200 (zoom 2x)
  • 300 (zoom 3x)
  • 350 (zoom 3,5x)
  • ...
La première valeur retournée est toujours 100 et la dernière valeur correspond au zoom maximal.
Exemple :
100<RC>200<RC>300<RC>350
Remarque : La fonction retournera une chaîne vide ("") si la caméra de l'appareil ne supporte pas le zoom.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.

Modifier la valeur d'un paramètre de la caméra de l'appareil Masquer les détails

<Résultat> = CaméraParamètre(<Paramètre> , <Valeur>)
<Résultat> : Booléen
  • Vrai si la modification du paramètre a été effectuée avec succès,
  • Faux dans le cas contraire ou en cas d'erreur lors de la récupération des paramètres de la caméra. Par exemple, la fonction CaméraParamètre retournera Faux si le paramètre spécifié ou sa valeur n'est pas supporté par la caméra.
En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Paramètre> : Constante de type chaîne de caractères ou chaîne de caractères
Paramètre pour lequel la valeur doit être modifiée. Ce paramètre peut correspondre :
  • soit à une des constantes prédéfinies. Ces constantes correspondent aux paramètres les plus courants.
  • soit à une Chaîne de caractères correspondant au nom du paramètre voulu.
    Attention : le nom du paramètre est sensible à la casse et à l'accentuation. Consultez la documentation du SDK Android ou de l'appareil pour connaître le nom des paramètres supplémentaires supportés. Si le nom spécifié ne correspond pas à un paramètre supporté par la caméra, la fonction retournera chaîne vide.
Les constantes disponibles sont les suivantes : Les constantes disponibles sont les suivantes :
vipBalanceMode de balance des blancs de la caméra.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipCaméraIndice de la caméra à utiliser.
Attention : le changement de la caméra entraîne la réinitialisation des paramètres précédemment définis avec la fonction CaméraParamètre.
vipCompressionJPEGCompression des images JPEG.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipEffetEffet de couleurs.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipFlashMode de flash à utiliser par la caméra.
vipFocusMode de focus à utiliser par la caméra.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipGéoPositionInformations de géolocalisation à utiliser.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipISOSensibilités ISO supportées par la caméra.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipRésolutionPhotoDéfinition de la résolution pour les photos prises par la caméra.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipRotationAutoRotation automatique des photos en fonction de l'orientation de l'appareil au moment de la capture.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipScèneType de scènes à utiliser par la caméra.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipScintillementAjustement du scintillement (antibanding) à utiliser par la caméra.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipZoomValeur de zoom à utiliser par la caméra.
iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
<Valeur> : Type correspondant au paramètre à modifier
Nouvelle valeur du paramètre.
Consultez les remarques pour connaître le tableau de correspondance entre le paramètre à modifier et la valeur attendue.
Remarques

Tableau de correspondance entre le paramètre à modifier et les valeurs possibles pour ce paramètre

Paramètre à modifierValeur attendue
vipBalanceModes de balance des blancs supportés par la caméra.
Ce paramètre peut correspondre à une des constantes suivantes ou à une variable de type chaîne de caractères :
  • vipBalanceAuto : mode automatique
  • vipBalanceCrépuscule : éclairage crépusculaire
  • vipBalanceEnsoleillé : éclairage ensoleillé
  • vipBalanceFluorescent : éclairage fluorescent
  • vipBalanceFluorescentChaud : éclairage fluorescent de type chaud
  • vipBalanceIncandescent : éclairage incandescent
  • vipBalanceNuageux : éclairage nuageux
  • vipBalanceOmbrageux : éclairage ombrageux
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipCaméraIndice de la caméra à utiliser. Ce paramètre peut correspondre :
  • à un entier compris entre 1 et le nombre de caméras présentes sur l'appareil
  • à une des constantes suivantes :
    • vipCaméraDorsale : utilisation de la première caméra dorsale (située sur la face opposée de l'écran).
    • vipCaméraFrontale : utilisation de la première caméra frontale (située sur la même face que l'écran).
vipCompressionJPEGCompression des images JPEG.
Entier compris entre 1 et 100 :
  • 1 : Compression maximale (qualité faible)
  • 100 : Pas de compression (très haute qualité)
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipEffetEffets de couleurs.
Ce paramètre peut correspondre à une des constantes suivantes ou à une variable de type chaîne de caractères :
  • vipEffetAqua : effet Aqua
  • vipEffetAucun : pas d'effet
  • vipEffetNégatif : effet négatif
  • vipEffetNoirEtBlanc : effet noir et blanc
  • vipEffetPoster : effet Poster
  • vipEffetSolarise : effet solarise
  • vipEffetSepia : effet sépia
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipFlashModes de flash supportés par la caméra.
Ce paramètre peut correspondre à une des constantes suivantes ou à une variable de type chaîne de caractères :
  • vipFlashAuto : mode automatique (le flash s'allume en cas d'éclairage insuffisant).
    iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
  • vipFlashOff : flash éteint.
  • vipFlashOn : flash allumé au moment de la prise de vue.
  • vipFlashTorche : mode torche : éclairage en continu du flash.
    iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
  • vipFlashYeuxRouges : mode réduction des yeux rouges.
    iPhone/iPadMac Catalyst Cette constante n'est pas disponible.
vipFocusModes de focus supportés par la caméra.
Ce paramètre peut correspondre à une des constantes suivantes ou à une variable de type chaîne de caractères :
  • vipFocusAuto : autofocus
  • vipFocusContinu : continu (pour l'enregistrement vidéo)
  • vipFocusFixe : fixe
  • vipFocusInfini : infini
  • vipFocusMacro : macro (sujet très proche)
  • vipFocusProfondeurChamp : profondeur de champ
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipGéoPositionInformations de géolocalisation.
Ce paramètre correspond à une variable de type géoPosition.
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipISOSensibilités ISO supportées par la caméra.
Ce paramètre peut correspondre à une des constantes suivantes ou à une variable de type chaîne de caractères :
  • vipISOAuto : Ajustement automatique de la sensibilité
  • "100", "200", "400", "800", ...
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipRésolutionPhotoRésolution des photos prises par la caméra.
Ce paramètre utilise le format suivant :
<Largeur><TAB><Hauteur>
Exemple :
1024<TAB>680
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipRotationAutoRotation automatique des photos en fonction de l'orientation de l'appareil au moment de la capture.
Paramètre de type Booléen :
  • Vrai : la rotation automatique est activée.
  • Faux : la rotation automatique est désactivée.
Si la rotation automatique est activée, la photo sera enregistrée en tenant compte de l'orientation de l'appareil au moment de la capture.
La rotation automatique est activée par défaut, cependant certains appareils ne supportent pas la prise de photos en mode portrait. Dans ce cas, il est conseillé de désactiver la rotation automatique et de gérer a posteriori la rotation de l'image par programmation.
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipScèneTypes de scènes supportés par la caméra.
Ce paramètre peut correspondre à une des constantes suivantes ou à une variable de type chaîne de caractères :
  • vipScèneAction : sujet en mouvement
  • vipScèneAuto : mode automatique
  • vipScèneBougie : éclairage à la bougie
  • vipScèneCodeBarres : lecture de code barres
  • vipScèneCoucherSoleil  : coucher de soleil
  • vipScèneFeuArtifice : Feux d'artifice
  • vipScèneIntérieur : photo en intérieur
  • vipScèneNeige : neige
  • vipScèneNuit : photo de nuit
  • vipScènePaysage : sujet lointain, paysage
  • vipScènePlage : plage
  • vipScènePortrait : portrait
  • vipScènePortraitNuit : portrait de nuit
  • vipScèneSport : sujet en mouvement rapide, sportifs
  • vipScèneThéatre : théatre/musée (pas de flash)
  • vipScèneVibration : correction des vibrations
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipScintillementAjustements du scintillement (antibanding) supportés par la caméra.
Ce paramètre peut correspondre à une des constantes suivantes ou à une variable de type chaîne de caractères :
  • vipScintillementAuto : ajustement automatique
  • vipScintillementOff  : pas d'ajustement du scintillement
  • vipScintillement50Hz : 50 Hertz
  • vipScintillement60Hz  : 60 Hertz
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
vipZoomValeurs de zoom supportées par la caméra.
Variable de type entier.
Exemple :
  • 100 : zoom 1x = pas de zoom
  • 200 : zoom 2x
  • 300 : zoom 3x
  • 350 : zoom 3,5x
  • ...
iPhone/iPadMac Catalyst Ce paramètre n'est pas disponible.
Si la valeur du paramètre ne correspond pas à une constante WLangage listée ci-dessus, il est possible d'indiquer directement cette valeur. Consultez la documentation du SDK Android ou de l'appareil pour connaître les valeurs supplémentaires et/ou utilisez la fonction CaméraListeParamètre pour vérifier si cette valeur est bien supportée. Si la valeur spécifiée n'est pas supportée par la caméra, la fonction CaméraParamètre retournera Faux.

Permissions requises

L'utilisation de cette fonction entraîne la modification des permissions requises par l'application.
Permission requise : CAMERA.
Cette permission permet aux applications d'accéder à la caméra.
Composante : wd290android.aar
Version minimum requise
  • Version 22
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale