Changes between Version 13 and Version 14 of Video_Users_Guide


Ignore:
Timestamp:
Sep 1, 2011 1:19:22 AM (8 years ago)
Author:
bennylp
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • Video_Users_Guide

    v13 v14  
    1414[[BR]] 
    1515 
    16  
    17 == Requirements == 
    18  
    19 All platforms: 
     16== Building with Video Support == 
     17 
     18=== Common Requirements for Desktop Platforms === #reqdesk 
     19 
     20The following components are needed for video: 
    2021 1. [http://www.libsdl.org/ SDL] '''version 1.3'''.  
    2122    - 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. 
    22  1. [http://ffmpeg.org/ ffmpeg] development library. 
    23  1. Optional: [http://qt.nokia.com/downloads/ Qt development SDK] for building the [#vidgui video GUI sample]. 
    24     - without this you can still enjoy video with pjsua sample application 
    25  
    26 Linux: 
    27  1. Video4Linux2 (v4l2) development library 
    28  
    29 Windows: 
    30  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: 
    31    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]. 
    32    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] 
    33  
    34 Mobile platforms (iPhone, Symbian, Windows Mobile, etc): 
    35  - Video is not supported on this release yet! 
    36  
    37  
    38 [[BR]] 
    39  
    40 == Building with Video Support == 
     23 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. 
     24 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. 
     25    - without this you can still enjoy video with pjsua console application 
     26 
    4127 
    4228=== Building with GNU Build System (for Mac OS X, Linux, etc.) === 
    4329 
    44 ==== 1. Running aconfigure ==== 
     30==== 1. Requirements ==== 
     31 
     32The following components are needed: 
     33 1. The components in [wiki:#reqdesk common requirements] above. 
     34 1. '''Linux specific:''' Video4Linux2 (v4l2) development library is required. 
     35 
     36 
     37==== 2. Running aconfigure ==== 
    4538 
    4639Video requirements will be detected by the {{{configure}}} script. Pay attention to the following output (the sample below was taken on a Mac): 
     
    5952Once again, we need SDL version 1.3 for the video to work. 
    6053 
    61 ==== 2. Configuring video support ==== 
     54==== 3. Configuring video support ==== 
    6255 
    6356Add this to your {{{config_site.h}}}: 
     
    6760}}} 
    6861 
    69 ==== 3. Build the library ==== 
     62==== 4. Build the library ==== 
    7063 
    7164As usual with: 
     
    8275Visual Studio users will need to configure things manually as explained below. 
    8376 
    84 ==== 1. Configure directories ==== 
     77==== 1. Requirements ==== 
     78 
     79Windows requirements: 
     80 1. The components in [wiki:#reqdesk common requirements] above. 
     81 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: 
     82   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]. 
     83   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] 
     84 
     85 
     86==== 2. Configure directories ==== 
    8587 
    8688 1 Add include and library paths for the required components: 
     
    9496 
    9597 
    96 ==== 2. Configure Video Settings ==== 
     98==== 3. Configure Video Settings ==== 
    9799 
    98100Add these to your {{{config_site.h}}}: 
     
    105107}}} 
    106108 
    107 ==== 3. Rebuild the Solution ==== 
     109==== 4. Rebuild the Solution ==== 
    108110 
    109111Once the build is successful, you will have '''pjsua''' executable containing video support. Additionally, you may want to build the [#vidgui GUI sample application] too.