Qpsycle/setup/alpha/Building qpsycle
From Psycle Wiki
qpsycle setup pages: Getting qpsycle | Building qpsycle | Configuring sound | Building psycle plugins | Getting the latest updates | Contributing code | Troubleshooting
NOTE: these are basic instructions for setting up the svn development code for qpsycle. You'll probably encounter a lot of problems in the process :) Please add any problems you encounter and any solutions to this page to help other people.
For now, there's a few things hardcoded which means it probably won't work... have a try anyway ;)
Contents |
[edit] installing external packages needed by qpsycle
In order to build qpsycle you will need to get some development libaries for your system.
[edit] Linux
- Qt 4.3 (or the release candidate 4.4 that is working perfectly with QPsycle)
- alsa, jack or esound
- gcc g++
- pkg-config
- boost
- libxml++
- libxml2
For Fedora and redhat-based distros:
yum install gcc-c++ yum install pkg-config yum install ....... the Qt packages .......... yum install ..... the boost signals packages ......
then install the development files for one of the audio output libraries supported by qpsycle:
yum install alsa-tools alsa-lib alsa-utils alsa-lib-devel yum install jack-audio-connection-kit-devel
optionally:
yum install qjackctl
For debian and debian-based distros (e.g. ubuntu):
aptitude install g++ aptitude install pkg-config aptitude install libqt4-core libqt4-gui libqt4-dev aptitude install libboost-signals-dev
then install the development files for one or more of the audio output libraries supported by xpsycle:
aptitude install libasound-dev aptitude install libesd-dev aptitude install libjack0.100.0-dev ...
(note libjack version number might change, try
aptitude search libjack
to find which is latest version.)
[edit] Windows
[edit] GNU gcc/mingw (recommended)
Download the psycle dev-pack for ms-windows.
Unpack it to a destination which doesn't contain spaces in the path.
Get the Qt for mingw pre-built package from the trolltech website.
Note: Make sure to get Qt version 4.3 or above, this is required for mingw!
During the installation point Qt to the mingw location in the dev-pack to x:\path\to\psycle-dev-pack-for-mswindows\opt\mingw. You can safely ignore the warning about w32api.h not being 3.2, the dev-pack contains a higher version.
[edit] Microsoft's Visual C++
If you want to use Visual Studio you should get the Qt Source Code from Trolltech and compile it yourself by running in the Qt main dir:
configure.exe -debug_and_release nmake
Note that if you want to compile with Visual C++ 2005 you should install Visual Studio 2005 SP1 and KB930198 then Visual C++ 2005 Express will be fuly supported by Qt Open Source Edition and by QPsycle. Visual C++ 2008 Express is not fully supported by Qt for now and it needs some tweaking in order to work with QPsycle.
See also Qpsycle/developer/notes
[edit] Mac OS X
In order to proceed, you must first have the XCode tools installed from your Mac OS X installation disc. If you've lost these, you could always register/login to your free ADC account and download XCode there. XCode contains a lot of libraries, and gcc, amongst others (like distcc for distributed compiling etc..).
First you will need to get QT for macOS, this page also guides you thru installing QT. Now you need to get pkg-config, if using fink open a terminal, and type "fink install pkgconfig" or when using macports: "port install pkgconfig". Follow this same step for installing boost, and alsa or jack (remember to set your preferred driver in your configuration file later on).
You should be all set now.
[edit] building qpsycle
[edit] Linux / Mac OS X
go to your qpsycle folder
cd qpsycle
next type
qmake-qt4 -recursive && make
or just
qmake -recursive && make
[edit] Windows
[edit] GNU gcc/mingw
Make sure you have all the needed libs installed, see section above if not. Note: Make sure you have Qt version 4.3 or above, this is required for mingw!
Start a command prompt. You can use the provided link in the Qt section of your start menu, or if you have the psycle dev-pack for ms-windows, start either bash-in-rxvt-terminal.cmd or microsoft-shell-in-microsoft-terminal.cmd (the former starts a posix shell, so you will need to adapt the syntax of the following commands to posix syntax).
If you started the command prompt by using the the provided link in the Qt section of your start menu, type:
x:\path\to\psycle-dev-pack-for-mswindows\libexec\main no-msys
If you started the command prompt by using the dev-pack, type:
echo %QTDIR%
If the command does not return the dir where you the installed Qt libs, type:
set QTDIR=%ProgramFiles%\Qt set PATH=%QTDIR%\bin;%PATH%
where %ProgramFiles%\Qt is the dir where you installed the Qt libs.
From the command prompt, if:
echo %QMAKESPEC%
does not return win32-g++, then type:
set QMAKESPEC=win32-g++
Then navigate to your qpsycle source directory and type:
qmake -recursive mingw32-make
[edit] Microsoft's Visual C++
You have to install gtkmm devlopement enviroment in order to compile QPsycle
Navigating to your qpsycle source directory and typing:
qmake nmake
remeber to set your QMAKESPEC enviroment variable to msvc!
set QMAKESPEC=win32-msvc2005
See also Qpsycle/developer/notes
[edit] OK?
If it went fine, that means it compiled fine.
Next step is to put the configuration file in the right place, then edit it, then see if it works.
[edit] Linux / Mac OS X
Copy to your home directory.
cp .xpsycle.xml ~
The config file is set up by default to use the alsa driver. To change the driver, see Qpsycle/setup/alpha/Configuring sound.
Test it and see if it works with:
./qpsycle
[edit] Windows
Copy .xpsycle.xml in your Documents And Settings folder.
cp .xpsycle.xml C:\Documents And Settings\(Your User Name)\
Currently, the audio driver will not be enabled by default so you have to open Configuration->Audio Settings in QPsycle and click on Restart Driver
