Changeset 3620 for pjproject/branches/projects/2.0-dev/pjmedia/include/pjmedia/vid_tee.h

Timestamp:

Jul 12, 2011 7:14:32 AM (13 years ago)

Author:

ming

Message:

Closed #1261: Video tee

• Add API pjmedia_vid_tee_add_dst_port2() for adding destination port which may need format conversion

File:

• pjproject/branches/projects/2.0-dev/pjmedia/include/pjmedia/vid_tee.h (modified) (3 diffs)

pjproject/branches/projects/2.0-dev/pjmedia/include/pjmedia/vid_tee.h

@@ -42 +42 @@
  * to destination ports only. Also, the video source port MUST actively call
  * pjmedia_port_put_frame() to the video tee and the video destination ports
- * MUST NEVER call pjmedia_port_get_frame() to the video tee.
+ * MUST NEVER call pjmedia_port_get_frame() to the video tee. Please note that
+ * there is no specific order of which destination port will receive a frame
+ * from the video tee.
  *
  * The video tee is not thread-safe, so it is application responsibility
@@ -87 +89 @@
 
 /**
- * Add a destination media port to the video tee.
+ * Add a destination media port to the video tee. For this function, the
+ * destination port's media format must match the source format.
  *
  * @param vid_tee           The video tee.
@@ -99 +102 @@
                                                   unsigned option,
                                                   pjmedia_port *port);
+
+
+/**
+ * Add a destination media port to the video tee. This function will also
+ * create a converter if the destination port's media format does not match
+ * the source format.
+ *
+ * @param vid_tee           The video tee.
+ * @param option            Video tee option, see @pjmedia_vid_tee_flag.
+ * @param port              The destination media port.
+ *
+ * @return                  PJ_SUCCESS on success, or the appropriate error
+ *                          code.
+ */
+PJ_DECL(pj_status_t) pjmedia_vid_tee_add_dst_port2(pjmedia_port *vid_tee,
+                                                   unsigned option,
+                                                   pjmedia_port *port);