Changes between Version 13 and Version 14 of Video_Users_Guide

Timestamp:

Sep 1, 2011 1:19:22 AM (13 years ago)

Author:

bennylp

Comment:

--

Video_Users_Guide

@@ -14 +14 @@
 [[BR]]
 
-
-== Requirements ==
-
-All platforms:
+== Building with Video Support ==
+
+=== Common Requirements for Desktop Platforms === #reqdesk
+
+The following components are needed for video:
  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].
-    - without this you can still enjoy video with pjsua sample application
-
-Linux:
- 1. Video4Linux2 (v4l2) development library
-
-Windows:
- 1. !DirectShow SDK, included in Windows SDK. The minimum component required within the SDK is ''Windows Development Headers and Libraris'' and ''Samples''. As there are several versions of SDK we found they have different issues:
-   a. If you don't need Windows 7 features, the recommended SDK is [http://www.microsoft.com/downloads/en/details.aspx?FamilyID=ff6467e6-5bba-4bf5-b562-9199be864d29 Windows SDK Update for Windows Vista]. This is because it doesn't have [wiki:FAQ#vs2008 IP Helper API header bug].
-   a. If you need Windows 7 features then use [http://www.microsoft.com/downloads/en/confirmation.aspx?FamilyID=6B6C21D2-2006-4AFA-9702-529FA782D63B Windows SDK for Windows 7 and .NET Framework 4] and follow the instructions on [wiki:FAQ#vs2008 fixing IP Helper API header bug]. Also if you are using Visual Studio 2005 then you will need to patch it using [http://support.microsoft.com/kb/949009/ MS Knowledge Base 949009]
-
-Mobile platforms (iPhone, Symbian, Windows Mobile, etc):
- - Video is not supported on this release yet!
-
-
-[[BR]]
-
-== Building with Video Support ==
+ 1. [http://ffmpeg.org/ ffmpeg] development library. We tested with ffmpeg version ranging from 0.5.1 (from circa 2009) to the latest git version as of August 2011.
+ 1. Optional: [http://qt.nokia.com/downloads/ Qt development SDK] for building the [#vidgui video GUI sample]. We tested with version 4.6 or later.
+    - without this you can still enjoy video with pjsua console application
+
 
 === Building with GNU Build System (for Mac OS X, Linux, etc.) ===
 
-==== 1. Running aconfigure ====
+==== 1. Requirements ====
+
+The following components are needed:
+ 1. The components in [wiki:#reqdesk common requirements] above.
+ 1. '''Linux specific:''' Video4Linux2 (v4l2) development library is required.
+
+
+==== 2. 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):
@@ -59 +52 @@
 Once again, we need SDL version 1.3 for the video to work.
 
-==== 2. Configuring video support ====
+==== 3. Configuring video support ====
 
 Add this to your {{{config_site.h}}}:
@@ -67 +60 @@
 }}}
 
-==== 3. Build the library ====
+==== 4. Build the library ====
 
 As usual with:
@@ -82 +75 @@
 Visual Studio users will need to configure things manually as explained below.
 
-==== 1. Configure directories ====
+==== 1. Requirements ====
+
+Windows requirements:
+ 1. The components in [wiki:#reqdesk common requirements] above.
+ 1. !DirectShow SDK, included in Windows SDK. The minimum component required within the SDK is ''Windows Development Headers and Libraris'' and ''Samples''. As there are several versions of SDK we found they have different issues:
+   a. If you don't need Windows 7 features, the recommended SDK is [http://www.microsoft.com/downloads/en/details.aspx?FamilyID=ff6467e6-5bba-4bf5-b562-9199be864d29 Windows SDK Update for Windows Vista]. This is because it doesn't have [wiki:FAQ#vs2008 IP Helper API header bug].
+   a. If you need Windows 7 features then use [http://www.microsoft.com/downloads/en/confirmation.aspx?FamilyID=6B6C21D2-2006-4AFA-9702-529FA782D63B Windows SDK for Windows 7 and .NET Framework 4] and follow the instructions on [wiki:FAQ#vs2008 fixing IP Helper API header bug]. Also if you are using Visual Studio 2005 then you will need to patch it using [http://support.microsoft.com/kb/949009/ MS Knowledge Base 949009]
+
+
+==== 2. Configure directories ====
 
  1 Add include and library paths for the required components:
@@ -94 +96 @@
 
 
-==== 2. Configure Video Settings ====
+==== 3. Configure Video Settings ====
 
 Add these to your {{{config_site.h}}}:
@@ -105 +107 @@
 }}}
 
-==== 3. Rebuild the Solution ====
+==== 4. 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.