Added abandoned KDE3 version of Amarok

git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/applications/amarok@1072335 283d02a7-25f6-0310-bc7c-ecb5cbfe19da
v3.5.13-sru
tpearson 16 years ago
commit 3ce9174229

@ -0,0 +1,15 @@
Alexandre Oliveira <aleprj@gmail.com>
Christian Muehlhaeuser <chris@chris.de>
Frederik Holljen <fh@ez.no>
Gábor Lehel <illissius@gmail.com>
Ian Monroe <ian@monroe.nu>
Jeff Mitchell <kde-dev@emailgoeshere.com>
Mark Kretschmann <kretschmann@kde.org>
Martin Aumueller <aumuell@reserv.at>
Max Howell <max.howell@methylblue.com>
Mike Diehl <madpenguin8@yahoo.com>
Paul Cifarelli <paul@cifarelli.net>
Pierpaolo Di Panfilo <pippo_dp@libero.it>
Roman Becker <roman@formmorf.de>
Seb Ruiz <ruiz@kde.org>
Stanislav Karchebny <berk@inbox.ru>

@ -0,0 +1,51 @@
project(extragear-multimedia)
set(CMAKE_MODULE_PATH ${CMAKE_MODULE_PATH} ${CMAKE_SOURCE_DIR}/cmake/modules )
# search packages used by KDE
find_package(KDE4 REQUIRED)
include (KDE4Defaults)
include (MacroLibrary)
include(MacroOptionalAddSubdirectory)
find_package(RUBY)
find_package(KdeMultimedia)
find_package(OpenGL)
find_package(Xine)
# are these two really required ?
if (APPLE)
find_package(Carbon REQUIRED)
endif (APPLE)
set(TAGLIB_MIN_VERSION "1.5")
find_package(Taglib)
#amarok needs to be before add_definitions, since it builds
#some qt-only software
if(TAGLIB_FOUND AND RUBY_EXECUTABLE AND RUBY_INCLUDE_PATH)
macro_optional_add_subdirectory(amarok)
endif(TAGLIB_FOUND AND RUBY_EXECUTABLE AND RUBY_INCLUDE_PATH)
add_definitions (${QT_DEFINITIONS} ${KDE4_DEFINITIONS})
include_directories (${CMAKE_SOURCE_DIR} ${CMAKE_BINARY_DIR} ${KDE4_INCLUDES})
include (ConfigureChecks.cmake)
if(TAGLIB_FOUND)
include_directories (${TAGLIB_INCLUDES})
endif(TAGLIB_FOUND)
if(KDEMULTIMEDIA_FOUND)
macro_optional_add_subdirectory(k3b)
macro_optional_add_subdirectory(kaudiocreator)
endif(KDEMULTIMEDIA_FOUND)
macro_optional_add_subdirectory(kaffeine)
macro_optional_add_subdirectory(kmid)
macro_optional_add_subdirectory(kplayer)
macro_optional_add_subdirectory(kmplayer)
macro_optional_add_subdirectory(doc)
if(QT_QTOPENGL_FOUND AND OPENGL_FOUND AND XINE_FOUND)
macro_optional_add_subdirectory(kaffeinegl)
endif(QT_QTOPENGL_FOUND AND OPENGL_FOUND AND XINE_FOUND)

