xoreos Wiki - User contributions [en]

Compiling xoreos

2019-03-02T05:05:18Z

Seedhartha: /* Libraries */

This page gives a few tips and pointers on how to compile xoreos on various platforms.
__TOC__

==Compiler and build system==

xoreos is written in C++, so a C++ compiler, like [https://gcc.gnu.org/ GCC] or [http://clang.llvm.org/ clang] is required. xoreos follows the C++11 standard. It has two build systems: [https://en.wikipedia.org/wiki/GNU_build_system Autotools] ([https://www.gnu.org/software/autoconf/ Autoconf], [https://www.gnu.org/software/automake/ Automake] and [https://www.gnu.org/software/libtool/ Libtool]) and [https://en.wikipedia.org/wiki/CMake CMake]. Use whichever you feel more comfortable with.

===GNU/Linux===

On Debian-based distributions (including Ubuntu), you should be able to install the required compiler and build system packages with

<nowiki>sudo apt-get install libc6-dev g++ make autoconf automake libtool gettext cmake</nowiki>

On Arch Linux, you can install the necessary packages with

<nowiki>sudo pacman -S base-devel cmake</nowiki>

On other distributions, it should work similarily.

===Mac OS X===

Due to the dependency on SDL2 (see below), you need at least Mac OS X 10.5 if you use a precompiled SDL2 library, and at least Mac OS X 10.7 if you're compiling SDL2 yourself.

===Windows===

Since Visual Studio does not work with autotools, you have to use the CMake build system if you want to compile xoreos with Visual Studio. If you're using [http://www.mingw.org/ MinGW], however, you're free to choose either build system.

On Windows, it is recommended that instead of Visual Studio, you use [https://msys2.github.io/ MSYS2] together with [https://mingw-w64.org/ Mingw-w64] (which can produce both 32-bit and 64-bit binaries). MSYS2 provides a package manager, with which you can install xoreos' library dependencies very easily.

You can install the 32-bit toolchain in MSYS2 with

<nowiki>pacman -S base-devel git mingw-w64-i686-toolchain mingw-w64-i686-cmake</nowiki>

You can install the 64-bit toolchain in MSYS2 with

<nowiki>pacman -S base-devel git mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake</nowiki>

==Libraries==

xoreos uses the following libraries to function:

* [https://en.wikipedia.org/wiki/Iconv iconv]
* [http://www.zlib.net/ zlib] (>= 1.2.3.4)
* [http://tukaani.org/xz/ liblzma] (>= 5.0.5)
* [http://www.xmlsoft.org/ libxml2] (>= 2.8.0)
* [http://www.boost.org/ Boost] (>= 1.53.0)
** Boost.Utility
** Boost.StringAlgo
** Boost.System
** Boost.Filesystem
** Boost.Regex
** Boost.Unordered
** Boost.Hash
** Boost.Date_Time
** Boost.Function
** Boost.Bind
** Boost.Uuid
** Boost.Smart_Ptr
** Boost.ScopeExit
** Boost.Atomic
** Boost.Locale
* [https://en.wikipedia.org/wiki/OpenGL OpenGL] (>= 2.1)
* [https://www.libsdl.org/ SDL2] (>= 2.0.0)
* [http://www.freetype.org/ FreeType 2] (>= 2.4.0 (libtool number >= 11.0.5))
* [https://en.wikipedia.org/wiki/OpenAL OpenAL] (>= 1.12) ('''See below''')
* [http://www.underbit.com/products/mad/ MAD] (>= 0.15.1b)
* [https://www.xiph.org/downloads/ libogg] (>= 1.2.0)
* [https://www.xiph.org/downloads/ libvorbis] (>= 1.3.1)
* [http://www.audiocoding.com/faad2.html libfaad] (>= 2.7)
* [https://www.xvid.org/ libxvidcore] (>= 1.2.2)
* [https://www.webmproject.org/code/ libvpx] (>= 1.6.0)

On Debian-based GNU/Linux distribution (including Ubuntu), you should be able to install these libraries and their development packages with

sudo apt-get install zlib1g-dev liblzma-dev libxml2-dev libboost-all-dev libsdl2-dev \
libfreetype6-dev libopenal-dev libmad0-dev libogg-dev libvorbis-dev libfaad-dev \
libxvidcore-dev libvpx-dev

On Arch Linux, you can install these dependencies with

sudo pacman -S zlib xz libxml2 boost boost-libs sdl2 freetype2 openal libmad libogg \
libvorbis faad2 xvidcore libvpx

Other GNU/Linux distributions should work similarily.

On Windows, if you're using MSYS2, you can install these dependencies for 32-bit with

pacman -S mingw-w64-i686-zlib mingw-w64-i686-xz mingw-w64-i686-libxml2 \
mingw-w64-i686-boost mingw-w64-i686-SDL2 mingw-w64-i686-freetype \
mingw-w64-i686-openal mingw-w64-i686-libmad mingw-w64-i686-libogg \
mingw-w64-i686-libvorbis mingw-w64-i686-faad2 mingw-w64-i686-xvidcore \
mingw-w64-i686-libvpx

On Windows, if you're using MSYS2, you can install these dependencies for 64-bit with

pacman -S mingw-w64-x86_64-zlib mingw-w64-x86_64-xz mingw-w64-x86_64-libxml2 \
mingw-w64-x86_64-boost mingw-w64-x86_64-SDL2 mingw-w64-x86_64-freetype \
mingw-w64-x86_64-openal mingw-w64-x86_64-libmad mingw-w64-x86_64-libogg \
mingw-w64-x86_64-libvorbis mingw-w64-x86_64-faad2 mingw-w64-x86_64-xvidcore \
mingw-w64-x86_64-libvpx

Windows users not using MSYS2 will have to visit each website manually and download a precompiled version, or, if not available, download the source and compile the library themselves. Alternatively, vcpkg can be used to install most of these libraries.

=== A note on OpenAL ===

On Mac OS X, we're using Apple's OpenAL implementation, so OpenAL does not need to be installed separately there.

On both GNU/Linux and Microsoft Windows, we require [http://kcat.strangesoft.net/openal.html OpenAL Soft]. There is a propriety OpenAL implementation by Creative Labs, Inc. for Microsoft Windows, which can be found at [http://openal.org/ http://openal.org/], but it's unfortunately old, outdated and abandoned. We do not recommend its use.

Likewise, on NetBSD and other systems using pkgsrc, you should use [http://pkgsrc.se/audio/openal-soft openal-soft] instead of [http://pkgsrc.se/audio/openal openal].

==Compiling xoreos==

Make sure you have your compiler, build system and libraries installed correctly. Then open a terminal and change into the directory of your sources.

===autotools===

Type

<nowiki>./autogen.sh && ./configure && make</nowiki>

The binary can be found in the src subdirectory, called "xoreos" or, on Windows, "xoreos.exe".

Optional, non-conventional ./configure flags:

{|
|
* --with-werror  
|| Compile with -Werror
|-
|
* --without-warnings  
|| Compile without the extra warnings enabled
|-
|
* --with-lto  
|| Compile with link-time optimization
|-
|
* --disable-external-glew  
|| Always compile against the internal GLEW libraries
|}

===CMake ===

Type

<nowiki>cmake . && make</nowiki>

The binary can be found in the bin subdirectory, called "xoreos" or, on Windows, "xoreos.exe".

Please read [http://www.cmake.org/runningcmake/ Running CMake] on the CMake website for in-depth information on invoking CMake.

Optional, non-conventional cmake flags:

{|
|
* -DBoost_USE_STATIC_LIBS=on  
|| Link Boost statically instead of dynamically
|-
|
* -DGLEW_INTERNAL=on  
|| Always use internal GLEW library
|}

'''Note''': The CMake's stock FindBoost.cmake doesn't correctly detect dependencies when linking statically. In this case, xoreos might fail to link, missing symbols for ICU, when linking Boost statically.

Moreover, if you're running GNU/Linux and have wrapper scripts installed that force the building of "hardened" binaries (often called "hardening-wrapper", but differs between Linux distributions), compiling xoreos might fail during the linking stage, when using statically linking Boost libraries. This is due to those static Boost libraries being incompatible with the compiler option "-fPIE", which is often added by hardening wrapper scripts. A workaround is to disable -fPIE for this compilation (which is distribution-specific).

==Unit tests==

On both build systems,

<nowiki>make check</nowiki>

compiles and runs our unit tests.

==Running xoreos==

Please have a look at the [[Running xoreos]] page.

Compiling xoreos

2019-03-01T16:54:04Z

Seedhartha:

This page gives a few tips and pointers on how to compile xoreos on various platforms.
__TOC__

==Compiler and build system==

xoreos is written in C++, so a C++ compiler, like [https://gcc.gnu.org/ GCC] or [http://clang.llvm.org/ clang] is required. xoreos follows the C++11 standard. It has two build systems: [https://en.wikipedia.org/wiki/GNU_build_system Autotools] ([https://www.gnu.org/software/autoconf/ Autoconf], [https://www.gnu.org/software/automake/ Automake] and [https://www.gnu.org/software/libtool/ Libtool]) and [https://en.wikipedia.org/wiki/CMake CMake]. Use whichever you feel more comfortable with.

===GNU/Linux===

On Debian-based distributions (including Ubuntu), you should be able to install the required compiler and build system packages with

<nowiki>sudo apt-get install libc6-dev g++ make autoconf automake libtool gettext cmake</nowiki>

On Arch Linux, you can install the necessary packages with

<nowiki>sudo pacman -S base-devel cmake</nowiki>

On other distributions, it should work similarily.

===Mac OS X===

Due to the dependency on SDL2 (see below), you need at least Mac OS X 10.5 if you use a precompiled SDL2 library, and at least Mac OS X 10.7 if you're compiling SDL2 yourself.

===Windows===

Since Visual Studio does not work with autotools, you have to use the CMake build system if you want to compile xoreos with Visual Studio. If you're using [http://www.mingw.org/ MinGW], however, you're free to choose either build system.

On Windows, it is recommended that instead of Visual Studio, you use [https://msys2.github.io/ MSYS2] together with [https://mingw-w64.org/ Mingw-w64] (which can produce both 32-bit and 64-bit binaries). MSYS2 provides a package manager, with which you can install xoreos' library dependencies very easily.

You can install the 32-bit toolchain in MSYS2 with

<nowiki>pacman -S base-devel git mingw-w64-i686-toolchain mingw-w64-i686-cmake</nowiki>

You can install the 64-bit toolchain in MSYS2 with

<nowiki>pacman -S base-devel git mingw-w64-x86_64-toolchain mingw-w64-x86_64-cmake</nowiki>

==Libraries==

xoreos uses the following libraries to function:

* [https://en.wikipedia.org/wiki/Iconv iconv]
* [http://www.zlib.net/ zlib] (>= 1.2.3.4)
* [http://tukaani.org/xz/ liblzma] (>= 5.0.5)
* [http://www.xmlsoft.org/ libxml2] (>= 2.8.0)
* [http://www.boost.org/ Boost] (>= 1.53.0)
** Boost.Utility
** Boost.StringAlgo
** Boost.System
** Boost.Filesystem
** Boost.Regex
** Boost.Unordered
** Boost.Hash
** Boost.Date_Time
** Boost.Function
** Boost.Bind
** Boost.Uuid
** Boost.Smart_Ptr
** Boost.ScopeExit
** Boost.Atomic
** Boost.Locale
* [https://en.wikipedia.org/wiki/OpenGL OpenGL] (>= 2.1)
* [https://www.libsdl.org/ SDL2] (>= 2.0.0)
* [http://www.freetype.org/ FreeType 2] (>= 2.4.0 (libtool number >= 11.0.5))
* [https://en.wikipedia.org/wiki/OpenAL OpenAL] (>= 1.12) ('''See below''')
* [http://www.underbit.com/products/mad/ MAD] (>= 0.15.1b)
* [https://www.xiph.org/downloads/ libogg] (>= 1.2.0)
* [https://www.xiph.org/downloads/ libvorbis] (>= 1.3.1)
* [http://www.audiocoding.com/faad2.html libfaad] (>= 2.7)
* [https://www.xvid.org/ libxvidcore] (>= 1.2.2)
* [https://www.webmproject.org/code/ libvpx] (>= 1.6.0)

On Debian-based GNU/Linux distribution (including Ubuntu), you should be able to install these libraries and their development packages with

sudo apt-get install zlib1g-dev liblzma-dev libxml2-dev libboost-all-dev libsdl2-dev \
libfreetype6-dev libopenal-dev libmad0-dev libogg-dev libvorbis-dev libfaad-dev \
libxvidcore-dev libvpx-dev

On Arch Linux, you can install these dependencies with

sudo pacman -S zlib xz libxml2 boost boost-libs sdl2 freetype2 openal libmad libogg \
libvorbis faad2 xvidcore libvpx

Other GNU/Linux distributions should work similarily.

On Windows, if you're using MSYS2, you can install these dependencies for 32-bit with

pacman -S mingw-w64-i686-zlib mingw-w64-i686-xz mingw-w64-i686-libxml2 \
mingw-w64-i686-boost mingw-w64-i686-SDL2 mingw-w64-i686-freetype \
mingw-w64-i686-openal mingw-w64-i686-libmad mingw-w64-i686-libogg \
mingw-w64-i686-libvorbis mingw-w64-i686-faad2 mingw-w64-i686-xvidcore \
mingw-w64-i686-libvpx

On Windows, if you're using MSYS2, you can install these dependencies for 64-bit with

pacman -S mingw-w64-x86_64-zlib mingw-w64-x86_64-xz mingw-w64-x86_64-libxml2 \
mingw-w64-x86_64-boost mingw-w64-x86_64-SDL2 mingw-w64-x86_64-freetype \
mingw-w64-x86_64-openal mingw-w64-x86_64-libmad mingw-w64-x86_64-libogg \
mingw-w64-x86_64-libvorbis mingw-w64-x86_64-faad2 mingw-w64-x86_64-xvidcore \
mingw-w64-x86_64-libvpx

Windows users not using MSYS2 will have to visit each website manually and download a precompiled version, or, if not available, download the source and compile the library themselves.

=== A note on OpenAL ===

On Mac OS X, we're using Apple's OpenAL implementation, so OpenAL does not need to be installed separately there.

On both GNU/Linux and Microsoft Windows, we require [http://kcat.strangesoft.net/openal.html OpenAL Soft]. There is a propriety OpenAL implementation by Creative Labs, Inc. for Microsoft Windows, which can be found at [http://openal.org/ http://openal.org/], but it's unfortunately old, outdated and abandoned. We do not recommend its use.

Likewise, on NetBSD and other systems using pkgsrc, you should use [http://pkgsrc.se/audio/openal-soft openal-soft] instead of [http://pkgsrc.se/audio/openal openal].

==Compiling xoreos==

Make sure you have your compiler, build system and libraries installed correctly. Then open a terminal and change into the directory of your sources.

===autotools===

Type

<nowiki>./autogen.sh && ./configure && make</nowiki>

The binary can be found in the src subdirectory, called "xoreos" or, on Windows, "xoreos.exe".

Optional, non-conventional ./configure flags:

{|
|
* --with-werror  
|| Compile with -Werror
|-
|
* --without-warnings  
|| Compile without the extra warnings enabled
|-
|
* --with-lto  
|| Compile with link-time optimization
|-
|
* --disable-external-glew  
|| Always compile against the internal GLEW libraries
|}

===CMake ===

Type

<nowiki>cmake . && make</nowiki>

The binary can be found in the bin subdirectory, called "xoreos" or, on Windows, "xoreos.exe".

Please read [http://www.cmake.org/runningcmake/ Running CMake] on the CMake website for in-depth information on invoking CMake.

Optional, non-conventional cmake flags:

{|
|
* -DBoost_USE_STATIC_LIBS=on  
|| Link Boost statically instead of dynamically
|-
|
* -DGLEW_INTERNAL=on  
|| Always use internal GLEW library
|}

'''Note''': The CMake's stock FindBoost.cmake doesn't correctly detect dependencies when linking statically. In this case, xoreos might fail to link, missing symbols for ICU, when linking Boost statically.

Moreover, if you're running GNU/Linux and have wrapper scripts installed that force the building of "hardened" binaries (often called "hardening-wrapper", but differs between Linux distributions), compiling xoreos might fail during the linking stage, when using statically linking Boost libraries. This is due to those static Boost libraries being incompatible with the compiler option "-fPIE", which is often added by hardening wrapper scripts. A workaround is to disable -fPIE for this compilation (which is distribution-specific).

==Unit tests==

On both build systems,

<nowiki>make check</nowiki>

compiles and runs our unit tests.

==Running xoreos==

Please have a look at the [[Running xoreos]] page.

Main Page

2019-02-08T04:16:52Z

Seedhartha: /* Index */

xoreos is an open source implementation of Bioware's Aurora engine and its derivatives, licensed under the terms of the GNU General Public License version 3 (or later).

In order to accurately reimplement these games, we need to research how all of the mechanics work. If you feel like crawling deep into the bowels of the Aurora engine, or have already done so, please feel free to document your newly gained understandings here.

'''NOTE:''' Thanks to spambots, I had to close account registrations. Please [[contact us]] to get an account.

== Index ==

* [[Running xoreos]], intro on how to use xoreos
* [[Running xoreos-tools]], intro on how to use the xoreos-tools
* [[Developer Central]], technical documentation and info for developers
* [[Games]], a list of supported games
* [[TODO]], a list of things left to do
* [[contact us|Contact]], get in contact with the developers

2018-06-17T09:42:45Z

Seedhartha:

== KotOR / KotOR 2 ==

Number one priority is to implement core gameplay of the original games, i.e., exploration, conversations/cutscenes, combat and GUI, which implies implementation of resource management, graphics, scripting, RPG and sound systems. Then goes the extra stuff, e.g., minigames, auxiliary menus, graphics improvements, networking, etc. Below is a rough list of features required to achieve feature parity with the original games and areas for improvement.

Numbers in square brackets represent the order in which we believe these features should be implemented.

=== Phase 1 - Necessities ===

* General
** Pathfinding
** Party management

* Scripting
** Implement missing functions [4]

* Conversations/cutscenes
** Camera setup [1]
** Scripted animations [2]
** Continuous flow [3]
** Activation distance

* Combat
** Turn based action queue
** Normal attacks
** Death, body bags

* GUI
** Character generation
** Save/load
** In-game
*** Equip
*** Inventory
*** Level up
*** Party selection

=== Phase 2 - Auxiliary ===

* General
** Stores

* Conversations/cutscenes
** Alien/droid voice over in KotOR 2

* Combat
** Force Powers
** Grenades
** Mines

* GUI
** In-game
*** Character sheet
*** Abilities
*** Messages
*** Quests
*** Map

=== Phase 3 - Miscellaneous ===

* GUI
** Main menu
*** Movies
*** Options
** In-game
*** Options

* Minigames
** Swoop racing
** Pazaak

* Graphics
** Shader based skeletal animation

Roadmap

2018-06-17T09:09:10Z

Seedhartha:

== KotOR / KotOR 2 ==

Number one priority is to implement core gameplay of the original games, i.e., exploration, conversations/cutscenes, combat and GUI, which implies implementation of resource management, graphics, scripting, RPG and sound systems. Then goes the extra stuff, e.g., minigames, auxiliary menus, graphics improvements, networking, etc. Below is a rough list of features required to achieve feature parity with the original games and areas for improvement.

Numbers in square brackets represent the order in which we believe these features should be implemented.

=== Phase 1 - Necessities ===

* General
** Pathfinding
** Party members (switch between, follower behavior)

* Scripting
** Implement missing functions

* Conversations/cutscenes
** Scripted characters animations
** Camera setup
** Activation distance
** Alien and droid voice over in KotOR 2
** Continuous flow when there are no selectable replies

* Combat
** Turn based game mode, action queue
** Action execution (closing in, animation)
** DnD based hit chance and damage calculations
** Death + body bags

* GUI
** Character generation
** Save/load
** In-game
*** Equip
*** Inventory
*** Level up
*** Party selection

=== Phase 2 - Auxiliary ===

* GUI
** In-game
*** Character sheet
*** Abilities
*** Messages
*** Quests
*** Map

=== Phase 3 - Miscellaneous ===

* GUI
** Main menu
*** Movies
*** Options
** In-game
*** Options

* Minigames
** Swoop racing
** Pazaak

* Graphics
** Shader based skeletal animation