AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Controles, páginas y ventanas / Funciones Cámara
  • Tabla de correspondencias entre el parámetro a modificar y los posibles valores de este parámetro
  • Permisos necesarios
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Devuelve o modifica el valor de un parámetro para la cámara del dispositivo.
Advertencia
AndroidiPhone/iPad A partir de la versión 27, esta función se ignora para las aplicaciones Android e iOS. Esta función se mantiene sólo para los controles de cámara de versiones anteriores y con la opción "Modo compatible con la versión 26" activada (pestaña "General" de la ventana del control description).
Observaciones:
  • Para conocer la lista de valores que admite la cámara para un determinado parámetro, utilice CameraListParameter.
  • Android La función CameraParameter puede utilizarse en el emulador de Android, pero no en el simulador.
  • Esta función es equivalente a la función VideoParameter.
Ejemplo
// Use the maximum resolution to take a photo
sListResolution is string
sListResolution = CameraListParameter(vipPhotoResolution)
IF ErrorOccurred = False THEN
CameraParameter(vipPhotoResolution, ExtractString(sListResolution, lastRank, CR))
ELSE
Error("Error while retrieving the resolutions supported by the camera.")
END
 
// Use the maximum zoom value
sListZoom is string
sListZoom = CameraListParameter(vipZoom)
IF ErrorOccurred = False THEN
nZoom is int = Val(ExtractString(sListZoom, lastRank, CR))
IF CameraParameter(vipZoom, nZoom) = False THEN
Error("The camera cannot zoom.")
END
END
 
// Geolocation of photos taken by the camera
MyPosition is geoPosition = GPSGetPosition()
CameraParameter(vipGeoPosition, MyPosition)
 
// Set the ISO sensitivity
CameraParameter(vipISO, 800)
Sintaxis

Recuperar el valor de un parámetro para la cámara del dispositivo Ocultar los detalles

