카메라 제어 매개변수 프로그래밍

컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.

이전 EVS(Extended View System) 1.0 출시에서는 카메라 기기가 읽기 전용 기기로 간주되었습니다. 따라서 애플리케이션이 확대/축소 또는 밝기와 같은 카메라 제어 매개변수를 변경할 수 있도록 하는 메서드가 없었습니다.

이로 인해 EVS 애플리케이션의 기능이 제한될 수 있으므로 새로운 EVS 1.1에서는 새 메서드를 도입하고 애플리케이션이 여러 카메라 제어 매개변수를 프로그래밍할 수 있도록 합니다. 이 매개변수는 모두 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,
};

메서드는 다음과 같이 정의됩니다.

/**
 * 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. Once it becomes a master, it will be able to
 * 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()는 클라이언트가 읽고 쓸 수 있는(클라이언트가 마스터인 경우) 매개변수 목록(CameraParam enum)을 반환하고 getIntParameterRange()는 유효한 값 범위 및 해상도를 전달합니다. 마스터 클라이언트가 카메라 매개변수를 변경하면 동일한 카메라 하드웨어의 다른 모든 클라이언트는 매개변수 ID 및 새 값이 있는 PARAMETER_CHANGED 이벤트를 수신하여 알림을 받습니다.

참고: 센서 드라이버는 잘못된 매개변수 값을 서로 다르게 처리할 수 있습니다. 단순히 오류 코드를 반환하거나 유효한 범위의 값을 자르고 적용할 수 있습니다. 따라서 setIntParameter() 메서드는 유효 값을 반환하고 클라이언트는 이 값을 사용하여 요청이 처리된 방식을 확인할 수 있습니다.

여러 카메라 클라이언트 간 중재 요청

이전의 EVS 설계에서는 여러 애플리케이션이 하나의 카메라 하드웨어를 동시에 구독할 수 있었기 때문에 한 애플리케이션이 카메라 매개변수를 변경하여 다른 애플리케이션의 작업을 방해할 수 있었습니다. 또한 여러 클라이언트가 동일한 매개변수를 서로 다르게 조정하려고 할 수 있으며 이 때문에 카메라 서비스를 실행할 때 예상치 못한 동작이 발생할 수 있습니다.

이러한 문제를 방지하기 위해 EVS 관리자는 마스터 클라이언트만 카메라 매개변수를 프로그래밍할 수 있도록 허용합니다. 클라이언트는 카메라 매개변수를 조정하려고 시도하기 전에 setMaster() 메서드를 호출하여 마스터 클라이언트가 되어야 합니다. 마스터 클라이언트가 되지 못한다면 해당 카메라 하드웨어에 이미 활성 마스터 클라이언트가 있음을 의미합니다. 현재 마스터 클라이언트가 종료되거나 unsetMaster()를 통해 명시적으로 마스터 역할을 포기할 때까지 다른 클라이언트는 카메라 매개변수를 변경할 수 없습니다. 마스터 클라이언트가 권한을 반환하면 다른 모든 애플리케이션은 MASTER_RELEASED 이벤트를 통해 알림을 받습니다.

우선순위가 높은 클라이언트

EVS 관리자는 디스플레이를 소유한 클라이언트를 높은 우선순위로 처리하며, 이 클라이언트가 현재 마스터에서 마스터 역할을 훔칠 수 있도록 허용합니다. EVS 디스플레이 소유권은 최신성을 기반으로 하므로 새 클라이언트는 현재 클라이언트로부터 디스플레이를 인계받을 수도 있습니다.

우선순위가 높은 클라이언트가 마스터 역할을 획득하려면 IEvsCamera::forceMaster(sp<IEvsDisplay>& display)를 호출해야 합니다. EVS 관리자는 지정된 디스플레이 핸들의 상태를 검사하고, 이 상태가 유효하고 DisplayState::NOT_OPENDisplayState::DEAD가 아닌 경우에 한해 마스터를 교체합니다. 마스터 역할을 잃게 된 클라이언트는 MASTER_RELEASED 이벤트를 통해 알림을 받으며 반드시 이를 적절하게 처리해야 합니다.