mirrors/gstreamer
mirrors/gstreamer
1
1
Fork 0
mirror of https://gitlab.freedesktop.org/gstreamer/gstreamer.git synced 2025-02-23 14:36:24 +00:00
Code Issues 1 Projects Releases Wiki Activity

Ported Cerbero/Install/build section to markdown

Browse source
This commit is contained in:
Olivier Crête 2016-05-16 19:23:12 +03:00
parent 3e540917bd
commit 055fc95e04
22 changed files with 246 additions and 565 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

186
Building+from+source+using+Cerbero.markdown
View file

@ -1,17 +1,9 @@
# GStreamer SDK documentation : Building from source using Cerbero # Building from source using Cerbero
This page last changed on Jul 15, 2013 by ylatuya. > ![Warning](images/icons/emoticons/warning.png)
> This section is intended for advanced users.</p></td>
<table> ## Build requirements
<tbody>
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><p>This section is intended for advanced users.</p></td>
</tr>
</tbody>
</table>
#### Build requirements
The GStreamer SDK build system provides bootstrapping facilities for all The GStreamer SDK build system provides bootstrapping facilities for all
platforms, but it still needs a minimum base to bootstrap: platforms, but it still needs a minimum base to bootstrap:
@ -20,61 +12,46 @@ platforms, but it still needs a minimum base to bootstrap:
included in python2.7. included in python2.7.
- git - git
<table> > ![Information](images/icons/emoticons/information.png)
<tbody> > **Windows users**
<tr class="odd"> >
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td> > Cerbero can be used on Windows using the Msys/MinGW shell (a Unix-like shell for Windows). There is a bit of setup that you need to do before Cerbero can take control.
<td><strong>Windows users</strong><br /> >
> You need to install the following programs:
> - [Python 2.7](http://www.python.org/getit/releases/2.7/)
> - [Git](http://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git) (Select the install option &quot;Checkout as-is, Commit as-is&quot; and install it in a path without spaces, eg: c:\Git)
> - [Msys/MinGW](https://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/) (Install it with all the options enabled)
> - [CMake](http://www.cmake.org/cmake/resources/software.htm) (Select the option &quot;Add CMake in system path for the current user&quot;)
> - [Yasm](http://yasm.tortall.net/Download.html) (Download the win32 or win64 version for your platform, name it <code>yasm.exe</code>, and place it in your MinGW <code>bin</code> directory, typically, <code>C:\MinGW\bin</code>)
> - [WiX 3.5](http://wix.codeplex.com/releases/view/60102)
> - [Microsoft SDK 7.1](http://www.microsoft.com/en-us/download/details.aspx?id=8279) (Install the SDK samples and the Visual C++ Compilers, required to build the DirectShow base classes. Might need installing the .NET 4 Framework first if the SDK installer doesn't find it)
> - [Windows Driver Kit 7.1.0](http://msdn.microsoft.com/en-us/windows/hardware/hh852365)
>
> Your user ID can't have spaces (eg: John Smith). Paths with spaces are not correctly handled in the build system and msys uses the user ID for the home folder.
>
>Cerbero must be run in the MinGW shell, which is accessible from the main menu once MinGW is installed.
>
>The last step is making `python` and `git` available from the shell, for which you will need to create a `.profile` file. Issue this command from within the MinGW shell:
>
> `echo "export PATH=\"\$PATH:/c/Python27:/c/Git/bin\"" >> ~/.profile`
>
> Using the appropriate paths to where you installed `python` and `git`
>
> (Note that inside the shell, / is mapped to c:\Mingw\msys\1.0\ )
<p>Cerbero can be used on Windows using the Msys/MinGW shell (a Unix-like shell for Windows). There is a bit of setup that you need to do before Cerbero can take control.</p>
<p>You need to install the following programs:</p>
<ul>
<li><a href="http://www.python.org/getit/releases/2.7/" class="external-link">Python 2.7</a></li>
<li><a href="http://code.google.com/p/msysgit/downloads/list?q=full+installer+official+git" class="external-link">Git</a> (Select the install option &quot;Checkout as-is, Commit as-is&quot; and install it in a path without spaces, eg: c:\Git)</li>
<li><a href="https://sourceforge.net/projects/mingw/files/Installer/mingw-get-inst/" class="external-link">Msys/MinGW</a> (Install it with all the options enabled)</li>
<li><a href="http://www.cmake.org/cmake/resources/software.html" class="external-link">CMake</a> (Select the option &quot;Add CMake in system path for the current user&quot;)</li>
<li><p><a href="http://yasm.tortall.net/Download.html" class="external-link">Yasm</a> (Download the win32 or win64 version for your platform, name it <code>yasm.exe</code>, and place it in your MinGW <code>bin</code> directory, typically, <code>C:\MinGW\bin</code>)</p></li>
<li><a href="http://wix.codeplex.com/releases/view/60102" class="external-link">WiX 3.5</a> </li>
<li><a href="http://www.microsoft.com/en-us/download/details.aspx?id=8279" class="external-link">Microsoft SDK 7.1</a> (Install the SDK samples and the Visual C++ Compilers, required to build the DirectShow base classes. Might need installing the .NET 4 Framework first if the SDK installer doesn't find it)</li>
<li><a href="http://msdn.microsoft.com/en-us/windows/hardware/hh852365" class="external-link">Windows Driver Kit 7.1.0</a></li>
</ul>
<p>Your user ID can't have spaces (eg: John Smith). Paths with spaces are not correctly handled in the build system and msys uses the user ID for the home folder.</p>
<p>Cerbero must be run in the MinGW shell, which is accessible from the main menu once MinGW is installed.</p>
<p>The last step is making <code>python</code> and <code>git</code> available from the shell, for which you will need to create a <code>.profile</code> file. Issue this command from within the MinGW shell:</p>
<div class="code panel" style="border-width: 1px;">
<div class="codeContent panelContent">
<pre class="theme: Default; brush: plain; gutter: false" style="font-size:12px;"><code>echo &quot;export PATH=\&quot;\$PATH:/c/Python27:/c/Git/bin\&quot;&quot; &gt;&gt; ~/.profile</code></pre>
</div>
</div>
<p>Using the appropriate paths to where you installed <code>python</code> and <code>git</code>.</p>
<p>(Note that inside the shell, / is mapped to c:\Mingw\msys\1.0\ )</p></td>
</tr>
</tbody>
</table>
<table> > ![Information](images/icons/emoticons/information.png)
<tbody> > **OS X users**
<tr class="odd"> >
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td> >To use cerbero on OS X you need to install the "Command Line Tools" from XCode. They are available from the "Preferences" dialog under "Downloads".
<td><strong>OS X users</strong><br />
<p>To use cerbero on OS X you need to install the &quot;Command Line Tools&quot; from XCode. They are available from the &quot;Preferences&quot; dialog under &quot;Downloads&quot;.</p></td>
</tr>
</tbody>
</table>
<table> > ![Information](images/icons/emoticons/information.png)
<tbody> > **iOS developers**
<tr class="odd"> >
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td> >If you want to build the GStreamer-SDK for iOS, you also need the iOS SDK. The minimum required iOS SDK version is 6.0 and is included in [XCode](https://developer.apple.com/devcenter/ios/index.action#downloads) since version 4.
<td><strong>iOS developers</strong><br />
<p>If you want to build the GStreamer-SDK for iOS, you also need the iOS SDK. The minimum required iOS SDK version is 6.0 and is included in <a href="https://developer.apple.com/devcenter/ios/index.action#downloads" class="external-link">Xcode</a> since version 4.</p></td> ## Download the sources
</tr>
</tbody>
</table>
Download the sources
To build the GStreamer SDK, you first need to download **Cerbero**. To build the GStreamer SDK, you first need to download **Cerbero**.
Cerbero is a multi-platform build system for Open Source projects that Cerbero is a multi-platform build system for Open Source projects that
@ -83,8 +60,8 @@ architectures and distributions.
Get a copy of Cerbero by cloning the git repository: Get a copy of Cerbero by cloning the git repository:
``` theme: Default; brush: plain; gutter: false ```
git clone git://anongit.freedesktop.org/gstreamer-sdk/cerbero git clone git://anongit.freedesktop.org/gstreamer/cerbero
``` ```
Cerbero can be run uninstalled and for convenience you can create an Cerbero can be run uninstalled and for convenience you can create an
@ -92,11 +69,11 @@ alias in your `.bashrc` file*. *If you prefer to skip this step,
remember that you need to replace the calls to `cerbero` with remember that you need to replace the calls to `cerbero` with
`./cerbero-uninstalled` in the next steps. `./cerbero-uninstalled` in the next steps.
``` theme: Default; brush: plain; gutter: false ```
echo "alias cerbero='~/git/cerbero/cerbero-uninstalled'" >> ~/.bashrc echo "alias cerbero='~/git/cerbero/cerbero-uninstalled'" >> ~/.bashrc
``` ```
#### Setup environment ## Setup environment
After Cerbero and the base requirements are in place, you need to setup After Cerbero and the base requirements are in place, you need to setup
the build environment. the build environment.
@ -116,8 +93,8 @@ An example configuration file with detailed comments can be found
To fire up the bootstrapping process, go to the directory where you To fire up the bootstrapping process, go to the directory where you
cloned/unpacked Cerbero and type: cloned/unpacked Cerbero and type:
``` theme: Default; brush: plain; gutter: false ```
cerbero bootstrap  cerbero bootstrap
``` ```
Enter the superuser/root password when prompted. Enter the superuser/root password when prompted.
@ -125,12 +102,12 @@ Enter the superuser/root password when prompted.
The bootstrap process will then install all packages required to build The bootstrap process will then install all packages required to build
the GStreamer SDK. the GStreamer SDK.
#### Build the SDK ## Build the SDK
To generate the SDK, use the following command: To generate the SDK, use the following command:
``` theme: Default; brush: plain; gutter: false ```
cerbero package gstreamer-sdk cerbero package gstreamer-1.0
``` ```
This should build all required SDK components and create packages for This should build all required SDK components and create packages for
@ -138,7 +115,7 @@ your distribution at the Cerbero source directory.
A list of supported packages to build can be retrieved using: A list of supported packages to build can be retrieved using:
``` theme: Default; brush: plain; gutter: false ```
cerbero list-packages cerbero list-packages
``` ```
@ -146,26 +123,26 @@ Packages are composed of 0 (in case of a meta package) or more
components that can be built separately if desired. The components are components that can be built separately if desired. The components are
defined as individual recipes and can be listed with: defined as individual recipes and can be listed with:
``` theme: Default; brush: plain; gutter: false ```
cerbero list cerbero list
``` ```
To build an individual recipe and its dependencies, do the following: To build an individual recipe and its dependencies, do the following:
``` theme: Default; brush: plain; gutter: false ```
cerbero build <recipe_name> cerbero build <recipe_name>
``` ```
Or to build or force a rebuild of a recipe without building its Or to build or force a rebuild of a recipe without building its
dependencies use: dependencies use:
``` theme: Default; brush: plain; gutter: false ```
cerbero buildone <recipe_name> cerbero buildone <recipe_name>
``` ```
To wipe everything and start from scratch: To wipe everything and start from scratch:
``` theme: Default; brush: plain; gutter: false ```
cerbero wipe cerbero wipe
``` ```
@ -173,39 +150,39 @@ Once built, the output of the recipes will be installed at the prefix
defined in the Cerbero configuration file `$HOME/.cerbero/cerbero.cbc` defined in the Cerbero configuration file `$HOME/.cerbero/cerbero.cbc`
or at `$HOME/cerbero/dist` if no prefix is defined. or at `$HOME/cerbero/dist` if no prefix is defined.
#### Build a single project with the SDK ### Build a single project with the SDK
Rebuilding the whole SDK is relatively fast on Linux and OS X, but it Rebuilding the whole SDK is relatively fast on Linux and OS X, but it
can be very slow on Windows, so if you only need to rebuild a single can be very slow on Windows, so if you only need to rebuild a single
project (eg: gst-plugins-good to patch qtdemux) there is a much faster project (eg: gst-plugins-good to patch qtdemux) there is a much faster
way of doing it. You will need  to follow the steps detailed in this way of doing it. You will need to follow the steps detailed in this
page, but skipping the step "**Build the SDK**", and installing the page, but skipping the step "**Build the SDK**", and installing the
SDK's development files as explained in [Installing the SDK's development files as explained in [Installing the
SDK](Installing%2Bthe%2BSDK.html). SDK](Installing+the+SDK.markdown).
By default, Cerbero uses as prefix a folder in the user directory with By default, Cerbero uses as prefix a folder in the user directory with
the following schema ~/cerbero/dist/$platform\_$arch, but for the SDK we the following schema ~/cerbero/dist/$platform\_$arch, but for the SDK we
must change this prefix to use its installation directory. This can be must change this prefix to use its installation directory. This can be
done with a custom configuration file named *custom.cbc*: done with a custom configuration file named *custom.cbc*:
``` theme: Default; brush: plain; gutter: false ```
# For Windows x86 # For Windows x86
prefix='/c/gstreamer-sdk/0.10/x86/' prefix='/c/gstreamer/1.0/x86/'
 
# For Windows x86_64 # For Windows x86_64
#prefix='/c/gstreamer-sdk/0.10/x86_64' #prefix='/c/gstreamer/1.0/x86_64'
 
# For Linux # For Linux
#prefix='/opt/gstreamer-sdk' #prefix='/opt/gstreamer'
 
# For OS X # For OS X
#prefix='/Library/Frameworks/GStreamer.framework/Versions/0.10' #prefix='/Library/Frameworks/GStreamer.framework/Versions/1.0'
``` ```
The prefix path might not be writable by your current user. Make sure The prefix path might not be writable by your current user. Make sure
you fix it before, for instance with: you fix it before, for instance with:
``` theme: Default; brush: plain; gutter: false ```
$ sudo chown -R <username> /Library/Frameworks/GStreamer.framework/ $ sudo chown -R <username> /Library/Frameworks/GStreamer.framework/
``` ```
@ -214,41 +191,39 @@ environment set up to target the SDK. You can start a new shell using
the installation prefix defined in *custom.cbc *with the following the installation prefix defined in *custom.cbc *with the following
command: command:
``` theme: Default; brush: plain; gutter: false ```
$ cerbero -c custom.cbc shell $ cerbero -c custom.cbc shell
``` ```
Once you are in Cerbero's shell you can compile new Once you are in Cerbero's shell you can compile new
projects targeting the SDK using the regular build projects targeting the SDK using the regular build
process: process:
``` theme: Default; brush: plain; gutter: false ```
$ git clone -b sdk-0.10.31 git://anongit.freedesktop.org/gstreamer-sdk/gst-plugins-good; cd gst-plugins-good $ git clone -b sdk-0.10.31 git://anongit.freedesktop.org/gstreamer-sdk/gst-plugins-good; cd gst-plugins-good
$ sh autogen.sh --disable-gtk-doc --prefix=<prefix> $ sh autogen.sh --disable-gtk-doc --prefix=<prefix>
$ make -C gst/isomp4 $ make -C gst/isomp4
``` ```
  ### Cross-compilation of the SDK
#### Cross-compilation of the SDK
Cerbero can be used to cross-compile the SDK to other platforms like Cerbero can be used to cross-compile the SDK to other platforms like
Android or Windows. You only need to use a configuration file that sets Android or Windows. You only need to use a configuration file that sets
the target platform, but we also provide a set of of pre-defined the target platform, but we also provide a set of of pre-defined
configuration files for the supported platforms (you will find them in configuration files for the supported platforms (you will find them in
the `config` folder with the `.cbc` extension the `config` folder with the `.cbc` extension
##### Android #### Android
You can cross-compile the SDK for Android from a Linux host using the You can cross-compile the SDK for Android from a Linux host using the
configuration file `config/cross-android.cbc`. Replace all the previous configuration file `config/cross-android.cbc`. Replace all the previous
commands with: commands with:
``` theme: Default; brush: plain; gutter: false ```
cerbero -c config/cross-android.cbc <command> cerbero -c config/cross-android.cbc <command>
``` ```
##### Windows #### Windows
The SDK can also be cross-compiled to Windows from Linux, but you should The SDK can also be cross-compiled to Windows from Linux, but you should
only use it for testing purpose. The DirectShow plugins cannot be only use it for testing purpose. The DirectShow plugins cannot be
@ -257,24 +232,21 @@ only be created from Windows.
Replace all the above commands for Windows 32bits with: Replace all the above commands for Windows 32bits with:
``` theme: Default; brush: plain; gutter: false ```
cerbero -c config/cross-win32.cbc <command> cerbero -c config/cross-win32.cbc <command>
``` ```
Or with using the following for Windows 64bits: Or with using the following for Windows 64bits:
``` theme: Default; brush: plain; gutter: false ```
cerbero -c config/cross-win64.cbc <command> cerbero -c config/cross-win64.cbc <command>
``` ```
##### iOS #### iOS
To cross compile for iOS from OS X, use the configuration file To cross compile for iOS from OS X, use the configuration file
`config/cross-ios-universal.cbc`. Replace all previous commands with: `config/cross-ios-universal.cbc`. Replace all previous commands with:
``` theme: Default; brush: cpp; gutter: false ```
cerbero -c config/cross-ios-universal.cbc <command> cerbero -c config/cross-ios-universal.cbc <command>
``` ```
Document generated by Confluence on Oct 08, 2015 10:27

3
Home.markdown
View file

@ -59,8 +59,7 @@ Commercial support, bug reporting...</td>
## Attachments: ## Attachments:
![](images/icons/bullet_blue.gif) [download.png](attachments/2424858.png)
[download.png](attachments/327688/2424858.png) (image/png)
![](images/icons/bullet_blue.gif) ![](images/icons/bullet_blue.gif)
[tutorials.png](attachments/327688/2424859.png) (image/png) [tutorials.png](attachments/327688/2424859.png) (image/png)
![](images/icons/bullet_blue.gif) ![](images/icons/bullet_blue.gif)

160
Installing+for+Android+development.markdown
View file

@ -1,8 +1,6 @@
# GStreamer SDK documentation : Installing for Android development # Installing for Android development
This page last changed on May 24, 2013 by xartigas. ## Prerequisites
# Prerequisites
The development machine is where you will develop your Android The development machine is where you will develop your Android
application, which then you will deploy on the target machine, which application, which then you will deploy on the target machine, which
@ -20,17 +18,10 @@ needs to have installed:
you have at least one Android SDK platform installed with API you have at least one Android SDK platform installed with API
version 9 or higher. version 9 or higher.
Optionally, you can use the [Eclipse Optionally, you can use the [Android Studio] (FIX LINK). As stated in the Android
IDE](http://www.eclipse.org/eclipse/). As stated in the Android documentation, *developing in Android Studio is highly recommended and
documentation, *developing in Eclipse with ADT is highly recommended and is the fastest way to get started*.
is the fastest way to get started*. If you plan to use the Eclipse IDE:
- Install the [Android ADT
plugin](http://developer.android.com/sdk/installing/installing-adt.html) for
Eclipse
- Install the [Android NDK
plugin](http://tools.android.com/recent/usingthendkplugin) for
Eclipse
Before continuing, make sure you can compile and run the samples Before continuing, make sure you can compile and run the samples
included in the Android NDK, and that you understand how the integration included in the Android NDK, and that you understand how the integration
@ -41,9 +32,9 @@ NDK](http://developer.android.com/tools/sdk/ndk/index.html)
documentation, you can find some useful [Android JNI tips documentation, you can find some useful [Android JNI tips
here](http://developer.android.com/guide/practices/jni.html). here](http://developer.android.com/guide/practices/jni.html).
# Download and install the SDK ## Download and install the SDK
The SDK has two variants: **Debug** and **Release**. The Debug variant The SDK has two variants: **Debug** and **Release**. The Debug variant
produces lots of debug output and is useful while developing your produces lots of debug output and is useful while developing your
application. The Release variant is what you will use to produce the application. The Release variant is what you will use to produce the
final version of your application, since GStreamer code runs slightly final version of your application, since GStreamer code runs slightly
@ -53,46 +44,15 @@ Get the compressed file below and just unzip it into any folder of your
choice (Choose your preferred file format; both files have exactly the choice (Choose your preferred file format; both files have exactly the
same content) same content)
<table> ### Debug variant
<colgroup>
<col width="100%" />
</colgroup>
<thead>
<tr class="header">
<th>Debug variant</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><ul>
<li><a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.tar.bz2" class="external-link">GStreamer SDK 2013.6 (Congo) for Android ARM (Debug, tar.bz2)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/android/arm/gstreamer-sdk-android-arm-debug-2013.6.tar.bz2" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.tar.bz2.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.tar.bz2.sha1" class="external-link">sha1</a></li>
<li><a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.zip" class="external-link">GStreamer SDK 2013.6 (Congo) for Android ARM (Debug, zip)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/android/arm/gstreamer-sdk-android-arm-debug-2013.6.zip" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.zip.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.zip.sha1" class="external-link">sha1</a></li>
</ul></td>
</tr>
<tr class="even">
<td><span style="color: rgb(0,0,0);">Release variant</span></td>
</tr>
<tr class="odd">
<td><ul>
<li><a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-release-2013.6.tar.bz2" class="external-link">GStreamer SDK 2013.6 (Congo) for Android ARM (Release, tar.bz2)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/android/arm/gstreamer-sdk-android-arm-release-2013.6.tar.bz2" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-release-2013.6.tar.bz2.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-release-2013.6.tar.bz2.sha1" class="external-link">sha1</a></li>
<li><a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.zip" class="external-link">GStreamer SDK 2013.6 (Congo) for Android ARM (Release, zip)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/android/arm/gstreamer-sdk-android-arm-debug-2013.6.zip" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.zip.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/android/arm/gstreamer-sdk-android-arm-debug-2013.6.zip.sha1" class="external-link">sha1</a></li>
</ul></td>
</tr>
</tbody>
</table>
<table> FIXME: Link to download files
<tbody>
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><p>Due to the size of these files, usage of a <a href="http://en.wikipedia.org/wiki/Download_manager" class="external-link">Download Manager</a> is <strong>highly recommended</strong>. Take a look at <a href="http://en.wikipedia.org/wiki/Comparison_of_download_managers" class="external-link">this list</a> if you do not have one installed. If, after downloading, the installer reports itself as corrupt, chances are that the connection ended before the file was complete. A Download Manager will typically re-start the process and fetch the missing parts.</p></td>
</tr>
</tbody>
</table>
If you intend to build the tutorials in this same folder, make sure you If you intend to build the tutorials in this same folder, make sure you
have writing permissions. have writing permissions.
FIXME: Is this all TRUE ?
In the process of building GStreamer-enabled Android applications, some In the process of building GStreamer-enabled Android applications, some
tools will need to know where you installed the SDK. You must define an tools will need to know where you installed the SDK. You must define an
environment variable called `GSTREAMER_SDK_ROOT_ANDROID` and point it to environment variable called `GSTREAMER_SDK_ROOT_ANDROID` and point it to
@ -105,16 +65,9 @@ Windows).
- Point `GSTREAMER_SDK_ROOT_ANDROID` to the folder where you unzipped - Point `GSTREAMER_SDK_ROOT_ANDROID` to the folder where you unzipped
the SDK. the SDK.
<table> > ![](images/icons/emoticons/information.png) If you plan to use Eclipse and do not want to define this environment variable globally, you can set it inside Eclipse. Go to Window → Preferences → C/C++ → Build → Build Variables and define `GSTREAMER_SDK_ROOT_ANDROID` there.
<tbody>
<tr class="odd">
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td>
<td><p>If you plan to use Eclipse and do not want to define this environment variable globally, you can set it inside Eclipse. Go to Window → Preferences → C/C++ → Build → Build Variables and define <code>GSTREAMER_SDK_ROOT_ANDROID</code> there.</p></td>
</tr>
</tbody>
</table>
# Configure your development environment ## Configure your development environment
There are two routes to use GStreamer in an Android application: Either There are two routes to use GStreamer in an Android application: Either
writing your GStreamer code in Java or in C. writing your GStreamer code in Java or in C.
@ -143,7 +96,7 @@ Android NDK projects, so the instructions at the [Android
NDK](http://developer.android.com/tools/sdk/ndk/index.html) home can be NDK](http://developer.android.com/tools/sdk/ndk/index.html) home can be
followed: followed:
![](images/icons/grey_arrow_down.gif)Using Eclipse (Click to expand) #### Using Eclipse
Make sure you have installed the ADT and NDK plugins listed in the Make sure you have installed the ADT and NDK plugins listed in the
prerequisites section, and that they are both aware of the location of prerequisites section, and that they are both aware of the location of
@ -154,13 +107,12 @@ File → New → Project… → Android Project from Existing
Code, and select the folder called `android-tutorial-1`. Code, and select the folder called `android-tutorial-1`.
After reading in the project and generating some extra files and After reading in the project and generating some extra files and
folders, Eclipse might complain about missing files. **This is normal**, folders, Eclipse might complain about missing files. **This is normal**,
we are not finished yet. we are not finished yet.
Provide native development support by activating the NDK plugin: Provide native development support by activating the NDK plugin:
Right-click on the project in the Project Explorer (this should be the Right-click on the project in the Project Explorer (this should be the
top-most folder, top-most folder, called `com.gst_sdk_tutorials.tutorial_1.Tutorial1`) → Android
called `com.gst_sdk_tutorials.tutorial_1.Tutorial1`) → Android
tools → Add Native Support… Here the NDK plugin asks for a library name. tools → Add Native Support… Here the NDK plugin asks for a library name.
This is irrelevant and any valid file name will do. Accept. This is irrelevant and any valid file name will do. Accept.
@ -179,21 +131,13 @@ tutorial in an Android Virtual Device (AVD), make sure to create the
device with support for audio playback and GPU Emulation (to enable device with support for audio playback and GPU Emulation (to enable
OpenGL ES). OpenGL ES).
![](images/icons/grey_arrow_down.gif)Using the command line (Click to #### Using the command line
expand)
<table> > ![](images/icons/emoticons/warning.png) Note that, on Windows, this procedure requires a working Cygwin shell, as explained in the [Android NDK System Requirements](http://developer.android.com/tools/sdk/ndk/index.html#Reqs)
<tbody>
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><p>Note that, on Windows, this procedure requires a working Cygwin shell, as explained in the <a href="http://developer.android.com/tools/sdk/ndk/index.html#Reqs" class="external-link">Android NDK System Requirements</a>.</p></td>
</tr>
</tbody>
</table>
For each tutorial, move to its folder and run: For each tutorial, move to its folder and run:
``` theme: Default; brush: plain; gutter: false ```
android update project -p . -s --target X android update project -p . -s --target X
``` ```
@ -204,7 +148,7 @@ API level 9.
To get a list of all available targets in your system issue this To get a list of all available targets in your system issue this
command: command:
``` theme: Default; brush: plain; gutter: false ```
android list android list
``` ```
@ -213,7 +157,7 @@ the build system. You only need to perform this action once per project.
To build the C part, just call: To build the C part, just call:
``` theme: Default; brush: plain; gutter: false ```
ndk-build ndk-build
``` ```
@ -224,13 +168,13 @@ methods.
Finally, compile the Java code with: Finally, compile the Java code with:
``` theme: Default; brush: plain; gutter: false ```
ant debug ant debug
``` ```
And install on the device with: And install on the device with:
``` theme: Default; brush: plain; gutter: false ```
adb install -r bin/Tutorial1-debug.apk adb install -r bin/Tutorial1-debug.apk
``` ```
@ -244,17 +188,12 @@ tutorial in an Android Virtual Device (AVD), make sure to create the
device with support for audio playback and GPU Emulation (to enable device with support for audio playback and GPU Emulation (to enable
OpenGL ES). OpenGL ES).
<table>
<tbody>
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><strong>Windows linkage problems</strong><br />
<p>Due to problems related to the standard linker, Google’s <a href="http://en.wikipedia.org/wiki/Gold_(linker)" class="external-link">Gold Linker</a> is used to build GStreamer applications.  Unfortunately, the Android NDK toolchain for Windows does not include the gold linker and the standard one has to be used.</p> > ![](images/icons/emoticons/warning.png) Windows linkage problems
<p>If you observe linkage problems, you can replace the linker in your Android NDK with the gold one from <a href="http://code.google.com/p/mingw-and-ndk/downloads/detail?name=android-ndk-r8b-ma-windows.7z&amp;can=2&amp;q=" class="external-link">this project</a>. Download the <code>android-ndk-r8b-ma-windows.7z</code> file, extract <code>\android-ndk-r8b\toolchains\arm-linux-androideabi-4.6\prebuilt\windows\arm-linux-androideabi\bin\ld.exe</code> (only this file is needed) and overwrite the one in the same folder in your Android NDK installation. You might need the free <a href="http://www.7-zip.org/" class="external-link">7-Zip archiving utility</a>.</p></td> >
</tr> > Due to problems related to the standard linker, Google’s <a href="http://en.wikipedia.org/wiki/Gold_(linker)" class="external-link">Gold Linker</a> is used to build GStreamer applications.  Unfortunately, the Android NDK toolchain for Windows does not include the gold linker and the standard one has to be used.
</tbody> >
</table> > If you observe linkage problems, you can replace the linker in your Android NDK with the gold one from [this project](http://code.google.com/p/mingw-and-ndk/downloads/detail?name=android-ndk-r8b-ma-windows.7z&amp;can=2&amp;q=). Download the `android-ndk-r8b-ma-windows.7z` file, extract `\android-ndk-r8b\toolchains\arm-linux-androideabi-4.6\prebuilt\windows\arm-linux-androideabi\bin\ld.exe` (only this file is needed) and overwrite the one in the same folder in your Android NDK installation. You might need the free [7-Zip archiving utility](http://www.7-zip.org/)
### Creating new projects ### Creating new projects
@ -271,7 +210,7 @@ project, and its barebones structure (as auto-generated by Eclipse) is:
**Android.mk** **Android.mk**
``` theme: Default; brush: plain; gutter: true ```
LOCAL_PATH := $(call my-dir) LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS) include $(CLEAR_VARS)
@ -290,7 +229,7 @@ Adding GStreamer support only requires adding these lines:
**Android.mk with GStreamer support** **Android.mk with GStreamer support**
``` theme: Default; brush: plain; gutter: true ```
LOCAL_PATH := $(call my-dir) LOCAL_PATH := $(call my-dir)
include $(CLEAR_VARS) include $(CLEAR_VARS)
@ -336,59 +275,54 @@ Listing all desired plugins can be cumbersome, so they have been grouped
into categories, which can be used by including the `plugins.mk` file, into categories, which can be used by including the `plugins.mk` file,
and used as follows: and used as follows:
``` theme: Default; brush: plain; gutter: false ```
include $(GSTREAMER_NDK_BUILD_PATH)/plugins.mk include $(GSTREAMER_NDK_BUILD_PATH)/plugins.mk
GSTREAMER_PLUGINS := $(GSTREAMER_PLUGINS_CORE) $(GSTREAMER_PLUGINS_CODECS) playbin souphttpsrc GSTREAMER_PLUGINS := $(GSTREAMER_PLUGINS_CORE) $(GSTREAMER_PLUGINS_CODECS) playbin souphttpsrc
``` ```
![](images/icons/grey_arrow_down.gif)List of categories and included #### List of categories and included plugins
plugins (Click to expand)
<table> <table>
<thead> <thead>
<tr class="header"> <tr>
<th>Category</th> <th>Category</th>
<th>Included plugins</th> <th>Included plugins</th>
</tr> </tr>
</thead> </thead>
<tbody> <tbody>
<tr class="odd"> <tr>
<td><code>GSTREAMER_PLUGINS_CORE</code></td> <td><code>GSTREAMER_PLUGINS_CORE</code></td>
<td><code>coreelements coreindexers adder app audioconvert audiorate audioresample audiotestsrc</code> <code>ffmpegcolorspace gdp gio pango typefindfunctions videorate videoscale videotestsrc</code> <code>volume autodetect videofilter</code></td> <td>coreelements coreindexers adder app audioconvert audiorate audioresample audiotestsrc ffmpegcolorspace gdp gio pango typefindfunctions videorate videoscale videotestsrc volume autodetect videofilter</td>
</tr> </tr>
<tr class="even"> <tr>
<td><code>GSTREAMER_PLUGINS_PLAYBACK</code></td> <td><code>GSTREAMER_PLUGINS_PLAYBACK</code></td>
<td><code>decodebin2 playbin</code></td> <td>decodebin playbin</td>
</tr> </tr>
<tr class="odd"> <tr>
<td><code>GSTREAMER_PLUGINS_CODECS</code></td> <td><code>GSTREAMER_PLUGINS_CODECS</code></td>
<td><code>subparse ogg theora vorbis alaw annodex apetag audioparsers auparse avi flac flv flxdec</code> <code>icydemux id3demux isomp4 jpeg matroska mulaw multipart png speex taglib wavenc wavpack</code> <code>wavparse y4menc adpcmdec adpcmenc aiff cdxaparse dtmf dvbsuboverlay dvdspu fragmented</code> <code>hdvparse id3tag ivfparse jp2k kate mve mxf nsf nuvdemux opus pcapparse pnm schro siren</code> <code>subenc tta videoparsersbad vmnc vp8 y4mdec</code></td> <td>subparse ogg theora vorbis alaw annodex apetag audioparsers auparse avi flac flv flxdec icydemux id3demux isomp4 jpeg matroska mulaw multipart png speex taglib wavenc wavpack wavparse y4menc adpcmdec adpcmenc aiff cdxaparse dtmf dvbsuboverlay dvdspu fragmented hdvparse id3tag ivfparse jp2k kate mve mxf nsf nuvdemux opus pcapparse pnm schro siren subenc tta videoparsersbad vmnc vp8 y4mdec</td>
</tr> </tr>
<tr class="even"> <tr>
<td><code>GSTREAMER_PLUGINS_VIS</code></td> <td><code>GSTREAMER_PLUGINS_VIS</code></td>
<td><code>libvisual goom goom2k1 audiovisualizers</code></td> <td>libvisual goom goom2k1 audiovisualizers</td>
</tr> </tr>
<tr class="odd"> <tr>
<td><code>GSTREAMER_PLUGINS_EFFECTS</code></td> <td><code>GSTREAMER_PLUGINS_EFFECTS</code></td>
<td><code>alpha alphacolor audiofx cutter debug deinterlace effectv equalizer gdkpixbuf imagefreeze</code> <code>interleave level multifile replaygain shapewipe smpte spectrum videobox videocrop videomixer</code> <code>autoconvert bayer coloreffects faceoverlay fieldanalysis freeverb frei0r gaudieffects</code> <code>geometrictransform interlace jp2kdecimator liveadder rawparse removesilence scaletempoplugin</code> <code>segmentclip smooth speed stereo videofiltersbad videomeasure videosignal</code></td> <td>alpha alphacolor audiofx cutter debug deinterlace effectv equalizer gdkpixbuf imagefreeze interleave level multifile replaygain shapewipe smpte spectrum videobox videocrop videomixer autoconvert bayer coloreffects faceoverlay fieldanalysis freeverb frei0r gaudieffects geometrictransform interlace jp2kdecimator liveadder rawparse removesilence scaletempoplugin segmentclip smooth speed stereo videofiltersbad videomeasure videosignal</td>
</tr> </tr>
<tr class="even"> <tr class="even">
<td><code>GSTREAMER_PLUGINS_NET</code></td> <td><code>GSTREAMER_PLUGINS_NET</code></td>
<td><code>rtsp rtp rtpmanager souphttpsrc udp dataurisrc rtpmux rtpvp8 sdpelem</code></td> <td>rtsp rtp rtpmanager souphttpsrc udp dataurisrc rtpmux rtpvp8 sdpelem</td>
</tr> </tr>
<tr class="odd"> <tr class="odd">
<td><code>GSTREAMER_PLUGINS_CODECS_GPL</code></td> <td><code>GSTREAMER_PLUGINS_CODECS_GPL</code></td>
<td><code>assrender</code></td> <td>assrender</td>
</tr> </tr>
<tr class="even"> <tr class="even">
<td><code>GSTREAMER_PLUGINS_SYS</code></td> <td><code>GSTREAMER_PLUGINS_SYS</code></td>
<td><code>eglglessink opensles amc</code></td> <td>eglglessink opensles amc</td>
</tr> </tr>
</tbody> </tbody>
</table> </table>
Build and run your application as explained in the **Building the Build and run your application as explained in the **Building the tutorials** section.
tutorials** section.
Document generated by Confluence on Oct 08, 2015 10:27

52
Installing+for+iOS+development.markdown
View file

@ -1,8 +1,6 @@
# GStreamer SDK documentation : Installing for iOS development # Installing for iOS development
This page last changed on Jun 12, 2013 by xartigas. ## Prerequisites
# Prerequisites
For iOS development you need to download Xcode and the iOS SDK. Xcode For iOS development you need to download Xcode and the iOS SDK. Xcode
can be found at the App Store or can be found at the App Store or
@ -15,39 +13,15 @@ Xcode is 4, but 4.5 is recommended.
In case you are not familiar with iOS, Objective-C or Xcode, we In case you are not familiar with iOS, Objective-C or Xcode, we
recommend taking a look at the available documentation at Apple's recommend taking a look at the available documentation at Apple's
website. website.
[This](http://developer.apple.com/library/ios/#DOCUMENTATION/iPhone/Conceptual/iPhone101/Articles/00_Introduction.html) [This](http://developer.apple.com/library/ios/#DOCUMENTATION/iPhone/Conceptual/iPhone101/Articles/00_Introduction.html) can be a good starting point.
can be a good starting point.
# Download and install the SDK # Download and install the SDK
The GStreamer SDK installer can be found at: The GStreamer SDK installer can be found at:
<table> **FIXME: Add links**
<colgroup>
<col width="100%" />
</colgroup>
<thead>
<tr class="header">
<th>Universal</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><ul>
<li><a href="http://cdn.gstreamer.com/ios/gstreamer-sdk-devel-2013.6-ios-universal.dmg" class="external-link">GStreamer SDK 2013.6 (Congo) for iOS (Installer Package)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/ios/gstreamer-sdk-devel-2013.6-ios-universal.dmg" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/ios/gstreamer-sdk-devel-2013.6-ios-universal.dmg.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/ios/gstreamer-sdk-devel-2013.6-ios-universal.dmg.sha1" class="external-link">sha1</a></li>
</ul></td>
</tr>
</tbody>
</table>
<table> > ![Warning](images/icons/emoticons/warning.png) Due to the size of these files, usage of a [Download Manager](http://en.wikipedia.org/wiki/Download_manager) is **highly recommended**. Take a look at [this list](http://en.wikipedia.org/wiki/Comparison_of_download_managers) if you do not have one installed. If, after downloading, the installer reports itself as corrupt, chances are that the connection ended before the file was complete. A Download Manager will typically re-start the process and fetch the missing parts.
<tbody>
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><p><span>Due to the size of these files, usage of a </span><a href="http://en.wikipedia.org/wiki/Download_manager" class="external-link">Download Manager</a><span> is </span><strong>highly recommended</strong><span>. Take a look at </span><a href="http://en.wikipedia.org/wiki/Comparison_of_download_managers" class="external-link">this list</a><span> if you do not have one installed. If, after downloading, the installer reports itself as corrupt, chances are that the connection ended before the file was complete. A Download Manager will typically re-start the process and fetch the missing parts.</span></p></td>
</tr>
</tbody>
</table>
Double click the package file and follow the instructions presented by Double click the package file and follow the instructions presented by
the install wizard. In case the system complains about the package not the install wizard. In case the system complains about the package not
@ -66,7 +40,7 @@ Xcode application templates for GStreamer development. Those templates
are also copied to `~/Library/Developer/Xcode/Templates` during are also copied to `~/Library/Developer/Xcode/Templates` during
installation so that Xcode can find them. installation so that Xcode can find them.
# Configure your development environment ## Configure your development environment
GStreamer is written in C, and the iOS API uses mostly Objective-C (and GStreamer is written in C, and the iOS API uses mostly Objective-C (and
C for some parts), but this should cause no problems as those languages C for some parts), but this should cause no problems as those languages
@ -76,8 +50,8 @@ example.
### Building the tutorials ### Building the tutorials
The GStreamer SDK ships a few tutorials in the `xcode iOS` folder inside The GStreamer SDK ships a few tutorials in the `xcode iOS` folder inside
the `.dmg` file. Copy them out of the package and into a more suitable the `.dmg` file. Copy them out of the package and into a more suitable
place.** **We recommend that you open the project in Xcode, take a look place. We recommend that you open the project in Xcode, take a look
at the sources and build them. This should confirm that the installation at the sources and build them. This should confirm that the installation
works and give some insight on how simple it is to mix Objective-C and C works and give some insight on how simple it is to mix Objective-C and C
code. code.
@ -95,13 +69,13 @@ to find, use and link GStreamer just like in traditional linux
development. For example, if you don't use the templates, you'll have to development. For example, if you don't use the templates, you'll have to
use: use:
``` theme: Default; brush: cpp; gutter: false ```
#include <GStreamer/gst/gst.h>  #include <GStreamer/gst/gst.h>
``` ```
instead of the usual: instead of the usual:
``` theme: Default; brush: cpp; gutter: false ```
#include <gst/gst.h> #include <gst/gst.h>
``` ```
@ -111,7 +85,5 @@ keep development consistent across all the platforms the SDK supports.
Once a project has been created using a GStreamer SDK Template, it is Once a project has been created using a GStreamer SDK Template, it is
ready to build and run. All necessary infrastructure is already in ready to build and run. All necessary infrastructure is already in
place. To understand what files have been created and how they interact, place. To understand what files have been created and how they interact,
take a look at the [iOS tutorials](iOS%2Btutorials.html). take a look at the [iOS tutorials](iOS+tutorials.markdown).
Document generated by Confluence on Oct 08, 2015 10:27

94
Installing+on+Mac+OS+X.markdown
View file

@ -1,8 +1,8 @@
# GStreamer SDK documentation : Installing on Mac OS X # Installing on Mac OS X
This page last changed on Jun 12, 2013 by xartigas. ## Prerequisites
# Prerequisites **FIXME: Those all need updating**
To develop applications using the GStreamer SDK for OS X you will need To develop applications using the GStreamer SDK for OS X you will need
OS X Snow Leopard (10.6) or later and OS X Snow Leopard (10.6) or later and
@ -10,65 +10,37 @@ OS X Snow Leopard (10.6) or later and
later. later.
The recommended system is [Mac OS X The recommended system is [Mac OS X
Lion](http://www.apple.com/macosx/) with Lion](http://www.apple.com/macosx/) with
[XCode 4](https://developer.apple.com/xcode/) [XCode 4](https://developer.apple.com/xcode/)
Installing the SDK for 32-bits platforms requires approximately 145MB of Installing the SDK for 32-bits platforms requires approximately 145MB of
free disk space for the runtime and 193MB for the development files. free disk space for the runtime and 193MB for the development files.
Installing the SDK for 64-bits platforms requires approximately 152MB of Installing the SDK for 64-bits platforms requires approximately 152MB of
free disk space for the runtime and 223MB for the development files. free disk space for the runtime and 223MB for the development files.
# Download and install the SDK ## Download and install the SDK
There are 3 sets of files in the SDK: There are 3 sets of files in the SDK:
- The runtime files are needed to run GStreamer applications. You - The runtime files are needed to run GStreamer applications. You
probably want to distribute these files with your application (or probably want to distribute these files with your application (or
the installer below). the installer below).
- The development files are **additional** files you need to create - The development files are **additional** files you need to create
GStreamer applications. GStreamer applications.
- Mac OS X packages that you can use - Mac OS X packages that you can use
with [PackageMaker](https://developer.apple.com/library/mac/#documentation/DeveloperTools/Conceptual/PackageMakerUserGuide/Introduction/Introduction.html) with [PackageMaker](https://developer.apple.com/library/mac/#documentation/DeveloperTools/Conceptual/PackageMakerUserGuide/Introduction/Introduction.html)
to deploy GStreamer with your application to deploy GStreamer with your application
Get **both the runtime and the development installers** from here: Get **both the runtime and the development installers** from here:
<table> ** FIXME: Update links **
<colgroup>
<col width="100%" />
</colgroup>
<tbody>
<tr class="odd">
<td>Universal</td>
</tr>
<tr class="even">
<td><ul>
<li><a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal.pkg" class="external-link">GStreamer SDK 2013.6 (Congo) for Mac OS X (Runtime)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/osx/universal/gstreamer-sdk-2013.6-universal.pkg" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal.pkg.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal.pkg.sha1" class="external-link">sha1</a></li>
<li><a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-devel-2013.6-universal.pkg" class="external-link">GStreamer SDK 2013.6 (Congo) for Mac OS X (Development files)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/osx/universal/gstreamer-sdk-devel-2013.6-universal.pkg" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-devel-2013.6-universal.pkg.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-devel-2013.6-universal.pkg.sha1" class="external-link">sha1</a></li>
<li><a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal-packages.dmg" class="external-link">GStreamer SDK 2013.6 (Congo) for Mac OS X (Deployment Packages)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/osx/universal/gstreamer-sdk-2013.6-universal-packages.dmg" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal-packages.dmg.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/osx/universal/gstreamer-sdk-2013.6-universal-packages.dmg.sha1" class="external-link">sha1</a></li>
</ul></td>
</tr>
</tbody>
</table>
<table> > ![Warning](images/icons/emoticons/warning.png)
<tbody> > On Mac OS X 10.6 (Snow Leopard) you have to install Python 2.7 manually. It is included in later versions of OS X already. You can get it from [here](http://www.python.org/getit).
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><p>On Mac OS X 10.6 (Snow Leopard) you have to install Python 2.7 manually. It is included in later versions of OS X already. You can get it from <a href="http://www.python.org/getit" class="external-link">here</a>.</p></td>
</tr>
</tbody>
</table>
<table> > ![Warning](images/icons/emoticons/warning.png)
<tbody> > Due to the size of these files, usage of a [Download Manager](http://en.wikipedia.org/wiki/Download_manager) is **highly recommended**. Take a look at [this list](http://en.wikipedia.org/wiki/Comparison_of_download_managers) if you do not have one installed. If, after downloading, the installer reports itself as corrupt, chances are that the connection ended before the file was complete. A Download Manager will typically re-start the process and fetch the missing parts.
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><p>Due to the size of these files, usage of a <a href="http://en.wikipedia.org/wiki/Download_manager" class="external-link">Download Manager</a> is <strong>highly recommended</strong>. Take a look at <a href="http://en.wikipedia.org/wiki/Comparison_of_download_managers" class="external-link">this list</a> if you do not have one installed. If, after downloading, the installer reports itself as corrupt, chances are that the connection ended before the file was complete. A Download Manager will typically re-start the process and fetch the missing parts.</p></td>
</tr>
</tbody>
</table>
The downloads are [Apple Disk Images The downloads are [Apple Disk Images
(.dmg)](http://en.wikipedia.org/wiki/Apple_Disk_Image) containing an (.dmg)](http://en.wikipedia.org/wiki/Apple_Disk_Image) containing an
@ -79,7 +51,7 @@ click in the installer to start the installation process.
These are some paths of the GStreamer framework that you might find These are some paths of the GStreamer framework that you might find
useful: useful:
- /Library/Frameworks/GStreamer.framework/: Framework's root path  - /Library/Frameworks/GStreamer.framework/: Framework's root path
- /Library/Frameworks/GStreamer.framework/Versions: path with all the - /Library/Frameworks/GStreamer.framework/Versions: path with all the
versions of the framework versions of the framework
- /Library/Frameworks/GStreamer.framework/Versions/Current: link to - /Library/Frameworks/GStreamer.framework/Versions/Current: link to
@ -91,52 +63,38 @@ useful:
gst-launch-0.10 gst-launch-0.10
For more information on OS X Frameworks anatomy, you can consult the For more information on OS X Frameworks anatomy, you can consult the
following [link](https://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPFrameworks/Concepts/FrameworkAnatomy.html) following [link](https://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPFrameworks/Concepts/FrameworkAnatomy.html)
# Configure your development environment ## Configure your development environment
### Building the tutorials ### Building the tutorials
The tutorial's code, along with project files and a solution file for The tutorial's code, along with project files and a solution file for
them all are included in the SDK. The source code and the XCode project them all are included in the SDK. The source code and the XCode project
files are located files are located
in `/Library/Frameworks/GStreamer.framework/Current/share/gst-sdk/tutorials.` in `/Library/Frameworks/GStreamer.framework/Current/share/gst-sdk/tutorials.`
To start building the tutorials, create a new folder in your Documents To start building the tutorials, create a new folder in your Documents
directory and copy the directory and copy the
folder `/Library/Frameworks/GStreamer.framework/Current/share/gst-sdk/tutorials`. folder `/Library/Frameworks/GStreamer.framework/Current/share/gst-sdk/tutorials`.
You can fire up XCode and load the project file. You can fire up XCode and load the project file.
Press the **Run **button to build and run the first tutorial. You can Press the **Run **button to build and run the first tutorial. You can
switch the tutorial to build selecting one of the available schemes.  switch the tutorial to build selecting one of the available schemes.
### Creating new projects ### Creating new projects
The GStreamer SDK provides a The GStreamer SDK provides a
[framework](https://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPFrameworks/Tasks/IncludingFrameworks.html) [framework](https://developer.apple.com/library/mac/#documentation/MacOSX/Conceptual/BPFrameworks/Tasks/IncludingFrameworks.html)
that you can drag and drop to XCode to start using it, or using the that you can drag and drop to XCode to start using it, or using the
linker option ***-framework GStreamer****.* linker option ***-framework GStreamer****.*
There is a small exception to the regular use of frameworks, and you There is a small exception to the regular use of frameworks, and you
will need to manually include the headers search will need to manually include the headers search
path  `/Library/Frameworks/GStreamer.framework/Headers` path `/Library/Frameworks/GStreamer.framework/Headers`
- XCode: Add the headers path to **Search Paths-\> Header Search - XCode: Add the headers path to **Search Paths-\> Header Search
Paths** Paths**
- GCC: Using the compiler - GCC: Using the compiler
option** -I/Library/Frameworks/GStreamer.framework/Headers** option** -I/Library/Frameworks/GStreamer.framework/Headers**
## Attachments:
![](images/icons/bullet_blue.gif)
[Configurations.png](attachments/327710/2424835.png) (image/png)
![](images/icons/bullet_blue.gif)
[Schemes.png](attachments/327710/2424836.png) (image/png)
![](images/icons/bullet_blue.gif) [Add
files.png](attachments/327710/2424837.png) (image/png)
![](images/icons/bullet_blue.gif) [Project
Files.png](attachments/327710/2424838.png) (image/png)
Document generated by Confluence on Oct 08, 2015 10:27

268
Installing+on+Windows.markdown
View file

@ -1,8 +1,6 @@
# GStreamer SDK documentation : Installing on Windows # Installing on Windows
This page last changed on Jun 12, 2013 by xartigas. ## Prerequisites
# Prerequisites
To develop applications using the GStreamer SDK for Windows you will To develop applications using the GStreamer SDK for Windows you will
need [Windows need [Windows
@ -30,9 +28,9 @@ Installing the SDK for 32-bits platforms requires approximately 286MB of
free disk space for the runtime and 207MB for the development files. free disk space for the runtime and 207MB for the development files.
Installing the SDK for 64-bits platforms requires approximately 340MB of Installing the SDK for 64-bits platforms requires approximately 340MB of
free disk space for the runtime and 216MB for the development files. free disk space for the runtime and 216MB for the development files.
# Download and install the SDK ## Download and install the SDK
There are 3 sets of files in the SDK: There are 3 sets of files in the SDK:
@ -43,193 +41,139 @@ There are 3 sets of files in the SDK:
GStreamer applications. GStreamer applications.
- The [Merge - The [Merge
Modules](http://msdn.microsoft.com/en-us/library/windows/desktop/aa369820%28v=vs.85%29.aspx) Modules](http://msdn.microsoft.com/en-us/library/windows/desktop/aa369820%28v=vs.85%29.aspx)
files are **additional** files you can use to deploy the GStreamer files are **additional** files you can use to deploy the GStreamer
SDK alongside your application (see [Windows SDK alongside your application (see [Windows
deployment](Windows%2Bdeployment.html)). deployment](Windows%2Bdeployment.html)).
Get **the Runtime and Development files** installers appropriate for Get **the Runtime and Development files** installers appropriate for
your architecture from here: your architecture from here:
<table>
<colgroup>
<col width="100%" />
</colgroup>
<tbody>
<tr class="odd">
<td>32 bits</td>
</tr>
<tr class="even">
<td><ul>
<li><a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-x86-2013.6.msi" class="external-link">GStreamer SDK 2013.6 (Congo) for Windows 32 bits (Runtime)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/windows/x86/gstreamer-sdk-x86-2013.6.msi" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-x86-2013.6.msi.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-x86-2013.6.msi.sha1" class="external-link">sha1</a></li>
<li><a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-devel-x86-2013.6.msi" class="external-link">GStreamer SDK 2013.6 (Congo) for Windows 32 bits (Development files)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/windows/x86/gstreamer-sdk-devel-x86-2013.6.msi" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-devel-x86-2013.6.msi.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-devel-x86-2013.6.msi.sha1" class="external-link">sha1</a></li>
<li><a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-x86-2013.6-merge-modules.zip" class="external-link">GStreamer SDK 2013.6 (Congo) for Windows 32 bits (Merge Modules)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/windows/x86/gstreamer-sdk-x86-2013.6-merge-modules.zip" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-x86-2013.6-merge-modules.zip.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/windows/x86/gstreamer-sdk-x86-2013.6-merge-modules.zip.sha1" class="external-link">sha1</a></li>
</ul></td>
</tr>
<tr class="odd">
<td><span style="color: rgb(0,51,102);">64 bits</span></td>
</tr>
<tr class="even">
<td><ul>
<li><a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-x86_64-2013.6.msi" class="external-link">GStreamer SDK 2013.6 (Congo) for Windows 64 bits (Runtime)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/windows/x86-64/gstreamer-sdk-x86_64-2013.6.msi" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-x86_64-2013.6.msi.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-x86_64-2013.6.msi.sha1" class="external-link">sha1</a></li>
<li><a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-devel-x86_64-2013.6.msi" class="external-link">GStreamer SDK 2013.6 (Congo) for Windows 64 bits (Development files)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/windows/x86-64/gstreamer-sdk-devel-x86_64-2013.6.msi" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-devel-x86_64-2013.6.msi.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-devel-x86_64-2013.6.msi.sha1" class="external-link">sha1</a></li>
<li><a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-x86_64-2013.6-merge-modules.zip" class="external-link">GStreamer SDK 2013.6 (Congo) for Windows 64 bits (Merge Modules)</a> - <a href="http://www.freedesktop.org/software/gstreamer-sdk/data/packages/windows/x86-64/gstreamer-sdk-x86_64-2013.6-merge-modules.zip" class="external-link">mirror</a> - <a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-x86_64-2013.6-merge-modules.zip.md5" class="external-link">md5</a> - <a href="http://cdn.gstreamer.com/windows/x86-64/gstreamer-sdk-x86_64-2013.6-merge-modules.zip.sha1" class="external-link">sha1</a></li>
</ul></td>
</tr>
</tbody>
</table>
<table> **FIXME: Add links **
<tbody>
<tr class="odd"> > ![Warning](images/icons/emoticons/warning.png)
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td> > Due to the size of these files, usage of a [Download Manager](http://en.wikipedia.org/wiki/Download_manager) is **highly recommended**. Take a look at [this list](http://en.wikipedia.org/wiki/Comparison_of_download_managers) if you do not have one installed. If, after downloading, the installer reports itself as corrupt, chances are that the connection ended before the file was complete. A Download Manager will typically re-start the process and fetch the missing parts.
<td><p>Due to the size of these files, usage of a <a href="http://en.wikipedia.org/wiki/Download_manager" class="external-link">Download Manager</a> is <strong>highly recommended</strong>. Take a look at <a href="http://en.wikipedia.org/wiki/Comparison_of_download_managers" class="external-link">this list</a> if you do not have one installed. If, after downloading, the installer reports itself as corrupt, chances are that the connection ended before the file was complete. A Download Manager will typically re-start the process and fetch the missing parts.</p></td>
</tr>
</tbody>
</table>
Execute the installers and choose an installation folder. The suggested Execute the installers and choose an installation folder. The suggested
default is usually OK. default is usually OK.
<table> > ![Warning](images/icons/emoticons/warning.png)
<tbody> >`If you plan to use Visual Studio, **close it before installing the GStreamer SDK**. The installer will define new environment variables which will not be picked up by Visual Studio if it is open.
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><p>If you plan to use Visual Studio, <strong>close it before installing the GStreamer SDK</strong>. The installer will define new environment variables which will not be picked up by Visual Studio if it is open.</p></td>
</tr>
</tbody>
</table>
<table>
<tbody> > On **Windows 8** and **Windows 10**, it might be necessary to log out and log back in to your account after the installation for the newly defined environment variables to be picked up by Visual Studio.
<tr class="odd">
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td>
<td><p>On <strong>Windows 8</strong>, it might be necessary to log out and log back in to your account after the installation for the newly defined environment variables to be picked up by Visual Studio.</p></td>
</tr>
</tbody>
</table>
It is the application's responsibility to ensure that, at runtime, It is the application's responsibility to ensure that, at runtime,
GStreamer can access its libraries and plugins. It can be done by adding GStreamer can access its libraries and plugins. It can be done by adding
`%GSTREAMER_SDK_ROOT_X86%\bin` to the `%PATH%` environment variable, or `%GSTREAMER_SDK_ROOT_X86%\bin` to the `%PATH%` environment variable, or
by running the application from this same folder. by running the application from this same folder.
At runtime, GStreamer will look for its plugins in the following At runtime, GStreamer will look for its plugins in the following
folders: folders:
- `%HOMEDRIVE%%HOMEFOLDER%/.gstreamer-0.10/plugins` - `%HOMEDRIVE%%HOMEFOLDER%/.gstreamer-1.0/plugins`
- `C:\gstreamer-sdk\0.10\x86\lib\gstreamer-0.10` - `C:\gstreamer\1.0\x86\lib\gstreamer-1.0`
- `<location of libgstreamer-0.10-0.dll>\..\lib\gstreamer-0.10` - `<location of libgstreamer-1.0-0.dll>\..\lib\gstreamer-1.0`
- `%GST_PLUGIN_PATH%` - `%GST_PLUGIN_PATH%`
So, typically, if your application can find `libgstreamer-0.10-0.dll`, So, typically, if your application can find `libgstreamer-1.0-0.dll`,
it will find the GStreamer plugins, as long as the installation folder it will find the GStreamer plugins, as long as the installation folder
structure is unmodified. If you do change this structure in your structure is unmodified. If you do change this structure in your
application, then you can use the `%GST_PLUGIN_PATH%` environment application, then you can use the `%GST_PLUGIN_PATH%` environment
variable to point GStreamer to its plugins. The plugins are initially variable to point GStreamer to its plugins. The plugins are initially
found at `%GSTREAMER_SDK_ROOT_X86%\lib\gstreamer-0.10`. found at `%GSTREAMER_SDK_ROOT_X86%\lib\gstreamer-1.0`.
Additionally, if you want to prevent GStreamer from looking in all the Additionally, if you want to prevent GStreamer from looking in all the
default folders listed above, you can set the default folders listed above, you can set the
`%GST_PLUGIN_SYSTEM_PATH%` environment variable to point where the `%GST_PLUGIN_SYSTEM_PATH%` environment variable to point where the
plugins are located. plugins are located.
# Configure your development environment ## Configure your development environment
### Building the tutorials ### Building the tutorials
The tutorial's code, along with project files and a solution file for The tutorial's code, along with project files and a solution file for
Visual Studio 2010 are all included in the SDK, in Visual Studio 2010 are all included in the SDK, in
the `%GSTREAMER_SDK_ROOT_X86%``\share\gst-sdk\tutorials` folder. the `%GSTREAMER_SDK_ROOT_X86%``\share\gst-sdk\tutorials` folder.
`%GSTREAMER_SDK_ROOT_X86%` is an environment variable that the installer `%GSTREAMER_SDK_ROOT_X86%` is an environment variable that the installer
defined for you, and points to the installation folder of the SDK. defined for you, and points to the installation folder of the SDK.
In order to prevent accidental modification of the original code, and to In order to prevent accidental modification of the original code, and to
make sure Visual Studio has the necessary permissions to write the make sure Visual Studio has the necessary permissions to write the
output files, copy the entire `tutorials` folder to a place of your output files, copy the entire `tutorials` folder to a place of your
liking, and work from there. liking, and work from there.
<table> > ![Information](images/icons/emoticons/information.png)
<tbody> > **64-bit Users**
<tr class="odd"> >
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td> >Use `%GSTREAMER_SDK_ROOT_X86_64%` if you have installed the SDK for 64-bit platforms. Both SDKs (32 and 64-bit) can be installed simultaneously, and hence the separate environment variables.
<td><strong>64-bit Users</strong><br /> >
>Make sure you select the Solution Configuration that matches the GStreamer SDK that you have installed: `Win32` for 32 bits or `x64` for 64 bits.
<p>Use <code>%GSTREAMER_SDK_ROOT_X86_64%</code> if you have installed the SDK for 64-bit platforms. Both SDKs (32 and 64-bit) can be installed simultaneously, and hence the separate environment variables.</p> >
<p>Make sure you select the Solution Configuration that matches the GStreamer SDK that you have installed: <code>Win32</code> for 32 bits or <code>x64</code> for 64 bits. <img src="attachments/thumbnails/327707/1540165" class="confluence-embedded-image confluence-thumbnail image-right" width="100" /></p></td> > ![Windows Install Configuration](attachments/WindowsInstall-Configuration.png)
</tr>
</tbody>
</table>
You can fire up Visual Studio 2010 and load your copy of the You can fire up Visual Studio 2010 and load your copy of the
`tutorials.sln` solution file (Click on the screen shots to enlarge `tutorials.sln` solution file (Click on the screen shots to enlarge
them).![](attachments/thumbnails/327707/1540147) them).
![](attachments/thumbnails/327707/1540146)
![](attachments/WindowsInstall2.png)
![](attachments/WindowsInstall1.png)
Hit **F7**, press the Build Solution button Hit **F7**, press the Build Solution button
![](attachments/327707/1540148.png) or go to Build → Build Solution. All ![](attachments/WindowsInstall-BuildSolution.png) or go to Build →
projects should build without problems. Build Solution. All projects should build without problems.
### Running the tutorials ### Running the tutorials
In order to run the tutorials, we will set the current working directory In order to run the tutorials, we will set the current working directory
to `%GSTREAMER_SDK_ROOT_X86%``\``bin` in the Debugging section of the to `%GSTREAMER_SDK_ROOT_X86%`\\`bin` in the Debugging section of the
project properties. **This property is not stored in the project files, project properties. **This property is not stored in the project files,
so you will need to manually add it to every tutorial you want to run so you will need to manually add it to every tutorial you want to run
from within Visual Studio**. Right click on a project in the Solution from within Visual Studio**. Right click on a project in the Solution
Explorer, Properties → Debugging → Working Directory, and type Explorer, Properties → Debugging → Working Directory, and type
`$(GSTREAMER_SDK_ROOT_X86)``\``bin` `$(GSTREAMER_SDK_ROOT_X86)`\\`bin`
` `(The `$(...)` notation is required to access environment variables (The `$(...)` notation is required to access environment variables
from within Visual Studio. You use the `%...%` notation from Windows from within Visual Studio. You use the `%...%` notation from Windows
Explorer) Explorer)
You should now be able to run the tutorials. You should now be able to run the tutorials.
 
### Creating new projects manually ### Creating new projects manually
**If you want to create 64-bit applications, remember also to create x64 **If you want to create 64-bit applications, remember also to create x64
Solution and Project configurations as Solution and Project configurations as
explained [here](http://msdn.microsoft.com/en-us/library/9yb4317s\(v=vs.100\).aspx).** explained [here](http://msdn.microsoft.com/en-us/library/9yb4317s\(v=vs.100\).aspx).**
#### Include the necessary SDK Property Sheet #### Include the necessary SDK Property Sheet
The included property sheets make creating new projects extremely easy. The included property sheets make creating new projects extremely easy.
In Visual Studio 2010 create a new project (Normally a `Win32 In Visual Studio 2010 create a new project (Normally a `Win32
Console` or `Win32 Application`). Then go to the Property Manager Console` or `Win32 Application`). Then go to the Property Manager
(View→Property Manager), right-click on your project and select “Add (View→Property Manager), right-click on your project and select “Add
Existing Property Sheet...”. Navigate to Existing Property Sheet...”. Navigate to
`%GSTREAMER_SDK_ROOT_X86%``\``share\vs\2010\libs` and `%GSTREAMER_SDK_ROOT_X86%`\\`share\vs\2010\libs` and
load `gstreamer-0.10.props ` load `gstreamer-1.0.props `
This property sheet contains the directories where the headers and This property sheet contains the directories where the headers and
libraries are located, and the necessary options for the compiler and libraries are located, and the necessary options for the compiler and
linker, so you do not need to change anything else in your project. linker, so you do not need to change anything else in your project.
**
**
 
 
If you cannot find the Property Manager, you might need to enable Expert If you cannot find the Property Manager, you might need to enable Expert
Settings. Go to Tools → Settings → Expert Settings. Upon first Settings. Go to Tools → Settings → Expert Settings. Upon first
installation of Visual Studio, Expert Settings are disabled by installation of Visual Studio, Expert Settings are disabled by
default.![](attachments/thumbnails/327707/1540154) default.
  ![](attachments/WindowsInstall10.png)
<table>
<tbody> > ![Warning](images/icons/emoticons/warning.png)
<tr class="odd"> > **Depending on the GStreamer libraries you need to use, you will have to add more property pages, besides `gstreamer-1.0`** (each property page corresponds to one GStreamer library).
<td><img src="images/icons/emoticons/warning.png" width="16" height="16" /></td> >
<td><p><strong>Depending on the GStreamer libraries you need to use, you will have to add more property pages, besides <code class="western">gstreamer-0.10</code></strong> (each property page corresponds to one GStreamer library).</p> > The tutorial's project files already contain all necessary property pages. When developing your own applications, the GStreamer documentation will tell you what library a function belongs to, and therefore, what property pages you need to add.
<p>The tutorial's project files already contain all necessary property pages. When developing your own applications, the GStreamer documentation will tell you what library a function belongs to, and therefore, what property pages you need to add.</p></td>
</tr>
</tbody>
</table>
#### Remove the dependency with the Visual Studio runtime #### Remove the dependency with the Visual Studio runtime
@ -252,107 +196,33 @@ Runtime, problems are bound to crop out.
In order to avoid these issues you must instruct your application to use In order to avoid these issues you must instruct your application to use
the system's C Runtime. First install the [Windows Device Driver Kit the system's C Runtime. First install the [Windows Device Driver Kit
Version 7.1.0](http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=11800) (DDK). Version 7.1.0](http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=11800) (DDK).
When the installer asks about the features, select only “Build When the installer asks about the features, select only “Build
Environments”. Accept the suggested location for the installation, which Environments”. Accept the suggested location for the installation, which
is usually `C:\WinDDK\7600.16385.1`. This download is an ISO file, you is usually `C:\WinDDK\7600.16385.1`. This download is an ISO file, you
can either burn a DVD with it (as recommended in the Microsoft site. You can either burn a DVD with it (as recommended in the Microsoft site. You
will need DVD burning software), mount the file in a virtual DVD device will need DVD burning software), mount the file in a virtual DVD device
(you will need DVD virtualization software) or unpack the file as if it (you will need DVD virtualization software) or unpack the file as if it
was a regular compressed file (you will need decompression software that was a regular compressed file (you will need decompression software that
understands the ISO format). understands the ISO format).
Then, add the `x86.props` or `x86_64.props` (for 32 or 64 bits) property Then, add the `x86.props` or `x86_64.props` (for 32 or 64 bits) property
sheet found in `%GSTREAMER_SDK_ROOT_X86%``\``share\vs\2010\msvc` to your sheet found in `%GSTREAMER_SDK_ROOT_X86%``\``share\vs\2010\msvc` to your
project. This will make your application use the ubiquitous project. This will make your application use the ubiquitous
`MSVCRT.DLL` saving you some troubles in the future. `MSVCRT.DLL` saving you some troubles in the future.
<table> > ![Information](images/icons/emoticons/information.png)
<tbody> > If you did not install the WinDDK to the standard path `C:\WinDDK\7600.16385.1`, you will need to tell Visual Studio where it is. Unfortunately, there is no automated way to do this. Once you have added the `x86.props` or `x86_64.props` to your project, go to the Property Manager, expand your project and its subfolders until you find the property sheet called `config`. Double click to edit it, and select the section called “User Macros” in the list on the left. You should see a macro called `WINDOWS_DRIVER_KIT`. Double click to edit it, and set its value to the root folder where you installed the DDK. This is the folder containing a file called `samples.txt`.
<tr class="odd"> >
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td> >That's it. Accept the changes, right click on the `config` property sheet and select “Save”. The path to the DDK is now stored in `config.props` and you do not need to perform this operation anymore.
<td><p>If you did not install the WinDDK to the standard path <code>C:\WinDDK\7600.16385.1</code>, you will need to tell Visual Studio where it is. Unfortunately, there is no automated way to do this. Once you have added the <code>x86.props</code> or <code>x86_64.props</code> to your project, go to the Property Manager, expand your project and its subfolders until you find the property sheet called <code>config</code>. Double click to edit it, and select the section called “User Macros” in the list on the left. You should see a macro called <code>WINDOWS_DRIVER_KIT</code>. Double click to edit it, and set its value to the root folder where you installed the DDK. This is the folder containing a file called <code>samples.txt </code></p>
<p>That's it. Accept the changes, right click on the <code>config</code> property sheet and select “Save”. The path to the DDK is now stored in <code>config.props</code> and you do not need to perform this operation anymore.</p></td>
</tr>
</tbody>
</table>
### Creating new projects using the wizard ### Creating new projects using the wizard
Go to File → New → Project… and you should find a template Go to File → New → Project… and you should find a template
named **GStreamer SDK Project**. It takes no parameters, and sets all named **GStreamer SDK Project**. It takes no parameters, and sets all
necessary project settings, both for 32 and 64 bits architectures. necessary project settings, both for 32 and 64 bits architectures.
The generated project file includes the two required Property Sheets The generated project file includes the two required Property Sheets
described in the previous section, so, in order to link to the correct described in the previous section, so, in order to link to the correct
`MSVCRT.DLL`, **you still need to install the Windows Device Driver `MSVCRT.DLL`, **you still need to install the Windows Device Driver
Kit** and change the appropriate property sheets. Kit** and change the appropriate property sheets.
<table>
<tbody>
<tr class="odd">
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td>
<td><p>GStreamer SDK versions prior to Congo did not automatically <span>deploy </span>the required Visual Studio Wizard files. We recommend that you upgrade to the latest available GStreamer SDK version.</p>
<div id="expander-2126536236" class="expand-container">
<div id="expander-control-2126536236" class="expand-control">
<span class="expand-control-icon"><img src="images/icons/grey_arrow_down.gif" class="expand-control-image" /></span><span class="expand-control-text">Click here to see the manual installation instructions...</span>
</div>
<div id="expander-content-2126536236" class="expand-content">
<p>1. The three files in the <code>%GSTREAMER_SDK_ROOT_X86%\share\vs\2010\wizard</code> folder need to be copied to the following location, depending on your version of Visual Studio:</p>
<ul>
<li>Visual Studio 2010:
<ul>
<li><code>C:\Program Files\Microsoft Visual Studio 10.0\VC\vcprojects</code></li>
</ul></li>
<li>Visual Studio 2010 Express:
<ul>
<li><code>C:\Program Files\Microsoft Visual Studio 10.0\VC\Express\VCProjects</code></li>
</ul></li>
</ul>
<p>2. The entire <code>%GSTREAMER_SDK_ROOT_X86%\share\vs\2010\gst-sdk-template</code> folder (including the <code>gst-sdk-template</code> folder) needs to be copied to:</p>
<ul>
<li><code>C:\Program Files\Microsoft Visual Studio 10.0\VC\VCWizards</code></li>
</ul>
<div>
<p><strong>To clarify:</strong> you must end up with three additional files in the <code>VCProjects</code> folder and a new folder named <code>gst-sdk-template</code> inside the <code>VCWizards</code> folder.</p>
<p>Use the right path for your Visual Studio folder.</p>
</div>
</div>
</div></td>
</tr>
</tbody>
</table>
## Attachments:
![](images/icons/bullet_blue.gif)
[WindowsInstall1.png](attachments/327707/1540146.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall2.png](attachments/327707/1540147.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall-BuildSolution.png](attachments/327707/1540148.png)
(image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall3.png](attachments/327707/1540149.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall4.png](attachments/327707/1540150.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall5.png](attachments/327707/1540151.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall6.png](attachments/327707/1540152.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall7.png](attachments/327707/1540153.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall8.png](attachments/327707/1540154.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall9.png](attachments/327707/1540155.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall10.png](attachments/327707/1540156.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall11.png](attachments/327707/1540157.png) (image/png)
![](images/icons/bullet_blue.gif)
[WindowsInstall-Configuration.png](attachments/327707/1540165.png)
(image/png)
Document generated by Confluence on Oct 08, 2015 10:27

30
Installing+the+SDK.markdown
View file

@ -1,6 +1,4 @@
# GStreamer SDK documentation : Installing the SDK # Installing the SDK
This page last changed on Jun 12, 2013 by xartigas.
### Choose your platform ### Choose your platform
@ -12,7 +10,7 @@ This page last changed on Jun 12, 2013 by xartigas.
</colgroup> </colgroup>
<tbody> <tbody>
<tr class="odd"> <tr class="odd">
<td><p><a href="Installing%2Bon%2BLinux.html"><img src="attachments/327700/1540162.png" class="confluence-embedded-image image-center" /></a></p> <td><p><a href="Installing%2Bon%2BLinux.html"><img src="attachments/1540162.png" class="confluence-embedded-image image-center" /></a></p>
<h3 id="InstallingtheSDK-Linux" style="text-align: center;">Linux</h3> <h3 id="InstallingtheSDK-Linux" style="text-align: center;">Linux</h3>
<ul> <ul>
<li>Ubuntu 12.04 (Precise Pangolin)</li> <li>Ubuntu 12.04 (Precise Pangolin)</li>
@ -23,7 +21,7 @@ This page last changed on Jun 12, 2013 by xartigas.
<li>Fedora 17</li> <li>Fedora 17</li>
</ul> </ul>
<p><span style="color: rgb(255,255,255);">______________________________________</span></p></td> <p><span style="color: rgb(255,255,255);">______________________________________</span></p></td>
<td><p><a href="Installing%2Bon%2BMac%2BOS%2BX.html"><img src="attachments/327700/1540163.png" class="confluence-embedded-image image-center" /></a></p> <td><p><a href="Installing%2Bon%2BMac%2BOS%2BX.html"><img src="attachments/1540163.png" class="confluence-embedded-image image-center" /></a></p>
<h3 id="InstallingtheSDK-MacOSX" style="text-align: center;">Mac OS X</h3> <h3 id="InstallingtheSDK-MacOSX" style="text-align: center;">Mac OS X</h3>
<ul> <ul>
<li>10.6 (Snow Leopard)</li> <li>10.6 (Snow Leopard)</li>
@ -31,7 +29,7 @@ This page last changed on Jun 12, 2013 by xartigas.
<li>10.8 (Mountain Lion)</li> <li>10.8 (Mountain Lion)</li>
</ul> </ul>
<p><span style="color: rgb(255,255,255);">______________________________________</span></p></td> <p><span style="color: rgb(255,255,255);">______________________________________</span></p></td>
<td><p><a href="Installing%2Bon%2BWindows.html"><img src="attachments/327700/1540164.png" class="confluence-embedded-image image-center" /></a></p> <td><p><a href="Installing%2Bon%2BWindows.html"><img src="attachments/1540164.png" class="confluence-embedded-image image-center" /></a></p>
<h3 id="InstallingtheSDK-MicrosoftWindows" style="text-align: center;">Microsoft Windows</h3> <h3 id="InstallingtheSDK-MicrosoftWindows" style="text-align: center;">Microsoft Windows</h3>
<ul> <ul>
<li>Windows XP</li> <li>Windows XP</li>
@ -55,7 +53,7 @@ This page last changed on Jun 12, 2013 by xartigas.
</colgroup> </colgroup>
<tbody> <tbody>
<tr class="odd"> <tr class="odd">
<td><p><a href="Installing%2Bfor%2BAndroid%2Bdevelopment.html"><img src="attachments/327700/2654239.png" class="confluence-embedded-image image-center" /></a></p> <td><p><a href="Installing%2Bfor%2BAndroid%2Bdevelopment.html"><img src="attachments/2654239.png" class="confluence-embedded-image image-center" /></a></p>
<h3 id="InstallingtheSDK-Android" style="text-align: center;">Android</h3> <h3 id="InstallingtheSDK-Android" style="text-align: center;">Android</h3>
<ul> <ul>
<li>2.3.1 Gingerbread and above</li> <li>2.3.1 Gingerbread and above</li>
@ -65,7 +63,7 @@ This page last changed on Jun 12, 2013 by xartigas.
<span style="color: rgb(255,255,255);"><br /> <span style="color: rgb(255,255,255);"><br />
</span> </span>
</div></td> </div></td>
<td><p><a href="Installing%2Bfor%2BiOS%2Bdevelopment.html"><img src="attachments/327700/3539150.jpeg" class="confluence-embedded-image image-center" /></a></p> <td><p><a href="Installing%2Bfor%2BiOS%2Bdevelopment.html"><img src="attachments/3539150.jpeg" class="confluence-embedded-image image-center" /></a></p>
<h3 id="InstallingtheSDK-iOS" style="text-align: center;">iOS</h3> <h3 id="InstallingtheSDK-iOS" style="text-align: center;">iOS</h3>
<ul> <ul>
<li>iOS 6 and above</li> <li>iOS 6 and above</li>
@ -81,19 +79,3 @@ This page last changed on Jun 12, 2013 by xartigas.
The installation instructions are different depending on your platform. The installation instructions are different depending on your platform.
Please select the appropriate one by clicking on its logo. Please select the appropriate one by clicking on its logo.
## Attachments:
![](images/icons/bullet_blue.gif)
[lin200px.png](attachments/327700/1540162.png) (image/png)
![](images/icons/bullet_blue.gif)
[mac200px.png](attachments/327700/1540163.png) (image/png)
![](images/icons/bullet_blue.gif)
[win200px.png](attachments/327700/1540164.png) (image/png)
![](images/icons/bullet_blue.gif)
[andr200px.png](attachments/327700/2654239.png) (image/png)
![](images/icons/bullet_blue.gif)
[ios200px.jpeg](attachments/327700/3539150.jpeg) (image/jpeg)
Document generated by Confluence on Oct 08, 2015 10:27

7
Tutorials.markdown
View file

@ -1,6 +1,4 @@
# GStreamer SDK documentation : Tutorials # Tutorials
This page last changed on Jun 12, 2013 by xartigas.
# Welcome to the GStreamer SDK Tutorials\! # Welcome to the GStreamer SDK Tutorials\!
@ -88,6 +86,3 @@ purposes. All the files are hosted
at [docs.gstreamer.com](http://docs.gstreamer.com). at [docs.gstreamer.com](http://docs.gstreamer.com).
- [Sintel, the Durian Open Movie Project](http://www.sintel.org/) - [Sintel, the Durian Open Movie Project](http://www.sintel.org/)
Document generated by Confluence on Oct 08, 2015 10:27

0
attachments/1540148.png → attachments/WindowsInstall-BuildSolution.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 418 B

After

Width:  |  Height:  |  Size: 418 B

0
attachments/1540165.png → attachments/WindowsInstall-Configuration.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 17 KiB

After

Width:  |  Height:  |  Size: 17 KiB

0
attachments/1540146.png → attachments/WindowsInstall1.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 13 KiB

After

Width:  |  Height:  |  Size: 13 KiB

0
attachments/1540156.png → attachments/WindowsInstall10.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 30 KiB

After

Width:  |  Height:  |  Size: 30 KiB

0
attachments/1540157.png → attachments/WindowsInstall11.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 40 KiB

After

Width:  |  Height:  |  Size: 40 KiB

0
attachments/1540147.png → attachments/WindowsInstall2.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 65 KiB

After

Width:  |  Height:  |  Size: 65 KiB

0
attachments/1540149.png → attachments/WindowsInstall3.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 25 KiB

After

Width:  |  Height:  |  Size: 25 KiB

0
attachments/1540150.png → attachments/WindowsInstall4.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 33 KiB

After

Width:  |  Height:  |  Size: 33 KiB

0
attachments/1540151.png → attachments/WindowsInstall5.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 42 KiB

After

Width:  |  Height:  |  Size: 42 KiB

0
attachments/1540152.png → attachments/WindowsInstall6.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 29 KiB

After

Width:  |  Height:  |  Size: 29 KiB

0
attachments/1540153.png → attachments/WindowsInstall7.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 42 KiB

After

Width:  |  Height:  |  Size: 42 KiB

0
attachments/1540154.png → attachments/WindowsInstall8.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 47 KiB

After

Width:  |  Height:  |  Size: 47 KiB

0
attachments/1540155.png → attachments/WindowsInstall9.png
View file

Side by side Swipe Overlay

Before

Width:  |  Height:  |  Size: 26 KiB

After

Width:  |  Height:  |  Size: 26 KiB

1
sitemap.txt
View file

@ -2,7 +2,6 @@ Home.markdown
Installing+the+SDK.markdown Installing+the+SDK.markdown
Installing+for+Android+development.markdown Installing+for+Android+development.markdown
Installing+for+iOS+development.markdown Installing+for+iOS+development.markdown
Installing+on+Linux.markdown
Installing+on+Mac+OS+X.markdown Installing+on+Mac+OS+X.markdown
Installing+on+Windows.markdown Installing+on+Windows.markdown
Building+from+source+using+Cerbero.markdown Building+from+source+using+Cerbero.markdown