https://wiki.secondlife.com/w/api.php?action=feedcontributions&feedformat=atom&user=Callum+LindenSecond Life Wiki - User contributions [en]2026-05-30T04:39:30ZUser contributionsMediaWiki 1.42.1https://wiki.secondlife.com/w/index.php?title=Build_the_Viewer_on_Windows&diff=1195374Build the Viewer on Windows2015-01-28T20:40:21Z<p>Callum Linden: </p>
<hr />
<div>{{OSWikiContribBox}}<br />
__NOTOC__<br />
=Visual Studio 2013 - Second Life Developer set up=<br />
This "Minimum Requirements recipe" listed below works for both local machines and VMs such as VMWare Fusion.<br />
<br />
This document is mostly complete (see <font color="#ff3333">Todo</font> sections below and has been tested a number of times on bare metal systems. It is expected (and hoped) that developers will improve and refine this process over time - there are still some rough edges and things will change as new versions of software become available.<br />
<br />
{{KBnote|custom=For Lindens Only|See [https://wiki.lindenlab.com/wiki/User:Callum/VS2013_Developer_Setup this page on the internal wiki for specifics of internal use].}}<br />
{{KBcaution|custom=Some Gotchas before we start|<br />
The external package versions and bit-widths listed below have been carefully selected and tested. If you decide to install a different version of a given package (even a minor update), you are on your own.<br />
<br />
This recipe, by design, only covers development using the Cygwin shell - some commands will have to be modified if you want to use the Windows Command Prompt instead.<br />
<br />
You will need at the very least, these items before you begin:<br />
*An installer for Windows 7 Pro 64bit<br />
*A valid Windows Product key<br />
*An installer for Visual Studio 2013<br />
*A valid license for Visual Studio 2013<br />
<br />
Every effort has been made to make this recipe work with the Cygwin shell only. Currently, the "Set up Autobuild and Python" section '''only''' works inside the Windows Command Prompt. ''If you figure out a way to make this work with Cygwin, please let us know.''<br />
<br />
The combination of Cygwin and Tortoise Hg means it is not possible to check out or check into a repository that requires you to enter login credentials. Currently, to do this, you must switch to a Windows Command Prompt. ''Again, if you know how to fix this or have a suggestion for a better package to use, please let us know.''<br />
}}<br />
<br />
=="Minimum Requirements" recipe==<br />
===Windows===<br />
<br />
*Install Windows 7 Pro 64bit using your own product key<br />
<br />
*Keep running Windows Update (Start Menu -> All Programs -> Windows Update) until clicking on "Check for Updates" there tells you everything is up to date. Depending on the age of the install media you started with, this could take a really long time and many, many iterations.<br />
<br />
===Microsoft Visual Studio 2013 Pro===<br />
*Install VS 2013 Pro<br />
* Note: If you don't own a copy of VS 2013 Pro, you might consider installing the the [http://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx Community Version]<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**Uncheck all the "Optional features to install:" - they are not required<br />
<br />
*Download and install VS2013 Service Packs and updates<br />
**[http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_5 Update 4 ] is the most recent '''released''' version at time of writing (2015-01)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
<br />
===DirectX SDK===<br />
*Download and install [http://www.microsoft.com/en-us/download/details.aspx?id=6812 DirectX SDK (June 2010)]<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**At the Installation Options screen, set everything except the DirectX Headers and Libs to "This feature will not be installed"<br />
<br />
===Tortoise Hg===<br />
*Download and install [http://tortoisehg.bitbucket.org/download/ TortoiseHg 3.2.3] (64bit)<br />
**Note: No option available to install as Administrator<br />
**Use default options (path, components etc.)<br />
<br />
===CMake===<br />
*Download and install [http://www.cmake.org/download/ CMake 3.1.0] (32bit is only option)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**At the "Install options" screen, select "Add CMake to the system PATH for all users"<br />
**For everything else, use the default options (path, etc.)<br />
<br />
===Cygwin===<br />
*Download and install [http://cygwin.com/install.html Cygwin 64] (64bit)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**Use default options (path, components etc.) *until* you get to the "Select Packages" screen<br />
**Add additional packages:<br />
***Devel/bison<br />
***Devel/flex<br />
***Devel/patch<br />
**Use default options for everything else<br />
<br />
===Python===<br />
*Download and install [https://www.python.org/ftp/python/2.7.8/python-2.7.8.msi Python 2.7.<font color="red">8</font> (32bit)] (Do '''not''' install version 2.7.9 - it doesn't work for our setup currently])<br />
**Note: No option available to install as Administrator<br />
**Use default options (path, components etc.) *until* you get to the "Customize Python" screen<br />
**Change "Add python.exe to Path" to "Will be installed on local hard drive"<br />
<br />
===Intermediate check===<br />
{{KBnote|custom=Confirm things are installed properly so far|<br />
Open a Cygwin terminal and type:<br />
bison --version<br />
cmake --version<br />
flex --version<br />
hg --version<br />
python --version<br />
If they all report sensible values and not "Command not found" errors, then you are in good shape}}<br />
<br />
===Set up Autobuild and Python===<br />
*Bootstrap pip <br />
** Download (Save As) [https://bootstrap.pypa.io/get-pip.py get-pip.py] and copy to a temp folder<br />
** Open <font color="#660000">Windows Command Prompt</font><br />
** Switch to that temp folder and execute it <code>python get-pip.py</code><br />
** Pip will be installed<br />
*Bootstrap easy_install <br />
** Download (Save As) [https://bootstrap.pypa.io/ez_setup.py ez_setup.py] and copy to a temp folder<br />
** Remain in <font color="#660000">Windows Command Prompt</font><br />
** Switch to that temp folder and execute it <code>python ez_setup.py</code><br />
** easy_install will be installed<br />
*Install Autobuild<br />
** Remain in <font color="#660000">Windows Command Prompt</font><br />
** Change to the Python Scripts folder that was just created<br />
** Typically <code>cd \Python27\Scripts</code><br />
** Run <code>pip install hg+http://bitbucket.org/oz_linden/autobuild-metadata#egg=autobuild</code><br />
** Autobuild will be installed<br />
*Update system PATH<br />
**Add Python Scripts folder to PATH environment variable via the Control Panel<br />
**Typically <code>C:\Python27\Scripts</code><br />
<br />
===NSIS (Unicode)===<br />
* You must install the Unicode version [http://www.scratchpaper.com/ here] and not the one from the NSIS page<br />
* Not strictly required for developers (although it's useful) <br />
<br><br />
===Test build of the Second Life Viewer===<br />
Open a Cygwin shell and create a folder to hold your work<br />
cd /cygdrive/c<br />
mkdir work<br />
cd work<br />
Check out a branch from Mercurial<br />
: Currently this has to be [https://bitbucket.org/lindenlab/viewer-tools-update Viewer Tools Update] but eventually will apply to Viewer Release too.<br />
hg clone https://bitbucket.org/lindenlab/viewer-tools-update<br />
Switch to the directory you just checked out and run Autobuild Configure<br />
cd viewer-tools-update<br />
autobuild configure -c ''RelWithDebInfoOS|ReleaseOS''<br />
{{KBnote|custom=TBD|we need a description here or somewhere on optional configuration switches}}<br />
When that completes, open the VS 2013 solution file that gets created<br />
cygstart build-vc120/SecondLife.sln<br />
Right-click on "secondlife-bin" in the Solution Explorer and select "Build"<br />
: ''wait...''<br />
When the build completes (hopefully without errors) run it by pressing Control-F5<br />
{{KBnote|At some point, this recipe will include steps that facilitate command line builds - for the moment, only option is to use the VS 2013 IDE}}<br />
<br />
==Additional Tools & Settings you might need==<br />
*Tools<br />
** Install and set up hg hooks using [https://wiki.secondlife.com/wiki/Mercurial_Tools instructions]<br />
**:''This arguably should be in the "minimum Requirements" section as it's way to easy to accidentally check in files with Windows line endings. Strongly suggested you install this.''<br />
**Install a Visual Studio helper like [http://www.wholetomato.com/ WholeTomato Visual Assist for VS2013] or [http://workspacewhiz.com/ Workspace Whiz]<br />
**:These extensions to Visual Studio add many great features. Pretty much essential for serious work.<br />
**Install a decent merge tool like [http://www.araxis.com/merge/index.en Araxis Merge] <br />
**:Many free alternatives out there but Araxis is the best (and most expensive)<br />
<br />
[[Category:Open Source]]<br />
[[Category:Compiling viewer]]</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=Build_the_Viewer_on_Windows&diff=1195373Build the Viewer on Windows2015-01-28T20:39:55Z<p>Callum Linden: </p>
<hr />
<div>{{OSWikiContribBox}}<br />
__NOTOC__<br />
=Visual Studio 2013 - Second Life Developer set up=<br />
This "Minimum Requirements recipe" listed below works for both local machines and VMs such as VMWare Fusion.<br />
<br />
This document is mostly complete (see <font color="#ff3333">Todo</font> sections below and has been tested a number of times on bare metal systems. It is expected (and hoped) that developers will improve and refine this process over time - there are still some rough edges and things will change as new versions of software become available.<br />
<br />
{{KBnote|custom=For Lindens Only|See [https://wiki.lindenlab.com/wiki/User:Callum/VS2013_Developer_Setup this page on the internal wiki for specifics of internal use].}}<br />
{{KBcaution|custom=Some Gotchas before we start|<br />
The external package versions and bit-widths listed below have been carefully selected and tested. If you decide to install a different version of a given package (even a minor update), you are on your own.<br />
<br />
This recipe, by design, only covers development using the Cygwin shell - some commands will have to be modified if you want to use the Windows Command Prompt instead.<br />
<br />
You will need at the very least, these items before you begin:<br />
*An installer for Windows 7 Pro 64bit<br />
*A valid Windows Product key<br />
*An installer for Visual Studio 2013<br />
*A valid license for Visual Studio 2013<br />
<br />
Every effort has been made to make this recipe work with the Cygwin shell only. Currently, the "Set up Autobuild and Python" section '''only''' works inside the Windows Command Prompt. ''If you figure out a way to make this work with Cygwin, please let us know.''<br />
<br />
The combination of Cygwin and Tortoise Hg means it is not possible to check out or check into a repository that requires you to enter login credentials. Currently, to do this, you must switch to a Windows Command Prompt. ''Again, if you know how to fix this or have a suggestion for a better package to use, please let us know.''<br />
}}<br />
<br />
=="Minimum Requirements" recipe==<br />
===Windows===<br />
<br />
*Install Windows 7 Pro 64bit using your own product key<br />
<br />
*Keep running Windows Update (Start Menu -> All Programs -> Windows Update) until clicking on "Check for Updates" there tells you everything is up to date. Depending on the age of the install media you started with, this could take a really long time and many, many iterations.<br />
<br />
===Microsoft Visual Studio 2013 Pro===<br />
*Install VS 2013 Pro<br />
* Note: If you don't own a copy of VS 2013 Pro, you might consider installing the the [http://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx Community Version]<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**Uncheck all the "Optional features to install:" - they are not required<br />
<br />
*Download and install VS2013 Service Packs and updates<br />
**[hhttp://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_5 Update 4 ] is the most recent '''released''' version at time of writing (2015-01)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
<br />
===DirectX SDK===<br />
*Download and install [http://www.microsoft.com/en-us/download/details.aspx?id=6812 DirectX SDK (June 2010)]<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**At the Installation Options screen, set everything except the DirectX Headers and Libs to "This feature will not be installed"<br />
<br />
===Tortoise Hg===<br />
*Download and install [http://tortoisehg.bitbucket.org/download/ TortoiseHg 3.2.3] (64bit)<br />
**Note: No option available to install as Administrator<br />
**Use default options (path, components etc.)<br />
<br />
===CMake===<br />
*Download and install [http://www.cmake.org/download/ CMake 3.1.0] (32bit is only option)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**At the "Install options" screen, select "Add CMake to the system PATH for all users"<br />
**For everything else, use the default options (path, etc.)<br />
<br />
===Cygwin===<br />
*Download and install [http://cygwin.com/install.html Cygwin 64] (64bit)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**Use default options (path, components etc.) *until* you get to the "Select Packages" screen<br />
**Add additional packages:<br />
***Devel/bison<br />
***Devel/flex<br />
***Devel/patch<br />
**Use default options for everything else<br />
<br />
===Python===<br />
*Download and install [https://www.python.org/ftp/python/2.7.8/python-2.7.8.msi Python 2.7.<font color="red">8</font> (32bit)] (Do '''not''' install version 2.7.9 - it doesn't work for our setup currently])<br />
**Note: No option available to install as Administrator<br />
**Use default options (path, components etc.) *until* you get to the "Customize Python" screen<br />
**Change "Add python.exe to Path" to "Will be installed on local hard drive"<br />
<br />
===Intermediate check===<br />
{{KBnote|custom=Confirm things are installed properly so far|<br />
Open a Cygwin terminal and type:<br />
bison --version<br />
cmake --version<br />
flex --version<br />
hg --version<br />
python --version<br />
If they all report sensible values and not "Command not found" errors, then you are in good shape}}<br />
<br />
===Set up Autobuild and Python===<br />
*Bootstrap pip <br />
** Download (Save As) [https://bootstrap.pypa.io/get-pip.py get-pip.py] and copy to a temp folder<br />
** Open <font color="#660000">Windows Command Prompt</font><br />
** Switch to that temp folder and execute it <code>python get-pip.py</code><br />
** Pip will be installed<br />
*Bootstrap easy_install <br />
** Download (Save As) [https://bootstrap.pypa.io/ez_setup.py ez_setup.py] and copy to a temp folder<br />
** Remain in <font color="#660000">Windows Command Prompt</font><br />
** Switch to that temp folder and execute it <code>python ez_setup.py</code><br />
** easy_install will be installed<br />
*Install Autobuild<br />
** Remain in <font color="#660000">Windows Command Prompt</font><br />
** Change to the Python Scripts folder that was just created<br />
** Typically <code>cd \Python27\Scripts</code><br />
** Run <code>pip install hg+http://bitbucket.org/oz_linden/autobuild-metadata#egg=autobuild</code><br />
** Autobuild will be installed<br />
*Update system PATH<br />
**Add Python Scripts folder to PATH environment variable via the Control Panel<br />
**Typically <code>C:\Python27\Scripts</code><br />
<br />
===NSIS (Unicode)===<br />
* You must install the Unicode version [http://www.scratchpaper.com/ here] and not the one from the NSIS page<br />
* Not strictly required for developers (although it's useful) <br />
<br><br />
===Test build of the Second Life Viewer===<br />
Open a Cygwin shell and create a folder to hold your work<br />
cd /cygdrive/c<br />
mkdir work<br />
cd work<br />
Check out a branch from Mercurial<br />
: Currently this has to be [https://bitbucket.org/lindenlab/viewer-tools-update Viewer Tools Update] but eventually will apply to Viewer Release too.<br />
hg clone https://bitbucket.org/lindenlab/viewer-tools-update<br />
Switch to the directory you just checked out and run Autobuild Configure<br />
cd viewer-tools-update<br />
autobuild configure -c ''RelWithDebInfoOS|ReleaseOS''<br />
{{KBnote|custom=TBD|we need a description here or somewhere on optional configuration switches}}<br />
When that completes, open the VS 2013 solution file that gets created<br />
cygstart build-vc120/SecondLife.sln<br />
Right-click on "secondlife-bin" in the Solution Explorer and select "Build"<br />
: ''wait...''<br />
When the build completes (hopefully without errors) run it by pressing Control-F5<br />
{{KBnote|At some point, this recipe will include steps that facilitate command line builds - for the moment, only option is to use the VS 2013 IDE}}<br />
<br />
==Additional Tools & Settings you might need==<br />
*Tools<br />
** Install and set up hg hooks using [https://wiki.secondlife.com/wiki/Mercurial_Tools instructions]<br />
**:''This arguably should be in the "minimum Requirements" section as it's way to easy to accidentally check in files with Windows line endings. Strongly suggested you install this.''<br />
**Install a Visual Studio helper like [http://www.wholetomato.com/ WholeTomato Visual Assist for VS2013] or [http://workspacewhiz.com/ Workspace Whiz]<br />
**:These extensions to Visual Studio add many great features. Pretty much essential for serious work.<br />
**Install a decent merge tool like [http://www.araxis.com/merge/index.en Araxis Merge] <br />
**:Many free alternatives out there but Araxis is the best (and most expensive)<br />
<br />
[[Category:Open Source]]<br />
[[Category:Compiling viewer]]</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=Build_the_Viewer_on_Windows&diff=1195368Build the Viewer on Windows2015-01-28T18:16:42Z<p>Callum Linden: </p>
<hr />
<div>{{OSWikiContribBox}}<br />
__NOTOC__<br />
=Visual Studio 2013 - Second Life Developer set up=<br />
This "Minimum Requirements recipe" listed below works for both local machines and VMs such as VMWare Fusion.<br />
<br />
This document is mostly complete (see <font color="#ff3333">Todo</font> sections below and has been tested a number of times on bare metal systems. It is expected (and hoped) that developers will improve and refine this process over time - there are still some rough edges and things will change as new versions of software become available.<br />
<br />
{{KBnote|custom=For Lindens Only|See [https://wiki.lindenlab.com/wiki/User:Callum/VS2013_Developer_Setup this page on the internal wiki for specifics of internal use].}}<br />
{{KBcaution|custom=Some Gotchas before we start|<br />
The external package versions and bit-widths listed below have been carefully selected and tested. If you decide to install a different version of a given package (even a minor update), you are on your own.<br />
<br />
This recipe, by design, only covers development using the Cygwin shell - some commands will have to be modified if you want to use the Windows Command Prompt instead.<br />
<br />
You will need at the very least, these items before you begin:<br />
*An installer for Windows 7 Pro 64bit<br />
*A valid Windows Product key<br />
*An installer for Visual Studio 2013<br />
*A valid license for Visual Studio 2013<br />
<br />
Every effort has been made to make this recipe work with the Cygwin shell only. Currently, the "Set up Autobuild and Python" section '''only''' works inside the Windows Command Prompt. ''If you figure out a way to make this work with Cygwin, please let us know.''<br />
<br />
The combination of Cygwin and Tortoise Hg means it is not possible to check out or check into a repository that requires you to enter login credentials. Currently, to do this, you must switch to a Windows Command Prompt. ''Again, if you know how to fix this or have a suggestion for a better package to use, please let us know.''<br />
}}<br />
<br />
=="Minimum Requirements" recipe==<br />
===Windows===<br />
<br />
*Install Windows 7 Pro 64bit using your own product key<br />
<br />
*When the Windows installer asks for the default username, use <code>sldev</code> and no password. Note: these instructions are trying to be as generic as possible - for local installs on your own machine, you can of course use any username you like.<br />
<br />
*Keep running Windows Update (Start Menu -> All Programs -> Windows Update) until clicking on "Check for Updates" there tells you everything is up to date. Depending on the age of the install media you started with, this could take a really long time and many, many iterations.<br />
<br />
===Microsoft Visual Studio 2013 Pro===<br />
*Install VS 2013 Pro<br />
* Note: If you don't own a copy of VS 2013 Pro, you might consider installing the the [http://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx Community Version]<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**Uncheck all the "Optional features to install:" - they are not required<br />
<br />
*Download and install VS2013 Service Packs and updates<br />
**[http://www.microsoft.com/en-us/download/details.aspx?id=45508 VS 2013 Update 5.2, January 26, 2015] is the most recent at time of writing (2015-01)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
<br />
===DirectX SDK===<br />
*Download and install [http://www.microsoft.com/en-us/download/details.aspx?id=6812 DirectX SDK (June 2010)]<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**At the Installation Options screen, set everything except the DirectX Headers and Libs to "This feature will not be installed"<br />
<br />
===Tortoise Hg===<br />
*Download and install [http://tortoisehg.bitbucket.org/download/ TortoiseHg 3.2.3] (64bit)<br />
**Note: No option available to install as Administrator<br />
**Use default options (path, components etc.)<br />
<br />
===CMake===<br />
*Download and install [http://www.cmake.org/download/ CMake 3.1.0] (32bit is only option)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**At the "Install options" screen, select "Add CMake to the system PATH for all users"<br />
**For everything else, use the default options (path, etc.)<br />
<br />
===Cygwin===<br />
*Download and install [http://cygwin.com/install.html Cygwin 64] (64bit)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**Use default options (path, components etc.) *until* you get to the "Select Packages" screen<br />
**Add additional packages:<br />
***Devel/bison<br />
***Devel/flex<br />
***Devel/patch<br />
**Use default options for everything else<br />
<br />
===Python===<br />
*Download and install [https://www.python.org/ftp/python/2.7.8/python-2.7.8.msi Python 2.7.<font color="red">8</font> (32bit)] (Do '''not''' install version 2.7.9 - it doesn't work for our setup currently])<br />
**Note: No option available to install as Administrator<br />
**Use default options (path, components etc.) *until* you get to the "Customize Python" screen<br />
**Change "Add python.exe to Path" to "Will be installed on local hard drive"<br />
<br />
===Intermediate check===<br />
{{KBnote|custom=Confirm things are installed properly so far|<br />
Open a Cygwin terminal and type:<br />
bison --version<br />
cmake --version<br />
flex --version<br />
hg --version<br />
python --version<br />
If they all report sensible values and not "Command not found" errors, then you are in good shape}}<br />
<br />
===Set up Autobuild and Python===<br />
*Bootstrap pip <br />
** Download (Save As) [https://bootstrap.pypa.io/get-pip.py get-pip.py] and copy to a temp folder<br />
** Open <font color="#660000">Windows Command Prompt</font><br />
** Switch to that temp folder and execute it <code>python get-pip.py</code><br />
** Pip will be installed<br />
*Bootstrap easy_install <br />
** Download (Save As) [https://bootstrap.pypa.io/ez_setup.py ez_setup.py] and copy to a temp folder<br />
** Remain in <font color="#660000">Windows Command Prompt</font><br />
** Switch to that temp folder and execute it <code>python ez_setup.py</code><br />
** easy_install will be installed<br />
*Install Autobuild<br />
** Remain in <font color="#660000">Windows Command Prompt</font><br />
** Change to the Python Scripts folder that was just created<br />
** Typically <code>cd \Python27\Scripts</code><br />
** Run <code>pip install hg+http://bitbucket.org/oz_linden/autobuild-metadata#egg=autobuild</code><br />
** Autobuild will be installed<br />
*Update system PATH<br />
**Add Python Scripts folder to PATH environment variable via the Control Panel<br />
**Typically <code>C:\Python27\Scripts</code><br />
<br />
===NSIS (Unicode)===<br />
* You must install the Unicode version [http://www.scratchpaper.com/ here] and not the one from the NSIS page<br />
* Not strictly required for developers (although it's useful) <br />
<br><br />
===Test build of the Second Life Viewer===<br />
Open a Cygwin shell and create a folder to hold your work<br />
cd /cygdrive/c<br />
mkdir work<br />
cd work<br />
Check out a branch from Mercurial<br />
: Currently this has to be [https://bitbucket.org/lindenlab/viewer-tools-update Viewer Tools Update] but eventually will apply to Viewer Release too.<br />
hg clone https://bitbucket.org/lindenlab/viewer-tools-update<br />
Switch to the directory you just checked out and run Autobuild Configure<br />
cd viewer-tools-update<br />
autobuild configure -c ''RelWithDebInfoOS|ReleaseOS''<br />
{{KBnote|custom=TBD|we need a description here or somewhere on optional configuration switches}}<br />
When that completes, open the VS 2013 solution file that gets created<br />
cygstart build-vc120/SecondLife.sln<br />
Right-click on "secondlife-bin" in the Solution Explorer and select "Build"<br />
: ''wait...''<br />
When the build completes (hopefully without errors) run it by pressing Control-F5<br />
{{KBnote|At some point, this recipe will include steps that facilitate command line builds - for the moment, only option is to use the VS 2013 IDE}}<br />
<br />
==Additional Tools & Settings you might need==<br />
*Tools<br />
** Install and set up hg hooks using [https://wiki.secondlife.com/wiki/Mercurial_Tools instructions]<br />
**:''This arguably should be in the "minimum Requirements" section as it's way to easy to accidentally check in files with Windows line endings. Strongly suggested you install this.''<br />
**Install a Visual Studio helper like [http://www.wholetomato.com/ WholeTomato Visual Assist for VS2013] or [http://workspacewhiz.com/ Workspace Whiz]<br />
**:These extensions to Visual Studio add many great features. Pretty much essential for serious work.<br />
**Install a decent merge tool like [http://www.araxis.com/merge/index.en Araxis Merge] <br />
**:Many free alternatives out there but Araxis is the best (and most expensive)<br />
<br />
[[Category:Open Source]]<br />
[[Category:Compiling viewer]]</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=Build_the_Viewer_on_Windows&diff=1195358Build the Viewer on Windows2015-01-27T20:27:07Z<p>Callum Linden: Created page with "__NOTOC__ =Visual Studio 2013 - Second Life Developer set up= This "Minimum Requirements recipe" listed below works for both local machines and VMs such as VMWare Fusion. <br>..."</p>
<hr />
<div>__NOTOC__<br />
=Visual Studio 2013 - Second Life Developer set up=<br />
This "Minimum Requirements recipe" listed below works for both local machines and VMs such as VMWare Fusion.<br />
<br><br />
This document is mostly complete (see <font color="#ff3333">Todo</font> sections below and has been tested a number of times on bare metal systems. It is expected (and hoped) that developers will improve and refine this process over time - there are still some rough edges and things will change as new versions of software become available.<br />
<br><br />
==<font color="#990000">Some Gotchas before we start</font>==<br />
* The external package versions and bit-widths listed below have carefully been selected and tested. If you decide to install a different version of a given package (even a minor update), you are on your own<br />
* This recipe, by design, only covers development using the Cygwin shell - some commands will have to be modified if you want to use the Windows Command Prompt instead.<br />
* You will need at the very least, these items from before you begin:<br />
**An installer for Windows 7 Pro 64bit<br />
**A valid Windows Product key<br />
**An installer for Visual Studio 2013<br />
**A valid license for Visual Studio 2013<br />
* Every effort has been made to make this recipe work with the Cygwin shell only. Currently, the "Set up Autobuild and Python" section '''only''' works inside the Windows Command Prompt. If you figure out a way to make this work with Cygwin, please let us know.<br />
* The combination of Cygwin and Tortoise Hg means it is not possible to check out or check into a repository that requires you to enter login credentials. Currently, to do this, you must switch to a Windows Command Prompt. Again, if you know how to fix this or have a suggestion for a better package to use, please let us know.<br />
<br><br />
<br />
=="Minimum Requirements" recipe==<br />
===Windows===<br />
<br />
*Install Windows 7 Pro 64bit using your own product key<br />
<br />
*When the Windows installer asks for the default username, use <code>sldev</code> and no password. Note: these instructions are trying to be as generic as possible - for local installs on your own machine, you can of course use any username you like.<br />
<br />
*Keep running Windows Update (Start Menu -> All Programs -> Windows Update) until clicking on "Check for Updates" there tells you everything is up to date. Depending on the age of the install media you started with, this could take a really long time and many, many iterations.<br />
<br />
===Microsoft Visual Studio 2013 Pro===<br />
*Install VS 2013 Pro<br />
* Note: If you don't own a copy of VS 2013 Pro, you might consider installing the the [http://www.visualstudio.com/en-us/news/vs2013-community-vs.aspx Community Version]<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**Uncheck all the "Optional features to install:" - they are not required<br />
<br />
*Download and install VS2013 Service Packs and updates<br />
**[http://www.microsoft.com/en-us/download/details.aspx?id=45508 VS 2013 Update 5.2, January 26, 2015] is the most recent at time of writing (2015-01)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
<br />
===DirectX SDK===<br />
*Download and install [http://www.microsoft.com/en-us/download/details.aspx?id=6812 DirectX SDK (June 2010)]<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**At the Installation Options screen, set everything except the DirectX Headers and Libs to "This feature will not be installed"<br />
<br />
===Tortoise Hg===<br />
*Download and install [http://tortoisehg.bitbucket.org/download/ TortoiseHg 3.2.3] (64bit)<br />
**Note: No option available to install as Administrator<br />
**Use default options (path, components etc.)<br />
<br />
===CMake===<br />
*Download and install [http://www.cmake.org/download/ CMake 3.1.0] (32bit is only option)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**At the "Install options" screen, select "Add CMake to the system PATH for all users"<br />
**For everything else, use the default options (path, etc.)<br />
<br />
===Cygwin===<br />
*Download and install [http://cygwin.com/install.html Cygwin 64] (64bit)<br />
**Run the installer as Administrator (right click, "Run as administrator")<br />
**Use default options (path, components etc.) *until* you get to the "Select Packages" screen<br />
**Add additional packages:<br />
***Devel/bison<br />
***Devel/flex<br />
***Devel/patch<br />
**Use default options for everything else<br />
<br />
===Python===<br />
*Download and install [https://www.python.org/ftp/python/2.7.8/python-2.7.8.msi Python 2.7.<font color="red">8</font> (32bit)] (Do '''not''' install version 2.7.9 - it doesn't work for our setup currently])<br />
**Note: No option available to install as Administrator<br />
**Use default options (path, components etc.) *until* you get to the "Customize Python" screen<br />
**Change "Add python.exe to Path" to "Will be installed on local hard drive"<br />
<br />
===Intermediate check===<br />
*Confirm things are installed properly so far:<br />
**Open a Cygwin terminal and type:<br />
***<code>bison --version</code><br />
***<code>cmake --version</code><br />
***<code>flex --version</code><br />
***<code>hg --version</code><br />
***<code>python --version</code><br />
**If they all report sensible values and not "Command not found" errors, then you are in good shape<br />
<br />
===Set up Autobuild and Python===<br />
*Bootstrap pip <br />
** Download (Save As) [https://bootstrap.pypa.io/get-pip.py get-pip.py] and copy to a temp folder<br />
** Open <font color="#660000">Windows Command Prompt</font><br />
** Switch to that temp folder and execute it <code>python get-pip.py</code><br />
** Pip will be installed<br />
*Bootstrap easy_install <br />
** Download (Save As) [https://bootstrap.pypa.io/ez_setup.py ez_setup.py] and copy to a temp folder<br />
** Remain in <font color="#660000">Windows Command Prompt</font><br />
** Switch to that temp folder and execute it <code>python ez_setup.py</code><br />
** easy_install will be installed<br />
*Install Autobuild<br />
** Remain in <font color="#660000">Windows Command Prompt</font><br />
** Change to the Python Scripts folder that was just created<br />
** Typically <code>cd \Python27\Scripts</code><br />
** Run <code>pip install hg+http://bitbucket.org/oz_linden/autobuild-metadata#egg=autobuild</code><br />
** Autobuild will be installed<br />
*Update system PATH<br />
**Add Python Scripts folder to PATH environment variable via the Control Panel<br />
**Typically <code>C:\Python27\Scripts</code><br />
<br />
===NSIS (Unicode)===<br />
* You must install the Unicode version [http://www.scratchpaper.com/ here] and not the one from the NSIS page<br />
* Not strictly required for developers (although it's useful) <br />
<br><br />
===Test build of the Second Life Viewer===<br />
*Open a Cygwin shell and create a folder to hold your work<br />
** <code>cd /cygdrive/c</code><br />
** <code>mkdir work</code><br />
** <code>cd work</code><br />
* Check out a branch from Mercurial<br />
** Currently this has to be [https://bitbucket.org/lindenlab/viewer-tools-update Viewer Tools Update] but eventually will apply to Viewer Release too.<br />
** <code>hg clone https://bitbucket.org/lindenlab/viewer-tools-update</code><br />
* Switch to the directory you just checked out and run Autobuild Configure<br />
** <code>cd viewer-tools-update</code><br />
** <code>autobuild configure</code><br />
** <font color="#ff3333">Todo:</font> Enumerate configure switches for OSS Community (FMOD, Havok etc.)<br />
* When that completes, open the VS 2013 solution file that gets created<br />
** <code>cygstart build-vc120/SecondLife.sln</code><br />
*Right-click on "secondlife-bin" in the Solution Explorer and select "Build"<br />
*Wait<br />
* When the build completes (hopefully without errors) run it by pressing Control-F5<br />
* Note: At some point, this recipe will include steps that facilitate command line builds - for the moment, only option is to use the VS 2013 IDE<br />
<br><br />
<br />
==Additional Tools & Settings you might need==<br />
*Tools<br />
** Install and set up hg hooks using [https://wiki.secondlife.com/wiki/Mercurial_Tools instructions]<br />
*** This arguably should be in the "minimum Requirements" section as it's wway to easy to accidentally check in files with Windows line endings. Strongly suggested you install this.<br />
**Install a Visual Studio helper like [http://www.wholetomato.com/ WholeTomato Visual Assist for VS2013] or [http://workspacewhiz.com/ Workspace Whiz]<br />
***These extensions to Visual Studio add many great features. Pretty much essential for serious work.<br />
**Install a decent merge tool like [http://www.araxis.com/merge/index.en Araxis Merge] <br />
***Many free alternatives out there but Araxis is the best (and most expensive)</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=1129316LLQtWebKit2010-12-24T00:45:32Z<p>Callum Linden: </p>
<hr />
<div>__NOTOC__<br />
== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using an off-the-shelf version of the [http://qt.nokia.com/ Qt application and UI framework]. It is currently used by the most recent version of the [[Media Rendering Plugin Framework|Media Plugin API]] to render Web content in the Second Life viewer.<br />
<br />
The biggest change in this version of LLQtWebKit is that is can be built against an un-patched version of Qt. The patches that were present before have either been rolled into the main Qt codebase or we have found way to work around them. <br />
<br />
== License ==<br />
LLQtWebKit is released under the [http://www.gnu.org/licenses/gpl-2.0.html GPL V2] license. <br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
Versions built with earlier editions of Qt can be found via appropriate Mercurial tags.<br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [[LLQtWebKit Win32 Build Instructions|here]].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [[LLQtWebKit Mac OSX Build Instructions|here]].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
However, that README-linux.txt is incorrect. Since Qt 4, qmake has the Qt location hardcoded and ignores QTDIR. It is necessary to run the correct qmake (and uic) and therefore to make sure that the correct ones are found <em>first</em> in the PATH. Also, some webpages instruct one that you must set QMAKESPEC to $QTDIR/mkspecs/default.<br />
<br />
Hence, correct instructions are (change '4.6.0' as appropriate for your Qt version):<br />
<br />
<pre><br />
export QTDIR=/usr/local/Trolltech/Qt-4.6.0<br />
export PATH=$QTDIR/bin:$PATH<br />
export QMAKESPEC=$QTDIR/mkspecs/default<br />
</pre><br />
<br />
And then continue as instructed (<code>which qmake</code> and <code>which uic</code> now should show a binary in your QTDIR).<br />
<br />
== Test applications ==<br />
As well as the source code and other files required to build LLQtWebKit, there are a number of applications included in the package that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the platform specific build instructions above.<br />
<br />
* '''qttestapp''' - A simple Qt based, cross platform application that implements a simple Web browser <br />
* '''win32gl''' - A simple Win32 specific application that implements a simple Web browser<br />
* '''testgl''' - A simple GLUT based, cross platform application that implements a simple Web browser<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based, cross platform application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: <code>4.7.1</code><br />
* The version of LLQtWebKit is <code>2.2</code><br />
* The user agent string reported by LLQtWebKit can be modified using the API but is of the form: "<code>Mozilla/5.0 (Windows;U; Windows NT 6.1; en-US) AppleWebKit/533.3 (KHTML, like Gecko, Safari/533.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [[LLMozLib2]] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [[Qt Webkit Win32 Build Instructions|Qt WebKit]] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=1129315LLQtWebKit2010-12-24T00:45:23Z<p>Callum Linden: </p>
<hr />
<div>__NOTOC__<br />
== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using an off-the-shelf version of the [http://qt.nokia.com/ Qt application and UI framework]. It is currently used by the most recent version of the [[Media Rendering Plugin Framework|Media Plugin API]] to render Web content in the Second Life viewer.<br />
<br />
The biggest change in this version of the LLQtWebKit is that is can be built against an un-patched version of Qt. The patches that were present before have either been rolled into the main Qt codebase or we have found way to work around them. <br />
<br />
== License ==<br />
LLQtWebKit is released under the [http://www.gnu.org/licenses/gpl-2.0.html GPL V2] license. <br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
Versions built with earlier editions of Qt can be found via appropriate Mercurial tags.<br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [[LLQtWebKit Win32 Build Instructions|here]].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [[LLQtWebKit Mac OSX Build Instructions|here]].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
However, that README-linux.txt is incorrect. Since Qt 4, qmake has the Qt location hardcoded and ignores QTDIR. It is necessary to run the correct qmake (and uic) and therefore to make sure that the correct ones are found <em>first</em> in the PATH. Also, some webpages instruct one that you must set QMAKESPEC to $QTDIR/mkspecs/default.<br />
<br />
Hence, correct instructions are (change '4.6.0' as appropriate for your Qt version):<br />
<br />
<pre><br />
export QTDIR=/usr/local/Trolltech/Qt-4.6.0<br />
export PATH=$QTDIR/bin:$PATH<br />
export QMAKESPEC=$QTDIR/mkspecs/default<br />
</pre><br />
<br />
And then continue as instructed (<code>which qmake</code> and <code>which uic</code> now should show a binary in your QTDIR).<br />
<br />
== Test applications ==<br />
As well as the source code and other files required to build LLQtWebKit, there are a number of applications included in the package that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the platform specific build instructions above.<br />
<br />
* '''qttestapp''' - A simple Qt based, cross platform application that implements a simple Web browser <br />
* '''win32gl''' - A simple Win32 specific application that implements a simple Web browser<br />
* '''testgl''' - A simple GLUT based, cross platform application that implements a simple Web browser<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based, cross platform application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: <code>4.7.1</code><br />
* The version of LLQtWebKit is <code>2.2</code><br />
* The user agent string reported by LLQtWebKit can be modified using the API but is of the form: "<code>Mozilla/5.0 (Windows;U; Windows NT 6.1; en-US) AppleWebKit/533.3 (KHTML, like Gecko, Safari/533.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [[LLMozLib2]] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [[Qt Webkit Win32 Build Instructions|Qt WebKit]] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=1129314LLQtWebKit Win32 Build Instructions2010-12-24T00:42:47Z<p>Callum Linden: </p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp, Win32GL). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows 7/64 and Qt 4.7.1. It is not known if the same instructions work using other versions of Windows, Microsoft Visual Studio or Qt.<br />
<br />
== Set up ==<br />
* For clarity, these instructions contain references to example paths and directories. Except where noted, you may replace these with ones of your own choosing although it is generally advisable to choose ones without spaces in them.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different archiving tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of '<code>perl</code>' and '<code>patch</code>' are available on your system.<br />
* Download the OpenSSL 0.9.8q tarball from http://openssl.org/source/openssl-0.9.8q.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8q</code><br />
** Note: Different archive tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8q</code> and not <code>C:\openssl-0.9.8q\openssl-0.9.8q</code><br />
** Note: Some archive tools (notably 7-Zip) appear to have issues extracting the files correctly - make sure the header files in the <code>C:\openssl-0.9.8q\include\openssl</code> directory are not zero length before proceeding.<br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\openssl-0.9.8q</code> directory <br />
* Run these commands:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps (this fixes the DLL manifest settings so that they are compatible with the Second Life client build configuration)<br />
** Copy the patch file <code>020-openssl-disable-manifest.patch</code> from the <code>C:\llqtwebkit\patches</code> to <code>C:\openssl-0.9.8q</code><br />
** Run this command:<br />
*** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8q\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.7.1 using Microsoft Visual Studio ==<br />
=== Acquire the Qt 4.7.1 source code ===<br />
* Download the source from here: http://get.qt.nokia.com/qt/source/qt-everywhere-opensource-src-4.7.1.zip<br />
* Extract the contents of the tarball into <code>C:\qt-4.7.1</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\qt-4.7.1</code> and not <code>C:\qt-4.7.1\qt-4.7.1</code> <br />
** Note: using Cygwin's <code>tar</code> command might not work. It may result in an '''Access is Denied''' error when running configure below. If so, try using WinZip, WinRAR or some other tool instead.<br />
<br />
=== Configure Qt build system to disable manifests ===<br />
* Windows manifest files are not required for Qt builds used in the Second Life client.<br />
* Inspect the <code>C:\qt-4.7.1\mkspecs\win32-msvc2005\qmake.conf</code> file and check that the <code>CONFIG</code> entry does not include an <code>embed_manifest_dll</code> entry<br />
* Inspect the <code>C:\qt-4.7.1\mkspecs\win32-msvc2005\qmake.conf</code> file and check that the <code>QMAKE_LFLAGS</code> line contains a <code>/MANIFEST:NO</code> directive.<br />
<br />
=== Configure Qt ===<br />
* If it's not open already, open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\qt-4.7.1</code> directory <br />
* Run this command: <br />
<code>configure -opensource -fast -debug-and-release -no-qt3support -no-phonon -no-phonon-backend -prefix C:\qt-4.7.1 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8q\include -L C:\openssl-0.9.8q\out32dll -opensource -nomake demos -nomake examples</code><br />
* When the license agreement appears, if you agree type <code>y</code> the Enter key<br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\qt-4.7.1</code> directory <br />
* Run this command:<br />
<code>nmake</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt, the release and debug libraries and dlls will be in <code>C:\qt-4.7.1\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8q\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8q\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt-4.7.1\bin</code>)<br />
* Create the file <code>C:\qt-4.7.1\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\qt-4.7.1<br />
set PATH=C:\qt-4.7.1\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\qt-4.7.1\bin\qt-vars.bat"<br />
Start in: C:\qt-4.7.1<br />
* Rename the shortcut to "Qt 4.7.1 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.7.1<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== Win32GL ===<br />
* Edit the path variables at the top of the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code> directory to reflect the location of your OpenSSL, Qt and LLQtWebKit files.<br />
* Run the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code><br />
* Open the <code>C:\llqtwebkit\tests\win32gl\win32gl.sln</code> MSVC solution file<br />
* Select <code>Release</code> configuration<br />
* Update <code>home_url</code> in win32gl.cpp with the correct path to your testpage<br />
* Build and run as normal<br />
<br />
== Win32 Helper batch files ==<br />
* There are some helper batch files for Windows developers that may prove useful. <br />
* You will very likely need to configure settings at the top of each one to match the location of the files and directories on your system.<br />
* They do not do much error checking so make sure you understand the ramifications of any changes you make.<br />
* A useful pattern is to edit them so they only do what you need at that moment - build release LLQtWebKit and release testGL for example - then revert them when you're finished.<br />
<br />
=== Build LLQtWebKit and test apps ===<br />
* Now you have built LLQtWebKit by hand, I'll point out this batch file which does it for you.<br />
* <code>C:\llqtwebkit\make_all.bat</code> is a very simple batch file that will clean and build release and debug versions of LLQtWebKit and then clean and build release version of the test apps (except Win32GL). <br />
* You will need to modify the GL_COMPONENT_DIR variable near the top that sets the location of the GLUT and GLUI build files.<br />
* You almost certainly will want to run this batch file from a Qt command prompt as described above since various Qt directories need to be in the path.<br />
<br />
=== Generate a directory tree compatible with the Second Life client build system ===<br />
* <code>C:\llqtwebkit\copy_llqtwebkit.bat</code> is a batch file that:<br />
** Generates a directory tree containing LLQtWebKit header and libraries along with the necessary Qt run time files that are required by the Second Life client.<br />
** Builds a <code>tar.bz2 </code> archive and associated MD5 sum that can be used in the LLQtWebKit section of the Second Life client <code>install.xml</code> configuration file.<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=1129313LLQtWebKit2010-12-23T22:58:43Z<p>Callum Linden: </p>
<hr />
<div>__NOTOC__<br />
== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using an off-the-shelf version of the [http://qt.nokia.com/ Qt application and UI framework]. It is currently used by the most recent version of the [[Media Rendering Plugin Framework|Media Plugin API]] to render Web content in the Second Life viewer.<br />
<br />
== License ==<br />
LLQtWebKit is released under the [http://www.gnu.org/licenses/gpl-2.0.html GPL V2] license. <br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
Versions built with earlier editions of Qt can be found via appropriate Mercurial tags.<br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [[LLQtWebKit Win32 Build Instructions|here]].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [[LLQtWebKit Mac OSX Build Instructions|here]].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
However, that README-linux.txt is incorrect. Since Qt 4, qmake has the Qt location hardcoded and ignores QTDIR. It is necessary to run the correct qmake (and uic) and therefore to make sure that the correct ones are found <em>first</em> in the PATH. Also, some webpages instruct one that you must set QMAKESPEC to $QTDIR/mkspecs/default.<br />
<br />
Hence, correct instructions are (change '4.6.0' as appropriate for your Qt version):<br />
<br />
<pre><br />
export QTDIR=/usr/local/Trolltech/Qt-4.6.0<br />
export PATH=$QTDIR/bin:$PATH<br />
export QMAKESPEC=$QTDIR/mkspecs/default<br />
</pre><br />
<br />
And then continue as instructed (<code>which qmake</code> and <code>which uic</code> now should show a binary in your QTDIR).<br />
<br />
== Test applications ==<br />
As well as the source code and other files required to build LLQtWebKit, there are a number of applications included in the package that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the platform specific build instructions above.<br />
<br />
* '''qttestapp''' - A simple Qt based, cross platform application that implements a simple Web browser <br />
* '''win32gl''' - A simple Win32 specific application that implements a simple Web browser<br />
* '''testgl''' - A simple GLUT based, cross platform application that implements a simple Web browser<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based, cross platform application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: <code>4.7.1</code><br />
* The version of LLQtWebKit is <code>2.2</code><br />
* The user agent string reported by LLQtWebKit can be modified using the API but is of the form: "<code>Mozilla/5.0 (Windows;U; Windows NT 6.1; en-US) AppleWebKit/533.3 (KHTML, like Gecko, Safari/533.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [[LLMozLib2]] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [[Qt Webkit Win32 Build Instructions|Qt WebKit]] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=1030132LLQtWebKit Win32 Build Instructions2010-09-08T23:03:16Z<p>Callum Linden: /* Configure Qt build system to disable manifests */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp, Win32GL). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 3 and Qt 4.6.0. It is not known if the same instructions work using other versions of Windows, Microsoft Visual Studio or Qt.<br />
<br />
== Set up ==<br />
* For clarity, these instructions contain references to example paths and directories. Except where noted, you may replace these with ones of your own choosing although it is generally advisable to choose ones without spaces in them.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different archiving tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of '<code>perl</code>' and '<code>patch</code>' are available on your system.<br />
* Download the OpenSSL 0.9.8l tarball from http://openssl.org/source/openssl-0.9.8l.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8l</code><br />
** Note: Different archive tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8l</code> and not <code>C:\openssl-0.9.8l\openssl-0.9.8l</code><br />
** Note: Some archive tools (notably 7-Zip) appear to have issues extracting the files correctly - make sure the header files in the <code>C:\openssl-0.9.8l\include\openssl</code> directory are not zero length before proceeding.<br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\openssl-0.9.8l</code> directory <br />
* Run these commands:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps (this fixes the DLL manifest settings so that they are compatible with the Second Life client build configuration)<br />
** Copy the patch file <code>020-openssl-disable-manifest.patch</code> from the <code>C:\llqtwebkit-4.6\patches</code> to <code>C:\openssl-0.9.8l</code><br />
** Run this command:<br />
*** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8l\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.6.0 using Microsoft Visual Studio ==<br />
=== Acquire the Qt 4.6.0 source with our patches ===<br />
* Our clone of Qt is available here: http://gitorious.org/+lindenqt/qt/lindenqt<br />
* Download the source by clicking on the "lindenqt" branch under "Branches:" and then using the "Download lindenqt as tar.gz" link on the right hand side of the page<br />
** It's a large download - over 100MB - so it may take some time<br />
** Alternately, if you prefer you can clone the repository with git using the "clone" link on the page -- details of this are left as an exercise to the reader<br />
* Extract the contents of the tarball into <code>C:\qt-lindenqt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\qt-lindenqt</code> and not <code>C:\qt-lindenqt\qt-lindenqt</code> <br />
** Note: using Cygwin's <code>tar</code> command might not work. It may result in an '''Access is Denied''' error when running configure below. If so, try using WinZip, WinRAR or some other tool instead.<br />
<br />
=== Configure Qt build system to disable manifests ===<br />
* Windows manifest files are not required for Qt builds used in the Second Life client.<br />
* Inspect the <code>C:\qt-lindenqt\mkspecs\win32-msvc2005\qmake.conf</code> file and check that the <code>CONFIG</code> entry does not include an <code>embed_manifest_dll</code> entry<br />
* Inspect the <code>C:\qt-lindenqt\mkspecs\win32-msvc2005\qmake.conf</code> file and check that the <code>QMAKE_LFLAGS</code> line contains a <code>/MANIFEST:NO</code> directive.<br />
<br />
=== Configure Qt ===<br />
* If it's not open already, open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\qt-lindenqt</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -no-phonon -no-phonon-backend -prefix C:\qt-lindenqt -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8l\include -L C:\openssl-0.9.8l\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press the Enter key<br />
* When the license agreement appears, if you agree type <code>y</code> the Enter key<br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\qt-lindenqt</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt, the release and debug libraries and dlls will be in <code>C:\qt-lindenqt\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8l\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8l\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt-lindenqt\bin</code>)<br />
* Create the file <code>C:\qt-lindenqt\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\qt-lindenqt<br />
set PATH=C:\qt-lindenqt\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\qt-lindenqt\bin\qt-vars.bat"<br />
Start in: C:\qt-lindenqt<br />
* Rename the shortcut to "Qt Linden Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.6.0<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== Win32GL ===<br />
* Edit the path variables at the top of the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code> directory to reflect the location of your OpenSSL, Qt and LLQtWebKit files.<br />
* Run the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code><br />
* Open the <code>C:\llqtwebkit\tests\win32gl\win32gl.sln</code> MSVC solution file<br />
* Select <code>Release</code> configuration<br />
* Update <code>home_url</code> in win32gl.cpp with the correct path to your testpage<br />
* Build and run as normal<br />
<br />
== Win32 Helper batch files ==<br />
* There are some helper batch files for Windows developers that may prove useful. <br />
* You will very likely need to configure settings at the top of each one to match the location of the files and directories on your system.<br />
* They do not do much error checking so make sure you understand the ramifications of any changes you make.<br />
* A useful pattern is to edit them so they only do what you need at that moment - build release LLQtWebKit and testGL for example - then revert them when you're finished.<br />
<br />
=== Build LLQtWebKit and test apps ===<br />
* Now you have built LLQtWebKit by hand, I'll point out this batch file which does it for you.<br />
* <code>C:\llqtwebkit\make_all.bat</code> is a very simple batch file that will clean and build release and debug versions of LLQtWebKit and then clean and build release version of the test apps (except Win32GL). <br />
* You will need to modify the GL_COMPONENT_DIR variable near the top that sets the location of the GLUT and GLUI build files.<br />
* You almost certainly will want to run this batch file from a Qt command prompt as described above since various Qt directories need to be in the path.<br />
<br />
=== Generate a directory tree compatible with the Second Life client build system ===<br />
* <code>C:\llqtwebkit\copy_llqtwebkit.bat</code> is a batch file that:<br />
** Generates a directory tree containing LLQtWebKit header and libraries along with the necessary Qt run time files that are required by the Second Life client.<br />
** Builds a <code>tar.bz2 </code> archive and associated MD5 sum that can be used in the LLQtWebKit section of the Second Life client <code>install.xml</code> configuration file.<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=1030043LLQtWebKit Win32 Build Instructions2010-09-08T21:26:39Z<p>Callum Linden: /* Build the open source version of Qt 4.6.0 using Microsoft Visual Studio */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp, Win32GL). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 3 and Qt 4.6.0. It is not known if the same instructions work using other versions of Windows, Microsoft Visual Studio or Qt.<br />
<br />
== Set up ==<br />
* For clarity, these instructions contain references to example paths and directories. Except where noted, you may replace these with ones of your own choosing although it is generally advisable to choose ones without spaces in them.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different archiving tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of '<code>perl</code>' and '<code>patch</code>' are available on your system.<br />
* Download the OpenSSL 0.9.8l tarball from http://openssl.org/source/openssl-0.9.8l.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8l</code><br />
** Note: Different archive tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8l</code> and not <code>C:\openssl-0.9.8l\openssl-0.9.8l</code><br />
** Note: Some archive tools (notably 7-Zip) appear to have issues extracting the files correctly - make sure the header files in the <code>C:\openssl-0.9.8l\include\openssl</code> directory are not zero length before proceeding.<br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\openssl-0.9.8l</code> directory <br />
* Run these commands:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps (this fixes the DLL manifest settings so that they are compatible with the Second Life client build configuration)<br />
** Copy the patch file <code>020-openssl-disable-manifest.patch</code> from the <code>C:\llqtwebkit-4.6\patches</code> to <code>C:\openssl-0.9.8l</code><br />
** Run this command:<br />
*** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8l\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.6.0 using Microsoft Visual Studio ==<br />
=== Acquire the Qt 4.6.0 source with our patches ===<br />
* Our clone of Qt is available here: http://gitorious.org/+lindenqt/qt/lindenqt<br />
* Download the source by clicking on the "lindenqt" branch under "Branches:" and then using the "Download lindenqt as tar.gz" link on the right hand side of the page<br />
** It's a large download - over 100MB - so it may take some time<br />
** Alternately, if you prefer you can clone the repository with git using the "clone" link on the page -- details of this are left as an exercise to the reader<br />
* Extract the contents of the tarball into <code>C:\qt-lindenqt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\qt-lindenqt</code> and not <code>C:\qt-lindenqt\qt-lindenqt</code> <br />
** Note: using Cygwin's <code>tar</code> command might not work. It may result in an '''Access is Denied''' error when running configure below. If so, try using WinZip, WinRAR or some other tool instead.<br />
<br />
=== Configure Qt build system to disable manifests ===<br />
* Windows manifest files are not required for Qt builds used in the Second Life client.<br />
* Inspect the <code>C:\qt-lindenqt\mkspecs\win32-msvc2005\qmake.conf</code> file and check that the <code>QMAKE_LFLAGS</code> line contains a <code>/MANIFEST:NO</code> directive.<br />
<br />
=== Configure Qt ===<br />
* If it's not open already, open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\qt-lindenqt</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -no-phonon -no-phonon-backend -prefix C:\qt-lindenqt -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8l\include -L C:\openssl-0.9.8l\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press the Enter key<br />
* When the license agreement appears, if you agree type <code>y</code> the Enter key<br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\qt-lindenqt</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt, the release and debug libraries and dlls will be in <code>C:\qt-lindenqt\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8l\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8l\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt-lindenqt\bin</code>)<br />
* Create the file <code>C:\qt-lindenqt\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\qt-lindenqt<br />
set PATH=C:\qt-lindenqt\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\qt-lindenqt\bin\qt-vars.bat"<br />
Start in: C:\qt-lindenqt<br />
* Rename the shortcut to "Qt Linden Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.6.0<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== Win32GL ===<br />
* Edit the path variables at the top of the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code> directory to reflect the location of your OpenSSL, Qt and LLQtWebKit files.<br />
* Run the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code><br />
* Open the <code>C:\llqtwebkit\tests\win32gl\win32gl.sln</code> MSVC solution file<br />
* Select <code>Release</code> configuration<br />
* Update <code>home_url</code> in win32gl.cpp with the correct path to your testpage<br />
* Build and run as normal<br />
<br />
== Win32 Helper batch files ==<br />
* There are some helper batch files for Windows developers that may prove useful. <br />
* You will very likely need to configure settings at the top of each one to match the location of the files and directories on your system.<br />
* They do not do much error checking so make sure you understand the ramifications of any changes you make.<br />
* A useful pattern is to edit them so they only do what you need at that moment - build release LLQtWebKit and testGL for example - then revert them when you're finished.<br />
<br />
=== Build LLQtWebKit and test apps ===<br />
* Now you have built LLQtWebKit by hand, I'll point out this batch file which does it for you.<br />
* <code>C:\llqtwebkit\make_all.bat</code> is a very simple batch file that will clean and build release and debug versions of LLQtWebKit and then clean and build release version of the test apps (except Win32GL). <br />
* You will need to modify the GL_COMPONENT_DIR variable near the top that sets the location of the GLUT and GLUI build files.<br />
* You almost certainly will want to run this batch file from a Qt command prompt as described above since various Qt directories need to be in the path.<br />
<br />
=== Generate a directory tree compatible with the Second Life client build system ===<br />
* <code>C:\llqtwebkit\copy_llqtwebkit.bat</code> is a batch file that:<br />
** Generates a directory tree containing LLQtWebKit header and libraries along with the necessary Qt run time files that are required by the Second Life client.<br />
** Builds a <code>tar.bz2 </code> archive and associated MD5 sum that can be used in the LLQtWebKit section of the Second Life client <code>install.xml</code> configuration file.<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=873823LLQtWebKit Win32 Build Instructions2010-04-21T18:44:18Z<p>Callum Linden: /* Build the open source OpenSSL library */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp, Win32GL). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 3 and Qt 4.6.0. It is not known if the same instructions work using other versions of Windows, Microsoft Visual Studio or Qt.<br />
<br />
== Set up ==<br />
* For clarity, these instructions contain references to example paths and directories. Except where noted, you may replace these with ones of your own choosing although it is generally advisable to choose ones without spaces in them.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different archiving tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of '<code>perl</code>' and '<code>patch</code>' are available on your system.<br />
* Download the OpenSSL 0.9.8l tarball from http://openssl.org/source/openssl-0.9.8l.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8l</code><br />
** Note: Different archive tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8l</code> and not <code>C:\openssl-0.9.8l\openssl-0.9.8l</code><br />
** Note: Some archive tools (notably 7-Zip) appear to have issues extracting the files correctly - make sure the header files in the <code>C:\openssl-0.9.8l\include\openssl</code> directory are not zero length before proceeding.<br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\openssl-0.9.8l</code> directory <br />
* Run these commands:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps (this fixes the DLL manifest settings so that they are compatible with the Second Life client build configuration)<br />
** Copy the patch file <code>020-openssl-disable-manifest.patch</code> from the <code>C:\llqtwebkit-4.6\patches</code> to <code>C:\openssl-0.9.8l</code><br />
** Run this command:<br />
*** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8l\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.6.0 using Microsoft Visual Studio ==<br />
=== Acquire the Qt 4.6.0 source with our patches ===<br />
* Our clone of Qt is available here: http://gitorious.org/+lindenqt/qt/lindenqt<br />
* Download the source by clicking on the "lindenqt" branch under "Branches:" and then using the "Download lindenqt as tar.gz" link on the right hand side of the page<br />
** It's a large download - over 100MB - so it may take some time<br />
** Alternately, if you prefer you can clone the repository with git using the "clone" link on the page -- details of this are left as an exercise to the reader<br />
* Extract the contents of the tarball into <code>C:\qt-lindenqt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\qt-lindenqt</code> and not <code>C:\qt-lindenqt\qt-lindenqt</code> <br />
** Note: using Cygwin's <code>tar</code> command might not work. It may result in an '''Access is Denied''' error when running configure below. If so, try using WinZip, WinRAR or some other tool instead.<br />
<br />
=== Configure Qt ===<br />
* If it's not open already, open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\qt-lindenqt</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -no-phonon -no-phonon-backend -prefix C:\qt-lindenqt -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8l\include -L C:\openssl-0.9.8l\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press the Enter key<br />
* When the license agreement appears, if you agree type <code>y</code> the Enter key<br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\qt-lindenqt</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt, the release and debug libraries and dlls will be in <code>C:\qt-lindenqt\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8l\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8l\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt-lindenqt\bin</code>)<br />
* Create the file <code>C:\qt-lindenqt\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\qt-lindenqt<br />
set PATH=C:\qt-lindenqt\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\qt-lindenqt\bin\qt-vars.bat"<br />
Start in: C:\qt-lindenqt<br />
* Rename the shortcut to "Qt Linden Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.6.0<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== Win32GL ===<br />
* Edit the path variables at the top of the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code> directory to reflect the location of your OpenSSL, Qt and LLQtWebKit files.<br />
* Run the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code><br />
* Open the <code>C:\llqtwebkit\tests\win32gl\win32gl.sln</code> MSVC solution file<br />
* Select <code>Release</code> configuration<br />
* Build and run as normal<br />
<br />
== Win32 Helper batch files ==<br />
* There are some helper batch files for Windows developers that may prove useful. <br />
* You will very likely need to configure settings at the top of each one to match the location of the files and directories on your system.<br />
* They do not do much error checking so make sure you understand the ramifications of any changes you make.<br />
* A useful pattern is to edit them so they only do what you need at that moment - build release LLQtWebKit and testGL for example - then revert them when you're finished.<br />
<br />
=== Build LLQtWebKit and test apps ===<br />
* Now you have built LLQtWebKit by hand, I'll point out this batch file which does it for you.<br />
* <code>C:\llqtwebkit\make_all.bat</code> is a very simple batch file that will clean and build release and debug versions of LLQtWebKit and then clean and build release version of the test apps (except Win32GL). <br />
* You will need to modify the GL_COMPONENT_DIR variable near the top that sets the location of the GLUT and GLUI build files.<br />
* You almost certainly will want to run this batch file from a Qt command prompt as described above since various Qt directories need to be in the path.<br />
<br />
=== Generate a directory tree compatible with the Second Life client build system ===<br />
* <code>C:\llqtwebkit\copy_llqtwebkit.bat</code> is a batch file that:<br />
** Generates a directory tree containing LLQtWebKit header and libraries along with the necessary Qt run time files that are required by the Second Life client.<br />
** Builds a <code>tar.bz2 </code> archive and associated MD5 sum that can be used in the LLQtWebKit section of the Second Life client <code>install.xml</code> configuration file.<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Mac_OSX_Build_Instructions&diff=800863LLQtWebKit Mac OSX Build Instructions2010-03-12T22:45:46Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Mac OS X as well as the test applications (testGL and uBrowser). They have been tested using XCode 3.2.1 on Mac OS X 10.6.2.<br />
<br />
== Set up ==<br />
Create a directory you'll use for the build. This can be anywhere you like, but for the purposes of the example I'll use ~/llqtwebkit.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the files in the zip into <code>~/llqtwebkit</code> (this should create the directory <code>~/llqtwebkit/llqtwebkit</code><br />
<br />
== Build the open source version of Qt using XCode ==<br />
=== Acquire the Qt 4.6 source with our patches ===<br />
* Our clone of Qt is available here: http://gitorious.org/+lindenqt/qt/lindenqt<br />
* Download the source by clicking on the "lindenqt" branch under "Branches" and then using the "download as tar.gz" link on the right hand side of the page<br />
** Alternately, if you prefer you can clone the repository with git using the "clone" link on the page -- details of this are left as an exercise to the reader<br />
* Extract the tarball into <code>~/llqtwebkit</code><br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>~/llqtwebkit/qt-lindenqt</code><br />
* Open a terminal window and cd to <code>~/llqtwebkit/qt-lindenqt </code> directory <br />
* run the following commands (we'll use the QTDIR variable in later steps)<br />
export QTDIR=`pwd`<br />
export PATH=$PATH:$QTDIR/bin<br />
<br />
=== Configure Qt ===<br />
* In the terminal window, make sure you're still in the directory <code>~/llqtwebkit/qt-lindenqt </code><br />
* Run the following command:<br />
./configure -platform macx-g++40 -no-framework -fast -no-qt3support -prefix $PWD -static -release -no-xmlpatterns -no-phonon -universal -sdk /Developer/SDKs/MacOSX10.4u.sdk/ -nomake examples -nomake demos -nomake docs -nomake translations<br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>yes</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* In the terminal window, make sure you're still in the directory <code>~/llqtwebkit/qt-lindenqt </code> <br />
* Run this command:<br />
make<br />
* If you're on a multicore machine, you can speed up the build substantially by using the '-j' argument to make, which will cause it to build files in parallel. For example, on a 4-core system, I use:<br />
make -j4<br />
* This takes a little over an hour on a 4-core Mac Pro.<br />
* After building Qt the built libraries will be in <code>~/llqtwebkit/qt-lindenqt/lib</code><br />
* For me, the full build fails with "duplicate symbol _sqlite3_status", but at that point it has already built most of what we need. <br />
* The one additional piece we need is the JavaScriptCore library in Webkit. To build that do the following:<br />
cd $QTDIR/src/3rdparty/webkit/JavaScriptCore<br />
make<br />
<br />
== Build LLQtWebKit ==<br />
* In the terminal window, change to the directory <code>~/llqtwebkit/llqtwebkit</code><br />
* Create a symlink to QTDIR in this directory (this allows the Xcode project to find it easily):<br />
ln -s $QTDIR QTDIR<br />
* Open the <code>llqtwebkit.xcodeproj</code> project with Xcode<br />
* Build the "Release" configuration of the "llqtwebkit" target<br />
* The output of the build is <code>~/llqtwebkit/llqtwebkit/build/Release/libllqtwebkit.dylib</code><br />
** to build the Second Life viewer, this library needs to be copied to <code>{VIEWERSRC}/libraries/universal-darwin/lib_release/</code> and llqtwebkit.h needs to go in <code>{VIEWERSRC}/libraries/include/</code><br />
<br />
== Optional: build testgl ==<br />
testgl is a simple example that uses the OpenGL GLUT toolkit to open a window, and renders web pages to an OpenGL texture using llqtwebkit.<br />
* First, build the llqtwebkit library as described above<br />
* In Terminal, go into the <code>tests/testgl/</code> directory<br />
* Create a symlink to your built version of the llqtwebkit library:<br />
ln -s ../../build/Release/libllqtwebkit.dylib<br />
* run the following commands:<br />
qmake<br />
make<br />
* this should create a 'testgl' binary, which you can run from the terminal window like so:<br />
./testgl<br />
<br />
== Optional: build ubrowser ==<br />
ubrowser is a more complex example that uses the GLUI toolkit to render web pages to OpenGL textures and apply them to various 3d models.<br />
* First, build the llqtwebkit library as described above<br />
* Open the Xcode project at <code>tests/ubrowser/ubrowser.xcodeproj</code><br />
* Build and run using the Xcode UI</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=800853LLQtWebKit Win32 Build Instructions2010-03-12T22:45:11Z<p>Callum Linden: </p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp, Win32GL). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 3 and Qt 4.6.0. It is not known if the same instructions work using other versions of Windows, Microsoft Visual Studio or Qt.<br />
<br />
== Set up ==<br />
* For clarity, these instructions contain references to example paths and directories. Except where noted, you may replace these with ones of your own choosing although it is generally advisable to choose ones without spaces in them.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different archiving tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of '<code>perl</code>' and '<code>patch</code>' are available on your system.<br />
* Download the OpenSSL 0.9.8l tarball from http://openssl.org/source/openssl-0.9.8l.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8l</code><br />
** Note: Different archive tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8l</code> and not <code>C:\openssl-0.9.8l\openssl-0.9.8l</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\openssl-0.9.8l</code> directory <br />
* Run these commands:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps (this fixes the DLL manifest settings so that they are compatible with the Second Life client build configuration)<br />
** Copy the patch file <code>020-openssl-disable-manifest.patch</code> from the <code>llqtwebkit-4.6\patches</code> to <code>C:\openssl-0.9.8l</code><br />
** Run this command:<br />
*** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8l\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.6.0 using Microsoft Visual Studio ==<br />
=== Acquire the Qt 4.6.0 source with our patches ===<br />
* Our clone of Qt is available here: http://gitorious.org/+lindenqt/qt/lindenqt<br />
* Download the source by clicking on the "lindenqt" branch under "Branches:" and then using the "Download lindenqt as tar.gz" link on the right hand side of the page<br />
** It's a large download - over 100MB - so it may take some time<br />
** Alternately, if you prefer you can clone the repository with git using the "clone" link on the page -- details of this are left as an exercise to the reader<br />
* Extract the contents of the tarball into <code>C:\qt-lindenqt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\qt-lindenqt</code> and not <code>C:\qt-lindenqt\qt-lindenqt</code> <br />
** Note: using Cygwin's <code>tar</code> command might not work. It may result in an '''Access is Denied''' error when running configure below. If so, try using WinZip, WinRAR or some other tool instead.<br />
<br />
=== Configure Qt ===<br />
* If it's not open already, open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\qt-lindenqt</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -no-phonon -no-phonon-backend -prefix C:\qt-lindenqt -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8l\include -L C:\openssl-0.9.8l\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press the Enter key<br />
* When the license agreement appears, if you agree type <code>y</code> the Enter key<br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\qt-lindenqt</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt, the release and debug libraries and dlls will be in <code>C:\qt-lindenqt\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8l\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8l\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt-lindenqt\bin</code>)<br />
* Create the file <code>C:\qt-lindenqt\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\qt-lindenqt<br />
set PATH=C:\qt-lindenqt\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\qt-lindenqt\bin\qt-vars.bat"<br />
Start in: C:\qt-lindenqt<br />
* Rename the shortcut to "Qt Linden Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.6.0<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== Win32GL ===<br />
* Edit the path variables at the top of the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code> directory to reflect the location of your OpenSSL, Qt and LLQtWebKit files.<br />
* Run the <code>C:\llqtwebkit\tests\win32gl\copy_files.bat</code><br />
* Open the <code>C:\llqtwebkit\tests\win32gl\win32gl.sln</code> MSVC solution file<br />
* Select <code>Release</code> configuration<br />
* Build and run as normal<br />
<br />
== Win32 Helper batch files ==<br />
* There are some helper batch files for Windows developers that may prove useful. <br />
* You will very likely need to configure settings at the top of each one to match the location of the files and directories on your system.<br />
* They do not do much error checking so make sure you understand the ramifications of any changes you make.<br />
* A useful pattern is to edit them so they only do what you need at that moment - build release LLQtWebKit and testGL for example - then revert them when you're finished.<br />
<br />
=== Build LLQtWebKit and test apps ===<br />
* Now you have built LLQtWebKit by hand, I'll point out this batch file which does it for you.<br />
* <code>C:\llqtwebkit\make_all.bat</code> is a very simple batch file that will clean and build release and debug versions of LLQtWebKit and then clean and build release version of the test apps (except Win32GL). <br />
* You will need to modify the GL_COMPONENT_DIR variable near the top that sets the location of the GLUT and GLUI build files.<br />
* You almost certainly will want to run this batch file from a Qt command prompt as described above since various Qt directories need to be in the path.<br />
<br />
=== Generate a directory tree compatible with the Second Life client build system ===<br />
* <code>C:\llqtwebkit\copy_llqtwebkit.bat</code> is a batch file that:<br />
** Generates a directory tree containing LLQtWebKit header and libraries along with the necessary Qt run time files that are required by the Second Life client.<br />
** Builds a <code>tar.bz2 </code> archive and associated MD5 sum that can be used in the LLQtWebKit section of the Second Life client <code>install.xml</code> configuration file.<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=800843LLQtWebKit2010-03-12T22:44:17Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a modified version of the [http://qt.nokia.com/ Qt application and UI framework]. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in the Second Life viewer.<br />
<br />
== License ==<br />
LLQtWebKit is released under the [http://www.gnu.org/licenses/gpl-2.0.html GPL V2] license. <br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Test applications ==<br />
As well as the source code and other files required to build LLQtWebKit, there are a number of applications included in the package that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the platform specific build instructions above.<br />
<br />
* '''qttestapp''' - A simple Qt based, cross platform application that implements a simple Web browser <br />
* '''win32gl''' - A simple Win32 specific application that implements a simple Web browser<br />
* '''testgl''' - A simple GLUT based, cross platform application that implements a simple Web browser<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based, cross platform application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: <code>4.6.0</code><br />
* The version of LLQtWebKit is <code>2.2</code><br />
* The user agent string reported by LLQtWebKit can be modified using the API but is of the form: "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/532.4+ (KHTML, like Gecko, Safari/532.4)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=Qt_Webkit_Win32_Build_Instructions&diff=667462Qt Webkit Win32 Build Instructions2009-11-19T21:44:35Z<p>Callum Linden: </p>
<hr />
<div>{{KBcaution|For a more recent version of the Qt/WebKit rendering library (LLQtWebKit) please go to [https://wiki.secondlife.com/wiki/LLQtWebKit this] page }}<br />
<br />
<br />
These are instructions for building the Qt/WebKit library as well as testgl and<br />
uBrowser demo apps using WebKit.<br />
<br />
If you do not have git, you can download and install from:<br />
http://code.google.com/p/msysgit/<br />
<br />
Select the option (number 2 of 3) to add git to your path, but not all the unix<br />
tools that ship with it.<br />
<br />
0) Building the open source OpenSSL library with Visual Studio:<br />
* You can build Qt without ssl support (and skip this step) by removing -openssl from the Qt configure options.<br />
* Download the latest tarball from http://openssl.org/source/ (Currently it is openssl-0.9.8j.tar.gz)<br />
* Copy to C:\ and extract the contents C:\openssl-0.9.8j<br />
* The header files are symlinks to the real files, Microsoft's compiler doesn't seem to support NTFS sysmlinks so the real files have to be copied to the include directory. Below are steps to do that in cygwin's bash. Feel free to put the equivalent dos commands here as going into bash seems like a nasty hack.<br />
Goto cd C:\openssl-0.9.8j and Launch bash and execute the following commands<br />
rm include/openssl/*<br />
cd crypto/<br />
find ./ -name "*.h" -exec cp {} ../include/openssl/ \;<br />
cd ../ssl/<br />
find ./ -name "*.h" -exec cp {} ../include/openssl/ \;<br />
cd ..<br />
cp *.h include/openssl/<br />
* Patch the OpenSSL distribution - it's broken out of the box. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8j\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
<br />
then run this command from the <code>C:\openssl-0.9.8j\util\</code> directory:<br />
patch mk1mf.pl -p0 < fix.patch<br />
<br />
* Compile openssl<br />
cd C:\openssl-0.9.8j<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
<br />
* The libraries libeay32.dll ssleay32.dll have now been build, they should be copied to wherever the Qt libraries are located for the applications that use them. <br />
<br />
1) Acquire llmozlib<br />
* 1.1) Run "Qt Snapshot Command Prompt" and clone llmozlib in the C drive.<br />
cd C:\<br />
git clone git://code.staikos.net/llmozlib<br />
<br />
* 1.2) Checkout the qtwebkit branch <br />
cd C:\llmozlib<br />
git checkout -f -b qtwebkit origin/qtwebkit<br />
<br />
2) Building the open source Qt snapshot with Visual Studio:<br />
* 2.1) Set up directories<br />
* Start/All Programs/Microsoft Visual Studio 2005/Visual Studio Tools/Visual Studio 2005 Command Prompt<br />
mkdir C:\Qt<br />
<br />
* 2.2) Aquire the source for Qt<br />
Download the 4.5.2 source which is found on the ftp server here:<br />
ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz<br />
<br />
* 2.3) Unzip the tarball and extract the contents of Qt in C:\Qt using your favorite zip tool ''(Note: using Cygwin's tar commmand might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
You should now have a directory C:\Qt\qt-all-opensource-src-4.5.2<br />
<br />
* 2.4) Apply patches<br />
Review the file llmozlib/llmozlib2/qt_patches/merged_into_qt to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
There are patches that can be found in llmozlib/llmozlib2/qt_patches/*.patch that should be applied to Qt<br />
<br />
* 2.4) Configure Qt, takes about 10 minutes. Open a vs console<br />
cd C:\Qt\qt-all-opensource-src-4.5.2<br />
configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8j\include -L C:\openssl-0.9.8j\out32dll<br />
<br />
* When the license agreement appears, if you agree type:<br />
* y<enter><br />
* 2.5) Build Qt, without demos. This takes 1-2 hours.<br />
nmake sub-src<br />
<br />
* After building Qt the release and debug libraries will be in C:\Qt\qt-all-opensource-src-4.5.2\lib<br />
* 2.8) Create the file C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat and put the following in it<br />
<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
<br />
* 2.8) Make a shortcut to qt-vars.bat on your desktop<br />
Right-click > Properties on the shortcut and set:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
<br />
Rename the command prompt shortcut to "Qt 4.5 Command Prompt".<br />
<br />
You can test it by opening the prompt and typing<br />
qmake --version<br />
To make sure that the version shows 4.5.2<br />
<br />
3) Build llmozlib<br />
<br />
* Investigate: does 'git config core.safecrlf true' solve the windows line ending issue?<br />
<br />
* 3.1) Launch the Qt command prompt, generate the makefile and build the library<br />
cd C:\llmozlib\llmozlib2<br />
qmake CONFIG-=debug<br />
nmake<br />
<br />
If you want to build the debug version of llmozlib run 'qmake CONFIG+=debug'<br />
<br />
* Now llmozlib is built and can be used in the viewer. If you want to build the test applications follow the next steps:<br />
<br />
4) Acquire the test application library dependencies; Glut and GLUI<br />
* a. Glut: http://www.xmission.com/~nate/glut.html Grab the library and header zip.<br />
glut-3.7.6-bin.zip<br />
* a1. Extract the contents of the zip to a c:\llmozlib\llmozlib2\tests\GL<br />
* b. Glui32: http://glui.sourceforge.net/<br />
glui-2.35.zip<br />
* b1. Extract the zip<br />
* b2. Open glui\src\msvc\glui.vcproj. Allow Visual Studio to convert the project.<br />
* b2. Edit src\include\GL\glui.h<br />
* b3. Move "#include <cstdlib>" to the top of the file, just under #define GLUI_GLUI_H<br />
(hence above #include <GL/glut.h><br />
* b4. See http://www.lighthouse3d.com/opengl/glut/ for details on this edit<br />
* Copy the contents of c:\llmozlib\llmozlib2\tests\GL into glue\src\include\GL<br />
* b5. Follow the instructions in the readme.txt to compile the library<br />
Make sure to build a release library<br />
* b6. Copy glui.h and from the include into C:\llmozlib\llmozlib2\tests\GL<br />
* b7. Copy glui32.lib from msvc/lib into C:\llmozlib\llmozlib2\tests\GL<br />
<br />
4) Build testgl and run it. Open the Qt Snapshot command prompt.<br />
cd C:\llmozlib\llmozlib2\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
<br />
5) Build ubrowser and run it. Open the Qt Snapshot command prompt.<br />
cd C:\llmozlib\llmozlib2\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
<br />
6) Build Second life<br />
* [[Get_source_and_compile]]<br />
* When grabbing the source use the webkit branch https://svn.secondlife.com/svn/linden/branches/2009/webkit<br />
* Copy Qt libraries and ssl into C:\linden\webkit\libraries\i686-win32\lib\debug & release<br />
* Copy Qt image plugins into C:\linden\webkit\indra\build-VC80\newview\relwithdebinfo\imageformats<br />
* Copy llmozlib and header into C:\linden\webkit\libraries\i686-win32\*<br />
<br />
Notes:<br />
a. To generate a Visual studio vcproj file you have to use a Qt *commercial* command prompt and run the following:<br />
qmake -tp vc<br />
<br />
b. Make sure all libs and app are built as Multi-threaded Dll or Multi-threaded debug dll.<br />
In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
<br />
Troubleshooting:<br />
1) If you see this, you need to reorder the <cstdlib> and <GL/glut.h> includes.<br />
<br />
C:\Program Files\Microsoft Visual Studio 8\VC\include\stdlib.h(406) : error C2381: 'exit' : redefinition; __declspec(noreturn) differs<br />
../include\GL/glut.h(146) : see declaration of 'exit'<br />
<br />
2) uBrowser crashes on startup in stdlib (vc8crt.dll or similar)<br />
<br />
This happens when you mix debug and release libraries. Make sure you are using<br />
all "release" builds of GLUI and ubrowser.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=Qt_Webkit_OSX_Build_Instructions&diff=667442Qt Webkit OSX Build Instructions2009-11-19T21:40:00Z<p>Callum Linden: </p>
<hr />
<div>{{Note|For a more recent version of the Qt/WebKit rendering library (LLQtWebKit) please go to [https://wiki.secondlife.com/wiki/LLQtWebKit this] page }}<br />
<br />
<br />
1) Get Qt and set environment variables.<br />
<br />
Download Qt from trolltech.com<br />
<br />
Extract it somewhere such as<br />
$HOME/dev/qt-4.5/<br />
<br />
Then set the environment variable QTDIR to point to that location.<br />
cd $HOME/dev/qt-4.5/<br />
export QTDIR=`pwd`<br />
export PATH=$PATH:$QTDIR/bin<br />
<br />
2) Get llmozlib and checkout the qtwebkit branch<br />
<br />
cd $HOME/dev<br />
# note if you hasve write access and want to make changes, <br />
# use git+ssh://git@code.staikos.net/srv/git/llmozlib<br />
git clone git://code.staikos.net/llmozlib<br />
git checkout -b qtwebkit origin/qtwebkit<br />
<br />
3) Apply locally maintained Qt patches<br />
<br />
cd $QTDIR<br />
<br />
# the patch files are numbered in the order they should be applied, so this should do the right thing<br />
for patchfile in /path/to/llmozlib/llmozlib2/qt_patches/[0-9]* /path/to/llmozlib/llmozlib2/qt_patches/qtwebkit-[0-9]* ; do<br />
echo applying "$patchfile"<br />
patch -p1 <"$patchfile"<br />
done<br />
<br />
4) Compile Qt<br />
<br />
cd $QTDIR<br />
./configure -opensource -no-framework -fast -no-qt3support -prefix $PWD -static -release -no-xmlpatterns -no-phonon -universal -sdk /Developer/SDKs/MacOSX10.4u.sdk/<br />
make<br />
<br />
If you have a multi-core machine, you can speed the make up substantially by using the '-j' argument. On a 4-core machine, I use 'make -j4'.<br />
<br />
For some reason, this doesn't seem to build libJavaScriptCore.a. I also had to do the following:<br />
<br />
cd $QTDIR/src/3rdparty/webkit/JavaScriptCore<br />
make<br />
<br />
5) build llmozlib2.dylib with XCode:<br />
<br />
cd $HOME/dev/llmozlib/llmozlib2/<br />
<br />
Create a symlink to QTDIR in the same directory as llmozlib2.xcodeproj (this allows the xcode project to find it easily):<br />
<br />
ln -s $QTDIR QTDIR<br />
<br />
build the "llwebkitlib" configuration of the "llmozlib2" target<br />
(note especially: the default configuration is "Release". Be sure<br />
to specify "llwebkitlib" as the configuration):<br />
<br />
xcodebuild -project llmozlib2.xcodeproj -target llmozlib2 -configuration llwebkitlib<br />
<br />
6) build ubrowser with xcode:<br />
<br />
Get the GLUI Framework (the one tested to work is at http://lukecyca.com/wp-content/uploads/2008/12/GLUI-Framework-2.35.tgz)<br />
<br />
run "update-mac-symbols.sh"<br />
<br />
./update-mac-symbols.sh<br />
<br />
build the "Release" configuration of the "llmozlib2" target:<br />
<br />
xcodebuild -project llmozlib2.xcodeproj -target llmozlib2 -configuration Release<br />
<br />
now build ubrowser<br />
<br />
cd tests/ubrowser<br />
xcodebuild -project ubrowser.xcodeproj -target ubrowser -configuration Release<br />
open build/Release/ubrowser.app</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=Linden_Lab_Official:Media_Plugin_System_Messages&diff=628533Linden Lab Official:Media Plugin System Messages2009-10-23T17:21:23Z<p>Callum Linden: /* media_status */</p>
<hr />
<div>{| align="right"<br />
|--<br />
|<br />
{{Media Plugin Nav}}<br />
|--<br />
|&nbsp;<br />
|--<br />
|<br />
{{Media Messages AlphaList}}<br />
|}<br />
<br />
__TOC__<br />
<br />
{{Note|This document reflects ongoing internal work on the Media Plugin System. The details may not match the current publicly-available code; however the overall approach and high-level features reflect the project direction.}}<br />
<br />
== Overview ==<br />
<br />
This article specifies the messages used in the Second Life Viewer media plugin system to communicate between the Plugin Loader Shell (PLS) and individual media rendering plugins.<br />
<br />
For information on messages passed between the PLS and the Viewer, see [[Media Plugin System Internal Messages]].<br />
<br />
=== Message categories ===<br />
<br />
Messages fall into these general categories:<br />
<br />
* '''[[#Base_messages|Base messages]]''' for initialization, connection management, and shared memory setup. All plugins must implement these basic messages.<br />
** '''[[#Media messages|Media messages]]''' for negotiating the pixel buffer and handling updates of subsections of it, specifying a media source URL, and passing mouse and keyboard events. All media rendering plugins must implement these messages.<br />
*** '''[[#Media_browser_messages|Time-based media messages]]''' for functions such as play, pause, stop, seek, and so on. All time-based media (video-like) rendering plugins must implement these messages.<br />
*** '''[[#Media_time_messages|Browser-like media messages]]''' for functions such as forward, back, reload, and so on. All browser-like media rendering plugins must implement these messages.<br />
* '''[[Media Plugin System Internal Messages|Internal messages]]''' for communication between the viewer and the plugin loader shell. These messages are not delivered to a plugin. Plugin developers need not be concerned with them; their documentation is provided for Viewer developers.<br />
<br />
During initialization, a plugin tells the PLS the set of messages it supports, including versioning information to maintain backwards compatibility.<br />
<br />
=== Buffer size negotiation ===<br />
<br />
A plugin and the PLS negotiate the size and format of the pixel buffer into which the plugin draws with the texture_params, size_change_request, and size_change messages.<br />
<br />
The plugin determines the buffer's pixel size and format according to what it sends in the texture_params message. Indexed pixel modes and pixels which use less than eight bits per channel are not currently supported. Recommended modes are 24 bit RGB or 32 bit ARGB, or variants thereof (BGRA, etc).<br />
<br />
Size negotiation is a bit more complicated:<br />
<br />
* PLS initially sets up the dimensions of the pixel buffer.<br />
** If the plugin doesn't have any special sizing requirements, it can just draw to the buffer and never send a size_change_request message.<br />
* If the plugin sends a size_change_request message, the PLS takes that as the "native size" of the media.<br />
** Media is allowed to change sizes multiple times during playback, such as with streaming QuickTime movies.<br />
* If the media is playing as parcel media and the "auto scale" option is set, the draw dimensions may be increased to the next power of two.<br />
* If the plugin sets the allow_downsample field in the texture_params message and the media's priority has been lowered, the host may reduce the requested draw dimensions. <br />
** The plugin should only set allow_downsample if it can draw the media at different scales without changing the overall look of the media, such as scaling down a video stream<br />
** Media which looks different when drawn at different pixel scales (such as a web browser where font sizes depend on pixel scale) should NOT set allow_downsample<br />
** If it's more expensive to draw media downsampled than at native resolution, the plugin should NOT set allow_downsample: it's supposed to be a way to reduce load on the system, and if it doesn't accomplish that it shouldn't be used.<br />
* If the plugin sets the 'padding' field in the texture_params message, the buffer's byte width will be padded to the requested alignment.<br />
** Note that it's possible to request pixel size/alignment combinations that don't come out even when using 3-byte RGB pixels. If the host detects this, it will disable padding.<br />
* PLS sends the requested drawing dimensions, the actual size of the buffer, and the name of the shared memory segment to the plugin in a size_change_response message.<br />
** The plugin must draw within the specified dimensions, and should NOT send a size_change_request in response to the size_change_response<br />
<br />
When changing buffer sizes, the new size may require a larger or smaller memory buffer than the old size. In this case, the shared memory segment name received with the size_change_response may be different than the one the plugin was previously drawing to. If the plugin receives a size_change_response with a shared memory segment name it hasn't seen yet, it MUST not draw to the old shared memory segment using the new parameters, or it may overrun the end of the buffer and crash. <br />
<br />
In this case, the plugin should expect to receive a shm_added message for the new shared memory segment either before or after the size_change_response, and must wait until it has received both before drawing to the new buffer.<br />
<br />
Likewise, when a plugin receives a shm_remove message and it's drawing to the shared memory buffer with that name, it needs to stop doing so, since the memory buffer will be deallocated once the message handler returns.<br />
<br />
== Base messages ==<br />
All plugins need to handle these messages.<br />
<br />
=== Messages the plugin receives ===<br />
<br />
==== init ====<br />
<br />
Initialization message the PLS sends. Plugin responds with [[#init_response|init_response]].<br />
<br />
'''No parameters'''.<br />
<br />
==== idle ====<br />
<br />
Call-in for plugin to do processing. No response required.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| time<br />
| Real<br />
| interval (in seconds) at which idle messages are being sent.<br />
|}<br />
<br />
==== cleanup ====<br />
<br />
The plugin is about to be unloaded, and should perform any cleanup it needs to do beforehand.<br />
<br />
==== shm_added ====<br />
Shared memory segment has been set up.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| name <br />
| string<br />
|<br />
<br />
|--<br />
| size<br />
| String<br />
| ?<br />
<br />
|--<br />
| address <br />
| string<br />
| Since this is going from the PLS to the plugin (not crossing a process boundary),<br />
the pointer will actually be valid. LLSD doesn't have an encoding for a pointer (or even an unsigned 32 bit value),<br />
so this will be the pointer's lowest 32-bits of value as a hexadecimal string.<br />
<br />
|--<br />
| address_1<br />
| string<br />
| Optional. The next 32-bits of the shm address, as above. Usually 0 or absent (unneeded) on 32-bit hosts. <br />
|}<br />
<br />
==== shm_remove ====<br />
<br />
PLS will remove the shared memory segment will be removed when plugin responds with [[#shm_remove_response|shm_remove_response]].<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| name<br />
| String<br />
| Name of memory segment to remove.<br />
|}<br />
<br />
=== Messages the plugin sends ===<br />
<br />
==== init_response ====<br />
<br />
This message is the plugin's response to the [[#init|init]] message sent by the PLS.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| versions <br />
| Map<br />
| Lists version corresponding to each plugin class.<br />
* Key: message class name<br />
* Value: version string. All versions start at "1.0".<br />
<br />
|--<br />
| plugin_version <br />
| String<br />
| Free-form version string for the plugin. This is expected to contain the versions of libraries the plugin uses (for example, quicktime, webkit, and so on) and may end up in the Viewer's about box.<br />
<br />
|}<br />
<br />
==== shm_remove_response ====<br />
<br />
Plugin is done with the shared memory segment, safe to delete. Plugin responds with this message when it receives a [[#shm_remove|shm_remove]] message.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| name<br />
| String<br />
| Name of shared memory segment to delete.<br />
|}<br />
<br />
== Media messages ==<br />
<br />
=== Messages the plugin receives ===<br />
<br />
==== load_uri ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| uri<br />
| String<br />
| URI to load.<br />
|}<br />
<br />
==== key_event ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| event<br />
| String<br />
| One of:<br />
* down<br />
* repeat<br />
* up<br />
<br />
|--<br />
| key<br />
| String <br />
| Platform-specific keycode<br />
<br />
|--<br />
| modifiers<br />
| String<br />
| Contains zero or more of the following, concatenated together with <nowiki>'|'</nowiki> characters in between. There may be a spurious trailing <nowiki>'|'</nowiki>.<br />
* control<br />
* alt -- the 'option' key on the mac<br />
* shift<br />
* meta -- the 'command' key on the mac<br />
<br />
|}<br />
<br />
==== text_event ====<br />
<br />
Text input event not associated with a single keystroke.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
|text<br />
| String<br />
| Encoded in utf8<br />
|}<br />
<br />
<br />
==== mouse_event ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| event<br />
| String<br />
| One of: <br />
* down<br />
* move<br />
* up<br />
* double_click<br />
<br />
|--<br />
|x<br />
|Integer<br />
| x-coordinate in texture space<br />
<br />
|--<br />
| y <br />
| Integer<br />
| Y-coordinate in texture space (taking into account whether vertical flip was requested or not).<br />
<br />
|--<br />
| modifiers <br />
| string <br />
| Contains zero or more of the following, concatenated together with <nowiki>'|'</nowiki> characters in between. There may be a spurious trailing <nowiki>'|'</nowiki>.<br />
* control<br />
* alt -- the 'option' key on the mac<br />
* shift<br />
* meta -- the 'command' key on the mac<br />
<br />
|}<br />
<br />
==== scroll_event ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
|x<br />
|Integer<br />
| x-coordinate in texture space<br />
<br />
|--<br />
| y <br />
| Integer<br />
| Y-coordinate in texture space (taking into account whether vertical flip was requested or not).<br />
<br />
|--<br />
| modifiers <br />
| string <br />
| Contains zero or more of the following, concatenated together with <nowiki>'|'</nowiki> characters in between. There may be a spurious trailing <nowiki>'|'</nowiki>.<br />
* control<br />
* alt -- the 'option' key on the mac<br />
* shift<br />
* meta -- the 'command' key on the mac<br />
<br />
|}<br />
<br />
==== size_change ====<br />
Either host-initiated or after a request from the plugin.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| width<br />
| String<br />
| <br />
<br />
|--<br />
| height<br />
| String<br />
| <br />
<br />
|--<br />
| texture_width<br />
| String<br />
| <br />
<br />
|--<br />
| texture_height<br />
| String<br />
| <br />
<br />
<br />
|--<br />
| name<br />
| String<br />
| Name of the shared memory segment the texture will draw into.<br />
<br />
|}<br />
<br />
==== set_priority ====<br />
<br />
Tells the plugin its relative priority.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| priority<br />
| String<br />
| One of:<br />
* stopped: media is not playing, shouldn't need to update at all<br />
* hidden: media is not being displayed or is out of view, don't need to do graphic updates, but may still update audio, playhead, etc. <br />
* slideshow: media is being displayed, but is being severely throttled to reduce resource usage <br />
* low: media is in the far distance, may be rendered at reduced size<br />
* normal: default priority<br />
* high: media has user focus and/or is taking up most of the screen<br />
<br />
|}<br />
<br />
==== edit_cut ====<br />
<br />
Perform an edit-menu "cut" operation to the system clipboard.<br />
<br />
'''No parameters'''<br />
<br />
==== edit_copy ====<br />
<br />
Perform an edit-menu "copy" operation to the system clipboard.<br />
<br />
'''No parameters'''<br />
<br />
==== edit_paste ====<br />
Perform an edit-menu "paste" operation from the system clipboard.<br />
<br />
'''No parameters'''<br />
<br />
=== Messages the plugin sends ===<br />
<br />
==== texture_params ====<br />
<br />
* Note that the hexadecimal GLint and GLenum values used for internalformat, format and type are fixed by the OpenGL ARB, so passing them across process boundaries should be safe.<br />
* Although the pixel size in bytes is completely determined by the format and type, deriving it from only those values is complex. To simplify things, the plugin must provide the pixel size to the host.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| default_width<br />
| String<br />
| Optional. Default width for the texture.<br />
<br />
|--<br />
| default_height<br />
| String<br />
| Optional. Default height for the texture.<br />
<br />
|--<br />
| depth<br />
| String<br />
| Pixel size in bytes.<br />
<br />
|--<br />
| internalformat<br />
| String<br />
| Texture internal format for glTexImage2D. The value is a string containing hexadecimal digits, (e.g. "0xDEADBEEF") representing a GLint.<br />
<br />
|--<br />
| format<br />
| String<br />
| Texture format for glTexImage2D. The value is a string containing hexadecimal digits, (e.g. "0xDEADBEEF") representing a GLenum.<br />
<br />
|--<br />
| type<br />
| String<br />
| Texture type for glTexImage2D. The value is a string containing hexadecimal digits, (e.g. "0xDEADBEEF") representing a GLenum.<br />
<br />
|--<br />
| swap_bytes<br />
| Boolean<br />
| Optional. True if the host should use glPixelStorei(GL_UNPACK_SWAP_BYTES, 1) when loading the data. If not specified, defaults to false.<br />
<br />
|--<br />
| coords_opengl<br />
| Boolean<br />
| True if the plugin wants to work in OpenGL coordinates (where (0,0) is the lower left corner of the texture), false to work in a coordinate system where (0,0) is the upper left.<br />
<br />
|--<br />
| allow_downsample<br />
| Boolean <br />
| Optional. If true, the host may negotiate a smaller texture when the plugin's priority is reduced. The plugin should not set this if downscaling the media is more expensive than drawing it at native size.<br />
<br />
|--<br />
| padding<br />
| String<br />
| Optional. Specifies how the rows of the texture should be padded. Useful values:<br />
* 0 (the default) -- no padding is added<br />
* -1 -- pad width to the next power of two<br />
* 16 -- start each row on a 16 byte boundary -- NOTE: may not work correctly with odd-sized pixels like GL_RGB<br />
* 32 -- start each row on a 32 byte boundary -- NOTE: may not work correctly with odd-sized pixels like GL_RGB<br />
<br />
|}<br />
<br />
==== updated====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| left<br />
| String<br />
|<br />
|--<br />
| top<br />
| String<br />
|<br />
|--<br />
| right<br />
| String<br />
|<br />
|--<br />
| bottom<br />
| String<br />
|<br />
|--<br />
| current_time<br />
| Real<br />
| Optional. Current playhead time in seconds.<br />
<br />
|--<br />
| duration<br />
| Real<br />
| Optional. Total duration of the media in seconds<br />
<br />
|--<br />
| current_rate<br />
| Real<br />
| Optional. Rate at which the media is currently playing.<br />
<br />
|--<br />
| loaded_duration<br />
| Real<br />
| Optional. For media which is partially loaded, the duration through which the media could currently play or seek. For media which can't be loaded incrementally, either omit this parameter or set it to the same value as 'duration'.<br />
|}<br />
<br />
==== media_status====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| status <br />
| String<br />
| One of:<br />
* <empty string> -- not initialized or no media loaded<br />
* loading -- loading or navigating<br />
* loaded -- preroll/navigation complete<br />
* error -- navigation/preroll failed<br />
* playing -- playing (only for time-based media)<br />
* paused -- paused (only for time-based media)<br />
<br />
|}<br />
<br />
==== name_text====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| name <br />
| String<br />
| The name of the media. Typically the <code><title></code> tag <br>in a Web page or the name in time based media.<br />
<br />
|}<br />
<br />
==== size_change_request ====<br />
<br />
When the stream wants to change its native size.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| width<br />
| String<br />
|<br />
<br />
|--<br />
| height<br />
| String<br />
|<br />
<br />
|--<br />
| name<br />
| String<br />
| Name of the shared memory segment the texture will draw into. This may induce the host to send a size_change message. The plugin may stop drawing to the texture until an appropriate size_change message has been received.<br />
|}<br />
<br />
==== size_change_response ====<br />
<br />
Sent by the plugin in response to [[#size_change|size_change]] when the size change is complete.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| width<br />
| String<br />
|<br />
<br />
|--<br />
| height<br />
| String<br />
|<br />
<br />
|--<br />
| texture_width<br />
| String<br />
|<br />
<br />
|--<br />
| texture_height<br />
| String<br />
|<br />
<br />
|--<br />
| name<br />
| String<br />
| Name of the shared memory segment the texture will draw into<br />
|}<br />
<br />
==== cursor_changed ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| name<br />
| String<br />
| One of:<br />
* <empty string><br />
* arrow<br />
* ibeam<br />
* splith<br />
* splitv<br />
* hand<br />
|}<br />
<br />
==== edit_state ====<br />
<br />
Update the state of the edit menu items in the host.<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
| cut<br />
| Boolean<br />
| OPTIONAL<br />
<br />
|--<br />
| copy<br />
| Boolean<br />
| OPTIONAL<br />
<br />
|--<br />
| paste<br />
| Boolean<br />
| OPTIONAL<br />
* items that are not present in the update message should have their state unchanged. <br />
* All states start out false in the host. <br />
* False means the operation is not possible and the menu should be disabled.<br />
|}<br />
<br />
<br />
== Media_browser messages ==<br />
<br />
=== Messages the plugin receives ===<br />
<br />
==== focus ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| focused <br />
| Boolean<br />
| true if the browser instance has focus<br />
|}<br />
<br />
==== clear_cache ====<br />
<br />
'''No Parameters'''.<br />
<br />
==== clear_cookies ====<br />
<br />
'''No Parameters'''.<br />
<br />
==== enable_cookies ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|--<br />
|enable<br />
|Boolean<br />
|Whether to enable cookies.<br />
|}<br />
<br />
==== proxy_setup ====<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| enable <br />
|Boolean<br />
|<br />
<br />
|---<br />
| host<br />
| String<br />
|<br />
<br />
|---<br />
| port<br />
|String<br />
|<br />
|}<br />
<br />
==== browse_stop ====<br />
<br />
'''No Parameters'''.<br />
<br />
==== browse_reload ====<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| ignore_cache<br />
| Boolean<br />
| If true, bypass cache for this reload.<br />
|}<br />
<br />
==== browse_forward ====<br />
<br />
'''No Parameters'''.<br />
<br />
==== browse_back ====<br />
<br />
'''No Parameters'''.<br />
<br />
==== set_status_redirect ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| code<br />
| String<br />
| The HTTP status code on which to redirect (currently, only be 404).<br />
<br />
|---<br />
| url<br />
| String<br />
| URL to which to redirect.<br />
|}<br />
<br />
==== init_history ====<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| history <br />
| Array of strings<br />
| Array of string URIs to add to the browser history.<br />
|}<br />
<br />
=== Messages the plugin sends ===<br />
<br />
<br />
==== navigate_begin ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| uri <br />
| String<br />
| URI to which the browser is navigating.<br />
<br />
|}<br />
<br />
==== navigate_complete ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
|---<br />
| uri <br />
| String<br />
| URI to which the browser was navigating.<br />
<br />
|---<br />
| result_code<br />
| String<br />
| For example, 200, 404.<br />
<br />
|---<br />
| result_string <br />
| String<br />
| "OK", "Not Found", etc.<br />
<br />
|---<br />
| history_back_available <br />
| Boolean<br />
| True if the "back" button should be enabled<br />
|---<br />
| history_forward_available <br />
| Boolean<br />
| True if the "forward" button should be enabled<br />
<br />
|}<br />
<br />
==== progress ====<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
|---<br />
| percent<br />
| String<br />
| Percent of page load that has completed<br />
<br />
|}<br />
<br />
==== status_text ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
|---<br />
| status <br />
| String<br />
| New browser status string.<br />
<br />
|}<br />
<br />
==== location_changed ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| uri <br />
| String<br />
| New browser URI for the navigation bar.<br />
<br />
|}<br />
<br />
==== click_href ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
|---<br />
| uri <br />
| String<br />
| URI of the link.<br />
<br />
|---<br />
| target <br />
| String<br />
| Target property of the link.<br />
<br />
|}<br />
<br />
==== click_nofollow ====<br />
<br />
'''Parameters''' <br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| uri <br />
| String<br />
| URI of the link.<br />
<br />
|}<br />
<br />
== Media_time messages ==<br />
<br />
=== Messages the plugin receives ===<br />
<br />
==== stop ====<br />
<br />
'''No parameters'''.<br />
<br />
==== start ====<br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
|---<br />
| rate<br />
| Real<br />
| Optional. Rate to play at:<br />
* 0.0 is the movie's default rate.<br />
* 1.0 is normal forward (on most movies).<br />
* -1.0 is reverse.<br />
* Greater than 1.0 is fast foward. <br />
* Less than 1.0 is slow motion.<br />
<br />
|}<br />
<br />
==== pause ====<br />
<br />
'''No parameters'''.<br />
<br />
==== seek ====<br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| time <br />
| Real<br />
|<br />
<br />
|}<br />
<br />
==== set_loop ====<br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
|---<br />
| loop <br />
| Boolean<br />
| True to make the media loop, false to make it play once.<br />
<br />
|}<br />
<br />
==== set_volume ====<br />
<br />
{| class="lltable" border="1"<br />
|--<br />
!Key<br />
!Type<br />
!Description<br />
<br />
|---<br />
| volume <br />
| Real<br />
|<br />
<br />
|}</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=627493LLQtWebKit Win32 Build Instructions2009-10-22T21:31:59Z<p>Callum Linden: /* Build Qt */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the OpenSSL and Qt source code<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - the line endings are broken out of the box on Windows. <br />
** Copy the OpenSSL patch files from the <code>LLQtWebKit\other_patches</code> directory into the <code>C:\openssl-0.9.8k</code> directory.<br />
** Open a command prompt and change to the <code>C:\openssl-0.9.8k</code> directory<br />
** Run this command:<br />
*** <code>patch -p1 < 010-openssl-fix-line-endings.patch</code><br />
* In the same directory, execute the following commands to build OpenSSL:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps using<br />
** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 007, 008 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries and dlls will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=627393LLQtWebKit Win32 Build Instructions2009-10-22T21:25:16Z<p>Callum Linden: /* Downloading and patching the Qt source */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the OpenSSL and Qt source code<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - the line endings are broken out of the box on Windows. <br />
** Copy the OpenSSL patch files from the <code>LLQtWebKit\other_patches</code> directory into the <code>C:\openssl-0.9.8k</code> directory.<br />
** Open a command prompt and change to the <code>C:\openssl-0.9.8k</code> directory<br />
** Run this command:<br />
*** <code>patch -p1 < 010-openssl-fix-line-endings.patch</code><br />
* In the same directory, execute the following commands to build OpenSSL:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps using<br />
** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 007, 008 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=627373LLQtWebKit Win32 Build Instructions2009-10-22T21:22:46Z<p>Callum Linden: /* Build the open source OpenSSL library */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the OpenSSL and Qt source code<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - the line endings are broken out of the box on Windows. <br />
** Copy the OpenSSL patch files from the <code>LLQtWebKit\other_patches</code> directory into the <code>C:\openssl-0.9.8k</code> directory.<br />
** Open a command prompt and change to the <code>C:\openssl-0.9.8k</code> directory<br />
** Run this command:<br />
*** <code>patch -p1 < 010-openssl-fix-line-endings.patch</code><br />
* In the same directory, execute the following commands to build OpenSSL:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps using<br />
** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 0007 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=627343LLQtWebKit Win32 Build Instructions2009-10-22T21:19:06Z<p>Callum Linden: /* Acquire LLQtWebKit source code */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the OpenSSL and Qt source code<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - the line endings are broken out of the box on Windows. <br />
** Copy the OpenSSL patch files from the <code>LLQtWebKit</code> directory into the <code>C:\openssl-0.9.8k</code> directory.<br />
** Open a command prompt and change to the <code>C:\openssl-0.9.8k</code> directory<br />
** Run this command:<br />
*** <code>patch -p1 < 010-openssl-fix-line-endings.patch</code><br />
* In the same directory, execute the following commands to build OpenSSL:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps using<br />
** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 0007 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=627333LLQtWebKit Win32 Build Instructions2009-10-22T21:18:20Z<p>Callum Linden: </p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - the line endings are broken out of the box on Windows. <br />
** Copy the OpenSSL patch files from the <code>LLQtWebKit</code> directory into the <code>C:\openssl-0.9.8k</code> directory.<br />
** Open a command prompt and change to the <code>C:\openssl-0.9.8k</code> directory<br />
** Run this command:<br />
*** <code>patch -p1 < 010-openssl-fix-line-endings.patch</code><br />
* In the same directory, execute the following commands to build OpenSSL:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps using<br />
** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 0007 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=627313LLQtWebKit Win32 Build Instructions2009-10-22T21:16:27Z<p>Callum Linden: /* Build the open source OpenSSL library */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - the line endings are broken out of the box on Windows. <br />
** Copy the OpenSSL patch files from the <code>LLQtWebKit</code> directory into the <code>C:\openssl-0.9.8k</code> directory.<br />
** Open a command prompt and change to the <code>C:\openssl-0.9.8k</code> directory<br />
** Run this command:<br />
*** <code>patch -p1 < 010-openssl-fix-line-endings.patch</code><br />
* In the same directory, execute the following commands to build OpenSSL:<br />
** <code>perl Configure VC-WIN32</code><br />
** <code>ms\do_masm</code><br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps using<br />
** <code>patch -p1 < 020-openssl-disable-manifest.patch</code><br />
* Continue to build <br />
** <code>nmake -f ms\ntdll.mak</code><br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 0007 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=627293LLQtWebKit Win32 Build Instructions2009-10-22T21:15:22Z<p>Callum Linden: /* Build the open source OpenSSL library */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - the line endings are broken out of the box on Windows. <br />
** Copy the OpenSSL patch files from the <code>LLQtWebKit</code> directory into the <code>C:\openssl-0.9.8k</code> directory.<br />
** Open a command prompt and change to the <code>C:\openssl-0.9.8k</code> directory<br />
** Run this command:<br />
*** <code>patch -p1 < 010-openssl-fix-line-endings.patch</code><br />
<br />
* In the same directory, execute the following commands to build OpenSSL:<br />
** perl Configure VC-WIN32<br />
** ms\do_masm<br />
<br />
* Patch the <code>ntdll.mak</code> file generated by the previous steps using<br />
** patch -p1 < 020-openssl-disable-manifest.patch<br />
<br />
* Continue to build <br />
** nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 0007 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=560593LLQtWebKit Win32 Build Instructions2009-10-06T23:22:33Z<p>Callum Linden: /* Notes */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 0007 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* To enable a run time console for the test applications add a <code>CONFIG+=console</code> line to the <code>qmake </code> line.<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=559453LLQtWebKit Win32 Build Instructions2009-10-06T23:21:16Z<p>Callum Linden: /* Downloading and patching the Qt source */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Apply the patches in the order indicated by the number in the filename - 002, 0007 etc.<br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=495892LLQtWebKit Win32 Build Instructions2009-09-24T06:47:15Z<p>Callum Linden: /* Downloading and patching the Qt source */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the contents of the tarball into <code>C:\Qt</code><br />
* This may take some as the archive contains a lot of files<br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\Qt\qt-all-opensource-src-4.5.2</code> and not <code>C:\Qt\qt-all-opensource-src-4.5.2\qt-all-opensource-src-4.5.2</code> <br />
** Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.).<br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=495882LLQtWebKit Win32 Build Instructions2009-09-24T06:39:55Z<p>Callum Linden: /* Acquire LLQtWebKit source code */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the contents of the zip file to <code>C:\llqtwebkit</code><br />
**Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\llqtwebkit</code> and not <code>C:\llqtwebkit\llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the tarball into <code>C:\Qt</code> ''(Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>C:\Qt\qt-all-opensource-src-4.5.2</code><br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=495872LLQtWebKit Win32 Build Instructions2009-09-24T06:33:56Z<p>Callum Linden: /* Build the open source OpenSSL library */</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
** Note: Different tools have different concepts of "contents" - you should end up with the directories and files in <code>C:\openssl-0.9.8k</code> and not <code>C:\openssl-0.9.8k\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the files in the zip to C:\llqtwebkit<br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the tarball into <code>C:\Qt</code> ''(Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>C:\Qt\qt-all-opensource-src-4.5.2</code><br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477902LLQtWebKit2009-09-02T09:25:28Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a patched version of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Test applications ==<br />
As well as the source code and patch files required to build the library there are a number of test applications included in the package that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the build instructions above.<br />
<br />
* '''qttestapp''' - A simple Qt based application that implements a simple Web browser using LLQtWebKit<br />
* '''testgl''' - A simple GLUT based application that renders a single Web page using OpenGL<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477893LLQtWebKit2009-09-02T09:19:41Z<p>Callum Linden: /* Test applications */</p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a patched version of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
<br />
== Test applications ==<br />
As well as the source code and patch files required to build the library there are a number of test applications included in the package that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the build instructions above.<br />
<br />
* '''qttestapp''' - A simple Qt based application that implements a simple Web browser using LLQtWebKit<br />
* '''testgl''' - A simple GLUT based application that renders a single Web page using OpenGL<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477883LLQtWebKit2009-09-02T09:18:41Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a patched version of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
<br />
== Test applications ==<br />
As well as the source code and patch files required to build the library there are a number of test applications that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the instructions below.<br />
<br />
* '''qttestapp''' - A simple Qt based application that implements a simple Web browser using LLQtWebKit<br />
* '''testgl''' - A simple GLUT based application that renders a single Web page using OpenGL<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477873LLQtWebKit2009-09-02T09:18:01Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a patched version of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Test applications ==<br />
As well as the source code and patch files required to build the library there are a number of test applications that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the instructions below.<br />
<br />
* '''qttestapp''' - A simple Qt based application that implements a simple Web browser using LLQtWebKit<br />
* '''testgl''' - A simple GLUT based application that renders a single Web page using OpenGL<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477863LLQtWebKit2009-09-02T09:16:43Z<p>Callum Linden: /* What's included? */</p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a patched version of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== What's included? ==<br />
As well as the source code and patch files required to build the library there are a number of test applications that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the instructions below.<br />
<br />
* '''qttestapp''' - A simple Qt based application that implements a simple Web browser using LLQtWebKit<br />
* '''testgl''' - A simple GLUT based application that renders a single Web page using OpenGL<br />
* '''ubrowser''' - A more complex application GLUT/GLUI based application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477853LLQtWebKit2009-09-02T09:16:06Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a patched version of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== What's included? ==<br />
As well as the source code and patch files required to build the library there are a number of test applications that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/tip/tests/ here]. Details of how to build them are included in the instructions below.<br />
<br />
* 'qttestapp' - A simple Qt based application that implements a simple Web browser using LLQtWebKit<br />
* 'testgl' - A simple GLUT based application that renders a single Web page using OpenGL<br />
* 'ubrowser' - A more complex application GLUT/GLUI based application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477843LLQtWebKit2009-09-02T09:15:04Z<p>Callum Linden: /* What's included? */</p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a patched version of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== What's included? ==<br />
As well as the source code and patch files required to build the library there are a number of test applications that are useful for testing. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here]. Details of how to build them are included in the instructions below.<br />
<br />
* qttestapp - A simple Qt based application that implements a simple Web browser using LLQtWebKit<br />
* testgl - A simple GLUT based application that renders a single Web page using OpenGL<br />
* ubrowser - A more complex application GLUT/GLUI based application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477833LLQtWebKit2009-09-02T09:14:13Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from a patched version of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== What's included? ==<br />
As well as the source code and patch files required to build the library there are a number of test applications that are useful for testing. Details of how to build them are included in the instructions below.<br />
<br />
* qttestapp - A simple Qt based application that implements a simple Web browser using LLQtWebKit<br />
* testgl - A simple GLUT based application that renders a single Web page using OpenGL<br />
* ubrowser - A more complex application GLUT/GLUI based application that renders multiple Web pages on the surface of 3D geometry<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477823LLQtWebKit2009-09-02T09:07:06Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from version 4.5.2 of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "<code>Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)</code>"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477813LLQtWebKit2009-09-02T09:06:00Z<p>Callum Linden: /* Previous Versions */</p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from version 4.5.2 of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)"<br />
<br />
== Previous Incarnations ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477803LLQtWebKit2009-09-02T09:05:33Z<p>Callum Linden: </p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from version 4.5.2 of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Version numbers ==<br />
* The version of Qt/WebKit used is: 4.5.2<br />
* The version of LLQtWebKit is 2.1<br />
* The user agent string reported by LLQtWebKit is "Mozilla/5.0 (Windows;U; Windows NT 5.1; en-US) AppleWebKit/527+ (KHTML, like Gecko, Safari/419.3)"<br />
<br />
== Previous Versions ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=Qt_Webkit_Win32_Build_Instructions&diff=477793Qt Webkit Win32 Build Instructions2009-09-02T08:58:00Z<p>Callum Linden: </p>
<hr />
<div>{{Note|For a more recent version of the Qt/WebKit rendering library (LLQtWebKit) please go to [https://wiki.secondlife.com/wiki/LLQtWebKit this] page }}<br />
<br />
<br />
These are instructions for building the Qt/WebKit library as well as testgl and<br />
uBrowser demo apps using WebKit.<br />
<br />
If you do not have git, you can download and install from:<br />
http://code.google.com/p/msysgit/<br />
<br />
Select the option (number 2 of 3) to add git to your path, but not all the unix<br />
tools that ship with it.<br />
<br />
0) Building the open source OpenSSL library with Visual Studio:<br />
* You can build Qt without ssl support (and skip this step) by removing -openssl from the Qt configure options.<br />
* Download the latest tarball from http://openssl.org/source/ (Currently it is openssl-0.9.8j.tar.gz)<br />
* Copy to C:\ and extract the contents C:\openssl-0.9.8j<br />
* The header files are symlinks to the real files, Microsoft's compiler doesn't seem to support NTFS sysmlinks so the real files have to be copied to the include directory. Below are steps to do that in cygwin's bash. Feel free to put the equivalent dos commands here as going into bash seems like a nasty hack.<br />
Goto cd C:\openssl-0.9.8j and Launch bash and execute the following commands<br />
rm include/openssl/*<br />
cd crypto/<br />
find ./ -name "*.h" -exec cp {} ../include/openssl/ \;<br />
cd ../ssl/<br />
find ./ -name "*.h" -exec cp {} ../include/openssl/ \;<br />
cd ..<br />
cp *.h include/openssl/<br />
* Patch the OpenSSL distribution - it's broken out of the box. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8j\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
<br />
then run this command from the <code>C:\openssl-0.9.8j\util\</code> directory:<br />
patch mk1mf.pl -p0 < fix.patch<br />
<br />
* Compile openssl<br />
cd C:\openssl-0.9.8j<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
<br />
* The libraries libeay32.dll ssleay32.dll have now been build, they should be copied to wherever the Qt libraries are located for the applications that use them. <br />
<br />
1) Acquire llmozlib<br />
* 1.1) Run "Qt Snapshot Command Prompt" and clone llmozlib in the C drive.<br />
cd C:\<br />
git clone git://code.staikos.net/llmozlib<br />
<br />
* 1.2) Checkout the qtwebkit branch <br />
cd C:\llmozlib<br />
git checkout -f -b qtwebkit origin/qtwebkit<br />
<br />
2) Building the open source Qt snapshot with Visual Studio:<br />
* 2.1) Set up directories<br />
* Start/All Programs/Microsoft Visual Studio 2005/Visual Studio Tools/Visual Studio 2005 Command Prompt<br />
mkdir C:\Qt<br />
<br />
* 2.2) Aquire the source for Qt<br />
Download the 4.5.2 source which is found on the ftp server here:<br />
ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz<br />
<br />
* 2.3) Unzip the tarball and extract the contents of Qt in C:\Qt using your favorite zip tool ''(Note: using Cygwin's tar commmand might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
You should now have a directory C:\Qt\qt-all-opensource-src-4.5.2<br />
<br />
* 2.4) Apply patches<br />
Review the file llmozlib/llmozlib2/qt_patches/merged_into_qt to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
There are patches that can be found in llmozlib/llmozlib2/qt_patches/*.patch that should be applied to Qt<br />
<br />
* 2.4) Configure Qt, takes about 10 minutes. Open a vs console<br />
cd C:\Qt\qt-all-opensource-src-4.5.2<br />
configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8j\include -L C:\openssl-0.9.8j\out32dll<br />
<br />
* When the license agreement appears, if you agree type:<br />
* y<enter><br />
* 2.5) Build Qt, without demos. This takes 1-2 hours.<br />
nmake sub-src<br />
<br />
* After building Qt the release and debug libraries will be in C:\Qt\qt-all-opensource-src-4.5.2\lib<br />
* 2.8) Create the file C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat and put the following in it<br />
<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
<br />
* 2.8) Make a shortcut to qt-vars.bat on your desktop<br />
Right-click > Properties on the shortcut and set:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
<br />
Rename the command prompt shortcut to "Qt 4.5 Command Prompt".<br />
<br />
You can test it by opening the prompt and typing<br />
qmake --version<br />
To make sure that the version shows 4.5.2<br />
<br />
3) Build llmozlib<br />
<br />
* Investigate: does 'git config core.safecrlf true' solve the windows line ending issue?<br />
<br />
* 3.1) Launch the Qt command prompt, generate the makefile and build the library<br />
cd C:\llmozlib\llmozlib2<br />
qmake CONFIG-=debug<br />
nmake<br />
<br />
If you want to build the debug version of llmozlib run 'qmake CONFIG+=debug'<br />
<br />
* Now llmozlib is built and can be used in the viewer. If you want to build the test applications follow the next steps:<br />
<br />
4) Acquire the test application library dependencies; Glut and GLUI<br />
* a. Glut: http://www.xmission.com/~nate/glut.html Grab the library and header zip.<br />
glut-3.7.6-bin.zip<br />
* a1. Extract the contents of the zip to a c:\llmozlib\llmozlib2\tests\GL<br />
* b. Glui32: http://glui.sourceforge.net/<br />
glui-2.35.zip<br />
* b1. Extract the zip<br />
* b2. Open glui\src\msvc\glui.vcproj. Allow Visual Studio to convert the project.<br />
* b2. Edit src\include\GL\glui.h<br />
* b3. Move "#include <cstdlib>" to the top of the file, just under #define GLUI_GLUI_H<br />
(hence above #include <GL/glut.h><br />
* b4. See http://www.lighthouse3d.com/opengl/glut/ for details on this edit<br />
* Copy the contents of c:\llmozlib\llmozlib2\tests\GL into glue\src\include\GL<br />
* b5. Follow the instructions in the readme.txt to compile the library<br />
Make sure to build a release library<br />
* b6. Copy glui.h and from the include into C:\llmozlib\llmozlib2\tests\GL<br />
* b7. Copy glui32.lib from msvc/lib into C:\llmozlib\llmozlib2\tests\GL<br />
<br />
4) Build testgl and run it. Open the Qt Snapshot command prompt.<br />
cd C:\llmozlib\llmozlib2\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
<br />
5) Build ubrowser and run it. Open the Qt Snapshot command prompt.<br />
cd C:\llmozlib\llmozlib2\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
<br />
6) Build Second life<br />
* [[Get_source_and_compile]]<br />
* When grabbing the source use the webkit branch https://svn.secondlife.com/svn/linden/branches/2009/webkit<br />
* Copy Qt libraries and ssl into C:\linden\webkit\libraries\i686-win32\lib\debug & release<br />
* Copy Qt image plugins into C:\linden\webkit\indra\build-VC80\newview\relwithdebinfo\imageformats<br />
* Copy llmozlib and header into C:\linden\webkit\libraries\i686-win32\*<br />
<br />
Notes:<br />
a. To generate a Visual studio vcproj file you have to use a Qt *commercial* command prompt and run the following:<br />
qmake -tp vc<br />
<br />
b. Make sure all libs and app are built as Multi-threaded Dll or Multi-threaded debug dll.<br />
In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
<br />
Troubleshooting:<br />
1) If you see this, you need to reorder the <cstdlib> and <GL/glut.h> includes.<br />
<br />
C:\Program Files\Microsoft Visual Studio 8\VC\include\stdlib.h(406) : error C2381: 'exit' : redefinition; __declspec(noreturn) differs<br />
../include\GL/glut.h(146) : see declaration of 'exit'<br />
<br />
2) uBrowser crashes on startup in stdlib (vc8crt.dll or similar)<br />
<br />
This happens when you mix debug and release libraries. Make sure you are using<br />
all "release" builds of GLUI and ubrowser.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477783LLQtWebKit2009-09-02T08:55:15Z<p>Callum Linden: /* Linux */</p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from version 4.5.2 of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions (in the form of a README file) can be found [http://hg.secondlife.com/llqtwebkit/src/tip/README-linux.txt here].<br />
<br />
== Previous Versions ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477773LLQtWebKit2009-09-02T08:52:21Z<p>Callum Linden: /* Introduction */</p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from version 4.5.2 of the Qt/WebKit project. It is currently used by the most recent version of the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Linux_Build_Instructions here].<br />
<br />
== Previous Versions ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Mac_OSX_Build_Instructions&diff=477763LLQtWebKit Mac OSX Build Instructions2009-09-02T08:50:40Z<p>Callum Linden: Created page with '<<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page] == Introduction == These are instructions for building the Qt/WebKit library (LLQtWebKit) on Mac O...'</p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Mac OS X as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using XCode 3.1.2 on Mac OS X 10.5.8.<br />
<br />
== Set up ==<br />
Create a directory you'll use for the build. This can be anywhere you like, but for the purposes of the example I'll use ~/llqtwebkit.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the files in the zip into <code>~/llqtwebkit</code> (this should create the directory <code>~/llqtwebkit/llqtwebkit</code><br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using XCode ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the tarball into <code>~/llqtwebkit</code><br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>~/llqtwebkit/qt-all-opensource-src-4.5.2</code><br />
* Review the file <code>~/llqtwebkit/llqtwebkit/qt_patches/merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Open a terminal window and cd to <code>~/llqtwebkit/qt-all-opensource-src-4.5.2</code> directory <br />
* run the following commands (we'll use the QTDIR variable in later steps)<br />
export QTDIR=`pwd`<br />
export PATH=$PATH:$QTDIR/bin<br />
* For each <code>.patch</code> file, run the following command: <br />
patch -p1 < ../llqtwebkit/qt_patches/$PATCH_NAME<br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* In the terminal window, make sure you're still in the directory <code>~/llqtwebkit/qt-all-opensource-src-4.5.2</code><br />
* Run the following command:<br />
./configure -no-framework -fast -no-qt3support -prefix $PWD -static -release -no-xmlpatterns -no-phonon -universal -sdk /Developer/SDKs/MacOSX10.4u.sdk/<br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>yes</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* In the terminal window, make sure you're still in the directory <code>~/llqtwebkit/qt-all-opensource-src-4.5.2</code> <br />
* Run this command:<br />
make<br />
* If you're on a multicore machine, you can speed up the build substantially by using the '-j' argument to make, which will cause it to build files in parallel. For example, on a 4-core system, I use:<br />
make -j4<br />
* This takes a little over an hour on a 4-core Mac Pro.<br />
* After building Qt the built libraries will be in <code>~/llqtwebkit/qt-all-opensource-src-4.5.2/lib</code><br />
* For some reason, this doesn't build one of the libraries we need. I also had to do the following:<br />
cd $QTDIR/src/3rdparty/webkit/JavaScriptCore<br />
make<br />
<br />
== Build LLQtWebKit ==<br />
* In the terminal window, change to the directory <code>~/llqtwebkit/llqtwebkit</code><br />
* Create a symlink to QTDIR in this directory (this allows the xcode project to find it easily):<br />
ln -s $QTDIR QTDIR<br />
* Open the <code>llqtwebkit.xcodeproj</code> project with Xcode<br />
* Build the "Release" configuration of the "llqtwebkit" target<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer.</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=477753LLQtWebKit Win32 Build Instructions2009-09-02T08:48:41Z<p>Callum Linden: </p>
<hr />
<div><<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page]<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the files in the zip to C:\llqtwebkit<br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the tarball into <code>C:\Qt</code> ''(Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>C:\Qt\qt-all-opensource-src-4.5.2</code><br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=477743LLQtWebKit Win32 Build Instructions2009-09-02T08:44:12Z<p>Callum Linden: </p>
<hr />
<div>=== <<< [ Back to LLQtWebKit main page] ===<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the files in the zip to C:\llqtwebkit<br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the tarball into <code>C:\Qt</code> ''(Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>C:\Qt\qt-all-opensource-src-4.5.2</code><br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=477733LLQtWebKit Win32 Build Instructions2009-09-02T08:44:05Z<p>Callum Linden: /* <<< Back to LLQtWebKit main page */</p>
<hr />
<div>==== <<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page] ====<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the files in the zip to C:\llqtwebkit<br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the tarball into <code>C:\Qt</code> ''(Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>C:\Qt\qt-all-opensource-src-4.5.2</code><br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=477723LLQtWebKit Win32 Build Instructions2009-09-02T08:43:41Z<p>Callum Linden: </p>
<hr />
<div>=== <<< [https://wiki.secondlife.com/wiki/LLQtWebKit Back to LLQtWebKit main page] ===<br />
<br />
== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the files in the zip to C:\llqtwebkit<br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the tarball into <code>C:\Qt</code> ''(Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>C:\Qt\qt-all-opensource-src-4.5.2</code><br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit_Win32_Build_Instructions&diff=477713LLQtWebKit Win32 Build Instructions2009-09-02T08:42:21Z<p>Callum Linden: Created page with '== Introduction == These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have bee...'</p>
<hr />
<div>== Introduction ==<br />
These are instructions for building the Qt/WebKit library (LLQtWebKit) on Windows as well as the test applications (testGL, uBrowser, QtTestApp). They have been tested using Microsoft Visual Studio 2005 (SP2) on Windows XP Service Pack 2 and Qt 4.5.2. It is not known if the same instructions work on Windows Vista or Windows 7 or using other versions of Microsoft Visual Studio or Qt.<br />
<br />
== Build the open source OpenSSL library ==<br />
* Make sure a recent version of 'perl' and 'patch' are available on your system.<br />
* Download the OpenSSL 0.9.8k tarball from http://openssl.org/source/openssl-0.9.8k.tar.gz<br />
* Extract the contents to <code>C:\openssl-0.9.8k</code><br />
* Open the "Visual Studio 2005 Command Prompt" (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Patch the OpenSSL distribution - it is broken out of the box on Windows. Copy the following lines into a file called <code>fix.patch</code> in the <code>C:\openssl-0.9.8k\util\</code> directory:<br />
*** Source: http://marc.info/?l=openssl-dev&m=107628900919852&q=raw<br />
*** openssl-0.9.7c/util/mk1mf.pl Fri Mar 14 17:29:18 2003<br />
--- openssl-0.9.7c-miket/util/mk1mf.pl Sat Feb 7 21:58:57 2004<br />
***************<br />
*** 485,490 ****<br />
--- 485,495 ----<br />
chop;<br />
<br />
($key,$val)=/^([^=]+)=(.*)/;<br />
+ <br />
+ # On some Windows machines, $val has linefeeds at the end, which confuses<br />
+ # subsequent code in this file. So we strip all whitespace at the end.<br />
+ $val =~ s/\s+$//;<br />
+ <br />
if ($key eq "RELATIVE_DIRECTORY")<br />
{<br />
if ($lib ne "")<br />
then run this command from the <code>C:\openssl-0.9.8k\util\</code> directory: <br />
<code>patch -p0 mk1mf.pl < fix.patch</code><br />
<br />
* Execute the following commands to build OpenSSL:<br />
cd C:\openssl-0.9.8k<br />
perl Configure VC-WIN32<br />
ms\do_masm<br />
nmake -f ms\ntdll.mak<br />
* After a few minutes, the libraries <code>libeay32.dll</code> and <code>ssleay32.dll</code> will be built in the <code>C:\openssl-0.9.8k\out32dll</code> directory - confirm they exist - they will be needed later.<br />
<br />
== Acquire LLQtWebKit source code ==<br />
* In a Web browser, navigate to http://hg.secondlife.com/llqtwebkit/<br />
* Select "get source->zip" from menu<br />
* A zip file of the source code will be downloaded<br />
* Extract the files in the zip to C:\llqtwebkit<br />
* Do not build anything yet - some of the files that were just downloaded will be used to modify the Qt source code<br />
<br />
== Build the open source version of Qt 4.5.2 using Microsoft Visual Studio ==<br />
=== Downloading and patching the Qt source ===<br />
* Download the Qt 4.5.2 source from ftp://ftp.qtsoftware.com/qt/source/qt-all-opensource-src-4.5.2.tar.gz (Approximately 125MB)<br />
* Extract the tarball into <code>C:\Qt</code> ''(Note: using Cygwin's tar command might not work. It results in an '''Access is Denied''' error when running configure below. Use WinZip or some other tool instead.)''.<br />
* This may take some as the archive contains a lot of files<br />
* You should now have a directory <code>C:\Qt\qt-all-opensource-src-4.5.2</code><br />
* Review the file <code>C:\llqtwebkit\qt_patches\merged_into_qt</code> to determine which patches need to be applied. Some patches are no longer needed with Qt 4.5.2.<br />
* Copy the <code>.patch</code> files that are required from the <code>C:\llqtwebkit\qt_patches\</code> to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory<br />
* If you do not have an MSVC command prompt open, open one now. (Start Menu->Microsoft Visual Studio 2005->Visual Studio Tools->Visual Studio 2005 Command Prompt)<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* For each <code>.patch</code> file, run the following command: <br />
<code>patch -p1 < $PATCH_NAME</code><br />
* where <code>$PATCH_NAME</code> is the filename of the patch file<br />
<br />
=== Configure Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command: <br />
<code>configure -debug-and-release -no-qt3support -prefix C:\Qt\qt-all-opensource-src-4.5.2 -qt-libjpeg -qt-libpng -openssl-linked -I C:\openssl-0.9.8k\include -L C:\openssl-0.9.8k\out32dll</code><br />
* When you are asked if you want to use the Commercial or Open Source version type <code>o</code> to select Open Source and press <enter><br />
* When the license agreement appears, if you agree type <code>y</code> <enter><br />
* This operation takes around 10-15 minutes on a typical development system<br />
<br />
=== Build Qt ===<br />
* Change to the <code>C:\Qt\qt-all-opensource-src-4.5.2</code> directory <br />
* Run this command:<br />
<code>nmake sub-src</code><br />
* This operation takes around 1-2 hours on a typical development system<br />
* After building Qt the release and debug libraries will be in <code>C:\Qt\qt-all-opensource-src-4.5.2\lib</code><br />
<br />
=== Configure a Qt runtime environment ===<br />
* Copy the OpenSSL dynamic libraries (<code>C:\openssl-0.9.8k\out32dll\libeay32.dll</code> and <code>C:\openssl-0.9.8k\out32dll\ssleay32.dll</code>) to the Qt binary directory (<code>C:\qt\qt-all-opensource-src-4.5.2\bin</code>)<br />
* Create the file <code>C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat</code> and put the following in it:<br />
@echo off<br />
echo Setting up a Qt environment...<br />
set QTDIR=C:\Qt\qt-all-opensource-src-4.5.2<br />
set PATH=C:\Qt\qt-all-opensource-src-4.5.2\bin;%PATH%<br />
set QMAKESPEC=win32-msvc2005<br />
call "C:\Program Files\Microsoft Visual Studio 8\Common7\Tools\vsvars32.bat"<br />
* Make a shortcut to <code>qt-vars.bat</code> on your desktop<br />
* Right-click on the shortcut and set the following properties:<br />
Target: %COMSPEC% /k "C:\Qt\qt-all-opensource-src-4.5.2\bin\qt-vars.bat"<br />
Start in: C:\Qt\qt-all-opensource-src-4.5.2<br />
* Rename the shortcut to "Qt 4.5.2 Command Prompt".<br />
* Test it by opening the prompt and typing<br />
qmake --version<br />
* Confirm that the Qt version displayed is 4.5.2<br />
<br />
<br />
== Build LLQtWebKit ==<br />
* Launch the Qt command prompt and enter the following in the command prompt:<br />
cd C:\llqtwebkit<br />
qmake CONFIG-=debug<br />
nmake<br />
* This operation takes just a few seconds on a typical development system<br />
* If you want to build the debug version of LLQtWebKit, use <code>qmake CONFIG+=debug</code> instead<br />
* Now LLQtWebKit is built and can be used in the Second Life viewer. <br />
* If you want to build the test applications, follow the next steps:<br />
<br />
== Acquire test application dependencies == <br />
=== Glut ===<br />
* Glut is a cross-platform library that manages OpenGL state and creation/destruction of OpenGL windows<br />
* The author provides a library and header for Windows so you do not have to build them yourself<br />
* Download the library and headers from http://www.xmission.com/~nate/glut/glut-3.7.6-bin.zip<br />
* Extract the contents of the zip to a new folder called <code>C:\llqtwebkit\tests\GL</code><br />
<br />
=== GLUI ===<br />
* Glut is a cross-platform library that renders UI components in the uBrowser test application<br />
* The author does not provide libraries for Windows so you have to build them yourself.<br />
* Download the source code from http://sourceforge.net/projects/glui/files/Source/2.36/glui-2.36.zip/download<br />
* Extract to <code>C:\glui-2.36</code><br />
* Copy <code>glut.h</code> from <code>C:\llqtwebkit\tests\GL</code> to <code>C:\glui-2.36\src\include\GL</code> as it is required to build GLUI<br />
* Open <code>C:\glui-2.36\src\msvc\glui.sln</code> and let Visual Studio convert the project<br />
* Select "Release" configuration of "_glui library" project and build it as normal<br />
* Copy the GLUI header (<code>C:\glui-2.36\src\include\GL\glui.h</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
* Copy the GLUI library you just built (<code>C:\glui-2.36\src\msvc\lib\glui32.lib</code>) to <code>C:\llqtwebkit\tests\GL</code><br />
<br />
== Build test applications == <br />
=== testGL ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following:<br />
cd C:\llqtwebkit\tests\testgl<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\testgl.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
=== uBrowser ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\ubrowser<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\ubrowser.exe<br />
* <font color="red">Important</font>: <code>glui.h</code> contains a pragma that forces the build to always link against the release version - <code>glut32.lib</code> - instead of the debug version. This means building a debug version of uBrowser is currently broken.<br />
<br />
=== QtTestApp ===<br />
* Open the Qt command prompt using the shortcut you made and enter the following: <br />
cd C:\llqtwebkit\tests\qttestapp<br />
qmake CONFIG-=debug<br />
nmake<br />
..\GL\qttestapp.exe<br />
* If you want to build the debug version, use <code>qmake CONFIG+=debug</code> instead and run <code>nmake clean</code> first<br />
<br />
== Notes ==<br />
* Make sure all libraries and applications are built as Multi-threaded Dll or Multi-threaded debug dll. In Visual Studio this is in Properties->configuration->c/c++->code generation->runtime library<br />
* Make sure you do not mix release and debug versions of libraries and applications</div>Callum Lindenhttps://wiki.secondlife.com/w/index.php?title=LLQtWebKit&diff=477703LLQtWebKit2009-09-02T08:40:06Z<p>Callum Linden: /* Build instructions */</p>
<hr />
<div>== Introduction ==<br />
LLQtWebKit is a static library that renders Web content into a memory buffer using code from version 4.5.2 of the Qt/WebKit project. It is currently used by the [https://wiki.secondlife.com/wiki/Media_Rendering_Plugin_Framework Media Plugin API] to render Web content in Second Life.<br />
<br />
== Browse the code ==<br />
The code for LLQtWebKit is stored in a Mercurial code repository. You can browse the code [http://hg.secondlife.com/llqtwebkit/src/ here] using a Web browser. <br />
<br />
== Build instructions ==<br />
==== Windows ====<br />
The Windows version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Win32_Build_Instructions here].<br />
<br />
==== Mac OSX ====<br />
The Mac OSX version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Mac_OSX_Build_Instructions here].<br />
<br />
==== Linux ====<br />
The Linux version of the build instructions can be found [https://wiki.secondlife.com/wiki/LLQtWebKit_Linux_Build_Instructions here].<br />
<br />
== Previous Versions ==<br />
* [https://wiki.secondlife.com/wiki/LLMozLib2 LLMozLib2] - the initial version of a Web content rendering library for Second Life that used the Mozilla/Gecko rendering engine. This is now deprecated.<br />
<br />
* [https://wiki.secondlife.com/wiki/Qt_Webkit_Win32_Build_Instructions Qt WebKit] - a poorly named version of the Web content rendering engine for Second Life that uses Qt/WebKit to render but retained the same method/class names from LLMozLib2. This is now deprecated.</div>Callum Linden