mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2025-02-22 14:06:23 +00:00
Ported Cerbero/Install/build section to markdown
This commit is contained in:
Olivier Crête
parent
3e540917bd
commit
055fc95e04
22 changed files with 246 additions and 565 deletions
|
|
@ -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.
|
||||
> 
|
||||
> This section is intended for advanced users.</p></td>
|
||||
|
||||
<table>
|
||||
<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
|
||||
## Build requirements
|
||||
|
||||
The GStreamer SDK build system provides bootstrapping facilities for all
|
||||
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.
|
||||
- git
|
||||
|
||||
<table>
|
||||
<tbody>
|
||||
<tr class="odd">
|
||||
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td>
|
||||
<td><strong>Windows users</strong><br />
|
||||
> 
|
||||
> **Windows users**
|
||||
>
|
||||
> 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.
|
||||
>
|
||||
> 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 "Checkout as-is, Commit as-is" 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 "Add CMake in system path for the current user")
|
||||
> - [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 "Checkout as-is, Commit as-is" 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 "Add CMake in system path for the current user")</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 "export PATH=\"\$PATH:/c/Python27:/c/Git/bin\"" >> ~/.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>
|
||||
<tbody>
|
||||
<tr class="odd">
|
||||
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td>
|
||||
<td><strong>OS X users</strong><br />
|
||||
> 
|
||||
> **OS X users**
|
||||
>
|
||||
>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".
|
||||
|
||||
<p>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".</p></td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
<table>
|
||||
<tbody>
|
||||
<tr class="odd">
|
||||
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td>
|
||||
<td><strong>iOS developers</strong><br />
|
||||
> 
|
||||
> **iOS developers**
|
||||
>
|
||||
>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.
|
||||
|
||||
<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>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
Download the sources
|
||||
## Download the sources
|
||||
|
||||
To build the GStreamer SDK, you first need to download **Cerbero**.
|
||||
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:
|
||||
|
||||
``` 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
|
||||
|
|
@ -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
|
||||
`./cerbero-uninstalled` in the next steps.
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
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
|
||||
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
|
||||
cloned/unpacked Cerbero and type:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
cerbero bootstrap
|
||||
```
|
||||
cerbero bootstrap
|
||||
```
|
||||
|
||||
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 GStreamer SDK.
|
||||
|
||||
#### Build the SDK
|
||||
## Build the SDK
|
||||
|
||||
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
|
||||
|
|
@ -138,7 +115,7 @@ your distribution at the Cerbero source directory.
|
|||
|
||||
A list of supported packages to build can be retrieved using:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
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
|
||||
defined as individual recipes and can be listed with:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
cerbero list
|
||||
```
|
||||
|
||||
To build an individual recipe and its dependencies, do the following:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
cerbero build <recipe_name>
|
||||
```
|
||||
|
||||
Or to build or force a rebuild of a recipe without building its
|
||||
dependencies use:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
cerbero buildone <recipe_name>
|
||||
```
|
||||
|
||||
To wipe everything and start from scratch:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
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`
|
||||
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
|
||||
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
|
||||
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
|
||||
SDK's development files as explained in [Installing the
|
||||
SDK](Installing%2Bthe%2BSDK.html).
|
||||
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
|
||||
SDK's development files as explained in [Installing the
|
||||
SDK](Installing+the+SDK.markdown).
|
||||
|
||||
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
|
||||
must change this prefix to use its installation directory. This can be
|
||||
done with a custom configuration file named *custom.cbc*:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
# For Windows x86
|
||||
prefix='/c/gstreamer-sdk/0.10/x86/'
|
||||
|
||||
prefix='/c/gstreamer/1.0/x86/'
|
||||
|
||||
# For Windows x86_64
|
||||
#prefix='/c/gstreamer-sdk/0.10/x86_64'
|
||||
|
||||
#prefix='/c/gstreamer/1.0/x86_64'
|
||||
|
||||
# For Linux
|
||||
#prefix='/opt/gstreamer-sdk'
|
||||
|
||||
#prefix='/opt/gstreamer'
|
||||
|
||||
# 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
|
||||
you fix it before, for instance with:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
$ 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
|
||||
command:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
$ cerbero -c custom.cbc shell
|
||||
```
|
||||
|
||||
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:
|
||||
|
||||
``` 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
|
||||
$ sh autogen.sh --disable-gtk-doc --prefix=<prefix>
|
||||
$ 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
|
||||
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
|
||||
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
|
||||
configuration file `config/cross-android.cbc`. Replace all the previous
|
||||
commands with:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
cerbero -c config/cross-android.cbc <command>
|
||||
```
|
||||
|
||||
##### Windows
|
||||
#### Windows
|
||||
|
||||
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
|
||||
|
|
@ -257,24 +232,21 @@ only be created from Windows.
|
|||
|
||||
Replace all the above commands for Windows 32bits with:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
cerbero -c config/cross-win32.cbc <command>
|
||||
```
|
||||
|
||||
Or with using the following for Windows 64bits:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
cerbero -c config/cross-win64.cbc <command>
|
||||
```
|
||||
|
||||
##### iOS
|
||||
#### iOS
|
||||
|
||||
To cross compile for iOS from OS X, use the configuration file
|
||||
`config/cross-ios-universal.cbc`. Replace all previous commands with:
|
||||
|
||||
``` theme: Default; brush: cpp; gutter: false
|
||||
```
|
||||
cerbero -c config/cross-ios-universal.cbc <command>
|
||||
```
|
||||
|
||||
Document generated by Confluence on Oct 08, 2015 10:27
|
||||
|
||||
|
|
|
|||
|
|
@ -59,8 +59,7 @@ Commercial support, bug reporting...</td>
|
|||
|
||||
## Attachments:
|
||||
|
||||
|
||||
[download.png](attachments/327688/2424858.png) (image/png)
|
||||
[download.png](attachments/2424858.png)
|
||||
|
||||
[tutorials.png](attachments/327688/2424859.png) (image/png)
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
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
|
||||
version 9 or higher.
|
||||
|
||||
Optionally, you can use the [Eclipse
|
||||
IDE](http://www.eclipse.org/eclipse/). As stated in the Android
|
||||
documentation, *developing in Eclipse with ADT is highly recommended and
|
||||
is the fastest way to get started*. If you plan to use the Eclipse IDE:
|
||||
Optionally, you can use the [Android Studio] (FIX LINK). As stated in the Android
|
||||
documentation, *developing in Android Studio is highly recommended and
|
||||
is the fastest way to get started*.
|
||||
|
||||
- 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
|
||||
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
|
||||
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
|
||||
application. The Release variant is what you will use to produce the
|
||||
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
|
||||
same content)
|
||||
|
||||
<table>
|
||||
<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>
|
||||
### Debug variant
|
||||
|
||||
<table>
|
||||
<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>
|
||||
FIXME: Link to download files
|
||||
|
||||
If you intend to build the tutorials in this same folder, make sure you
|
||||
have writing permissions.
|
||||
|
||||
FIXME: Is this all TRUE ?
|
||||
|
||||
In the process of building GStreamer-enabled Android applications, some
|
||||
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
|
||||
|
|
@ -105,16 +65,9 @@ Windows).
|
|||
- Point `GSTREAMER_SDK_ROOT_ANDROID` to the folder where you unzipped
|
||||
the SDK.
|
||||
|
||||
<table>
|
||||
<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>
|
||||
>  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.
|
||||
|
||||
# Configure your development environment
|
||||
## Configure your development environment
|
||||
|
||||
There are two routes to use GStreamer in an Android application: Either
|
||||
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
|
||||
followed:
|
||||
|
||||
Using Eclipse (Click to expand)
|
||||
#### Using Eclipse
|
||||
|
||||
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
|
||||
|
|
@ -154,13 +107,12 @@ File → New → Project… → Android Project from Existing
|
|||
Code, and select the folder called `android-tutorial-1`.
|
||||
|
||||
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.
|
||||
|
||||
Provide native development support by activating the NDK plugin:
|
||||
Right-click on the project in the Project Explorer (this should be the
|
||||
top-most folder,
|
||||
called `com.gst_sdk_tutorials.tutorial_1.Tutorial1`) → Android
|
||||
top-most folder, called `com.gst_sdk_tutorials.tutorial_1.Tutorial1`) → Android
|
||||
tools → Add Native Support… Here the NDK plugin asks for a library name.
|
||||
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
|
||||
OpenGL ES).
|
||||
|
||||
Using the command line (Click to
|
||||
expand)
|
||||
#### Using the command line
|
||||
|
||||
<table>
|
||||
<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>
|
||||
>  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)
|
||||
|
||||
For each tutorial, move to its folder and run:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
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
|
||||
command:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
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:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
ndk-build
|
||||
```
|
||||
|
||||
|
|
@ -224,13 +168,13 @@ methods.
|
|||
|
||||
Finally, compile the Java code with:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
ant debug
|
||||
```
|
||||
|
||||
And install on the device with:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
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
|
||||
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>
|
||||
<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&can=2&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>
|
||||
</tbody>
|
||||
</table>
|
||||
>  Windows linkage problems
|
||||
>
|
||||
> 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.
|
||||
>
|
||||
> 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&can=2&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
|
||||
|
||||
|
|
@ -271,7 +210,7 @@ project, and its barebones structure (as auto-generated by Eclipse) is:
|
|||
|
||||
**Android.mk**
|
||||
|
||||
``` theme: Default; brush: plain; gutter: true
|
||||
```
|
||||
LOCAL_PATH := $(call my-dir)
|
||||
|
||||
include $(CLEAR_VARS)
|
||||
|
|
@ -290,7 +229,7 @@ Adding GStreamer support only requires adding these lines:
|
|||
|
||||
**Android.mk with GStreamer support**
|
||||
|
||||
``` theme: Default; brush: plain; gutter: true
|
||||
```
|
||||
LOCAL_PATH := $(call my-dir)
|
||||
|
||||
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,
|
||||
and used as follows:
|
||||
|
||||
``` theme: Default; brush: plain; gutter: false
|
||||
```
|
||||
include $(GSTREAMER_NDK_BUILD_PATH)/plugins.mk
|
||||
GSTREAMER_PLUGINS := $(GSTREAMER_PLUGINS_CORE) $(GSTREAMER_PLUGINS_CODECS) playbin souphttpsrc
|
||||
```
|
||||
|
||||
List of categories and included
|
||||
plugins (Click to expand)
|
||||
#### List of categories and included plugins
|
||||
|
||||
<table>
|
||||
<thead>
|
||||
<tr class="header">
|
||||
<tr>
|
||||
<th>Category</th>
|
||||
<th>Included plugins</th>
|
||||
</tr>
|
||||
</thead>
|
||||
<tbody>
|
||||
<tr class="odd">
|
||||
<tr>
|
||||
<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 class="even">
|
||||
<tr>
|
||||
<td><code>GSTREAMER_PLUGINS_PLAYBACK</code></td>
|
||||
<td><code>decodebin2 playbin</code></td>
|
||||
<td>decodebin playbin</td>
|
||||
</tr>
|
||||
<tr class="odd">
|
||||
<tr>
|
||||
<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 class="even">
|
||||
<tr>
|
||||
<td><code>GSTREAMER_PLUGINS_VIS</code></td>
|
||||
<td><code>libvisual goom goom2k1 audiovisualizers</code></td>
|
||||
<td>libvisual goom goom2k1 audiovisualizers</td>
|
||||
</tr>
|
||||
<tr class="odd">
|
||||
<tr>
|
||||
<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 class="even">
|
||||
<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 class="odd">
|
||||
<td><code>GSTREAMER_PLUGINS_CODECS_GPL</code></td>
|
||||
<td><code>assrender</code></td>
|
||||
<td>assrender</td>
|
||||
</tr>
|
||||
<tr class="even">
|
||||
<td><code>GSTREAMER_PLUGINS_SYS</code></td>
|
||||
<td><code>eglglessink opensles amc</code></td>
|
||||
<td>eglglessink opensles amc</td>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
|
||||
Build and run your application as explained in the **Building the
|
||||
tutorials** section.
|
||||
|
||||
Document generated by Confluence on Oct 08, 2015 10:27
|
||||
|
||||
Build and run your application as explained in the **Building the tutorials** section.
|
||||
|
|
|
|||
|
|
@ -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
|
||||
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
|
||||
recommend taking a look at the available documentation at Apple's
|
||||
website.
|
||||
[This](http://developer.apple.com/library/ios/#DOCUMENTATION/iPhone/Conceptual/iPhone101/Articles/00_Introduction.html)
|
||||
can be a good starting point.
|
||||
[This](http://developer.apple.com/library/ios/#DOCUMENTATION/iPhone/Conceptual/iPhone101/Articles/00_Introduction.html) can be a good starting point.
|
||||
|
||||
# Download and install the SDK
|
||||
|
||||
The GStreamer SDK installer can be found at:
|
||||
|
||||
<table>
|
||||
<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>
|
||||
**FIXME: Add links**
|
||||
|
||||
<table>
|
||||
<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>
|
||||
>  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.
|
||||
|
||||
Double click the package file and follow the instructions presented by
|
||||
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
|
||||
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
|
||||
C for some parts), but this should cause no problems as those languages
|
||||
|
|
@ -76,8 +50,8 @@ example.
|
|||
### Building the tutorials
|
||||
|
||||
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
|
||||
place.** **We recommend that you open the project in Xcode, take a look
|
||||
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
|
||||
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
|
||||
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
|
||||
use:
|
||||
|
||||
``` theme: Default; brush: cpp; gutter: false
|
||||
#include <GStreamer/gst/gst.h>
|
||||
```
|
||||
#include <GStreamer/gst/gst.h>
|
||||
```
|
||||
|
||||
instead of the usual:
|
||||
|
||||
``` theme: Default; brush: cpp; gutter: false
|
||||
```
|
||||
#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
|
||||
ready to build and run. All necessary infrastructure is already in
|
||||
place. To understand what files have been created and how they interact,
|
||||
take a look at the [iOS tutorials](iOS%2Btutorials.html).
|
||||
|
||||
Document generated by Confluence on Oct 08, 2015 10:27
|
||||
take a look at the [iOS tutorials](iOS+tutorials.markdown).
|
||||
|
||||
|
|
|
|||
|
|
@ -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
|
||||
OS X Snow Leopard (10.6) or later and
|
||||
|
|
@ -10,65 +10,37 @@ OS X Snow Leopard (10.6) or later and
|
|||
later.
|
||||
|
||||
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/)
|
||||
|
||||
Installing the SDK for 32-bits platforms requires approximately 145MB of
|
||||
free disk space for the runtime and 193MB for the development files.
|
||||
|
||||
Installing the SDK for 64-bits platforms requires approximately 152MB of
|
||||
free disk space for the runtime and 223MB for the development files.
|
||||
Installing the SDK for 64-bits platforms requires approximately 152MB of
|
||||
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:
|
||||
|
||||
- The runtime files are needed to run GStreamer applications. You
|
||||
probably want to distribute these files with your application (or
|
||||
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.
|
||||
- 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
|
||||
|
||||
Get **both the runtime and the development installers** from here:
|
||||
Get **both the runtime and the development installers** from here:
|
||||
|
||||
<table>
|
||||
<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>
|
||||
** FIXME: Update links **
|
||||
|
||||
<table>
|
||||
<tbody>
|
||||
<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>
|
||||
> 
|
||||
> 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).
|
||||
|
||||
<table>
|
||||
<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>
|
||||
> 
|
||||
> 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.
|
||||
|
||||
The downloads are [Apple Disk Images
|
||||
(.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
|
||||
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
|
||||
versions of the framework
|
||||
- /Library/Frameworks/GStreamer.framework/Versions/Current: link to
|
||||
|
|
@ -91,52 +63,38 @@ useful:
|
|||
gst-launch-0.10
|
||||
|
||||
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
|
||||
|
||||
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
|
||||
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
|
||||
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
|
||||
switch the tutorial to build selecting one of the available schemes.
|
||||
Press the **Run **button to build and run the first tutorial. You can
|
||||
switch the tutorial to build selecting one of the available schemes.
|
||||
|
||||
### Creating new projects
|
||||
|
||||
The GStreamer SDK provides a
|
||||
[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
|
||||
linker option ***-framework GStreamer****.*
|
||||
linker option ***-framework GStreamer****.*
|
||||
|
||||
There is a small exception to the regular use of frameworks, and you
|
||||
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
|
||||
Paths**
|
||||
- GCC: Using the compiler
|
||||
option** -I/Library/Frameworks/GStreamer.framework/Headers**
|
||||
|
||||
## Attachments:
|
||||
|
||||
|
||||
[Configurations.png](attachments/327710/2424835.png) (image/png)
|
||||
|
||||
[Schemes.png](attachments/327710/2424836.png) (image/png)
|
||||
 [Add
|
||||
files.png](attachments/327710/2424837.png) (image/png)
|
||||
 [Project
|
||||
Files.png](attachments/327710/2424838.png) (image/png)
|
||||
|
||||
Document generated by Confluence on Oct 08, 2015 10:27
|
||||
|
||||
option** -I/Library/Frameworks/GStreamer.framework/Headers**
|
||||
|
|
@ -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
|
||||
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.
|
||||
|
||||
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:
|
||||
|
||||
|
|
@ -43,193 +41,139 @@ There are 3 sets of files in the SDK:
|
|||
GStreamer applications.
|
||||
- The [Merge
|
||||
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
|
||||
deployment](Windows%2Bdeployment.html)).
|
||||
|
||||
Get **the Runtime and Development files** installers appropriate for
|
||||
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>
|
||||
<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>
|
||||
**FIXME: Add links **
|
||||
|
||||
> 
|
||||
> 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.
|
||||
|
||||
Execute the installers and choose an installation folder. The suggested
|
||||
default is usually OK.
|
||||
|
||||
<table>
|
||||
<tbody>
|
||||
<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>
|
||||
> 
|
||||
>`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.
|
||||
|
||||
<table>
|
||||
<tbody>
|
||||
<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>
|
||||
|
||||
> 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.
|
||||
|
||||
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_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.
|
||||
|
||||
At runtime, GStreamer will look for its plugins in the following
|
||||
folders:
|
||||
|
||||
- `%HOMEDRIVE%%HOMEFOLDER%/.gstreamer-0.10/plugins`
|
||||
- `C:\gstreamer-sdk\0.10\x86\lib\gstreamer-0.10`
|
||||
- `<location of libgstreamer-0.10-0.dll>\..\lib\gstreamer-0.10`
|
||||
- `%HOMEDRIVE%%HOMEFOLDER%/.gstreamer-1.0/plugins`
|
||||
- `C:\gstreamer\1.0\x86\lib\gstreamer-1.0`
|
||||
- `<location of libgstreamer-1.0-0.dll>\..\lib\gstreamer-1.0`
|
||||
- `%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
|
||||
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
|
||||
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
|
||||
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.
|
||||
|
||||
# Configure your development environment
|
||||
## Configure your development environment
|
||||
|
||||
### Building the tutorials
|
||||
|
||||
The tutorial's code, along with project files and a solution file for
|
||||
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.
|
||||
|
||||
In order to prevent accidental modification of the original code, and to
|
||||
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.
|
||||
|
||||
<table>
|
||||
<tbody>
|
||||
<tr class="odd">
|
||||
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td>
|
||||
<td><strong>64-bit Users</strong><br />
|
||||
|
||||
<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>
|
||||
</tr>
|
||||
</tbody>
|
||||
</table>
|
||||
> 
|
||||
> **64-bit Users**
|
||||
>
|
||||
>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.
|
||||
>
|
||||
>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.
|
||||
>
|
||||
> 
|
||||
|
||||
You can fire up Visual Studio 2010 and load your copy of the
|
||||
`tutorials.sln` solution file (Click on the screen shots to enlarge
|
||||
them).
|
||||
|
||||
`tutorials.sln` solution file (Click on the screen shots to enlarge
|
||||
them).
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
Hit **F7**, press the Build Solution button
|
||||
 or go to Build → Build Solution. All
|
||||
projects should build without problems.
|
||||
 or go to Build →
|
||||
Build Solution. All projects should build without problems.
|
||||
|
||||
### Running the tutorials
|
||||
|
||||
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,
|
||||
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
|
||||
`$(GSTREAMER_SDK_ROOT_X86)``\``bin`
|
||||
`$(GSTREAMER_SDK_ROOT_X86)`\\`bin`
|
||||
|
||||
` `(The `$(...)` notation is required to access environment variables
|
||||
from within Visual Studio. You use the `%...%` notation from Windows
|
||||
(The `$(...)` notation is required to access environment variables
|
||||
from within Visual Studio. You use the `%...%` notation from Windows
|
||||
Explorer)
|
||||
|
||||
You should now be able to run the tutorials.
|
||||
|
||||
|
||||
|
||||
|
||||
### Creating new projects manually
|
||||
|
||||
**If you want to create 64-bit applications, remember also to create x64
|
||||
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
|
||||
|
||||
The included property sheets make creating new projects extremely easy.
|
||||
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
|
||||
Existing Property Sheet...”. Navigate to
|
||||
`%GSTREAMER_SDK_ROOT_X86%``\``share\vs\2010\libs` and
|
||||
load `gstreamer-0.10.props `
|
||||
`%GSTREAMER_SDK_ROOT_X86%`\\`share\vs\2010\libs` and
|
||||
load `gstreamer-1.0.props `
|
||||
|
||||
This property sheet contains the directories where the headers 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.
|
||||
|
||||
**
|
||||
**
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
If you cannot find the Property Manager, you might need to enable Expert
|
||||
Settings. Go to Tools → Settings → Expert Settings. Upon first
|
||||
installation of Visual Studio, Expert Settings are disabled by
|
||||
default.
|
||||
default.
|
||||
|
||||
|
||||
|
||||
|
||||
<table>
|
||||
<tbody>
|
||||
<tr class="odd">
|
||||
<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>
|
||||
<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>
|
||||
|
||||
> 
|
||||
> **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).
|
||||
>
|
||||
> 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.
|
||||
|
||||
#### 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
|
||||
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
|
||||
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
|
||||
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
|
||||
was a regular compressed file (you will need decompression software that
|
||||
understands the ISO format).
|
||||
|
||||
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
|
||||
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
|
||||
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>
|
||||
<tbody>
|
||||
<tr class="odd">
|
||||
<td><img src="images/icons/emoticons/information.png" width="16" height="16" /></td>
|
||||
<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>
|
||||
> 
|
||||
> 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`.
|
||||
>
|
||||
>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.
|
||||
|
||||
### Creating new projects using the wizard
|
||||
|
||||
Go to File → New → Project… and you should find a template
|
||||
named **GStreamer SDK Project**. It takes no parameters, and sets all
|
||||
Go to File → New → Project… and you should find a template
|
||||
named **GStreamer SDK Project**. It takes no parameters, and sets all
|
||||
necessary project settings, both for 32 and 64 bits architectures.
|
||||
|
||||
The generated project file includes the two required Property Sheets
|
||||
described in the previous section, so, in order to link to the correct
|
||||
`MSVCRT.DLL`, **you still need to install the Windows Device Driver
|
||||
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:
|
||||
|
||||
|
||||
[WindowsInstall1.png](attachments/327707/1540146.png) (image/png)
|
||||
|
||||
[WindowsInstall2.png](attachments/327707/1540147.png) (image/png)
|
||||
|
||||
[WindowsInstall-BuildSolution.png](attachments/327707/1540148.png)
|
||||
(image/png)
|
||||
|
||||
[WindowsInstall3.png](attachments/327707/1540149.png) (image/png)
|
||||
|
||||
[WindowsInstall4.png](attachments/327707/1540150.png) (image/png)
|
||||
|
||||
[WindowsInstall5.png](attachments/327707/1540151.png) (image/png)
|
||||
|
||||
[WindowsInstall6.png](attachments/327707/1540152.png) (image/png)
|
||||
|
||||
[WindowsInstall7.png](attachments/327707/1540153.png) (image/png)
|
||||
|
||||
[WindowsInstall8.png](attachments/327707/1540154.png) (image/png)
|
||||
|
||||
[WindowsInstall9.png](attachments/327707/1540155.png) (image/png)
|
||||
|
||||
[WindowsInstall10.png](attachments/327707/1540156.png) (image/png)
|
||||
|
||||
[WindowsInstall11.png](attachments/327707/1540157.png) (image/png)
|
||||
|
||||
[WindowsInstall-Configuration.png](attachments/327707/1540165.png)
|
||||
(image/png)
|
||||
|
||||
Document generated by Confluence on Oct 08, 2015 10:27
|
||||
|
||||
Kit** and change the appropriate property sheets.
|
||||
|
|
@ -1,6 +1,4 @@
|
|||
# GStreamer SDK documentation : Installing the SDK
|
||||
|
||||
This page last changed on Jun 12, 2013 by xartigas.
|
||||
# Installing the SDK
|
||||
|
||||
### Choose your platform
|
||||
|
||||
|
|
@ -12,7 +10,7 @@ This page last changed on Jun 12, 2013 by xartigas.
|
|||
</colgroup>
|
||||
<tbody>
|
||||
<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>
|
||||
<ul>
|
||||
<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>
|
||||
</ul>
|
||||
<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>
|
||||
<ul>
|
||||
<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>
|
||||
</ul>
|
||||
<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>
|
||||
<ul>
|
||||
<li>Windows XP</li>
|
||||
|
|
@ -55,7 +53,7 @@ This page last changed on Jun 12, 2013 by xartigas.
|
|||
</colgroup>
|
||||
<tbody>
|
||||
<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>
|
||||
<ul>
|
||||
<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>
|
||||
</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>
|
||||
<ul>
|
||||
<li>iOS 6 and above</li>
|
||||
|
|
@ -80,20 +78,4 @@ This page last changed on Jun 12, 2013 by xartigas.
|
|||
</table>
|
||||
|
||||
The installation instructions are different depending on your platform.
|
||||
Please select the appropriate one by clicking on its logo.
|
||||
|
||||
## Attachments:
|
||||
|
||||
|
||||
[lin200px.png](attachments/327700/1540162.png) (image/png)
|
||||
|
||||
[mac200px.png](attachments/327700/1540163.png) (image/png)
|
||||
|
||||
[win200px.png](attachments/327700/1540164.png) (image/png)
|
||||
|
||||
[andr200px.png](attachments/327700/2654239.png) (image/png)
|
||||
|
||||
[ios200px.jpeg](attachments/327700/3539150.jpeg) (image/jpeg)
|
||||
|
||||
Document generated by Confluence on Oct 08, 2015 10:27
|
||||
|
||||
Please select the appropriate one by clicking on its logo.
|
||||
|
|
@ -1,6 +1,4 @@
|
|||
# GStreamer SDK documentation : Tutorials
|
||||
|
||||
This page last changed on Jun 12, 2013 by xartigas.
|
||||
# Tutorials
|
||||
|
||||
# Welcome to the GStreamer SDK Tutorials\!
|
||||
|
||||
|
|
@ -87,7 +85,4 @@ authors. In some cases they have been re-encoded for demonstration
|
|||
purposes. All the files are hosted
|
||||
at [docs.gstreamer.com](http://docs.gstreamer.com).
|
||||
|
||||
- [Sintel, the Durian Open Movie Project](http://www.sintel.org/)
|
||||
|
||||
Document generated by Confluence on Oct 08, 2015 10:27
|
||||
|
||||
- [Sintel, the Durian Open Movie Project](http://www.sintel.org/)
|
||||
|
Before Width: | Height: | Size: 418 B After Width: | Height: | Size: 418 B |
|
Before Width: | Height: | Size: 17 KiB After Width: | Height: | Size: 17 KiB |
|
Before Width: | Height: | Size: 13 KiB After Width: | Height: | Size: 13 KiB |
|
Before Width: | Height: | Size: 30 KiB After Width: | Height: | Size: 30 KiB |
|
Before Width: | Height: | Size: 40 KiB After Width: | Height: | Size: 40 KiB |
|
Before Width: | Height: | Size: 65 KiB After Width: | Height: | Size: 65 KiB |
|
Before Width: | Height: | Size: 25 KiB After Width: | Height: | Size: 25 KiB |
|
Before Width: | Height: | Size: 33 KiB After Width: | Height: | Size: 33 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 42 KiB |
|
Before Width: | Height: | Size: 29 KiB After Width: | Height: | Size: 29 KiB |
|
Before Width: | Height: | Size: 42 KiB After Width: | Height: | Size: 42 KiB |
|
Before Width: | Height: | Size: 47 KiB After Width: | Height: | Size: 47 KiB |
|
Before Width: | Height: | Size: 26 KiB After Width: | Height: | Size: 26 KiB |
|
|
@ -2,7 +2,6 @@ Home.markdown
|
|||
Installing+the+SDK.markdown
|
||||
Installing+for+Android+development.markdown
|
||||
Installing+for+iOS+development.markdown
|
||||
Installing+on+Linux.markdown
|
||||
Installing+on+Mac+OS+X.markdown
|
||||
Installing+on+Windows.markdown
|
||||
Building+from+source+using+Cerbero.markdown
|
||||
|
|
|
|||
Loading…
Reference in a new issue