Building Opal on Windows

Introduction

Prerequisites

Download and install the OPAL source code

Open the opal_2017.sln solution file

Configure directories

Build the OPAL Static project

Build the OPAL_dll project

Build the samples

Build the codec plugins

You may need to add the following directories to environment variables:

Note: if the installdir\OPAL and installdir\PTLIB, use the same installdir, then you do not need to set the above or set the PTLib environment variables to build OPAL.

1. Build the codec plug ins

This document provides instructions for building PTLib with Visual Studio on Windows.

If you are using Visual Studio 2013, open the opal_2013.sln solution file.

If you are using Visual Studio 2012, open the opal_2012.sln solution file.

If you are using Visual Studio 2010, open the opal_2010.sln solution file.

While not always necessary, you may add the following directories to environment variables:

    * Add installdir\OPAL\LIB to the PATH environment variable
    * Add installdir\OPAL\INCLUDE to the INCLUDE environment variable
    * Add installdir\OPAL\LIB to the LIB environment variable

The OPAL Static project must be built before building Opal_dll. This should happen automatically through the solution file dependencies, if something goes wrong you can do it manually to be sure.

To build some of the samples you may open open the opal_samples_XXXX.sln solution file. There a number of sample and utility applications here that may be compiled as you desire.

9. Build the codec plugins

To build some of the codec plugins you may open open the installdir\OPAL\plugins\plugins_XXXX.sln solution file. There a large number of codecs available, some of which will require third party libraries to build. Consult the various ReadMe.txt files in those codecs sub-directories.

The most important third party library is FFMPEG, instructions for using this is contained in installdir\OPAL\plugins\video\common\ReadMe.txt.

Support for MSVC 6 and DevStudio 2003 is no longer maintained as they are very old and MSVC 6 in particular contains bugs that cause many problems. While Windows 2000 may work for builds and running executables, it is expected that at least Windows XP would be used and no gurantees are made the future versions.

• VS.net 2005, VS.net 2008, Visual C++ 2008 Express Edition, Visual Studio 2010 or Visual C++ 2010 Express Edition.

If you are using VS 2010, open the opal_2010.sln solution file.

• A compiled PTLib installation (see Compiling PTLib)

The OPAL source may be downloaded as a ZIP file from the SourceForge download page or you may download it using Subversion

Note: for Windows Mobile, make sure you also set those platforms, see Notes on Windows Mobile

1. Download and install the OPAL source code

1. Build the OPAL Static project
2. Build the OPAL_dll project
3. Build the samples

This document provides a thorough description of the building PTLib for Visual Studio on Windows.

Support for MSVC 6 is no longer maintained as it is very old and contains bugs that cause many problems. While Windows 2000 may work for builds and running executables, it is expected that at least Windows XP would be used and no gurantees are made the future versions.

• VS.net 2003, VS.net 2005, Visual C++ 2005 Express Edition, VS.net 2008 or Visual C++ 2008 Express Edition.
  • Note that you cannot use the free VS.net 2003 available from Microsoft as building without the IDE is not supported.
• If using SVN download, Tortoise SVN is highly recommended.
• There are a number of optional downloads for extra features, for example SRTP. OPAL will automatically detect if these are installed and compile the system accordingly.

The OPAL source may be downloaded as a ZIP file from the SourceForge download page or you may download it using Subversion

If you are using VS.net 2008, open the opal_2008.sln solution file.

Once Visual Studio is started, select "Tools" from the "Options" menu, then open the "Projects and Solutions" element in the tree on the left, and finally select the "VC++ Directories" entry. Add the following directories settings:

6. Build the OPAL Static project

Build the OPAL Static project to create a static code library containing all of the OPAL code.

7. Build the OPAL_dll project

The OPAL Static project must be built before building Opal_dll. Thist should happen automatically through the solution file dependencies, if something goes wrong you can do it manually to be sure.

Build the OPAL_dll project to create a DLL code library containing all of the Opal code.

8. Build the samples

To build some of the samples you may open open the opal_samples_XXXX.sln solution file, where XXX is 2003, 2005 or 2008 as appropriate. There a number of sample and utility applications here that may be compiled as you desire.

as it is very old and contains many bugs that cause problems in many circumstances

Build the Opal Static project to create a static code library containing all of the Opal code. In Release mode, this will build the opals.lib file. In Debug mode, this will build the opalsd.lib file.

The Opal Static project must be built before building Opal_dll.

In Release mode, this will build the opal.dll file. In Debug mode, this will build the opald.dll file.

2. Prerequisites

3. Download and install the OPAL source code

(:title Building Opal on Windows:)

Contents

1. Introduction
2. Prerequisites
3. Download and install the Opal source code
4. Open the solution file
5. Configure directories
6. Build the Opal Static project
7. Build the Opal_dll project

1. Introduction

1. Introduction

This document describes how to build Opal using VS.net 2003 and VS.net 2005. Support for MSVC 6 is no longer maintained as it is very old and contains many bugs that may cause problems in some circumstances

2. Prerequisites

You will need the following:

• A compiled PTLib installation (see Compiling PTLib)
• VS.net 2003, VS.net 2005 or Visual C++ 2005 Express Edition.

Note that you cannot use the VS.net 2003 available from Microsoft as building without the IDE is not supported. Visual C++ 2005 Expresss Edition is supported (follow the instructions for VS.net 2005)

• A copy of the Opal source archive from the SourceForge download page or from Subversion
• An unzip program such as WinZIP

3. Download and install the OPAL source code

Download and extract the OPAL source code. For the purposes of this document, the directory that contains Opal will be indicated as installdir\OPAL

For the purposes of this document, the directory that contains OPAL will be indicated as installdir\OPAL

4. Open the solution file

If you are using VS.net 2003, open the opal.sln solution file.

If you are using VS.net 2005, open the opal_2005.sln solution file.

The solution contain the following projects:

• OPAL Static
• OPAL_dll
• PTLib DLL
• PTLib Static
• Simple OPAL DLL
• Simple OPAL Static

5. Configure directories

Select "Tools" from the "Options" menu, and add the following directories settings as required

    * Add installdir\OPAL\INCLUDE to the Include directory list
    * Add installdir\OPAL\LIB to the Executable directory list
    * Add installdir\OPAL\LIB to the Library directory list

6. Build the Opal Static project

Build the Opal Static project to create a static code library containing all of the PTLib code.

7. Build the Opal_dll project

Build the Opal_dll project to create a DLL code library containing all of the Opal code. The Opal Static project must be built first.