Changeset 3622 for pjproject/branches/projects/2.0-dev/pjmedia/include/pjmedia/vid_codec.h

Timestamp:

Jul 12, 2011 9:08:56 AM (13 years ago)

Author:

bennylp

Message:

More on re #1284:

• Replaced bit_info mechanism to report format change in codec with event
• Updated vid_port, vid_codec_test, etc.
• Add event publisher to vid_codec
• Add event publisher to pjmedia_port
• Add event publisher to vid_stream

File:

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

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

@@ -28 +28 @@
 
 #include <pjmedia/codec.h>
+#include <pjmedia/event.h>
 #include <pjmedia/format.h>
 #include <pjmedia/types.h>
@@ -99 +100 @@
 
 /**
- * Enumeration of video codec events.
- */
-typedef enum pjmedia_vid_codec_event
-{
-    /**
-     * Format changed event. The decoder output format is not really
-     * configurable, so that the output format setting configured in the
-     * initialization may be changed. Application can catch this event
-     * by checking the bit_info field of the pjmedia_frame of the decoder
-     * output frame.
-     */
-    PJMEDIA_VID_CODEC_EVENT_FMT_CHANGED = 1,
-
-} pjmedia_vid_codec_event;
-
-
-/**
  * Forward declaration for video codec.
  */
@@ -269 +253 @@
      * format may different to the current setting, e.g: the format specified
      * in the #pjmedia_vid_codec_param when opening the codec, in this case the
-     * PJMEDIA_VID_CODEC_EVENT_FMT_CHANGED flag will be set in the bit_info
-     * field of the output frame and application can query the new format
+     * PJMEDIA_EVENT_FMT_CHANGED event will be emitted by the codec. The codec
+     * parameter will also be updated, and application can query the format by
      * using #get_param().
      *
@@ -310 +294 @@
 
 /**
- * This structure describes a video codec instance. 
+ * This structure describes a video codec instance. Codec implementers
+ * should use #pjmedia_vid_codec_init() to initialize this structure with
+ * default values.
  */
 struct pjmedia_vid_codec
@@ -325 +311 @@
     /** Operations to codec. */
     pjmedia_vid_codec_op        *op;
+
+    /** Event publisher object */
+    pjmedia_event_publisher      epub;
 };
 
@@ -438 +427 @@
 
 
+/**
+ * Initialize pjmedia_vid_codec structure with default values.
+ *
+ * @param codec     The codec to be initialized.
+ */
+PJ_DECL(void) pjmedia_vid_codec_init(pjmedia_vid_codec *codec);
 
 /**