Kamerasteuerungsparameter programmieren

In der vorherigen Version des Extended View System (EVS) 1.0 wurden Kamerageräte als schreibgeschützte Geräte betrachtet wurden, sodass es keine Methode gab, die in der App, um Parameter für die Kamerasteuerung wie Zoom oder Helligkeit zu ändern.

Da dies die Leistungsfähigkeit von EVS-Apps beeinträchtigen könnte, wurde das neue EVS 1.1 werden neue Methoden vorgestellt und die App kann mehrere Kameras programmieren. Steuerelementparameter, die alle in enum CameraParam definiert sind:

/**
 * 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,
};

Methoden sind definiert als:

/**
 * 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() gibt eine Liste von Parametern zurück. (CameraParam enum) ein Client lesen und schreiben kann (wenn der Client ein Master ist), und getIntParameterRange() gibt den gültigen Wertebereich und die Auflösung weiter. Wenn ein Master-Client einen Kameraparameter ändert, können alle anderen Clients derselben Kamera Hardware benachrichtigt werden, wenn ein PARAMETER_CHANGED-Ereignis mit einem mit der Parameter-ID und dem neuen Wert.

Hinweis : Der Sensortreiber verarbeitet möglicherweise ungültige Parameter. unterschiedlichen Werten. Möglicherweise wird einfach ein Fehlercode zurückgegeben oder der Wert im Feld gültigen Bereich und wenden an. Daher gibt die Methode setIntParameter() einen effektiven Wert und der Client kann anhand dieses Werts prüfen, wie die Anfrage behandelt werden.

Schlichtung zwischen mehreren Kamera-Clients anfordern

Weil das vorherige EVS-Design es mehreren Apps gleichzeitig ermöglichte eine einzige Kamera-Hardware hat, kann eine App diese die Abläufe anderer Apps stören, indem Sie einen Kameraparameter ändern. Außerdem mehrere Kunden denselben Parameter unterschiedlich anpassen möchten, zu unerwartetem Verhalten beim Ausführen von Kameradiensten führen.

Um solche Probleme zu vermeiden, lässt der EVS-Manager zu, dass nur Master-Clients Kameraparameter zu programmieren. Bevor der Client versucht, Kameraparameter anzupassen, durch Aufrufen des setMaster() MÜSSEN ein Master-Client werden. . Wenn dieser Vorgang fehlschlägt, bedeutet dies, dass bereits ein aktiver Master-Client vorhanden ist. für die Kamera-Hardware. Bis der aktuelle Masterclient stirbt oder explizit gibt über unsetMaster() eine Hauptrolle auf, aber kein anderer Client Kameraparameter ändern dürfen. Wenn ein Master-Client seine Berechtigung zurückgibt, Alle anderen Apps werden durch ein MASTER_RELEASED-Ereignis benachrichtigt.

Kunden mit hoher Priorität

Der EVS-Manager kümmert sich um den Kunden, dem das Display gehört, Priorität und ermöglicht es, eine Masterrolle von einem aktuellen Master zu stehlen. Weil EVS Display-Inhaberschaft auf Aktualität basiert, kann der neue Kunde sogar aktuellen Client mit dem Display.

Kunden mit hoher Priorität müssen IEvsCamera::forceMaster(sp<IEvsDisplay>& display) aufrufen eine Masterrolle zu erlangen. Der EVS-Manager prüft den Status eines bestimmten Bildschirms. Handle and, wenn (und only if) sein Status gültig ist und weder DisplayState::NOT_OPEN oder DisplayState::DEAD eine Master-Anzeige ersetzt. Der Client, der lediglich die Masterrolle verliert, von einem MASTER_RELEASED-Ereignis benachrichtigt wurden und MÜSSEN verarbeiten, wie Sie dies tun können.