CONTENTS ======== 1.) ADTF 2 Installation 2.) License 3.) Supported Distributions (32 bit/64 bit) 4.) Graphics Acceleration 5.) Used Libraries 6.) Optional Libraries 1.) ADTF 2 Installation ======================= Along this file you should have receive a file called adtf-VERSION.run (where VERSION stands for the specific version of the package). You can launch this installer by running "sh adtf-VERSION.run" on the command line or by launching it from your favourite file manager. The installer will check for some optional libraries on the system. You can continue the installation without these libraries being present on your system, but will lose some extended functionality. Please see section "Optional Libraries" for a list of such libraries and for hints on how to install them. The affected ADTF components will become useable even if you install these libraries after ADTF. After you have passed these checks, you are prompt for a directory where the installer should copy the adtf package to. In most cases you can safely accept the proposed directory in your home directory. Please mind that if you want to install adtf in a system wide manner in a directory such as "/opt/adtf", you have to run the installer as root user in order to gain the necessary permissions to copy files to such a location. After installation has completed you can run the binary "adtf_devenv" in the "bin" sub directory of your installation directory. 2.) License ============ On the first start the registration dialog should pop up. Here you can enter your network license details or load a license file. ADTF will store your license in the file "HOME/.adtf/adtf2.lic" (where HOME stands for your users home directory). If you want to install a license for all users, copy the license file to "/etc/adtf2.lic" (you will require root privileges to do so). For the license text see license/aev_license_extern.txt and see 5.) regarding used third party components. 3.) Supported Distributions (64 bit only) =========================================== ADTF will most likely run on any recent Linux distribution but has ONLY been tested to run on the following distributions: - Ubuntu 12.04 or later If you are not running one of these tested distributions make at least sure that libc is a version >= 2.15 and libstdc++ >= 6.0.16. 4.) Graphics Acceleration ========================= For best performance and error free functionality the hardware acceleration for your graphics card must be enabled. On Ubuntu 9.04 with Intel cards the default installation uses a software renderer. To change the settings contact your local administrator and read the following links for further information: - http://ubuntuforums.org/showthread.php?t=589834 (2009-12-17) - http://intellinuxgraphics.org/install.html (2009-12-17) - https://wiki.ubuntu.com/X/Troubleshooting/IntelPerformance#Problem:%20Falling%20back%20to%20OpenGL%20software%20rendering (2009-12-17) 5.) Used Libraries ================== Some licenses, however, The LGPL license text can be found in the license/lgpl-2.1.txt. The GPL license text can be found in the license/gpl-2.0.txt. --------------------- --------------------- Qt --------------------- The Qt GUI Toolkit is Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). Contact: Nokia Corporation (qt-info@nokia.com) Qt 4.7.1 is available under the LGPLv2.1 An own modified Qt version 4.7.1 for Windows is stored at Digitalwerk GmbH. You may obtain a copy of the respective source code by contacting us via email support@digitalwerk.net. This package includes the file qt.conf. qt.conf overwrites the path, which is written in the QT library by QT when it is compiled. The path in the qt.conf file has to be set to your %QTDIR%. Used Qt Components with other licenses: --------------------------------------- --------------------- Drag and Drop --------------------- Copyright 1996 Daniel Dardailler. Copyright 1999 Matt Koss Permission to use, copy, modify, distribute, and sell this software for any purpose is hereby granted without fee, provided that the above copyright notice appear in all copies and that both that copyright notice and this permission notice appear in supporting documentation, and that the name of Daniel Dardailler not be used in advertising or publicity pertaining to distribution of the software without specific, written prior permission. Daniel Dardailler makes no representations about the suitability of this software for any purpose. It is provided "as is" without express or implied warranty. --------------------- QtMain --------------------- Copyright (C) 2010 Nokia Corporation and/or its subsidiary(-ies). All rights reserved. Contact: Nokia Corporation (qt-info@nokia.com) You may use this file under the terms of the BSD license as follows: "Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met: * Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer. * Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution. * Neither the name of Nokia Corporation and its Subsidiary(-ies) nor the names of its contributors may be used to endorse or promote products derived from this software without specific prior written permission. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE." --------------------- FreeType --------------------- Portions of this software are copyright (c) 2006 The FreeType Project (www.freetype.org). All rights reserved. The license text for the contributed BDF driver can be found in license/bdf-license.txt. The licence text for the contributed PCF driver can be found in license/pcf-license.txt. The licence text for the contributed GZIP module can be found in license/zlib.h. --------------------- bzip2 --------------------- This program, "bzip2", the associated library "libbzip2", and all documentation, are copyright (c) 1996-2007 Julian R Seward. All rights reserved. --------------------- PCRE - Perl Compatible Regular Expressions --------------------- The complete license can be found in license/pcre-license.txt. --------------------- OSSP uuid - Universally Unique Identifier --------------------- The complete license can be found in license/ossp-uuid-license.txt. --------------------- Advanced Linux Sound Architecture - ALSA Library (Linux only) --------------------- This software uses libraries from the ALSA project under the LGPLv2.1. For further information on how this software can use these libraries see 6.) Optional Libraries. --------------------- Qwt Widget Library --------------------- Copyright (C) 1997 Josef Wilgen Copyright (C) 2002 Uwe Rathmann This library is free software; you can redistribute it and/or modify it under the terms of the Qwt License, Version 1.0 ADTF is based in part on the work of the Qwt project (http://qwt.sf.net). The compiled Qwt Widget Library and the according source code can be obtained from Digitalwerk GmbH on request. --------------------- Boost Library 1.55 --------------------- Copyright (C) 2003 Beman Dawes The complete licence text of the Boost Software License Version 1.0 can be found in licence/boost-license-1.0.txt. --------------------- zlib --------------------- The zlib extension is built using an included copy of the zlib sources if the zlib version found on the system is too old to be used for the build: Copyright (C) 1995-2010 Jean-loup Gailly and Mark Adler This software is provided 'as-is', without any express or implied warranty. In no event will the authors be held liable for any damages arising from the use of this software. Permission is granted to anyone to use this software for any purpose, including commercial applications, and to alter it and redistribute it freely, subject to the following restrictions: 1. The origin of this software must not be misrepresented; you must not claim that you wrote the original software. If you use this software in a product, an acknowledgment in the product documentation would be appreciated but is not required. 2. Altered source versions must be plainly marked as such, and must not be misrepresented as being the original software. 3. This notice may not be removed or altered from any source distribution. Jean-loup Gailly Mark Adler jloup@gzip.org madler@alumni.caltech.edu --------------------- libxml2 2.9.x --------------------- Except where otherwise noted in the source code (e.g. the files hash.c, list.c and the trio files, which are covered by a similar licence but with different Copyright notices) all the files are: Copyright (C) 1998-2003 Daniel Veillard. All Rights Reserved. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE DANIEL VEILLARD BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. Except as contained in this notice, the name of Daniel Veillard shall not be used in advertising or otherwise to promote the sale, use or other dealings in this Software without prior written authorization from him. - hash.c: chained hash tables Copyright (C) 2000,2012 Bjorn Reese and Daniel Veillard. Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER. - list.c: lists handling implementation Copyright (C) 2000 Gary Pennington and Daniel Veillard. Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER. - trio files Copyright (C) 1998 Bjorn Reese and Daniel Stenberg. Copyright (C) 2000 Bjorn Reese and Daniel Stenberg. Copyright (C) 2001 Bjorn Reese Permission to use, copy, modify, and distribute this software for any purpose with or without fee is hereby granted, provided that the above copyright notice and this permission notice appear in all copies. THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE AUTHORS AND CONTRIBUTORS ACCEPT NO RESPONSIBILITY IN ANY CONCEIVABLE MANNER. 6.) Optional Libraries ====================== ADTF supports some extended functionality only if certain external libraries are installed on your system. If they are not present on your system, ADTF will not be able to load the corresponding plugins, but will continue to function with all other features available. These external libraries are NOT distributed through the installation of ADTF. In order to use them you have to install them manually on your system. The following sections describe how to install them in a proper way. ALSA (Linux only): ----- The alsainput and alsaoutput plugins are linked dynamically against the asound library. Therefore this library has to be present on your system. On all recent Linux distributions this library is probably already installed and if not you can install it through the package management. Look for packages called "asound" or "alsa". SDL: ---- Some of the example plugins distributed with ADTF require the SDL library. In order to build and use these plugins you should install the sdl package and also the sdl development packages through your favourite package manager.