תכנות פרמטרים של שליטה במצלמה

בגרסה 1.0 הקודמת של המערכת לתצוגה מורחבת (EVS), מכשירי המצלמה נחשבים למכשירים לקריאה בלבד, ולכן לא קיימת שיטה שתאפשר להשתמש באפליקציה כדי לשנות פרמטרים של בקרת המצלמה כמו זום או בהירות.

המצב הזה עשוי להגביל את היכולת של אפליקציות לרכב חשמלי (EVS), גרסה 1.1 החדשה של הרכב החשמלי (EVS) מציג שיטות חדשות ומאפשר לאפליקציה לתכנת כמה מצלמות פרמטרים בקרה, המוגדרים כולם ב-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,
};

ה-methods מוגדרות כך:

/**
 * 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() מחזירה רשימת פרמטרים (CameraParam enum) לקוח יכול לקרוא ולכתוב (אם הלקוח הוא מאסטר), ו-getIntParameterRange() מעבירים את טווח הערכים והרזולוציה התקינים. כשלקוח ראשי משנה פרמטר של מצלמה, כל שאר הלקוחות באותה מצלמה קבלת הודעה מהציוד באמצעות קבלת אירוע PARAMETER_CHANGED עם מזהה פרמטר והערך החדש.

הערה: יכול להיות שמנהל התקן של החיישן יטפל בפרמטר לא חוקי באופן שונה. היא עשויה פשוט להחזיר קוד שגיאה או לחתוך את הערך טווח חוקי והחלה. לכן, השיטה setIntParameter() מחזירה ערך יעיל, והלקוח יכול להשתמש בערך הזה כדי לבדוק איך הבקשה לטיפול.

בקשת בוררות בין כמה תוכנות מצלמות

כי העיצוב הקודם של הרכב החשמלי (EVS) אפשר לאפליקציות מרובות בו-זמנית אם תירשמו לחומרה של מצלמה אחת, יכול להיות שאפליקציה אחת תוכל להפריע לפעולות של אפליקציות אחרות על ידי שינוי הפרמטר של המצלמה. כמו כן, ייתכן שלקוחות רבים ירצו לשנות את אותו פרמטר באופן שונה, לגרום להתנהגויות לא צפויות בשירותי המצלמה.

כדי למנוע בעיות כאלה, מנהל הרכבים החשמליים (EVS) מאפשר רק ללקוח ראשי כדי לתכנת פרמטר מצלמה. לפני שמנסים להתאים פרמטר כלשהו של המצלמה, הלקוח חייב להפוך ללקוח מאסטר באמצעות הפעלה של setMaster() . אם הפעולה נכשלה, המשמעות היא שכבר קיים לקוח ראשי פעיל בחומרה של המצלמה. עד שהלקוח הראשי הנוכחי ימות, או במפורש שנותן תפקיד ראשי דרך unsetMaster(), אף לקוח אחר לא מורשה לשנות פרמטר של מצלמה. כשלקוח ראשי מחזיר את ההרשאה שלו, כל שאר האפליקציות מקבלות התראה מאירוע MASTER_RELEASED.

לקוחות עם עדיפות גבוהה

מנהל מערכת הרכב החשמלי (EVS) מטפל בלקוח שהוא הבעלים של המסך עם ומאפשרת לו לגנוב תפקיד ראשי ממאסטר נוכחי. כי הרכב החשמלי (EVS) בעלות על תצוגה מבוססת על עדכניות, הלקוח החדש יכול אפילו להשתלט על הלקוח הנוכחי במסך.

לקוחות בעדיפות גבוהה חייבים להתקשר אל IEvsCamera::forceMaster(sp<IEvsDisplay>& display) כדי לקבל תפקיד ראשי. מנהל הרכב החשמלי (EVS) בוחן את המצב של מסך נתון וגם אם (ורק אם) המצב שלו תקין ואף אחד מהם לא תקף. DisplayState::NOT_OPEN או DisplayState::DEAD מחליפה מאסטר. הלקוח, שפשוט מאבד את התפקיד הראשי, נשלחה הודעה על ידי אירוע של MASTER_RELEASED והכינוי חייב הזה כמו שצריך.