@ -0,0 +1,340 @@
GNU GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1989, 1991 Free Software Foundation, Inc.
51 Franklin Steet, Fifth Floor, Boston, MA 02110-1301 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
License is intended to guarantee your freedom to share and change free
software--to make sure the software is free for all its users. This
General Public License applies to most of the Free Software
Foundation's software and to any other program whose authors commit to
using it. (Some other Free Software Foundation software is covered by
the GNU Library General Public License instead.) You can apply it to
your programs, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if you
distribute copies of the software, or if you modify it.
For example, if you distribute copies of such a program, whether
gratis or for a fee, you must give the recipients all the rights that
you have. You must make sure that they, too, receive or can get the
source code. And you must show them these terms so they know their
rights.
We protect your rights with two steps: (1) copyright the software, and
(2) offer you this license which gives you legal permission to copy,
distribute and/or modify the software.
Also, for each author's protection and ours, we want to make certain
that everyone understands that there is no warranty for this free
software. If the software is modified by someone else and passed on, we
want its recipients to know that what they have is not the original, so
that any problems introduced by others will not reflect on the original
authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that redistributors of a free
program will individually obtain patent licenses, in effect making the
program proprietary. To prevent this, we have made it clear that any
patent must be licensed for everyone's free use or not licensed at all.
The precise terms and conditions for copying, distribution and
modification follow.
GNU GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License applies to any program or other work which contains
a notice placed by the copyright holder saying it may be distributed
under the terms of this General Public License. The "Program", below,
refers to any such program or work, and a "work based on the Program"
means either the Program or any derivative work under copyright law:
that is to say, a work containing the Program or a portion of it,
either verbatim or with modifications and/or translated into another
language. (Hereinafter, translation is included without limitation in
the term "modification".) Each licensee is addressed as "you".
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running the Program is not restricted, and the output from the Program
is covered only if its contents constitute a work based on the
Program (independent of having been made by running the Program).
Whether that is true depends on what the Program does.
1. You may copy and distribute verbatim copies of the Program's
source code as you receive it, in any medium, provided that you
conspicuously and appropriately publish on each copy an appropriate
copyright notice and disclaimer of warranty; keep intact all the
notices that refer to this License and to the absence of any warranty;
and give any other recipients of the Program a copy of this License
along with the Program.
You may charge a fee for the physical act of transferring a copy, and
you may at your option offer warranty protection in exchange for a fee.
2. You may modify your copy or copies of the Program or any portion
of it, thus forming a work based on the Program, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) You must cause the modified files to carry prominent notices
stating that you changed the files and the date of any change.
b) You must cause any work that you distribute or publish, that in
whole or in part contains or is derived from the Program or any
part thereof, to be licensed as a whole at no charge to all third
parties under the terms of this License.
c) If the modified program normally reads commands interactively
when run, you must cause it, when started running for such
interactive use in the most ordinary way, to print or display an
announcement including an appropriate copyright notice and a
notice that there is no warranty (or else, saying that you provide
a warranty) and that users may redistribute the program under
these conditions, and telling the user how to view a copy of this
License. (Exception: if the Program itself is interactive but
does not normally print such an announcement, your work based on
the Program is not required to print an announcement.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Program,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Program, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Program.
In addition, mere aggregation of another work not based on the Program
with the Program (or with a work based on the Program) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may copy and distribute the Program (or a work based on it,
under Section 2) in object code or executable form under the terms of
Sections 1 and 2 above provided that you also do one of the following:
a) Accompany it with the complete corresponding machine-readable
source code, which must be distributed under the terms of Sections
1 and 2 above on a medium customarily used for software interchange; or,
b) Accompany it with a written offer, valid for at least three
years, to give any third party, for a charge no more than your
cost of physically performing source distribution, a complete
machine-readable copy of the corresponding source code, to be
distributed under the terms of Sections 1 and 2 above on a medium
customarily used for software interchange; or,
c) Accompany it with the information you received as to the offer
to distribute corresponding source code. (This alternative is
allowed only for noncommercial distribution and only if you
received the program in object code or executable form with such
an offer, in accord with Subsection b above.)
The source code for a work means the preferred form of the work for
making modifications to it. For an executable work, complete source
code means all the source code for all modules it contains, plus any
associated interface definition files, plus the scripts used to
control compilation and installation of the executable. However, as a
special exception, the source code distributed need not include
anything that is normally distributed (in either source or binary
form) with the major components (compiler, kernel, and so on) of the
operating system on which the executable runs, unless that component
itself accompanies the executable.
If distribution of executable or object code is made by offering
access to copy from a designated place, then offering equivalent
access to copy the source code from the same place counts as
distribution of the source code, even though third parties are not
compelled to copy the source along with the object code.
4. You may not copy, modify, sublicense, or distribute the Program
except as expressly provided under this License. Any attempt
otherwise to copy, modify, sublicense or distribute the Program is
void, and will automatically terminate your rights under this License.
However, parties who have received copies, or rights, from you under
this License will not have their licenses terminated so long as such
parties remain in full compliance.
5. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Program or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Program (or any work based on the
Program), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Program or works based on it.
6. Each time you redistribute the Program (or any work based on the
Program), the recipient automatically receives a license from the
original licensor to copy, distribute or modify the Program subject to
these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
7. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Program at all. For example, if a patent
license would not permit royalty-free redistribution of the Program by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Program.
If any portion of this section is held invalid or unenforceable under
any particular circumstance, the balance of the section is intended to
apply and the section as a whole is intended to apply in other
circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system, which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
8. If the distribution and/or use of the Program is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Program under this License
may add an explicit geographical distribution limitation excluding
those countries, so that distribution is permitted only in or among
countries not thus excluded. In such case, this License incorporates
the limitation as if written in the body of this License.
9. The Free Software Foundation may publish revised and/or new versions
of the General Public License from time to time. Such new versions will
be similar in spirit to the present version, but may differ in detail to
address new problems or concerns.
Each version is given a distinguishing version number. If the Program
specifies a version number of this License which applies to it and "any
later version", you have the option of following the terms and conditions
either of that version or of any later version published by the Free
Software Foundation. If the Program does not specify a version number of
this License, you may choose any version ever published by the Free Software
Foundation.
10. If you wish to incorporate parts of the Program into other free
programs whose distribution conditions are different, write to the author
to ask for permission. For software which is copyrighted by the Free
Software Foundation, write to the Free Software Foundation; we sometimes
make exceptions for this. Our decision will be guided by the two goals
of preserving the free status of all derivatives of our free software and
of promoting the sharing and reuse of software generally.
NO WARRANTY
11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
REPAIR OR CORRECTION.
12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
POSSIBILITY OF SUCH DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Programs
If you develop a new program, and you want it to be of the greatest
possible use to the public, the best way to achieve this is to make it
free software which everyone can redistribute and change under these terms.
To do so, attach the following notices to the program. It is safest
to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least
the "copyright" line and a pointer to where the full notice is found.
<one line to give the program's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
Foundation, Inc., 51 Franklin Steet, Fifth Floor, Boston, MA 02110-1301 USA
Also add information on how to contact you by electronic and paper mail.
If the program is interactive, make it output a short notice like this
when it starts in an interactive mode:
Gnomovision version 69, Copyright (C) year name of author
Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
This is free software, and you are welcome to redistribute it
under certain conditions; type `show c' for details.
The hypothetical commands `show w' and `show c' should show the appropriate
parts of the General Public License. Of course, the commands you use may
be called something other than `show w' and `show c'; they could even be
mouse-clicks or menu items--whatever suits your program.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the program, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the program
`Gnomovision' (which makes passes at compilers) written by James Hacker.
<signature of Ty Coon>, 1 April 1989
Ty Coon, President of Vice
This General Public License does not permit incorporating your program into
proprietary programs. If your program is a subroutine library, you may
consider it more useful to permit linking proprietary applications with the
library. If this is what you want to do, use the GNU Library General
Public License instead of this License.

File diff suppressed because it is too large Load Diff

@ -0,0 +1,34 @@
include(CheckIncludeFile)
include(CheckIncludeFiles)
include(CheckSymbolExists)
include(CheckFunctionExists)
include(CheckLibraryExists)
include(CheckPrototypeExists)
include(CheckTypeSize)
include(MacroBoolTo01)
# The FindKDE4.cmake module sets _KDE4_PLATFORM_DEFINITIONS with
# definitions like _GNU_SOURCE that are needed on each platform.
set(CMAKE_REQUIRED_DEFINITIONS ${_KDE4_PLATFORM_DEFINITIONS})
#check for libz using the cmake supplied FindZLIB.cmake
macro_bool_to_01(ZLIB_FOUND HAVE_LIBZ)
macro_bool_to_01(JPEG_FOUND HAVE_LIBJPEG)
macro_bool_to_01(PNG_FOUND HAVE_LIBPNG)
macro_bool_to_01(CARBON_FOUND HAVE_CARBON)
macro_bool_to_01(NJB_FOUND HAVE_LIBNJB)
macro_bool_to_01(IFP_FOUND HAVE_IFP)
macro_bool_to_01(LIBVISUAL_FOUND HAVE_LIBVISUAL)
macro_bool_to_01(MTP_FOUND HAVE_MTP)
#now check for dlfcn.h using the cmake supplied CHECK_include_FILE() macro
# If definitions like -D_GNU_SOURCE are needed for these checks they
# should be added to _KDE4_PLATFORM_DEFINITIONS when it is originally
# defined outside this file. Here we include these definitions in
# CMAKE_REQUIRED_DEFINITIONS so they will be included in the build of
# checks below.
set(CMAKE_REQUIRED_DEFINITIONS ${_KDE4_PLATFORM_DEFINITIONS})
if (WIN32)
set(CMAKE_REQUIRED_LIBRARIES ${KDEWIN32_LIBRARIES} )
set(CMAKE_REQUIRED_INCLUDES ${KDEWIN32_INCLUDES} )
endif (WIN32)

@ -0,0 +1,185 @@
Installing Amarok
=================
In order to compile and install Amarok on your system, type the following in the
base directory of the Amarok distribution:
% ./configure --prefix=`kde-config --prefix`
% make
% make install
Note: --enable-final is not supported.
The GNU installation instructions follow.
Basic Installation
==================
These are generic installation instructions.
The `configure' shell script attempts to guess correct values for
various system-dependent variables used during compilation. It uses
those values to create a `Makefile' in each directory of the package.
It may also create one or more `.h' files containing system-dependent
definitions. Finally, it creates a shell script `config.status' that
you can run in the future to recreate the current configuration, a file
`config.cache' that saves the results of its tests to speed up
reconfiguring, and a file `config.log' containing compiler output
(useful mainly for debugging `configure').
If you need to do unusual things to compile the package, please try
to figure out how `configure' could check whether to do them, and mail
diffs or instructions to the address given in the `README' so they can
be considered for the next release. If at some point `config.cache'
contains results you don't want to keep, you may remove or edit it.
The file `configure.in' is used to create `configure' by a program
called `autoconf'. You only need `configure.in' if you want to change
it or regenerate `configure' using a newer version of `autoconf'.
The simplest way to compile this package is:
1. `cd' to the directory containing the package's source code and type
`./configure' to configure the package for your system. If you're
using `csh' on an old version of System V, you might need to type
`sh ./configure' instead to prevent `csh' from trying to execute
`configure' itself.
Running `configure' takes a while. While running, it prints some
messages telling which features it is checking for.
2. Type `make' to compile the package.
3. Type `make install' to install the programs and any data files and
documentation.
4. You can remove the program binaries and object files from the
source code directory by typing `make clean'.
Compilers and Options
=====================
Some systems require unusual options for compilation or linking that
the `configure' script does not know about. You can give `configure'
initial values for variables by setting them in the environment. Using
a Bourne-compatible shell, you can do that on the command line like
this:
CC=c89 CFLAGS=-O2 LIBS=-lposix ./configure
Or on systems that have the `env' program, you can do it like this:
env CPPFLAGS=-I/usr/local/include LDFLAGS=-s ./configure
Compiling For Multiple Architectures
====================================
You can compile the package for more than one kind of computer at the
same time, by placing the object files for each architecture in their
own directory. To do this, you must use a version of `make' that
supports the `VPATH' variable, such as GNU `make'. `cd' to the
directory where you want the object files and executables to go and run
the `configure' script. `configure' automatically checks for the
source code in the directory that `configure' is in and in `..'.
If you have to use a `make' that does not supports the `VPATH'
variable, you have to compile the package for one architecture at a time
in the source code directory. After you have installed the package for
one architecture, use `make distclean' before reconfiguring for another
architecture.
Installation Names
==================
By default, `make install' will install the package's files in
`/usr/local/bin', `/usr/local/man', etc. You can specify an
installation prefix other than `/usr/local' by giving `configure' the
option `--prefix=PATH'.
You can specify separate installation prefixes for
architecture-specific files and architecture-independent files. If you
give `configure' the option `--exec-prefix=PATH', the package will use
PATH as the prefix for installing programs and libraries.
Documentation and other data files will still use the regular prefix.
If the package supports it, you can cause programs to be installed
with an extra prefix or suffix on their names by giving `configure' the
option `--program-prefix=PREFIX' or `--program-suffix=SUFFIX'.
Optional Features
=================
Some packages pay attention to `--enable-FEATURE' options to
`configure', where FEATURE indicates an optional part of the package.
They may also pay attention to `--with-PACKAGE' options, where PACKAGE
is something like `gnu-as' or `x' (for the X Window System). The
`README' should mention any `--enable-' and `--with-' options that the
package recognizes.
For packages that use the X Window System, `configure' can usually
find the X include and library files automatically, but if it doesn't,
you can use the `configure' options `--x-includes=DIR' and
`--x-libraries=DIR' to specify their locations.
Specifying the System Type
==========================
There may be some features `configure' can not figure out
automatically, but needs to determine by the type of host the package
will run on. Usually `configure' can figure that out, but if it prints
a message saying it can not guess the host type, give it the
`--host=TYPE' option. TYPE can either be a short name for the system
type, such as `sun4', or a canonical name with three fields:
CPU-COMPANY-SYSTEM
See the file `config.sub' for the possible values of each field. If
`config.sub' isn't included in this package, then this package doesn't
need to know the host type.
If you are building compiler tools for cross-compiling, you can also
use the `--target=TYPE' option to select the type of system they will
produce code for and the `--build=TYPE' option to select the type of
system on which you are compiling the package.
Sharing Defaults
================
If you want to set default values for `configure' scripts to share,
you can create a site shell script called `config.site' that gives
default values for variables like `CC', `cache_file', and `prefix'.
`configure' looks for `PREFIX/share/config.site' if it exists, then
`PREFIX/etc/config.site' if it exists. Or, you can set the
`CONFIG_SITE' environment variable to the location of the site script.
A warning: not all `configure' scripts look for a site script.
Operation Controls
==================
`configure' recognizes the following options to control how it
operates.
`--cache-file=FILE'
Use and save the results of the tests in FILE instead of
`./config.cache'. Set FILE to `/dev/null' to disable caching, for
debugging `configure'.
`--help'
Print a summary of the options to `configure', and exit.
`--quiet'
`--silent'
`-q'
Do not print messages saying which checks are being made.
`--srcdir=DIR'
Look for the package's source code in directory DIR. Usually
`configure' can determine that directory automatically.
`--version'
Print the version of Autoconf used to generate the `configure'
script, and exit.
`configure' also accepts some other, not widely useful, options.

@ -0,0 +1,5 @@
AUTOMAKE_OPTIONS = foreign 1.5
include admin/deps.am
include admin/Doxyfile.am
SUBDIRS=$(TOPSUBDIRS)

@ -0,0 +1,4 @@
AUTOMAKE_OPTIONS = foreign 1.5
include admin/deps.am
include admin/Doxyfile.am

@ -0,0 +1,14 @@
all:
@echo "This Makefile is only for the CVS repository"
@echo "This will be deleted before making the distribution"
@echo ""
@if test ! -d admin; then \
echo "Please recheckout this module!" ;\
echo "for cvs: use checkout once and after that update again" ;\
echo "for cvsup: checkout kde-common from cvsup and" ;\
echo " link kde-common/admin to ./admin" ;\
exit 1 ;\
fi
$(MAKE) -f admin/Makefile.common cvs
.SILENT:

223
README

@ -0,0 +1,223 @@
Amarok - the audio player for KDE
===================================
There are many media players around these days, true. What's missing from most
players is a user interface that doesn't get in the way of the user. How many
buttons do you have to press for simply adding some new tracks to the playlist?
Amarok tries to be a little different, providing a simple drag and drop
interface that really makes playlist handling easy.
FEATURES
==========
* Quick and simple drag and drop playlist creation
* Music library (built-in SQLite, MySQL, or PostgreSQL)
* Multiple backends supported (xine, Helix, and NMM)
* Plays all audio formats known to man
* 10 band equalizer
* Automatic cover art download using Amazon services
* The unique and powerful stylable context browser
* Automatic play-statistics generation (iRate style)
* Full lyrics download
* Learn about your music with integrated Wikipedia
* Full last.fm support
* Visualisations with libvisual
* Crossfading and gapless playback
* Fully configurable OSD for track changes
* K3B (CD-burning) integration
* Podcast support
* Access to iPod, iRiver IFP, USB Mass Storage and many other devices
* Powerful scripting interface
* Complete DCOP Access
* KDE integration
* Preview and buy albums from the Magnatune.com music store
--------------------------------------------------------------------------------
DEPENDENCIES
==============
Required
* KDE-Libs 3.3 (or newer)
http://www.kde.org
* TagLib 1.4 (or newer)
(metadata tagging library)
http://freshmeat.net/projects/taglib
* Ruby 1.8
(programming language, used for scoring, lyrics, last.fm streams)
http://www.ruby-lang.org
* One of the multimedia frameworks listed below:
Recommended
* xine-lib 1.0.2 (or newer)
Note: xine-lib 1.1.1 is required for gapless playback.
(multimedia framework)
http://xinehq.de/
Optional
* RealPlayer 10 or HelixPlayer 1.0
(multimedia framework)
http://www.real.com
(Note: only HelixPlayer is exactly RealPlayer without MP3 support)
* KDE-Base 3.3 (or newer)
(needed for Konqueror Sidebar)
http://www.kde.org
* MySQL 4 or 5
(faster database support)
http://www.mysql.com
* PostgreSQL 7.4
(faster database support)
http://www.postgresql.org
* OpenGL accelerated X-Server
(visualization rendering)
* Libvisual 0.4.0 + SDL 1.2
(visualization framework)
http://localhost.nl/~synap/libvisual/
http://www.libsdl.org
* ProjectM 0.96 (or newer)
(visualization plugins for Libvisual or XMMS)
http://xmms-projectm.sourceforge.net/
* libtunepimp 0.3 (or newer)
(automatic tagging support)
http://www.musicbrainz.org/
* K3B 0.11 (or newer)
(CD burning support)
http://www.k3b.org
* libgpod 0.4.2 (or newer)
(iPod support)
Note: libgpod 0.6.0 is required for the newest Apple iPods.
http://www.gtkpod.org/libgpod.html
* libifp 1.0.0.2
(iRiver iFP support)
http://ifp-driver.sourceforge.net/libifp/
* libmp4v2 (mpeg4ip 1.5 is recommended, faad2 is less reliable)
(MP4/AAC tag reading & writing)
http://www.sf.net/projects/mpeg4ip
http://www.audiocoding.com
* libnjb 2.2.4 (older versions may work)
(NJB mediadevice (Creative Nomad/Zen family, Dell DJ devices)
http://www.sf.net/projects/libnjb
* libmtp 0.1.1 (or newer)
(MTP media device support AKA PlaysForSure)
http://libmtp.sourceforge.net/
* libkarma 0.0.5 && OMFS 0.6.1
(Rio Karma support via USB)
http://freakysoft.de/html/libkarma/ && http://linux-karma.sf.net/
Please note, if compiling from source you must also install the devel versions
of these packages.
--------------------------------------------------------------------------------
IMPORTANT INSTALL INSTRUCTIONS
================================
In order to compile and install Amarok on your system, type the following in the
base directory of the Amarok distribution:
% ./configure --prefix=`kde-config --prefix`
% make
% make install
Note: --enable-final is not guaranteed to work
Packages for popular distributions are available at http://amarok.kde.org
--------------------------------------------------------------------------------
INSTALLATION-FAQ
==================
Q: Can I improve Amarok's startup time?
A: Prelinking Amarok has spectacular results; however if you have binary openGL
drivers (eg Nvidia drivers), you will need to compile Amarok --without-opengl
in order to get the amarokapp binary to prelink (the amarok binary is not
important here).
--------------------------------------------------------------------------------
OTHER-FAQS
============
For answers to problems like "Amarok won't play any MP3s!" and "My MP3s skip
and stutter!" please visit:
http://amarok.kde.org/
--------------------------------------------------------------------------------
INFORMATION FOR PACKAGERS
===========================
For Amarok packages we suggest you build:
% ./configure --disable-debug
It is possible to build Amarok to use MySQL as the database backend. Using
MySQL makes the Amarok collection faster.
We suggest compiling Os, there is no particular part of Amarok that would
benefit from optimisation, so the smallest binary is probably the best route.
In order to limit the dependencies the Amarok package demands we suggest
splitting Amarok into the following packages:
1. Amarok + one backend
2. xine-engine
3. Helix-engine
4. amarok_libvisual
5. ipod media device
6. ifp media device
7. njb media device
8. mtp media device
9. rio karma media device
Amarok is modular and will be fully functional as long as one of 2 or 3 is
also installed. Hence we suggest Amarok + one backend. Feel free to include the
helix, MAS and NMM engines if you can satisfy their dependencies.
Amarok ships with two binaries: amarok and amarokapp. The amarok binary is a
wrapper designed to speed up command line argument passing. amarokapp is the
real Amarok.
If you make packages for Amarok please let us know and we'll link to you on the
homepage (as long as you don't object).
--------------------------------------------------------------------------------
CONTRIBUTING
==============
If you wish to contribute to Amarok, you should build it from SVN and subscribe
to the amarok-devel mailing list. The IRC channel is also a place where
it's nice to be, since you can talk to other developers much easier, and
get instant notification of commits to the SVN. For instant email notification
of commits, visit http://commitfilter.kde.org/.
--------------------------------------------------------------------------------
WWW : http://amarok.kde.org
MAIL: amarok@kde.org
IRC : irc.freenode.net - #amarok, #amarok.de, #amarok.es

297
TODO

@ -0,0 +1,297 @@
TODO-list for Amarok
======================
<nick> == reported by
-->nick == assigned to
SHORT-TERM (URGENT):
<sebr> When using "Copy files to collection" in the filebrowser, tags wont get recognised from
urls which are organised from media:/ locations.
<jeff> When playing a stream from e.g. Ampache, even if an Artist is detected, Wikipedia
will pull up "Artist - Song" instead of just Artist.
<sebr> PlaylistBrowser::slotDoubleClicked() and PlaylistBrowser::addSelectedToPlaylist()
should be merged for better code reusage. They are practically the same.
<markey> I just deleted a tag by accident: Clicked on a file in the playlist, pressed
delete to remove the track from the playlist. I had not noticed that it
went into edit mode, though. So I clicked somewhere else, and BAM, the new
empty tag was written. My tag was gone :S IMHO we should require confirmation
before writing, e.g. only write the tag after pressing enter.
<markey> When you start a lastfm stream, the old metadata from the last stream is
shown before the new stream starts. Doesn't look nice.
<shanachie> update podcast-tuples when the feed get's corrected after a mistake by the podcaster/publisher. eg. pubdate, url, title.
<sebr> We need to check for pkg-config when configuring, otherwise we can't check for things
like libgpod. Currently its a silent error, and its very difficult to debug without
trawling through configure.in.in
<sebr> Don't reload media device plugins when saving config settings. Its annoying, slow
and all around unnecessary. It also crashes if the device is connected/loaded.
<aumuell> Cannot reproduce anything of this with ipods - i think i fixed that already.
<markey> After doing "Delete downloaded podcast", the icon still indicates downloaded.
<sebr> LastFm:
- determine how hard it would be to tag songs
<eean> - display history in the playlist somehow <markey> I'm against this.
-subitems?
-just disabled?
- 'stop after current track' should work
<markey> - when you've never listenend to lastfm before, all stream links on the
website are disabled ("Download the player"). we need to do a handshake on
startup once, and then set a config item, e.g. handshaked=true.
<markey> xine-engine: when "xine could not init any audio driver" happens, always retry
with Autodetect. This seems to be an issue with leftover amarokrc's from 1.3.
<sebr> Adding an m3u with non existant items has filesize = 16,777,216.0 TB!
<sebr> Refactor code for PlaylistBrowser::removeSelectedItems(). I can see pathological cases
where it won't work.
<illiss.> Is using the score for the number, but the rating for the vis. in the context browser
confusing? (I think it is, but that might be becuase my theme doesn't use stars but a
partially-filled bar). If so it should be reverted for beta 1, I have a better solution
already planned but that won't be in time.
<illiss.> The various UI and behaviour refactorings for Dynamic Mode should be finished up and
polished. Among them, add a button to turn it off in the bar-above-the-playlist, fix
drag-and-dropping of dynamic playlists, and when loading a dynamic playlist, clear the
existing playlist first, instead of making it dynamic (which has all sorts of nasty side
effects).
<sebr> Podcast Fixme's:
* Have i listened to podcast streamed?
<illiss.> Loading normal (M3U) playlists from the playlist browser doesn't block the UI per se,
but it does nothing for really long time, until suddenly the whole playlist shows up,
which is strange and confusing.
<markey> Tooltips don't work for 3rd level items in the Playlist Browser. They do how
however work (for me) for 2nd level items. Very bad, cause you can't read the
text!
<sebr> When starting a drag in the collection browser, we can block the gui if the user makes a
selection which is sql intensive (eg, select all). Instead of calculating the items
in each of those nodes, we should add the sql to the drag and allow the playlist loader
to do the work for us (which is threaded).
<muesli> See SqlLoader class in playlistloader. We do the very same stuff for
Smart-Playlists already.
<sebr> The unknown album should ALWAYS be shown last. Year has a higher weighting than album
name. We should special case the Unknown album.
<markey> When all 5 browser tabs are activated, the current tab button is drawn a few
pixels below the normal position. This has the side effect that the separator line
at the bottom of the bottom becomes invisible.
You can see the problem easily when you hide the current browser by clicking twice
the button twice. This problem AFAIK also affects 1.3-branch.
<markey> Add DCOP functions for showing dialogs, similar to kdialog.
<sebr> More consistent playlistbrowser drag and drop actions; No dropping of default streams, set
e->accept( false ) if dropping one type onto another.
<sebr> Use KIO queues for podcast download queues. Should simplify the lot. Problems atm included
selecting multiple downloads individually, and automatic downloads occuring for more that one
podcast item.
<markey> In EngineController::play(), add a sanity check when querying the track length
from the engine. Apparently AAC can deliver ridiculous values with GST and Helix,
like 1192479:38:49. If length is too extreme, default to the TagLib provided
value.
<eean> Currently custom dynamic playlist selection is simply based on the titles. So its less then
ideal. Via some method, each playlist should be assigned iteratively a number paired with its
type.. Dynamic playlists and static playlists should probably have seperate numbering so
that the "next" number can be determined by looking at one XML file.
Remembering which PartyEntry was used on close should be remembered with the same method.
<eean> Smart playlists bypass checks on whether the media is playable or not.
Or perhaps such media shouldn't be in the collection at all? This is the sort of
thing we're going to have to worry about now that we have m4a and wma tag support.
<markey> Consider moving the GHNS provider list to a different server than amarok.kde.org,
possibly download.kde.org or similar. (When our site is down, the GHNS feature fails
to work entirely)
<markey> Amarok fails to download any stream playlist from http://dir.xiph.org. Part of the problem is
PlaylistLoader::isPlaylistFile(const KURL&), which only looks at the filename's extension. This
fails for URLs like http://dir.xiph.org/listen.php?pid=669641&file=listen.m3u, because the filename
is "listen.php". So it must look at the whole url instead.
<mxcl> On first-ever-run, if Amarok crashes building the sqlite collection, it is impossible to _ever_
build a collection unless the user's amarokrc file is deleted! This MUST be fixed before 1.2!
::muesli:: We could just _always_ try to create the sql tables on startup. This would fail on
::muesli:: systems which already got the tables, but would fix the situation where tables are
::muesli:: missing, as in this situation. Just pump the debug of these calls to /dev/null.
<mxcl> Just before we load any engine plugin, write to a file, and it we don't succeed the next time
Amarok starts show a big warning saying "Gah!" and load a different one.
<mxcl> If you inline set the title tag to "", prettyTitle gets inserted as the title tag.
<markey> When the KDE color scheme is changed while Amarok is running, all toolbar buttons (those with text)
lose their texts.
<shakes> The scrobbler code should report some sort of error message rather than just saying that the
submit failed. That way when last.fm goes down we wouldn't get so many people asking why they
can't submit. It'd also be nice to be able to tell people they've got their password wrong.
<jefferai> When hovering the mouse over the Repeat/Random icons in the bottom taskbar, the popups that appear
not only have inconsistent icons with the ones shown in the taskbar, but they're pixellated and ugly
as sin. Should probably be redone as SVGs.
<jefferai> Xine proxy value is not saved across sessions. Problem exists in Xine-UI as well, at least for me.
Maybe an upstream bug and nothing we can fix.
MID-TERM:
<eean> Implement a "Find My Music" button in the first-run wizard. Just a basic
thing that will look at file extensions and try to figure out where the users
music is located. Ignore /opt/, /usr etc. to avoid adding sound effects. Prompt
user with the directories at the end of the scan, allowing them to exclude some.
<eean> The FileBrowser doesn't check for recursive symlinks. This is a KDirOperator (or the
classes it depends on) problem.
<eean> Basically need to re-add some of the functionality I removed in re-doing dynamic
--><eean> custom playlist creation.
1) the default dynamic playlists need to be more insistent, the same way the
the default smart playlists are.
<eean> Implement leinir's mockup:
www.leinir.dk/temp/gallery/?image=pictures/amarok-playlist-bar-dynamic-mode.png
<leinir> The idea with the look of the top is, as you can probably see from the colours
otherwise present, that it's the active window titlebar/colour/font, with the name of the
playlist being un-bolded (if the window title is bold)...
<leinir> eean: Some people will identify the active window by titlebar colour alone :)
<mp8> Album covers as icons from filebrowser.
<eean> When the player window shades, it should lose its title bar and be replaced with something more
compactish. This would probably have to be created manually.
<sebr> Make the player window scroll the text in the opposite direction if using right-2-left text
(eg hebrew or arabic)
<sebr> Use Metabar's box retraction animation to the context browser. More iCandy. Any Javascript experts around?
<mxcl> Should be able to open collection browser by right clicking on stuff in contextB, so show the
artist or album that is right clicked.
<markey> AudioCD support for gst engine (cdparanoia ! *sink). -->markey
<markey> We should cut down on unnecessary/redundant debug output/warnings (noise).
<mxcl> Perhaps a nice idea: when you drag playlistItems to a branch in the collection browser
it prompts to change the track's tags, so drag a track to the "moolaaa" album and that
track get's it's album tag changed to "moolaaa" and is inserted into the branch, so the user
know's what has happened.
<mxcl> User asked for a CTRL-J itty-bitty dialog that allows you to jump to a specific part
of a track. I'll see if I can do it with tiny amount of code -->mxcl
<muesli> Don't rely on KDE timeouts to see whether a file is accessible or not,
since this really sucks for disconnected network shares. XMMS handles
this way better and it really is a problem in userland. maybe a thread
helps, which simply tries to fopen() the file. if this task hasn't been
finished in (let's say) 3 seconds, jump to the next song. XMMS even
remembers such files and their folders, so that it's not going to open
another file from that folder for the next few minutes. what about hdd
sleep-timeouts? opinions?
<mxcl> Determine some behavior for the clear/shuffle/etc. buttons when a search is in action
clear -> only clear the stuff that was searched for?
shuffle -> stop the search and do normal shuffle?
ADDitionally what to do when user rearranges a set of items that are the search result?
<larson> No big deal to me as long as the behaviour is consistent. I.e. if shuffle shuffles
the search, then clear should clear the search only, and visa versa.
<larson> Make playlist toolbar buttons toggle like the playerwidget buttons.
Toolbar button in FileBrowser for switching recursive directory reading.
<mxcl> Can't resize newly displayed columns if they are hidden at beginning of session -->mxcl
<muesli> Add an option "clean up playlist on startup".
<mxcl> Do you mean remove duplicates or dead entries etc. ? Cool.
<mxcl> Option: don't crossfade for sequential tracks on same album. Comments? -->mxcl
Of course, there would still be the up to 150ms gap, but we can fix that some other time..
<markey> Please clarify: is this the same as BR #75388 ?
<mxcl> No, this is just to make crossfading not ruin album transitions
Add dirs to combo history when user adds a track from that dir to the playlist.
"Show playlist" to the right click menu, redundant but necessary.
More KTips, better KTips, somehow use the "Did you know" tip dialog (eg kmail, gideon, etc.) -->mxcl
Option to automatically adjust column widths.
Option to implicitly sort playlist by { track, album } (on drop only) -->mxcl
<berkus> Playmode indication button in main widget (repeat track/pl/shuffle), clickable.
LONG-TERM:
<sebr> Support multiple collections. This could be really powerful, and could be handled
with the collection browser. We could support non-local collections, audio cd/dvds,
NFS/Samba etc. This would also allow us to retrieve tracks from other networked pcs.
Auto-polling of added collections for a 'hot-sync' style detection of collections.
<markey> Use more accurate interpolation for analyzers (cubic or spline)
Tabbed playlists.
Pro: it's convenient to have several playlists
Contra: the playlist is getting cluttered enough as it is!
<illissius> I already added a comment wrt this to the b.k.o bug, but here's the idea:
switch between playlists with the playlist browser -- that's what it's there for.
This avoids the clutter. The way it'd work is the currently playing playlist would
have the same fancy fading thing the current track has. The context menu for playlists
would have two seperate items, one for showing and one for playing. When just showing,
the previous playlist would continue playing while you view/edit the other one.
(If you doubleclick a song in the new playlist, it would naturally start playing that
one instead). What to do when the user doubleclicks a playlist -- show, play, or both
-- is TBD.
Make windows magnetic / sticking together (difficult).
<mxcl> Implement beat detection (thread?), interface should glow/move to
the beat, visualisations have access to beat/bpm info.
Audio system info widget, showing all available codecs and similar info.
Resizable playerwidget, like in Winamp3.
IDEAS:
Bookmarks inside of tracks (good for very long tracks), and nifty bookmark browser
Using filelight (as a kpart maybe) for a graphical representation of the playlist. so
you could see at first glance how the altogether playing time is divided into different
albums, tunes and so on.
DO-NOT-IMPLEMENT (stuff that was rejected):
<markey> Allow removing of playlist items by dragging back into browser.
<larson> I think this is really weird. When I drag something I expect that someting to be
ADDed or opened in the target. Not removed from the sender.
(RFC: is this still appropriate or would it be misleading?)
<muesli> imho, it's misleading and not hid-compatible. i would rather
expect that file to be copied to the browser's current directory.
"Hide playlist when main widget is not active" option (?? comments please: )
<berkus> Noo, we have it hiding into tray, thats enough (imagine how much flashing will be
if i drag mouse around with "focus follows mouse" on - this is the one i use all the time)
<mxcl> Hence it's an option, you'd not use it with focus follows mouse. But it was just an idea
anyway.. dunno if I like the sound of it anymore either.
BACKTRACES/DEBUG/VALGRIND:

File diff suppressed because it is too large Load Diff

881
aclocal.m4 vendored

@ -0,0 +1,881 @@
# generated automatically by aclocal 1.10.1 -*- Autoconf -*-
# Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
# 2005, 2006, 2007, 2008 Free Software Foundation, Inc.
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY, to the extent permitted by law; without
# even the implied warranty of MERCHANTABILITY or FITNESS FOR A
# PARTICULAR PURPOSE.
m4_ifndef([AC_AUTOCONF_VERSION],
[m4_copy([m4_PACKAGE_VERSION], [AC_AUTOCONF_VERSION])])dnl
m4_if(AC_AUTOCONF_VERSION, [2.61],,
[m4_warning([this file was generated for autoconf 2.61.
You have another version of autoconf. It may work, but is not guaranteed to.
If you have problems, you may need to regenerate the build system entirely.
To do so, use the procedure documented by the package, typically `autoreconf'.])])
# Copyright (C) 2002, 2003, 2005, 2006, 2007 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# AM_AUTOMAKE_VERSION(VERSION)
# ----------------------------
# Automake X.Y traces this macro to ensure aclocal.m4 has been
# generated from the m4 files accompanying Automake X.Y.
# (This private macro should not be called outside this file.)
AC_DEFUN([AM_AUTOMAKE_VERSION],
[am__api_version='1.10'
dnl Some users find AM_AUTOMAKE_VERSION and mistake it for a way to
dnl require some minimum version. Point them to the right macro.
m4_if([$1], [1.10.1], [],
[AC_FATAL([Do not call $0, use AM_INIT_AUTOMAKE([$1]).])])dnl
])
# _AM_AUTOCONF_VERSION(VERSION)
# -----------------------------
# aclocal traces this macro to find the Autoconf version.
# This is a private macro too. Using m4_define simplifies
# the logic in aclocal, which can simply ignore this definition.
m4_define([_AM_AUTOCONF_VERSION], [])
# AM_SET_CURRENT_AUTOMAKE_VERSION
# -------------------------------
# Call AM_AUTOMAKE_VERSION and AM_AUTOMAKE_VERSION so they can be traced.
# This function is AC_REQUIREd by AC_INIT_AUTOMAKE.
AC_DEFUN([AM_SET_CURRENT_AUTOMAKE_VERSION],
[AM_AUTOMAKE_VERSION([1.10.1])dnl
m4_ifndef([AC_AUTOCONF_VERSION],
[m4_copy([m4_PACKAGE_VERSION], [AC_AUTOCONF_VERSION])])dnl
_AM_AUTOCONF_VERSION(AC_AUTOCONF_VERSION)])
# AM_AUX_DIR_EXPAND -*- Autoconf -*-
# Copyright (C) 2001, 2003, 2005 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# For projects using AC_CONFIG_AUX_DIR([foo]), Autoconf sets
# $ac_aux_dir to `$srcdir/foo'. In other projects, it is set to
# `$srcdir', `$srcdir/..', or `$srcdir/../..'.
#
# Of course, Automake must honor this variable whenever it calls a
# tool from the auxiliary directory. The problem is that $srcdir (and
# therefore $ac_aux_dir as well) can be either absolute or relative,
# depending on how configure is run. This is pretty annoying, since
# it makes $ac_aux_dir quite unusable in subdirectories: in the top
# source directory, any form will work fine, but in subdirectories a
# relative path needs to be adjusted first.
#
# $ac_aux_dir/missing
# fails when called from a subdirectory if $ac_aux_dir is relative
# $top_srcdir/$ac_aux_dir/missing
# fails if $ac_aux_dir is absolute,
# fails when called from a subdirectory in a VPATH build with
# a relative $ac_aux_dir
#
# The reason of the latter failure is that $top_srcdir and $ac_aux_dir
# are both prefixed by $srcdir. In an in-source build this is usually
# harmless because $srcdir is `.', but things will broke when you
# start a VPATH build or use an absolute $srcdir.
#
# So we could use something similar to $top_srcdir/$ac_aux_dir/missing,
# iff we strip the leading $srcdir from $ac_aux_dir. That would be:
# am_aux_dir='\$(top_srcdir)/'`expr "$ac_aux_dir" : "$srcdir//*\(.*\)"`
# and then we would define $MISSING as
# MISSING="\${SHELL} $am_aux_dir/missing"
# This will work as long as MISSING is not called from configure, because
# unfortunately $(top_srcdir) has no meaning in configure.
# However there are other variables, like CC, which are often used in
# configure, and could therefore not use this "fixed" $ac_aux_dir.
#
# Another solution, used here, is to always expand $ac_aux_dir to an
# absolute PATH. The drawback is that using absolute paths prevent a
# configured tree to be moved without reconfiguration.
AC_DEFUN([AM_AUX_DIR_EXPAND],
[dnl Rely on autoconf to set up CDPATH properly.
AC_PREREQ([2.50])dnl
# expand $ac_aux_dir to an absolute path
am_aux_dir=`cd $ac_aux_dir && pwd`
])
# AM_CONDITIONAL -*- Autoconf -*-
# Copyright (C) 1997, 2000, 2001, 2003, 2004, 2005, 2006
# Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 8
# AM_CONDITIONAL(NAME, SHELL-CONDITION)
# -------------------------------------
# Define a conditional.
AC_DEFUN([AM_CONDITIONAL],
[AC_PREREQ(2.52)dnl
ifelse([$1], [TRUE], [AC_FATAL([$0: invalid condition: $1])],
[$1], [FALSE], [AC_FATAL([$0: invalid condition: $1])])dnl
AC_SUBST([$1_TRUE])dnl
AC_SUBST([$1_FALSE])dnl
_AM_SUBST_NOTMAKE([$1_TRUE])dnl
_AM_SUBST_NOTMAKE([$1_FALSE])dnl
if $2; then
$1_TRUE=
$1_FALSE='#'
else
$1_TRUE='#'
$1_FALSE=
fi
AC_CONFIG_COMMANDS_PRE(
[if test -z "${$1_TRUE}" && test -z "${$1_FALSE}"; then
AC_MSG_ERROR([[conditional "$1" was never defined.
Usually this means the macro was only invoked conditionally.]])
fi])])
# Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006
# Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 9
# There are a few dirty hacks below to avoid letting `AC_PROG_CC' be
# written in clear, in which case automake, when reading aclocal.m4,
# will think it sees a *use*, and therefore will trigger all it's
# C support machinery. Also note that it means that autoscan, seeing
# CC etc. in the Makefile, will ask for an AC_PROG_CC use...
# _AM_DEPENDENCIES(NAME)
# ----------------------
# See how the compiler implements dependency checking.
# NAME is "CC", "CXX", "GCJ", or "OBJC".
# We try a few techniques and use that to set a single cache variable.
#
# We don't AC_REQUIRE the corresponding AC_PROG_CC since the latter was
# modified to invoke _AM_DEPENDENCIES(CC); we would have a circular
# dependency, and given that the user is not expected to run this macro,
# just rely on AC_PROG_CC.
AC_DEFUN([_AM_DEPENDENCIES],
[AC_REQUIRE([AM_SET_DEPDIR])dnl
AC_REQUIRE([AM_OUTPUT_DEPENDENCY_COMMANDS])dnl
AC_REQUIRE([AM_MAKE_INCLUDE])dnl
AC_REQUIRE([AM_DEP_TRACK])dnl
ifelse([$1], CC, [depcc="$CC" am_compiler_list=],
[$1], CXX, [depcc="$CXX" am_compiler_list=],
[$1], OBJC, [depcc="$OBJC" am_compiler_list='gcc3 gcc'],
[$1], UPC, [depcc="$UPC" am_compiler_list=],
[$1], GCJ, [depcc="$GCJ" am_compiler_list='gcc3 gcc'],
[depcc="$$1" am_compiler_list=])
AC_CACHE_CHECK([dependency style of $depcc],
[am_cv_$1_dependencies_compiler_type],
[if test -z "$AMDEP_TRUE" && test -f "$am_depcomp"; then
# We make a subdir and do the tests there. Otherwise we can end up
# making bogus files that we don't know about and never remove. For
# instance it was reported that on HP-UX the gcc test will end up
# making a dummy file named `D' -- because `-MD' means `put the output
# in D'.
mkdir conftest.dir
# Copy depcomp to subdir because otherwise we won't find it if we're
# using a relative directory.
cp "$am_depcomp" conftest.dir
cd conftest.dir
# We will build objects and dependencies in a subdirectory because
# it helps to detect inapplicable dependency modes. For instance
# both Tru64's cc and ICC support -MD to output dependencies as a
# side effect of compilation, but ICC will put the dependencies in
# the current directory while Tru64 will put them in the object
# directory.
mkdir sub
am_cv_$1_dependencies_compiler_type=none
if test "$am_compiler_list" = ""; then
am_compiler_list=`sed -n ['s/^#*\([a-zA-Z0-9]*\))$/\1/p'] < ./depcomp`
fi
for depmode in $am_compiler_list; do
# Setup a source with many dependencies, because some compilers
# like to wrap large dependency lists on column 80 (with \), and
# we should not choose a depcomp mode which is confused by this.
#
# We need to recreate these files for each test, as the compiler may
# overwrite some of them when testing with obscure command lines.
# This happens at least with the AIX C compiler.
: > sub/conftest.c
for i in 1 2 3 4 5 6; do
echo '#include "conftst'$i'.h"' >> sub/conftest.c
# Using `: > sub/conftst$i.h' creates only sub/conftst1.h with
# Solaris 8's {/usr,}/bin/sh.
touch sub/conftst$i.h
done
echo "${am__include} ${am__quote}sub/conftest.Po${am__quote}" > confmf
case $depmode in
nosideeffect)
# after this tag, mechanisms are not by side-effect, so they'll
# only be used when explicitly requested
if test "x$enable_dependency_tracking" = xyes; then
continue
else
break
fi
;;
none) break ;;
esac
# We check with `-c' and `-o' for the sake of the "dashmstdout"
# mode. It turns out that the SunPro C++ compiler does not properly
# handle `-M -o', and we need to detect this.
if depmode=$depmode \
source=sub/conftest.c object=sub/conftest.${OBJEXT-o} \
depfile=sub/conftest.Po tmpdepfile=sub/conftest.TPo \
$SHELL ./depcomp $depcc -c -o sub/conftest.${OBJEXT-o} sub/conftest.c \
>/dev/null 2>conftest.err &&
grep sub/conftst1.h sub/conftest.Po > /dev/null 2>&1 &&
grep sub/conftst6.h sub/conftest.Po > /dev/null 2>&1 &&
grep sub/conftest.${OBJEXT-o} sub/conftest.Po > /dev/null 2>&1 &&
${MAKE-make} -s -f confmf > /dev/null 2>&1; then
# icc doesn't choke on unknown options, it will just issue warnings
# or remarks (even with -Werror). So we grep stderr for any message
# that says an option was ignored or not supported.
# When given -MP, icc 7.0 and 7.1 complain thusly:
# icc: Command line warning: ignoring option '-M'; no argument required
# The diagnosis changed in icc 8.0:
# icc: Command line remark: option '-MP' not supported
if (grep 'ignoring option' conftest.err ||
grep 'not supported' conftest.err) >/dev/null 2>&1; then :; else
am_cv_$1_dependencies_compiler_type=$depmode
break
fi
fi
done
cd ..
rm -rf conftest.dir
else
am_cv_$1_dependencies_compiler_type=none
fi
])
AC_SUBST([$1DEPMODE], [depmode=$am_cv_$1_dependencies_compiler_type])
AM_CONDITIONAL([am__fastdep$1], [
test "x$enable_dependency_tracking" != xno \
&& test "$am_cv_$1_dependencies_compiler_type" = gcc3])
])
# AM_SET_DEPDIR
# -------------
# Choose a directory name for dependency files.
# This macro is AC_REQUIREd in _AM_DEPENDENCIES
AC_DEFUN([AM_SET_DEPDIR],
[AC_REQUIRE([AM_SET_LEADING_DOT])dnl
AC_SUBST([DEPDIR], ["${am__leading_dot}deps"])dnl
])
# AM_DEP_TRACK
# ------------
AC_DEFUN([AM_DEP_TRACK],
[AC_ARG_ENABLE(dependency-tracking,
[ --disable-dependency-tracking speeds up one-time build
--enable-dependency-tracking do not reject slow dependency extractors])
if test "x$enable_dependency_tracking" != xno; then
am_depcomp="$ac_aux_dir/depcomp"
AMDEPBACKSLASH='\'
fi
AM_CONDITIONAL([AMDEP], [test "x$enable_dependency_tracking" != xno])
AC_SUBST([AMDEPBACKSLASH])dnl
_AM_SUBST_NOTMAKE([AMDEPBACKSLASH])dnl
])
# Generate code to set up dependency tracking. -*- Autoconf -*-
# Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005
# Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
#serial 3
# _AM_OUTPUT_DEPENDENCY_COMMANDS
# ------------------------------
AC_DEFUN([_AM_OUTPUT_DEPENDENCY_COMMANDS],
[for mf in $CONFIG_FILES; do
# Strip MF so we end up with the name of the file.
mf=`echo "$mf" | sed -e 's/:.*$//'`
# Check whether this is an Automake generated Makefile or not.
# We used to match only the files named `Makefile.in', but
# some people rename them; so instead we look at the file content.
# Grep'ing the first line is not enough: some people post-process
# each Makefile.in and add a new line on top of each file to say so.
# Grep'ing the whole file is not good either: AIX grep has a line
# limit of 2048, but all sed's we know have understand at least 4000.
if sed -n 's,^#.*generated by automake.*,X,p' "$mf" | grep X >/dev/null 2>&1; then
dirpart=`AS_DIRNAME("$mf")`
else
continue
fi
# Extract the definition of DEPDIR, am__include, and am__quote
# from the Makefile without running `make'.
DEPDIR=`sed -n 's/^DEPDIR = //p' < "$mf"`
test -z "$DEPDIR" && continue
am__include=`sed -n 's/^am__include = //p' < "$mf"`
test -z "am__include" && continue
am__quote=`sed -n 's/^am__quote = //p' < "$mf"`
# When using ansi2knr, U may be empty or an underscore; expand it
U=`sed -n 's/^U = //p' < "$mf"`
# Find all dependency output files, they are included files with
# $(DEPDIR) in their names. We invoke sed twice because it is the
# simplest approach to changing $(DEPDIR) to its actual value in the
# expansion.
for file in `sed -n "
s/^$am__include $am__quote\(.*(DEPDIR).*\)$am__quote"'$/\1/p' <"$mf" | \
sed -e 's/\$(DEPDIR)/'"$DEPDIR"'/g' -e 's/\$U/'"$U"'/g'`; do
# Make sure the directory exists.
test -f "$dirpart/$file" && continue
fdir=`AS_DIRNAME(["$file"])`
AS_MKDIR_P([$dirpart/$fdir])
# echo "creating $dirpart/$file"
echo '# dummy' > "$dirpart/$file"
done
done
])# _AM_OUTPUT_DEPENDENCY_COMMANDS
# AM_OUTPUT_DEPENDENCY_COMMANDS
# -----------------------------
# This macro should only be invoked once -- use via AC_REQUIRE.
#
# This code is only required when automatic dependency tracking
# is enabled. FIXME. This creates each `.P' file that we will
# need in order to bootstrap the dependency handling code.
AC_DEFUN([AM_OUTPUT_DEPENDENCY_COMMANDS],
[AC_CONFIG_COMMANDS([depfiles],
[test x"$AMDEP_TRUE" != x"" || _AM_OUTPUT_DEPENDENCY_COMMANDS],
[AMDEP_TRUE="$AMDEP_TRUE" ac_aux_dir="$ac_aux_dir"])
])
# Copyright (C) 1996, 1997, 2000, 2001, 2003, 2005
# Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 8
# AM_CONFIG_HEADER is obsolete. It has been replaced by AC_CONFIG_HEADERS.
AU_DEFUN([AM_CONFIG_HEADER], [AC_CONFIG_HEADERS($@)])
# Do all the work for Automake. -*- Autoconf -*-
# Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004,
# 2005, 2006, 2008 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 13
# This macro actually does too much. Some checks are only needed if
# your package does certain things. But this isn't really a big deal.
# AM_INIT_AUTOMAKE(PACKAGE, VERSION, [NO-DEFINE])
# AM_INIT_AUTOMAKE([OPTIONS])
# -----------------------------------------------
# The call with PACKAGE and VERSION arguments is the old style
# call (pre autoconf-2.50), which is being phased out. PACKAGE
# and VERSION should now be passed to AC_INIT and removed from
# the call to AM_INIT_AUTOMAKE.
# We support both call styles for the transition. After
# the next Automake release, Autoconf can make the AC_INIT
# arguments mandatory, and then we can depend on a new Autoconf
# release and drop the old call support.
AC_DEFUN([AM_INIT_AUTOMAKE],
[AC_PREREQ([2.60])dnl
dnl Autoconf wants to disallow AM_ names. We explicitly allow
dnl the ones we care about.
m4_pattern_allow([^AM_[A-Z]+FLAGS$])dnl
AC_REQUIRE([AM_SET_CURRENT_AUTOMAKE_VERSION])dnl
AC_REQUIRE([AC_PROG_INSTALL])dnl
if test "`cd $srcdir && pwd`" != "`pwd`"; then
# Use -I$(srcdir) only when $(srcdir) != ., so that make's output
# is not polluted with repeated "-I."
AC_SUBST([am__isrc], [' -I$(srcdir)'])_AM_SUBST_NOTMAKE([am__isrc])dnl
# test to see if srcdir already configured
if test -f $srcdir/config.status; then
AC_MSG_ERROR([source directory already configured; run "make distclean" there first])
fi
fi
# test whether we have cygpath
if test -z "$CYGPATH_W"; then
if (cygpath --version) >/dev/null 2>/dev/null; then
CYGPATH_W='cygpath -w'
else
CYGPATH_W=echo
fi
fi
AC_SUBST([CYGPATH_W])
# Define the identity of the package.
dnl Distinguish between old-style and new-style calls.
m4_ifval([$2],
[m4_ifval([$3], [_AM_SET_OPTION([no-define])])dnl
AC_SUBST([PACKAGE], [$1])dnl
AC_SUBST([VERSION], [$2])],
[_AM_SET_OPTIONS([$1])dnl
dnl Diagnose old-style AC_INIT with new-style AM_AUTOMAKE_INIT.
m4_if(m4_ifdef([AC_PACKAGE_NAME], 1)m4_ifdef([AC_PACKAGE_VERSION], 1), 11,,
[m4_fatal([AC_INIT should be called with package and version arguments])])dnl
AC_SUBST([PACKAGE], ['AC_PACKAGE_TARNAME'])dnl
AC_SUBST([VERSION], ['AC_PACKAGE_VERSION'])])dnl
_AM_IF_OPTION([no-define],,
[AC_DEFINE_UNQUOTED(PACKAGE, "$PACKAGE", [Name of package])
AC_DEFINE_UNQUOTED(VERSION, "$VERSION", [Version number of package])])dnl
# Some tools Automake needs.
AC_REQUIRE([AM_SANITY_CHECK])dnl
AC_REQUIRE([AC_ARG_PROGRAM])dnl
AM_MISSING_PROG(ACLOCAL, aclocal-${am__api_version})
AM_MISSING_PROG(AUTOCONF, autoconf)
AM_MISSING_PROG(AUTOMAKE, automake-${am__api_version})
AM_MISSING_PROG(AUTOHEADER, autoheader)
AM_MISSING_PROG(MAKEINFO, makeinfo)
AM_PROG_INSTALL_SH
AM_PROG_INSTALL_STRIP
AC_REQUIRE([AM_PROG_MKDIR_P])dnl
# We need awk for the "check" target. The system "awk" is bad on
# some platforms.
AC_REQUIRE([AC_PROG_AWK])dnl
AC_REQUIRE([AC_PROG_MAKE_SET])dnl
AC_REQUIRE([AM_SET_LEADING_DOT])dnl
_AM_IF_OPTION([tar-ustar], [_AM_PROG_TAR([ustar])],
[_AM_IF_OPTION([tar-pax], [_AM_PROG_TAR([pax])],
[_AM_PROG_TAR([v7])])])
_AM_IF_OPTION([no-dependencies],,
[AC_PROVIDE_IFELSE([AC_PROG_CC],
[_AM_DEPENDENCIES(CC)],
[define([AC_PROG_CC],
defn([AC_PROG_CC])[_AM_DEPENDENCIES(CC)])])dnl
AC_PROVIDE_IFELSE([AC_PROG_CXX],
[_AM_DEPENDENCIES(CXX)],
[define([AC_PROG_CXX],
defn([AC_PROG_CXX])[_AM_DEPENDENCIES(CXX)])])dnl
AC_PROVIDE_IFELSE([AC_PROG_OBJC],
[_AM_DEPENDENCIES(OBJC)],
[define([AC_PROG_OBJC],
defn([AC_PROG_OBJC])[_AM_DEPENDENCIES(OBJC)])])dnl
])
])
# When config.status generates a header, we must update the stamp-h file.
# This file resides in the same directory as the config header
# that is generated. The stamp files are numbered to have different names.
# Autoconf calls _AC_AM_CONFIG_HEADER_HOOK (when defined) in the
# loop where config.status creates the headers, so we can generate
# our stamp files there.
AC_DEFUN([_AC_AM_CONFIG_HEADER_HOOK],
[# Compute $1's index in $config_headers.
_am_arg=$1
_am_stamp_count=1
for _am_header in $config_headers :; do
case $_am_header in
$_am_arg | $_am_arg:* )
break ;;
* )
_am_stamp_count=`expr $_am_stamp_count + 1` ;;
esac
done
echo "timestamp for $_am_arg" >`AS_DIRNAME(["$_am_arg"])`/stamp-h[]$_am_stamp_count])
# Copyright (C) 2001, 2003, 2005 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# AM_PROG_INSTALL_SH
# ------------------
# Define $install_sh.
AC_DEFUN([AM_PROG_INSTALL_SH],
[AC_REQUIRE([AM_AUX_DIR_EXPAND])dnl
install_sh=${install_sh-"\$(SHELL) $am_aux_dir/install-sh"}
AC_SUBST(install_sh)])
# Copyright (C) 2003, 2005 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 2
# Check whether the underlying file-system supports filenames
# with a leading dot. For instance MS-DOS doesn't.
AC_DEFUN([AM_SET_LEADING_DOT],
[rm -rf .tst 2>/dev/null
mkdir .tst 2>/dev/null
if test -d .tst; then
am__leading_dot=.
else
am__leading_dot=_
fi
rmdir .tst 2>/dev/null
AC_SUBST([am__leading_dot])])
# Check to see how 'make' treats includes. -*- Autoconf -*-
# Copyright (C) 2001, 2002, 2003, 2005 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 3
# AM_MAKE_INCLUDE()
# -----------------
# Check to see how make treats includes.
AC_DEFUN([AM_MAKE_INCLUDE],
[am_make=${MAKE-make}
cat > confinc << 'END'
am__doit:
@echo done
.PHONY: am__doit
END
# If we don't find an include directive, just comment out the code.
AC_MSG_CHECKING([for style of include used by $am_make])
am__include="#"
am__quote=
_am_result=none
# First try GNU make style include.
echo "include confinc" > confmf
# We grep out `Entering directory' and `Leaving directory'
# messages which can occur if `w' ends up in MAKEFLAGS.
# In particular we don't look at `^make:' because GNU make might
# be invoked under some other name (usually "gmake"), in which
# case it prints its new name instead of `make'.
if test "`$am_make -s -f confmf 2> /dev/null | grep -v 'ing directory'`" = "done"; then
am__include=include
am__quote=
_am_result=GNU
fi
# Now try BSD make style include.
if test "$am__include" = "#"; then
echo '.include "confinc"' > confmf
if test "`$am_make -s -f confmf 2> /dev/null`" = "done"; then
am__include=.include
am__quote="\""
_am_result=BSD
fi
fi
AC_SUBST([am__include])
AC_SUBST([am__quote])
AC_MSG_RESULT([$_am_result])
rm -f confinc confmf
])
# Fake the existence of programs that GNU maintainers use. -*- Autoconf -*-
# Copyright (C) 1997, 1999, 2000, 2001, 2003, 2004, 2005
# Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 5
# AM_MISSING_PROG(NAME, PROGRAM)
# ------------------------------
AC_DEFUN([AM_MISSING_PROG],
[AC_REQUIRE([AM_MISSING_HAS_RUN])
$1=${$1-"${am_missing_run}$2"}
AC_SUBST($1)])
# AM_MISSING_HAS_RUN
# ------------------
# Define MISSING if not defined so far and test if it supports --run.
# If it does, set am_missing_run to use it, otherwise, to nothing.
AC_DEFUN([AM_MISSING_HAS_RUN],
[AC_REQUIRE([AM_AUX_DIR_EXPAND])dnl
AC_REQUIRE_AUX_FILE([missing])dnl
test x"${MISSING+set}" = xset || MISSING="\${SHELL} $am_aux_dir/missing"
# Use eval to expand $SHELL
if eval "$MISSING --run true"; then
am_missing_run="$MISSING --run "
else
am_missing_run=
AC_MSG_WARN([`missing' script is too old or missing])
fi
])
# Copyright (C) 2003, 2004, 2005, 2006 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# AM_PROG_MKDIR_P
# ---------------
# Check for `mkdir -p'.
AC_DEFUN([AM_PROG_MKDIR_P],
[AC_PREREQ([2.60])dnl
AC_REQUIRE([AC_PROG_MKDIR_P])dnl
dnl Automake 1.8 to 1.9.6 used to define mkdir_p. We now use MKDIR_P,
dnl while keeping a definition of mkdir_p for backward compatibility.
dnl @MKDIR_P@ is magic: AC_OUTPUT adjusts its value for each Makefile.
dnl However we cannot define mkdir_p as $(MKDIR_P) for the sake of
dnl Makefile.ins that do not define MKDIR_P, so we do our own
dnl adjustment using top_builddir (which is defined more often than
dnl MKDIR_P).
AC_SUBST([mkdir_p], ["$MKDIR_P"])dnl
case $mkdir_p in
[[\\/$]]* | ?:[[\\/]]*) ;;
*/*) mkdir_p="\$(top_builddir)/$mkdir_p" ;;
esac
])
# Helper functions for option handling. -*- Autoconf -*-
# Copyright (C) 2001, 2002, 2003, 2005 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 3
# _AM_MANGLE_OPTION(NAME)
# -----------------------
AC_DEFUN([_AM_MANGLE_OPTION],
[[_AM_OPTION_]m4_bpatsubst($1, [[^a-zA-Z0-9_]], [_])])
# _AM_SET_OPTION(NAME)
# ------------------------------
# Set option NAME. Presently that only means defining a flag for this option.
AC_DEFUN([_AM_SET_OPTION],
[m4_define(_AM_MANGLE_OPTION([$1]), 1)])
# _AM_SET_OPTIONS(OPTIONS)
# ----------------------------------
# OPTIONS is a space-separated list of Automake options.
AC_DEFUN([_AM_SET_OPTIONS],
[AC_FOREACH([_AM_Option], [$1], [_AM_SET_OPTION(_AM_Option)])])
# _AM_IF_OPTION(OPTION, IF-SET, [IF-NOT-SET])
# -------------------------------------------
# Execute IF-SET if OPTION is set, IF-NOT-SET otherwise.
AC_DEFUN([_AM_IF_OPTION],
[m4_ifset(_AM_MANGLE_OPTION([$1]), [$2], [$3])])
# Check to make sure that the build environment is sane. -*- Autoconf -*-
# Copyright (C) 1996, 1997, 2000, 2001, 2003, 2005
# Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 4
# AM_SANITY_CHECK
# ---------------
AC_DEFUN([AM_SANITY_CHECK],
[AC_MSG_CHECKING([whether build environment is sane])
# Just in case
sleep 1
echo timestamp > conftest.file
# Do `set' in a subshell so we don't clobber the current shell's
# arguments. Must try -L first in case configure is actually a
# symlink; some systems play weird games with the mod time of symlinks
# (eg FreeBSD returns the mod time of the symlink's containing
# directory).
if (
set X `ls -Lt $srcdir/configure conftest.file 2> /dev/null`
if test "$[*]" = "X"; then
# -L didn't work.
set X `ls -t $srcdir/configure conftest.file`
fi
rm -f conftest.file
if test "$[*]" != "X $srcdir/configure conftest.file" \
&& test "$[*]" != "X conftest.file $srcdir/configure"; then
# If neither matched, then we have a broken ls. This can happen
# if, for instance, CONFIG_SHELL is bash and it inherits a
# broken ls alias from the environment. This has actually
# happened. Such a system could not be considered "sane".
AC_MSG_ERROR([ls -t appears to fail. Make sure there is not a broken
alias in your environment])
fi
test "$[2]" = conftest.file
)
then
# Ok.
:
else
AC_MSG_ERROR([newly created file is older than distributed files!
Check your system clock])
fi
AC_MSG_RESULT(yes)])
# Copyright (C) 2001, 2003, 2005 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# AM_PROG_INSTALL_STRIP
# ---------------------
# One issue with vendor `install' (even GNU) is that you can't
# specify the program used to strip binaries. This is especially
# annoying in cross-compiling environments, where the build's strip
# is unlikely to handle the host's binaries.
# Fortunately install-sh will honor a STRIPPROG variable, so we
# always use install-sh in `make install-strip', and initialize
# STRIPPROG with the value of the STRIP variable (set by the user).
AC_DEFUN([AM_PROG_INSTALL_STRIP],
[AC_REQUIRE([AM_PROG_INSTALL_SH])dnl
# Installed binaries are usually stripped using `strip' when the user
# run `make install-strip'. However `strip' might not be the right
# tool to use in cross-compilation environments, therefore Automake
# will honor the `STRIP' environment variable to overrule this program.
dnl Don't test for $cross_compiling = yes, because it might be `maybe'.
if test "$cross_compiling" != no; then
AC_CHECK_TOOL([STRIP], [strip], :)
fi
INSTALL_STRIP_PROGRAM="\$(install_sh) -c -s"
AC_SUBST([INSTALL_STRIP_PROGRAM])])
# Copyright (C) 2006 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# _AM_SUBST_NOTMAKE(VARIABLE)
# ---------------------------
# Prevent Automake from outputting VARIABLE = @VARIABLE@ in Makefile.in.
# This macro is traced by Automake.
AC_DEFUN([_AM_SUBST_NOTMAKE])
# Check how to create a tarball. -*- Autoconf -*-
# Copyright (C) 2004, 2005 Free Software Foundation, Inc.
#
# This file is free software; the Free Software Foundation
# gives unlimited permission to copy and/or distribute it,
# with or without modifications, as long as this notice is preserved.
# serial 2
# _AM_PROG_TAR(FORMAT)
# --------------------
# Check how to create a tarball in format FORMAT.
# FORMAT should be one of `v7', `ustar', or `pax'.
#
# Substitute a variable $(am__tar) that is a command
# writing to stdout a FORMAT-tarball containing the directory
# $tardir.
# tardir=directory && $(am__tar) > result.tar
#
# Substitute a variable $(am__untar) that extract such
# a tarball read from stdin.
# $(am__untar) < result.tar
AC_DEFUN([_AM_PROG_TAR],
[# Always define AMTAR for backward compatibility.
AM_MISSING_PROG([AMTAR], [tar])
m4_if([$1], [v7],
[am__tar='${AMTAR} chof - "$$tardir"'; am__untar='${AMTAR} xf -'],
[m4_case([$1], [ustar],, [pax],,
[m4_fatal([Unknown tar format])])
AC_MSG_CHECKING([how to create a $1 tar archive])
# Loop over all known methods to create a tar archive until one works.
_am_tools='gnutar m4_if([$1], [ustar], [plaintar]) pax cpio none'
_am_tools=${am_cv_prog_tar_$1-$_am_tools}
# Do not fold the above two line into one, because Tru64 sh and
# Solaris sh will not grok spaces in the rhs of `-'.
for _am_tool in $_am_tools
do
case $_am_tool in
gnutar)
for _am_tar in tar gnutar gtar;
do
AM_RUN_LOG([$_am_tar --version]) && break
done
am__tar="$_am_tar --format=m4_if([$1], [pax], [posix], [$1]) -chf - "'"$$tardir"'
am__tar_="$_am_tar --format=m4_if([$1], [pax], [posix], [$1]) -chf - "'"$tardir"'
am__untar="$_am_tar -xf -"
;;
plaintar)
# Must skip GNU tar: if it does not support --format= it doesn't create
# ustar tarball either.
(tar --version) >/dev/null 2>&1 && continue
am__tar='tar chf - "$$tardir"'
am__tar_='tar chf - "$tardir"'
am__untar='tar xf -'
;;
pax)
am__tar='pax -L -x $1 -w "$$tardir"'
am__tar_='pax -L -x $1 -w "$tardir"'
am__untar='pax -r'
;;
cpio)
am__tar='find "$$tardir" -print | cpio -o -H $1 -L'
am__tar_='find "$tardir" -print | cpio -o -H $1 -L'
am__untar='cpio -i -H $1 -d'
;;
none)
am__tar=false
am__tar_=false
am__untar=false
;;
esac
# If the value was cached, stop now. We just wanted to have am__tar
# and am__untar set.
test -n "${am_cv_prog_tar_$1}" && break
# tar/untar a dummy directory, and stop if the command works
rm -rf conftest.dir
mkdir conftest.dir
echo GrepMe > conftest.dir/file
AM_RUN_LOG([tardir=conftest.dir && eval $am__tar_ >conftest.tar])
rm -rf conftest.dir
if test -s conftest.tar; then
AM_RUN_LOG([$am__untar <conftest.tar])
grep GrepMe conftest.dir/file >/dev/null 2>&1 && break
fi
done
rm -rf conftest.dir
AC_CACHE_VAL([am_cv_prog_tar_$1], [am_cv_prog_tar_$1=$_am_tool])
AC_MSG_RESULT([$am_cv_prog_tar_$1])])
AC_SUBST([am__tar])
AC_SUBST([am__untar])
]) # _AM_PROG_TAR
m4_include([acinclude.m4])

@ -0,0 +1,397 @@
GNU Free Documentation License
Version 1.2, November 2002
Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
0. PREAMBLE
The purpose of this License is to make a manual, textbook, or other
functional and useful document "free" in the sense of freedom: to
assure everyone the effective freedom to copy and redistribute it,
with or without modifying it, either commercially or noncommercially.
Secondarily, this License preserves for the author and publisher a way
to get credit for their work, while not being considered responsible
for modifications made by others.
This License is a kind of "copyleft", which means that derivative
works of the document must themselves be free in the same sense. It
complements the GNU General Public License, which is a copyleft
license designed for free software.
We have designed this License in order to use it for manuals for free
software, because free software needs free documentation: a free
program should come with manuals providing the same freedoms that the
software does. But this License is not limited to software manuals;
it can be used for any textual work, regardless of subject matter or
whether it is published as a printed book. We recommend this License
principally for works whose purpose is instruction or reference.
1. APPLICABILITY AND DEFINITIONS
This License applies to any manual or other work, in any medium, that
contains a notice placed by the copyright holder saying it can be
distributed under the terms of this License. Such a notice grants a
world-wide, royalty-free license, unlimited in duration, to use that
work under the conditions stated herein. The "Document", below,
refers to any such manual or work. Any member of the public is a
licensee, and is addressed as "you". You accept the license if you
copy, modify or distribute the work in a way requiring permission
under copyright law.
A "Modified Version" of the Document means any work containing the
Document or a portion of it, either copied verbatim, or with
modifications and/or translated into another language.
A "Secondary Section" is a named appendix or a front-matter section of
the Document that deals exclusively with the relationship of the
publishers or authors of the Document to the Document's overall subject
(or to related matters) and contains nothing that could fall directly
within that overall subject. (Thus, if the Document is in part a
textbook of mathematics, a Secondary Section may not explain any
mathematics.) The relationship could be a matter of historical
connection with the subject or with related matters, or of legal,
commercial, philosophical, ethical or political position regarding
them.
The "Invariant Sections" are certain Secondary Sections whose titles
are designated, as being those of Invariant Sections, in the notice
that says that the Document is released under this License. If a
section does not fit the above definition of Secondary then it is not
allowed to be designated as Invariant. The Document may contain zero
Invariant Sections. If the Document does not identify any Invariant
Sections then there are none.
The "Cover Texts" are certain short passages of text that are listed,
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
the Document is released under this License. A Front-Cover Text may
be at most 5 words, and a Back-Cover Text may be at most 25 words.
A "Transparent" copy of the Document means a machine-readable copy,
represented in a format whose specification is available to the
general public, that is suitable for revising the document
straightforwardly with generic text editors or (for images composed of
pixels) generic paint programs or (for drawings) some widely available
drawing editor, and that is suitable for input to text formatters or
for automatic translation to a variety of formats suitable for input
to text formatters. A copy made in an otherwise Transparent file
format whose markup, or absence of markup, has been arranged to thwart
or discourage subsequent modification by readers is not Transparent.
An image format is not Transparent if used for any substantial amount
of text. A copy that is not "Transparent" is called "Opaque".
Examples of suitable formats for Transparent copies include plain
ASCII without markup, Texinfo input format, LaTeX input format, SGML
or XML using a publicly available DTD, and standard-conforming simple
HTML, PostScript or PDF designed for human modification. Examples of
transparent image formats include PNG, XCF and JPG. Opaque formats
include proprietary formats that can be read and edited only by
proprietary word processors, SGML or XML for which the DTD and/or
processing tools are not generally available, and the
machine-generated HTML, PostScript or PDF produced by some word
processors for output purposes only.
The "Title Page" means, for a printed book, the title page itself,
plus such following pages as are needed to hold, legibly, the material
this License requires to appear in the title page. For works in
formats which do not have any title page as such, "Title Page" means
the text near the most prominent appearance of the work's title,
preceding the beginning of the body of the text.
A section "Entitled XYZ" means a named subunit of the Document whose
title either is precisely XYZ or contains XYZ in parentheses following
text that translates XYZ in another language. (Here XYZ stands for a
specific section name mentioned below, such as "Acknowledgements",
"Dedications", "Endorsements", or "History".) To "Preserve the Title"
of such a section when you modify the Document means that it remains a
section "Entitled XYZ" according to this definition.
The Document may include Warranty Disclaimers next to the notice which
states that this License applies to the Document. These Warranty
Disclaimers are considered to be included by reference in this
License, but only as regards disclaiming warranties: any other
implication that these Warranty Disclaimers may have is void and has
no effect on the meaning of this License.
2. VERBATIM COPYING
You may copy and distribute the Document in any medium, either
commercially or noncommercially, provided that this License, the
copyright notices, and the license notice saying this License applies
to the Document are reproduced in all copies, and that you add no other
conditions whatsoever to those of this License. You may not use
technical measures to obstruct or control the reading or further
copying of the copies you make or distribute. However, you may accept
compensation in exchange for copies. If you distribute a large enough
number of copies you must also follow the conditions in section 3.
You may also lend copies, under the same conditions stated above, and
you may publicly display copies.
3. COPYING IN QUANTITY
If you publish printed copies (or copies in media that commonly have
printed covers) of the Document, numbering more than 100, and the
Document's license notice requires Cover Texts, you must enclose the
copies in covers that carry, clearly and legibly, all these Cover
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
the back cover. Both covers must also clearly and legibly identify
you as the publisher of these copies. The front cover must present
the full title with all words of the title equally prominent and
visible. You may add other material on the covers in addition.
Copying with changes limited to the covers, as long as they preserve
the title of the Document and satisfy these conditions, can be treated
as verbatim copying in other respects.
If the required texts for either cover are too voluminous to fit
legibly, you should put the first ones listed (as many as fit
reasonably) on the actual cover, and continue the rest onto adjacent
pages.
If you publish or distribute Opaque copies of the Document numbering
more than 100, you must either include a machine-readable Transparent
copy along with each Opaque copy, or state in or with each Opaque copy
a computer-network location from which the general network-using
public has access to download using public-standard network protocols
a complete Transparent copy of the Document, free of added material.
If you use the latter option, you must take reasonably prudent steps,
when you begin distribution of Opaque copies in quantity, to ensure
that this Transparent copy will remain thus accessible at the stated
location until at least one year after the last time you distribute an
Opaque copy (directly or through your agents or retailers) of that
edition to the public.
It is requested, but not required, that you contact the authors of the
Document well before redistributing any large number of copies, to give
them a chance to provide you with an updated version of the Document.
4. MODIFICATIONS
You may copy and distribute a Modified Version of the Document under
the conditions of sections 2 and 3 above, provided that you release
the Modified Version under precisely this License, with the Modified
Version filling the role of the Document, thus licensing distribution
and modification of the Modified Version to whoever possesses a copy
of it. In addition, you must do these things in the Modified Version:
A. Use in the Title Page (and on the covers, if any) a title distinct
from that of the Document, and from those of previous versions
(which should, if there were any, be listed in the History section
of the Document). You may use the same title as a previous version
if the original publisher of that version gives permission.
B. List on the Title Page, as authors, one or more persons or entities
responsible for authorship of the modifications in the Modified
Version, together with at least five of the principal authors of the
Document (all of its principal authors, if it has fewer than five),
unless they release you from this requirement.
C. State on the Title page the name of the publisher of the
Modified Version, as the publisher.
D. Preserve all the copyright notices of the Document.
E. Add an appropriate copyright notice for your modifications
adjacent to the other copyright notices.
F. Include, immediately after the copyright notices, a license notice
giving the public permission to use the Modified Version under the
terms of this License, in the form shown in the Addendum below.
G. Preserve in that license notice the full lists of Invariant Sections
and required Cover Texts given in the Document's license notice.
H. Include an unaltered copy of this License.
I. Preserve the section Entitled "History", Preserve its Title, and add
to it an item stating at least the title, year, new authors, and
publisher of the Modified Version as given on the Title Page. If
there is no section Entitled "History" in the Document, create one
stating the title, year, authors, and publisher of the Document as
given on its Title Page, then add an item describing the Modified
Version as stated in the previous sentence.
J. Preserve the network location, if any, given in the Document for
public access to a Transparent copy of the Document, and likewise
the network locations given in the Document for previous versions
it was based on. These may be placed in the "History" section.
You may omit a network location for a work that was published at
least four years before the Document itself, or if the original
publisher of the version it refers to gives permission.
K. For any section Entitled "Acknowledgements" or "Dedications",
Preserve the Title of the section, and preserve in the section all
the substance and tone of each of the contributor acknowledgements
and/or dedications given therein.
L. Preserve all the Invariant Sections of the Document,
unaltered in their text and in their titles. Section numbers
or the equivalent are not considered part of the section titles.
M. Delete any section Entitled "Endorsements". Such a section
may not be included in the Modified Version.
N. Do not retitle any existing section to be Entitled "Endorsements"
or to conflict in title with any Invariant Section.
O. Preserve any Warranty Disclaimers.
If the Modified Version includes new front-matter sections or
appendices that qualify as Secondary Sections and contain no material
copied from the Document, you may at your option designate some or all
of these sections as invariant. To do this, add their titles to the
list of Invariant Sections in the Modified Version's license notice.
These titles must be distinct from any other section titles.
You may add a section Entitled "Endorsements", provided it contains
nothing but endorsements of your Modified Version by various
parties--for example, statements of peer review or that the text has
been approved by an organization as the authoritative definition of a
standard.
You may add a passage of up to five words as a Front-Cover Text, and a
passage of up to 25 words as a Back-Cover Text, to the end of the list
of Cover Texts in the Modified Version. Only one passage of
Front-Cover Text and one of Back-Cover Text may be added by (or
through arrangements made by) any one entity. If the Document already
includes a cover text for the same cover, previously added by you or
by arrangement made by the same entity you are acting on behalf of,
you may not add another; but you may replace the old one, on explicit
permission from the previous publisher that added the old one.
The author(s) and publisher(s) of the Document do not by this License
give permission to use their names for publicity for or to assert or
imply endorsement of any Modified Version.
5. COMBINING DOCUMENTS
You may combine the Document with other documents released under this
License, under the terms defined in section 4 above for modified
versions, provided that you include in the combination all of the
Invariant Sections of all of the original documents, unmodified, and
list them all as Invariant Sections of your combined work in its
license notice, and that you preserve all their Warranty Disclaimers.
The combined work need only contain one copy of this License, and
multiple identical Invariant Sections may be replaced with a single
copy. If there are multiple Invariant Sections with the same name but
different contents, make the title of each such section unique by
adding at the end of it, in parentheses, the name of the original
author or publisher of that section if known, or else a unique number.
Make the same adjustment to the section titles in the list of
Invariant Sections in the license notice of the combined work.
In the combination, you must combine any sections Entitled "History"
in the various original documents, forming one section Entitled
"History"; likewise combine any sections Entitled "Acknowledgements",
and any sections Entitled "Dedications". You must delete all sections
Entitled "Endorsements".
6. COLLECTIONS OF DOCUMENTS
You may make a collection consisting of the Document and other documents
released under this License, and replace the individual copies of this
License in the various documents with a single copy that is included in
the collection, provided that you follow the rules of this License for
verbatim copying of each of the documents in all other respects.
You may extract a single document from such a collection, and distribute
it individually under this License, provided you insert a copy of this
License into the extracted document, and follow this License in all
other respects regarding verbatim copying of that document.
7. AGGREGATION WITH INDEPENDENT WORKS
A compilation of the Document or its derivatives with other separate
and independent documents or works, in or on a volume of a storage or
distribution medium, is called an "aggregate" if the copyright
resulting from the compilation is not used to limit the legal rights
of the compilation's users beyond what the individual works permit.
When the Document is included in an aggregate, this License does not
apply to the other works in the aggregate which are not themselves
derivative works of the Document.
If the Cover Text requirement of section 3 is applicable to these
copies of the Document, then if the Document is less than one half of
the entire aggregate, the Document's Cover Texts may be placed on
covers that bracket the Document within the aggregate, or the
electronic equivalent of covers if the Document is in electronic form.
Otherwise they must appear on printed covers that bracket the whole
aggregate.
8. TRANSLATION
Translation is considered a kind of modification, so you may
distribute translations of the Document under the terms of section 4.
Replacing Invariant Sections with translations requires special
permission from their copyright holders, but you may include
translations of some or all Invariant Sections in addition to the
original versions of these Invariant Sections. You may include a
translation of this License, and all the license notices in the
Document, and any Warranty Disclaimers, provided that you also include
the original English version of this License and the original versions
of those notices and disclaimers. In case of a disagreement between
the translation and the original version of this License or a notice
or disclaimer, the original version will prevail.
If a section in the Document is Entitled "Acknowledgements",
"Dedications", or "History", the requirement (section 4) to Preserve
its Title (section 1) will typically require changing the actual
title.
9. TERMINATION
You may not copy, modify, sublicense, or distribute the Document except
as expressly provided for under this License. Any other attempt to
copy, modify, sublicense or distribute the Document is void, and will
automatically terminate your rights under this License. However,
parties who have received copies, or rights, from you under this
License will not have their licenses terminated so long as such
parties remain in full compliance.
10. FUTURE REVISIONS OF THIS LICENSE
The Free Software Foundation may publish new, revised versions
of the GNU Free Documentation License from time to time. Such new
versions will be similar in spirit to the present version, but may
differ in detail to address new problems or concerns. See
http://www.gnu.org/copyleft/.
Each version of the License is given a distinguishing version number.
If the Document specifies that a particular numbered version of this
License "or any later version" applies to it, you have the option of
following the terms and conditions either of that specified version or
of any later version that has been published (not as a draft) by the
Free Software Foundation. If the Document does not specify a version
number of this License, you may choose any version ever published (not
as a draft) by the Free Software Foundation.
ADDENDUM: How to use this License for your documents
To use this License in a document you have written, include a copy of
the License in the document and put the following copyright and
license notices just after the title page:
Copyright (c) YEAR YOUR NAME.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.2
or any later version published by the Free Software Foundation;
with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
A copy of the license is included in the section entitled "GNU
Free Documentation License".
If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
replace the "with...Texts." line with this:
with the Invariant Sections being LIST THEIR TITLES, with the
Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
If you have Invariant Sections without Cover Texts, or some other
combination of the three, merge those two alternatives to suit the
situation.
If your document contains nontrivial examples of program code, we
recommend releasing these examples in parallel under your choice of
free software license, such as the GNU General Public License,
to permit their use in free software.

@ -0,0 +1,481 @@
GNU LIBRARY GENERAL PUBLIC LICENSE
Version 2, June 1991
Copyright (C) 1991 Free Software Foundation, Inc.
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
[This is the first released version of the library GPL. It is
numbered 2 because it goes with version 2 of the ordinary GPL.]
Preamble
The licenses for most software are designed to take away your
freedom to share and change it. By contrast, the GNU General Public
Licenses are intended to guarantee your freedom to share and change
free software--to make sure the software is free for all its users.
This license, the Library General Public License, applies to some
specially designated Free Software Foundation software, and to any
other libraries whose authors decide to use it. You can use it for
your libraries, too.
When we speak of free software, we are referring to freedom, not
price. Our General Public Licenses are designed to make sure that you
have the freedom to distribute copies of free software (and charge for
this service if you wish), that you receive source code or can get it
if you want it, that you can change the software or use pieces of it
in new free programs; and that you know you can do these things.
To protect your rights, we need to make restrictions that forbid
anyone to deny you these rights or to ask you to surrender the rights.
These restrictions translate to certain responsibilities for you if
you distribute copies of the library, or if you modify it.
For example, if you distribute copies of the library, whether gratis
or for a fee, you must give the recipients all the rights that we gave
you. You must make sure that they, too, receive or can get the source
code. If you link a program with the library, you must provide
complete object files to the recipients so that they can relink them
with the library, after making changes to the library and recompiling
it. And you must show them these terms so they know their rights.
Our method of protecting your rights has two steps: (1) copyright
the library, and (2) offer you this license which gives you legal
permission to copy, distribute and/or modify the library.
Also, for each distributor's protection, we want to make certain
that everyone understands that there is no warranty for this free
library. If the library is modified by someone else and passed on, we
want its recipients to know that what they have is not the original
version, so that any problems introduced by others will not reflect on
the original authors' reputations.
Finally, any free program is threatened constantly by software
patents. We wish to avoid the danger that companies distributing free
software will individually obtain patent licenses, thus in effect
transforming the program into proprietary software. To prevent this,
we have made it clear that any patent must be licensed for everyone's
free use or not licensed at all.
Most GNU software, including some libraries, is covered by the ordinary
GNU General Public License, which was designed for utility programs. This
license, the GNU Library General Public License, applies to certain
designated libraries. This license is quite different from the ordinary
one; be sure to read it in full, and don't assume that anything in it is
the same as in the ordinary license.
The reason we have a separate public license for some libraries is that
they blur the distinction we usually make between modifying or adding to a
program and simply using it. Linking a program with a library, without
changing the library, is in some sense simply using the library, and is
analogous to running a utility program or application program. However, in
a textual and legal sense, the linked executable is a combined work, a
derivative of the original library, and the ordinary General Public License
treats it as such.
Because of this blurred distinction, using the ordinary General
Public License for libraries did not effectively promote software
sharing, because most developers did not use the libraries. We
concluded that weaker conditions might promote sharing better.
However, unrestricted linking of non-free programs would deprive the
users of those programs of all benefit from the free status of the
libraries themselves. This Library General Public License is intended to
permit developers of non-free programs to use free libraries, while
preserving your freedom as a user of such programs to change the free
libraries that are incorporated in them. (We have not seen how to achieve
this as regards changes in header files, but we have achieved it as regards
changes in the actual functions of the Library.) The hope is that this
will lead to faster development of free libraries.
The precise terms and conditions for copying, distribution and
modification follow. Pay close attention to the difference between a
"work based on the library" and a "work that uses the library". The
former contains code derived from the library, while the latter only
works together with the library.
Note that it is possible for a library to be covered by the ordinary
General Public License rather than by this special one.
GNU LIBRARY GENERAL PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. This License Agreement applies to any software library which
contains a notice placed by the copyright holder or other authorized
party saying it may be distributed under the terms of this Library
General Public License (also called "this License"). Each licensee is
addressed as "you".
A "library" means a collection of software functions and/or data
prepared so as to be conveniently linked with application programs
(which use some of those functions and data) to form executables.
The "Library", below, refers to any such software library or work
which has been distributed under these terms. A "work based on the
Library" means either the Library or any derivative work under
copyright law: that is to say, a work containing the Library or a
portion of it, either verbatim or with modifications and/or translated
straightforwardly into another language. (Hereinafter, translation is
included without limitation in the term "modification".)
"Source code" for a work means the preferred form of the work for
making modifications to it. For a library, complete source code means
all the source code for all modules it contains, plus any associated
interface definition files, plus the scripts used to control compilation
and installation of the library.
Activities other than copying, distribution and modification are not
covered by this License; they are outside its scope. The act of
running a program using the Library is not restricted, and output from
such a program is covered only if its contents constitute a work based
on the Library (independent of the use of the Library in a tool for
writing it). Whether that is true depends on what the Library does
and what the program that uses the Library does.
1. You may copy and distribute verbatim copies of the Library's
complete source code as you receive it, in any medium, provided that
you conspicuously and appropriately publish on each copy an
appropriate copyright notice and disclaimer of warranty; keep intact
all the notices that refer to this License and to the absence of any
warranty; and distribute a copy of this License along with the
Library.
You may charge a fee for the physical act of transferring a copy,
and you may at your option offer warranty protection in exchange for a
fee.
2. You may modify your copy or copies of the Library or any portion
of it, thus forming a work based on the Library, and copy and
distribute such modifications or work under the terms of Section 1
above, provided that you also meet all of these conditions:
a) The modified work must itself be a software library.
b) You must cause the files modified to carry prominent notices
stating that you changed the files and the date of any change.
c) You must cause the whole of the work to be licensed at no
charge to all third parties under the terms of this License.
d) If a facility in the modified Library refers to a function or a
table of data to be supplied by an application program that uses
the facility, other than as an argument passed when the facility
is invoked, then you must make a good faith effort to ensure that,
in the event an application does not supply such function or
table, the facility still operates, and performs whatever part of
its purpose remains meaningful.
(For example, a function in a library to compute square roots has
a purpose that is entirely well-defined independent of the
application. Therefore, Subsection 2d requires that any
application-supplied function or table used by this function must
be optional: if the application does not supply it, the square
root function must still compute square roots.)
These requirements apply to the modified work as a whole. If
identifiable sections of that work are not derived from the Library,
and can be reasonably considered independent and separate works in
themselves, then this License, and its terms, do not apply to those
sections when you distribute them as separate works. But when you
distribute the same sections as part of a whole which is a work based
on the Library, the distribution of the whole must be on the terms of
this License, whose permissions for other licensees extend to the
entire whole, and thus to each and every part regardless of who wrote
it.
Thus, it is not the intent of this section to claim rights or contest
your rights to work written entirely by you; rather, the intent is to
exercise the right to control the distribution of derivative or
collective works based on the Library.
In addition, mere aggregation of another work not based on the Library
with the Library (or with a work based on the Library) on a volume of
a storage or distribution medium does not bring the other work under
the scope of this License.
3. You may opt to apply the terms of the ordinary GNU General Public
License instead of this License to a given copy of the Library. To do
this, you must alter all the notices that refer to this License, so
that they refer to the ordinary GNU General Public License, version 2,
instead of to this License. (If a newer version than version 2 of the
ordinary GNU General Public License has appeared, then you can specify
that version instead if you wish.) Do not make any other change in
these notices.
Once this change is made in a given copy, it is irreversible for
that copy, so the ordinary GNU General Public License applies to all
subsequent copies and derivative works made from that copy.
This option is useful when you wish to copy part of the code of
the Library into a program that is not a library.
4. You may copy and distribute the Library (or a portion or
derivative of it, under Section 2) in object code or executable form
under the terms of Sections 1 and 2 above provided that you accompany
it with the complete corresponding machine-readable source code, which
must be distributed under the terms of Sections 1 and 2 above on a
medium customarily used for software interchange.
If distribution of object code is made by offering access to copy
from a designated place, then offering equivalent access to copy the
source code from the same place satisfies the requirement to
distribute the source code, even though third parties are not
compelled to copy the source along with the object code.
5. A program that contains no derivative of any portion of the
Library, but is designed to work with the Library by being compiled or
linked with it, is called a "work that uses the Library". Such a
work, in isolation, is not a derivative work of the Library, and
therefore falls outside the scope of this License.
However, linking a "work that uses the Library" with the Library
creates an executable that is a derivative of the Library (because it
contains portions of the Library), rather than a "work that uses the
library". The executable is therefore covered by this License.
Section 6 states terms for distribution of such executables.
When a "work that uses the Library" uses material from a header file
that is part of the Library, the object code for the work may be a
derivative work of the Library even though the source code is not.
Whether this is true is especially significant if the work can be
linked without the Library, or if the work is itself a library. The
threshold for this to be true is not precisely defined by law.
If such an object file uses only numerical parameters, data
structure layouts and accessors, and small macros and small inline
functions (ten lines or less in length), then the use of the object
file is unrestricted, regardless of whether it is legally a derivative
work. (Executables containing this object code plus portions of the
Library will still fall under Section 6.)
Otherwise, if the work is a derivative of the Library, you may
distribute the object code for the work under the terms of Section 6.
Any executables containing that work also fall under Section 6,
whether or not they are linked directly with the Library itself.
6. As an exception to the Sections above, you may also compile or
link a "work that uses the Library" with the Library to produce a
work containing portions of the Library, and distribute that work
under terms of your choice, provided that the terms permit
modification of the work for the customer's own use and reverse
engineering for debugging such modifications.
You must give prominent notice with each copy of the work that the
Library is used in it and that the Library and its use are covered by
this License. You must supply a copy of this License. If the work
during execution displays copyright notices, you must include the
copyright notice for the Library among them, as well as a reference
directing the user to the copy of this License. Also, you must do one
of these things:
a) Accompany the work with the complete corresponding
machine-readable source code for the Library including whatever
changes were used in the work (which must be distributed under
Sections 1 and 2 above); and, if the work is an executable linked
with the Library, with the complete machine-readable "work that
uses the Library", as object code and/or source code, so that the
user can modify the Library and then relink to produce a modified
executable containing the modified Library. (It is understood
that the user who changes the contents of definitions files in the
Library will not necessarily be able to recompile the application
to use the modified definitions.)
b) Accompany the work with a written offer, valid for at
least three years, to give the same user the materials
specified in Subsection 6a, above, for a charge no more
than the cost of performing this distribution.
c) If distribution of the work is made by offering access to copy
from a designated place, offer equivalent access to copy the above
specified materials from the same place.
d) Verify that the user has already received a copy of these
materials or that you have already sent this user a copy.
For an executable, the required form of the "work that uses the
Library" must include any data and utility programs needed for
reproducing the executable from it. However, as a special exception,
the source code distributed need not include anything that is normally
distributed (in either source or binary form) with the major
components (compiler, kernel, and so on) of the operating system on
which the executable runs, unless that component itself accompanies
the executable.
It may happen that this requirement contradicts the license
restrictions of other proprietary libraries that do not normally
accompany the operating system. Such a contradiction means you cannot
use both them and the Library together in an executable that you
distribute.
7. You may place library facilities that are a work based on the
Library side-by-side in a single library together with other library
facilities not covered by this License, and distribute such a combined
library, provided that the separate distribution of the work based on
the Library and of the other library facilities is otherwise
permitted, and provided that you do these two things:
a) Accompany the combined library with a copy of the same work
based on the Library, uncombined with any other library
facilities. This must be distributed under the terms of the
Sections above.
b) Give prominent notice with the combined library of the fact
that part of it is a work based on the Library, and explaining
where to find the accompanying uncombined form of the same work.
8. You may not copy, modify, sublicense, link with, or distribute
the Library except as expressly provided under this License. Any
attempt otherwise to copy, modify, sublicense, link with, or
distribute the Library is void, and will automatically terminate your
rights under this License. However, parties who have received copies,
or rights, from you under this License will not have their licenses
terminated so long as such parties remain in full compliance.
9. You are not required to accept this License, since you have not
signed it. However, nothing else grants you permission to modify or
distribute the Library or its derivative works. These actions are
prohibited by law if you do not accept this License. Therefore, by
modifying or distributing the Library (or any work based on the
Library), you indicate your acceptance of this License to do so, and
all its terms and conditions for copying, distributing or modifying
the Library or works based on it.
10. Each time you redistribute the Library (or any work based on the
Library), the recipient automatically receives a license from the
original licensor to copy, distribute, link with or modify the Library
subject to these terms and conditions. You may not impose any further
restrictions on the recipients' exercise of the rights granted herein.
You are not responsible for enforcing compliance by third parties to
this License.
11. If, as a consequence of a court judgment or allegation of patent
infringement or for any other reason (not limited to patent issues),
conditions are imposed on you (whether by court order, agreement or
otherwise) that contradict the conditions of this License, they do not
excuse you from the conditions of this License. If you cannot
distribute so as to satisfy simultaneously your obligations under this
License and any other pertinent obligations, then as a consequence you
may not distribute the Library at all. For example, if a patent
license would not permit royalty-free redistribution of the Library by
all those who receive copies directly or indirectly through you, then
the only way you could satisfy both it and this License would be to
refrain entirely from distribution of the Library.
If any portion of this section is held invalid or unenforceable under any
particular circumstance, the balance of the section is intended to apply,
and the section as a whole is intended to apply in other circumstances.
It is not the purpose of this section to induce you to infringe any
patents or other property right claims or to contest validity of any
such claims; this section has the sole purpose of protecting the
integrity of the free software distribution system which is
implemented by public license practices. Many people have made
generous contributions to the wide range of software distributed
through that system in reliance on consistent application of that
system; it is up to the author/donor to decide if he or she is willing
to distribute software through any other system and a licensee cannot
impose that choice.
This section is intended to make thoroughly clear what is believed to
be a consequence of the rest of this License.
12. If the distribution and/or use of the Library is restricted in
certain countries either by patents or by copyrighted interfaces, the
original copyright holder who places the Library under this License may add
an explicit geographical distribution limitation excluding those countries,
so that distribution is permitted only in or among countries not thus
excluded. In such case, this License incorporates the limitation as if
written in the body of this License.
13. The Free Software Foundation may publish revised and/or new
versions of the Library General Public License from time to time.
Such new versions will be similar in spirit to the present version,
but may differ in detail to address new problems or concerns.
Each version is given a distinguishing version number. If the Library
specifies a version number of this License which applies to it and
"any later version", you have the option of following the terms and
conditions either of that version or of any later version published by
the Free Software Foundation. If the Library does not specify a
license version number, you may choose any version ever published by
the Free Software Foundation.
14. If you wish to incorporate parts of the Library into other free
programs whose distribution conditions are incompatible with these,
write to the author to ask for permission. For software which is
copyrighted by the Free Software Foundation, write to the Free
Software Foundation; we sometimes make exceptions for this. Our
decision will be guided by the two goals of preserving the free status
of all derivatives of our free software and of promoting the sharing
and reuse of software generally.
NO WARRANTY
15. BECAUSE THE LIBRARY IS LICENSED FREE OF CHARGE, THERE IS NO
WARRANTY FOR THE LIBRARY, TO THE EXTENT PERMITTED BY APPLICABLE LAW.
EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
OTHER PARTIES PROVIDE THE LIBRARY "AS IS" WITHOUT WARRANTY OF ANY
KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE
LIBRARY IS WITH YOU. SHOULD THE LIBRARY PROVE DEFECTIVE, YOU ASSUME
THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
16. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN
WRITING WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY
AND/OR REDISTRIBUTE THE LIBRARY AS PERMITTED ABOVE, BE LIABLE TO YOU
FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR
CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO USE THE
LIBRARY (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING
RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A
FAILURE OF THE LIBRARY TO OPERATE WITH ANY OTHER SOFTWARE), EVEN IF
SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH
DAMAGES.
END OF TERMS AND CONDITIONS
How to Apply These Terms to Your New Libraries
If you develop a new library, and you want it to be of the greatest
possible use to the public, we recommend making it free software that
everyone can redistribute and change. You can do so by permitting
redistribution under these terms (or, alternatively, under the terms of the
ordinary General Public License).
To apply these terms, attach the following notices to the library. It is
safest to attach them to the start of each source file to most effectively
convey the exclusion of warranty; and each file should have at least the
"copyright" line and a pointer to where the full notice is found.
<one line to give the library's name and a brief idea of what it does.>
Copyright (C) <year> <name of author>
This library is free software; you can redistribute it and/or
modify it under the terms of the GNU Library General Public
License as published by the Free Software Foundation; either
version 2 of the License, or (at your option) any later version.
This library is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
Library General Public License for more details.
You should have received a copy of the GNU Library General Public
License along with this library; if not, write to the Free Software
Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston MA 02110-1301 USA
Also add information on how to contact you by electronic and paper mail.
You should also get your employer (if you work as a programmer) or your
school, if any, to sign a "copyright disclaimer" for the library, if
necessary. Here is a sample; alter the names:
Yoyodyne, Inc., hereby disclaims all copyright interest in the
library `Frob' (a library for tweaking knobs) written by James Random Hacker.
<signature of Ty Coon>, 1 April 1990
Ty Coon, President of Vice
That's all there is to it!

@ -0,0 +1,269 @@
Hacking on Amarok
-----------------
Please respect these guidelines when coding for Amarok, thanks!
* Where this document isn't clear, refer to Amarok code.
This C++ FAQ is a life saver in many situations, so you want to keep it handy:
http://www.parashift.com/c++-faq-lite/
Formatting
----------
* Spaces, not tabs
* Indentation is 4 spaces
* Lines should be limited to 90 characters
* Spaces between brackets and argument functions
* For pointer and reference variable declarations put a space between the type
and the * or & and no space before the variable name.
* For if, else, while and similar statements put the brackets on the next line,
although brackets are not needed for single statements.
* Function and class definitions have their brackets on separate lines
* A function implementation's return type is on its own line.
* amarok.h contains some helpful macros, foreach and foreachType. Use them,
they improve coding style and readability.
Example:
| bool
| MyClass::myMethod( QPtrList<QListViewItem> items, const QString &name )
| {
| if( items.isEmpty() )
| return false;
|
| foreachType( QPtrList<QListViewItem>, items )
| {
| (*it)->setText( 0, name );
| debug() << "Setting item name: " << name << endl;
| }
| }
Header includes should be listed in the following order:
- Amarok includes
- KDE includes
- Qt includes
They should also be sorted alphabetically, for ease of locating them. A small comment
if applicable is also helpful.
Includes in a header file should be kept to the absolute minimum, as to keep compile times
low. This can be achieved by using "forward declarations" instead of includes, like
"class QListView;" Forward declarations work for pointers and const references.
TIP:
Kate/KDevelop users can sort the headers automatically. Select the lines you want to sort,
then Tools -> Filter Selection Through Command -> "sort".
Example:
| #include "amarok.h"
| #include "debug.h"
| #include "playlist.h"
|
| #include "kdialogbase.h" //baseclass
| #include "kpushbutton.h" //see function...
|
| #include "qlistviewitem.h"
| #include "qwidget.h"
Comments
--------
Comment your code. Don't comment what the code does, comment on the purpose of the code. It's
good for others reading your code, and ultimately it's good for you too.
Comments are essential when adding a strange hack, like the following example:
| /** Due to xine-lib, we have to make KProcess close all fds, otherwise we get "device is busy" messages
| * Used by AmarokProcIO and AmarokProcess, exploiting commSetupDoneC(), a virtual method that
| * happens to be called in the forked process
| * See bug #103750 for more information.
| */
| class AmarokProcIO : public KProcIO
| {
| public:
| virtual int commSetupDoneC() {
| const int i = KProcIO::commSetupDoneC();
| Amarok::closeOpenFiles(KProcIO::out[0],KProcIO::in[0],KProcIO::err[0]);
| return i;
| }
| };
For headers, use the Doxygen syntax. See: http://www.stack.nl/~dimitri/doxygen/
Example:
| /**
| * Start playback.
| * @param offset Start playing at @p msec position.
| * @return True for success.
| */
| virtual bool play( uint offset = 0 ) = 0;
Header Formatting
-----------------
General rules apply here. Please keep header function definitions aligned nicely,
if possible. It helps greatly when looking through the code. Sorted methods,
either by name or by their function (ie, group all related methods together) is
great too.
| #ifndef AMAROK_QUEUEMANAGER_H
| #define AMAROK_QUEUEMANAGER_H
| class QueueList : public KListView
| {
| Q_OBJECT
|
| public:
| Queuelist( QWidget *parent, const char *name = 0 );
| ~QueueList() {};
|
| public slots:
| void moveSelectedUp();
| void moveSelectedDown();
| };
#endif /* AMAROK_QUEUEMANAGER_H */
0 vs NULL
---------
The use of 0 to express a null pointer is preferred over the use of NULL.
0 is not a magic value, it's the defined value of the null pointer in C++.
NULL, on the other hand, is a preprocessor directive (#define) and not only is
it more typing than '0' but preprocessor directives are less elegant.
| SomeClass *instance = 0;
Const Correctness
-----------------
Try to keep your code const correct. Declare methods const if they don't mutate the object,
and use const variables. It improves safety, and also makes it easier to understand the code.
See: http://www.parashift.com/c++-faq-lite/const-correctness.html
Example:
| bool
| MyClass::isValidFile( const QString& path ) const
| {
| const bool valid = QFile::exist( path );
|
| return valid;
| }
Debugging
---------
debug.h contains some handy functions for our debug console output.
Please use them instead of kdDebug().
Usage:
| #include "debug.h"
|
| debug() << "Something is happening" << endl;
| warning() << "Something bad may happen" << endl;
| error() << "Something bad did happen!" << endl;
Additionally, there are some macros for debugging functions:
DEBUG_BLOCK
DEBUG_FUNC_INFO
DEBUG_LINE_INFO
DEBUG_INDENT
DEBUG_UNINDENT
AMAROK_NOTIMPLEMENTED
AMAROK_DEPRECATED
threadweaver.h has two additional macros:
DEBUG_THREAD_FUNC_INFO outputs the memory address of the current QThread or 'none'
if its the original GUI thread.
SHOULD_BE_GUI outputs a warning message if it occurs in a thread that isn't in
the original "GUI Thread", otherwise it is silent. Useful for documenting
functions and to prevent problems in the future.
Usage of Amarok::config()
-------------------------
We provide this method for convenience, but it is important to use it properly. By
inspection, we can see that we may produce very obscure bugs in the wrong case:
| KConfig
| *config( const QString &group )
| {
| //Slightly more useful config() that allows setting the group simultaneously
| kapp->config()->setGroup( group );
| return kapp->config();
| }
Take the following example:
| void
| f1()
| {
| KConfig *config = Amarok::config( "Group 2" );
| config->writeEntry( "Group 2 Variable", true );
| }
|
| void
| doStuff()
| {
| KConfig *config = Amarok::config( "Group 1" );
| f1();
| config->writeEntry( "Group 1 Variable", true );
| }
We would expect the following results:
| [Group 1]
| Group 1 Variable = true
|
| [Group 2]
| Group 2 Variable = true
However because the config group is changed before writing the entry:
| [Group 1]
|
| [Group 2]
| Group 1 Variable = true
| Group 2 Variable = true
Which is clearly incorrect. And hard to see when your wondering why f1() is not
working. So do not store a value of Amarok::config, make it a habit to just
always call writeEntry or readEntry directly.
Correct:
| amarok::config( "Group 1" )->writeEntry( "Group 1 Variable", true );
Errors & Asserts
----------------
*Never use assert() or fatal(). There must be a better option than crashing a user's
application (its not uncommon for end-users to have debugging enabled).
*KMessageBox is fine to use to prompt the user, but do not use it to display errors
or informational messages. Instead, KDE::StatusBar has a few handy methods. Refer to
amarok/src/statusbar/statusBarBase.h
Copyright
---------
To comply with the GPL, add your name, email address & the year to the top of any file
that you edit. If you bring in code or files from elsewhere, make sure its
GPL-compatible and to put the authors name, email & copyright year to the top of
those files.
Thanks, now have fun!
-- the Amarok developers

@ -0,0 +1,17 @@
SUBDIRS = \
src
EXTRA_DIST = \
AUTHORS \
COPYING \
ChangeLog \
INSTALL \
README \
TODO \
admin \
amarok.kdevprj \
amarok.lsm
AUTOMAKE_OPTIONS = \
foreign

@ -0,0 +1,163 @@
amaroK VIS_PLAN - Created: 22-11-2003
Abstract
========
In order to create a visualisation framework that is superior to anything
popular available for Linux today we should plan amaroK's thoroughly
before implementation. This document exists to map out our ideas and is
available for anyone to edit, please, if you have some good suggestion, or
experience with this kind of work, add some comments! Thanks, Max Howell
Formatting
==========
The document has no regimented formatting, but do try to keep the wordwrap set
the same! Feel free to recommend formatting if the document becomes
unmanageable.
Plan
====
My initial thoughts were to make visualisations a separate process rather than
separate thread. The reasoning being, a crash in the vis won't crash amaroK,
threads can be unmanageable, *nix is good for new processes, we can use DCOP to
control the vis and presumable we just need to pass a handle to the relevant
arts server to the vis and leave it. Since the music playing bit is already a
separate process it makes sense to make the visualisation separate too! Also
this may mean that these visuals could be separate from amaroK and just depend
on KDE.
I was also thinking that this means it may be possible to not use Qt to
do rendering. There are probably better libraries for high speed graphics and if
there isn't a way to make DCOP not depend on a QApplication, then maybe we could
write something. It would be sorted if we could make something that can react to
arts sound output in general.
<markey> we could use SDL for 2d and OpenGL for 3d rendering.
I was also thinking it would be neat to embed the visuals somehow into amaroK,
so as the background in the playlist perhaps (I know, this would probably not
work well due to the need to re-render all the AA text all the time, but still
the idea is neat) This is similar to Sonique on Windows if anyone has ever used
it.
If we make the visualisations not amaroK specific it may be possible to embed
visualisations into the Kicker, onto the desktop, etc.
Do we want more than an FFT of the audio data? Would other data
be useful to visuals at all? Beat detection certainly would be a useful thing to
offer the visualisations, and it would certainly stop every visual implementing
its own detection.
Vis Process Architecture
========================
I suggest having a separate process for each visualization. Each vis process would
only load one visualization plugin. This way we have good crash safety and it's also
possible to develop and ship plugins separately from amaroK. So we have one "vis loader
skeleton" in amaroK, which will be instanciated whenever we need a vis. This loader could
get started with the vis plugin as cli argument. It would also contain all the socket and
interface needed to communicate with amaroK.
We should take care to keep the design as simple as possible.
<mxcl> Why make visualisations plugins as well as binaries? It seems sensible to have
visualisations as separate processes and then communicate with amK through the socket.
Why have the extra layer of plugins if you're going to force each process to only load
one plugin anyway?
Merging Analyzer and Vis
========================
If we decide on unifying vis and analyzer, the question arises how to get the rendered
bitmap graphic back into amaroK's playerwidget. It seems we have the following options:
* Writing it into a shared memory buffer. amaroK must then read the buffer and bitBlt()
the pixmap into the framebuffer
* Transferring the pixmap over a Unix socket (or UDP network socket). This can amount to
several megabytes per second. After the transfer amaroK must bitBlt() it to the
framebuffer.
* Writing it directly into the framebuffer at the desired position, like a video overlay.
There might be technical problems doing so, and it will be difficult when the user
moves the window.
[Comment from muesli, to be integrated into the paragraphs above]
imho, it would be cool to offer this service via sockets. udp would fit per-
fectly, since it has to be realtime, anyways (better loose a packet and show
nothing, instead of a out-of-sync beat). e.g., you would be able to have
various of visualizations-clients connected to amarok, showing different
animations, at the same time. this would also remove the DCOP-dependency-chains
for the OpenGL clients.
right now, i can imagine two implementation methods:
A) transmit the frequency vector of the analyzer to the vis-client. beat-detection and
all that stuff gets done by the vis-client.
B) basic beat-detection and music analysis gets done by amarok itself. the
results of that process are sent to the vis-clients.
<mxcl> IMO it would be good to offer services like beat detection. This
way vis-writers have less to do and are more likely to write a vis since
beat-detection is already done, also it means beat-detection is likely to be better
as we will over time offer a really good implementation, and it means that if the user
has many visuals running, the beat-detection is only done once for all visualisations.
[/Comment by muesli]
//FIXME <markey> beat detection code temporarily moved here
/*
// Muesli's Beat Detection - A Night's Oddysee
// shift old elements
for ( uint x = 0; x < 18; ++x )
for ( uint y = 42; y > 0; --y ) m_beatEnergy[x][y] = m_beatEnergy[x][y - 1];
// get current energy values
for ( uint x = 0; x < pScopeVector->size(); ++x ) m_beatEnergy[x][0] = pScopeVector->at(x);
// compare to old elements and get averages
double beatAvg[18];
// double beatVariance[18];
// double beatMood[18];
for ( uint x = 0; x < 18; ++x )
{
beatAvg[x] = 0;
for ( uint y = 1; y < 44; ++y ) beatAvg[x] += m_beatEnergy[x][y];
beatAvg[x] = beatAvg[x] / 43;
}
*/
/* for ( uint x = 0; x < 18; ++x )
{
beatVariance[x] = 0;
for ( uint y = 0; y < 42; ++y ) beatVariance[x] += (pow((m_beatEnergy[x][y] - beatAvg[x]), 2) / 43);
}
for ( uint x = 0; x < 18; ++x )
beatMood[x] = (-0.0025714 * beatVariance[x]) + 1.5142857;
*/
// do we have a beat? let's dance!
/* int total_hits = 0;
for ( uint x = 0; x < 18; ++x )
{
double factor = cos( x * 4 ) * 18;
factor = beatAvg[x] * factor;
if ( m_beatEnergy[x][0] > factor )
{
total_hits++;
kdDebug() << "*CLAP* factor: " << factor << " - x: " << x << " - average energy: " << beatAvg[x] << " - current peak: " << m_beatEnergy[x][0] << endl;
}
}
if ( total_hits > 3 ) kdDebug() << "***CLAPCLAPCLAP***" << endl;
*/

@ -0,0 +1,239 @@
<!DOCTYPE kdevelop>
<kdevelop>
<general>
<author>Mark Kretschmann</author>
<email>markey@web.de</email>
<projectmanagement>KDevKDEAutoProject</projectmanagement>
<primarylanguage>C++</primarylanguage>
<keywords>
<keyword>KDE</keyword>
<keyword>Qt</keyword>
</keywords>
<projectdirectory>.</projectdirectory>
<absoluteprojectpath>false</absoluteprojectpath>
<version/>
<description/>
<ignoreparts/>
<secondaryLanguages/>
<defaultencoding/>
<projectname>amarok</projectname>
</general>
<kdevautoproject>
<general>
<mainprogram>amarok</mainprogram>
<useconfiguration>default</useconfiguration>
<activetarget>src/magnatunebrowser/libmagnatunebrowser.la</activetarget>
<useactivetarget>true</useactivetarget>
</general>
<configure>
<configargs>\s--build=i386-linux --host=i386-linux --target=i386-linux\s</configargs>
</configure>
<make>
<abortonerror>false</abortonerror>
<numberofjobs>1</numberofjobs>
<dontact>false</dontact>
<makebin>unsermake</makebin>
<envvars>
<envvar value="1" name="WANT_AUTOCONF_2_5" />
<envvar value="1" name="WANT_AUTOMAKE_1_6" />
</envvars>
<prio>0</prio>
<runmultiplejobs>false</runmultiplejobs>
</make>
<compiler>
<cflags/>
<cxxflags>\s-O0 -g3 -Wall</cxxflags>
</compiler>
<run>
<mainprogram/>
<programargs/>
<terminal>false</terminal>
<autocompile>false</autocompile>
<envvars/>
<directoryradio>build</directoryradio>
<customdirectory>/usr/kde/cvs/bin/</customdirectory>
<runarguments>
<amarok/>
</runarguments>
</run>
<configurations>
<default>
<configargs>--enable-debug=full</configargs>
<builddir/>
<topsourcedir/>
<cppflags/>
<ldflags/>
<ccompiler>kdevgccoptions</ccompiler>
<cxxcompiler>kdevgppoptions</cxxcompiler>
<f77compiler>kdevpgf77options</f77compiler>
<ccompilerbinary/>
<cxxcompilerbinary/>
<f77compilerbinary/>
<cflags/>
<cxxflags/>
<f77flags/>
<envvars/>
</default>
</configurations>
<subclassing>
<subclass uifile="/src/magnatunebrowser/magnatuneredownloaddialogbase.ui" sourcefile="/src/magnatunebrowser/magnatuneredownloaddialog.h" />
</subclassing>
</kdevautoproject>
<kdevfileview>
<groups>
<group pattern="*.h,*.hh,*.hxx,*.hpp,*.H" name="Headers" />
<group pattern="*.cpp,*.c,*.cc,*.C,*.cxx,*.ec,*.ecpp,*.lxx,*.l++,*.ll,*.l" name="Sources" />
<group pattern="*.kdevdlg,*.ui,*.rc,*.dlg" name="User Interface" />
<group pattern="*.po" name="Translations" />
<group pattern="AUTHORS,COPYING,ChangeLog,INSTALL,README,TODO,NEWS" name="GNU" />
<group pattern="*" name="Others" />
<hidenonprojectfiles>false</hidenonprojectfiles>
<hidenonlocation>false</hidenonlocation>
</groups>
<tree>
<hidenonprojectfiles>false</hidenonprojectfiles>
<hidepatterns>*.o,*.lo,CVS</hidepatterns>
<showvcsfields>true</showvcsfields>
</tree>
</kdevfileview>
<kdevdoctreeview>
<ignoretocs>
<toc>gtk</toc>
<toc>gnustep</toc>
<toc>python</toc>
<toc>php</toc>
<toc>perl</toc>
</ignoretocs>
<projectdoc>
<userdocDir>/home/mark/mysource/gideon/amarok-0.5.2-gideon/html/</userdocDir>
<apidocDir>/home/mark/mysource/gideon/amarok-0.5.2-gideon/html/</apidocDir>
</projectdoc>
<ignoreqt_xml/>
<ignoredoxygen/>
<ignorekdocs/>
<ignoredevhelp/>
</kdevdoctreeview>
<kdevdebugger>
<general>
<dbgshell>/usr/bin/libtool</dbgshell>
<programargs/>
<gdbpath/>
<breakonloadinglibs>true</breakonloadinglibs>
<separatetty>false</separatetty>
<floatingtoolbar>false</floatingtoolbar>
<runappinappdirectory>true</runappinappdirectory>
<configGdbScript/>
<runShellScript/>
<runGdbScript/>
</general>
<display>
<staticmembers>false</staticmembers>
<demanglenames>true</demanglenames>
<outputradix>10</outputradix>
</display>
</kdevdebugger>
<kdevfilecreate>
<filetypes/>
<useglobaltypes/>
</kdevfilecreate>
<cppsupportpart>
<filetemplates>
<choosefiles>false</choosefiles>
<interfaceURL/>
<implementationURL/>
<interfacesuffix>.h</interfacesuffix>
<implementationsuffix>.cpp</implementationsuffix>
<lowercasefilenames>true</lowercasefilenames>
</filetemplates>
</cppsupportpart>
<kdevcppsupport>
<codecompletion>
<includeGlobalFunctions>true</includeGlobalFunctions>
<includeTypes>true</includeTypes>
<includeEnums>true</includeEnums>
<includeTypedefs>false</includeTypedefs>
<automaticCodeCompletion>true</automaticCodeCompletion>
<automaticArgumentsHint>true</automaticArgumentsHint>
<codeCompletionDelay>100</codeCompletionDelay>
<argumentsHintDelay>100</argumentsHintDelay>
<automaticHeaderCompletion>true</automaticHeaderCompletion>
<headerCompletionDelay>250</headerCompletionDelay>
<showOnlyAccessibleItems>false</showOnlyAccessibleItems>
<completionBoxItemOrder>0</completionBoxItemOrder>
<howEvaluationContextMenu>true</howEvaluationContextMenu>
<showCommentWithArgumentHint>true</showCommentWithArgumentHint>
<statusBarTypeEvaluation>false</statusBarTypeEvaluation>
<namespaceAliases>std=_GLIBCXX_STD;__gnu_cxx=std</namespaceAliases>
<processPrimaryTypes>true</processPrimaryTypes>
<processFunctionArguments>false</processFunctionArguments>
<preProcessAllHeaders>false</preProcessAllHeaders>
<parseMissingHeaders>false</parseMissingHeaders>
<resolveIncludePaths>true</resolveIncludePaths>
<alwaysParseInBackground>true</alwaysParseInBackground>
<usePermanentCaching>true</usePermanentCaching>
<alwaysIncludeNamespaces>false</alwaysIncludeNamespaces>
<includePaths>.;</includePaths>
</codecompletion>
<references/>
<creategettersetter>
<prefixGet/>
<prefixSet>set</prefixSet>
<prefixVariable>m_,_</prefixVariable>
<parameterName>theValue</parameterName>
<inlineGet>true</inlineGet>
<inlineSet>true</inlineSet>
</creategettersetter>
<qt>
<used>true</used>
<version>3</version>
<root>/usr/qt/3</root>
<includestyle>3</includestyle>
<designerintegration>EmbeddedKDevDesigner</designerintegration>
<qmake>/usr/qt/3/bin/qmake</qmake>
<designer>/usr/qt/3/bin/designer</designer>
<designerpluginpaths/>
</qt>
<splitheadersource>
<enabled>false</enabled>
<synchronize>true</synchronize>
<orientation>Vertical</orientation>
</splitheadersource>
<designerintegration>
<qtdesigner/>
</designerintegration>
</kdevcppsupport>
<kdevclassview>
<folderhierarchy>true</folderhierarchy>
<depthoffolders>2</depthoffolders>
</kdevclassview>
<kdevcvs>
<cvsoptions>-f</cvsoptions>
<commitoptions/>
<addoptions/>
<logoptions/>
<updateoptions>-dP</updateoptions>
<removeoptions>-f</removeoptions>
<revertoptions>-C -d -P</revertoptions>
<diffoptions>-u3 -p</diffoptions>
<rshoptions/>
</kdevcvs>
<kdevcvsservice>
<recursivewhenupdate>true</recursivewhenupdate>
<prunedirswhenupdate>true</prunedirswhenupdate>
<createdirswhenupdate>true</createdirswhenupdate>
<recursivewhencommitremove>true</recursivewhencommitremove>
<revertoptions>-C</revertoptions>
</kdevcvsservice>
<kdevdocumentation>
<projectdoc>
<docsystem/>
<docurl/>
<usermanualurl/>
</projectdoc>
</kdevdocumentation>
<ctagspart>
<customArguments/>
<customTagfilePath>/home/ian/workspace/local/amarok/tags</customTagfilePath>
<activeTagsFiles/>
</ctagspart>
</kdevelop>

@ -0,0 +1,336 @@
# configure.in.bot
# This file is used for printing important messages at the end of configure
echo ""
if test x$amarok_error_notaglib = xyes; then
echo " ========================"
echo " === Amarok - ERROR =========================================================="
echo " ========================"
echo " ="
echo " = Amarok cannot be built because, either the TagLib library is not installed,"
echo " = or if relevant, the taglib-devel package is not installed."
echo " = TagLib can be obtained from: http://ktown.kde.org/~wheeler/taglib/"
echo " ="
fi
if test x$amarok_error_taglibold = xyes; then
echo " ========================"
echo " === Amarok - ERROR =========================================================="
echo " ========================"
echo " ="
echo " = Amarok cannot be built because your TagLib version is too old. Please obtain"
echo " = the version $TAGLIB_REQ_VERSION from:"
echo " = http://ktown.kde.org/~wheeler/taglib/"
echo " ="
fi
if test x$amarok_error_noruby = xyes; then
echo " =========================="
echo " === Amarok - ERROR =========================================================="
echo " =========================="
echo " ="
echo " = The Ruby programming language is not installed. Please obtain Ruby"
echo " = (version 1.8 or later) from http://ruby-lang.org, or install a distribution"
echo " = package. To build Amarok requires the Ruby header files as well, which some"
echo " = distributions package separately."
echo " ="
fi
if test x$amarok_warning_xineold = xyes; then
echo " =========================="
echo " === Amarok - WARNING ========================================================"
echo " =========================="
echo " ="
echo " = Amarok requires xine-lib version: 1.0-rc4"
echo " = Amarok will still be built, but you must use another sound-engine."
echo " ="
fi
if test x$PKGCONFIGFOUND != xyes; then
echo " =========================="
echo " === Amarok - WARNING ========================================================"
echo " =========================="
echo " ="
echo " = pkg-config could not be found, this means some optional components (eg the"
echo " = GStreamer-engine) cannot be built."
echo " = See README for help with this issue."
echo " ="
fi
#if test x$amarok_warning_mas_notfound = xyes; then
# echo " =========================="
# echo " === Amarok - WARNING ========================================================"
# echo " =========================="
# echo " ="
# echo " = mas-config could not be found, this means that MAS-engine"
# echo " = cannot be built."
# echo " ="
#fi
if test x$build_xine = xno; then
echo " =========================="
echo " === Amarok - WARNING ========================================================"
echo " =========================="
echo " ="
echo " = The recommended xine-engine will not be built. If you want to use the"
echo " = powerful xine multimedia framework with Amarok, please download xine-lib"
echo " = version $xine_version_min or higher from http://xinehq.de/"
echo " ="
fi
if test x$have_gst_plugins = xno -a x$have_gst = xyes; then
echo " =========================="
echo " === Amarok - WARNING ========================================================"
echo " =========================="
echo " ="
echo " = No GStreamer plugins were detected!"
echo " = Without plugins you will not be able to play any media using the"
echo " = GStreamer-engine! You need at least the MP3 plugin and a sink plugin, (eg."
echo " = ALSAsink). Please refer to http://gstreamer.freedesktop.org/"
echo " = NOTE: you will still be able to play media with another engine plugin."
echo " ="
fi
if test x$included_sqlite = xno; then
if test x$have_sqlite = xyes; then
echo " =========================="
echo " === Amarok - WARNING ========================================================"
echo " =========================="
echo " ="
echo " = You have passed the --without-included-sqlite option to configure, which"
echo " = means that SQLite will be dynamically linked instead of statically linked."
echo " = IMPORTANT: you must ensure the libsqlite.so library in your system is"
echo " = threadsafe!!! Amarok will not be stable otherwise."
echo " ="
else
echo " ========================"
echo " === Amarok - ERROR =========================================================="
echo " ========================"
echo " ="
echo " = You have passed the --without-included-sqlite option to configure, but"
echo " = the development files for SQLite could not be found. Please make sure you"
echo " = have the relevant package installed or, even better, use the included"
echo " = sqlite (unless you *really* know what you're doing, of course)."
echo " ="
fi
fi
if test x$amarok_warning_mysql_notfound = xyes; then
echo " =========================="
echo " === Amarok - WARNING ========================================================"
echo " =========================="
echo " ="
echo " = mysql_config could not be found, this means that support for MySql"
echo " = will be disabled."
echo " ="
fi
if test x$amarok_warning_postgresql_notfound = xyes; then
echo " =========================="
echo " === Amarok - WARNING ========================================================"
echo " =========================="
echo " ="
echo " = pg_config could not be found, this means that support for Postgresql"
echo " = will be disabled."
echo " ="
fi
if test x$no_engine = xyes; then
all_tests=bad
echo " =================================="
echo " === AMAROK WILL NOT BE BUILT ================================================"
echo " =================================="
echo " ="
echo " = No suitable multimedia framework was detected. You need to install at least"
echo " = the Xine or Helix framework as detailed in the Amarok README."
echo " ="
fi
if test x$no_amarok = xyes; then
all_tests=bad
echo " =================================="
echo " === AMAROK WILL NOT BE BUILT ================================================"
echo " =================================="
echo " ="
echo " = Some mandatory dependencies are either not installed or not installed"
echo " = correctly. See the Amarok README for help with this issue. Further assistance"
echo " = can be found at http://amarok.kde.org or in amarok on irc.freenode.net."
echo " = You will still be able to build other modules from extragear/multimedia."
echo " ="
else
echo " =========================="
echo " === Amarok - PLUGINS ========================================================"
echo " =========================="
echo " ="
echo " = The following extra functionality will NOT be included:"
# if test x$build_akode != xyes; then
# echo " = - aKode-engine"
# fi
# if test x$have_gst10 != xyes; then
# echo " = - GStreamer0.10-engine"
# fi
if test x$build_xine != xyes; then
echo " = - xine-engine"
fi
if test x$build_nmm != xyes; then
echo " = - NMM-engine"
fi
# if test x$build_mas != xyes; then
# echo " = - MAS-engine"
# fi
if test x$build_helix = xno; then
echo " = - Helix-engine"
fi
if test x$build_yauap = xno; then
echo " = - yauap-engine"
fi
if test x$build_libvisual != xyes; then
echo " = - libvisual Support"
fi
if test x$enable_mysql != xyes; then
echo " = - MySql Support"
fi
if test x$enable_postgresql != xyes; then
echo " = - Postgresql Support"
fi
if test x$have_konqsidebar != xyes; then
echo " = - Konqueror Sidebar"
fi
if test x$have_tunepimp != xyes; then
echo " = - MusicBrainz Support"
fi
if test x$have_mp4v2 != xyes; then
echo " = - MP4/AAC Tag Write Support"
fi
if test x$have_libgpod != xyes; then
if test x$have_libgpod_042 != xno; then
echo " = - iPod Support"
else
echo " = - iPod Support (at least libgpod 0.4.2 is required)"
fi
fi
if test x$have_ifp != xyes; then
echo " = - iRiver iFP Support"
fi
if test x$have_libnjb != xyes; then
echo " = - Creative Nomad Jukebox Support"
fi
if test x$have_libmtp != xyes; then
echo " = - MTP Device Support"
fi
if test x$have_libkarma != xyes; then
echo " = - Rio Karma Support"
fi
if test x$have_daap != xyes; then
echo " = - DAAP Music Sharing Support"
fi
echo " ="
echo " = The following extra functionality will be included:"
# if test x$build_akode = xyes; then
# echo " = + aKode-engine"
# fi
# if test x$have_gst10 = xyes; then
# echo " = + GStreamer0.10-engine"
# fi
if test x$build_xine = xyes; then
echo " = + xine-engine"
fi
if test x$build_nmm = xyes; then
echo " = + NMM-engine"
fi
# if test x$build_mas = xyes; then
# echo " = + MAS-engine"
# fi
if test x$build_helix != xno; then
echo " = + Helix-engine"
fi
if test x$build_yauap != xno; then
echo " = + yauap-engine"
fi
if test x$build_libvisual = xyes; then
echo " = + libvisual Support"
fi
if test x$enable_mysql = xyes; then
echo " = + MySql Support"
fi
if test x$enable_postgresql = xyes; then
echo " = + Postgresql Support"
fi
if test x$have_konqsidebar = xyes; then
echo " = + Konqueror Sidebar"
fi
if test x$have_tunepimp = xyes; then
echo " = + MusicBrainz Support"
fi
if test x$have_mp4v2 = xyes; then
echo " = + MP4/AAC Tag Write Support"
fi
if test x$have_libgpod = xyes; then
echo " = + iPod Support"
fi
if test x$have_ifp = xyes; then
echo " = + iRiver iFP Support"
fi
if test x$have_libnjb = xyes; then
echo " = + Creative Nomad Jukebox Support"
fi
if test x$have_libmtp = xyes; then
echo " = + MTP Device Support"
fi
if test x$have_libkarma = xyes; then
echo " = + Rio Karma Support"
fi
if test x$have_daap = xyes; then
echo " = + DAAP Music Sharing Support"
fi
echo " ="
fi
echo " ==============================================================================="

File diff suppressed because it is too large Load Diff

@ -0,0 +1,810 @@
<?xml version="1.0" encoding="UTF-8"?>
<XMI xmlns:UML="http://schema.omg.org/spec/UML/1.3" verified="false" timestamp="2007-01-21T11:38:24" xmi.version="1.2" >
<XMI.header>
<XMI.documentation>
<XMI.exporter>umbrello uml modeller http://uml.sf.net</XMI.exporter>
<XMI.exporterVersion>1.5.5</XMI.exporterVersion>
<XMI.exporterEncoding>UnicodeUTF8</XMI.exporterEncoding>
</XMI.documentation>
<XMI.metamodel xmi.name="UML" href="UML.xml" xmi.version="1.3" />
</XMI.header>
<XMI.content>
<UML:Model isSpecification="false" isLeaf="false" isRoot="false" xmi.id="m1" isAbstract="false" name="UML Model" >
<UML:Namespace.ownedElement>
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="2" isRoot="false" isAbstract="false" name="folder" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="2" isRoot="false" isAbstract="false" name="folder" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4394" isRoot="false" isAbstract="false" name="datatype" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4405" isRoot="false" isAbstract="false" name="constructor" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4406" isRoot="false" isAbstract="false" name="friend" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4407" isRoot="false" isAbstract="false" name="virtual" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4410" isRoot="false" isAbstract="false" name="interface" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="2" isRoot="false" isAbstract="false" name="folder" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4394" isRoot="false" isAbstract="false" name="datatype" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4405" isRoot="false" isAbstract="false" name="constructor" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4406" isRoot="false" isAbstract="false" name="friend" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4407" isRoot="false" isAbstract="false" name="virtual" />
<UML:Stereotype isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4410" isRoot="false" isAbstract="false" name="interface" />
<UML:Model stereotype="2" isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="1" isRoot="false" isAbstract="false" name="Logical View" >
<UML:Namespace.ownedElement>
<UML:Package stereotype="2" isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="8" isRoot="false" isAbstract="false" name="Datatypes" >
<UML:Namespace.ownedElement>
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4393" isRoot="false" isAbstract="false" name="int" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4395" isRoot="false" isAbstract="false" name="char" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4396" isRoot="false" isAbstract="false" name="bool" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4397" isRoot="false" isAbstract="false" name="float" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4398" isRoot="false" isAbstract="false" name="double" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4399" isRoot="false" isAbstract="false" name="short" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4400" isRoot="false" isAbstract="false" name="long" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4401" isRoot="false" isAbstract="false" name="unsigned int" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4402" isRoot="false" isAbstract="false" name="unsigned short" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4403" isRoot="false" isAbstract="false" name="unsigned long" />
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="8" xmi.id="4404" isRoot="false" isAbstract="false" name="string" />
</UML:Namespace.ownedElement>
</UML:Package>
<UML:Class comment="This singleton is the " isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="4408" isRoot="false" isAbstract="false" name="CollectionManager" >
<UML:Classifier.feature>
<UML:Operation comment="factory method for this singleton." isSpecification="false" isLeaf="false" visibility="public" xmi.id="9274" isRoot="false" isAbstract="false" isQuery="false" name="instance" ownerScope="classifier" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14465" type="4408" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="private" xmi.id="12814" isRoot="false" isAbstract="false" isQuery="false" name="CollectionManager" />
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4458" isRoot="false" isAbstract="false" isQuery="false" name="queryBuilder" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14466" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="6143" isRoot="false" isAbstract="false" isQuery="false" name="startFullScan" />
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="6395" isRoot="false" isAbstract="false" isQuery="false" name="collectionLocations" />
</UML:Classifier.feature>
</UML:Class>
<UML:Interface stereotype="4410" comment="Abstract base class for QueryBuilder implementations. All implementations must return this when the return type is QueryBuilder to allow method chaining." isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="4409" isRoot="false" isAbstract="true" name="QueryBuilder" >
<UML:Classifier.feature>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4714" isRoot="false" isAbstract="true" isQuery="false" name="signalNewResultReady" >
<UML:BehavioralFeature.parameter>
<UML:Parameter comment="Identifies the collection which returned the new results. QString is just a placeholder" isSpecification="false" visibility="private" xmi.id="4739" value="" type="4736" name="collectionId" />
<UML:Parameter comment="the songs which were found by the collection for the given query. The calling function takes ownership of the objects." isSpecification="false" visibility="private" xmi.id="4745" value="" type="4742" name="songs" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="13516" isRoot="false" isAbstract="true" isQuery="false" name="signalNewResultReady" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="13517" value="" type="4736" name="collectionId" />
<UML:Parameter isSpecification="false" visibility="private" xmi.id="13601" value="" type="13559" name="albums" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="13348" isRoot="false" isAbstract="true" isQuery="false" name="signalNewResultReady" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="13349" value="" type="4736" name="collectionId" />
<UML:Parameter isSpecification="false" visibility="private" xmi.id="13433" value="" type="13391" name="artists" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4750" isRoot="false" isAbstract="true" isQuery="false" name="signalNewResultReady" >
<UML:BehavioralFeature.parameter>
<UML:Parameter comment="identifies the collection which returned this result. The type is just a placeholder, there are probably better choices than a QString" isSpecification="false" visibility="private" xmi.id="4751" value="" type="4736" name="collectionId" />
<UML:Parameter comment="The result of the given query." isSpecification="false" visibility="private" xmi.id="4757" value="" type="4754" name="result" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="start the defined query. this method will not block but return immediately." isSpecification="false" isLeaf="false" visibility="public" xmi.id="4724" isRoot="false" isAbstract="true" isQuery="false" name="run" />
<UML:Operation comment="This method starts a song query. A song query will return Song objects and does not allow you to add additional return values by calling addReturnValue()" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4762" isRoot="false" isAbstract="true" isQuery="false" name="startSongQuery()" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14467" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="13726" isRoot="false" isAbstract="true" isQuery="false" name="startAlbumQuery" />
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="13684" isRoot="false" isAbstract="true" isQuery="false" name="startArtistQuery" />
<UML:Operation comment="starts a custom query. A custom query allows the client code define the needed return values by calling addReturnValue(). Do not use this method if you want songs, use startSongQuery() instead." isSpecification="false" isLeaf="false" visibility="public" xmi.id="4765" isRoot="false" isAbstract="true" isQuery="false" name="startCustomQuery" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14468" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="resets the query represented by the QueryBuilder. After calling this method the state of the QueryBuilder instance is equal to a new one created by calling CollectionManager's queryBuilder() method." isSpecification="false" isLeaf="false" visibility="public" xmi.id="4768" isRoot="false" isAbstract="true" isQuery="false" name="reset()" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14469" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="adds a filter to the query.
TODO: add parameters" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4771" isRoot="false" isAbstract="true" isQuery="false" name="addFilter" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14470" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="define the sort order of the returned result.
TODO: add parameters" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4774" isRoot="false" isAbstract="true" isQuery="false" name="orderBy" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14471" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="aborts a running query. Calling this method has no effect if query wasnt run yet or the QueryBuilder already returned the results for the query. The QueryBuilder instance will try to exit as soon as possible after calling this method." isSpecification="false" isLeaf="false" visibility="public" xmi.id="4792" isRoot="false" isAbstract="true" isQuery="false" name="abortQuery" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14472" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="adds a return value to the query. NOTE: calls to this method are ignored if you started a song query by calling startSongQuery()" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4809" isRoot="false" isAbstract="true" isQuery="false" name="addReturnValue" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14473" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="This signal is emitted when the query completed and no additional signalNewResultReady() signals will be emitted." isSpecification="false" isLeaf="false" visibility="public" xmi.id="8743" isRoot="false" isAbstract="true" isQuery="false" name="signalQueryDone" />
<UML:Operation comment="include the collection identified by the collection id in this query. By default, all collections are queried. After this calling this method once, all collections which are not explicitly included are not queried." isSpecification="false" isLeaf="false" visibility="public" xmi.id="9377" isRoot="false" isAbstract="true" isQuery="false" name="includeCollection" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14474" type="4409" />
<UML:Parameter isSpecification="false" visibility="private" xmi.id="9378" value="" type="4736" name="collectionId" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="exclude the collection identified by its collection id from this query." isSpecification="false" isLeaf="false" visibility="public" xmi.id="9448" isRoot="false" isAbstract="true" isQuery="false" name="excludeCollection" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14475" type="4409" />
<UML:Parameter isSpecification="false" visibility="private" xmi.id="9449" value="" type="4736" name="collectionId" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
</UML:Classifier.feature>
</UML:Interface>
<UML:Class comment="This class encapsulates multiple QueryBuilder and simply forwards most method calls to each of them. A notable exception is the run() method (or maybe query() method, i'm not sure if it shouldn't be renamed).
In this method the class will query all internal QueryBuilders in parallel. It will emit the signal signalNewResultReady() as soon as an internal QueryBuilder delivers its result. Depending on whether the client code started a song query or a custom query it will emit signalNewResultReady(QString, QPtrList&lt;Song>) or signalNewResultReady(QString, QStringList)." isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4411" isRoot="false" isAbstract="false" name="MetaQueryBuilder" >
<UML:Classifier.feature>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4719" isRoot="false" isAbstract="false" isQuery="false" name="slotNewResultReady" />
</UML:Classifier.feature>
</UML:Class>
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4412" isRoot="false" isAbstract="false" name="LocalQueryBuilder" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4413" isRoot="false" isAbstract="false" name="DaapQueryBuilder" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4414" isRoot="false" isAbstract="false" name="AmpacheQueryBuilder" />
<UML:Interface stereotype="4410" isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4434" isRoot="false" isAbstract="true" name="Collection" >
<UML:Classifier.feature>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4447" isRoot="false" isAbstract="true" isQuery="false" name="queryBuilder" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14476" type="4409" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="6244" isRoot="false" isAbstract="true" isQuery="false" name="startFullScan" />
<UML:Operation comment="get writable collection locations. Collection which are not writable should return a list with length 0." isSpecification="false" isLeaf="false" visibility="public" xmi.id="6446" isRoot="false" isAbstract="true" isQuery="false" name="collectionLocations" />
<UML:Operation comment="returns the collection id.
TODO: think of a better type for the collection id." isSpecification="false" isLeaf="false" visibility="public" xmi.id="9809" isRoot="false" isAbstract="true" isQuery="true" name="collectionId" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14477" type="4736" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="returns a displayble name for this collection, e.g. &quot;Your collection&quot; or &quot;Your Ipod&quot;." isSpecification="false" isLeaf="false" visibility="public" xmi.id="9847" isRoot="false" isAbstract="true" isQuery="true" name="prettyName" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14478" type="4736" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
</UML:Classifier.feature>
</UML:Interface>
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4435" isRoot="false" isAbstract="false" name="LocalCollection" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4436" isRoot="false" isAbstract="false" name="DaapCollection" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4437" isRoot="false" isAbstract="false" name="AmpacheCollection" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4606" isRoot="false" isAbstract="false" name="Amarok" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4648" isRoot="false" isAbstract="false" name="IpodCollection" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4651" isRoot="false" isAbstract="false" name="IpodQueryBuilder" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4736" isRoot="false" isAbstract="false" name="QString" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4742" isRoot="false" isAbstract="false" name="QPtrList&lt;Song>" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4754" isRoot="false" isAbstract="false" name="QStringList" />
<UML:Interface stereotype="4410" isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="4892" isRoot="false" isAbstract="true" name="Song" >
<UML:Classifier.feature>
<UML:Operation comment="returns an URL playable by Phonon" isSpecification="false" isLeaf="false" visibility="public" xmi.id="4902" isRoot="false" isAbstract="true" isQuery="false" name="playableUrl" />
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4930" isRoot="false" isAbstract="true" isQuery="true" name="prettyTitle" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14479" type="4736" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4971" isRoot="false" isAbstract="true" isQuery="true" name="prettyUrl" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14480" type="4736" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="4994" isRoot="false" isAbstract="true" isQuery="true" name="title" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14481" type="4736" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="returns true if the collection that this song is stored in supports statistics." isSpecification="false" isLeaf="false" visibility="public" xmi.id="5033" isRoot="false" isAbstract="true" isQuery="true" name="supportsStatistics" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14482" type="4396" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5064" isRoot="false" isAbstract="true" isQuery="false" name="playcount" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14483" type="4393" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5096" isRoot="false" isAbstract="true" isQuery="false" name="rating" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14484" type="4393" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5114" isRoot="false" isAbstract="true" isQuery="false" name="percentage" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14485" type="4397" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5133" isRoot="false" isAbstract="true" isQuery="false" name="setPlaycount" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="5134" value="" type="4393" name="newPlaycount" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="increases the playcount of this song. This is a convience function and equivalent to calling setPlaycount( playcount + delta )" isSpecification="false" isLeaf="false" visibility="public" xmi.id="9041" isRoot="false" isAbstract="true" isQuery="false" name="void increasePlaycount" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="9042" value="" type="4393" name="delta" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5171" isRoot="false" isAbstract="true" isQuery="false" name="setRating" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="5172" value="" type="4393" name="newRating" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5209" isRoot="false" isAbstract="true" isQuery="false" name="setPercentage" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="5210" value="" type="4397" name="newPercentage" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5600" isRoot="false" isAbstract="true" isQuery="false" name="artist" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14486" type="5320" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5623" isRoot="false" isAbstract="true" isQuery="false" name="album" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14487" type="5301" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5715" isRoot="false" isAbstract="true" isQuery="false" name="playable" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14488" type="4396" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5740" isRoot="false" isAbstract="true" isQuery="false" name="supportsTagUpdates" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14489" type="4396" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="returns a TagUpdate instance whichis able to update the tags of the song, if possible. will return 0 if supportsTagUpdates() return false." isSpecification="false" isLeaf="false" visibility="public" xmi.id="12608" isRoot="false" isAbstract="true" isQuery="false" name="tagUpdater" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14490" type="12609" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="update the title of this song. This method will return immediately and will not update the title if supportsTagUpdates() returns false." isSpecification="false" isLeaf="false" visibility="public" xmi.id="5766" isRoot="false" isAbstract="true" isQuery="false" name="setTitle" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="5767" value="" type="4736" name="newTitle" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="find out whether this song is deletable." isSpecification="false" isLeaf="false" visibility="public" xmi.id="6699" isRoot="false" isAbstract="true" isQuery="true" name="deletable" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14491" type="4396" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="Calling this method will remove the song from the underlying collection and from the filesystem. Client code should delete the instance after calling this method.
This method is a NOOP when deletable() returns false" isSpecification="false" isLeaf="false" visibility="public" xmi.id="6726" isRoot="false" isAbstract="true" isQuery="false" name="delete" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14492" type="4396" />
<UML:Parameter comment="if true, the file is not deleted but moved to trash instead. If it is not possible to move it to trash because the underlying storage system does not support it, the file is directly deleted." isSpecification="false" visibility="private" xmi.id="6727" value="true" type="4396" name="moveToTrash" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="8577" isRoot="false" isAbstract="true" isQuery="false" name="trackNumber" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14493" type="4393" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="8610" isRoot="false" isAbstract="true" isQuery="false" name="cdNumber" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14494" type="4393" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="returns true if the collection that this song is stored in supports labels." isSpecification="false" isLeaf="false" visibility="public" xmi.id="5019" isRoot="false" isAbstract="true" isQuery="true" name="supportsLabels" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14495" type="4396" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="get the labels for this song, if any. It will return an empty list if no labels were defined or the collection of this song does not support labels." isSpecification="false" isLeaf="false" visibility="public" xmi.id="5048" isRoot="false" isAbstract="true" isQuery="false" name="labels" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14496" type="4754" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="11560" isRoot="false" isAbstract="true" isQuery="false" name="setLabels" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="11561" value="" type="4754" name="labels" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="11638" isRoot="false" isAbstract="true" isQuery="false" name="removeLabel" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14497" type="4396" />
<UML:Parameter isSpecification="false" visibility="private" xmi.id="11639" value="" type="4736" name="label" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="11717" isRoot="false" isAbstract="true" isQuery="false" name="addLabel" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14498" type="4396" />
<UML:Parameter isSpecification="false" visibility="private" xmi.id="11718" value="" type="4736" name="label" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
</UML:Classifier.feature>
</UML:Interface>
<UML:Interface stereotype="4410" isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="5301" isRoot="false" isAbstract="true" name="Album" >
<UML:Classifier.feature>
<UML:Operation comment="get all the tracks of the album. The tracks will be ordered by ascending CD number first, ascending track number second.
NOTE: what about albums which span multiple collections? We would need an asynchronous method, otherwise this method could block for a long time." isSpecification="false" isLeaf="false" visibility="public" xmi.id="5413" isRoot="false" isAbstract="true" isQuery="false" name="tracks" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14499" type="4742" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5433" isRoot="false" isAbstract="true" isQuery="false" name="albumImage" />
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5453" isRoot="false" isAbstract="true" isQuery="true" name="name" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14500" type="4736" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="8006" isRoot="false" isAbstract="true" isQuery="false" name="setAlbumImage" />
</UML:Classifier.feature>
</UML:Interface>
<UML:Interface stereotype="4410" isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="5320" isRoot="false" isAbstract="true" name="Artist" >
<UML:Classifier.feature>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5339" isRoot="false" isAbstract="true" isQuery="false" name="similarArtists" />
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5358" isRoot="false" isAbstract="true" isQuery="false" name="albums" />
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="5494" isRoot="false" isAbstract="true" isQuery="true" name="name" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14501" type="4736" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="8297" isRoot="false" isAbstract="true" isQuery="false" name="allSongs" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14502" type="4742" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="Get the user's favorite songs from this artist" isSpecification="false" isLeaf="false" visibility="public" xmi.id="8328" isRoot="false" isAbstract="true" isQuery="false" name="favoriteSongs" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14503" type="4742" />
<UML:Parameter comment="The maximum number of favorite songs to return." isSpecification="false" visibility="private" xmi.id="8329" value="" type="4393" name="count" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
</UML:Classifier.feature>
</UML:Interface>
<UML:Interface stereotype="4410" comment="This abstract class encapsulates and extends the collection folders of Amarok 1.x. The idea is to allow the user to move/copy from one collection type to another, e.g. from the local collection to an ipod or from a DAAP share to the local collection or to a media device.
It should be possible to reuse this code when implementing the copy mechanism for the media device browser." isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="7051" isRoot="false" isAbstract="true" name="CollectionLocation" >
<UML:Classifier.feature>
<UML:Operation comment="pretty name of this collection location for display purposes." isSpecification="false" isLeaf="false" visibility="public" xmi.id="7079" isRoot="false" isAbstract="true" isQuery="true" name="prettyName" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14504" type="4736" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation comment="copy a file to a destination in this collection location. Will return true if the file could be copied successfully, false otherwise.
Note: the method will return true even if the original file could not be deleted as long as the file was copied successfully.
Note: implementations are free to ignore the relative path if the underlying collection requires it.
TODO:
figure out how the CollectionLocation can easily access the song. Add a toStream() method to Song???" isSpecification="false" isLeaf="false" visibility="public" xmi.id="7136" isRoot="false" isAbstract="true" isQuery="false" name="copy" >
<UML:BehavioralFeature.parameter>
<UML:Parameter kind="return" xmi.id="14505" type="4396" />
<UML:Parameter comment="the original file to be copied to the new location." isSpecification="false" visibility="private" xmi.id="7137" value="" type="4892" name="originalFile" />
<UML:Parameter comment="The relative path to copy the file to. This includes directories (if any) below the root of the collection location and the full destination filename" isSpecification="false" visibility="private" xmi.id="7166" value="" type="4736" name="relativeDestinationPath" />
<UML:Parameter comment="attempt to delete the original file (thereby implementing a move operation).
Note: the original filename will not be deleted if originalFile->deletable() returns false. The move operation will still succeed though." isSpecification="false" visibility="private" xmi.id="7223" value="false" type="4396" name="deleteOriginal" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
</UML:Classifier.feature>
</UML:Interface>
<UML:Interface stereotype="4410" isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="11878" isRoot="false" isAbstract="true" name="TagUpdater" >
<UML:Classifier.feature>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="11919" isRoot="false" isAbstract="true" isQuery="false" name="setAlbum" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="11920" value="" type="4736" name="album" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="12041" isRoot="false" isAbstract="true" isQuery="false" name="setAlbum" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="12083" value="" type="5301" name="*album" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="12244" isRoot="false" isAbstract="true" isQuery="false" name="setArtist" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="12245" value="" type="4736" name="artist" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
<UML:Operation isSpecification="false" isLeaf="false" visibility="public" xmi.id="12326" isRoot="false" isAbstract="true" isQuery="false" name="setArtist" >
<UML:BehavioralFeature.parameter>
<UML:Parameter isSpecification="false" visibility="private" xmi.id="12327" value="" type="5320" name="*artist" />
</UML:BehavioralFeature.parameter>
</UML:Operation>
</UML:Classifier.feature>
</UML:Interface>
<UML:DataType stereotype="4394" isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="12609" isRoot="false" isAbstract="false" name="TagUpdater*" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="13391" isRoot="false" isAbstract="false" name="QPtrList&lt;Artist>" />
<UML:Class isSpecification="false" isLeaf="false" visibility="public" namespace="1" xmi.id="13559" isRoot="false" isAbstract="false" name="QPtrList&lt;Album>" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4415" client="4412" name="" supplier="4409" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4418" client="4413" name="" supplier="4409" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4421" client="4414" name="" supplier="4409" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4424" client="4411" name="" supplier="4409" />
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4427" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4428" aggregation="composite" type="4411" name="" multiplicity="1" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4429" aggregation="none" type="4409" name="" multiplicity="n" />
</UML:Association.connection>
</UML:Association>
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4438" client="4437" name="" supplier="4434" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4441" client="4436" name="" supplier="4434" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4444" client="4435" name="" supplier="4434" />
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4452" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4453" aggregation="composite" type="4408" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4454" aggregation="none" type="4434" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4513" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4514" aggregation="none" type="4412" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4515" aggregation="none" type="4435" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4520" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4521" aggregation="none" type="4413" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4522" aggregation="none" type="4436" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4527" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4528" aggregation="none" type="4414" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4529" aggregation="none" type="4437" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4540" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4541" aggregation="none" type="4408" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4542" aggregation="none" type="4411" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4609" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4610" aggregation="none" type="4606" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4611" aggregation="none" type="4606" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4618" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4619" aggregation="none" type="4606" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4620" aggregation="none" type="4408" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4625" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4626" aggregation="none" type="4606" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4627" aggregation="none" type="4409" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4654" client="4648" name="" supplier="4434" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4661" client="4651" name="" supplier="4409" />
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4672" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4673" aggregation="none" type="4648" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4674" aggregation="none" type="4651" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4415" client="4412" name="" supplier="4409" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4418" client="4413" name="" supplier="4409" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4421" client="4414" name="" supplier="4409" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4424" client="4411" name="" supplier="4409" />
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4427" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4428" aggregation="composite" type="4411" name="" multiplicity="1" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4429" aggregation="none" type="4409" name="" multiplicity="n" />
</UML:Association.connection>
</UML:Association>
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4438" client="4437" name="" supplier="4434" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4441" client="4436" name="" supplier="4434" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4444" client="4435" name="" supplier="4434" />
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4452" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4453" aggregation="composite" type="4408" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4454" aggregation="none" type="4434" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4513" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4514" aggregation="none" type="4412" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4515" aggregation="none" type="4435" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4520" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4521" aggregation="none" type="4413" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4522" aggregation="none" type="4436" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4527" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4528" aggregation="none" type="4414" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4529" aggregation="none" type="4437" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4540" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4541" aggregation="none" type="4408" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4542" aggregation="none" type="4411" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4609" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4610" aggregation="none" type="4606" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4611" aggregation="none" type="4606" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4618" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4619" aggregation="none" type="4606" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4620" aggregation="none" type="4408" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4625" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4626" aggregation="none" type="4606" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4627" aggregation="none" type="4409" name="" />
</UML:Association.connection>
</UML:Association>
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4654" client="4648" name="" supplier="4434" />
<UML:Abstraction isSpecification="false" visibility="public" namespace="1" xmi.id="4661" client="4651" name="" supplier="4409" />
<UML:Association isSpecification="false" visibility="public" namespace="1" xmi.id="4672" name="" >
<UML:Association.connection>
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4673" aggregation="none" type="4648" name="" />
<UML:AssociationEnd isSpecification="false" visibility="public" changeability="changeable" isNavigable="true" xmi.id="4674" aggregation="none" type="4651" name="" />
</UML:Association.connection>
</UML:Association>
</UML:Namespace.ownedElement>
<XMI.extension xmi.extender="umbrello" >
<diagrams>
<diagram snapgrid="0" showattsig="1" fillcolor="#ffffc0" linewidth="0" zoom="100" showgrid="1" showopsig="1" usefillcolor="1" snapx="10" canvaswidth="1874" snapy="10" showatts="1" xmi.id="4392" documentation="" type="1" showops="1" showpackage="0" name="class diagram" localid="900000" showstereotype="0" showscope="1" snapcsgrid="0" font="Nimbus Sans L,8,-1,5,50,0,0,0,0,0" linecolor="#ff0000" canvasheight="958" >
<widgets>
<classwidget usesdiagramfillcolour="0" width="199" showattsigs="601" usesdiagramusefillcolour="0" x="348" y="450" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="117" usefillcolor="1" showpubliconly="0" showattributes="1" isinstance="0" xmi.id="4408" showoperations="1" showpackage="0" showscope="1" font="Nimbus Sans L,8,-1,5,75,0,0,0,0,0" linecolor="#ff0000" />
<interfacewidget usesdiagramfillcolour="0" width="451" usesdiagramusefillcolour="0" x="819" y="509" drawascircle="0" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="351" usefillcolor="1" showpubliconly="0" isinstance="0" xmi.id="4409" showoperations="1" showpackage="0" showscope="1" showstereotype="1" font="Nimbus Sans L,8,-1,5,75,1,0,0,0,0" linecolor="#ff0000" />
<classwidget usesdiagramfillcolour="0" width="151" showattsigs="601" usesdiagramusefillcolour="0" x="546" y="654" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="45" usefillcolor="1" showpubliconly="0" showattributes="1" isinstance="0" xmi.id="4411" showoperations="1" showpackage="0" showscope="1" font="Nimbus Sans L,8,-1,5,75,0,0,0,0,0" linecolor="#ff0000" />
<classwidget usesdiagramfillcolour="1" width="127" showattsigs="601" usesdiagramusefillcolour="1" x="615" y="829" showopsigs="601" linewidth="none" fillcolour="none" height="36" usefillcolor="1" showpubliconly="0" showattributes="1" isinstance="0" xmi.id="4412" showoperations="1" showpackage="0" showscope="1" font="Nimbus Sans L,8,-1,5,75,0,0,0,0,0" linecolor="none" />
<interfacewidget usesdiagramfillcolour="0" width="192" usesdiagramusefillcolour="0" x="318" y="608" drawascircle="0" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="135" usefillcolor="1" showpubliconly="0" isinstance="0" xmi.id="4434" showoperations="1" showpackage="0" showscope="1" showstereotype="1" font="Nimbus Sans L,8,-1,5,75,1,0,0,0,0" linecolor="#ff0000" />
<classwidget usesdiagramfillcolour="1" width="108" showattsigs="601" usesdiagramusefillcolour="1" x="470" y="829" showopsigs="601" linewidth="none" fillcolour="none" height="36" usefillcolor="1" showpubliconly="0" showattributes="1" isinstance="0" xmi.id="4435" showoperations="1" showpackage="0" showscope="1" font="Nimbus Sans L,8,-1,5,75,0,0,0,0,0" linecolor="none" />
<classwidget usesdiagramfillcolour="1" width="59" showattsigs="601" usesdiagramusefillcolour="1" x="576" y="187" showopsigs="601" linewidth="none" fillcolour="none" height="36" usefillcolor="1" showpubliconly="0" showattributes="1" isinstance="0" xmi.id="4606" showoperations="1" showpackage="0" showscope="1" font="Nimbus Sans L,8,-1,5,75,0,0,0,0,0" linecolor="none" />
<classwidget usesdiagramfillcolour="1" width="102" showattsigs="601" usesdiagramusefillcolour="1" x="330" y="889" showopsigs="601" linewidth="none" fillcolour="none" height="36" usefillcolor="1" showpubliconly="0" showattributes="1" isinstance="0" xmi.id="4648" showoperations="1" showpackage="0" showscope="1" font="Nimbus Sans L,8,-1,5,75,0,0,0,0,0" linecolor="none" />
<classwidget usesdiagramfillcolour="1" width="121" showattsigs="601" usesdiagramusefillcolour="1" x="838" y="888" showopsigs="601" linewidth="none" fillcolour="none" height="36" usefillcolor="1" showpubliconly="0" showattributes="1" isinstance="0" xmi.id="4651" showoperations="1" showpackage="0" showscope="1" font="Nimbus Sans L,8,-1,5,75,0,0,0,0,0" linecolor="none" />
<interfacewidget usesdiagramfillcolour="0" width="258" usesdiagramusefillcolour="0" x="1336" y="153" drawascircle="0" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="531" usefillcolor="1" showpubliconly="0" isinstance="0" xmi.id="4892" showoperations="1" showpackage="0" showscope="1" showstereotype="1" font="Nimbus Sans L,8,-1,5,75,1,0,0,0,0" linecolor="#ff0000" />
<interfacewidget usesdiagramfillcolour="0" width="175" usesdiagramusefillcolour="0" x="1600" y="153" drawascircle="0" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="117" usefillcolor="1" showpubliconly="0" isinstance="0" xmi.id="5301" showoperations="1" showpackage="0" showscope="1" showstereotype="1" font="Nimbus Sans L,8,-1,5,75,1,0,0,0,0" linecolor="#ff0000" />
<interfacewidget usesdiagramfillcolour="0" width="277" usesdiagramusefillcolour="0" x="1055" y="154" drawascircle="0" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="135" usefillcolor="1" showpubliconly="0" isinstance="0" xmi.id="5320" showoperations="1" showpackage="0" showscope="1" showstereotype="1" font="Nimbus Sans L,8,-1,5,75,1,0,0,0,0" linecolor="#ff0000" />
<notewidget usesdiagramfillcolour="1" width="205" usesdiagramusefillcolour="1" x="61" y="170" linewidth="none" fillcolour="none" height="187" usefillcolor="1" isinstance="0" xmi.id="6915" showstereotype="1" text="Note: the interfaces in this diagram should be implemented by abstract base classes in c++. This allows us to add convienence implementations for some methods too." font="Nimbus Sans L,8,-1,5,50,0,0,0,0,0" linecolor="none" />
<interfacewidget usesdiagramfillcolour="0" width="566" usesdiagramusefillcolour="0" x="1304" y="842" drawascircle="0" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="81" usefillcolor="1" showpubliconly="0" isinstance="0" xmi.id="7051" showoperations="1" showpackage="0" showscope="1" showstereotype="1" font="Nimbus Sans L,8,-1,5,75,1,0,0,0,0" linecolor="#ff0000" />
<notewidget usesdiagramfillcolour="1" width="116" usesdiagramusefillcolour="1" x="183" y="861" linewidth="none" fillcolour="none" height="93" usefillcolor="1" isinstance="0" xmi.id="10989" showstereotype="1" text="Not actually required for the initial implementation." font="Nimbus Sans L,8,-1,5,50,0,0,0,0,0" linecolor="none" />
<interfacewidget usesdiagramfillcolour="0" width="179" usesdiagramusefillcolour="0" x="1603" y="410" drawascircle="0" showopsigs="601" linewidth="none" fillcolour="#ffffc0" height="117" usefillcolor="1" showpubliconly="0" isinstance="0" xmi.id="11878" showoperations="1" showpackage="0" showscope="1" showstereotype="1" font="Nimbus Sans L,8,-1,5,75,1,0,0,0,0" linecolor="#ff0000" />
</widgets>
<messages/>
<associations>
<assocwidget totalcounta="2" indexa="1" totalcountb="4" indexb="3" linewidth="none" widgetbid="4409" widgetaid="4412" xmi.id="4415" linecolor="none" >
<linepath>
<startpoint startx="678" starty="829" />
<endpoint endx="819" endy="772" />
</linepath>
</assocwidget>
<assocwidget totalcounta="3" indexa="1" totalcountb="4" indexb="1" linewidth="none" widgetbid="4409" widgetaid="4411" xmi.id="4424" linecolor="none" >
<linepath>
<startpoint startx="697" starty="669" />
<endpoint endx="819" endy="596" />
</linepath>
</assocwidget>
<assocwidget totalcounta="3" indexa="2" totalcountb="4" indexb="2" linewidth="none" widgetbid="4409" widgetaid="4411" xmi.id="4427" linecolor="none" >
<linepath>
<startpoint startx="697" starty="684" />
<endpoint endx="819" endy="684" />
</linepath>
<floatingtext usesdiagramfillcolour="1" width="32" usesdiagramusefillcolour="1" x="712" y="663" linewidth="none" posttext="" role="701" fillcolour="none" height="32" usefillcolor="1" pretext="" isinstance="0" xmi.id="54" text="1" font="Nimbus Sans L,8,-1,5,50,0,0,0,0,0" linecolor="none" />
<floatingtext usesdiagramfillcolour="1" width="32" usesdiagramusefillcolour="1" x="788" y="682" linewidth="none" posttext="" role="702" fillcolour="none" height="32" usefillcolor="1" pretext="" isinstance="0" xmi.id="55" showstereotype="1" text="n" font="Nimbus Sans L,8,-1,5,50,0,0,0,0,0" linecolor="none" />
</assocwidget>
<assocwidget totalcounta="2" indexa="1" totalcountb="3" indexb="2" linewidth="none" widgetbid="4434" widgetaid="4435" xmi.id="4444" linecolor="none" >
<linepath>
<startpoint startx="524" starty="829" />
<endpoint endx="446" endy="743" />
</linepath>
</assocwidget>
<assocwidget totalcounta="3" indexa="1" totalcountb="2" indexb="1" linewidth="none" widgetbid="4434" widgetaid="4408" xmi.id="4452" linecolor="none" >
<linepath>
<startpoint startx="414" starty="567" />
<endpoint endx="414" endy="608" />
</linepath>
</assocwidget>
<assocwidget totalcounta="2" indexa="1" totalcountb="2" indexb="1" linewidth="none" widgetbid="4435" widgetaid="4412" xmi.id="4513" linecolor="none" >
<linepath>
<startpoint startx="615" starty="847" />
<endpoint endx="578" endy="847" />
</linepath>
</assocwidget>
<assocwidget totalcounta="3" indexa="2" totalcountb="2" indexb="1" linewidth="none" widgetbid="4411" widgetaid="4408" xmi.id="4540" linecolor="none" >
<linepath>
<startpoint startx="480" starty="567" />
<endpoint endx="621" endy="654" />
</linepath>
</assocwidget>
<assocwidget totalcounta="3" indexa="1" totalcountb="2" indexb="1" linewidth="none" widgetbid="4408" widgetaid="4606" xmi.id="4618" linecolor="none" >
<linepath>
<startpoint startx="595" starty="223" />
<endpoint endx="447" endy="450" />
</linepath>
</assocwidget>
<assocwidget totalcounta="3" indexa="2" totalcountb="2" indexb="1" linewidth="none" widgetbid="4409" widgetaid="4606" xmi.id="4625" linecolor="none" >
<linepath>
<startpoint startx="615" starty="223" />
<endpoint endx="1044" endy="509" />
</linepath>
</assocwidget>
<assocwidget totalcounta="2" indexa="1" totalcountb="3" indexb="1" linewidth="none" widgetbid="4434" widgetaid="4648" xmi.id="4654" linecolor="none" >
<linepath>
<startpoint startx="381" starty="889" />
<endpoint endx="382" endy="743" />
</linepath>
</assocwidget>
<assocwidget totalcounta="2" indexa="1" totalcountb="2" indexb="1" linewidth="none" widgetbid="4409" widgetaid="4651" xmi.id="4661" linecolor="none" >
<linepath>
<startpoint startx="898" starty="888" />
<endpoint endx="1044" endy="860" />
</linepath>
</assocwidget>
<assocwidget totalcounta="2" indexa="1" totalcountb="2" indexb="1" linewidth="none" widgetbid="4651" widgetaid="4648" xmi.id="4672" linecolor="none" >
<linepath>
<startpoint startx="432" starty="907" />
<endpoint endx="838" endy="906" />
</linepath>
</assocwidget>
<assocwidget totalcounta="2" indexa="1" visibilityB="200" totalcountb="2" indexb="1" linewidth="none" widgetbid="4648" widgetaid="10989" roleBdoc="" documentation="" roleAdoc="" type="513" changeabilityA="900" changeabilityB="900" linecolor="none" visibilityA="200" >
<linepath>
<startpoint startx="299" starty="907" />
<endpoint endx="330" endy="907" />
</linepath>
</assocwidget>
</associations>
</diagram>
</diagrams>
</XMI.extension>
</UML:Model>
<UML:Model stereotype="2" isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="3" isRoot="false" isAbstract="false" name="Use Case View" >
<UML:Namespace.ownedElement/>
</UML:Model>
<UML:Model stereotype="2" isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="4" isRoot="false" isAbstract="false" name="Component View" >
<UML:Namespace.ownedElement/>
</UML:Model>
<UML:Model stereotype="2" isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="5" isRoot="false" isAbstract="false" name="Deployment View" >
<UML:Namespace.ownedElement/>
</UML:Model>
<UML:Model stereotype="2" isSpecification="false" isLeaf="false" visibility="public" namespace="m1" xmi.id="6" isRoot="false" isAbstract="false" name="Entity Relationship Model" >
<UML:Namespace.ownedElement/>
</UML:Model>
</UML:Namespace.ownedElement>
</UML:Model>
</XMI.content>
<XMI.extensions xmi.extender="umbrello" >
<docsettings viewid="4392" documentation="" uniqueid="14505" />
<listview>
<listitem open="1" type="800" label="Views" >
<listitem open="1" type="801" id="1" >
<listitem open="1" type="813" id="4606" />
<listitem open="1" type="813" id="4437" />
<listitem open="1" type="813" id="4414" />
<listitem open="1" type="813" id="4408" >
<listitem open="0" type="815" id="9274" />
<listitem open="0" type="815" id="12814" />
<listitem open="0" type="815" id="4458" />
<listitem open="0" type="815" id="6143" />
<listitem open="0" type="815" id="6395" />
</listitem>
<listitem open="1" type="813" id="4436" />
<listitem open="1" type="813" id="4413" />
<listitem open="1" type="813" id="4648" />
<listitem open="1" type="813" id="4651" />
<listitem open="1" type="813" id="4435" />
<listitem open="1" type="813" id="4412" />
<listitem open="0" type="813" id="4411" >
<listitem open="0" type="815" id="4719" />
</listitem>
<listitem open="1" type="813" id="13559" />
<listitem open="1" type="813" id="13391" />
<listitem open="1" type="813" id="4742" />
<listitem open="1" type="813" id="4736" />
<listitem open="1" type="813" id="4754" />
<listitem open="0" type="817" id="5301" >
<listitem open="0" type="815" id="5413" />
<listitem open="0" type="815" id="5433" />
<listitem open="0" type="815" id="5453" />
<listitem open="0" type="815" id="8006" />
</listitem>
<listitem open="0" type="817" id="5320" >
<listitem open="0" type="815" id="5339" />
<listitem open="0" type="815" id="5358" />
<listitem open="0" type="815" id="5494" />
<listitem open="0" type="815" id="8297" />
<listitem open="0" type="815" id="8328" />
</listitem>
<listitem open="0" type="817" id="4434" >
<listitem open="0" type="815" id="4447" />
<listitem open="0" type="815" id="6244" />
<listitem open="0" type="815" id="6446" />
<listitem open="0" type="815" id="9809" />
<listitem open="0" type="815" id="9847" />
</listitem>
<listitem open="1" type="817" id="7051" >
<listitem open="0" type="815" id="7079" />
<listitem open="0" type="815" id="7136" />
</listitem>
<listitem open="1" type="817" id="4409" >
<listitem open="0" type="815" id="4714" />
<listitem open="0" type="815" id="13516" />
<listitem open="0" type="815" id="13348" />
<listitem open="0" type="815" id="4750" />
<listitem open="0" type="815" id="4724" />
<listitem open="0" type="815" id="4762" />
<listitem open="0" type="815" id="13726" />
<listitem open="0" type="815" id="13684" />
<listitem open="0" type="815" id="4765" />
<listitem open="0" type="815" id="4768" />
<listitem open="0" type="815" id="4771" />
<listitem open="0" type="815" id="4774" />
<listitem open="0" type="815" id="4792" />
<listitem open="0" type="815" id="4809" />
<listitem open="0" type="815" id="8743" />
<listitem open="0" type="815" id="9377" />
<listitem open="0" type="815" id="9448" />
</listitem>
<listitem open="1" type="817" id="4892" >
<listitem open="0" type="815" id="4902" />
<listitem open="0" type="815" id="4930" />
<listitem open="0" type="815" id="4971" />
<listitem open="0" type="815" id="4994" />
<listitem open="0" type="815" id="5033" />
<listitem open="0" type="815" id="5064" />
<listitem open="0" type="815" id="5096" />
<listitem open="0" type="815" id="5114" />
<listitem open="0" type="815" id="5133" />
<listitem open="0" type="815" id="9041" />
<listitem open="0" type="815" id="5171" />
<listitem open="0" type="815" id="5209" />
<listitem open="0" type="815" id="5600" />
<listitem open="0" type="815" id="5623" />
<listitem open="0" type="815" id="5715" />
<listitem open="0" type="815" id="5740" />
<listitem open="0" type="815" id="12608" />
<listitem open="0" type="815" id="5766" />
<listitem open="0" type="815" id="6699" />
<listitem open="0" type="815" id="6726" />
<listitem open="0" type="815" id="8577" />
<listitem open="0" type="815" id="8610" />
<listitem open="0" type="815" id="5019" />
<listitem open="0" type="815" id="5048" />
<listitem open="0" type="815" id="11560" />
<listitem open="0" type="815" id="11638" />
<listitem open="0" type="815" id="11717" />
</listitem>
<listitem open="1" type="817" id="11878" >
<listitem open="0" type="815" id="11919" />
<listitem open="0" type="815" id="12041" />
<listitem open="0" type="815" id="12244" />
<listitem open="0" type="815" id="12326" />
</listitem>
<listitem open="1" type="829" id="12609" />
<listitem open="1" type="830" id="8" >
<listitem open="1" type="829" id="4396" />
<listitem open="1" type="829" id="4395" />
<listitem open="1" type="829" id="4398" />
<listitem open="1" type="829" id="4397" />
<listitem open="1" type="829" id="4393" />
<listitem open="1" type="829" id="4400" />
<listitem open="1" type="829" id="4399" />
<listitem open="1" type="829" id="4404" />
<listitem open="1" type="829" id="4401" />
<listitem open="1" type="829" id="4403" />
<listitem open="1" type="829" id="4402" />
</listitem>
</listitem>
<listitem open="1" type="802" id="3" />
<listitem open="1" type="821" id="4" />
<listitem open="1" type="827" id="5" />
<listitem open="1" type="836" id="6" />
</listitem>
</listview>
<codegeneration>
<codegenerator language="C++" />
</codegeneration>
</XMI.extensions>
</XMI>

@ -0,0 +1,272 @@
if with_included_sqlite
SQLITE_SUBDIR = sqlite
LIB_SQLITE_LOCAL = $(top_builddir)/amarok/src/sqlite/libsqlite.la
sqlite_includes = -I$(top_srcdir)/amarok/src/sqlite
endif
if with_konqsidebar
KONQSIDEBAR_SUBDIR = konquisidebar
endif
KDE_OPTIONS = nofinal
lib_LTLIBRARIES = libamarok.la
SUBDIRS = \
amarokcore \
magnatunebrowser \
$(SQLITE_SUBDIR) \
analyzers \
data \
plugin \
images \
loader \
scripts \
themes \
vis \
metadata \
$(KONQSIDEBAR_SUBDIR) \
statusbar \
. \
engine \
mediadevice \
device \
collectionscanner
INCLUDES = \
-I$(top_builddir)/amarok/src/amarokcore \
-I$(top_builddir)/amarok/src/magnatunebrowser \
-I$(top_srcdir)/amarok/src/amarokcore \
-I$(top_srcdir)/amarok/src/analyzers \
-I$(top_srcdir)/amarok/src/plugin \
-I$(top_srcdir)/amarok/src/statusbar \
-I$(top_srcdir)/amarok/src/mediadevice \
-I$(top_srcdir)/amarok/src/device \
-I$(top_srcdir)/amarok/src \
-I$(kde_includes)/arts \
$(TAGLIB_CFLAGS) \
$(sqlite_includes) \
$(mysql_includes) \
$(postgresql_includes) \
$(EXSCALIBAR_CFLAGS) \
$(all_includes)
libamarok_la_SOURCES = \
Options1.ui \
Options1.ui.h \
Options2.ui \
Options4.ui \
Options5.ui \
Options7.ui \
Options8.ui \
actionclasses.cpp \
app.cpp \
atomicstring.cpp \
atomicurl.cpp \
browserbar.cpp \
clicklineedit.cpp \
collectionbrowser.cpp \
collectiondb.cpp \
columnlist.cpp \
configdialog.cpp \
contextbrowser.cpp \
coverfetcher.cpp \
covermanager.cpp \
cuefile.cpp \
dbsetup.ui \
dbsetup.ui.h \
deletedialog.cpp \
deletedialogbase.ui \
deviceconfiguredialog.cpp \
devicemanager.cpp \
directorylist.cpp \
dynamicmode.cpp \
enginebase.cpp \
enginecontroller.cpp \
engineobserver.cpp \
equalizergraph.cpp \
equalizerpresetmanager.cpp \
equalizersetup.cpp \
expression.cpp \
fht.cpp \
filebrowser.cpp \
firstrunwizard.ui \
hintlineedit.cpp \
htmlview.cpp \
iconloader.cpp \
k3bexporter.cpp \
kbookmarkhandler.cpp \
ktrm.cpp \
lastfm.cpp \
mediabrowser.cpp \
mediadevicemanager.cpp \
medium.cpp \
mediumpluginmanager.cpp \
metabundle.cpp \
metabundlesaver.cpp \
moodbar.cpp \
mountpointmanager.cpp \
multitabbar.cpp \
mydiroperator.cpp \
newdynamic.ui \
organizecollectiondialog.ui \
osd.cpp \
pixmapviewer.cpp \
playerwindow.cpp \
playlist.cpp \
playlistbrowser.cpp \
playlistbrowseritem.cpp \
playlistitem.cpp \
playlistloader.cpp \
playlistselection.cpp \
playlistwindow.cpp \
pluginmanager.cpp \
podcastsettings.cpp \
podcastsettingsbase.ui \
prettypopupmenu.cpp \
queuemanager.cpp \
refreshimages.cpp \
scancontroller.cpp \
scriptmanager.cpp \
scriptmanagerbase.ui \
scrobbler.cpp \
sliderwidget.cpp \
smartplaylisteditor.cpp \
socketserver.cpp \
starmanager.cpp \
statistics.cpp \
systray.cpp \
tagdialog.cpp \
tagdialogbase.ui \
tagguesser.cpp \
tagguesserconfigdialog.ui \
threadmanager.cpp \
tooltip.cpp \
trackpickerdialog.cpp \
trackpickerdialogbase.ui \
tracktooltip.cpp \
transferdialog.cpp \
xmlloader.cpp \
xspfplaylist.cpp \
editfilterdialog.cpp
libamarok_la_LIBADD = \
$(top_builddir)/amarok/src/amarokcore/libamarokcore.la \
$(top_builddir)/amarok/src/analyzers/libanalyzers.la \
$(top_builddir)/amarok/src/plugin/libplugin.la \
$(top_builddir)/amarok/src/statusbar/libstatusbar.la \
$(top_builddir)/amarok/src/metadata/libmetadata.la \
$(top_builddir)/amarok/src/magnatunebrowser/libmagnatunebrowser.la \
$(LIB_QT) $(LIB_KPARTS) -lDCOP -lkdefx $(KDE_MT_LIBS) $(LIB_KFILE) $(LIB_KDEUI) $(LIB_KDECORE) $(LIB_KHTML) $(LIB_KNEWSTUFF) \
$(TAGLIB_LIBS) $(gl_libs) $(LIB_SQLITE) $(LIB_SQLITE_LOCAL) \
$(LIB_TUNEPIMP) \
$(mysql_libs) \
$(postgresql_libs)
libamarok_la_LDFLAGS = \
$(all_libraries) \
$(KDE_RPATH)
METASOURCES = \
AUTO
KDE_ICON = \
AUTO
bin_SCRIPTS = amarok_proxy.rb
bin_PROGRAMS = amarokapp
# atomicstring_unittest is excluded from the build by default to avoid compile slowdowns.
# If you intend to do work in this area and want to build it, comment the line above and
# uncomment the lines below:
#bin_PROGRAMS = amarokapp atomicstring_unittest
#atomicstring_unittest_SOURCES = atomicstring_unittest.cpp atomicstring.h
#atomicstring_unittest_LDADD = atomicstring.$(OBJEXT) $(LIB_KDECORE)
amarokapp_SOURCES = main.cpp
amarokapp_LDADD = \
$(top_builddir)/amarok/src/amarokcore/libamarokcore.la \
libamarok.la \
$(top_builddir)/amarok/src/analyzers/libanalyzers.la \
$(top_builddir)/amarok/src/plugin/libplugin.la \
$(top_builddir)/amarok/src/statusbar/libstatusbar.la \
$(top_builddir)/amarok/src/metadata/libmetadata.la \
$(LIB_KDECORE)
$(EXSCALIBAR_LIBS)
amarokapp_LDFLAGS = \
$(all_libraries) \
$(KDE_RPATH)
rcdir = \
$(kde_datadir)/amarok
rc_DATA = \
amarokui.rc
configdir = \
$(kde_confdir)
config_DATA = \
amarokrc
xdg_apps_DATA = \
amarok.desktop
kde_servicetypes_DATA = \
amarok_plugin.desktop \
amarok_codecinstall.desktop
servicemenudir = \
$(kde_datadir)/konqueror/servicemenus
servicemenu_DATA = \
amarok_addaspodcast.desktop \
amarok_append.desktop \
amarok_play_audiocd.desktop
profiledatadir = \
$(kde_datadir)/profiles
profiledata_DATA = \
amarok.profile.xml
protocoldir = \
$(kde_servicesdir)
protocol_DATA = \
amarokitpc.protocol \
amaroklastfm.protocol \
amarokpcast.protocol
messages: rc.cpp
$(EXTRACTRC) `find . -name "*.rc" -o -name "*.ui" -o -name "*.kcfg"` > rc.cpp
LIST=`find . -name \*.h -o -name \*.hh -o -name \*.H -o -name \*.hxx -o -name \*.hpp -o -name \*.cpp -o -name \*.cc -o -name \*.cxx -o -name \*.ecpp -o -name \*.C`; \
if test -n "$$LIST"; then \
$(XGETTEXT) $$LIST -o $(podir)/amarok.pot; \
fi
install-exec-hook:
@echo ""
@echo "=========================="
@echo "= Amarok - INSTALLED ================================"
@echo "=========================="
@echo "="
@echo "= Type amarok to start!"
@echo "="
@echo "= If you have problems, please consult the README;"
@echo "= if the problems continue join us on #amarok."
@echo "="
@echo "======================================================="

@ -0,0 +1,700 @@
<!DOCTYPE UI><UI version="3.3" stdsetdef="1">
<class>Options1</class>
<widget class="QWidget">
<property name="name">
<cstring>General</cstring>
</property>
<property name="geometry">
<rect>
<x>0</x>
<y>0</y>
<width>431</width>
<height>556</height>
</rect>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>3</hsizetype>
<vsizetype>3</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="caption">
<string>General</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<widget class="QGroupBox">
<property name="name">
<cstring>generalBox</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<property name="title">
<string>General Options</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_ShowSplashscreen</cstring>
</property>
<property name="text">
<string>Sho&amp;w splash-screen on startup</string>
</property>
<property name="toolTip" stdset="0">
<string>Check to enable the splashscreen during Amarok startup.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Check to enable the splashscreen during Amarok startup.</string>
</property>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_ShowTrayIcon</cstring>
</property>
<property name="text">
<string>Show tray &amp;icon</string>
</property>
<property name="toolTip" stdset="0">
<string>Check to enable the Amarok system tray icon.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Check to enable the Amarok system tray icon.</string>
</property>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout5</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<spacer>
<property name="name">
<cstring>spacer3_2</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Fixed</enum>
</property>
<property name="sizeHint">
<size>
<width>16</width>
<height>21</height>
</size>
</property>
</spacer>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_AnimateTrayIcon</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="text">
<string>&amp;Flash tray icon when playing</string>
</property>
<property name="toolTip" stdset="0">
<string>Check to animate the Amarok system tray icon.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Check to animate the Amarok system tray icon.</string>
</property>
</widget>
</hbox>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_ShowPlayerWindow</cstring>
</property>
<property name="text">
<string>Show player window</string>
</property>
<property name="toolTip" stdset="0">
<string>Check to enable an extra player window.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Check to enable an extra player window.</string>
</property>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout4</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel">
<property name="name">
<cstring>textLabel1</cstring>
</property>
<property name="text">
<string>Default si&amp;ze for cover previews:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_CoverPreviewSize</cstring>
</property>
<property name="toolTip" stdset="0">
<string>Size of the cover image in the context viewer in pixels.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Size of the cover image in the context viewer in pixels.</string>
</property>
</widget>
<widget class="QSpinBox">
<property name="name">
<cstring>kcfg_CoverPreviewSize</cstring>
</property>
<property name="suffix">
<string>px</string>
</property>
<property name="maxValue">
<number>300</number>
</property>
<property name="minValue">
<number>50</number>
</property>
<property name="value">
<number>100</number>
</property>
<property name="toolTip" stdset="0">
<string>Size of the cover images in the context viewer in pixels.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Size of the cover images in the context viewer in pixels.</string>
</property>
</widget>
<spacer>
<property name="name">
<cstring>spacer7</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>30</width>
<height>20</height>
</size>
</property>
</spacer>
</hbox>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout7</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel">
<property name="name">
<cstring>textLabel1_2</cstring>
</property>
<property name="minimumSize">
<size>
<width>150</width>
<height>0</height>
</size>
</property>
<property name="text">
<string>External web &amp;browser:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kComboBox_browser</cstring>
</property>
</widget>
<widget class="KComboBox">
<property name="name">
<cstring>kComboBox_browser</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>7</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>150</width>
<height>0</height>
</size>
</property>
<property name="toolTip" stdset="0">
<string>Choose the external web browser to be used by Amarok.</string>
</property>
</widget>
<spacer>
<property name="name">
<cstring>spacer7_2</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>50</width>
<height>21</height>
</size>
</property>
</spacer>
</hbox>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout8</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>checkBox_customBrowser</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="minimumSize">
<size>
<width>150</width>
<height>0</height>
</size>
</property>
<property name="text">
<string>Use &amp;another browser:</string>
</property>
</widget>
<widget class="KLineEdit">
<property name="name">
<cstring>kLineEdit_customBrowser</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>7</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>150</width>
<height>0</height>
</size>
</property>
<property name="toolTip" stdset="0">
<string>Enter filename of external web browser.</string>
</property>
</widget>
<spacer>
<property name="name">
<cstring>spacer7_2_3</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>50</width>
<height>21</height>
</size>
</property>
</spacer>
</hbox>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>componentsBox</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<property name="title">
<string>Components</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_UseScores</cstring>
</property>
<property name="text">
<string>Use &amp;scores</string>
</property>
<property name="checked">
<bool>false</bool>
</property>
<property name="toolTip" stdset="0">
<string>Scores for tracks are calculated automatically, based on your listening habits.</string>
</property>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_UseRatings</cstring>
</property>
<property name="text">
<string>Use ratings</string>
</property>
<property name="toolTip" stdset="0">
<string>You can assign ratings to tracks manually, from 1 to 5 stars.</string>
</property>
</widget>
<widget class="Line">
<property name="name">
<cstring>line1</cstring>
</property>
<property name="frameShape">
<enum>HLine</enum>
</property>
<property name="frameShadow">
<enum>Sunken</enum>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
</widget>
<widget class="KActiveLabel">
<property name="name">
<cstring>moodbarHelpLabel</cstring>
</property>
<property name="text">
<string>You need the &lt;a href='http://amarok.kde.org/wiki/Moodbar'&gt;moodbar package&lt;/a&gt; installed to enable the moodbar feature.</string>
</property>
</widget>
<widget class="QFrame">
<property name="name">
<cstring>moodFrame</cstring>
</property>
<property name="frameShape">
<enum>NoFrame</enum>
</property>
<property name="frameShadow">
<enum>Raised</enum>
</property>
<property name="lineWidth">
<number>0</number>
</property>
<property name="margin">
<number>0</number>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<property name="spacing">
<number>0</number>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_ShowMoodbar</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="text">
<string>Use &amp;moods</string>
</property>
<property name="checked">
<bool>true</bool>
</property>
<property name="toolTip" stdset="0">
<string>Displays a visual representation of the current track in the slider bar of the player window and a column in the playlist window.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Displays a visual representation of the current track in the slider bar of the player window and a column in the playlist window.</string>
</property>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout8_2_2</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<spacer>
<property name="name">
<cstring>spacerMoodier</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Fixed</enum>
</property>
<property name="sizeHint">
<size>
<width>16</width>
<height>21</height>
</size>
</property>
</spacer>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_MakeMoodier</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="text">
<string>Make m&amp;oodier:</string>
</property>
<property name="toolTip" stdset="0">
<string>When enabled, the hue distribution is quantised and respread evenly, giving a prettier but less meaningful output.</string>
</property>
<property name="whatsThis" stdset="0">
<string>When enabled, the hue distribution is quantised and respread evenly, giving a prettier but less meaningful output.</string>
</property>
</widget>
<widget class="QComboBox">
<item>
<property name="text">
<string>Happy Like a Rainbow</string>
</property>
</item>
<item>
<property name="text">
<string>Angry as Hell</string>
</property>
</item>
<item>
<property name="text">
<string>Frozen in the Arctic</string>
</property>
</item>
<property name="name">
<cstring>kcfg_AlterMood</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
</widget>
<spacer>
<property name="name">
<cstring>spacer7_2_2_2</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>130</width>
<height>20</height>
</size>
</property>
</spacer>
</hbox>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout7_2_2</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<spacer>
<property name="name">
<cstring>spacerWithMusic</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Fixed</enum>
</property>
<property name="sizeHint">
<size>
<width>16</width>
<height>21</height>
</size>
</property>
</spacer>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_MoodsWithMusic</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="text">
<string>Stor&amp;e mood data files with music</string>
</property>
<property name="toolTip" stdset="0">
<string>Enabling this option stores Mood data files with the music files. Disabling stores them in your home folder.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Enabling this option stores Mood data files with the music files. Namely, the mood file for /music/file.mp3 will be /music/file.mood. Disabling stores them in your home folder.</string>
</property>
</widget>
</hbox>
</widget>
</vbox>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>groupBox2</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<property name="title">
<string>Playlist-Window Options</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_SavePlaylist</cstring>
</property>
<property name="text">
<string>&amp;Remember current playlist on exit</string>
</property>
<property name="toolTip" stdset="0">
<string>If checked, Amarok saves the current playlist on quit and restores it when restarted.&lt;br&gt;</string>
</property>
<property name="whatsThis" stdset="0">
<string>If checked, Amarok saves the current playlist on quit and restores it when restarted.</string>
</property>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_RelativePlaylist</cstring>
</property>
<property name="text">
<string>Manually sa&amp;ved playlists use relative path</string>
</property>
<property name="toolTip" stdset="0">
<string>If checked, Amarok uses a relative path for the tracks of manually saved playlists</string>
</property>
<property name="whatsThis" stdset="0">
<string>If checked, Amarok uses a relative path for the tracks of manually saved playlists</string>
</property>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_AutoShowContextBrowser</cstring>
</property>
<property name="text">
<string>Switch to Context &amp;Browser on track change</string>
</property>
<property name="toolTip" stdset="0">
<string>Switch to the context browser, when playing a track.&lt;br&gt;</string>
</property>
<property name="whatsThis" stdset="0">
<string>Switch to the context browser, when playing a track.</string>
</property>
</widget>
</vbox>
</widget>
<spacer>
<property name="name">
<cstring>spacer5</cstring>
</property>
<property name="orientation">
<enum>Vertical</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>20</width>
<height>30</height>
</size>
</property>
</spacer>
</vbox>
</widget>
<connections>
<connection>
<sender>kcfg_ShowTrayIcon</sender>
<signal>toggled(bool)</signal>
<receiver>kcfg_AnimateTrayIcon</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>checkBox_customBrowser</sender>
<signal>toggled(bool)</signal>
<receiver>kComboBox_browser</receiver>
<slot>setDisabled(bool)</slot>
</connection>
<connection>
<sender>checkBox_customBrowser</sender>
<signal>toggled(bool)</signal>
<receiver>kLineEdit_customBrowser</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_ShowMoodbar</sender>
<signal>toggled(bool)</signal>
<receiver>General</receiver>
<slot>slotUpdateMoodFrame()</slot>
</connection>
<connection>
<sender>kcfg_MakeMoodier</sender>
<signal>toggled(bool)</signal>
<receiver>General</receiver>
<slot>slotUpdateMoodFrame()</slot>
</connection>
</connections>
<includes>
<include location="local" impldecl="in implementation">Options1.ui.h</include>
</includes>
<slots>
<slot>slotUpdateMoodFrame()</slot>
</slots>
<functions>
<function access="private" specifier="non virtual">init()</function>
</functions>
<layoutdefaults spacing="6" margin="11"/>
<includehints>
<includehint>kcombobox.h</includehint>
<includehint>klineedit.h</includehint>
<includehint>kactivelabel.h</includehint>
</includehints>
</UI>

@ -0,0 +1,218 @@
//Released under GPLv2 or later. (C) 2005 Ian Monroe <ian@monroe.nu>
/****************************************************************************
** ui.h extension file, included from the uic-generated form implementation.
**
** If you want to add, delete, or rename functions or slots, use
** Qt Designer to update this file, preserving your code.
**
** You should not define a constructor or destructor in this file.
** Instead, write your code in functions called init() and destroy().
** These will automatically be called by the form's constructor and
** destructor.
*****************************************************************************/
#include <config.h>
#include "amarokconfig.h"
#include "moodbar.h"
#include "starmanager.h"
#include <kcolordialog.h>
#include <kstandarddirs.h>
void Options1::init()
{
slotUpdateMoodFrame();
//kcfg_CustomRatingsColors->setChecked( AmarokConfig::customRatingsColors() );
//slotUpdateRatingsFrame();
QStringList browsers;
browsers << "konqueror" << "firefox" << "opera" << "galeon" << "epiphany"
<< "safari" << "mozilla";
// Remove browsers which are not actually installed
for( QStringList::Iterator it = browsers.begin(), end = browsers.end(); it != end; ) {
if( KStandardDirs::findExe( *it ).isEmpty() )
it = browsers.erase( it );
else
++it;
}
#ifdef Q_WS_MAC
if ( KStandardDirs::findExe( "open" ) != QString::null )
browsers.prepend( i18n( "Default Browser" ) );
#else
if ( KStandardDirs::findExe( "kfmclient" ) != QString::null )
browsers.prepend( i18n( "Default KDE Browser" ) );
#endif
kComboBox_browser->insertStringList( browsers );
kLineEdit_customBrowser->setText( AmarokConfig::externalBrowser() );
int index = browsers.findIndex( AmarokConfig::externalBrowser() );
if( index >= 0 )
kComboBox_browser->setCurrentItem( index );
else if( AmarokConfig::externalBrowser() ==
#ifdef Q_WS_MAC
"open"
#else
"kfmclient openURL"
#endif
)
{
kComboBox_browser->setCurrentItem( 0 );
}
else
{
checkBox_customBrowser->setChecked( true );
}
}
void Options1::slotUpdateMoodFrame()
{
if( Moodbar::executableExists() )
{
moodbarHelpLabel->hide();
moodFrame->setEnabled(true);
kcfg_MakeMoodier->setEnabled(kcfg_ShowMoodbar->isChecked());
kcfg_AlterMood->setEnabled(kcfg_ShowMoodbar->isChecked() && kcfg_MakeMoodier->isChecked());
kcfg_MoodsWithMusic->setEnabled(kcfg_ShowMoodbar->isChecked());
}
else
{
moodbarHelpLabel->show();
kcfg_ShowMoodbar->setChecked(false);
moodFrame->setEnabled(false);
}
}
/*
void Options1::slotUpdateRatingsFrame()
{
kcfg_CustomRatingsColors->setEnabled( kcfg_UseRatings->isChecked() );
bool enableStars = kcfg_UseRatings->isChecked() && kcfg_CustomRatingsColors->isChecked();
kcfg_FixedHalfStarColor->setEnabled( enableStars );
AmarokConfig::setCustomRatingsColors( enableStars );
StarManager::instance()->reinitStars();
ratingsFrame->setEnabled( enableStars );
fivestar_1->setPixmap( *StarManager::instance()->getStar( 5 ) );
fivestar_2->setPixmap( *StarManager::instance()->getStar( 5 ) );
fivestar_3->setPixmap( *StarManager::instance()->getStar( 5 ) );
fivestar_4->setPixmap( *StarManager::instance()->getStar( 5 ) );
fivestar_5->setPixmap( *StarManager::instance()->getStar( 5 ) );
fivestar_1->setEnabled( enableStars );
fivestar_2->setEnabled( enableStars );
fivestar_3->setEnabled( enableStars );
fivestar_4->setEnabled( enableStars );
fivestar_5->setEnabled( enableStars );
fourstar_1->setPixmap( *StarManager::instance()->getStar( 4 ) );
fourstar_2->setPixmap( *StarManager::instance()->getStar( 4 ) );
fourstar_3->setPixmap( *StarManager::instance()->getStar( 4 ) );
fourstar_4->setPixmap( *StarManager::instance()->getStar( 4 ) );
fourstar_1->setEnabled( enableStars );
fourstar_2->setEnabled( enableStars );
fourstar_3->setEnabled( enableStars );
fourstar_4->setEnabled( enableStars );
threestar_1->setPixmap( *StarManager::instance()->getStar( 3 ) );
threestar_2->setPixmap( *StarManager::instance()->getStar( 3 ) );
threestar_3->setPixmap( *StarManager::instance()->getStar( 3 ) );
threestar_1->setEnabled( enableStars );
threestar_2->setEnabled( enableStars );
threestar_3->setEnabled( enableStars );
twostar_1->setPixmap( *StarManager::instance()->getStar( 2 ) );
twostar_2->setPixmap( *StarManager::instance()->getStar( 2 ) );
twostar_1->setEnabled( enableStars );
twostar_2->setEnabled( enableStars );
onestar_1->setPixmap( *StarManager::instance()->getStar( 1 ) );
onestar_1->setEnabled( enableStars );
halfstar->setPixmap( *StarManager::instance()->getHalfStar() );
halfstar->setEnabled( enableStars );
}
void Options1::slotFixedHalfStarColor()
{
bool checked = kcfg_FixedHalfStarColor->isChecked();
AmarokConfig::setFixedHalfStarColor( kcfg_FixedHalfStarColor->isChecked() );
slotUpdateRatingsFrame();
}
void Options1::slotPickColorHalf()
{
QColor halfStar;
int result = KColorDialog::getColor( halfStar );
if( result == KColorDialog::Accepted )
{
AmarokConfig::setStarColorHalf( halfStar );
StarManager::instance()->setHalfColor( halfStar );
slotUpdateRatingsFrame();
}
}
void Options1::slotPickColorOne()
{
QColor oneStar;
int result = KColorDialog::getColor( oneStar );
if( result == KColorDialog::Accepted )
{
AmarokConfig::setStarColorOne( oneStar );
StarManager::instance()->setColor( 1, oneStar );
slotUpdateRatingsFrame();
}
}
void Options1::slotPickColorTwo()
{
QColor twoStar;
int result = KColorDialog::getColor( twoStar );
if( result == KColorDialog::Accepted )
{
AmarokConfig::setStarColorTwo( twoStar );
StarManager::instance()->setColor( 2, twoStar );
slotUpdateRatingsFrame();
}
}
void Options1::slotPickColorThree()
{
QColor threeStar;
int result = KColorDialog::getColor( threeStar );
if( result == KColorDialog::Accepted )
{
AmarokConfig::setStarColorThree( threeStar );
StarManager::instance()->setColor( 3, threeStar );
slotUpdateRatingsFrame();
}
}
void Options1::slotPickColorFour()
{
QColor fourStar;
int result = KColorDialog::getColor( fourStar );
if( result == KColorDialog::Accepted )
{
AmarokConfig::setStarColorFour( fourStar );
StarManager::instance()->setColor( 4, fourStar );
slotUpdateRatingsFrame();
}
}
void Options1::slotPickColorFive()
{
QColor fiveStar;
int result = KColorDialog::getColor( fiveStar );
if( result == KColorDialog::Accepted )
{
AmarokConfig::setStarColorFive( fiveStar );
StarManager::instance()->setColor( 5, fiveStar );
slotUpdateRatingsFrame();
}
}
*/

@ -0,0 +1,768 @@
<!DOCTYPE UI><UI version="3.3" stdsetdef="1">
<class>Options2</class>
<widget class="QWidget">
<property name="name">
<cstring>Options2</cstring>
</property>
<property name="geometry">
<rect>
<x>0</x>
<y>0</y>
<width>447</width>
<height>564</height>
</rect>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>3</hsizetype>
<vsizetype>3</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<widget class="QGroupBox">
<property name="name">
<cstring>groupBox6</cstring>
</property>
<property name="title">
<string>Icons</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_UseCustomIconTheme</cstring>
</property>
<property name="text">
<string>Use custom icon &amp;theme (requires restart)</string>
</property>
<property name="toolTip" stdset="0">
<string>Check to enable Amarok's custom icon theme.&lt;br&gt;</string>
</property>
<property name="whatsThis" stdset="0">
<string>Check to enable Amarok's custom icon theme.</string>
</property>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>groupBox4</cstring>
</property>
<property name="title">
<string>Fonts</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_UseCustomFonts</cstring>
</property>
<property name="text">
<string>&amp;Use custom fonts</string>
</property>
<property name="checked">
<bool>false</bool>
</property>
<property name="toolTip" stdset="0">
<string>Check to enable custom fonts.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Check to enable custom fonts.</string>
</property>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>fontGroupBox</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>7</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="frameShape">
<enum>NoFrame</enum>
</property>
<property name="lineWidth">
<number>0</number>
</property>
<property name="title">
<string></string>
</property>
<property name="flat">
<bool>true</bool>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel" row="0" column="0">
<property name="name">
<cstring>textLabel3</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>1</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>Playlist Window:</string>
</property>
<property name="toolTip" stdset="0">
<string>The font to use in the playlist window.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The font to use in the playlist window.</string>
</property>
</widget>
<widget class="KFontRequester" row="0" column="1">
<property name="name">
<cstring>kcfg_PlaylistWindowFont</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="sampleText">
<string></string>
</property>
<property name="toolTip" stdset="0">
<string>The font to use in the playlist window.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The font to use in the playlist window.</string>
</property>
</widget>
<widget class="QLabel" row="1" column="0">
<property name="name">
<cstring>textLabel1</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>1</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>Player Window:</string>
</property>
<property name="alignment">
<set>AlignVCenter</set>
</property>
<property name="toolTip" stdset="0">
<string>The font to use in the player window.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The font to use in the player window.</string>
</property>
</widget>
<widget class="QLabel" row="2" column="0">
<property name="name">
<cstring>textLabel3_2</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>1</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>Context Sidebar:</string>
</property>
<property name="toolTip" stdset="0">
<string>The font to use in the context browser.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The font to use in the context browser.</string>
</property>
</widget>
<widget class="KFontRequester" row="2" column="1">
<property name="name">
<cstring>kcfg_ContextBrowserFont</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="sampleText">
<string></string>
</property>
<property name="toolTip" stdset="0">
<string>The font to use in the context browser.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The font to use in the context browser.</string>
</property>
</widget>
<widget class="KFontRequester" row="1" column="1">
<property name="name">
<cstring>kcfg_PlayerWidgetFont</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="sampleText">
<string></string>
</property>
<property name="toolTip" stdset="0">
<string>The font to use in the context browser.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The font to use in the context browser.</string>
</property>
</widget>
</grid>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>groupBox3</cstring>
</property>
<property name="title">
<string>Color Scheme</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QButtonGroup">
<property name="name">
<cstring>radioGroup</cstring>
</property>
<property name="frameShape">
<enum>NoFrame</enum>
</property>
<property name="title">
<string></string>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<widget class="QLayoutWidget" row="2" column="0">
<property name="name">
<cstring>layout2</cstring>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="spacing">
<number>0</number>
</property>
<widget class="QRadioButton">
<property name="name">
<cstring>kcfg_SchemeCustom</cstring>
</property>
<property name="text">
<string>&amp;Custom color scheme</string>
</property>
<property name="checked">
<bool>true</bool>
</property>
<property name="toolTip" stdset="0">
<string>If selected, Amarok uses the user-defined colors in the playlist.</string>
</property>
<property name="whatsThis" stdset="0">
<string>If selected, Amarok uses the user-defined colors in the playlist.</string>
</property>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>customSchemeBox</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="focusPolicy">
<enum>NoFocus</enum>
</property>
<property name="frameShape">
<enum>NoFrame</enum>
</property>
<property name="title">
<string></string>
</property>
<property name="flat">
<bool>false</bool>
</property>
<property name="checked">
<bool>false</bool>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel" row="0" column="0">
<property name="name">
<cstring>fgLabel</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>4</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>0</width>
<height>0</height>
</size>
</property>
<property name="text">
<string>Fo&amp;reground:</string>
</property>
<property name="textFormat">
<enum>AutoText</enum>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_PlaylistWindowFgColor</cstring>
</property>
<property name="whatsThis" stdset="0">
<string>Selects the color to use as foreground color in the playlist.</string>
</property>
</widget>
<widget class="KColorButton" row="0" column="1">
<property name="name">
<cstring>kcfg_PlaylistWindowFgColor</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>2</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string></string>
</property>
<property name="color">
<color>
<red>255</red>
<green>255</green>
<blue>255</blue>
</color>
</property>
<property name="toolTip" stdset="0">
<string>Click to select the foreground text color in the playlist window.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Selects the color to use as foreground (text) color in the playlist.</string>
</property>
</widget>
<widget class="QLabel" row="1" column="0">
<property name="name">
<cstring>bgColor</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>4</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>&amp;Background:</string>
</property>
<property name="textFormat">
<enum>AutoText</enum>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_PlaylistWindowBgColor</cstring>
</property>
<property name="whatsThis" stdset="0">
<string>Selects the color to use as background color in the playlist.</string>
</property>
</widget>
<widget class="KColorButton" row="1" column="1">
<property name="name">
<cstring>kcfg_PlaylistWindowBgColor</cstring>
</property>
<property name="enabled">
<bool>true</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>2</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>0</width>
<height>0</height>
</size>
</property>
<property name="maximumSize">
<size>
<width>192</width>
<height>32767</height>
</size>
</property>
<property name="text">
<string></string>
</property>
<property name="color">
<color>
<red>32</red>
<green>32</green>
<blue>80</blue>
</color>
</property>
<property name="toolTip" stdset="0">
<string>Click to select the background color in the playlist window.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Selects the color to use as background color in the playlist.</string>
</property>
</widget>
</grid>
</widget>
</vbox>
</widget>
<widget class="QRadioButton" row="0" column="0">
<property name="name">
<cstring>kcfg_SchemeKDE</cstring>
</property>
<property name="text">
<string>The current &amp;KDE color-scheme</string>
</property>
<property name="buttonGroupId">
<number>0</number>
</property>
<property name="toolTip" stdset="0">
<string>If selected, Amarok uses the KDE standard colors in the playlist.</string>
</property>
<property name="whatsThis" stdset="0">
<string>If selected, Amarok uses the KDE standard colors in the playlist.</string>
</property>
</widget>
<widget class="QRadioButton" row="1" column="0">
<property name="name">
<cstring>kcfg_SchemeAmarok</cstring>
</property>
<property name="text">
<string>The classic &amp;Amarok, "funky-monkey", theme</string>
</property>
<property name="buttonGroupId">
<number>1</number>
</property>
<property name="toolTip" stdset="0">
<string>If selected, Amarok uses the Amarok standard colors in the playlist.</string>
</property>
<property name="whatsThis" stdset="0">
<string>If selected, Amarok uses the Amarok standard colors in the playlist.</string>
</property>
</widget>
</grid>
</widget>
<widget class="Line">
<property name="name">
<cstring>line1</cstring>
</property>
<property name="frameShape">
<enum>HLine</enum>
</property>
<property name="frameShadow">
<enum>Sunken</enum>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout5</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel">
<property name="name">
<cstring>textLabel1_3</cstring>
</property>
<property name="text">
<string>Color for new playlist items:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_NewPlaylistItemsColor</cstring>
</property>
<property name="toolTip" stdset="0">
<string>The color that is used when fresh items are being loaded in the playlist.</string>
</property>
</widget>
<widget class="KColorButton">
<property name="name">
<cstring>kcfg_NewPlaylistItemsColor</cstring>
</property>
<property name="text">
<string></string>
</property>
<property name="toolTip" stdset="0">
<string>The color that is used when fresh items are being loaded in the playlist.</string>
</property>
</widget>
</hbox>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>contextGroupBox</cstring>
</property>
<property name="title">
<string>Context Browser Style</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout6</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel">
<property name="name">
<cstring>textLabel1_2</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>Select a style:</string>
</property>
<property name="toolTip" stdset="0">
<string></string>
</property>
</widget>
<widget class="KComboBox">
<property name="name">
<cstring>styleComboBox</cstring>
</property>
<property name="toolTip" stdset="0">
<string>Select the style of the Context Browser.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Select the style of the Context Browser.</string>
</property>
</widget>
</hbox>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout5</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QPushButton">
<property name="name">
<cstring>installPushButton</cstring>
</property>
<property name="text">
<string>Install New Style...</string>
</property>
<property name="toolTip" stdset="0">
<string>Click to install a new Context Browser style.&lt;br&gt;Tip: More styles can be found on &lt;a href='http://kde-look.org'&gt;http://kde-look.org&lt;/a&gt;</string>
</property>
<property name="whatsThis" stdset="0">
<string>Select and install a new Context Browser style.</string>
</property>
</widget>
<widget class="QPushButton">
<property name="name">
<cstring>retrievePushButton</cstring>
</property>
<property name="text">
<string>Download Styles...</string>
</property>
<property name="toolTip" stdset="0">
<string>Click to download new Context Browser styles.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Select and download new Context Browser styles.</string>
</property>
</widget>
<spacer>
<property name="name">
<cstring>spacer2</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>40</width>
<height>20</height>
</size>
</property>
</spacer>
<widget class="QPushButton">
<property name="name">
<cstring>uninstallPushButton</cstring>
</property>
<property name="text">
<string>Uninstall Style</string>
</property>
<property name="toolTip" stdset="0">
<string>Click to uninstall the selected Context Browser style.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Uninstall the selected Context Browser style.</string>
</property>
</widget>
</hbox>
</widget>
</vbox>
</widget>
<spacer>
<property name="name">
<cstring>spacer1</cstring>
</property>
<property name="orientation">
<enum>Vertical</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>20</width>
<height>30</height>
</size>
</property>
</spacer>
</vbox>
</widget>
<connections>
<connection>
<sender>kcfg_UseCustomFonts</sender>
<signal>toggled(bool)</signal>
<receiver>fontGroupBox</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_SchemeCustom</sender>
<signal>toggled(bool)</signal>
<receiver>customSchemeBox</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>installPushButton</sender>
<signal>clicked()</signal>
<receiver>Options2</receiver>
<slot>installPushButton_clicked()</slot>
</connection>
<connection>
<sender>retrievePushButton</sender>
<signal>clicked()</signal>
<receiver>Options2</receiver>
<slot>retrievePushButton_clicked()</slot>
</connection>
<connection>
<sender>uninstallPushButton</sender>
<signal>clicked()</signal>
<receiver>Options2</receiver>
<slot>uninstallPushButton_clicked()</slot>
</connection>
<connection>
<sender>styleComboBox</sender>
<signal>activated(const QString&amp;)</signal>
<receiver>Options2</receiver>
<slot>styleComboBox_activated(const QString&amp;)</slot>
</connection>
</connections>
<includes>
<include location="local" impldecl="in implementation">Options2.ui.h</include>
</includes>
<slots>
<slot>installPushButton_clicked()</slot>
<slot>retrievePushButton_clicked()</slot>
<slot>uninstallPushButton_clicked()</slot>
<slot>styleComboBox_activated( const QString &amp; s )</slot>
<slot>updateStyleComboBox()</slot>
</slots>
<functions>
<function access="private" specifier="non virtual">init()</function>
</functions>
<layoutdefaults spacing="6" margin="11"/>
<includehints>
<includehint>kfontrequester.h</includehint>
<includehint>kfontrequester.h</includehint>
<includehint>kfontrequester.h</includehint>
<includehint>kcolorbutton.h</includehint>
<includehint>kcolorbutton.h</includehint>
<includehint>kcolorbutton.h</includehint>
<includehint>kcombobox.h</includehint>
</includehints>
</UI>

@ -0,0 +1,189 @@
/****************************************************************************
** ui.h extension file, included from the uic-generated form implementation.
**
** If you want to add, delete, or rename functions or slots, use
** Qt Designer to update this file, preserving your code.
**
** You should not define a constructor or destructor in this file.
** Instead, write your code in functions called init() and destroy().
** These will automatically be called by the form's constructor and
** destructor.
*****************************************************************************/
#include "amarok.h"
#include "amarokconfig.h"
#include "debug.h"
#include "contextbrowser.h"
#include <kapplication.h>
#include <kfiledialog.h>
#include <kmessagebox.h>
#include <knewstuff/downloaddialog.h> // knewstuff theme fetching
#include <knewstuff/engine.h> // "
#include <knewstuff/knewstuff.h> // "
#include <knewstuff/provider.h> // "
#include <kstandarddirs.h>
#include <ktar.h>
#include <kio/netaccess.h>
#include <qdir.h>
#include <qfileinfo.h>
#include <qtimer.h>
////////////////////////////////////////////////////////////////////////////////
// class AmarokThemeNewStuff
////////////////////////////////////////////////////////////////////////////////
/**
* GHNS Customised Download implementation.
*/
class AmarokThemeNewStuff : public KNewStuff
{
public:
AmarokThemeNewStuff(const QString &type, QWidget *parentWidget=0)
: KNewStuff( type, parentWidget )
{}
bool install( const QString& fileName )
{
KTar archive( fileName );
if ( !archive.open( IO_ReadOnly ) ) {
KMessageBox::sorry( 0, i18n( "Could not read this package." ) );
return false;
}
const QString destination = Amarok::saveLocation( "themes/" );
debug() << "copying to " << destination << endl;
const KArchiveDirectory* archiveDir = archive.directory();
archiveDir->copyTo( destination, true );
return true;
}
virtual bool createUploadFile( const QString& ) { return false; }
};
////////////////////////////////////////////////////////////////////////////////
// class Options2
////////////////////////////////////////////////////////////////////////////////
void Options2::init()
{
updateStyleComboBox();
uninstallPushButton->setEnabled ( styleComboBox->currentText() != "Default" );
}
// This method is basically lifted from ScriptManager::slotInstallScript()
void Options2::installPushButton_clicked()
{
KFileDialog dia( QString::null, "*.tar *.tar.bz2 *.tar.gz|" + i18n( "Style Packages (*.tar, *.tar.bz2, *.tar.gz)" ), 0, 0, true );
kapp->setTopWidget( &dia );
dia.setCaption( kapp->makeStdCaption( i18n( "Select Style Package" ) ) );
dia.setMode( KFile::File | KFile::ExistingOnly );
if ( !dia.exec() ) return;
KTar archive( dia.selectedURL().path() );
if ( !archive.open( IO_ReadOnly ) ) {
KMessageBox::sorry( 0, i18n( "Could not read this package." ) );
return;
}
const QString destination = Amarok::saveLocation( "themes/" );
debug() << "copying to " << destination << endl;
const KArchiveDirectory* archiveDir = archive.directory();
archiveDir->copyTo( destination, true );
updateStyleComboBox();
}
void Options2::retrievePushButton_clicked()
{
// Delete KNewStuff's configuration entries. These entries reflect which styles
// are already installed. As we cannot yet keep them in sync after uninstalling
// styles, we deactivate the check marks entirely.
Amarok::config()->deleteGroup( "KNewStuffStatus" );
// we need this because KNewStuffGeneric's install function isn't clever enough
AmarokThemeNewStuff *kns = new AmarokThemeNewStuff( "amarok/themes", this );
KNS::Engine *engine = new KNS::Engine( kns, "amarok/theme", this );
KNS::DownloadDialog* d = new KNS::DownloadDialog( engine, this );
d->setType( "amarok/theme" );
// you have to do this by hand when providing your own Engine
KNS::ProviderLoader *p = new KNS::ProviderLoader( this );
connect( p, SIGNAL( providersLoaded(Provider::List*) ), d, SLOT( slotProviders(Provider::List *) ) );
p->load( "amarok/theme", "http://amarok.kde.org/knewstuff/amarokthemes-providers.xml" );
connect( d, SIGNAL( finished() ), d, SLOT( delayedDestruct() ) );
connect( d, SIGNAL( finished() ), this, SLOT( updateStyleComboBox() ) );
// Due to kdelibs idiocy, KNS::DownloadDialog is /always/ non-modal. So we have to
// ensure that closing the settings dialog before the DownloadDialog doesn't crash.
QTimer::singleShot( 0, d, SLOT( exec() ) );
}
void Options2::uninstallPushButton_clicked()
{
const QString name = styleComboBox->currentText();
if ( name == "Default" )
return;
if( KMessageBox::warningContinueCancel( 0,
i18n( "<p>Are you sure you want to uninstall the theme <strong>%1</strong>?</p>" ).arg( name ),
i18n("Uninstall Theme"), i18n("Uninstall") ) == KMessageBox::Cancel )
return;
if ( name == AmarokConfig::contextBrowserStyleSheet() ) {
AmarokConfig::setContextBrowserStyleSheet( "Default" );
ContextBrowser::instance()->reloadStyleSheet();
}
KURL themeDir( KURL::fromPathOrURL( Amarok::saveLocation( "themes/" ) ) );
themeDir.addPath( name );
if( !KIO::NetAccess::del( themeDir, 0 ) ) {
KMessageBox::sorry( 0, i18n( "<p>Could not uninstall this theme.</p>"
"<p>You may not have sufficient permissions to delete the folder <strong>%1<strong></p>."
).arg( themeDir.isLocalFile() ? themeDir.path() : themeDir.url() ) );
return;
}
updateStyleComboBox();
}
void Options2::styleComboBox_activated(const QString& s)
{
bool disable = false;
QDir dir( Amarok::saveLocation( "themes/" ) + s );
if( !dir.exists() )
disable = true;
uninstallPushButton->setEnabled ( !disable );
}
void Options2::updateStyleComboBox()
{
DEBUG_BLOCK
styleComboBox->clear();
const QStringList styleList = kapp->dirs()->findAllResources("data","amarok/themes/*/stylesheet.css", false);
QStringList sortedList;
foreach (styleList) sortedList.append(QFileInfo( *it ).dir().dirName());
sortedList.append( "Default" );
sortedList.sort();
foreach(sortedList) styleComboBox->insertItem(*it);
styleComboBox->setCurrentItem(AmarokConfig::contextBrowserStyleSheet());
}

@ -0,0 +1,622 @@
<!DOCTYPE UI><UI version="3.3" stdsetdef="1">
<class>Options4</class>
<widget class="QWidget">
<property name="name">
<cstring>Options4</cstring>
</property>
<property name="geometry">
<rect>
<x>0</x>
<y>0</y>
<width>455</width>
<height>447</height>
</rect>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>3</hsizetype>
<vsizetype>3</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QButtonGroup" row="0" column="0">
<property name="name">
<cstring>opt_crossfade</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>0</width>
<height>180</height>
</size>
</property>
<property name="frameShape">
<enum>GroupBoxPanel</enum>
</property>
<property name="frameShadow">
<enum>Sunken</enum>
</property>
<property name="title">
<string>&amp;Transition</string>
</property>
<property name="whatsThis" stdset="0">
<string>&lt;b&gt;Transition Behavior&lt;/b&gt;
&lt;p&gt;During playback, when Amarok transitions between tracks, it can either proceed to the next track instantly (with configurable gap), or crossfade (with configurable fade period).&lt;/p&gt;</string>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QRadioButton" row="0" column="0" rowspan="1" colspan="2">
<property name="name">
<cstring>radioButtonNormalPlayback</cstring>
</property>
<property name="text">
<string>&amp;No crossfading</string>
</property>
<property name="checked">
<bool>true</bool>
</property>
<property name="toolTip" stdset="0">
<string>Enable normal track transition. You may insert a gap of silence between tracks.</string>
</property>
</widget>
<widget class="QLayoutWidget" row="1" column="1">
<property name="name">
<cstring>layout11</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel">
<property name="name">
<cstring>trackDelayLengthLabel</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>4</hsizetype>
<vsizetype>1</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>150</width>
<height>0</height>
</size>
</property>
<property name="text">
<string>Insert &amp;gap:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_TrackDelayLength</cstring>
</property>
</widget>
<widget class="QSpinBox">
<property name="name">
<cstring>kcfg_TrackDelayLength</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>3</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>160</width>
<height>0</height>
</size>
</property>
<property name="suffix">
<string> ms</string>
</property>
<property name="maxValue">
<number>10000</number>
</property>
<property name="lineStep">
<number>100</number>
</property>
<property name="value">
<number>0</number>
</property>
<property name="toolTip" stdset="0">
<string>Silence between tracks, in milliseconds.</string>
</property>
</widget>
</hbox>
</widget>
<widget class="QRadioButton" row="2" column="0" rowspan="1" colspan="2">
<property name="name">
<cstring>kcfg_Crossfade</cstring>
</property>
<property name="text">
<string>&amp;Crossfading</string>
</property>
<property name="checked">
<bool>false</bool>
</property>
<property name="toolTip" stdset="0">
<string>Enable crossfading between tracks.</string>
</property>
</widget>
<widget class="QLayoutWidget" row="3" column="1">
<property name="name">
<cstring>layout9</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout7</cstring>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel">
<property name="name">
<cstring>crossfadeLengthLabel</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>4</hsizetype>
<vsizetype>1</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>150</width>
<height>0</height>
</size>
</property>
<property name="text">
<string>Crosso&amp;ver duration:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_CrossfadeLength</cstring>
</property>
</widget>
<widget class="QLabel">
<property name="name">
<cstring>crossfadeDropdownText</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>4</hsizetype>
<vsizetype>1</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>150</width>
<height>0</height>
</size>
</property>
<property name="text">
<string>Crossfa&amp;de:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_CrossfadeType</cstring>
</property>
</widget>
</vbox>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout8</cstring>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QSpinBox">
<property name="name">
<cstring>kcfg_CrossfadeLength</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>4</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>50</width>
<height>0</height>
</size>
</property>
<property name="suffix">
<string> ms</string>
</property>
<property name="maxValue">
<number>99999999</number>
</property>
<property name="minValue">
<number>100</number>
</property>
<property name="lineStep">
<number>100</number>
</property>
<property name="value">
<number>100</number>
</property>
<property name="toolTip" stdset="0">
<string>The length of the crossfade between tracks, in milliseconds.</string>
</property>
</widget>
<widget class="QComboBox">
<item>
<property name="text">
<string>Always</string>
</property>
</item>
<item>
<property name="text">
<string>On Automatic Track Change Only</string>
</property>
</item>
<item>
<property name="text">
<string>On Manual Track Change Only</string>
</property>
</item>
<property name="name">
<cstring>kcfg_CrossfadeType</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>4</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>50</width>
<height>0</height>
</size>
</property>
<property name="duplicatesEnabled">
<bool>false</bool>
</property>
<property name="toolTip" stdset="0">
<string>Select when you want crossfading to occur</string>
</property>
<property name="whatsThis" stdset="0">
<string>Select when you want crossfading to occur</string>
</property>
</widget>
</vbox>
</widget>
</hbox>
</widget>
<spacer row="3" column="0">
<property name="name">
<cstring>spacer76</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Fixed</enum>
</property>
<property name="sizeHint">
<size>
<width>16</width>
<height>20</height>
</size>
</property>
</spacer>
</grid>
</widget>
<widget class="QCheckBox" row="2" column="0">
<property name="name">
<cstring>kcfg_FadeoutOnExit</cstring>
</property>
<property name="text">
<string>Fade out on e&amp;xit</string>
</property>
<property name="toolTip" stdset="0">
<string>If checked, Amarok will fade out the music on program exit.</string>
</property>
</widget>
<widget class="QCheckBox" row="3" column="0">
<property name="name">
<cstring>kcfg_ResumePlayback</cstring>
</property>
<property name="text">
<string>&amp;Resume playback on start</string>
</property>
<property name="toolTip" stdset="0">
<string>If checked, Amarok will&lt;br&gt;resume playback from where you left it the previous session -- just like a tape-player.</string>
</property>
</widget>
<spacer row="4" column="0">
<property name="name">
<cstring>spacer2</cstring>
</property>
<property name="orientation">
<enum>Vertical</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>31</width>
<height>30</height>
</size>
</property>
</spacer>
<widget class="QButtonGroup" row="1" column="0">
<property name="name">
<cstring>opt_crossfade_2</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>0</width>
<height>120</height>
</size>
</property>
<property name="frameShape">
<enum>GroupBoxPanel</enum>
</property>
<property name="frameShadow">
<enum>Sunken</enum>
</property>
<property name="title">
<string>&amp;Fadeout</string>
</property>
<property name="whatsThis" stdset="0">
<string>&lt;b&gt;Transition Behavior&lt;/b&gt;
&lt;p&gt;During playback, when Amarok transitions between tracks, it can either proceed to the next track instantly (with configurable gap), or crossfade (with configurable fade period).&lt;/p&gt;</string>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QRadioButton" row="0" column="0" rowspan="1" colspan="2">
<property name="name">
<cstring>radioButtonNormalPlayback_2</cstring>
</property>
<property name="text">
<string>No &amp;fadeout</string>
</property>
<property name="checked">
<bool>true</bool>
</property>
<property name="toolTip" stdset="0">
<string>Disable fadeout. Music will stop immediately.</string>
</property>
</widget>
<spacer row="2" column="0">
<property name="name">
<cstring>spacer76_2</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Fixed</enum>
</property>
<property name="sizeHint">
<size>
<width>16</width>
<height>20</height>
</size>
</property>
</spacer>
<widget class="QLayoutWidget" row="2" column="1">
<property name="name">
<cstring>layout9_2</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout7_2</cstring>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel">
<property name="name">
<cstring>fadeoutLengthLabel</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>4</hsizetype>
<vsizetype>1</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>150</width>
<height>0</height>
</size>
</property>
<property name="text">
<string>Fadeout &amp;duration:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_FadeoutLength</cstring>
</property>
</widget>
</vbox>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout8_2</cstring>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QSpinBox">
<property name="name">
<cstring>kcfg_FadeoutLength</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>4</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>50</width>
<height>0</height>
</size>
</property>
<property name="suffix">
<string> ms</string>
</property>
<property name="maxValue">
<number>99999999</number>
</property>
<property name="minValue">
<number>100</number>
</property>
<property name="lineStep">
<number>100</number>
</property>
<property name="value">
<number>100</number>
</property>
<property name="toolTip" stdset="0">
<string>The length of the fadeout, in milliseconds.</string>
</property>
</widget>
</vbox>
</widget>
</hbox>
</widget>
<widget class="QRadioButton" row="1" column="0" rowspan="1" colspan="2">
<property name="name">
<cstring>kcfg_Fadeout</cstring>
</property>
<property name="text">
<string>Fade&amp;out</string>
</property>
<property name="checked">
<bool>false</bool>
</property>
<property name="toolTip" stdset="0">
<string>Fade the music out when the Stop button is pressed.</string>
</property>
</widget>
</grid>
</widget>
</grid>
</widget>
<connections>
<connection>
<sender>radioButtonNormalPlayback</sender>
<signal>toggled(bool)</signal>
<receiver>kcfg_TrackDelayLength</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_Crossfade</sender>
<signal>toggled(bool)</signal>
<receiver>kcfg_CrossfadeLength</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>radioButtonNormalPlayback</sender>
<signal>toggled(bool)</signal>
<receiver>trackDelayLengthLabel</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_Crossfade</sender>
<signal>toggled(bool)</signal>
<receiver>crossfadeLengthLabel</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_Crossfade</sender>
<signal>toggled(bool)</signal>
<receiver>crossfadeDropdownText</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_Crossfade</sender>
<signal>toggled(bool)</signal>
<receiver>kcfg_CrossfadeType</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_Fadeout</sender>
<signal>toggled(bool)</signal>
<receiver>fadeoutLengthLabel</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_Fadeout</sender>
<signal>toggled(bool)</signal>
<receiver>kcfg_FadeoutLength</receiver>
<slot>setEnabled(bool)</slot>
</connection>
</connections>
<layoutdefaults spacing="6" margin="11"/>
</UI>

@ -0,0 +1,530 @@
<!DOCTYPE UI><UI version="3.3" stdsetdef="1">
<class>Options5</class>
<widget class="QWidget">
<property name="name">
<cstring>Options5</cstring>
</property>
<property name="geometry">
<rect>
<x>0</x>
<y>0</y>
<width>481</width>
<height>472</height>
</rect>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_OsdEnabled</cstring>
</property>
<property name="text">
<string>&amp;Use On-Screen-Display</string>
</property>
<property name="checked">
<bool>true</bool>
</property>
<property name="toolTip" stdset="0">
<string>Check to enable the On-Screen-Display. &lt;br&gt;The OSD briefly displays track data when a new track is played.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Check to enable the On-Screen-Display. The OSD briefly displays track data when a new track is played.</string>
</property>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout2</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<spacer>
<property name="name">
<cstring>spacer2</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Fixed</enum>
</property>
<property name="sizeHint">
<size>
<width>16</width>
<height>20</height>
</size>
</property>
</spacer>
<widget class="QGroupBox">
<property name="name">
<cstring>mainBox</cstring>
</property>
<property name="frameShape">
<enum>NoFrame</enum>
</property>
<property name="title">
<string></string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<widget class="QGroupBox">
<property name="name">
<cstring>fontBox</cstring>
</property>
<property name="frameShape">
<enum>GroupBoxPanel</enum>
</property>
<property name="frameShadow">
<enum>Sunken</enum>
</property>
<property name="lineWidth">
<number>1</number>
</property>
<property name="title">
<string>&amp;Font</string>
</property>
<property name="flat">
<bool>false</bool>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="KFontRequester">
<property name="name">
<cstring>kcfg_OsdFont</cstring>
</property>
<property name="font">
<font>
</font>
</property>
<property name="sampleText">
<string></string>
</property>
<property name="toolTip" stdset="0">
<string>The font to use for the On-Screen Display.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The font to use for the On-Screen Display.</string>
</property>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_OsdDrawShadow</cstring>
</property>
<property name="text">
<string>Draw &amp;shadow</string>
</property>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>groupBox9</cstring>
</property>
<property name="title">
<string>C&amp;olors</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout3</cstring>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="spacing">
<number>2</number>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_OsdUseCustomColors</cstring>
</property>
<property name="text">
<string>Use &amp;custom colors</string>
</property>
<property name="toolTip" stdset="0">
<string>Check to enable custom colors for the On-Screen-Display.</string>
</property>
<property name="whatsThis" stdset="0">
<string>Check to enable custom colors for the On-Screen-Display.</string>
</property>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout1</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<spacer>
<property name="name">
<cstring>spacer1</cstring>
</property>
<property name="orientation">
<enum>Horizontal</enum>
</property>
<property name="sizeType">
<enum>Fixed</enum>
</property>
<property name="sizeHint">
<size>
<width>16</width>
<height>20</height>
</size>
</property>
</spacer>
<widget class="QGroupBox">
<property name="name">
<cstring>colorsBox</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="frameShape">
<enum>NoFrame</enum>
</property>
<property name="title">
<string></string>
</property>
<property name="flat">
<bool>false</bool>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<widget class="QLabel" row="1" column="0">
<property name="name">
<cstring>textLabel2_2</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>1</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="frameShape">
<enum>NoFrame</enum>
</property>
<property name="text">
<string>Background color:</string>
</property>
<property name="whatsThis" stdset="0">
<string>The color of the OSD background.</string>
</property>
</widget>
<widget class="KColorButton" row="0" column="1">
<property name="name">
<cstring>kcfg_OsdTextColor</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>2</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string></string>
</property>
<property name="color">
<color>
<red>255</red>
<green>0</green>
<blue>0</blue>
</color>
</property>
<property name="toolTip" stdset="0">
<string>Click to select the color of the OSD text.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The color of the OSD text.</string>
</property>
</widget>
<widget class="KColorButton" row="1" column="1">
<property name="name">
<cstring>kcfg_OsdBackgroundColor</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>2</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string></string>
</property>
<property name="color">
<color>
<red>255</red>
<green>0</green>
<blue>0</blue>
</color>
</property>
<property name="toolTip" stdset="0">
<string>Click to select the background color of the OSD.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The color of the OSD background.</string>
</property>
</widget>
<widget class="QLabel" row="0" column="0">
<property name="name">
<cstring>textLabel2</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>1</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>Text color:</string>
</property>
<property name="whatsThis" stdset="0">
<string>The color of the OSD text.</string>
</property>
</widget>
</grid>
</widget>
</hbox>
</widget>
</vbox>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_OsdUseFakeTranslucency</cstring>
</property>
<property name="text">
<string>Make the &amp;background translucent</string>
</property>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>osdText</cstring>
</property>
<property name="frameShape">
<enum>GroupBoxPanel</enum>
</property>
<property name="title">
<string>Display &amp;Text</string>
</property>
<property name="flat">
<bool>false</bool>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_OsdUsePlaylistColumns</cstring>
</property>
<property name="text">
<string>Display the same information as the columns in the playlist</string>
</property>
</widget>
<widget class="KTextEdit">
<property name="name">
<cstring>kcfg_OsdText</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>7</hsizetype>
<vsizetype>7</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="lineWidth">
<number>2</number>
</property>
<property name="textFormat">
<enum>PlainText</enum>
</property>
<property name="tabChangesFocus">
<bool>true</bool>
</property>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>groupBox22</cstring>
</property>
<property name="title">
<string></string>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel" row="0" column="0">
<property name="name">
<cstring>textLabel1</cstring>
</property>
<property name="text">
<string>&amp;Duration:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_OsdDuration</cstring>
</property>
</widget>
<widget class="KIntSpinBox" row="0" column="1">
<property name="name">
<cstring>kcfg_OsdDuration</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>1</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>2</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="suffix">
<string> ms</string>
</property>
<property name="specialValueText">
<string>Forever</string>
</property>
<property name="buttonSymbols">
<enum>UpDownArrows</enum>
</property>
<property name="maxValue">
<number>600000</number>
</property>
<property name="minValue">
<number>0</number>
</property>
<property name="lineStep">
<number>1000</number>
</property>
<property name="value">
<number>5000</number>
</property>
<property name="toolTip" stdset="0">
<string>The time in milliseconds to show the OSD. The value must be between 500 ms and 10000 ms.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The time in milliseconds to show the OSD. The value must be between 500 ms and 10000 ms.</string>
</property>
</widget>
<widget class="KComboBox" row="0" column="3">
<property name="name">
<cstring>kcfg_OsdScreen</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>1</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>2</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="toolTip" stdset="0">
<string>The screen that should display the OSD.</string>
</property>
<property name="whatsThis" stdset="0">
<string>The screen that should display the OSD.</string>
</property>
</widget>
<widget class="QLabel" row="0" column="2">
<property name="name">
<cstring>textLabel2_3</cstring>
</property>
<property name="text">
<string>Sc&amp;reen:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_OsdScreen</cstring>
</property>
</widget>
</grid>
</widget>
</vbox>
</widget>
</hbox>
</widget>
</vbox>
</widget>
<connections>
<connection>
<sender>kcfg_OsdUseCustomColors</sender>
<signal>toggled(bool)</signal>
<receiver>colorsBox</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_OsdEnabled</sender>
<signal>toggled(bool)</signal>
<receiver>mainBox</receiver>
<slot>setEnabled(bool)</slot>
</connection>
<connection>
<sender>kcfg_OsdUseCustomColors</sender>
<signal>toggled(bool)</signal>
<receiver>Options5</receiver>
<slot>useCustomColorsToggled(bool)</slot>
</connection>
<connection>
<sender>kcfg_OsdUsePlaylistColumns</sender>
<signal>toggled(bool)</signal>
<receiver>kcfg_OsdText</receiver>
<slot>setDisabled(bool)</slot>
</connection>
</connections>
<includes>
<include location="global" impldecl="in implementation">qapplication.h</include>
<include location="global" impldecl="in implementation">qdesktopwidget.h</include>
<include location="local" impldecl="in declaration">osd.h</include>
</includes>
<variables>
<variable access="private">OSDPreviewWidget *m_pOSDPreview;</variable>
</variables>
<signals>
<signal>settingsChanged()</signal>
</signals>
<slots>
<slot access="protected">slotPositionChanged()</slot>
<slot access="protected">useCustomColorsToggled( bool on )</slot>
</slots>
<functions>
<function access="private" specifier="non virtual">init()</function>
<function access="protected">hideEvent( QHideEvent * )</function>
<function access="protected">showEvent( QShowEvent * )</function>
</functions>
<layoutdefaults spacing="6" margin="11"/>
<includehints>
<includehint>ktextedit.h</includehint>
</includehints>
</UI>

@ -0,0 +1,126 @@
/***************************************************************************
begin : 2004/02/25
copyright : (C) Frederik Holljen
email : fh@ez.no
***************************************************************************/
/***************************************************************************
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
***************************************************************************/
/****************************************************************************
** ui.h extension file, included from the uic-generated form implementation.
**
** If you wish to add, delete or rename functions or slots use
** Qt Designer which will update this file, preserving your code. Create an
** init() function in place of a constructor, and a destroy() function in
** place of a destructor.
*****************************************************************************/
#include "amarokconfig.h"
#include <klocale.h>
#include "qstringx.h"
#include <qtooltip.h>
void Options5::init()
{
m_pOSDPreview = new OSDPreviewWidget( this ); //must be child!!!
m_pOSDPreview->setAlignment( static_cast<OSDWidget::Alignment>( AmarokConfig::osdAlignment() ) );
m_pOSDPreview->setOffset( AmarokConfig::osdYOffset() );
connect( m_pOSDPreview, SIGNAL( positionChanged() ), SLOT( slotPositionChanged() ) );
const int numScreens = QApplication::desktop()->numScreens();
for( int i = 0; i < numScreens; i++ )
kcfg_OsdScreen->insertItem( QString::number( i ) );
connect( kcfg_OsdDrawShadow, SIGNAL( toggled(bool) ),
m_pOSDPreview, SLOT( setDrawShadow(bool) ) );
connect( kcfg_OsdTextColor, SIGNAL( changed(const QColor&) ),
m_pOSDPreview, SLOT( setTextColor(const QColor&) ) );
connect( kcfg_OsdUseCustomColors, SIGNAL( toggled(bool) ),
this, SLOT( useCustomColorsToggled(bool) ) );
connect( kcfg_OsdBackgroundColor, SIGNAL( changed(const QColor&) ),
m_pOSDPreview, SLOT( setBackgroundColor(const QColor&) ) );
connect( kcfg_OsdFont, SIGNAL( fontSelected(const QFont&) ),
m_pOSDPreview, SLOT( setFont(const QFont&) ) );
connect( kcfg_OsdScreen, SIGNAL( activated(int) ),
m_pOSDPreview, SLOT( setScreen(int) ) );
connect( kcfg_OsdEnabled, SIGNAL( toggled(bool) ),
m_pOSDPreview, SLOT( setShown(bool) ) );
Amarok::QStringx text = i18n(
"<h3>Tags Displayed in OSD</h3>"
"You can use the following tokens:"
"<ul>"
"<li>Title - %1"
"<li>Album - %2"
"<li>Artist - %3"
"<li>Genre - %4"
"<li>Bitrate - %5"
"<li>Year - %6"
"<li>Track Length - %7"
"<li>Track Number - %8"
"<li>Filename - %9"
"<li>Directory - %10"
"<li>Type - %11"
"<li>Comment - %12"
"<li>Score - %13"
"<li>Playcount - %14"
"<li>Disc Number - %15"
"<li>Rating - %16"
"<li>Moodbar - %17"
"<li>Elapsed Time - %18"
"</ul>"
"If you surround sections of text that contain a token with curly-braces, that section will be hidden if the token is empty, for example:"
"<pre>%19</pre>"
"Will not show <b>Score: <i>%score</i></b> if the track has no score." );
QToolTip::add( kcfg_OsdText, text.args( QStringList()
// we don't translate these, it is not sensible to do so
<< "%title" << "%album" << "%artist" << "%genre" << "%bitrate"
<< "%year " << "%length" << "%track" << "%filename" << "%directory"
<< "%type" << "%comment" << "%score" << "%playcount" << "%discnumber"
<< "%rating" << "%moodbar" << "%elapsed"
<< "%title {" + i18n( "Score: %1" ).arg( "%score" ) +'}' ) );
}
void
Options5::slotPositionChanged()
{
kcfg_OsdScreen->blockSignals( true );
kcfg_OsdScreen->setCurrentItem( m_pOSDPreview->screen() );
kcfg_OsdScreen->blockSignals( false );
// Update button states (e.g. "Apply")
emit settingsChanged();
}
void
Options5::hideEvent( QHideEvent* )
{
m_pOSDPreview->hide();
}
void
Options5::showEvent( QShowEvent* )
{
useCustomColorsToggled( kcfg_OsdUseCustomColors->isChecked() );
m_pOSDPreview->setFont( kcfg_OsdFont->font() );
m_pOSDPreview->setScreen( kcfg_OsdScreen->currentItem() );
m_pOSDPreview->setShown( kcfg_OsdEnabled->isChecked() );
}
void
Options5::useCustomColorsToggled( bool on )
{
m_pOSDPreview->setUseCustomColors( on, kcfg_OsdTextColor->color(), kcfg_OsdBackgroundColor->color() );
}

@ -0,0 +1,81 @@
<!DOCTYPE UI><UI version="3.3" stdsetdef="1">
<class>Options7</class>
<widget class="QWidget">
<property name="name">
<cstring>Options7</cstring>
</property>
<property name="geometry">
<rect>
<x>0</x>
<y>0</y>
<width>404</width>
<height>215</height>
</rect>
</property>
<property name="caption">
<string>Collection Setup</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<widget class="QGroupBox">
<property name="name">
<cstring>collectionFoldersBox</cstring>
</property>
<property name="title">
<string>Collection Folders</string>
</property>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>databaseBox</cstring>
</property>
<property name="title">
<string>Collection Database</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="DbSetup">
<property name="name">
<cstring>dbSetupFrame</cstring>
</property>
</widget>
</vbox>
</widget>
</vbox>
</widget>
<customwidgets>
<customwidget>
<class>DbSetup</class>
<header location="local">dbsetup.h</header>
<sizehint>
<width>380</width>
<height>165</height>
</sizehint>
<container>1</container>
<sizepolicy>
<hordata>3</hordata>
<verdata>3</verdata>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
<pixmap>image0</pixmap>
</customwidget>
</customwidgets>
<images>
<image name="image0">
<data format="XBM.GZ" length="79">789c534e494dcbcc4b554829cdcdad8c2fcf4c29c95030e0524611cd48cd4ccf28010a1797249664262b2467241641a592324b8aa363156c15aab914146aadb90067111b1f</data>
</image>
</images>
<layoutdefaults spacing="6" margin="11"/>
<includehints>
<includehint>klineedit.h</includehint>
<includehint>kpushbutton.h</includehint>
</includehints>
</UI>

@ -0,0 +1,305 @@
<!DOCTYPE UI><UI version="3.3" stdsetdef="1">
<class>Options8</class>
<widget class="QWidget">
<property name="name">
<cstring>Options8</cstring>
</property>
<property name="geometry">
<rect>
<x>0</x>
<y>0</y>
<width>425</width>
<height>418</height>
</rect>
</property>
<property name="minimumSize">
<size>
<width>1</width>
<height>1</height>
</size>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="margin">
<number>0</number>
</property>
<property name="spacing">
<number>12</number>
</property>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout2</cstring>
</property>
<hbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<property name="spacing">
<number>12</number>
</property>
<widget class="QLabel">
<property name="name">
<cstring>infoPixmap_2</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>4</hsizetype>
<vsizetype>1</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string></string>
</property>
<property name="alignment">
<set>AlignVCenter</set>
</property>
</widget>
<widget class="KActiveLabel">
<property name="name">
<cstring>kActiveLabel3</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>4</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="minimumSize">
<size>
<width>-1</width>
<height>-1</height>
</size>
</property>
<property name="text">
<string>Amarok can send the name of every song you play to last.fm. The system automatically matches you to people with similar musical tastes, and creates personalized recommendations. To learn more about last.fm, &lt;A href='http://www.last.fm'&gt;visit the homepage&lt;/A&gt;.</string>
</property>
</widget>
</hbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>groupBox3</cstring>
</property>
<property name="title">
<string>last.fm Profile</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="KActiveLabel">
<property name="name">
<cstring>kActiveLabel1</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>&lt;P&gt;To use last.fm with Amarok, you need a &lt;A href='http://www.last.fm:80/signup.php'&gt;last.fm profile&lt;/A&gt;.</string>
</property>
</widget>
<widget class="QLayoutWidget">
<property name="name">
<cstring>layout3</cstring>
</property>
<grid>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="KLineEdit" row="0" column="1">
<property name="name">
<cstring>kcfg_ScrobblerUsername</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>7</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
</widget>
<widget class="QLabel" row="1" column="0">
<property name="name">
<cstring>labelPassword</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>&amp;Password:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_ScrobblerPassword</cstring>
</property>
</widget>
<widget class="QLabel" row="0" column="0">
<property name="name">
<cstring>labelUsername</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>&amp;Username:</string>
</property>
<property name="buddy" stdset="0">
<cstring>kcfg_ScrobblerUsername</cstring>
</property>
</widget>
<widget class="KLineEdit" row="1" column="1">
<property name="name">
<cstring>kcfg_ScrobblerPassword</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>7</hsizetype>
<vsizetype>0</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="echoMode">
<enum>Password</enum>
</property>
</widget>
</grid>
</widget>
</vbox>
</widget>
<widget class="QGroupBox">
<property name="name">
<cstring>groupBox2</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="title">
<string>last.fm Services</string>
</property>
<vbox>
<property name="name">
<cstring>unnamed</cstring>
</property>
<widget class="QLabel">
<property name="name">
<cstring>textLabel1</cstring>
</property>
<property name="text">
<string>Once registered, Amarok can tell the last.fm service about your listening habits; your profile can then provide statistics and recommendations. A profile is not required to retrieve similar-artists for display in the Context Browser.</string>
</property>
<property name="textFormat">
<enum>RichText</enum>
</property>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_SubmitPlayedSongs</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>7</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>Improve m&amp;y profile by submitting the tracks I play</string>
</property>
</widget>
<widget class="QCheckBox">
<property name="name">
<cstring>kcfg_RetrieveSimilarArtists</cstring>
</property>
<property name="enabled">
<bool>false</bool>
</property>
<property name="text">
<string>&amp;Retrieve similar artists</string>
</property>
</widget>
</vbox>
</widget>
<widget class="KActiveLabel">
<property name="name">
<cstring>kActiveLabel2</cstring>
</property>
<property name="sizePolicy">
<sizepolicy>
<hsizetype>5</hsizetype>
<vsizetype>5</vsizetype>
<horstretch>0</horstretch>
<verstretch>0</verstretch>
</sizepolicy>
</property>
<property name="text">
<string>Why not join the &lt;A href='http://www.last.fm:80/group/Amarok+Users'&gt;Amarok last.fm group&lt;/A&gt; and share your musical tastes with other Amarok users?</string>
</property>
</widget>
<spacer>
<property name="name">
<cstring>spacer4</cstring>
</property>
<property name="orientation">
<enum>Vertical</enum>
</property>
<property name="sizeType">
<enum>Expanding</enum>
</property>
<property name="sizeHint">
<size>
<width>20</width>
<height>30</height>
</size>
</property>
</spacer>
</vbox>
</widget>
<connections>
<connection>
<sender>kcfg_ScrobblerUsername</sender>
<signal>textChanged(const QString&amp;)</signal>
<receiver>Options8</receiver>
<slot>updateServices(const QString&amp;)</slot>
</connection>
</connections>
<includes>
<include location="local" impldecl="in implementation">Options8.ui.h</include>
</includes>
<slots>
<slot access="protected">updateServices( const QString &amp; s )</slot>
</slots>
<layoutdefaults spacing="6" margin="11"/>
<includehints>
<includehint>kactivelabel.h</includehint>
<includehint>kactivelabel.h</includehint>
<includehint>klineedit.h</includehint>
<includehint>klineedit.h</includehint>
<includehint>kactivelabel.h</includehint>
</includehints>
</UI>

@ -0,0 +1,22 @@
// (c) 2006 Seb Ruiz <me@sebruiz.net>
/****************************************************************************
** ui.h extension file, included from the uic-generated form implementation.
**
** If you want to add, delete, or rename functions or slots, use
** Qt Designer to update this file, preserving your code.
**
** You should not define a constructor or destructor in this file.
** Instead, write your code in functions called init() and destroy().
** These will automatically be called by the form's constructor and
** destructor.
*****************************************************************************/
void Options8::updateServices( const QString &s )
{
bool empty = s.isEmpty();
groupBox2->setEnabled( !empty );
kcfg_SubmitPlayedSongs->setEnabled( !empty );
kcfg_RetrieveSimilarArtists->setEnabled( !empty );
}

@ -0,0 +1,665 @@
// Maintainer: Max Howell <max.howell@methylblue.com>, (C) 2004
// Copyright: See COPYING file that comes with this distribution
#include "config.h" //HAVE_LIBVISUAL definition
#include "actionclasses.h"
#include "amarok.h"
#include "amarokconfig.h"
#include "app.h"
#include "debug.h"
#include "collectiondb.h"
#include "covermanager.h"
#include "enginecontroller.h"
#include "k3bexporter.h"
#include "mediumpluginmanager.h"
#include "playlistwindow.h"
#include "playlist.h"
#include "socketserver.h" //Vis::Selector::showInstance()
#include "threadmanager.h"
#include <qpixmap.h>
#include <qtooltip.h>
#include <kaction.h>
#include <khelpmenu.h>
#include <kiconloader.h>
#include <klocale.h>
#include <kstandarddirs.h>
#include <ktoolbar.h>
#include <ktoolbarbutton.h>
#include <kurl.h>
namespace Amarok
{
bool repeatNone() { return AmarokConfig::repeat() == AmarokConfig::EnumRepeat::Off; }
bool repeatTrack() { return AmarokConfig::repeat() == AmarokConfig::EnumRepeat::Track; }
bool repeatAlbum() { return AmarokConfig::repeat() == AmarokConfig::EnumRepeat::Album; }
bool repeatPlaylist() { return AmarokConfig::repeat() == AmarokConfig::EnumRepeat::Playlist; }
bool randomOff() { return AmarokConfig::randomMode() == AmarokConfig::EnumRandomMode::Off; }
bool randomTracks() { return AmarokConfig::randomMode() == AmarokConfig::EnumRandomMode::Tracks; }
bool randomAlbums() { return AmarokConfig::randomMode() == AmarokConfig::EnumRandomMode::Albums; }
bool favorNone() { return AmarokConfig::favorTracks() == AmarokConfig::EnumFavorTracks::Off; }
bool favorScores() { return AmarokConfig::favorTracks() == AmarokConfig::EnumFavorTracks::HigherScores; }
bool favorRatings() { return AmarokConfig::favorTracks() == AmarokConfig::EnumFavorTracks::HigherRatings; }
bool favorLastPlay() { return AmarokConfig::favorTracks() == AmarokConfig::EnumFavorTracks::LessRecentlyPlayed; }
bool entireAlbums() { return repeatAlbum() || randomAlbums(); }
}
using namespace Amarok;
KHelpMenu *Menu::s_helpMenu = 0;
static void
safePlug( KActionCollection *ac, const char *name, QWidget *w )
{
if( ac )
{
KAction *a = ac->action( name );
if( a ) a->plug( w );
}
}
//////////////////////////////////////////////////////////////////////////////////////////
// MenuAction && Menu
// KActionMenu doesn't work very well, so we derived our own
//////////////////////////////////////////////////////////////////////////////////////////
MenuAction::MenuAction( KActionCollection *ac )
: KAction( i18n( "Amarok Menu" ), 0, ac, "amarok_menu" )
{
setShortcutConfigurable ( false ); //FIXME disabled as it doesn't work, should use QCursor::pos()
}
int
MenuAction::plug( QWidget *w, int index )
{
KToolBar *bar = dynamic_cast<KToolBar*>(w);
if( bar && kapp->authorizeKAction( name() ) )
{
const int id = KAction::getToolButtonID();
addContainer( bar, id );
connect( bar, SIGNAL( destroyed() ), SLOT( slotDestroyed() ) );
//TODO create menu on demand
//TODO create menu above and aligned within window
//TODO make the arrow point upwards!
bar->insertButton( QString::null, id, true, i18n( "Menu" ), index );
bar->alignItemRight( id );
KToolBarButton* button = bar->getButton( id );
button->setPopup( Amarok::Menu::instance() );
button->setName( "toolbutton_amarok_menu" );
button->setIcon( "amarok" );
return containerCount() - 1;
}
else return -1;
}
Menu::Menu()
{
KActionCollection *ac = Amarok::actionCollection();
setCheckable( true );
safePlug( ac, "repeat", this );
safePlug( ac, "random_mode", this );
insertSeparator();
safePlug( ac, "playlist_playmedia", this );
safePlug( ac, "play_audiocd", this );
safePlug( ac, "lastfm_play", this );
insertSeparator();
insertItem( SmallIconSet( Amarok::icon( "covermanager" ) ), i18n( "C&over Manager" ), ID_SHOW_COVER_MANAGER );
safePlug( ac, "queue_manager", this );
insertItem( SmallIconSet( Amarok::icon( "visualizations" ) ), i18n( "&Visualizations" ), ID_SHOW_VIS_SELECTOR );
insertItem( SmallIconSet( Amarok::icon( "equalizer" ) ), i18n( "E&qualizer" ), kapp, SLOT( slotConfigEqualizer() ), 0, ID_CONFIGURE_EQUALIZER );
safePlug( ac, "script_manager", this );
safePlug( ac, "statistics", this );
insertSeparator();
safePlug( ac, "update_collection", this );
insertItem( SmallIconSet( Amarok::icon( "rescan" ) ), i18n("&Rescan Collection"), ID_RESCAN_COLLECTION );
setItemEnabled( ID_RESCAN_COLLECTION, !ThreadManager::instance()->isJobPending( "CollectionScanner" ) );
#ifndef Q_WS_MAC
insertSeparator();
safePlug( ac, KStdAction::name(KStdAction::ShowMenubar), this );
#endif
insertSeparator();