Changes between Version 44 and Version 45 of Video_Users_Guide

Timestamp:

Mar 21, 2012 5:07:56 AM (12 years ago)

Author:

ming

Comment:

--

Video_Users_Guide

@@ -26 +26 @@
       {{{
 $ ./configure --enable-shared --disable-static --enable-memalign-hack
-                                # add other options if needed, e.g: optimization, install dir, search path particularly CFLAGS and LDFLAGS for x264
+                                # add other options if needed, e.g: optimization, install dir, search path 
+                                # particularly CFLAGS and LDFLAGS for x264
                                 # to enable H264, add "--enable-gpl --enable-libx264"
 $ make && make install
@@ -32 +33 @@
  1. Optional for H.264: [http://www.videolan.org/developers/x264.html libx264]. We tested with the latest from git (as of October 2011):
      {{{
-$ ./configure --enable-static                   # add options if needed, e.g: optimization, install dir, search path
+$ ./configure --enable-static      # add options if needed, e.g: optimization, install dir, search path
 $ make && make install-lib-static  # default install dir is /usr/local
       }}}
@@ -297 +298 @@
 {{{
 const pj_str_t codec_id = {"H264", 4};
-pjmedia_vid_codec_param *param;
+pjmedia_vid_codec_param param;
 
 pjsua_vid_codec_get_param(&codec_id, &param);
@@ -311 +312 @@
     {{{
 /* Sending 1280 x 720 */
-pjmedia_vid_codec_param.enc_fmt.vid.size.w = 1280;
-pjmedia_vid_codec_param.enc_fmt.vid.size.h = 720;
+param.enc_fmt.vid.size.w = 1280;
+param.enc_fmt.vid.size.h = 720;
     }}}
     Note that there is a possibility that the value will be adjusted to follow remote capability. For example, if remote signals that maximum resolution supported is 640 x 480 and locally the encoding direction size is set to 1280 x 720, then 640 x 480 will be used.
@@ -321 +322 @@
          {{{
 /* 1st preference: 352 x 288 (CIF) */
-pjmedia_vid_codec_param.dec_fmtp.param[n].name = pj_str("CIF");
+param.dec_fmtp.param[n].name = pj_str("CIF");
 /* The value actually specifies framerate, see framerate section below */
-pjmedia_vid_codec_param.dec_fmtp.param[n].value = pj_str("1");
+param.dec_fmtp.param[n].value = pj_str("1");
 /* 2nd preference: 176 x 144 (QCIF) */
-pjmedia_vid_codec_param.dec_fmtp.param[n+1].name = pj_str("QCIF");
+param.dec_fmtp.param[n+1].name = pj_str("QCIF");
 /* The value actually specifies framerate, see framerate section below */
-pjmedia_vid_codec_param.dec_fmtp.param[n+1].value = pj_str("1");
+param.dec_fmtp.param[n+1].value = pj_str("1");
          }}}
        - H264, the size is implicitly specified in H264 level (check the standard specification or [http://en.wikipedia.org/wiki/H.264/MPEG-4_AVC#Levels this]) and on SDP, the H264 level is signalled via H264 SDP fmtp [http://tools.ietf.org/html/rfc6184#section-8.1 profile-level-id], e.g:
          {{{
 /* Can receive up to 1280×720 @30fps */
-pjmedia_vid_codec_param.dec_fmtp.param[n].name = pj_str("profile-level-id");
+param.dec_fmtp.param[n].name = pj_str("profile-level-id");
 /* Set the profile level to "1f", which means level 3.1 */
-pjmedia_vid_codec_param.dec_fmtp.param[n].value = pj_str("xxxx1f");
+param.dec_fmtp.param[n].value = pj_str("xxxx1f");
          }}}
 
@@ -344 +345 @@
     {{{
 /* Sending @30fps */
-pjmedia_vid_codec_param.enc_fmt.vid.fps.num   = 30;
-pjmedia_vid_codec_param.enc_fmt.vid.fps.denum = 1;
+param.enc_fmt.vid.fps.num   = 30;
+param.enc_fmt.vid.fps.denum = 1;
     }}}
     Note that there is a possibility that the value will be adjusted to follow remote capability. For example, if remote signals that maximum framerate supported is 10fps and locally the encoding direction framerate is set to 30fps, then 10fps will be used.
@@ -354 +355 @@
          {{{
 /* 3000/(1.001*2) fps for CIF */
-pjmedia_vid_codec_param.dec_fmtp.param[m].name = pj_str("CIF");
-pjmedia_vid_codec_param.dec_fmtp.param[m].value = pj_str("2");
+param.dec_fmtp.param[m].name = pj_str("CIF");
+param.dec_fmtp.param[m].value = pj_str("2");
 /* 3000/(1.001*1) fps for QCIF */
-pjmedia_vid_codec_param.dec_fmtp.param[n].name = pj_str("QCIF");
-pjmedia_vid_codec_param.dec_fmtp.param[n].value = pj_str("1");
+param.dec_fmtp.param[n].name = pj_str("QCIF");
+param.dec_fmtp.param[n].value = pj_str("1");
          }}}
        - H264, similar to size/resolution, the framerate is implicitly specified in H264 level (check the standard specification, or http://en.wikipedia.org/wiki/H.264/MPEG-4_AVC#Levels) and the H264 level is signalled via H264 SDP fmtp {{{profile-level-id}}}, e.g:
          {{{
 /* Can receive up to 1280×720 @30fps */
-pjmedia_vid_codec_param.dec_fmtp.param[n].name = pj_str("profile-level-id");
-pjmedia_vid_codec_param.dec_fmtp.param[n].value = pj_str("xxxx1f");
+param.dec_fmtp.param[n].name = pj_str("profile-level-id");
+param.dec_fmtp.param[n].value = pj_str("xxxx1f");
          }}}
 
@@ -374 +375 @@
 {{{
 /* Bitrate range preferred: 512-1024kbps */
-pjmedia_vid_codec_param.enc_fmt.vid.avg_bps = 512000;
-pjmedia_vid_codec_param.enc_fmt.vid.max_bps = 1024000;
+param.enc_fmt.vid.avg_bps = 512000;
+param.enc_fmt.vid.max_bps = 1024000;
 }}}
 
@@ -385 +386 @@
    {{{
 /* H263 specific maximum bitrate 512kbps */
-pjmedia_vid_codec_param.dec_fmtp.param[n].name = pj_str("MaxBR");
-pjmedia_vid_codec_param.dec_fmtp.param[n].value = pj_str("5120"); /* = max_bps / 100 */
+param.dec_fmtp.param[n].name = pj_str("MaxBR");
+param.dec_fmtp.param[n].value = pj_str("5120"); /* = max_bps / 100 */
    }}}