<Result> = CameraParameter(<Parameter>)
<Result>: Tipo de parámetro recuperado
  • Valor del parámetro,
  • Vacíe la cadena (""") si la cámara no admite el parámetro especificado o si se ha producido un error al recuperar los parámetros de la cámara.
Si se produce un error, la variable ErrorOccurred se pone en True. Para obtener más información sobre el error, utilice la función ErrorInfo.
<Parameter>: Constante de la cadena de caracteres o cadena de caracteres
Parámetro para el que se recuperará el valor. Este parámetro puede corresponder a:
  • una de las constantes preestablecidas. Estas constantes corresponden a los parámetros más comunes.
  • una Cadena correspondiente al nombre del parámetro deseado.
    Atención: el nombre del parámetro distingue entre mayúsculas y minúsculas y acentos. Vea la documentación sobre el SDK de Android o sobre el dispositivo para saber el nombre de los parámetros adicionales soportados. Si el nombre especificado no corresponde a un parámetro soportado por la cámara, la función devolverá una cadena vacía.
Las constantes disponibles son las siguientes:
vipBalanceModo de balance de blancos actualmente soportados por la cámara: automatic, luz del día, nublado, ...
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipCameraÍndice de la cámara utilizada actualmente:
  • El subíndice incluye entre 1 y el número de cámaras que se encuentran en el dispositivo.
  • -1 si no se utiliza actualmente ninguna cámara.
vipCompressionJPEGCompresión de imágenes JPEG, correspondientes a un número entero incluido entre 1 y 100.
  • 1: Máxima compresión (baja calidad)
  • 100: Sin compresión (muy alta calidad)
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipEffectEfecto de los colores que se tienen en cuenta actualmente: negro y White, cartel, sepia, ...
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipFlashEstado actual del flash de la cámara: automatic, sin, ojos anti rojos, ...
vipFlickerAjuste del parpadeo (anti-banding) utilizado actualmente por la cámara: automatic, ninguno, 50Hz, 60Hz, ...
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipFocusEstado actual del enfoque de la cámara: automatic, macro, fijo, ...
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipGeoPositionInformación de geolocalización actual: el valor devuelto es un geoPosition Variable. Las siguientes propiedades pueden ser especificadas de acuerdo con los elementos soportados por la cámara: latitud, longitud, altitud, fecha de medición.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipISOSensibilidad ISO actualmente utilizada por la cámara: automatic , 100, 200, 400, ...
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipPhotoResolutionResolución de las fotos tomadas por la cámara.
El valor se devuelve en el siguiente formato:
<Width><TAB><Height>
Ejemplo:
640<TAB>480
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipRotationAutoautomatic rotación de las fotos según la orientación del dispositivo durante la captura.
  • True: la rotación de automatic está activada.
  • False: la rotación de automatic está desactivada.
Si se activa la rotación de la automatic, la foto se guardará teniendo en cuenta la orientación del dispositivo durante la captura.

La rotación de automatic está habilitada por Default; sin embargo, algunos dispositivos no soportan la toma de fotos en modo retrato. En este caso, le aconsejamos que desactive la rotación de automatic y que gestione la rotación de Image mediante la programación.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipSceneTipos de escenas que utiliza actualmente la cámara: automatic, noche, deportes, ...
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipZoomValor de zoom utilizado actualmente por la cámara.
Los valores devueltos tienen el siguiente formato:
  • 100 (1x zoom = no zoom)
  • 200 (zoom 2x)
  • 300 (zoom 3x)
  • 350 (zoom de 3,5 aumentos)
  • ...
El primer valor es siempre 100 y el último valor corresponde al zoom máximo..
Ejemplo:
100<CR>200<CR>300<CR>350
Observación: La función devolverá una cadena vacía ("") si la cámara del dispositivo no admite el zoom.
iPhone/iPadMac Catalyst Esta constante no está disponible.

Modificar el valor de un parámetro para la cámara del dispositivo Ocultar los detalles

<Result> = CameraParameter(<Parameter> , <Value>)
<Result>: booleano
  • True si la modificación del parámetro se realizó con éxito,
  • False de lo contrario o si se produce un error al recuperar los parámetros de la cámara. Por ejemplo, la función CameraParameter devolverá False si el parámetro especificado (o su valor) no es compatible con la cámara.
Si se produce un error, la variable ErrorOccurred se pone en True. Para obtener más información sobre el error, utilice la función ErrorInfo.
<Parameter>: Constante de la cadena de caracteres o cadena de caracteres
Parámetro para el que se modificará el valor. Este parámetro puede corresponder a:
  • una de las constantes preestablecidas. Estas constantes corresponden a los parámetros más comunes.
  • una Cadena correspondiente al nombre del parámetro deseado.
    Atención: el nombre del parámetro distingue entre mayúsculas y minúsculas y acentos. Vea la documentación sobre el SDK de Android o sobre el dispositivo para saber el nombre de los parámetros adicionales soportados. Si el nombre especificado no corresponde a un parámetro soportado por la cámara, la función devolverá una cadena vacía.
Las constantes disponibles son las siguientes: Las constantes disponibles son las siguientes:
vipBalanceModo de balance de blancos para la cámara.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipCameraSubíndice de la cámara a utilizar.
Atención: el cambio de cámara reinicializa los parámetros previamente definidos con la función CameraParameter.
vipCompressionJPEGCompresión de imágenes JPEG.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipEffectEfecto de los colores.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipFlashModo de flash que utilizará la cámara.
vipFlickerAjuste del parpadeo (anti-banding) que utilizará la cámara.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipFocusModo de enfoque que utilizará la cámara.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipGeoPositionInformación de geolocalización que se utilizará.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipISOSensibilidades ISO soportadas por la cámara.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipPhotoResolutionDefinition de resolución para las fotos tomadas por la cámara.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipRotationAutoautomatic rotación de las fotos según la orientación del dispositivo durante la captura.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipSceneTipos de escenas que utilizará la cámara.
iPhone/iPadMac Catalyst Esta constante no está disponible.
vipZoomValor de zoom que utilizará la cámara.
iPhone/iPadMac Catalyst Esta constante no está disponible.
<Value>: El tipo correspondiente al parámetro a modificar
Nuevo valor para el parámetro.
Ver los comentarios para conocer el tabla de correspondencias entre el parámetro a modificar y el valor esperado.
Observaciones

Tabla de correspondencias entre el parámetro a modificar y los posibles valores de este parámetro

Parámetro a modificarValor esperado
vipBalanceModos de balance para los blancos soportados por la cámara.
Este parámetro puede corresponder a una de las siguientes constantes o a una cadena de caracteres Variable:
  • vipBalanceAuto: Modo automatic
  • vipBalanceTwilight: iluminación crepuscular
  • vipBalanceSunny: iluminación soleada
  • vipBalanceFluorescent: luz fluorescente
  • vipBalanceFluorescentWarm: iluminación fluorescente cálida
  • vipBalanceIncandescent: iluminación incandescente
  • vipBalanceCloudy: iluminación nublada
  • vipBalanceShadow: iluminación de sombras
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipCameraÍndice de la cámara a utilizar. Este parámetro puede corresponder a:
  • un número entero incluido entre 1 y el número de cámaras encontradas en el dispositivo
  • una de las siguientes constantes:
    • vipCameraBack: se utiliza la primera cámara trasera (opuesta a la pantalla).
    • vipCameraFront: se utiliza la primera cámara frontal (de frente a la pantalla).
vipCompressionJPEGCompresión de imágenes JPEG.
Entero comprendido entre 1 y 100:
  • 1: Máxima compresión (baja calidad)
  • 100: Sin compresión (muy alta calidad)
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipEffectEfectos Color.
Este parámetro puede corresponder a una de las siguientes constantes o a una cadena de caracteres Variable:
  • vipEffectAqua: Efecto acuático
  • vipEffectNone: ningún efecto
  • vipEffectNegative: efecto perjudicial
  • vipEffectBlackAndWhite: negro y efecto White
  • vipEffectPoster: Efecto póster
  • vipEffectSolarize: efecto de solarización
  • vipEffectSepia: efecto sepia
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipFlashModos de flash compatibles con la cámara.
Este parámetro puede corresponder a una de las siguientes constantes o a una cadena de caracteres Variable:
  • vipFlashAuto: Modo automatic (el flash se inicia cuando la iluminación no es suficiente).
    iPhone/iPadMac Catalyst Esta constante no está disponible.
  • vipFlashOff: El flash está apagado.
  • vipFlashOn: El flash se enciende cuando se toma la foto.
  • vipFlashTorch: modo antorcha: iluminación intermitente continua.
    iPhone/iPadMac Catalyst Esta constante no está disponible.
  • vipFlashRedEyes: modo anti ojos rojos.
    iPhone/iPadMac Catalyst Esta constante no está disponible.
vipFocusModos de enfoque compatibles con la cámara.
Este parámetro puede corresponder a una de las siguientes constantes o a una cadena de caracteres Variable:
  • vipFocusAuto: autofocus
  • vipFocusContinuous: continuo (para la grabación de vídeo)
  • vipFocusFixed: fijo
  • vipFocusInfinite: infinito
  • vipFocusMacro: macro (tema muy cercano)
  • vipFocusDepthOfField: profundidad de campo
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipGeoPositionInformación de geolocalización.
Este parámetro corresponde a una variable de tipo geoPosition.
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipISOSensibilidades ISO soportadas por la cámara.
Este parámetro puede corresponder a una de las siguientes constantes o a una cadena de caracteres Variable:
  • vipISOAuto: Ajuste de la sensibilidad de automatic
  • "100", "200", "400", "800", ...
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipPhotoResolutionResolución de las fotos tomadas por la cámara.
Este parámetro utiliza el siguiente formato:
<Ancho><TAB><Alto>
Ejemplo:
1024680
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipRotationAutoautomatic rotación de las fotos según la orientación del dispositivo durante la captura.
Boolean parameter:
  • True: la rotación de automatic está activada.
  • False: la rotación de automatic está desactivada.
Si se activa la rotación de la automatic, la foto se guardará teniendo en cuenta la orientación del dispositivo durante la captura.
La rotación de automatic está habilitada por Default; sin embargo, algunos dispositivos no soportan la toma de fotos en modo retrato. En este caso, le aconsejamos que desactive la rotación de automatic y que gestione la rotación de Image mediante la programación.
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipSceneTipos de escenas soportadas por la cámara.
Este parámetro puede corresponder a una de las siguientes constantes o a una cadena de caracteres Variable:
  • vipSceneAction: el sujeto se está moviendo
  • vipSceneAuto: Modo automatic
  • vipSceneCandle: luz de las velas
  • vipSceneBarCode: leer códigos de barras
  • vipSceneSunset : atardecer
  • vipSceneFireworks: Fuegos artificiales
  • vipSceneInterior: foto tomada en interiores
  • vipSceneSnow: nevada
  • vipSceneNight: foto de noche
  • vipSceneLandscape: tema lejano, paisaje
  • vipSceneBeach: encallar
  • vipScenePortrait: retrato
  • vipSceneNightPortrait: retrato de noche
  • vipSceneSport: el sujeto se mueve rápido, el deporte
  • vipSceneTheater: teatro/museo (sin flash)
  • vipSceneVibration: corrección de vibraciones
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipFlickerAjustes de parpadeo (anti-banding) soportados por la cámara.
Este parámetro puede corresponder a una de las siguientes constantes o a una cadena de caracteres Variable:
  • vipFlickerAuto: Ajuste de automatic
  • vipFlickerOff : sin ajuste del parpadeo
  • vipFlicker50Hz: 50 Hertz
  • vipFlicker60Hz : 60 Hertz
iPhone/iPadMac Catalyst Este parámetro no está disponible.
vipZoomValores de zoom soportados por la cámara.
Variable de tipo Integer.
Ejemplo:
  • 100: 1x zoom = no zoom
  • 200: Zoom 2x
  • 300: Zoom 3x
  • 350: Zoom de 3,5 aumentos
  • ...
iPhone/iPadMac Catalyst Este parámetro no está disponible.
Si el valor del parámetro no corresponde a una de las constantes de WLangage mencionadas por Above, tiene la posibilidad de especificar este valor directamente. Consulte la documentación sobre el SDK de Android o sobre el dispositivo para conocer los valores adicionales y/o utilice CameraListParameter para saber si este valor está soportado. Si la cámara no admite el valor especificado, la función CameraParameter devolverá False.

Permisos necesarios

La llamada a esta función modifica los permisos requeridos por la aplicación.
Requerido Permission: CÁMARA.
Esta Permission permite a las aplicaciones acceder a la cámara.
Componente: wd290android.aar
Versión mínima requerida
  • Versión 22
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/05/2022

Señalar un error o enviar una sugerencia | Ayuda local