Public Support

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.