{{{
#!html
<!-- MAIN TABLE START -->
<table border=0 width="90%" align="center"><tr><td>
}}}

= PJSIP Video User's Guide =

'''Table of Contents'''
[[PageOutline(2-3,,inline)]]

Video is available on PJSIP version 2.0 and later. This document describes how to use the video feature with PJSIP.

[[BR]]


== Requirements ==

All platforms:
 1. [http://www.libsdl.org/ SDL] '''version 1.3'''. 
    - Note that this is the newer and not yet released SDL library, hence most likely it won't be installed by default on your system. You can download the source snapshot or from the Mercurial repository from http://www.libsdl.org/hg.php.
 1. [http://ffmpeg.org/ ffmpeg] development library.
 1. Optional: [http://qt.nokia.com/downloads/ Qt development SDK] for building the [#vidgui video GUI sample].
    - 

Linux:
 1. Video4Linux2 (v4l2) development library

Windows:
 1. ?

Mac OS X:
 -

Mobile platforms (iPhone, Symbian, Windows Mobile, etc):
 - Video is not supported on this release yet!


== Building with Video Support ==

=== GNU Build System ===

==== 1. Running aconfigure ====

Video requirements will be detected by the {{{configure}}} script. Pay attention to the following output (the sample below was taken on a Mac):

{{{
checking SDL availability..... 1.3
checking for avdevice_version in -lavdevice... yes
checking for av_register_all in -lavformat... yes
checking for avcodec_init in -lavcodec... yes
checking for sws_scale in -lswscale... yes
checking for av_malloc in -lavutil... yes
checking for avcore_version in -lavcore... yes
checking for v4l2_open in -lv4l2... no
}}}

Once again, we need SDL version 1.3 for the video to work.

==== 2. Configuring video support ====

Add this in your {{{config_site.h}}}:

{{{
#define PJMEDIA_HAS_VIDEO	1
}}}

==== 3. Build the library ====

As usual with:
{{{
make dep && make clean && make
}}}

Once the build is successful, you will have '''pjsua''' executable containing video support. Additionally, you may want to build the [#vidgui GUI sample application] too.

=== Visual Studio ===

Visual Studio users will need to configure things manually as explained below.

==== 1. Configure directories ====

Add include and library paths for the required components:
 1. SDL
 1. ffmpeg
 1. !DirectX (?)
 1. Base classes (?)

==== 2. Configure Video Settings ====

Add these to your {{{config_site.h}}}:

{{{
#define PJMEDIA_HAS_VIDEO	    1
#define PJMEDIA_HAS_FFMPEG	    1
#define PJMEDIA_VIDEO_DEV_HAS_SDL   1
}}}

==== 3. Rebuild the Solution ====

Once the build is successful, you will have '''pjsua''' executable containing video support. Additionally, you may want to build the [#vidgui GUI sample application] too.


=== GUI Sample Application === #vidgui

We have a GUI sample application with video support. The project is located under {{{pjsip-apps/src/vidgui}}}. It is not built by default, and you need [http://qt.nokia.com/downloads/ Qt SDK] to build it.

==== GNU Build System (Mac OS X, Linux, etc) ====

Follow these steps to build vidgui sample:

{{{
$ cd pjsip-apps/src/vidgui
$ make
}}}

==== Visual Studio ====

Follow these steps to build vidgui sample with Visual Studio:

 1. Open command prompt, and
 {{{
cd pjsip-apps\src\vidgui
 }}}
 1. Generate project files:
 {{{
qmake -tp vc
 }}}
 1. Open vidgui.vcproj project.
 1. Save the solution, and build the project




{{{
#!html
<!-- MAIN TABLE END -->
</td></tr></table>
}}}