Changeset 3901 for pjproject/trunk/pjmedia/include/pjmedia/vid_codec.h

Timestamp:

Dec 7, 2011 10:43:28 AM (13 years ago)

Author:

nanang

Message:

Re #1234: Initial version of keyframe request/response via SIP INFO.

File:

• pjproject/trunk/pjmedia/include/pjmedia/vid_codec.h (modified) (7 diffs)

pjproject/trunk/pjmedia/include/pjmedia/vid_codec.h

@@ -76 +76 @@
 
 } pjmedia_vid_packing;
+
+
+/**
+ * Enumeration of video frame info flag for the bit_info field in the
+ * pjmedia_frame.
+ */
+typedef enum pjmedia_vid_frm_bit_info
+{
+    /**
+     * The video frame is keyframe.
+     */
+    PJMEDIA_VID_FRM_KEYFRAME    = 1
+
+} pjmedia_vid_frm_bit_info;
+
+
+/**
+ * Encoding option.
+ */
+typedef struct pjmedia_vid_encode_opt
+{
+    /**
+     * Flag to force the encoder to generate keyframe for the specified input
+     * frame. When this flag is set, application can verify the result by
+     * examining PJMEDIA_VID_FRM_KEYFRAME flag in the bit_info field of the
+     * output frame.
+     */
+    pj_bool_t force_keyframe;
+
+} pjmedia_vid_encode_opt;
+
 
 /** 
@@ -179 +210 @@
      * See #pjmedia_vid_codec_modify().
      */
-    pj_status_t (*modify)(pjmedia_vid_codec *codec, 
+    pj_status_t (*modify)(pjmedia_vid_codec *codec,
                           const pjmedia_vid_codec_param *param);
 
@@ -192 +223 @@
      */
     pj_status_t (*encode_begin)(pjmedia_vid_codec *codec,
+                                const pjmedia_vid_encode_opt *opt,
                                 const pjmedia_frame *input,
                                 unsigned out_size,
@@ -364 +396 @@
 
 /**
- * Initialize pjmedia_vid_codec structure with default values.
- *
- * @param codec     The codec to be initialized.
- * @param sig       Codec's object signature (see signatures.h)
- */
-PJ_DECL(void) pjmedia_vid_codec_reset(pjmedia_vid_codec *codec,
-                                      pjmedia_obj_sig sig);
-
-/**
  * Initialize codec manager. If there is no the default video codec manager,
  * this function will automatically set the default video codec manager to
@@ -729 +752 @@
  *
  * @param codec         The codec instance.
+ * @param opt           Optional encoding options.
  * @param input         The input frame.
  * @param out_size      The length of buffer in the output frame. This
@@ -742 +766 @@
 PJ_INLINE(pj_status_t)
 pjmedia_vid_codec_encode_begin( pjmedia_vid_codec *codec,
+                                const pjmedia_vid_encode_opt *opt,
                                 const pjmedia_frame *input,
                                 unsigned out_size,
@@ -747 +772 @@
                                 pj_bool_t *has_more)
 {
-    return (*codec->op->encode_begin)(codec, input, out_size, output,
+    return (*codec->op->encode_begin)(codec, opt, input, out_size, output,
                                       has_more);
 }