En la versión anterior del Extended View System (EVS) 1.0, los dispositivos de cámara considerados de solo lectura y, por lo tanto, no existía ningún método que permitiera la app para cambiar los parámetros de control de la cámara, como el zoom o el brillo.
Como esto podría limitar la capacidad de las apps de EVS, el nuevo EVS 1.1
introduce métodos nuevos y permite que la app programe varias cámaras
parámetros de control, los cuales se definen en enum CameraParam:
/**
* EVS Camera Parameter
*/
enum CameraParam : uint32_t {
/**
* The brightness of image frames
*/
BRIGHTNESS,
/**
* The contrast of image frames
*/
CONTRAST,
/**
* Automatic gain/exposure control
*/
AUTOGAIN,
/**
* Gain control
*/
GAIN,
/**
* Automatic Whitebalance
*/
AUTO_WHITE_BALANCE,
/**
* Manual white balance setting as a color temperature in Kelvin.
*/
WHITE_BALANCE_TEMPERATURE,
/**
* Image sharpness adjustment
*/
SHARPNESS,
/**
* Auto Exposure Control modes; auto, manual, shutter priority, or
* aperture priority.
*/
AUTO_EXPOSURE,
/**
* Manual exposure time of the camera
*/
ABSOLUTE_EXPOSURE,
/**
* Set the focal point of the camera to the specified position. This
* parameter may not be effective when auto focus is enabled.
*/
ABSOLUTE_FOCUS,
/**
* Enables continuous automatic focus adjustments.
*/
AUTO_FOCUS,
/**
* Specify the objective lens focal length as an absolute value.
*/
ABSOLUTE_ZOOM,
};
Los métodos se definen de la siguiente manera:
/**
* Requests to be a master client.
*
* When multiple clients subscribe to a single camera hardware and one of
* them adjusts a camera parameter such as the contrast, it may disturb
* other clients' operations. Therefore, the client must call this method
* to be a master client. When it becomes a master, it can
* change camera parameters until either it dies or explicitly gives up the
* role.
*
* @return result EvsResult::OK if a master role is granted.
* EvsResult::OWNERSHIP_LOST if there is already a
* master client.
*/
setMaster() generates (EvsResult result);
/**
* Sets to be a master client forcibly.
*
* The client, which owns the display, has a high priority and can take over
* a master role from other clients without the display.
*
* @param display IEvsDisplay handle. If this is valid, the calling client
* is considered as the high priority client and therefore
* it would take over a master role.
*
* @return result EvsResult::OK if a master role is granted.
* EvsResult::OWNERSHIP_LOST if there is already a
* master client with the display.
*/
forceMaster(IEvsDisplay display) generates (EvsResult result);
/**
* Retires from a master client role.
*
* @return result EvsResult::OK if this call is successful.
* EvsResult::INVALID_ARG if the caller client is not a
* master client.
*/
unsetMaster() generates (EvsResult result);
/**
* Retrieves a list of parameters this camera supports.
*
* @return params A list of CameraParam that this camera supports.
*/
getParameterList() generates (vec<CameraParam> params);
/**
* Requests a valid value range of a camera parameter
*
* @param id The identifier of camera parameter, CameraParam enum.
*
* @return min The lower bound of the valid parameter value range.
* @return max The upper bound of the valid parameter value range.
* @return step The resolution of values in valid range.
*/
getIntParameterRange(CameraParam id)
generates (int32_t min, int32_t max, int32_t step);
/**
* Requests to set a camera parameter.
*
* @param id The identifier of camera parameter,
* CameraParam enum.
* value A desired parameter value.
* @return result EvsResult::OK if it succeeds to set a parameter.
* EvsResult::INVALID_ARG if either a requested
* parameter is not supported or a given value is out
* of bounds.
* effectiveValue A programmed parameter value. This may differ
* from what the client gives if, for example, the
* driver does not support a target parameter.
*/
setIntParameter(CameraParam id, int32_t value)
generates (EvsResult result, int32_t effectiveValue);
/**
* Retrieves a value of given camera parameter.
*
* @param id The identifier of camera parameter, CameraParam enum.
* @return result EvsResult::OK if it succeeds to read a parameter.
* EvsResult::INVALID_ARG if either a requested parameter is
* not supported.
* value A value of requested camera parameter.
*/
getIntParameter(CameraParam id) generates(EvsResult result, int32_t value);
getParameterList() muestra una lista de parámetros.
(enum CameraParam) puede leer y escribir un cliente (si es una instancia principal).
y getIntParameterRange() retransmite el rango de valores y la resolución válidos.
Cuando un cliente principal cambia un parámetro de cámara, todos los demás clientes de la misma cámara
de hardware reciben un evento PARAMETER_CHANGED con un
el ID del parámetro y el valor nuevo.
Nota: Es posible que el controlador del sensor controle un parámetro no válido.
los valores de manera diferente. Simplemente puede mostrar un código de error o recortar el valor en la
un rango válido y aplicar. Por lo tanto, el método setIntParameter() muestra
un valor efectivo y el cliente puede usarlo para confirmar cómo se aplicó
que se encarguen de su administración.
Cómo solicitar arbitraje entre varios clientes de cámaras
Porque el diseño anterior de EVS permitía que varias apps se suscriben a un hardware de cámara único, es posible que una app interrumpir el funcionamiento de otras apps cambiando un parámetro de la cámara Además, varios clientes pueden querer ajustar el mismo parámetro de manera diferente y, por lo tanto, causar comportamientos inesperados en el funcionamiento de servicios de cámara.
Para evitar estos problemas, el administrador de EVS permite que solo el cliente principal
para programar un parámetro de la cámara. Antes de intentar ajustar cualquier parámetro de la cámara, el cliente
DEBE convertirse en un cliente principal mediante una llamada a setMaster().
. Si esto falla, significa que ya existe un cliente principal activo.
en el hardware de esa cámara. Hasta que el cliente principal actual no falle o explícitamente
renuncia a una función maestra a través de unsetMaster(), ningún otro cliente puede
tener permitido cambiar un parámetro de la cámara. Cuando un cliente principal devuelve su privilegio,
todas las demás apps reciben notificaciones de un evento MASTER_RELEASED.
Clientes con prioridad alta
El administrador de EVS maneja al cliente propietario de la pantalla con la alta prioridad y le permite robar un rol de instancia maestra de una instancia maestra actual. Porque EVS la propiedad de anuncios gráficos se basa en las visitas recientes, el cliente nuevo incluso puede tomar el control cliente actual con la pantalla.
Los clientes de prioridad alta deben llamar a IEvsCamera::forceMaster(sp<IEvsDisplay>& display)
para lograr un rol de maestro. El administrador de EVS examina el estado de una pantalla determinada
y, si (y solo si) su estado es válido y
DisplayState::NOT_OPEN ni DisplayState::DEAD
reemplaza a un maestro. El cliente, que simplemente pierde el rol principal, es
notificadas por un evento MASTER_RELEASED y DEBE controlar
correctamente.