|
|
|
|
- Tabla de correspondencias entre el parámetro a modificar y los posibles valores de este parámetro
- Permisos necesarios
CameraParameter( Función) Devuelve o modifica el valor de un parámetro para la cámara del dispositivo.
Advertencia
Observaciones: - Para conocer la lista de valores que admite la cámara para un determinado parámetro, utilice CameraListParameter.
- 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.
// 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: | | vipBalance | Modo de balance de blancos actualmente soportados por la cámara: automatic, luz del día, nublado, ...
| 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.
| vipCompressionJPEG | Compresió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)
| vipEffect | Efecto de los colores que se tienen en cuenta actualmente: negro y White, cartel, sepia, ...
| vipFlash | Estado actual del flash de la cámara: automatic, sin, ojos anti rojos, ... | vipFlicker | Ajuste del parpadeo (anti-banding) utilizado actualmente por la cámara: automatic, ninguno, 50Hz, 60Hz, ...
| vipFocus | Estado actual del enfoque de la cámara: automatic, macro, fijo, ...
| vipGeoPosition | Informació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.
| vipISO | Sensibilidad ISO actualmente utilizada por la cámara: automatic , 100, 200, 400, ...
| vipPhotoResolution | Resolución de las fotos tomadas por la cámara. El valor se devuelve en el siguiente formato:
| vipRotationAuto | automatic 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.
| vipScene | Tipos de escenas que utiliza actualmente la cámara: automatic, noche, deportes, ...
| vipZoom | Valor 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:
Observación: La función devolverá una cadena vacía ("") si la cámara del dispositivo no admite el zoom.
|
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: | | vipBalance | Modo de balance de blancos para la cámara.
| vipCamera | Subí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. | vipCompressionJPEG | Compresión de imágenes JPEG.
| vipEffect | Efecto de los colores.
| vipFlash | Modo de flash que utilizará la cámara. | vipFlicker | Ajuste del parpadeo (anti-banding) que utilizará la cámara.
| vipFocus | Modo de enfoque que utilizará la cámara.
| vipGeoPosition | Información de geolocalización que se utilizará.
| vipISO | Sensibilidades ISO soportadas por la cámara.
| vipPhotoResolution | Definition de resolución para las fotos tomadas por la cámara.
| vipRotationAuto | automatic rotación de las fotos según la orientación del dispositivo durante la captura.
| vipScene | Tipos de escenas que utilizará la cámara.
| vipZoom | Valor de zoom que utilizará la cámara.
|
<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 modificar | Valor esperado |
---|
vipBalance | Modos 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
| 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).
| vipCompressionJPEG | Compresió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)
| vipEffect | Efectos 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
| vipFlash | Modos 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).
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.
Esta constante no está disponible. - vipFlashRedEyes: modo anti ojos rojos.
Esta constante no está disponible.
| vipFocus | Modos 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
| vipGeoPosition | Información de geolocalización.Este parámetro corresponde a una variable de tipo geoPosition.
| vipISO | Sensibilidades 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", ...
| vipPhotoResolution | Resolución de las fotos tomadas por la cámara. Este parámetro utiliza el siguiente formato:
<Ancho><TAB><Alto>
| vipRotationAuto | automatic 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.
| vipScene | Tipos 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
| vipFlicker | Ajustes 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
| vipZoom | Valores 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
- ...
|
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
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|