Changeset 3781 for pjproject

Timestamp:

Oct 3, 2011 9:43:10 AM (13 years ago)

Author:

bennylp

Message:

Added PJMEDIA_VID_DEV_CAP_SWITCH capability to allow fast switching to another device while the video device stream is running. Currently not implemented on any devices.(This closes #1362)

Location:

pjproject/trunk/pjmedia

Files:

• include/pjmedia-videodev/videodev.h (modified) (2 diffs)
• src/pjmedia-videodev/videodev.c (modified) (2 diffs)

pjproject/trunk/pjmedia/include/pjmedia-videodev/videodev.h

@@ -97 +97 @@
 
 /**
+ * Parameter for switching device with PJMEDIA_VID_DEV_CAP_SWITCH capability.
+ */
+typedef struct pjmedia_vid_dev_switch_param
+{
+    /**
+     * Target device ID to switch to. Once the switching is successful, the
+     * video stream will use this device and the old device will be closed.
+     */
+    pjmedia_vid_dev_index target_id;
+
+} pjmedia_vid_dev_switch_param;
+
+
+/**
  * Device index constants.
  */
@@ -205 +219 @@
      */
     PJMEDIA_VID_DEV_CAP_ORIENTATION = 128,
+
+    /**
+     * Support for fast switching to another device. A video stream with this
+     * capability allows replacing of its underlying device with another
+     * device, saving the user from opening a new video stream and gets a much
+     * faster and smoother switching action.
+     *
+     * Note that even when this capability is supported by a device, it may
+     * not be able to switch to arbitrary device. Application must always
+     * check the return value of the operation to verify that switching has
+     * occurred.
+     *
+     * This capability is currently write-only (i.e. set-only).
+     *
+     * The value of this capability is pointer to pjmedia_vid_dev_switch_param
+     * structure.
+     */
+    PJMEDIA_VID_DEV_CAP_SWITCH = 256,
 
     /**

pjproject/trunk/pjmedia/src/pjmedia-videodev/videodev.c

@@ -46 +46 @@
     DEFINE_CAP("hide",          "Renderer hide"),
     DEFINE_CAP("preview",       "Input preview"),
-    DEFINE_CAP("orientation",   "Video orientation")
+    DEFINE_CAP("orientation",   "Video orientation"),
+    DEFINE_CAP("switch",        "Switch device")
 };
 
@@ -184 +185 @@
         FIELD_INFO(orient);
         break;
+    /* The PJMEDIA_VID_DEV_CAP_SWITCH does not have an entry in the
+     * param (it doesn't make sense to open a stream and tell it
+     * to switch immediately).
+     */
     default:
         return PJMEDIA_EVID_INVCAP;