Added KGo to playground/games and integrated into build-system.
svn path=/trunk/playground/games/kgo/; revision=836659
This commit is contained in:
commit
2ecdeb9296
50 changed files with 6813 additions and 0 deletions
1
AUTHORS
Normal file
1
AUTHORS
Normal file
|
@ -0,0 +1 @@
|
|||
Sascha Peilicke <sasch.pe@gmx.de>
|
17
CMakeLists.txt
Normal file
17
CMakeLists.txt
Normal file
|
@ -0,0 +1,17 @@
|
|||
project(kgo)
|
||||
|
||||
set(CMAKE_BUILD_TYPE Debug)
|
||||
#set(CMAKE_BUILD_TYPE Release)
|
||||
|
||||
find_package(KDE4 REQUIRED)
|
||||
include_directories(${KDE4_INCLUDES})
|
||||
include(KDE4Defaults)
|
||||
#include(GGZ)
|
||||
|
||||
add_subdirectory(src)
|
||||
|
||||
add_subdirectory(icons)
|
||||
add_subdirectory(themes)
|
||||
add_subdirectory(games)
|
||||
add_subdirectory(sounds)
|
||||
add_subdirectory(docs)
|
675
COPYING
Normal file
675
COPYING
Normal file
|
@ -0,0 +1,675 @@
|
|||
GNU GENERAL PUBLIC LICENSE
|
||||
Version 3, 29 June 2007
|
||||
|
||||
Copyright (C) 2007 Free Software Foundation, Inc. <http://fsf.org/>
|
||||
Everyone is permitted to copy and distribute verbatim copies
|
||||
of this license document, but changing it is not allowed.
|
||||
|
||||
Preamble
|
||||
|
||||
The GNU General Public License is a free, copyleft license for
|
||||
software and other kinds of works.
|
||||
|
||||
The licenses for most software and other practical works are designed
|
||||
to take away your freedom to share and change the works. By contrast,
|
||||
the GNU General Public License is intended to guarantee your freedom to
|
||||
share and change all versions of a program--to make sure it remains free
|
||||
software for all its users. We, the Free Software Foundation, use the
|
||||
GNU General Public License for most of our software; it applies also to
|
||||
any other work released this way by its authors. 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
|
||||
them 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 prevent others from denying you
|
||||
these rights or asking you to surrender the rights. Therefore, you have
|
||||
certain responsibilities if you distribute copies of the software, or if
|
||||
you modify it: responsibilities to respect the freedom of others.
|
||||
|
||||
For example, if you distribute copies of such a program, whether
|
||||
gratis or for a fee, you must pass on to the recipients the same
|
||||
freedoms that you received. 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.
|
||||
|
||||
Developers that use the GNU GPL protect your rights with two steps:
|
||||
(1) assert copyright on the software, and (2) offer you this License
|
||||
giving you legal permission to copy, distribute and/or modify it.
|
||||
|
||||
For the developers' and authors' protection, the GPL clearly explains
|
||||
that there is no warranty for this free software. For both users' and
|
||||
authors' sake, the GPL requires that modified versions be marked as
|
||||
changed, so that their problems will not be attributed erroneously to
|
||||
authors of previous versions.
|
||||
|
||||
Some devices are designed to deny users access to install or run
|
||||
modified versions of the software inside them, although the manufacturer
|
||||
can do so. This is fundamentally incompatible with the aim of
|
||||
protecting users' freedom to change the software. The systematic
|
||||
pattern of such abuse occurs in the area of products for individuals to
|
||||
use, which is precisely where it is most unacceptable. Therefore, we
|
||||
have designed this version of the GPL to prohibit the practice for those
|
||||
products. If such problems arise substantially in other domains, we
|
||||
stand ready to extend this provision to those domains in future versions
|
||||
of the GPL, as needed to protect the freedom of users.
|
||||
|
||||
Finally, every program is threatened constantly by software patents.
|
||||
States should not allow patents to restrict development and use of
|
||||
software on general-purpose computers, but in those that do, we wish to
|
||||
avoid the special danger that patents applied to a free program could
|
||||
make it effectively proprietary. To prevent this, the GPL assures that
|
||||
patents cannot be used to render the program non-free.
|
||||
|
||||
The precise terms and conditions for copying, distribution and
|
||||
modification follow.
|
||||
|
||||
TERMS AND CONDITIONS
|
||||
|
||||
0. Definitions.
|
||||
|
||||
"This License" refers to version 3 of the GNU General Public License.
|
||||
|
||||
"Copyright" also means copyright-like laws that apply to other kinds of
|
||||
works, such as semiconductor masks.
|
||||
|
||||
"The Program" refers to any copyrightable work licensed under this
|
||||
License. Each licensee is addressed as "you". "Licensees" and
|
||||
"recipients" may be individuals or organizations.
|
||||
|
||||
To "modify" a work means to copy from or adapt all or part of the work
|
||||
in a fashion requiring copyright permission, other than the making of an
|
||||
exact copy. The resulting work is called a "modified version" of the
|
||||
earlier work or a work "based on" the earlier work.
|
||||
|
||||
A "covered work" means either the unmodified Program or a work based
|
||||
on the Program.
|
||||
|
||||
To "propagate" a work means to do anything with it that, without
|
||||
permission, would make you directly or secondarily liable for
|
||||
infringement under applicable copyright law, except executing it on a
|
||||
computer or modifying a private copy. Propagation includes copying,
|
||||
distribution (with or without modification), making available to the
|
||||
public, and in some countries other activities as well.
|
||||
|
||||
To "convey" a work means any kind of propagation that enables other
|
||||
parties to make or receive copies. Mere interaction with a user through
|
||||
a computer network, with no transfer of a copy, is not conveying.
|
||||
|
||||
An interactive user interface displays "Appropriate Legal Notices"
|
||||
to the extent that it includes a convenient and prominently visible
|
||||
feature that (1) displays an appropriate copyright notice, and (2)
|
||||
tells the user that there is no warranty for the work (except to the
|
||||
extent that warranties are provided), that licensees may convey the
|
||||
work under this License, and how to view a copy of this License. If
|
||||
the interface presents a list of user commands or options, such as a
|
||||
menu, a prominent item in the list meets this criterion.
|
||||
|
||||
1. Source Code.
|
||||
|
||||
The "source code" for a work means the preferred form of the work
|
||||
for making modifications to it. "Object code" means any non-source
|
||||
form of a work.
|
||||
|
||||
A "Standard Interface" means an interface that either is an official
|
||||
standard defined by a recognized standards body, or, in the case of
|
||||
interfaces specified for a particular programming language, one that
|
||||
is widely used among developers working in that language.
|
||||
|
||||
The "System Libraries" of an executable work include anything, other
|
||||
than the work as a whole, that (a) is included in the normal form of
|
||||
packaging a Major Component, but which is not part of that Major
|
||||
Component, and (b) serves only to enable use of the work with that
|
||||
Major Component, or to implement a Standard Interface for which an
|
||||
implementation is available to the public in source code form. A
|
||||
"Major Component", in this context, means a major essential component
|
||||
(kernel, window system, and so on) of the specific operating system
|
||||
(if any) on which the executable work runs, or a compiler used to
|
||||
produce the work, or an object code interpreter used to run it.
|
||||
|
||||
The "Corresponding Source" for a work in object code form means all
|
||||
the source code needed to generate, install, and (for an executable
|
||||
work) run the object code and to modify the work, including scripts to
|
||||
control those activities. However, it does not include the work's
|
||||
System Libraries, or general-purpose tools or generally available free
|
||||
programs which are used unmodified in performing those activities but
|
||||
which are not part of the work. For example, Corresponding Source
|
||||
includes interface definition files associated with source files for
|
||||
the work, and the source code for shared libraries and dynamically
|
||||
linked subprograms that the work is specifically designed to require,
|
||||
such as by intimate data communication or control flow between those
|
||||
subprograms and other parts of the work.
|
||||
|
||||
The Corresponding Source need not include anything that users
|
||||
can regenerate automatically from other parts of the Corresponding
|
||||
Source.
|
||||
|
||||
The Corresponding Source for a work in source code form is that
|
||||
same work.
|
||||
|
||||
2. Basic Permissions.
|
||||
|
||||
All rights granted under this License are granted for the term of
|
||||
copyright on the Program, and are irrevocable provided the stated
|
||||
conditions are met. This License explicitly affirms your unlimited
|
||||
permission to run the unmodified Program. The output from running a
|
||||
covered work is covered by this License only if the output, given its
|
||||
content, constitutes a covered work. This License acknowledges your
|
||||
rights of fair use or other equivalent, as provided by copyright law.
|
||||
|
||||
You may make, run and propagate covered works that you do not
|
||||
convey, without conditions so long as your license otherwise remains
|
||||
in force. You may convey covered works to others for the sole purpose
|
||||
of having them make modifications exclusively for you, or provide you
|
||||
with facilities for running those works, provided that you comply with
|
||||
the terms of this License in conveying all material for which you do
|
||||
not control copyright. Those thus making or running the covered works
|
||||
for you must do so exclusively on your behalf, under your direction
|
||||
and control, on terms that prohibit them from making any copies of
|
||||
your copyrighted material outside their relationship with you.
|
||||
|
||||
Conveying under any other circumstances is permitted solely under
|
||||
the conditions stated below. Sublicensing is not allowed; section 10
|
||||
makes it unnecessary.
|
||||
|
||||
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
|
||||
|
||||
No covered work shall be deemed part of an effective technological
|
||||
measure under any applicable law fulfilling obligations under article
|
||||
11 of the WIPO copyright treaty adopted on 20 December 1996, or
|
||||
similar laws prohibiting or restricting circumvention of such
|
||||
measures.
|
||||
|
||||
When you convey a covered work, you waive any legal power to forbid
|
||||
circumvention of technological measures to the extent such circumvention
|
||||
is effected by exercising rights under this License with respect to
|
||||
the covered work, and you disclaim any intention to limit operation or
|
||||
modification of the work as a means of enforcing, against the work's
|
||||
users, your or third parties' legal rights to forbid circumvention of
|
||||
technological measures.
|
||||
|
||||
4. Conveying Verbatim Copies.
|
||||
|
||||
You may convey 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;
|
||||
keep intact all notices stating that this License and any
|
||||
non-permissive terms added in accord with section 7 apply to the code;
|
||||
keep intact all notices of the absence of any warranty; and give all
|
||||
recipients a copy of this License along with the Program.
|
||||
|
||||
You may charge any price or no price for each copy that you convey,
|
||||
and you may offer support or warranty protection for a fee.
|
||||
|
||||
5. Conveying Modified Source Versions.
|
||||
|
||||
You may convey a work based on the Program, or the modifications to
|
||||
produce it from the Program, in the form of source code under the
|
||||
terms of section 4, provided that you also meet all of these conditions:
|
||||
|
||||
a) The work must carry prominent notices stating that you modified
|
||||
it, and giving a relevant date.
|
||||
|
||||
b) The work must carry prominent notices stating that it is
|
||||
released under this License and any conditions added under section
|
||||
7. This requirement modifies the requirement in section 4 to
|
||||
"keep intact all notices".
|
||||
|
||||
c) You must license the entire work, as a whole, under this
|
||||
License to anyone who comes into possession of a copy. This
|
||||
License will therefore apply, along with any applicable section 7
|
||||
additional terms, to the whole of the work, and all its parts,
|
||||
regardless of how they are packaged. This License gives no
|
||||
permission to license the work in any other way, but it does not
|
||||
invalidate such permission if you have separately received it.
|
||||
|
||||
d) If the work has interactive user interfaces, each must display
|
||||
Appropriate Legal Notices; however, if the Program has interactive
|
||||
interfaces that do not display Appropriate Legal Notices, your
|
||||
work need not make them do so.
|
||||
|
||||
A compilation of a covered work with other separate and independent
|
||||
works, which are not by their nature extensions of the covered work,
|
||||
and which are not combined with it such as to form a larger program,
|
||||
in or on a volume of a storage or distribution medium, is called an
|
||||
"aggregate" if the compilation and its resulting copyright are not
|
||||
used to limit the access or legal rights of the compilation's users
|
||||
beyond what the individual works permit. Inclusion of a covered work
|
||||
in an aggregate does not cause this License to apply to the other
|
||||
parts of the aggregate.
|
||||
|
||||
6. Conveying Non-Source Forms.
|
||||
|
||||
You may convey a covered work in object code form under the terms
|
||||
of sections 4 and 5, provided that you also convey the
|
||||
machine-readable Corresponding Source under the terms of this License,
|
||||
in one of these ways:
|
||||
|
||||
a) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by the
|
||||
Corresponding Source fixed on a durable physical medium
|
||||
customarily used for software interchange.
|
||||
|
||||
b) Convey the object code in, or embodied in, a physical product
|
||||
(including a physical distribution medium), accompanied by a
|
||||
written offer, valid for at least three years and valid for as
|
||||
long as you offer spare parts or customer support for that product
|
||||
model, to give anyone who possesses the object code either (1) a
|
||||
copy of the Corresponding Source for all the software in the
|
||||
product that is covered by this License, on a durable physical
|
||||
medium customarily used for software interchange, for a price no
|
||||
more than your reasonable cost of physically performing this
|
||||
conveying of source, or (2) access to copy the
|
||||
Corresponding Source from a network server at no charge.
|
||||
|
||||
c) Convey individual copies of the object code with a copy of the
|
||||
written offer to provide the Corresponding Source. This
|
||||
alternative is allowed only occasionally and noncommercially, and
|
||||
only if you received the object code with such an offer, in accord
|
||||
with subsection 6b.
|
||||
|
||||
d) Convey the object code by offering access from a designated
|
||||
place (gratis or for a charge), and offer equivalent access to the
|
||||
Corresponding Source in the same way through the same place at no
|
||||
further charge. You need not require recipients to copy the
|
||||
Corresponding Source along with the object code. If the place to
|
||||
copy the object code is a network server, the Corresponding Source
|
||||
may be on a different server (operated by you or a third party)
|
||||
that supports equivalent copying facilities, provided you maintain
|
||||
clear directions next to the object code saying where to find the
|
||||
Corresponding Source. Regardless of what server hosts the
|
||||
Corresponding Source, you remain obligated to ensure that it is
|
||||
available for as long as needed to satisfy these requirements.
|
||||
|
||||
e) Convey the object code using peer-to-peer transmission, provided
|
||||
you inform other peers where the object code and Corresponding
|
||||
Source of the work are being offered to the general public at no
|
||||
charge under subsection 6d.
|
||||
|
||||
A separable portion of the object code, whose source code is excluded
|
||||
from the Corresponding Source as a System Library, need not be
|
||||
included in conveying the object code work.
|
||||
|
||||
A "User Product" is either (1) a "consumer product", which means any
|
||||
tangible personal property which is normally used for personal, family,
|
||||
or household purposes, or (2) anything designed or sold for incorporation
|
||||
into a dwelling. In determining whether a product is a consumer product,
|
||||
doubtful cases shall be resolved in favor of coverage. For a particular
|
||||
product received by a particular user, "normally used" refers to a
|
||||
typical or common use of that class of product, regardless of the status
|
||||
of the particular user or of the way in which the particular user
|
||||
actually uses, or expects or is expected to use, the product. A product
|
||||
is a consumer product regardless of whether the product has substantial
|
||||
commercial, industrial or non-consumer uses, unless such uses represent
|
||||
the only significant mode of use of the product.
|
||||
|
||||
"Installation Information" for a User Product means any methods,
|
||||
procedures, authorization keys, or other information required to install
|
||||
and execute modified versions of a covered work in that User Product from
|
||||
a modified version of its Corresponding Source. The information must
|
||||
suffice to ensure that the continued functioning of the modified object
|
||||
code is in no case prevented or interfered with solely because
|
||||
modification has been made.
|
||||
|
||||
If you convey an object code work under this section in, or with, or
|
||||
specifically for use in, a User Product, and the conveying occurs as
|
||||
part of a transaction in which the right of possession and use of the
|
||||
User Product is transferred to the recipient in perpetuity or for a
|
||||
fixed term (regardless of how the transaction is characterized), the
|
||||
Corresponding Source conveyed under this section must be accompanied
|
||||
by the Installation Information. But this requirement does not apply
|
||||
if neither you nor any third party retains the ability to install
|
||||
modified object code on the User Product (for example, the work has
|
||||
been installed in ROM).
|
||||
|
||||
The requirement to provide Installation Information does not include a
|
||||
requirement to continue to provide support service, warranty, or updates
|
||||
for a work that has been modified or installed by the recipient, or for
|
||||
the User Product in which it has been modified or installed. Access to a
|
||||
network may be denied when the modification itself materially and
|
||||
adversely affects the operation of the network or violates the rules and
|
||||
protocols for communication across the network.
|
||||
|
||||
Corresponding Source conveyed, and Installation Information provided,
|
||||
in accord with this section must be in a format that is publicly
|
||||
documented (and with an implementation available to the public in
|
||||
source code form), and must require no special password or key for
|
||||
unpacking, reading or copying.
|
||||
|
||||
7. Additional Terms.
|
||||
|
||||
"Additional permissions" are terms that supplement the terms of this
|
||||
License by making exceptions from one or more of its conditions.
|
||||
Additional permissions that are applicable to the entire Program shall
|
||||
be treated as though they were included in this License, to the extent
|
||||
that they are valid under applicable law. If additional permissions
|
||||
apply only to part of the Program, that part may be used separately
|
||||
under those permissions, but the entire Program remains governed by
|
||||
this License without regard to the additional permissions.
|
||||
|
||||
When you convey a copy of a covered work, you may at your option
|
||||
remove any additional permissions from that copy, or from any part of
|
||||
it. (Additional permissions may be written to require their own
|
||||
removal in certain cases when you modify the work.) You may place
|
||||
additional permissions on material, added by you to a covered work,
|
||||
for which you have or can give appropriate copyright permission.
|
||||
|
||||
Notwithstanding any other provision of this License, for material you
|
||||
add to a covered work, you may (if authorized by the copyright holders of
|
||||
that material) supplement the terms of this License with terms:
|
||||
|
||||
a) Disclaiming warranty or limiting liability differently from the
|
||||
terms of sections 15 and 16 of this License; or
|
||||
|
||||
b) Requiring preservation of specified reasonable legal notices or
|
||||
author attributions in that material or in the Appropriate Legal
|
||||
Notices displayed by works containing it; or
|
||||
|
||||
c) Prohibiting misrepresentation of the origin of that material, or
|
||||
requiring that modified versions of such material be marked in
|
||||
reasonable ways as different from the original version; or
|
||||
|
||||
d) Limiting the use for publicity purposes of names of licensors or
|
||||
authors of the material; or
|
||||
|
||||
e) Declining to grant rights under trademark law for use of some
|
||||
trade names, trademarks, or service marks; or
|
||||
|
||||
f) Requiring indemnification of licensors and authors of that
|
||||
material by anyone who conveys the material (or modified versions of
|
||||
it) with contractual assumptions of liability to the recipient, for
|
||||
any liability that these contractual assumptions directly impose on
|
||||
those licensors and authors.
|
||||
|
||||
All other non-permissive additional terms are considered "further
|
||||
restrictions" within the meaning of section 10. If the Program as you
|
||||
received it, or any part of it, contains a notice stating that it is
|
||||
governed by this License along with a term that is a further
|
||||
restriction, you may remove that term. If a license document contains
|
||||
a further restriction but permits relicensing or conveying under this
|
||||
License, you may add to a covered work material governed by the terms
|
||||
of that license document, provided that the further restriction does
|
||||
not survive such relicensing or conveying.
|
||||
|
||||
If you add terms to a covered work in accord with this section, you
|
||||
must place, in the relevant source files, a statement of the
|
||||
additional terms that apply to those files, or a notice indicating
|
||||
where to find the applicable terms.
|
||||
|
||||
Additional terms, permissive or non-permissive, may be stated in the
|
||||
form of a separately written license, or stated as exceptions;
|
||||
the above requirements apply either way.
|
||||
|
||||
8. Termination.
|
||||
|
||||
You may not propagate or modify a covered work except as expressly
|
||||
provided under this License. Any attempt otherwise to propagate or
|
||||
modify it is void, and will automatically terminate your rights under
|
||||
this License (including any patent licenses granted under the third
|
||||
paragraph of section 11).
|
||||
|
||||
However, if you cease all violation of this License, then your
|
||||
license from a particular copyright holder is reinstated (a)
|
||||
provisionally, unless and until the copyright holder explicitly and
|
||||
finally terminates your license, and (b) permanently, if the copyright
|
||||
holder fails to notify you of the violation by some reasonable means
|
||||
prior to 60 days after the cessation.
|
||||
|
||||
Moreover, your license from a particular copyright holder is
|
||||
reinstated permanently if the copyright holder notifies you of the
|
||||
violation by some reasonable means, this is the first time you have
|
||||
received notice of violation of this License (for any work) from that
|
||||
copyright holder, and you cure the violation prior to 30 days after
|
||||
your receipt of the notice.
|
||||
|
||||
Termination of your rights under this section does not terminate the
|
||||
licenses of parties who have received copies or rights from you under
|
||||
this License. If your rights have been terminated and not permanently
|
||||
reinstated, you do not qualify to receive new licenses for the same
|
||||
material under section 10.
|
||||
|
||||
9. Acceptance Not Required for Having Copies.
|
||||
|
||||
You are not required to accept this License in order to receive or
|
||||
run a copy of the Program. Ancillary propagation of a covered work
|
||||
occurring solely as a consequence of using peer-to-peer transmission
|
||||
to receive a copy likewise does not require acceptance. However,
|
||||
nothing other than this License grants you permission to propagate or
|
||||
modify any covered work. These actions infringe copyright if you do
|
||||
not accept this License. Therefore, by modifying or propagating a
|
||||
covered work, you indicate your acceptance of this License to do so.
|
||||
|
||||
10. Automatic Licensing of Downstream Recipients.
|
||||
|
||||
Each time you convey a covered work, the recipient automatically
|
||||
receives a license from the original licensors, to run, modify and
|
||||
propagate that work, subject to this License. You are not responsible
|
||||
for enforcing compliance by third parties with this License.
|
||||
|
||||
An "entity transaction" is a transaction transferring control of an
|
||||
organization, or substantially all assets of one, or subdividing an
|
||||
organization, or merging organizations. If propagation of a covered
|
||||
work results from an entity transaction, each party to that
|
||||
transaction who receives a copy of the work also receives whatever
|
||||
licenses to the work the party's predecessor in interest had or could
|
||||
give under the previous paragraph, plus a right to possession of the
|
||||
Corresponding Source of the work from the predecessor in interest, if
|
||||
the predecessor has it or can get it with reasonable efforts.
|
||||
|
||||
You may not impose any further restrictions on the exercise of the
|
||||
rights granted or affirmed under this License. For example, you may
|
||||
not impose a license fee, royalty, or other charge for exercise of
|
||||
rights granted under this License, and you may not initiate litigation
|
||||
(including a cross-claim or counterclaim in a lawsuit) alleging that
|
||||
any patent claim is infringed by making, using, selling, offering for
|
||||
sale, or importing the Program or any portion of it.
|
||||
|
||||
11. Patents.
|
||||
|
||||
A "contributor" is a copyright holder who authorizes use under this
|
||||
License of the Program or a work on which the Program is based. The
|
||||
work thus licensed is called the contributor's "contributor version".
|
||||
|
||||
A contributor's "essential patent claims" are all patent claims
|
||||
owned or controlled by the contributor, whether already acquired or
|
||||
hereafter acquired, that would be infringed by some manner, permitted
|
||||
by this License, of making, using, or selling its contributor version,
|
||||
but do not include claims that would be infringed only as a
|
||||
consequence of further modification of the contributor version. For
|
||||
purposes of this definition, "control" includes the right to grant
|
||||
patent sublicenses in a manner consistent with the requirements of
|
||||
this License.
|
||||
|
||||
Each contributor grants you a non-exclusive, worldwide, royalty-free
|
||||
patent license under the contributor's essential patent claims, to
|
||||
make, use, sell, offer for sale, import and otherwise run, modify and
|
||||
propagate the contents of its contributor version.
|
||||
|
||||
In the following three paragraphs, a "patent license" is any express
|
||||
agreement or commitment, however denominated, not to enforce a patent
|
||||
(such as an express permission to practice a patent or covenant not to
|
||||
sue for patent infringement). To "grant" such a patent license to a
|
||||
party means to make such an agreement or commitment not to enforce a
|
||||
patent against the party.
|
||||
|
||||
If you convey a covered work, knowingly relying on a patent license,
|
||||
and the Corresponding Source of the work is not available for anyone
|
||||
to copy, free of charge and under the terms of this License, through a
|
||||
publicly available network server or other readily accessible means,
|
||||
then you must either (1) cause the Corresponding Source to be so
|
||||
available, or (2) arrange to deprive yourself of the benefit of the
|
||||
patent license for this particular work, or (3) arrange, in a manner
|
||||
consistent with the requirements of this License, to extend the patent
|
||||
license to downstream recipients. "Knowingly relying" means you have
|
||||
actual knowledge that, but for the patent license, your conveying the
|
||||
covered work in a country, or your recipient's use of the covered work
|
||||
in a country, would infringe one or more identifiable patents in that
|
||||
country that you have reason to believe are valid.
|
||||
|
||||
If, pursuant to or in connection with a single transaction or
|
||||
arrangement, you convey, or propagate by procuring conveyance of, a
|
||||
covered work, and grant a patent license to some of the parties
|
||||
receiving the covered work authorizing them to use, propagate, modify
|
||||
or convey a specific copy of the covered work, then the patent license
|
||||
you grant is automatically extended to all recipients of the covered
|
||||
work and works based on it.
|
||||
|
||||
A patent license is "discriminatory" if it does not include within
|
||||
the scope of its coverage, prohibits the exercise of, or is
|
||||
conditioned on the non-exercise of one or more of the rights that are
|
||||
specifically granted under this License. You may not convey a covered
|
||||
work if you are a party to an arrangement with a third party that is
|
||||
in the business of distributing software, under which you make payment
|
||||
to the third party based on the extent of your activity of conveying
|
||||
the work, and under which the third party grants, to any of the
|
||||
parties who would receive the covered work from you, a discriminatory
|
||||
patent license (a) in connection with copies of the covered work
|
||||
conveyed by you (or copies made from those copies), or (b) primarily
|
||||
for and in connection with specific products or compilations that
|
||||
contain the covered work, unless you entered into that arrangement,
|
||||
or that patent license was granted, prior to 28 March 2007.
|
||||
|
||||
Nothing in this License shall be construed as excluding or limiting
|
||||
any implied license or other defenses to infringement that may
|
||||
otherwise be available to you under applicable patent law.
|
||||
|
||||
12. No Surrender of Others' Freedom.
|
||||
|
||||
If 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 convey a
|
||||
covered work so as to satisfy simultaneously your obligations under this
|
||||
License and any other pertinent obligations, then as a consequence you may
|
||||
not convey it at all. For example, if you agree to terms that obligate you
|
||||
to collect a royalty for further conveying from those to whom you convey
|
||||
the Program, the only way you could satisfy both those terms and this
|
||||
License would be to refrain entirely from conveying the Program.
|
||||
|
||||
13. Use with the GNU Affero General Public License.
|
||||
|
||||
Notwithstanding any other provision of this License, you have
|
||||
permission to link or combine any covered work with a work licensed
|
||||
under version 3 of the GNU Affero General Public License into a single
|
||||
combined work, and to convey the resulting work. The terms of this
|
||||
License will continue to apply to the part which is the covered work,
|
||||
but the special requirements of the GNU Affero General Public License,
|
||||
section 13, concerning interaction through a network will apply to the
|
||||
combination as such.
|
||||
|
||||
14. Revised Versions of this License.
|
||||
|
||||
The Free Software Foundation may publish revised and/or new versions of
|
||||
the GNU 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 that a certain numbered version of the GNU General
|
||||
Public License "or any later version" applies to it, you have the
|
||||
option of following the terms and conditions either of that numbered
|
||||
version or of any later version published by the Free Software
|
||||
Foundation. If the Program does not specify a version number of the
|
||||
GNU General Public License, you may choose any version ever published
|
||||
by the Free Software Foundation.
|
||||
|
||||
If the Program specifies that a proxy can decide which future
|
||||
versions of the GNU General Public License can be used, that proxy's
|
||||
public statement of acceptance of a version permanently authorizes you
|
||||
to choose that version for the Program.
|
||||
|
||||
Later license versions may give you additional or different
|
||||
permissions. However, no additional obligations are imposed on any
|
||||
author or copyright holder as a result of your choosing to follow a
|
||||
later version.
|
||||
|
||||
15. Disclaimer of Warranty.
|
||||
|
||||
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.
|
||||
|
||||
16. Limitation of Liability.
|
||||
|
||||
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
|
||||
WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
|
||||
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.
|
||||
|
||||
17. Interpretation of Sections 15 and 16.
|
||||
|
||||
If the disclaimer of warranty and limitation of liability provided
|
||||
above cannot be given local legal effect according to their terms,
|
||||
reviewing courts shall apply local law that most closely approximates
|
||||
an absolute waiver of all civil liability in connection with the
|
||||
Program, unless a warranty or assumption of liability accompanies a
|
||||
copy of the Program in return for a fee.
|
||||
|
||||
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
|
||||
state 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 3 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, see <http://www.gnu.org/licenses/>.
|
||||
|
||||
Also add information on how to contact you by electronic and paper mail.
|
||||
|
||||
If the program does terminal interaction, make it output a short
|
||||
notice like this when it starts in an interactive mode:
|
||||
|
||||
<program> Copyright (C) <year> <name of author>
|
||||
This program 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, your program's commands
|
||||
might be different; for a GUI interface, you would use an "about box".
|
||||
|
||||
You should also get your employer (if you work as a programmer) or school,
|
||||
if any, to sign a "copyright disclaimer" for the program, if necessary.
|
||||
For more information on this, and how to apply and follow the GNU GPL, see
|
||||
<http://www.gnu.org/licenses/>.
|
||||
|
||||
The GNU 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 Lesser General
|
||||
Public License instead of this License. But first, please read
|
||||
<http://www.gnu.org/philosophy/why-not-lgpl.html>.
|
||||
|
3
ChangeLog
Normal file
3
ChangeLog
Normal file
|
@ -0,0 +1,3 @@
|
|||
0.1 : First release
|
||||
|
||||
|
8
TODO
Normal file
8
TODO
Normal file
|
@ -0,0 +1,8 @@
|
|||
* Ship further go board themes (two should be enough to show)
|
||||
|
||||
* Add move controls to toolbar instead of Undo/Redo:
|
||||
First Move | Previous Move | Next Move | Last Move
|
||||
|
||||
* Add multiplayer support via GGZ and traditional Go servers
|
||||
|
||||
* Implement the Demo mode
|
1
docs/CMakeLists.txt
Normal file
1
docs/CMakeLists.txt
Normal file
|
@ -0,0 +1 @@
|
|||
kde4_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en)
|
489
docs/index.docbook
Normal file
489
docs/index.docbook
Normal file
|
@ -0,0 +1,489 @@
|
|||
<?xml version="1.0" ?>
|
||||
<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [
|
||||
<!-- Define an entity for your application if it is not part of KDE
|
||||
CVS -->
|
||||
<!ENTITY kgo "KGo">
|
||||
<!ENTITY package "kdegames"><!-- kdebase, kdeadmin, etc. Leave
|
||||
this unchanged if your
|
||||
application is not maintained in KDE CVS -->
|
||||
<!ENTITY % addindex "IGNORE">
|
||||
<!ENTITY % English "INCLUDE">
|
||||
]>
|
||||
<!-- ................................................................ -->
|
||||
|
||||
<book lang="&language;">
|
||||
<bookinfo>
|
||||
<title>The &kgo; Handbook</title>
|
||||
|
||||
<authorgroup>
|
||||
<author>
|
||||
<firstname></firstname>
|
||||
<surname>Sascha Peilicke</surname>
|
||||
<affiliation>
|
||||
<address>sasch.pe@gmx.de</address>
|
||||
</affiliation>
|
||||
</author>
|
||||
<!-- TRANS:ROLES_OF_TRANSLATORS -->
|
||||
</authorgroup>
|
||||
|
||||
<copyright>
|
||||
<year>2008-04-15</year>
|
||||
<holder>Sascha Peilicke</holder>
|
||||
</copyright>
|
||||
|
||||
<!--<legalnotice>&FDLNotice;</legalnotice>-->
|
||||
|
||||
<date>2008-04-15</date>
|
||||
<releaseinfo>0.1</releaseinfo>
|
||||
|
||||
<abstract>
|
||||
<para>KGo is an open-source implementation of the popular Go game (also known as Weiqi).</para>
|
||||
</abstract>
|
||||
<keywordset>
|
||||
<keyword>KDE</keyword>
|
||||
<keyword>&kgo;</keyword>
|
||||
</keywordset>
|
||||
</bookinfo>
|
||||
|
||||
<!-- The contents of the documentation begin here. Label
|
||||
each chapter so with the id attribute. This is necessary for two reasons: it
|
||||
allows you to easily reference the chapter from other chapters of your
|
||||
document, and if there is no ID, the name of the generated HTML files will vary
|
||||
from time to time making it hard to manage for maintainers and for the CVS
|
||||
system. Any chapter labelled (OPTIONAL) may be left out at the author's
|
||||
discretion. Other chapters should not be left out in order to maintain a
|
||||
consistent documentation style across all KDE apps. -->
|
||||
|
||||
<chapter id="introduction">
|
||||
<title>Introduction</title>
|
||||
<para>
|
||||
&kgo; is a program that lets you do absolutely nothing. Please report
|
||||
any problems or feature requests to the &kde; mailing lists.
|
||||
</para>
|
||||
<!-- The introduction chapter contains a brief introduction for the
|
||||
application that explains what it does and where to report
|
||||
problems. Basically a long version of the abstract. Don't include a
|
||||
revision history. (see installation appendix comment) -->
|
||||
</chapter>
|
||||
|
||||
<chapter id="using-kapp">
|
||||
<title>Using &kgo;</title>
|
||||
|
||||
<!-- This chapter should tell the user how to use your app. You should use as
|
||||
many sections (Chapter, Sect1, Sect3, etc...) as is necessary to fully document
|
||||
your application. -->
|
||||
|
||||
<para>
|
||||
|
||||
<!-- Note that all graphics should be in .png format. Use no gifs because of
|
||||
patent issues. -->
|
||||
|
||||
<screenshot>
|
||||
<screeninfo>Here's a screenshot of &kgo;</screeninfo>
|
||||
<mediaobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="screenshot.png" format="PNG"/>
|
||||
</imageobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="screenshot.eps" format="EPS"/>
|
||||
</imageobject>
|
||||
<textobject>
|
||||
<phrase>Screenshot</phrase>
|
||||
</textobject>
|
||||
</mediaobject>
|
||||
</screenshot>
|
||||
</para>
|
||||
|
||||
|
||||
<sect1 id="kapp-features">
|
||||
<title>More &kgo; features</title>
|
||||
|
||||
<para>It slices! It dices! and it comes with a free toaster!</para>
|
||||
<para>
|
||||
The Squiggle Tool <guiicon><inlinemediaobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="squiggle.png" format="PNG"/>
|
||||
</imageobject>
|
||||
<imageobject>
|
||||
<imagedata fileref="squiggle.eps" format="EPS"/>
|
||||
</imageobject>
|
||||
<textobject>
|
||||
<phrase>Squiggle</phrase>
|
||||
</textobject>
|
||||
</inlinemediaobject></guiicon> is used to draw squiggly lines all over
|
||||
the &kgo; main window. It's not a bug, it's a feature!
|
||||
</para>
|
||||
|
||||
</sect1>
|
||||
</chapter>
|
||||
|
||||
<chapter id="commands">
|
||||
<title>Command Reference</title>
|
||||
|
||||
<!-- (OPTIONAL, BUT RECOMMENDED) This chapter should list all of the
|
||||
application windows and their menubar and toolbar commands for easy reference.
|
||||
Also include any keys that have a special function but have no equivalent in the
|
||||
menus or toolbars. This may not be necessary for small apps or apps with no tool
|
||||
or menu bars. -->
|
||||
|
||||
<sect1 id="kapp-mainwindow">
|
||||
<title>The main &kgo; window</title>
|
||||
|
||||
<sect2>
|
||||
<title>The File Menu</title>
|
||||
<para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><menuchoice>
|
||||
<shortcut>
|
||||
<keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo>
|
||||
</shortcut>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>New</guimenuitem>
|
||||
</menuchoice></term>
|
||||
<listitem><para><action>Creates a new document</action></para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><menuchoice>
|
||||
<shortcut>
|
||||
<keycombo action="simul">&Ctrl;<keycap>S</keycap></keycombo>
|
||||
</shortcut>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Save</guimenuitem>
|
||||
</menuchoice></term>
|
||||
<listitem><para><action>Saves the document</action></para></listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><menuchoice>
|
||||
<shortcut>
|
||||
<keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo>
|
||||
</shortcut>
|
||||
<guimenu>File</guimenu>
|
||||
<guimenuitem>Quit</guimenuitem>
|
||||
</menuchoice></term>
|
||||
<listitem><para><action>Quits</action> &kgo;</para></listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2>
|
||||
<title>The <guimenu>Help</guimenu> Menu</title>
|
||||
|
||||
<!-- Assuming you have a standard help menu (help, what's this, about -->
|
||||
<!-- &kmyapplication;, about KDE) then the documentation is already written. -->
|
||||
<!-- The following entity is valid anywhere that a variablelist is -->
|
||||
<!-- valid. -->
|
||||
|
||||
&help.menu.documentation;
|
||||
|
||||
</sect2>
|
||||
|
||||
</sect1>
|
||||
</chapter>
|
||||
<chapter id="developers">
|
||||
<title>Developer's Guide to &kgo;</title>
|
||||
|
||||
<!-- (OPTIONAL) A Programming/Scripting reference chapter should be
|
||||
used for apps that use plugins or that provide their own scripting hooks
|
||||
and/or development libraries. -->
|
||||
|
||||
<para>
|
||||
Programming &kgo; plugins is a joy to behold. Just read through the next
|
||||
66 pages of API's to learn how!
|
||||
</para>
|
||||
|
||||
<!-- Use refentries to describe APIs. Refentries are fairly complicated and you
|
||||
should consult the docbook reference for further details. The example below was
|
||||
taken from that reference and shortened a bit for readability. -->
|
||||
|
||||
<refentry id="re-1007-unmanagechildren-1">
|
||||
<refmeta>
|
||||
<refentrytitle>XtUnmanageChildren</refentrytitle>
|
||||
<refmiscinfo>Xt - Geometry Management</refmiscinfo>
|
||||
</refmeta>
|
||||
<refnamediv>
|
||||
<refname>XtUnmanageChildren
|
||||
</refname>
|
||||
<refpurpose>remove a list of children from a parent widget's managed
|
||||
list.
|
||||
<indexterm id="ix-1007-unmanagechildren-1"><primary>widgets</primary><secondary>removing</secondary></indexterm>
|
||||
<indexterm id="ix-1007-unmanagechildren-2"><primary>XtUnmanageChildren</primary></indexterm>
|
||||
</refpurpose>
|
||||
|
||||
</refnamediv>
|
||||
<refsynopsisdiv>
|
||||
<refsynopsisdivinfo>
|
||||
<date>4 March 1996</date>
|
||||
</refsynopsisdivinfo>
|
||||
<synopsis>
|
||||
void XtUnmanageChildren(<replaceable class="parameter">children</replaceable>, <replaceable class="parameter">num_children</replaceable>)
|
||||
WidgetList <replaceable class="parameter">children</replaceable>;
|
||||
Cardinal <replaceable class="parameter">num_children</replaceable>;
|
||||
</synopsis>
|
||||
|
||||
<refsect2 id="r2-1007-unmanagechildren-1">
|
||||
<title>Inputs</title>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term><replaceable class="parameter">children</replaceable>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>Specifies an array of child widgets. Each child must be of
|
||||
class RectObj or any subclass thereof.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term><replaceable class="parameter">num_children</replaceable>
|
||||
</term>
|
||||
<listitem>
|
||||
<para>Specifies the number of elements in <replaceable class="parameter">children</replaceable>.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
</refsect2></refsynopsisdiv>
|
||||
|
||||
<refsect1 id="r1-1007-unmanagechildren-1">
|
||||
<title>Description
|
||||
</title>
|
||||
<para><function>XtUnmanageChildren()</function> unmaps the specified widgets
|
||||
and removes them from their parent's geometry management.
|
||||
The widgets will disappear from the screen, and (depending
|
||||
on its parent) may no longer have screen space allocated for
|
||||
them.
|
||||
</para>
|
||||
<para>Each of the widgets in the <replaceable class="parameter">children</replaceable> array must have
|
||||
the same parent.
|
||||
</para>
|
||||
<para>See the “Algorithm” section below for full details of the
|
||||
widget unmanagement procedure.
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 id="r1-1007-unmanagechildren-2">
|
||||
<title>Usage</title>
|
||||
<para>Unmanaging widgets is the usual method for temporarily
|
||||
making them invisible. They can be re-managed with
|
||||
<function>XtManageChildren()</function>.
|
||||
</para>
|
||||
<para>You can unmap a widget, but leave it under geometry
|
||||
management by calling <function>XtUnmapWidget()</function>. You can
|
||||
destroy a widget's window without destroying the widget by
|
||||
calling <function>XtUnrealizeWidget()</function>. You can destroy a
|
||||
widget completely with <function>XtDestroyWidget()</function>.
|
||||
</para>
|
||||
<para>If you are only going to unmanage a single widget, it is
|
||||
more convenient to call <function>XtUnmanageChild()</function>. It is
|
||||
often more convenient to call <function>XtUnmanageChild()</function>
|
||||
several times than it is to declare and initialize an array
|
||||
of widgets to pass to <function>XtUnmanageChildren()</function>. Calling
|
||||
<function>XtUnmanageChildren()</function> is more efficient, however,
|
||||
because it only calls the parent's <function>change_managed()</function>
|
||||
method once.
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 id="r1-1007-unmanagechildren-3">
|
||||
<title>Algorithm
|
||||
</title>
|
||||
<para><function>XtUnmanageChildren()</function> performs the following:
|
||||
</para>
|
||||
<variablelist>
|
||||
<varlistentry>
|
||||
<term>-
|
||||
</term>
|
||||
<listitem>
|
||||
<para>Ignores the child if it already is unmanaged or is being
|
||||
destroyed.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry>
|
||||
<term>-
|
||||
</term>
|
||||
<listitem>
|
||||
<para>Otherwise, if the child is realized, it makes it nonvisible
|
||||
by unmapping it.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
<para>
|
||||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1 id="r1-1007-unmanagechildren-4">
|
||||
<title>Structures</title>
|
||||
<para>The <type>WidgetList</type> type is simply an array of widgets:
|
||||
</para>
|
||||
<screen id="sc-1007-unmanagechildren-1">typedef Widget *WidgetList;
|
||||
</screen>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
|
||||
</chapter>
|
||||
|
||||
<chapter id="faq">
|
||||
<title>Questions and Answers</title>
|
||||
|
||||
<!-- (OPTIONAL but recommended) This chapter should include all of the silly
|
||||
(and not-so-silly) newbie questions that fill up your mailbox. This chapter
|
||||
should be reserved for BRIEF questions and answers! If one question uses more
|
||||
than a page or so then it should probably be part of the
|
||||
"Using this Application" chapter instead. You should use links to
|
||||
cross-reference questions to the parts of your documentation that answer them.
|
||||
This is also a great place to provide pointers to other FAQ's if your users
|
||||
must do some complicated configuration on other programs in order for your
|
||||
application work. -->
|
||||
|
||||
&reporting.bugs;
|
||||
&updating.documentation;
|
||||
|
||||
<qandaset id="faqlist">
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>My Mouse doesn't work. How do I quit &kgo;?</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>You silly goose! Check out the <link linkend="commands">Commands
|
||||
Section</link> for the answer.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
<qandaentry>
|
||||
<question>
|
||||
<para>Why can't I twiddle my documents?</para>
|
||||
</question>
|
||||
<answer>
|
||||
<para>You can only twiddle your documents if you have the foobar.lib
|
||||
installed.</para>
|
||||
</answer>
|
||||
</qandaentry>
|
||||
</qandaset>
|
||||
</chapter>
|
||||
|
||||
<chapter id="credits">
|
||||
|
||||
<!-- Include credits for the programmers, documentation writers, and
|
||||
contributors here. The license for your software should then be included below
|
||||
the credits with a reference to the appropriate license file included in the KDE
|
||||
distribution. -->
|
||||
|
||||
<title>Credits and License</title>
|
||||
|
||||
<para>
|
||||
&kgo;
|
||||
</para>
|
||||
<para>
|
||||
Program copyright 2007 Sascha Peilicke <email>sasch.pe@gmx.de</email>
|
||||
</para>
|
||||
<para>
|
||||
Contributors:
|
||||
<itemizedlist>
|
||||
<listitem><para>Konqui the KDE Dragon <email>konqui@kde.org</email></para>
|
||||
</listitem>
|
||||
<listitem><para>Tux the Linux Penguin <email>tux@linux.org</email></para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Documentation Copyright © 2007 Sascha Peilicke <email>sasch.pe@gmx.de</email>
|
||||
</para>
|
||||
|
||||
<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
|
||||
|
||||
&underFDL; <!-- FDL: do not remove -->
|
||||
|
||||
<!-- Determine which license your application is licensed under,
|
||||
and delete all the remaining licenses below:
|
||||
|
||||
(NOTE: All documentation are licensed under the FDL,
|
||||
regardless of what license the application uses) -->
|
||||
|
||||
&underGPL; <!-- GPL License -->
|
||||
|
||||
</chapter>
|
||||
|
||||
<appendix id="installation">
|
||||
<title>Installation</title>
|
||||
|
||||
<sect1 id="getting-kapp">
|
||||
<title>How to obtain &kgo;</title>
|
||||
|
||||
<!-- This first entity contains boiler plate for applications that are
|
||||
part of KDE CVS. You should remove it if you are releasing your
|
||||
application -->
|
||||
|
||||
&install.intro.documentation;
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="requirements">
|
||||
<title>Requirements</title>
|
||||
|
||||
<!--
|
||||
List any special requirements for your application here. This should include:
|
||||
.Libraries or other software that is not included in kdesupport,
|
||||
kdelibs, or kdebase.
|
||||
.Hardware requirements like amount of RAM, disk space, graphics card
|
||||
capabilities, screen resolution, special expansion cards, etc.
|
||||
.Operating systems the app will run on. If your app is designed only for a
|
||||
specific OS, (you wrote a graphical LILO configurator for example) put this
|
||||
information here.
|
||||
-->
|
||||
|
||||
<para>
|
||||
In order to successfully use &kgo;, you need &kde; 1.1. Foobar.lib is
|
||||
required in order to support the advanced &kgo; features. &kgo; uses
|
||||
about 5 megs of memory to run, but this may vary depending on your
|
||||
platform and configuration.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
All required libraries as well as kgo; itself can be found
|
||||
on <ulink url="ftp://ftp.kapp.org">The &kgo; home page</ulink>.
|
||||
</para>
|
||||
|
||||
<!-- For a list of updates, you may refer to the application web site
|
||||
or the ChangeLog file, or ... -->
|
||||
<para>
|
||||
You can find a list of changes at <ulink
|
||||
url="http://apps.kde.org/kapp">http://apps.kde.org/kapp</ulink>.
|
||||
</para>
|
||||
</sect1>
|
||||
|
||||
<sect1 id="compilation">
|
||||
<title>Compilation and Installation</title>
|
||||
|
||||
<!-- This entity contains the boilerplate text for standard -->
|
||||
<!-- compilation instructions. If your application requires any -->
|
||||
<!-- special handling, remove it, and replace with your own text. -->
|
||||
|
||||
&install.compile.documentation;
|
||||
|
||||
</sect1>
|
||||
|
||||
<sect1 id="configuration">
|
||||
<title>Configuration</title>
|
||||
|
||||
<para>Don't forget to tell your system to start the <filename>dtd</filename>
|
||||
dicer-toaster daemon first, or &kgo; won't work !</para>
|
||||
|
||||
</sect1>
|
||||
|
||||
</appendix>
|
||||
|
||||
&documentation.index;
|
||||
</book>
|
||||
<!--
|
||||
Local Variables:
|
||||
mode: sgml
|
||||
sgml-omittag: nil
|
||||
sgml-shorttag: t
|
||||
sgml-general-insert-case: lower
|
||||
End:
|
||||
-->
|
||||
|
3
games/CMakeLists.txt
Normal file
3
games/CMakeLists.txt
Normal file
|
@ -0,0 +1,3 @@
|
|||
install(FILES
|
||||
kgo_default_games.zip
|
||||
DESTINATION ${DATA_INSTALL_DIR}/kgo/games)
|
BIN
games/kgo_default_games.zip
Normal file
BIN
games/kgo_default_games.zip
Normal file
Binary file not shown.
1
icons/CMakeLists.txt
Normal file
1
icons/CMakeLists.txt
Normal file
|
@ -0,0 +1 @@
|
|||
kde4_install_icons(${ICON_INSTALL_DIR})
|
BIN
icons/hi128-app-kgo.png
Normal file
BIN
icons/hi128-app-kgo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 11 KiB |
BIN
icons/hi16-app-kgo.png
Normal file
BIN
icons/hi16-app-kgo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 859 B |
BIN
icons/hi22-app-kgo.png
Normal file
BIN
icons/hi22-app-kgo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 3.8 KiB |
BIN
icons/hi32-app-kgo.png
Normal file
BIN
icons/hi32-app-kgo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 2.2 KiB |
BIN
icons/hi48-app-kgo.png
Normal file
BIN
icons/hi48-app-kgo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 3.3 KiB |
BIN
icons/hi64-app-kgo.png
Normal file
BIN
icons/hi64-app-kgo.png
Normal file
Binary file not shown.
After Width: | Height: | Size: 4.4 KiB |
2
sounds/CMakeLists.txt
Normal file
2
sounds/CMakeLists.txt
Normal file
|
@ -0,0 +1,2 @@
|
|||
install(FILES kgo.notifyrc DESTINATION ${DATA_INSTALL_DIR}/kgo)
|
||||
#install(FILES kgo-click.wav kgo-won.wav DESTINATION ${DATA_INSTALL_DIR}/kgo/sounds)
|
0
sounds/kgo.notifyrc
Normal file
0
sounds/kgo.notifyrc
Normal file
30
src/CMakeLists.txt
Normal file
30
src/CMakeLists.txt
Normal file
|
@ -0,0 +1,30 @@
|
|||
set(kgo_SRCS
|
||||
game/gtp.cpp
|
||||
gui/config.cpp
|
||||
gui/themerenderer.cpp
|
||||
gui/gamescene.cpp
|
||||
gui/gameview.cpp
|
||||
gui/gamescreen.cpp
|
||||
gui/setupscreen.cpp
|
||||
gui/mainwindow.cpp
|
||||
main.cpp
|
||||
)
|
||||
|
||||
kde4_add_ui_files(kgo_SRCS
|
||||
gui/config.ui
|
||||
gui/gamescreen.ui
|
||||
gui/setupscreen.ui
|
||||
)
|
||||
kde4_add_kcfg_files(kgo_SRCS preferences.kcfgc)
|
||||
kde4_add_app_icon(kgo_SRCS "${CMAKE_CURRENT_SOURCE_DIR}/../icons/hi*-app-kgo.png")
|
||||
kde4_add_executable(kgo ${kgo_SRCS})
|
||||
|
||||
target_link_libraries(kgo ${KDE4_KDEUI_LIBS} kdegames ${KDE_KNEWSTUFF2_LIBS} ${KGGZGAMES_LIBS})
|
||||
|
||||
install(TARGETS kgo DESTINATION ${BIN_INSTALL_DIR})
|
||||
install(FILES gui/kgo.desktop DESTINATION ${XDG_APPS_INSTALL_DIR})
|
||||
install(FILES gui/kgoui.rc DESTINATION ${DATA_INSTALL_DIR}/kgo)
|
||||
install(FILES kgo.kcfg DESTINATION ${KCFG_INSTALL_DIR})
|
||||
install(FILES kgo.knsrc DESTINATION ${CONFIG_INSTALL_DIR})
|
||||
|
||||
#register_ggz_module(module.dsc)
|
12
src/Mainpage.dox
Normal file
12
src/Mainpage.dox
Normal file
|
@ -0,0 +1,12 @@
|
|||
/** @mainpage KGo API Reference
|
||||
|
||||
KGo is an open-source implementation of the popular Go game written specifically for KDE.
|
||||
|
||||
@authors
|
||||
Sascha Peilicke <sasch.pe@gmx.de>
|
||||
|
||||
Released under the terms of the GNU General Public license version 3
|
||||
*/
|
||||
|
||||
// DOXYGEN_NAME=kgo
|
||||
// DOXYGEN_ENABLE=yes
|
921
src/game/gtp.cpp
Normal file
921
src/game/gtp.cpp
Normal file
|
@ -0,0 +1,921 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and implements the classes Gtp, Gtp::Stone
|
||||
* and Gtp::Score, which together implement a Go Text Protocol (GTP)
|
||||
* interface to communicate with Go engines supporting GTP protocol
|
||||
* version 2.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#include "gtp.h"
|
||||
|
||||
#include <QFile>
|
||||
#include <QApplication>
|
||||
|
||||
#include <KDebug>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
Gtp::Stone::Stone(const QString &stone)
|
||||
: m_x(stone[0].toLatin1())
|
||||
, m_y(stone.mid(1).toInt())
|
||||
{
|
||||
}
|
||||
|
||||
bool Gtp::Stone::isValid() const
|
||||
{
|
||||
if (m_y >= 1 && m_y <= 19 && ((m_x >= 'a' && m_x < 't') || (m_x >= 'A' && m_x <= 'T')))
|
||||
return true;
|
||||
else
|
||||
return false;
|
||||
}
|
||||
|
||||
QByteArray Gtp::Stone::toLatin1() const
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append(m_x);
|
||||
msg.append(m_y);
|
||||
return msg;
|
||||
}
|
||||
|
||||
QString Gtp::Stone::toString() const
|
||||
{
|
||||
return QString("%1%2").arg(m_x).arg(m_y);
|
||||
}
|
||||
|
||||
Gtp::Score::Score(const QString &scoreString)
|
||||
{
|
||||
if (scoreString[0] == 'W')
|
||||
m_player = PlayerWhite;
|
||||
else
|
||||
m_player = PlayerBlack;
|
||||
int i = scoreString.indexOf(' ');
|
||||
m_score = scoreString.mid(2, i - 1).toInt();
|
||||
//m_upperBound = scoreString.mid(
|
||||
//TODO: Implement Score class, the bounds should be considered optional and can
|
||||
// be the same as the score if none given
|
||||
}
|
||||
|
||||
bool Gtp::Score::isValid() const
|
||||
{
|
||||
return m_score >= 0 ? true : false;
|
||||
}
|
||||
|
||||
QString Gtp::Score::toString() const
|
||||
{
|
||||
return QString("%1+%2 (upper bound: %3, lower: %4").arg(m_player == PlayerWhite ? "W" : "B").arg(m_score).arg(m_upperBound).arg(m_lowerBound);
|
||||
}
|
||||
|
||||
////////////////////////////////////////////////////////////////////
|
||||
|
||||
Gtp::Gtp()
|
||||
{
|
||||
connect(&m_process, SIGNAL(readyReadStandardOutput()), this, SLOT(readStandardOutput()));
|
||||
connect(&m_process, SIGNAL(readyReadStandardError()), this, SLOT(readStandardError()));
|
||||
connect(&m_process, SIGNAL(error(QProcess::ProcessError)), SIGNAL(error(QProcess::ProcessError)));
|
||||
}
|
||||
|
||||
Gtp::~Gtp()
|
||||
{
|
||||
quit();
|
||||
}
|
||||
|
||||
bool Gtp::openSession(const QString &command)
|
||||
{
|
||||
quit(); // Close old session if there's one
|
||||
m_process.start(command.toLatin1()); // Start new process with provided command
|
||||
|
||||
if (!m_process.waitForStarted()) // NOTE: Blocking wait for process start
|
||||
return false;
|
||||
|
||||
if (protocolVersion()) {
|
||||
clearBoard(); // Start with blank board
|
||||
} else {
|
||||
quit();
|
||||
m_response = "Protocol version error";
|
||||
return false;
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
void Gtp::quit()
|
||||
{
|
||||
if (m_process.isOpen()) {
|
||||
m_process.write("quit\n");
|
||||
m_process.close();
|
||||
}
|
||||
}
|
||||
|
||||
bool Gtp::loadSgf(const QString &fileName, int moveNumber)
|
||||
{
|
||||
Q_ASSERT(moveNumber >= 0);
|
||||
if (fileName.isEmpty() || !QFile::exists(fileName))
|
||||
return false;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("loadsgf ");
|
||||
msg.append(fileName.toLatin1());
|
||||
msg.append(" ");
|
||||
msg.append(moveNumber);
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::saveSgf(const QString &fileName)
|
||||
{
|
||||
if (fileName.isEmpty())
|
||||
return false;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("printsgf ");
|
||||
msg.append(fileName.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
QString Gtp::name()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("name\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
int Gtp::protocolVersion()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("protocol_version\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return -1;
|
||||
}
|
||||
|
||||
QString Gtp::version()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("version\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
bool Gtp::setBoardSize(int size)
|
||||
{
|
||||
Q_ASSERT(size >= 1 && size <= 19);
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("boardsize ");
|
||||
msg.append(size);
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
int Gtp::boardSize()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("query_boardsize\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return -1;
|
||||
}
|
||||
|
||||
bool Gtp::clearBoard()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("clear_board\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::setKomi(float komi)
|
||||
{
|
||||
Q_ASSERT(komi >= 0);
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("komi ");
|
||||
msg.append(komi);
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::setLevel(int level)
|
||||
{
|
||||
Q_ASSERT(level >= 1 && level <= 10);
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("level ");
|
||||
msg.append(level);
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::setFixedHandicap(int handicap)
|
||||
{
|
||||
Q_ASSERT(handicap >= 0 && handicap <= 9);
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("fixed_handicap ");
|
||||
msg.append(handicap);
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::playMove(PlayerColor color, const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return false;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("play ");
|
||||
if (color == PlayerWhite)
|
||||
msg.append("white ");
|
||||
else
|
||||
msg.append("black ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::passMove(PlayerColor color)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("play ");
|
||||
if (color == PlayerWhite)
|
||||
msg.append("white ");
|
||||
else
|
||||
msg.append("black ");
|
||||
msg.append("pass\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::generateMove(PlayerColor color)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("genmove ");
|
||||
if(color == PlayerWhite)
|
||||
msg.append("white\n");
|
||||
else
|
||||
msg.append("black\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::undoMove(int i)
|
||||
{
|
||||
Q_ASSERT(i >= 0);
|
||||
QByteArray msg;
|
||||
msg.append("undo ");
|
||||
msg.append(i);
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::tryMove(PlayerColor color, const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return false;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("trymove ");
|
||||
if (color == PlayerWhite)
|
||||
msg.append("white ");
|
||||
else
|
||||
msg.append("black ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::popGo()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("popgo\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
Gtp::FieldStatus Gtp::whatColor(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return FieldInvalid;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("color ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse()) {
|
||||
if (m_response == "white") return FieldWhite;
|
||||
else if (m_response == "black") return FieldBlack;
|
||||
else if (m_response == "empty") return FieldEmpty;
|
||||
else return FieldInvalid;
|
||||
} else
|
||||
return FieldInvalid;
|
||||
}
|
||||
|
||||
int Gtp::countLiberties(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return -1;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("countlib ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return -1;
|
||||
}
|
||||
|
||||
QList<Gtp::Stone> Gtp::findLiberties(const Stone &field)
|
||||
{
|
||||
QList<Gtp::Stone> list;
|
||||
if (!field.isValid())
|
||||
return list;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("findlib ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
waitResponse();
|
||||
|
||||
foreach (QString entry, m_response.split(' '))
|
||||
list.append(Gtp::Stone(entry));
|
||||
return list;
|
||||
}
|
||||
|
||||
bool Gtp::isLegal(PlayerColor color, const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return false;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("is_legal ");
|
||||
if (color == PlayerWhite)
|
||||
msg.append("white ");
|
||||
else
|
||||
msg.append("black ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
waitResponse();
|
||||
if (m_response == "1")
|
||||
return true;
|
||||
else
|
||||
return false;
|
||||
}
|
||||
|
||||
QString Gtp::topMoves(PlayerColor color)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("top_moves_");
|
||||
if (color == PlayerWhite)
|
||||
msg.append("white\n");
|
||||
else
|
||||
msg.append("black\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
QList<Gtp::Stone> Gtp::legalMoves(PlayerColor color)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("all_legal ");
|
||||
if (color == PlayerWhite)
|
||||
msg.append("white\n");
|
||||
else
|
||||
msg.append("black\n");
|
||||
m_process.write(msg);
|
||||
waitResponse();
|
||||
|
||||
QList<Gtp::Stone> list;
|
||||
foreach (QString entry, m_response.split(' '))
|
||||
list.append(Gtp::Stone(entry));
|
||||
return list;
|
||||
}
|
||||
|
||||
int Gtp::captures(PlayerColor color)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("captures ");
|
||||
if (color == PlayerWhite)
|
||||
msg.append("white\n");
|
||||
else
|
||||
msg.append("black\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return 0;
|
||||
}
|
||||
|
||||
QString Gtp::attack(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return QString();
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("attack ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
QString Gtp::defend(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return QString();
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("defend ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
bool Gtp::increaseDepths()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("increase_depths\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::decreaseDepths()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("decrease_depths\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
QString Gtp::owlAttack(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return QString();
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("owl_attack ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
QString Gtp::owlDefense(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return QString();
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("owl_defend ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
QString Gtp::evalEye(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return QString();
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("eval_eye ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
Gtp::DragonStatus Gtp::dragonStatus(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return DragonInvalid;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("dragon_status ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse()) {
|
||||
if (m_response == "alive") return DragonAlive;
|
||||
else if (m_response == "critical") return DragonCritical;
|
||||
else if (m_response == "dead") return DragonDead;
|
||||
else if (m_response == "unknown") return DragonUnknown;
|
||||
else return DragonInvalid; /* should never happen */
|
||||
} else
|
||||
return DragonInvalid;
|
||||
}
|
||||
|
||||
bool Gtp::sameDragon(const Stone &field1, const Stone &field2)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("same_dragon ");
|
||||
msg.append(field1.toLatin1());
|
||||
msg.append(" ");
|
||||
msg.append(field2.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse() && m_response == "1")
|
||||
return true;
|
||||
else
|
||||
return false;
|
||||
}
|
||||
|
||||
QString Gtp::dragonData(const Stone &field)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("dragon_data ");
|
||||
if (field.isValid())
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
Gtp::FinalState Gtp::finalStatus(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return StateInvalid;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("final_status ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse()) {
|
||||
if (m_response == "alive") return Alive;
|
||||
else if (m_response == "dead") return Dead;
|
||||
else if (m_response == "seki") return Seki;
|
||||
else if (m_response == "white_territory") return WhiteTerritory;
|
||||
else if (m_response == "blacK_territory") return BlackTerritory;
|
||||
else if (m_response == "dame") return Dame;
|
||||
else return StateInvalid;
|
||||
} else
|
||||
return StateInvalid;
|
||||
}
|
||||
|
||||
QList<Gtp::Stone> Gtp::finalStatusList(FinalState state)
|
||||
{
|
||||
QList<Stone> list;
|
||||
if (state == StateInvalid)
|
||||
return list;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("final_status_list ");
|
||||
switch (state) {
|
||||
case Alive: msg.append("alive"); break;
|
||||
case Dead: msg.append("dead"); break;
|
||||
case Seki: msg.append("seki"); break;
|
||||
case WhiteTerritory: msg.append("white_territory"); break;
|
||||
case BlackTerritory: msg.append("black_territory"); break;
|
||||
case Dame: msg.append("dame"); break;
|
||||
case StateInvalid: /* Will never happen */ break;
|
||||
}
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse()) {
|
||||
foreach (QString entry, m_response.split(' '))
|
||||
list.append(Stone(entry));
|
||||
}
|
||||
return list;
|
||||
}
|
||||
|
||||
Gtp::Score Gtp::finalScore()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("final_score\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return Score(m_response);
|
||||
else
|
||||
return Score();
|
||||
}
|
||||
|
||||
Gtp::Score Gtp::estimateScore()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("estimate_score\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return Score(m_response);
|
||||
else
|
||||
return Score();
|
||||
}
|
||||
|
||||
int Gtp::getLifeNodeCounter()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("get_life_node_counter\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return -1;
|
||||
}
|
||||
|
||||
bool Gtp::resetLifeNodeCounter()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("reset_life_node_counter\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
int Gtp::getOwlNodeCounter()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("get_owl_node_counter\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return -1;
|
||||
}
|
||||
|
||||
bool Gtp::resetOwlNodeCounter()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("reset_owl_node_counter\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
int Gtp::getReadingNodeCounter()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("get_reading_node_counter\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return -1;
|
||||
}
|
||||
|
||||
bool Gtp::resetReadingNodeCounter()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("reset_reading_node_counter\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
int Gtp::getTryMoveCounter()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("get_trymove_counter\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return -1;
|
||||
}
|
||||
|
||||
bool Gtp::resetTryMoveCounter()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("reset_trymove_counter\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::showBoard()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("showboard\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
bool Gtp::dumpStack()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("dump_stack\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
int Gtp::wormCutStone(const Stone &field)
|
||||
{
|
||||
if (!field.isValid())
|
||||
return -1;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("worm_cutstone ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response.toInt();
|
||||
else
|
||||
return -1;
|
||||
}
|
||||
|
||||
QString Gtp::wormData(const Stone &field)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("worm_data ");
|
||||
if (field.isValid())
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
QList<Gtp::Stone> Gtp::wormStones(const Stone &field)
|
||||
{
|
||||
QList<Stone> list;
|
||||
if (!field.isValid())
|
||||
return list;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("worm_stones ");
|
||||
msg.append(field.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse()) {
|
||||
foreach (QString entry, m_response.split(' '))
|
||||
list.append(Stone(entry));
|
||||
}
|
||||
return list;
|
||||
}
|
||||
|
||||
bool Gtp::tuneMoveOrdering(int parameters)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("tune_move_ordering ");
|
||||
msg.append(parameters);
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
QList<QString> Gtp::help()
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("help\n");
|
||||
m_process.write(msg);
|
||||
QList<QString> list;
|
||||
if (waitResponse()) {
|
||||
foreach (QString entry, m_response.split('\n'))
|
||||
list.append(entry);
|
||||
}
|
||||
return list;
|
||||
}
|
||||
|
||||
bool Gtp::reportUncertainty(bool enabled)
|
||||
{
|
||||
QByteArray msg;
|
||||
msg.append("report_uncertainty ");
|
||||
msg.append(enabled ? "on" : "off");
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
QString Gtp::shell(const QString &command)
|
||||
{
|
||||
if (command.isEmpty())
|
||||
return QString();
|
||||
|
||||
QByteArray msg;
|
||||
msg.append(command.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
bool Gtp::knownCommand(const QString &command)
|
||||
{
|
||||
if (command.isEmpty())
|
||||
return false;
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("known_command ");
|
||||
msg.append(command.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
return waitResponse();
|
||||
}
|
||||
|
||||
QString Gtp::echo(const QString &command)
|
||||
{
|
||||
if (command.isEmpty())
|
||||
return QString();
|
||||
|
||||
QByteArray msg;
|
||||
msg.append("echo ");
|
||||
msg.append(command.toLatin1());
|
||||
msg.append("\n");
|
||||
m_process.write(msg);
|
||||
if (waitResponse())
|
||||
return m_response;
|
||||
else
|
||||
return QString();
|
||||
}
|
||||
|
||||
void Gtp::readStandardOutput()
|
||||
{
|
||||
m_response = m_process.readAllStandardOutput();
|
||||
}
|
||||
|
||||
void Gtp::readStandardError()
|
||||
{
|
||||
kDebug() << "Error occured:" << m_process.readAllStandardError();
|
||||
}
|
||||
|
||||
bool Gtp::waitResponse()
|
||||
{
|
||||
QString tmp = m_response;
|
||||
do { // Process some events till our response arrives
|
||||
qApp->processEvents(); // to not slow down this thread too much
|
||||
} while (m_response.length() == 0 || m_response == tmp);
|
||||
|
||||
tmp = m_response[0];
|
||||
m_response.remove(0, 2); // Remove the first two chars (e.g. "? " or "= "
|
||||
m_response.remove(m_response.size() - 2, 2); // Remove the two trailing newlines
|
||||
|
||||
emit ready();
|
||||
if (tmp == "?") // '?' Means the engine didn't understand the query
|
||||
return false;
|
||||
else
|
||||
return true;
|
||||
}
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#include "moc_gtp.cpp"
|
730
src/game/gtp.h
Normal file
730
src/game/gtp.h
Normal file
|
@ -0,0 +1,730 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and defines the classes Gtp, Gtp::Stone
|
||||
* and Gtp::Score, which together implement a Go Text Protocol (GTP)
|
||||
* interface to communicate with Go engines supporting GTP protocol
|
||||
* version 2.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#ifndef KGO_GTP_H
|
||||
#define KGO_GTP_H
|
||||
|
||||
#include <QProcess>
|
||||
#include <QList>
|
||||
#include <QString>
|
||||
#include <QObject>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
/**
|
||||
* The Gtp class implements the Go game and acts as a wrapper around a
|
||||
* remote Go Game engine implementing the Go Text Protocol (GTP). It uses
|
||||
* GTP protocol version 2 and interfaces the engine executable in an
|
||||
* asynchronous manor. The best supported engine should (naturally)
|
||||
* be GnuGo.
|
||||
*
|
||||
* @code
|
||||
* Gtp *gtp = new Gtp;
|
||||
*
|
||||
* // Open a session with a Go engine in GTP mode
|
||||
* gtp->openSession("gnugo --mode gtp");
|
||||
*
|
||||
* // Get some informations about the Go engine
|
||||
* gtp->name();
|
||||
* gtp->version();
|
||||
* gtp->help();
|
||||
*
|
||||
* gtp->quit();
|
||||
* @endcode
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
* @since 0.1
|
||||
*/
|
||||
class Gtp : public QObject
|
||||
{
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
/**
|
||||
* Enumeration of available player colors.
|
||||
*/
|
||||
enum PlayerColor {
|
||||
PlayerWhite = 1, ///< The white player
|
||||
PlayerBlack ///< The black player
|
||||
};
|
||||
|
||||
/**
|
||||
* Enumeration of what color the stone has on a certain board field.
|
||||
*/
|
||||
enum FieldStatus {
|
||||
FieldEmpty = 1, ///< The field is empty
|
||||
FieldWhite, ///< The field has a white stone on it
|
||||
FieldBlack, ///< The field has a black stone on it
|
||||
FieldInvalid ///< An invalid field was queried, shows error
|
||||
};
|
||||
|
||||
/**
|
||||
* Enumeration of all possible states of a dragon
|
||||
*/
|
||||
enum DragonStatus {
|
||||
DragonAlive = 1, ///< The dragon lives
|
||||
DragonCritical, ///< The dragon is critical
|
||||
DragonDead, ///< The dragon is dead
|
||||
DragonUnknown, ///< The state of the dragon is unknown
|
||||
DragonInvalid ///< An invalid field was querid, shows error
|
||||
};
|
||||
|
||||
/**
|
||||
* Enumeration of all possible final states of a field when a game is over
|
||||
*/
|
||||
enum FinalState {
|
||||
Alive = 1, ///< The stone on the field is alive
|
||||
Dead, ///< The stone on the field is dead
|
||||
Seki, ///<
|
||||
WhiteTerritory, ///< The field belongs to the white player
|
||||
BlackTerritory, ///< The field belongs to the black player
|
||||
Dame, ///< The field belongs to no player
|
||||
StateInvalid ///< The state is invalid, shows error
|
||||
};
|
||||
|
||||
/**
|
||||
* This class represents a stone on a field of the game board.
|
||||
*/
|
||||
class Stone
|
||||
{
|
||||
public:
|
||||
/**
|
||||
* Standard constructor. Can optionally set from the given coordinates.
|
||||
*
|
||||
* @param x The x coordinate of the stone
|
||||
* @param y The y coordinate of the stone
|
||||
*/
|
||||
Stone(char x = -1, int y = -1) : m_x(x), m_y(y) {}
|
||||
|
||||
/**
|
||||
* Constructor to set from a stone given as a string.
|
||||
*
|
||||
* @param stone The stone as string
|
||||
*/
|
||||
Stone(const QString &stone);
|
||||
|
||||
/**
|
||||
* Checks wether the stone is valid or not
|
||||
*/
|
||||
bool isValid() const;
|
||||
|
||||
/**
|
||||
* Returns the stone as a string
|
||||
*/
|
||||
QString toString() const;
|
||||
|
||||
/**
|
||||
* Returns the stone as a byte array
|
||||
*/
|
||||
QByteArray toLatin1() const;
|
||||
|
||||
/**
|
||||
* Retrieves the x coordinate of the stone
|
||||
*/
|
||||
char x() const { return m_x; }
|
||||
|
||||
/**
|
||||
* Retrieves the y coordinate of the stone
|
||||
*/
|
||||
int y() const { return m_y; }
|
||||
|
||||
private:
|
||||
char m_x; ///< The horizontal field coordinate (from 'A' to 'T')
|
||||
int m_y; ///< The vertical field coordinate (from 1 to 19)
|
||||
};
|
||||
|
||||
/**
|
||||
* This class is used as return value by the 'newScore', 'estimateScore'
|
||||
* and 'finalScore' Gtp methods.
|
||||
*/
|
||||
class Score
|
||||
{
|
||||
public:
|
||||
/**
|
||||
* Standard constructor. Used to create a Score object from a
|
||||
* score string returned by the Go engine.
|
||||
*
|
||||
* @param scoreString The score string from the engine
|
||||
*/
|
||||
Score(const QString &scoreString = QString());
|
||||
|
||||
/**
|
||||
* Checks wether the score is valid or not.
|
||||
*/
|
||||
bool isValid() const;
|
||||
|
||||
/**
|
||||
* Converts the score into a string.
|
||||
*/
|
||||
QString toString() const;
|
||||
|
||||
/**
|
||||
* Returns the player which currently leads by points.
|
||||
*/
|
||||
PlayerColor player() const { return m_player; }
|
||||
|
||||
/**
|
||||
* Returns the amount of points (aka score) which the leading
|
||||
* player has more than the other.
|
||||
*/
|
||||
int score() const { return m_score; }
|
||||
|
||||
/**
|
||||
* Returns the lower bound for a score estimate.
|
||||
*/
|
||||
int lowerBound() const { return m_lowerBound; }
|
||||
|
||||
/**
|
||||
* Returns the upper bound for a score estimate.
|
||||
*/
|
||||
int upperBound() const { return m_upperBound; }
|
||||
|
||||
private:
|
||||
PlayerColor m_player; ///< The player which has more points
|
||||
int m_score; ///< The amount of points the player leads with
|
||||
int m_lowerBound; ///< Estimate lower bound
|
||||
int m_upperBound; ///< Estimate upper bound
|
||||
};
|
||||
|
||||
////////////////////////////////////////////////////////////////////
|
||||
|
||||
Gtp();
|
||||
~Gtp();
|
||||
|
||||
////////////////////////////////////////////////////////////////////
|
||||
// GTP: Administrative commands
|
||||
////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Connect to the given Go game engine in GTP mode. The most common
|
||||
* used case is 'gnugo --mode gtp' but this depends on your platform
|
||||
* and installed Go engine(s).
|
||||
*
|
||||
* @param command The executable command to start in GTP mode.
|
||||
*/
|
||||
bool openSession(const QString &command = "gnugo --mode gtp");
|
||||
|
||||
/**
|
||||
* Check wether the Gtp object is connected to a Go engine, running
|
||||
* and waiting for commands to be fed with.
|
||||
*/
|
||||
bool isRunning() const { return m_process.state() == QProcess::Running; }
|
||||
|
||||
/**
|
||||
* Retrieve the last response the Go game engine made occuredafter it
|
||||
* received a command.
|
||||
*/
|
||||
QString response() const { return m_response; }
|
||||
|
||||
/**
|
||||
* Gracefully stop and exit the Go game engine.
|
||||
*/
|
||||
void quit();
|
||||
|
||||
/**
|
||||
* Load a SGF file, possibly up to a move number or the first
|
||||
* occurence of a move.
|
||||
*
|
||||
* @param fileName The SGF file name
|
||||
* @param moveNumber The move number
|
||||
*/
|
||||
bool loadSgf(const QString &fileName, int moveNumber = 0);
|
||||
|
||||
/**
|
||||
* Save the current game as a SGF filer.
|
||||
*
|
||||
* @param fileName The SGF file name
|
||||
*/
|
||||
bool saveSgf(const QString &fileName);
|
||||
|
||||
////////////////////////////////////////////////////////////////////
|
||||
// GTP: Program identity
|
||||
////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Retrieves the name of the Go game engine application.
|
||||
*/
|
||||
QString name();
|
||||
|
||||
/**
|
||||
* Retrieves the GTP protocol version implemented by the Go game engine.
|
||||
*/
|
||||
int protocolVersion();
|
||||
|
||||
/**
|
||||
* Retrieves the version of the Go game engine application.
|
||||
*/
|
||||
QString version();
|
||||
|
||||
////////////////////////////////////////////////////////////////////
|
||||
// GTP: Setting the board size, clearing
|
||||
////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Set the board size to NxN.
|
||||
*
|
||||
* @param size The board size (standard are 9x9, 13x13 and 19x19)
|
||||
*/
|
||||
bool setBoardSize(int size);
|
||||
|
||||
/**
|
||||
* Retrieves the current board size.
|
||||
*/
|
||||
int boardSize();
|
||||
|
||||
/**
|
||||
* Clears the board.
|
||||
*/
|
||||
bool clearBoard();
|
||||
|
||||
////////////////////////////////////////////////////////////////////
|
||||
// GTP: Setting komi, level, handicap
|
||||
////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Set the komi.
|
||||
*
|
||||
* @param komi The komi to be set (usually 4.5 or 4.5 on 19x19 boards)
|
||||
*/
|
||||
bool setKomi(float komi);
|
||||
|
||||
/**
|
||||
* Set the Go engine strength level.
|
||||
*
|
||||
* @param level The strength level (from 1 to 10)
|
||||
*/
|
||||
bool setLevel(int level);
|
||||
|
||||
/**
|
||||
* Set up fixed placement handicap stones.
|
||||
*
|
||||
* @param handicap The number of handicap stones.
|
||||
*/
|
||||
bool setFixedHandicap(int handicap);
|
||||
|
||||
////////////////////////////////////////////////////////////////////
|
||||
// GTP: Playing and generating moves
|
||||
////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Play a stone for the player with 'color' at 'field'
|
||||
*
|
||||
* @param color The player's color for whom to play the stone
|
||||
* @param field The board field on which to play the stone
|
||||
*/
|
||||
bool playMove(PlayerColor color, const Stone &field);
|
||||
|
||||
/**
|
||||
* Let the player with 'color' pass.
|
||||
*
|
||||
* @param color The player's color who want's to pass
|
||||
*/
|
||||
bool passMove(PlayerColor color);
|
||||
|
||||
/**
|
||||
* Generate and play the supposedly best move for 'color'.
|
||||
*
|
||||
* @param color Play the move for player with that color
|
||||
*/
|
||||
bool generateMove(PlayerColor color);
|
||||
|
||||
/**
|
||||
* Undo last move.
|
||||
*
|
||||
* @param i
|
||||
*/
|
||||
bool undoMove(int i = 1);
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// GTP: Retractable moves
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Play a stone of the given color at the given field.
|
||||
*
|
||||
* @param color Play a stone for that color
|
||||
* @param field Play a stone at that field
|
||||
*/
|
||||
bool tryMove(PlayerColor color, const Stone &field);
|
||||
|
||||
/**
|
||||
* Undo a trymove.
|
||||
*/
|
||||
bool popGo();
|
||||
|
||||
////////////////////////////////////////////////////////////////////
|
||||
// GTP: Board status
|
||||
////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Return the color (state) of a specific board field.
|
||||
*
|
||||
* @param field The field to report the state
|
||||
* @see FieldStatus
|
||||
*/
|
||||
FieldStatus whatColor(const Stone &field);
|
||||
|
||||
/**
|
||||
* Count the number of liberties for the stone at 'field'.
|
||||
*
|
||||
* @param field The field to count liberties for
|
||||
*/
|
||||
int countLiberties(const Stone &field);
|
||||
|
||||
/**
|
||||
* Returns the positions of the liberties for the stone at 'field'.
|
||||
*
|
||||
* @param field The field to return liberties for
|
||||
*/
|
||||
QList<Stone> findLiberties(const Stone &field);
|
||||
|
||||
/**
|
||||
* Tell wether a move at 'field' for player 'color' is legal.
|
||||
*
|
||||
* @param color The player to test the move for
|
||||
* @param field The field to test the move for
|
||||
*/
|
||||
bool isLegal(PlayerColor color, const Stone &field);
|
||||
|
||||
/**
|
||||
* Generate a list of the best moves for a player with 'color' with
|
||||
* weights.
|
||||
*
|
||||
* @param color Player to generate the list for
|
||||
*/
|
||||
QString topMoves(PlayerColor color);
|
||||
|
||||
/**
|
||||
* List all legal moves for either color.
|
||||
*
|
||||
* @param color List legal moves for this color
|
||||
*/
|
||||
QList<Stone> legalMoves(PlayerColor color);
|
||||
|
||||
/**
|
||||
* List the number of captures taken by either color.
|
||||
*/
|
||||
int captures(PlayerColor color);
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// GTP: Tactical reading
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Try to attack a field.
|
||||
*
|
||||
* @param field The field to attack
|
||||
*/
|
||||
QString attack(const Stone &field);
|
||||
|
||||
/**
|
||||
* Try to defend a field.
|
||||
*
|
||||
* @param field The field to defend>
|
||||
*/
|
||||
QString defend(const Stone &field);
|
||||
|
||||
/**
|
||||
* Increase depth values by one.
|
||||
*/
|
||||
bool increaseDepths();
|
||||
|
||||
/**
|
||||
* Decrease depth values by one.
|
||||
*/
|
||||
bool decreaseDepths();
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// GTP: OWL reading and eyes
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Try to attack a dragon.
|
||||
*
|
||||
* @param field The dragon field to attack
|
||||
*/
|
||||
QString owlAttack(const Stone &field);
|
||||
|
||||
/**
|
||||
* Try to defend a dragon.
|
||||
*
|
||||
* @param field The dragon field to defend
|
||||
*/
|
||||
QString owlDefense(const Stone &field);
|
||||
|
||||
/**
|
||||
* Evaluate an eye space and returns a minumum and maximum number of
|
||||
* eyes. If these differ an attack and a defense point are additionally
|
||||
* returned. If the field is not an eye space or not of unique color,
|
||||
* a single -1 is returned.
|
||||
*
|
||||
* @param field The eye field to evaluate
|
||||
* @return Minimum and maximum nuber of eyes.
|
||||
* @see EyeInfo
|
||||
*/
|
||||
QString evalEye(const Stone &field);
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// GTP: Dragon status
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Determine status of a dragon. Returns the dragon status, attack
|
||||
* points, defense points. Points of attack and defense are only given
|
||||
* if the status is critical and the owl code is enabled.
|
||||
*
|
||||
* @param field The dragon stone
|
||||
* @see DragonStatus
|
||||
*/
|
||||
DragonStatus dragonStatus(const Stone &field);
|
||||
|
||||
/**
|
||||
* Determine wether two stones belong to the same dragon.
|
||||
*
|
||||
* @param field1 The first stone
|
||||
* @param field2 The second stone
|
||||
*/
|
||||
bool sameDragon(const Stone &field1, const Stone &field2);
|
||||
|
||||
/**
|
||||
* Returns the information in the dragon data structure. The data
|
||||
* is formatted corresponding to gtp_worm__. If a field is given
|
||||
* only worm data for the field is returned.
|
||||
*
|
||||
* @param field The field for which information is wanted
|
||||
*/
|
||||
QString dragonData(const Stone &field = Stone());
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// GTP: Score
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Report the final status of a field in a finished game.
|
||||
*
|
||||
* @param field Report status for that feed
|
||||
* @see FinalState
|
||||
*/
|
||||
FinalState finalStatus(const Stone &field);
|
||||
|
||||
/**
|
||||
* Report fields with a specified final status in a finished game.
|
||||
*
|
||||
* @param state Report only fields with that state
|
||||
* @see FinalState
|
||||
*/
|
||||
QList<Stone> finalStatusList(FinalState state);
|
||||
|
||||
/**
|
||||
* Compute the score of a finished game.
|
||||
*
|
||||
* @return Score in SGF format (RE property)
|
||||
*/
|
||||
Score finalScore();
|
||||
|
||||
/**
|
||||
* Returns an estimate of the final score based on the current game
|
||||
* situation.
|
||||
*/
|
||||
Score estimateScore();
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// GTP: Statistics
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Retrieve the count of life nodes.
|
||||
*
|
||||
* @return The number of life nodes
|
||||
*/
|
||||
int getLifeNodeCounter();
|
||||
|
||||
/**
|
||||
* Reset the count of life nodes.
|
||||
*/
|
||||
bool resetLifeNodeCounter();
|
||||
|
||||
/**
|
||||
* Retrieve the count of owl nodes.
|
||||
*
|
||||
* @return The number of owl nodes.
|
||||
*/
|
||||
int getOwlNodeCounter();
|
||||
|
||||
/**
|
||||
* Reset the count of owl nodes.
|
||||
*/
|
||||
bool resetOwlNodeCounter();
|
||||
|
||||
/**
|
||||
* Retrieve the count of reading nodes.
|
||||
*
|
||||
* @return The number of reading nodes.
|
||||
*/
|
||||
int getReadingNodeCounter();
|
||||
|
||||
/**
|
||||
* Reset the count of reading nodes.
|
||||
*/
|
||||
bool resetReadingNodeCounter();
|
||||
|
||||
/**
|
||||
* Retrieve the count of trymoves/trykos.
|
||||
*/
|
||||
int getTryMoveCounter();
|
||||
|
||||
/**
|
||||
* Reset the count of trymoves/trykos.
|
||||
*/
|
||||
bool resetTryMoveCounter();
|
||||
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
// GTP: debug
|
||||
/////////////////////////////////////////////////////////////////////
|
||||
|
||||
/**
|
||||
* Write the complete board to stdout.
|
||||
*/
|
||||
bool showBoard();
|
||||
|
||||
/**
|
||||
* Dump stack to stdout.
|
||||
*/
|
||||
bool dumpStack();
|
||||
|
||||
/**
|
||||
* Return the cutstone field in the worm data structure.
|
||||
*
|
||||
* @param field The field to inspect
|
||||
* @return The cutstone value of worm data for that field
|
||||
*/
|
||||
int wormCutStone(const Stone &field);
|
||||
|
||||
/**
|
||||
* Return the information in the worm data structure. If no
|
||||
* valid field is given, worm data is returned for all fields.
|
||||
*
|
||||
* @param field The field to inspect
|
||||
* @return Worm data formatted
|
||||
*/
|
||||
QString wormData(const Stone &field = Stone());
|
||||
|
||||
/**
|
||||
* List of lists of linked together stones around a given field
|
||||
* from the worm data structure.
|
||||
*
|
||||
* @param field The location
|
||||
*/
|
||||
QList<Stone> wormStones(const Stone &field);
|
||||
|
||||
/**
|
||||
* Tune the parameters for the move ordering in the tactical reading.
|
||||
*
|
||||
* @param parameters The move ordering parameters
|
||||
*/
|
||||
bool tuneMoveOrdering(int parameters);
|
||||
|
||||
/**
|
||||
* List all known commands.
|
||||
*
|
||||
* @return The list of known commands
|
||||
*/
|
||||
QList<QString> help();
|
||||
|
||||
/**
|
||||
* Turn uncertainty reports from owl_attack and owl_defend on or off.
|
||||
*
|
||||
* @param enabled Wether to turn uncertainty reports on or off
|
||||
*/
|
||||
bool reportUncertainty(bool enabled);
|
||||
|
||||
/**
|
||||
* Sends a custom command to the Go engine and returns the result.
|
||||
*
|
||||
* @param command The custom command
|
||||
* @return Result of the command
|
||||
*/
|
||||
QString shell(const QString &command);
|
||||
|
||||
/**
|
||||
* Evaluate wether a command is known.
|
||||
*
|
||||
* @param command The command to evaluate
|
||||
*/
|
||||
bool knownCommand(const QString &command);
|
||||
|
||||
/**
|
||||
* A simple echo command to test the engine.
|
||||
*
|
||||
* @param command The command to echo
|
||||
* @return
|
||||
*/
|
||||
QString echo(const QString &command);
|
||||
|
||||
signals:
|
||||
/**
|
||||
* This signal is emmited when the process encounters an error.
|
||||
*/
|
||||
void error(QProcess::ProcessError);
|
||||
|
||||
/**
|
||||
* This signal is emitted when all heavy computation is over
|
||||
* and the Go engine is ready to receive the next command.
|
||||
*/
|
||||
void ready();
|
||||
|
||||
private slots:
|
||||
/**
|
||||
* This slot reads everything from the process's stdout
|
||||
*/
|
||||
void readStandardOutput();
|
||||
|
||||
/**
|
||||
* This slot reads everything from the process's stderr. This is
|
||||
* mainly for debugging purposes, because this should only happen
|
||||
* if a bug occured.
|
||||
*/
|
||||
void readStandardError();
|
||||
|
||||
/**
|
||||
* Wait gracefully for a response from the Go engine. The returned string
|
||||
* from the Go engine is stored in 'm_response'.
|
||||
*/
|
||||
bool waitResponse();
|
||||
|
||||
private:
|
||||
QString m_response; ///< Stores the last answer from the engine
|
||||
QProcess m_process; ///< To interact with the engine executable
|
||||
};
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#endif
|
43
src/gui/config.cpp
Normal file
43
src/gui/config.cpp
Normal file
|
@ -0,0 +1,43 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and implements the class GeneralConfig,
|
||||
* which displays the general configuration options tab in the
|
||||
* Kgo configuration screen.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#include "config.h"
|
||||
|
||||
namespace KGo {
|
||||
|
||||
GeneralConfig::GeneralConfig(QWidget *parent)
|
||||
: QWidget(parent)
|
||||
{
|
||||
setupUi(this);
|
||||
}
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#include "moc_config.cpp"
|
60
src/gui/config.h
Normal file
60
src/gui/config.h
Normal file
|
@ -0,0 +1,60 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and defines the class GeneralConfig,
|
||||
* which displays the general configuration options tab in the
|
||||
* Kgo configuration screen.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#ifndef KGO_CONFIG_H
|
||||
#define KGO_CONFIG_H
|
||||
|
||||
#include "ui_config.h"
|
||||
|
||||
#include <QWidget>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
/**
|
||||
* Represents the general configuration tab in the KGo
|
||||
* configuration screen.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
* @since 0.1
|
||||
*/
|
||||
class GeneralConfig : public QWidget, private Ui::GeneralConfig
|
||||
{
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
/**
|
||||
* Standard Constructor. Sets up the loaded user interface.
|
||||
*/
|
||||
explicit GeneralConfig(QWidget *parent = 0);
|
||||
};
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#endif
|
71
src/gui/config.ui
Normal file
71
src/gui/config.ui
Normal file
|
@ -0,0 +1,71 @@
|
|||
<ui version="4.0" >
|
||||
<class>GeneralConfig</class>
|
||||
<widget class="QWidget" name="GeneralConfig" >
|
||||
<property name="geometry" >
|
||||
<rect>
|
||||
<x>0</x>
|
||||
<y>0</y>
|
||||
<width>359</width>
|
||||
<height>347</height>
|
||||
</rect>
|
||||
</property>
|
||||
<property name="windowTitle" >
|
||||
<string>Form</string>
|
||||
</property>
|
||||
<layout class="QVBoxLayout" name="verticalLayout" >
|
||||
<item>
|
||||
<widget class="QGroupBox" name="groupBox_2" >
|
||||
<property name="sizePolicy" >
|
||||
<sizepolicy vsizetype="Fixed" hsizetype="Preferred" >
|
||||
<horstretch>0</horstretch>
|
||||
<verstretch>0</verstretch>
|
||||
</sizepolicy>
|
||||
</property>
|
||||
<property name="title" >
|
||||
<string>Go Engine Settings</string>
|
||||
</property>
|
||||
<layout class="QHBoxLayout" name="horizontalLayout_2" >
|
||||
<item>
|
||||
<widget class="QLabel" name="label" >
|
||||
<property name="text" >
|
||||
<string>Executable command:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>kcfg_EngineCommand</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="KLineEdit" name="kcfg_EngineCommand" />
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<spacer name="verticalSpacer" >
|
||||
<property name="orientation" >
|
||||
<enum>Qt::Vertical</enum>
|
||||
</property>
|
||||
<property name="sizeHint" stdset="0" >
|
||||
<size>
|
||||
<width>20</width>
|
||||
<height>256</height>
|
||||
</size>
|
||||
</property>
|
||||
</spacer>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
<customwidgets>
|
||||
<customwidget>
|
||||
<class>KLineEdit</class>
|
||||
<extends>QLineEdit</extends>
|
||||
<header>klineedit.h</header>
|
||||
</customwidget>
|
||||
</customwidgets>
|
||||
<resources/>
|
||||
<connections/>
|
||||
</ui>
|
109
src/gui/gamescene.cpp
Normal file
109
src/gui/gamescene.cpp
Normal file
|
@ -0,0 +1,109 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and implements the class GameScene,
|
||||
* which displays the go game.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#include "gamescene.h"
|
||||
#include "game/gtp.h"
|
||||
#include "themerenderer.h"
|
||||
|
||||
#include <QGraphicsPixmapItem>
|
||||
#include <QPainter>
|
||||
|
||||
#include <KDebug>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
GameScene::GameScene(Gtp *gtp)
|
||||
: m_gtp(gtp)
|
||||
, m_showLabels(false)
|
||||
, m_cursorItem(0)
|
||||
{
|
||||
Q_ASSERT(gtp);
|
||||
}
|
||||
|
||||
void GameScene::resizeScene(int width, int height)
|
||||
{
|
||||
setSceneRect(0, 0, width, height);
|
||||
|
||||
int size = qMin(width, height);
|
||||
m_boardRect.setRect(width / 2 - size / 2, height / 2 - size / 2, size, size);
|
||||
|
||||
// Determine size of board cell element based on width (same as height, board is a quad)
|
||||
int defWidth = ThemeRenderer::instance()->elementSize(ThemeRenderer::BoardBackground).width();
|
||||
qreal scale = (qreal)size / defWidth;
|
||||
if (scale <= 0)
|
||||
return;
|
||||
|
||||
// Make sure the cell element has the correct size (correspoding to current board size)
|
||||
m_currentCellSize = defWidth * scale / (m_gtp->boardSize() + 3);
|
||||
}
|
||||
|
||||
void GameScene::update()
|
||||
{
|
||||
//TODO: Resize, set komi, board size ...
|
||||
}
|
||||
|
||||
void GameScene::showMoveHistory(bool show)
|
||||
{
|
||||
|
||||
}
|
||||
|
||||
void GameScene::hint()
|
||||
{
|
||||
|
||||
}
|
||||
|
||||
void GameScene::drawBackground(QPainter *painter, const QRectF &rect)
|
||||
{
|
||||
ThemeRenderer::instance()->renderElement(ThemeRenderer::SceneBackground, painter, sceneRect());
|
||||
ThemeRenderer::instance()->renderElement(ThemeRenderer::BoardBackground, painter, m_boardRect);
|
||||
if (m_showLabels)
|
||||
ThemeRenderer::instance()->renderElement(ThemeRenderer::BoardLabels, painter, m_boardRect);
|
||||
|
||||
/*// Draw the board cells
|
||||
QPointF upLeftPoint(m_boardRect.x() + m_currentCellSize * 1.5,
|
||||
m_boardRect.y() + m_currentCellSize * 1.5);
|
||||
QPointF upRightPoint(m_boardRect.x() + m_boardRect.width() - m_currentCellSize * 1.5,
|
||||
m_boardRect.y() + m_currentCellSize * 1.5);
|
||||
QPointF downLeftPoint(upLeftPoint.x(),
|
||||
upLeftPoint.y() + m_boardRect.height() - m_currentCellSize * 3);
|
||||
|
||||
for (int i = 0; i < m_gtp->boardSize() - 1; i++) {
|
||||
// Draw horizontal line
|
||||
panter->drawLine(QPointF(upLeftPoint.x(), upLeftPoint.y() + i * m_currentCellSize),
|
||||
QPointF(upRightPoint.x(), upRightPoint.y() + i * m_currentCellSize));
|
||||
|
||||
// Draw vertical line
|
||||
painter->drawLine(QPointF(upLeftPoint.x() + i * m_currentCellSize, upLeftPoint.y()),
|
||||
QPointF(downLeftPoint.x() + i * m_currentCellSize, downLeftPoint.y()));
|
||||
}*/
|
||||
}
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#include "moc_gamescene.cpp"
|
112
src/gui/gamescene.h
Normal file
112
src/gui/gamescene.h
Normal file
|
@ -0,0 +1,112 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and defines the class GameScene,
|
||||
* which displays the go game.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#ifndef KGO_GAMESCENE_H
|
||||
#define KGO_GAMESCENE_H
|
||||
|
||||
#include <QGraphicsScene>
|
||||
|
||||
class QGraphicsPixmapItem;
|
||||
|
||||
namespace KGo {
|
||||
|
||||
class Gtp;
|
||||
|
||||
/**
|
||||
* This class provides a graphical representation of the go game using
|
||||
* QGraphicsScene.
|
||||
*
|
||||
* It displays the go board in its current state, receives mouse events,
|
||||
* translates them so that KGo::Gtp can understand, send them to it,
|
||||
* receives board-changed notificationi and nicely animates them.
|
||||
*
|
||||
* It also drives the game flow, i.e. tells game when to make the
|
||||
* next move.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
* @since 0.1
|
||||
*/
|
||||
class GameScene : public QGraphicsScene
|
||||
{
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
/**
|
||||
* Constructs a new game scene object from a correctly configured Gtp
|
||||
* object.
|
||||
*
|
||||
* @param gtp A configured, "ready to start gaming with" Gtp object
|
||||
*/
|
||||
explicit GameScene(Gtp *gtp);
|
||||
|
||||
/**
|
||||
*
|
||||
* @param width
|
||||
* @param height
|
||||
*/
|
||||
void resizeScene(int width, int height);
|
||||
|
||||
public slots:
|
||||
/**
|
||||
*
|
||||
*/
|
||||
void update();
|
||||
|
||||
/**
|
||||
*
|
||||
* @param show Wether to show the move history or not
|
||||
*/
|
||||
void showMoveHistory(bool show);
|
||||
|
||||
/**
|
||||
*
|
||||
*/
|
||||
void hint();
|
||||
|
||||
private:
|
||||
/**
|
||||
* Used to draw the scene background and the Go board.
|
||||
*
|
||||
* @param painter
|
||||
* @param
|
||||
* @see QGraphicsScene::drawBackground()
|
||||
*/
|
||||
void drawBackground(QPainter *painter, const QRectF &);
|
||||
|
||||
Gtp *m_gtp; ///< To interface with the go engine
|
||||
bool m_showLabels; ///< Show board labels or not
|
||||
qreal m_currentCellSize; ///<
|
||||
QRectF m_boardRect; ///< Position of board in the scene
|
||||
QList<QGraphicsPixmapItem *> m_stoneItemList; ///<
|
||||
QGraphicsPixmapItem *m_cursorItem; ///<
|
||||
};
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#endif
|
60
src/gui/gamescreen.cpp
Normal file
60
src/gui/gamescreen.cpp
Normal file
|
@ -0,0 +1,60 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and implements the class GameScreen,
|
||||
* which acts as a compound widget to display the game view and
|
||||
* several additional information panels.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#include "gamescreen.h"
|
||||
#include "preferences.h"
|
||||
#include "game/gtp.h"
|
||||
#include "gamescene.h"
|
||||
#include "gameview.h"
|
||||
|
||||
namespace KGo {
|
||||
|
||||
GameScreen::GameScreen(Gtp *gtp, QWidget *parent)
|
||||
: QWidget(parent)
|
||||
, m_gtp(gtp)
|
||||
, m_gameScene(new GameScene(gtp))
|
||||
, m_gameView(new GameView(m_gameScene, this))
|
||||
{
|
||||
Q_ASSERT(gtp);
|
||||
|
||||
setupUi(this);
|
||||
m_gameView->setInteractive(true);
|
||||
gameFrame->setLayout(new QHBoxLayout());
|
||||
gameFrame->layout()->addWidget(m_gameView);
|
||||
}
|
||||
|
||||
GameScreen::~GameScreen()
|
||||
{
|
||||
m_gtp->quit();
|
||||
}
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#include "moc_gamescreen.cpp"
|
86
src/gui/gamescreen.h
Normal file
86
src/gui/gamescreen.h
Normal file
|
@ -0,0 +1,86 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and defines the class GameScreen,
|
||||
* which acts as a compound widget to display the game view and
|
||||
* several additional information panels.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#ifndef KGO_GAMESCREEN_H
|
||||
#define KGO_GAMESCREEN_H
|
||||
|
||||
#include "ui_gamescreen.h"
|
||||
#include <QWidget>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
class Gtp;
|
||||
class GameScene;
|
||||
class GameView;
|
||||
|
||||
/**
|
||||
* The game screen acts as a compound widget for the game view and
|
||||
* some additional information panels. The panels include the move
|
||||
* history and game statistics.
|
||||
*
|
||||
* @see GameView
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
* @since 0.1
|
||||
*/
|
||||
class GameScreen : public QWidget, private Ui::GameScreen
|
||||
{
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
/**
|
||||
* Standard constructor. Creates a new game screen and sets up
|
||||
* some informational panels as well as the main Go game board
|
||||
* view.
|
||||
*
|
||||
* @param gtp A configured, ready to start gaming with Gtp object
|
||||
* @param parent The parent widget or none
|
||||
*/
|
||||
explicit GameScreen(Gtp *gtp, QWidget *parent = 0);
|
||||
|
||||
/**
|
||||
* Standard destructor.
|
||||
*/
|
||||
~GameScreen();
|
||||
|
||||
signals:
|
||||
|
||||
public slots:
|
||||
//void setMoveHistoryVisible(bool visible);
|
||||
//void setGameStatisticsVisible(bool visible);
|
||||
|
||||
private:
|
||||
Gtp *m_gtp; ///<
|
||||
GameScene *m_gameScene; ///<
|
||||
GameView *m_gameView; ///<
|
||||
};
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#endif
|
137
src/gui/gamescreen.ui
Normal file
137
src/gui/gamescreen.ui
Normal file
|
@ -0,0 +1,137 @@
|
|||
<ui version="4.0" >
|
||||
<class>GameScreen</class>
|
||||
<widget class="QWidget" name="GameScreen" >
|
||||
<property name="geometry" >
|
||||
<rect>
|
||||
<x>0</x>
|
||||
<y>0</y>
|
||||
<width>239</width>
|
||||
<height>321</height>
|
||||
</rect>
|
||||
</property>
|
||||
<property name="windowTitle" >
|
||||
<string>Form</string>
|
||||
</property>
|
||||
<layout class="QHBoxLayout" name="horizontalLayout" >
|
||||
<item>
|
||||
<widget class="QFrame" name="gameFrame" >
|
||||
<property name="frameShape" >
|
||||
<enum>QFrame::StyledPanel</enum>
|
||||
</property>
|
||||
<property name="frameShadow" >
|
||||
<enum>QFrame::Raised</enum>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="QToolBox" name="toolBox" >
|
||||
<property name="sizePolicy" >
|
||||
<sizepolicy vsizetype="Preferred" hsizetype="Fixed" >
|
||||
<horstretch>0</horstretch>
|
||||
<verstretch>0</verstretch>
|
||||
</sizepolicy>
|
||||
</property>
|
||||
<property name="currentIndex" >
|
||||
<number>0</number>
|
||||
</property>
|
||||
<widget class="QWidget" name="page" >
|
||||
<property name="geometry" >
|
||||
<rect>
|
||||
<x>0</x>
|
||||
<y>0</y>
|
||||
<width>130</width>
|
||||
<height>241</height>
|
||||
</rect>
|
||||
</property>
|
||||
<attribute name="label" >
|
||||
<string>Game Information</string>
|
||||
</attribute>
|
||||
<layout class="QVBoxLayout" name="verticalLayout" >
|
||||
<item>
|
||||
<widget class="QGroupBox" name="scoreBox" >
|
||||
<property name="title" >
|
||||
<string>Score Estimates</string>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="QGroupBox" name="statisticsBox" >
|
||||
<property name="title" >
|
||||
<string>Statistics</string>
|
||||
</property>
|
||||
<layout class="QGridLayout" name="gridLayout" >
|
||||
<item row="0" column="0" >
|
||||
<widget class="QLabel" name="label" >
|
||||
<property name="text" >
|
||||
<string>White Captures:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="0" column="1" >
|
||||
<widget class="QLabel" name="whiteCapturesLabel" >
|
||||
<property name="text" >
|
||||
<string>0</string>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="0" >
|
||||
<widget class="QLabel" name="label_4" >
|
||||
<property name="text" >
|
||||
<string>Black Captures:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="1" >
|
||||
<widget class="QLabel" name="blackCapturesLabel" >
|
||||
<property name="text" >
|
||||
<string>0</string>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
<widget class="QWidget" name="page_2" >
|
||||
<property name="geometry" >
|
||||
<rect>
|
||||
<x>0</x>
|
||||
<y>0</y>
|
||||
<width>264</width>
|
||||
<height>241</height>
|
||||
</rect>
|
||||
</property>
|
||||
<attribute name="label" >
|
||||
<string>Move History</string>
|
||||
</attribute>
|
||||
<layout class="QVBoxLayout" name="verticalLayout_2" >
|
||||
<item>
|
||||
<widget class="KListWidget" name="moveListWidget" >
|
||||
<property name="enabled" >
|
||||
<bool>false</bool>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
<customwidgets>
|
||||
<customwidget>
|
||||
<class>KListWidget</class>
|
||||
<extends>QListWidget</extends>
|
||||
<header>klistwidget.h</header>
|
||||
</customwidget>
|
||||
</customwidgets>
|
||||
<resources/>
|
||||
<connections/>
|
||||
</ui>
|
57
src/gui/gameview.cpp
Normal file
57
src/gui/gameview.cpp
Normal file
|
@ -0,0 +1,57 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and implements the class GameView,
|
||||
* which implements the view for a go game scene.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#include "gameview.h"
|
||||
#include "gamescene.h"
|
||||
|
||||
#include <QResizeEvent>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
GameView::GameView(GameScene *scene, QWidget *parent)
|
||||
: QGraphicsView(scene, parent)
|
||||
, m_scene(scene)
|
||||
{
|
||||
setCacheMode(QGraphicsView::CacheBackground);
|
||||
setHorizontalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
|
||||
setVerticalScrollBarPolicy(Qt::ScrollBarAlwaysOff);
|
||||
setFrameStyle(QFrame::NoFrame);
|
||||
setOptimizationFlags(QGraphicsView::DontClipPainter |
|
||||
QGraphicsView::DontSavePainterState |
|
||||
QGraphicsView::DontAdjustForAntialiasing);
|
||||
}
|
||||
|
||||
void GameView::resizeEvent(QResizeEvent *event)
|
||||
{
|
||||
m_scene->resizeScene(event->size().width(), event->size().height());
|
||||
}
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#include "moc_gameview.cpp"
|
73
src/gui/gameview.h
Normal file
73
src/gui/gameview.h
Normal file
|
@ -0,0 +1,73 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and defines the class GameView,
|
||||
* which implements the view for a go game scene.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#ifndef KGO_GAMEVIEW_H
|
||||
#define KGO_GAMEVIEW_H
|
||||
|
||||
#include <QGraphicsView>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
class GameScene;
|
||||
|
||||
/**
|
||||
* This class represents a view on a Go game view. This widget can be
|
||||
* included into a main window.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
* @since 0.1
|
||||
*/
|
||||
class GameView : public QGraphicsView
|
||||
{
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
/**
|
||||
* Standard constructor. Creates a game view based on a given game scene.
|
||||
*
|
||||
* @param scene The game scene
|
||||
* @param parent The (optional) parent widget
|
||||
* @see GameScene
|
||||
*/
|
||||
explicit GameView(GameScene *scene, QWidget *parent = 0);
|
||||
|
||||
private:
|
||||
/**
|
||||
* The resize event happens when the user changes the window size.
|
||||
*
|
||||
* @param event The resize event
|
||||
*/
|
||||
virtual void resizeEvent(QResizeEvent *event);
|
||||
|
||||
GameScene *m_scene; ///< Pointer to the game scene
|
||||
};
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#endif
|
16
src/gui/kgo.desktop
Normal file
16
src/gui/kgo.desktop
Normal file
|
@ -0,0 +1,16 @@
|
|||
[Desktop Entry]
|
||||
Type=Application
|
||||
Icon=kgo
|
||||
Encoding=UTF-8
|
||||
Exec=kgo %i -caption "%c"
|
||||
Terminal=false
|
||||
Categories=Qt;KDE;Game;BoardGame;
|
||||
DocPath=kgo/index.html
|
||||
#X-KDE-StartupNotify=true
|
||||
#X-DBUS-StartupType=Multi
|
||||
|
||||
Name=KGo
|
||||
|
||||
GenericName=Go Board Game
|
||||
GenericName[de]=Go Brettspiel
|
||||
GenericName[fr]=Jeu de plateau Go
|
28
src/gui/kgoui.rc
Normal file
28
src/gui/kgoui.rc
Normal file
|
@ -0,0 +1,28 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<!DOCTYPE kpartgui SYSTEM "kpartgui.dtd">
|
||||
<gui name="kgo" version="2">
|
||||
<MenuBar>
|
||||
<Menu name="game">
|
||||
<Action name="game_seats" />
|
||||
</Menu>
|
||||
<!-- <Menu name="view">
|
||||
<text>&View</text>
|
||||
<Action name="show_last_move" />
|
||||
<Action name="show_legal_moves" />
|
||||
<Action name="show_moves" />
|
||||
</Menu> -->
|
||||
<Menu name="settings">
|
||||
<text>&aml;Settings</text>
|
||||
<Action name="skill" />
|
||||
</Menu>
|
||||
</MenuBar>
|
||||
<ToolBar name="mainToolBar">
|
||||
<text>Main ToolBar</text>
|
||||
<Action name="game_new" />
|
||||
<Action name="game_load" />
|
||||
<Separator />
|
||||
<Action name="move_undo" />
|
||||
<Action name="move_redo" />
|
||||
<Action name="move_demo" />
|
||||
</ToolBar>
|
||||
</gui>
|
157
src/gui/mainwindow.cpp
Normal file
157
src/gui/mainwindow.cpp
Normal file
|
@ -0,0 +1,157 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and implements the class MainWindow,
|
||||
* which acts as the main window of the graphical user interface
|
||||
* for KGo.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
|
||||
#include "mainwindow.h"
|
||||
#include "preferences.h"
|
||||
#include "gui/setupscreen.h"
|
||||
#include "gui/gamescreen.h"
|
||||
#include "gui/config.h"
|
||||
#include "game/gtp.h"
|
||||
|
||||
#include <QDir>
|
||||
#include <QStackedWidget>
|
||||
|
||||
#include <KStatusBar>
|
||||
#include <KAction>
|
||||
#include <KToggleAction>
|
||||
#include <KStandardAction>
|
||||
#include <KStandardGameAction>
|
||||
#include <KActionCollection>
|
||||
#include <KConfigDialog>
|
||||
#include <KFileDialog>
|
||||
#include <KGameThemeSelector>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
MainWindow::MainWindow(QWidget *parent, bool startDemo)
|
||||
: KXmlGuiWindow(parent)
|
||||
, m_gtp(new Gtp())
|
||||
, m_setupScreen(new SetupScreen(m_gtp, this))
|
||||
, m_gameScreen(new GameScreen(m_gtp, this))
|
||||
, m_startInDemoMode(startDemo)
|
||||
{
|
||||
// Handle the start game whish the user entered in the setup screen
|
||||
connect(m_setupScreen, SIGNAL(startClicked()), this, SLOT(startGame()));
|
||||
|
||||
QStackedWidget *mainWidget = new QStackedWidget;
|
||||
mainWidget->addWidget(m_setupScreen);
|
||||
mainWidget->addWidget(m_gameScreen);
|
||||
mainWidget->setCurrentWidget(m_setupScreen);
|
||||
setCentralWidget(mainWidget);
|
||||
|
||||
setupActions();
|
||||
setupGUI();
|
||||
}
|
||||
|
||||
MainWindow::~MainWindow()
|
||||
{
|
||||
m_gtp->quit(); // Gently disconnect the Go engine
|
||||
}
|
||||
|
||||
void MainWindow::setupActions()
|
||||
{
|
||||
// Game menu
|
||||
KStandardGameAction::gameNew(this, SLOT(newGame()), actionCollection());
|
||||
KStandardGameAction::load(this, SLOT(loadGame()), actionCollection());
|
||||
m_saveAsAction = KStandardGameAction::saveAs(this, SLOT(saveGame()), actionCollection());
|
||||
m_saveAsAction->setEnabled(false);
|
||||
KStandardGameAction::quit(this, SLOT(close()), actionCollection());
|
||||
|
||||
// Move menu
|
||||
//TODO FIXME: Integrate move forward/backward stuff
|
||||
m_previousMoveAction = KStandardGameAction::undo(this, SLOT(undo()), actionCollection());
|
||||
m_previousMoveAction->setEnabled(false);
|
||||
m_nextMoveAction = KStandardGameAction::redo(this, SLOT(redo()), actionCollection());
|
||||
m_nextMoveAction->setEnabled(false);
|
||||
m_demoAction = KStandardGameAction::demo(this, SLOT(toggleDemoMode()), actionCollection());
|
||||
m_demoAction->setEnabled(false);
|
||||
|
||||
// Settings menu
|
||||
KStandardAction::preferences(this, SLOT(showPreferences()), actionCollection());
|
||||
}
|
||||
|
||||
void MainWindow::newGame()
|
||||
{
|
||||
m_saveAsAction->setEnabled(false);
|
||||
m_setupScreen->setupNewGame();
|
||||
qobject_cast<QStackedWidget *>(centralWidget())->setCurrentWidget(m_setupScreen);
|
||||
}
|
||||
|
||||
void MainWindow::loadGame()
|
||||
{
|
||||
m_saveAsAction->setEnabled(false);
|
||||
QString fileName = KFileDialog::getOpenFileName(KUrl(QDir::homePath()), "*.sgf");
|
||||
if (!fileName.isEmpty()) {
|
||||
m_setupScreen->setupLoadedGame(fileName, true);
|
||||
qobject_cast<QStackedWidget *>(centralWidget())->setCurrentWidget(m_setupScreen);
|
||||
}
|
||||
}
|
||||
|
||||
void MainWindow::saveGame()
|
||||
{
|
||||
QString fileName = KFileDialog::getSaveFileName(KUrl(QDir::homePath()), "*.sgf");
|
||||
if (!fileName.isEmpty())
|
||||
m_gtp->saveSgf(fileName);
|
||||
}
|
||||
|
||||
void MainWindow::startGame()
|
||||
{
|
||||
m_saveAsAction->setEnabled(true);
|
||||
qobject_cast<QStackedWidget *>(centralWidget())->setCurrentWidget(m_gameScreen);
|
||||
//TODO: gameScreen should be notified somehow to start the game
|
||||
}
|
||||
|
||||
void MainWindow::undo()
|
||||
{
|
||||
}
|
||||
|
||||
void MainWindow::redo()
|
||||
{
|
||||
}
|
||||
|
||||
void MainWindow::toggleDemoMode()
|
||||
{
|
||||
}
|
||||
|
||||
void MainWindow::showPreferences()
|
||||
{
|
||||
if (KConfigDialog::showDialog("settings"))
|
||||
return;
|
||||
KConfigDialog *dialog = new KConfigDialog(this, "settings", Preferences::self());
|
||||
dialog->addPage(new GeneralConfig(), i18n("General"), "preferences-other");
|
||||
dialog->addPage(new KGameThemeSelector(dialog, Preferences::self()), i18n("Themes"), "games-config-theme");
|
||||
dialog->setHelp(QString(),"KGo");
|
||||
dialog->show();
|
||||
}
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#include "moc_mainwindow.cpp"
|
99
src/gui/mainwindow.h
Normal file
99
src/gui/mainwindow.h
Normal file
|
@ -0,0 +1,99 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and defines the class MainWindow,
|
||||
* which acts as the main window of the graphical user interface
|
||||
* for KGo.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#ifndef KGO_MAINWINDOW_H
|
||||
#define KGO_MAINWINDOW_H
|
||||
|
||||
#include <KXmlGuiWindow>
|
||||
|
||||
class QAction;
|
||||
class QStackedWidget;
|
||||
class KToggleAction;
|
||||
|
||||
namespace KGo {
|
||||
|
||||
class Gtp;
|
||||
class SetupScreen;
|
||||
class GameScreen;
|
||||
|
||||
/**
|
||||
* The MainWindow class acts as the main window of the KGo graphical
|
||||
* user interface.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
* @since 0.1
|
||||
*/
|
||||
class MainWindow : public KXmlGuiWindow
|
||||
{
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
/**
|
||||
* Standard Constructor
|
||||
*
|
||||
* @param parent The parent widget
|
||||
* @param startDemo Start in demo mode?
|
||||
*/
|
||||
MainWindow(QWidget *parent = 0, bool startDemo = false);
|
||||
|
||||
/**
|
||||
*
|
||||
*/
|
||||
~MainWindow();
|
||||
|
||||
private slots:
|
||||
void newGame(); ///< Configure new game with setupscreen
|
||||
void loadGame(); ///< Configure loaded game with ~
|
||||
void saveGame(); ///< Save the current game state
|
||||
void startGame(); ///< React on setupscreen start button
|
||||
void undo(); ///<
|
||||
void redo(); ///<
|
||||
void toggleDemoMode(); ///<
|
||||
void showPreferences(); ///< Show settings dialog
|
||||
|
||||
private:
|
||||
void setupActions();
|
||||
|
||||
Gtp* m_gtp; ///<
|
||||
SetupScreen *m_setupScreen; ///< Pointer to the game setup screen
|
||||
GameScreen *m_gameScreen; ///< Pointer to the game playing screen
|
||||
bool m_startInDemoMode; ///< Start application in demo mode
|
||||
|
||||
QAction *m_saveAsAction; ///< Action to save the current game
|
||||
QAction *m_firstMoveAction; ///< Action to jump to the first move
|
||||
QAction *m_previousMoveAction; ///< Action to jump to the previous move
|
||||
QAction *m_nextMoveAction; ///< Action to jump to the next move
|
||||
QAction *m_lastMoveAction; ///< Action to jump to the last move
|
||||
KToggleAction *m_demoAction; ///< Action to change to demo mode
|
||||
};
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#endif
|
232
src/gui/setupscreen.cpp
Normal file
232
src/gui/setupscreen.cpp
Normal file
|
@ -0,0 +1,232 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and implements the class SetupScreen.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#include "setupscreen.h"
|
||||
#include "preferences.h"
|
||||
#include "game/gtp.h"
|
||||
#include "gamescene.h"
|
||||
#include "gameview.h"
|
||||
|
||||
#include <KDebug>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
SetupScreen::SetupScreen(Gtp *gtp, QWidget *parent)
|
||||
: QWidget(parent)
|
||||
, m_gtp(gtp)
|
||||
, m_gameScene(new GameScene(m_gtp))
|
||||
, m_gameView(new GameView(m_gameScene, this))
|
||||
{
|
||||
Q_ASSERT(gtp);
|
||||
|
||||
setupUi(this);
|
||||
m_gameView->setInteractive(false); // This is just a preview, not a real game
|
||||
previewFrame->setLayout(new QHBoxLayout());
|
||||
previewFrame->layout()->addWidget(m_gameView);
|
||||
setupNewGame(); // Configure new game per default
|
||||
}
|
||||
|
||||
SetupScreen::~SetupScreen()
|
||||
{
|
||||
saveSettings();
|
||||
}
|
||||
|
||||
void SetupScreen::setupNewGame()
|
||||
{
|
||||
newGameBox->show();
|
||||
loadedGameBox->hide();
|
||||
infoBox->hide();
|
||||
loadSettings();
|
||||
m_gtp->openSession(Preferences::engineCommand()); // (Re)Connect to the configured go engine
|
||||
m_gtp->clearBoard();
|
||||
}
|
||||
|
||||
void SetupScreen::setupLoadedGame(const QString &fileName, bool showInfo)
|
||||
{
|
||||
Q_ASSERT(!fileName.isEmpty());
|
||||
|
||||
newGameBox->hide();
|
||||
loadedGameBox->show();
|
||||
infoBox->setVisible(showInfo);
|
||||
loadSettings();
|
||||
m_gtp->openSession(Preferences::engineCommand()); // (Re)Connect to the configured go engine
|
||||
m_gtp->loadSgf(fileName);
|
||||
//TODO: Set max value of startMoveSpinBox
|
||||
if (showInfo) {
|
||||
//TODO: Display all related game information in the info box
|
||||
}
|
||||
}
|
||||
|
||||
void SetupScreen::on_whitePlayerCombo_currentIndexChanged(const QString &text)
|
||||
{
|
||||
if (text == tr("Human")) {
|
||||
whitePlayerName->setEnabled(true);
|
||||
if (blackPlayerCombo->currentText() == tr("Human")) {
|
||||
difficultyBox->setEnabled(false);
|
||||
difficultySlider->setEnabled(false);
|
||||
} else {
|
||||
difficultyBox->setEnabled(true);
|
||||
difficultySlider->setEnabled(true);
|
||||
}
|
||||
} else if (text == tr("Computer")) {
|
||||
whitePlayerName->setEnabled(false);
|
||||
if (blackPlayerCombo->currentText() == tr("Computer")) {
|
||||
difficultyBox->setEnabled(false);
|
||||
difficultySlider->setEnabled(false);
|
||||
} else {
|
||||
difficultyBox->setEnabled(true);
|
||||
difficultySlider->setEnabled(true);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
void SetupScreen::on_blackPlayerCombo_currentIndexChanged(const QString &text)
|
||||
{
|
||||
if (text == tr("Human")) {
|
||||
blackPlayerName->setEnabled(true);
|
||||
if (whitePlayerCombo->currentText() == tr("Human")) {
|
||||
difficultyBox->setEnabled(false);
|
||||
difficultySlider->setEnabled(false);
|
||||
} else {
|
||||
difficultyBox->setEnabled(true);
|
||||
difficultySlider->setEnabled(true);
|
||||
}
|
||||
} else if (text == tr("Computer")) {
|
||||
blackPlayerName->setEnabled(false);
|
||||
if (whitePlayerCombo->currentText() == tr("Computer")) {
|
||||
difficultyBox->setEnabled(false);
|
||||
difficultySlider->setEnabled(false);
|
||||
} else {
|
||||
difficultyBox->setEnabled(true);
|
||||
difficultySlider->setEnabled(true);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
void SetupScreen::on_startMoveSpinBox_valueChanged(int value)
|
||||
{
|
||||
//TODO: Show the corresponding board
|
||||
}
|
||||
|
||||
void SetupScreen::on_sizeGroupBox_changed(int /*id*/)
|
||||
{
|
||||
if (sizeOther->isChecked())
|
||||
sizeOtherSpinBox->setEnabled(true);
|
||||
else
|
||||
sizeOtherSpinBox->setEnabled(false);
|
||||
}
|
||||
|
||||
void SetupScreen::on_startButton_clicked()
|
||||
{
|
||||
saveSettings();
|
||||
if (newGameBox->isVisible()) { // Means we configured a new game
|
||||
m_gtp->setBoardSize(Preferences::boardSize());
|
||||
m_gtp->setLevel(Preferences::difficulty());
|
||||
m_gtp->setKomi(Preferences::komi());
|
||||
m_gtp->setFixedHandicap(Preferences::fixedHandicap());
|
||||
} else { // Means we configured a loaded game
|
||||
//NOTE: Nothing to do here, all settings where already loaded from the SGF file.
|
||||
}
|
||||
emit startClicked();
|
||||
}
|
||||
|
||||
void SetupScreen::loadSettings()
|
||||
{
|
||||
kDebug() << "Load settings";
|
||||
if (Preferences::whitePlayerHuman()) {
|
||||
whitePlayerCombo->setCurrentIndex(whitePlayerCombo->findText(tr("Human")));
|
||||
whitePlayerName->setEnabled(true);
|
||||
} else {
|
||||
whitePlayerCombo->setCurrentIndex(whitePlayerCombo->findText(tr("Computer")));
|
||||
whitePlayerName->setEnabled(false);
|
||||
}
|
||||
whitePlayerName->setText(Preferences::whitePlayerName());
|
||||
|
||||
if (Preferences::blackPlayerHuman()) {
|
||||
blackPlayerCombo->setCurrentIndex(blackPlayerCombo->findText(tr("Human")));
|
||||
blackPlayerName->setEnabled(true);
|
||||
} else {
|
||||
blackPlayerCombo->setCurrentIndex(blackPlayerCombo->findText(tr("Computer")));
|
||||
blackPlayerName->setEnabled(false);
|
||||
}
|
||||
blackPlayerName->setText(Preferences::blackPlayerName());
|
||||
|
||||
if ((Preferences::blackPlayerHuman() && !Preferences::whitePlayerHuman()) || (!Preferences::blackPlayerHuman() && Preferences::whitePlayerHuman())) {
|
||||
difficultyBox->setEnabled(true);
|
||||
difficultySlider->setEnabled(true);
|
||||
}
|
||||
|
||||
difficultySlider->setValue(Preferences::difficulty());
|
||||
komiSpinBox->setValue(Preferences::komi());
|
||||
handicapSpinBox->setValue(Preferences::fixedHandicap());
|
||||
|
||||
switch (Preferences::boardSize()) {
|
||||
case 9:
|
||||
sizeSmall->setChecked(true);
|
||||
break;
|
||||
case 13:
|
||||
sizeMedium->setChecked(true);
|
||||
break;
|
||||
case 19:
|
||||
sizeBig->setChecked(true);
|
||||
break;
|
||||
default:
|
||||
sizeOther->setChecked(true);
|
||||
sizeOtherSpinBox->setEnabled(true);
|
||||
sizeOtherSpinBox->setValue(Preferences::boardSize());
|
||||
break;
|
||||
}
|
||||
}
|
||||
|
||||
void SetupScreen::saveSettings()
|
||||
{
|
||||
kDebug () << "Save settings";
|
||||
Preferences::setWhitePlayerHuman(whitePlayerCombo->currentText() == tr("Human"));
|
||||
Preferences::setWhitePlayerName(whitePlayerName->text());
|
||||
Preferences::setBlackPlayerHuman(blackPlayerCombo->currentText() == tr("Human"));
|
||||
Preferences::setBlackPlayerName(blackPlayerName->text());
|
||||
|
||||
Preferences::setDifficulty(difficultySlider->value());
|
||||
Preferences::setKomi(komiSpinBox->value());
|
||||
Preferences::setFixedHandicap(handicapSpinBox->value());
|
||||
|
||||
if (sizeSmall->isChecked())
|
||||
Preferences::setBoardSize(9);
|
||||
else if (sizeMedium->isChecked())
|
||||
Preferences::setBoardSize(13);
|
||||
else if (sizeBig->isChecked())
|
||||
Preferences::setBoardSize(19);
|
||||
else if (sizeOther->isChecked())
|
||||
Preferences::setBoardSize(sizeOtherSpinBox->value());
|
||||
|
||||
Preferences::self()->writeConfig();
|
||||
}
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#include "moc_setupscreen.cpp"
|
113
src/gui/setupscreen.h
Normal file
113
src/gui/setupscreen.h
Normal file
|
@ -0,0 +1,113 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and defines the class SetupScreen.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#ifndef KGO_SETUPSCREEN_H
|
||||
#define KGO_SETUPSCREEN_H
|
||||
|
||||
#include "ui_setupscreen.h"
|
||||
|
||||
#include <QWidget>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
class Gtp;
|
||||
class GameScene;
|
||||
class GameView;
|
||||
|
||||
/**
|
||||
* The game setup screen lets the user choose a variety of game
|
||||
* options preview the configured game and start it.
|
||||
*
|
||||
* The user can make all necessary settings for the game he/she
|
||||
* wishes to start, the welcome screen only sets the KGo::Game to
|
||||
* these values and emits a signal when the user wants to start.
|
||||
* Further interaction with the KGo::Game (and it's graphical
|
||||
* representation KGo::BoardView and KGo::BoardScene) has to happen
|
||||
* elsewhere.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
* @since 0.1
|
||||
*/
|
||||
class SetupScreen : public QWidget, private Ui::SetupScreen
|
||||
{
|
||||
Q_OBJECT
|
||||
|
||||
public:
|
||||
/**
|
||||
* Standard constructor. Sets up the loaded user interface and initial state.
|
||||
*
|
||||
* @param gtp A valid Gtp object
|
||||
* @param parent The parent widget or none
|
||||
*/
|
||||
explicit SetupScreen(Gtp *gtp, QWidget *parent = 0);
|
||||
|
||||
/**
|
||||
* Standard destructor.
|
||||
*/
|
||||
~SetupScreen();
|
||||
|
||||
/**
|
||||
* Use the setup screen to configure a new game. This sets the right widgets
|
||||
* for that purpose.
|
||||
*/
|
||||
void setupNewGame();
|
||||
|
||||
/**
|
||||
* Use the setup screen to configure a loaded game. This sets the right widgets
|
||||
* bases on the paramters.
|
||||
*
|
||||
* @param fileName The SGF file to load the game from
|
||||
* @param showInfo Wether to show some info found in the SGF or not
|
||||
*/
|
||||
void setupLoadedGame(const QString &fileName, bool showInfo = false);
|
||||
|
||||
signals:
|
||||
/**
|
||||
* This signal is emmited when the user clicked the 'start game' button.
|
||||
*/
|
||||
void startClicked();
|
||||
|
||||
private slots:
|
||||
void on_whitePlayerCombo_currentIndexChanged(const QString &);
|
||||
void on_blackPlayerCombo_currentIndexChanged(const QString &);
|
||||
void on_startMoveSpinBox_valueChanged(int);
|
||||
void on_sizeGroupBox_changed(int);
|
||||
void on_startButton_clicked();
|
||||
|
||||
void loadSettings(); ///< Load KConfigXT application settings
|
||||
void saveSettings(); ///< Store KConfigXT application settings
|
||||
|
||||
private:
|
||||
Gtp *m_gtp; ///<
|
||||
GameScene *m_gameScene; ///<
|
||||
GameView *m_gameView; ///<
|
||||
};
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#endif
|
536
src/gui/setupscreen.ui
Normal file
536
src/gui/setupscreen.ui
Normal file
|
@ -0,0 +1,536 @@
|
|||
<ui version="4.0" >
|
||||
<class>SetupScreen</class>
|
||||
<widget class="QWidget" name="SetupScreen" >
|
||||
<property name="geometry" >
|
||||
<rect>
|
||||
<x>0</x>
|
||||
<y>0</y>
|
||||
<width>701</width>
|
||||
<height>722</height>
|
||||
</rect>
|
||||
</property>
|
||||
<property name="windowTitle" >
|
||||
<string>Form</string>
|
||||
</property>
|
||||
<layout class="QGridLayout" name="gridLayout_6" >
|
||||
<item row="0" column="0" >
|
||||
<widget class="QFrame" name="frame" >
|
||||
<property name="sizePolicy" >
|
||||
<sizepolicy vsizetype="Preferred" hsizetype="Fixed" >
|
||||
<horstretch>0</horstretch>
|
||||
<verstretch>0</verstretch>
|
||||
</sizepolicy>
|
||||
</property>
|
||||
<property name="frameShape" >
|
||||
<enum>QFrame::NoFrame</enum>
|
||||
</property>
|
||||
<property name="frameShadow" >
|
||||
<enum>QFrame::Raised</enum>
|
||||
</property>
|
||||
<property name="lineWidth" >
|
||||
<number>0</number>
|
||||
</property>
|
||||
<layout class="QVBoxLayout" name="verticalLayout_4" >
|
||||
<property name="margin" >
|
||||
<number>0</number>
|
||||
</property>
|
||||
<item>
|
||||
<widget class="QGroupBox" name="blackPlayerBox" >
|
||||
<property name="title" >
|
||||
<string/>
|
||||
</property>
|
||||
<layout class="QGridLayout" name="gridLayout_3" >
|
||||
<item row="0" column="1" >
|
||||
<widget class="KComboBox" name="blackPlayerCombo" >
|
||||
<item>
|
||||
<property name="text" >
|
||||
<string>Human</string>
|
||||
</property>
|
||||
</item>
|
||||
<item>
|
||||
<property name="text" >
|
||||
<string>Computer</string>
|
||||
</property>
|
||||
</item>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="0" >
|
||||
<widget class="QLabel" name="label_6" >
|
||||
<property name="text" >
|
||||
<string>Name:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>blackPlayerName</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="1" >
|
||||
<widget class="KLineEdit" name="blackPlayerName" >
|
||||
<property name="enabled" >
|
||||
<bool>true</bool>
|
||||
</property>
|
||||
<property name="text" >
|
||||
<string/>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="0" column="0" >
|
||||
<widget class="QLabel" name="label_5" >
|
||||
<property name="text" >
|
||||
<string>Black:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>blackPlayerCombo</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="QGroupBox" name="whitePlayerBox" >
|
||||
<property name="title" >
|
||||
<string/>
|
||||
</property>
|
||||
<layout class="QGridLayout" name="gridLayout_2" >
|
||||
<item row="0" column="0" >
|
||||
<widget class="QLabel" name="label_4" >
|
||||
<property name="text" >
|
||||
<string>White:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>whitePlayerCombo</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="0" column="1" >
|
||||
<widget class="KComboBox" name="whitePlayerCombo" >
|
||||
<item>
|
||||
<property name="text" >
|
||||
<string>Human</string>
|
||||
</property>
|
||||
</item>
|
||||
<item>
|
||||
<property name="text" >
|
||||
<string>Computer</string>
|
||||
</property>
|
||||
</item>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="0" >
|
||||
<widget class="QLabel" name="label_3" >
|
||||
<property name="text" >
|
||||
<string>Name:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>whitePlayerName</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="1" >
|
||||
<widget class="KLineEdit" name="whitePlayerName" >
|
||||
<property name="enabled" >
|
||||
<bool>false</bool>
|
||||
</property>
|
||||
<property name="text" >
|
||||
<string/>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="QGroupBox" name="difficultyBox" >
|
||||
<property name="enabled" >
|
||||
<bool>false</bool>
|
||||
</property>
|
||||
<property name="title" >
|
||||
<string>Computer Difficulty</string>
|
||||
</property>
|
||||
<layout class="QGridLayout" name="gridLayout_4" >
|
||||
<item row="0" column="0" colspan="2" >
|
||||
<widget class="QSlider" name="difficultySlider" >
|
||||
<property name="enabled" >
|
||||
<bool>false</bool>
|
||||
</property>
|
||||
<property name="minimum" >
|
||||
<number>1</number>
|
||||
</property>
|
||||
<property name="maximum" >
|
||||
<number>10</number>
|
||||
</property>
|
||||
<property name="pageStep" >
|
||||
<number>1</number>
|
||||
</property>
|
||||
<property name="value" >
|
||||
<number>1</number>
|
||||
</property>
|
||||
<property name="orientation" >
|
||||
<enum>Qt::Horizontal</enum>
|
||||
</property>
|
||||
<property name="tickPosition" >
|
||||
<enum>QSlider::TicksBelow</enum>
|
||||
</property>
|
||||
<property name="tickInterval" >
|
||||
<number>0</number>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="0" >
|
||||
<widget class="QLabel" name="label1" >
|
||||
<property name="text" >
|
||||
<string>Easy</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignLeading|Qt::AlignLeft|Qt::AlignTop</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>difficultySlider</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="1" >
|
||||
<widget class="QLabel" name="label2" >
|
||||
<property name="text" >
|
||||
<string>Hard</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTop|Qt::AlignTrailing</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>difficultySlider</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="QGroupBox" name="loadedGameBox" >
|
||||
<property name="enabled" >
|
||||
<bool>true</bool>
|
||||
</property>
|
||||
<property name="sizePolicy" >
|
||||
<sizepolicy vsizetype="Preferred" hsizetype="Preferred" >
|
||||
<horstretch>0</horstretch>
|
||||
<verstretch>0</verstretch>
|
||||
</sizepolicy>
|
||||
</property>
|
||||
<property name="title" >
|
||||
<string>Loaded Game Setup</string>
|
||||
</property>
|
||||
<layout class="QHBoxLayout" name="horizontalLayout" >
|
||||
<item>
|
||||
<widget class="QLabel" name="label_2" >
|
||||
<property name="text" >
|
||||
<string>Start with Move:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>startMoveSpinBox</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="KIntSpinBox" name="startMoveSpinBox" />
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="QGroupBox" name="newGameBox" >
|
||||
<property name="enabled" >
|
||||
<bool>true</bool>
|
||||
</property>
|
||||
<property name="sizePolicy" >
|
||||
<sizepolicy vsizetype="Preferred" hsizetype="Preferred" >
|
||||
<horstretch>0</horstretch>
|
||||
<verstretch>0</verstretch>
|
||||
</sizepolicy>
|
||||
</property>
|
||||
<property name="title" >
|
||||
<string>New Game Setup</string>
|
||||
</property>
|
||||
<layout class="QVBoxLayout" name="verticalLayout_3" >
|
||||
<item>
|
||||
<widget class="KButtonGroup" name="sizeGroupBox" >
|
||||
<property name="title" >
|
||||
<string>BoardSize</string>
|
||||
</property>
|
||||
<property name="flat" >
|
||||
<bool>false</bool>
|
||||
</property>
|
||||
<property name="current" stdset="0" >
|
||||
<number>2</number>
|
||||
</property>
|
||||
<layout class="QGridLayout" name="gridLayout" >
|
||||
<item row="0" column="0" colspan="2" >
|
||||
<widget class="QRadioButton" name="sizeSmall" >
|
||||
<property name="text" >
|
||||
<string>Tiny (9x9)</string>
|
||||
</property>
|
||||
<property name="checked" >
|
||||
<bool>false</bool>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="0" colspan="2" >
|
||||
<widget class="QRadioButton" name="sizeMedium" >
|
||||
<property name="text" >
|
||||
<string>Small (13x13)</string>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="2" column="0" colspan="2" >
|
||||
<widget class="QRadioButton" name="sizeBig" >
|
||||
<property name="text" >
|
||||
<string>Normal (19x19)</string>
|
||||
</property>
|
||||
<property name="checked" >
|
||||
<bool>true</bool>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="3" column="0" >
|
||||
<widget class="QRadioButton" name="sizeOther" >
|
||||
<property name="text" >
|
||||
<string>Other:</string>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="3" column="1" >
|
||||
<widget class="QSpinBox" name="sizeOtherSpinBox" >
|
||||
<property name="enabled" >
|
||||
<bool>false</bool>
|
||||
</property>
|
||||
<property name="minimum" >
|
||||
<number>5</number>
|
||||
</property>
|
||||
<property name="maximum" >
|
||||
<number>19</number>
|
||||
</property>
|
||||
<property name="value" >
|
||||
<number>19</number>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<layout class="QGridLayout" name="gridLayout_5" >
|
||||
<item row="0" column="0" >
|
||||
<widget class="QLabel" name="label_7" >
|
||||
<property name="text" >
|
||||
<string>Komi:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>komiSpinBox</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="0" column="1" >
|
||||
<widget class="QDoubleSpinBox" name="komiSpinBox" >
|
||||
<property name="suffix" >
|
||||
<string> Points</string>
|
||||
</property>
|
||||
<property name="decimals" >
|
||||
<number>1</number>
|
||||
</property>
|
||||
<property name="maximum" >
|
||||
<double>50.000000000000000</double>
|
||||
</property>
|
||||
<property name="value" >
|
||||
<double>4.500000000000000</double>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="0" >
|
||||
<widget class="QLabel" name="label_8" >
|
||||
<property name="text" >
|
||||
<string>Fixed Handicap:</string>
|
||||
</property>
|
||||
<property name="alignment" >
|
||||
<set>Qt::AlignRight|Qt::AlignTrailing|Qt::AlignVCenter</set>
|
||||
</property>
|
||||
<property name="buddy" >
|
||||
<cstring>handicapSpinBox</cstring>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="1" >
|
||||
<widget class="QSpinBox" name="handicapSpinBox" >
|
||||
<property name="suffix" >
|
||||
<string> Stones</string>
|
||||
</property>
|
||||
<property name="maximum" >
|
||||
<number>9</number>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<spacer name="verticalSpacer_2" >
|
||||
<property name="orientation" >
|
||||
<enum>Qt::Vertical</enum>
|
||||
</property>
|
||||
<property name="sizeHint" stdset="0" >
|
||||
<size>
|
||||
<width>38</width>
|
||||
<height>33</height>
|
||||
</size>
|
||||
</property>
|
||||
</spacer>
|
||||
</item>
|
||||
</layout>
|
||||
<zorder>blackPlayerBox</zorder>
|
||||
<zorder>whitePlayerBox</zorder>
|
||||
<zorder>difficultyBox</zorder>
|
||||
<zorder>loadedGameBox</zorder>
|
||||
<zorder>newGameBox</zorder>
|
||||
<zorder>verticalSpacer_2</zorder>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="0" column="1" colspan="2" >
|
||||
<widget class="QFrame" name="frame_3" >
|
||||
<property name="frameShape" >
|
||||
<enum>QFrame::NoFrame</enum>
|
||||
</property>
|
||||
<property name="frameShadow" >
|
||||
<enum>QFrame::Raised</enum>
|
||||
</property>
|
||||
<property name="lineWidth" >
|
||||
<number>0</number>
|
||||
</property>
|
||||
<layout class="QVBoxLayout" name="verticalLayout_2" >
|
||||
<property name="margin" >
|
||||
<number>0</number>
|
||||
</property>
|
||||
<item>
|
||||
<widget class="QGroupBox" name="infoBox" >
|
||||
<property name="sizePolicy" >
|
||||
<sizepolicy vsizetype="Fixed" hsizetype="Preferred" >
|
||||
<horstretch>0</horstretch>
|
||||
<verstretch>0</verstretch>
|
||||
</sizepolicy>
|
||||
</property>
|
||||
<property name="title" >
|
||||
<string>Game Information</string>
|
||||
</property>
|
||||
<layout class="QVBoxLayout" name="verticalLayout" >
|
||||
<item>
|
||||
<widget class="QLabel" name="label" >
|
||||
<property name="text" >
|
||||
<string>PLACEHOLDER</string>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item>
|
||||
<widget class="QFrame" name="previewFrame" >
|
||||
<property name="frameShape" >
|
||||
<enum>QFrame::StyledPanel</enum>
|
||||
</property>
|
||||
<property name="frameShadow" >
|
||||
<enum>QFrame::Raised</enum>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
</item>
|
||||
<item row="1" column="0" colspan="2" >
|
||||
<spacer name="horizontalSpacer" >
|
||||
<property name="orientation" >
|
||||
<enum>Qt::Horizontal</enum>
|
||||
</property>
|
||||
<property name="sizeHint" stdset="0" >
|
||||
<size>
|
||||
<width>577</width>
|
||||
<height>27</height>
|
||||
</size>
|
||||
</property>
|
||||
</spacer>
|
||||
</item>
|
||||
<item row="1" column="2" >
|
||||
<widget class="KPushButton" name="startButton" >
|
||||
<property name="sizePolicy" >
|
||||
<sizepolicy vsizetype="Fixed" hsizetype="Fixed" >
|
||||
<horstretch>0</horstretch>
|
||||
<verstretch>0</verstretch>
|
||||
</sizepolicy>
|
||||
</property>
|
||||
<property name="text" >
|
||||
<string>Start Game</string>
|
||||
</property>
|
||||
<property name="shortcut" >
|
||||
<string>Ctrl+S</string>
|
||||
</property>
|
||||
</widget>
|
||||
</item>
|
||||
</layout>
|
||||
</widget>
|
||||
<customwidgets>
|
||||
<customwidget>
|
||||
<class>KButtonGroup</class>
|
||||
<extends>QGroupBox</extends>
|
||||
<header>kbuttongroup.h</header>
|
||||
<container>1</container>
|
||||
</customwidget>
|
||||
<customwidget>
|
||||
<class>KComboBox</class>
|
||||
<extends>QComboBox</extends>
|
||||
<header>kcombobox.h</header>
|
||||
</customwidget>
|
||||
<customwidget>
|
||||
<class>KIntSpinBox</class>
|
||||
<extends>QSpinBox</extends>
|
||||
<header>knuminput.h</header>
|
||||
</customwidget>
|
||||
<customwidget>
|
||||
<class>KLineEdit</class>
|
||||
<extends>QLineEdit</extends>
|
||||
<header>klineedit.h</header>
|
||||
</customwidget>
|
||||
<customwidget>
|
||||
<class>KPushButton</class>
|
||||
<extends>QPushButton</extends>
|
||||
<header>kpushbutton.h</header>
|
||||
</customwidget>
|
||||
</customwidgets>
|
||||
<tabstops>
|
||||
<tabstop>blackPlayerCombo</tabstop>
|
||||
<tabstop>blackPlayerName</tabstop>
|
||||
<tabstop>whitePlayerCombo</tabstop>
|
||||
<tabstop>whitePlayerName</tabstop>
|
||||
<tabstop>difficultySlider</tabstop>
|
||||
<tabstop>startMoveSpinBox</tabstop>
|
||||
<tabstop>startButton</tabstop>
|
||||
</tabstops>
|
||||
<resources/>
|
||||
<connections/>
|
||||
</ui>
|
220
src/gui/themerenderer.cpp
Normal file
220
src/gui/themerenderer.cpp
Normal file
|
@ -0,0 +1,220 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and implements the class ThemeRenderer,
|
||||
* which provides means to get parts of the current selected theme.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#include "themerenderer.h"
|
||||
#include "preferences.h"
|
||||
|
||||
#include <QPixmap>
|
||||
#include <QPainter>
|
||||
|
||||
#include <KSvgRenderer>
|
||||
#include <KStandardDirs>
|
||||
#include <KPixmapCache>
|
||||
#include <KGameTheme>
|
||||
#include <KDebug>
|
||||
|
||||
namespace KGo {
|
||||
|
||||
ThemeRenderer::ThemeRenderer()
|
||||
: m_renderer(new KSvgRenderer)
|
||||
, m_cache(new KPixmapCache("kgo-cache"))
|
||||
{
|
||||
m_cache->setCacheLimit(3 * 1024);
|
||||
if (!loadTheme(Preferences::theme()))
|
||||
kDebug() << "Failed to load any game theme!";
|
||||
}
|
||||
|
||||
ThemeRenderer::~ThemeRenderer()
|
||||
{
|
||||
delete m_cache;
|
||||
delete m_renderer;
|
||||
}
|
||||
|
||||
bool ThemeRenderer::loadTheme(const QString &themeName)
|
||||
{
|
||||
bool discardCache = !m_currentTheme.isEmpty();
|
||||
|
||||
if (!m_currentTheme.isEmpty() && m_currentTheme == themeName) {
|
||||
kDebug() << "Notice: Loading the same theme";
|
||||
return true; // We don't have to do anything
|
||||
}
|
||||
|
||||
m_currentTheme = themeName;
|
||||
|
||||
KGameTheme theme;
|
||||
if (themeName.isEmpty() || !theme.load(themeName)) {
|
||||
kDebug() << "Failed to load theme" << Preferences::theme();
|
||||
kDebug() << "Trying to load default";
|
||||
if (!theme.loadDefault())
|
||||
return true;
|
||||
|
||||
discardCache = true;
|
||||
m_currentTheme = "default";
|
||||
}
|
||||
|
||||
kDebug() << "Loading" << theme.graphics();
|
||||
if (!m_renderer->load(theme.graphics()))
|
||||
return false;
|
||||
|
||||
if (discardCache) {
|
||||
kDebug() << "Discarding cache";
|
||||
m_cache->discard();
|
||||
}
|
||||
return true;
|
||||
}
|
||||
|
||||
void ThemeRenderer::renderElement(Element element, QPainter *painter, const QRectF &rect) const
|
||||
{
|
||||
if (!m_renderer->isValid() || rect.isEmpty() || painter == 0)
|
||||
return;
|
||||
|
||||
QPixmap pixmap = renderElement(element, rect.size().toSize());
|
||||
|
||||
// Draw pixmap with the parameter provided painter
|
||||
painter->drawPixmap(static_cast<int>(rect.x()), static_cast<int>(rect.y()), pixmap);
|
||||
}
|
||||
|
||||
QPixmap ThemeRenderer::renderElement(Element element, const QSize &size) const
|
||||
{
|
||||
if (!m_renderer->isValid() || size.isEmpty())
|
||||
return QPixmap();
|
||||
|
||||
// Determine which board element we have to render and set the cache item name
|
||||
QString cacheName;
|
||||
switch (element) {
|
||||
case SceneBackground:
|
||||
cacheName = QString("background_%1x%2").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
case BoardBackground:
|
||||
cacheName = QString("board_background_%1x%2").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
case BoardCell:
|
||||
cacheName = QString("board_cell_%1x%2").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
case BoardHandicapMark:
|
||||
cacheName = QString("board_handicap_mark_%1x%2").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
case BoardLabels:
|
||||
cacheName = QString("board_labels_%1x%2").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
case WhiteStone:
|
||||
cacheName = QString("board_stone_white_%1x%2").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
case WhiteStoneTransparent:
|
||||
cacheName = QString("board_stone_white_%1x%2_trans").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
case BlackStone:
|
||||
cacheName = QString("board_stone_black_%1x%2").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
case BlackStoneTransparent:
|
||||
cacheName = QString("board_stone_black_%1x%2_trans").arg(size.width()).arg(size.height());
|
||||
break;
|
||||
}
|
||||
|
||||
// Check if board element is already in cache, if not render it
|
||||
QPixmap pixmap;
|
||||
if (!m_cache->find(cacheName, pixmap)) {
|
||||
pixmap = QPixmap(size);
|
||||
pixmap.fill(Qt::transparent);
|
||||
QPainter p(&pixmap);
|
||||
switch (element) {
|
||||
case SceneBackground:
|
||||
m_renderer->render(&p, "background");
|
||||
break;
|
||||
case BoardBackground:
|
||||
m_renderer->render(&p, "board_background");
|
||||
break;
|
||||
case BoardCell:
|
||||
m_renderer->render(&p, "board_cell");
|
||||
break;
|
||||
case BoardHandicapMark:
|
||||
m_renderer->render(&p, "board_handicap_mark");
|
||||
break;
|
||||
case BoardLabels:
|
||||
m_renderer->render(&p, "board_labels");
|
||||
break;
|
||||
case WhiteStone:
|
||||
m_renderer->render(&p, "board_stone_white");
|
||||
break;
|
||||
case WhiteStoneTransparent:
|
||||
p.setOpacity(0.5);
|
||||
m_renderer->render(&p, "board_stone_white");
|
||||
break;
|
||||
case BlackStone:
|
||||
m_renderer->render(&p, "board_stone_black");
|
||||
break;
|
||||
case BlackStoneTransparent:
|
||||
p.setOpacity(0.5);
|
||||
m_renderer->render(&p, "board_stone_black");
|
||||
break;
|
||||
}
|
||||
p.end();
|
||||
m_cache->insert(cacheName, pixmap);
|
||||
}
|
||||
return pixmap;
|
||||
}
|
||||
|
||||
QSize ThemeRenderer::elementSize(Element element) const
|
||||
{
|
||||
QRectF sizeRect;
|
||||
switch(element) {
|
||||
case SceneBackground:
|
||||
sizeRect = m_renderer->boundsOnElement("background");
|
||||
break;
|
||||
case BoardBackground:
|
||||
sizeRect = m_renderer->boundsOnElement("board_background");
|
||||
break;
|
||||
case BoardCell:
|
||||
sizeRect = m_renderer->boundsOnElement("board_cell");
|
||||
break;
|
||||
case BoardHandicapMark:
|
||||
sizeRect = m_renderer->boundsOnElement("board_handicap_mark");
|
||||
break;
|
||||
case BoardLabels:
|
||||
sizeRect = m_renderer->boundsOnElement("board_labels");
|
||||
break;
|
||||
case WhiteStone:
|
||||
sizeRect = m_renderer->boundsOnElement("board_stone_white");
|
||||
break;
|
||||
case WhiteStoneTransparent:
|
||||
sizeRect = m_renderer->boundsOnElement("board_stone_white");
|
||||
break;
|
||||
case BlackStone:
|
||||
sizeRect = m_renderer->boundsOnElement("board_stone_black");
|
||||
break;
|
||||
case BlackStoneTransparent:
|
||||
sizeRect = m_renderer->boundsOnElement("board_stone_black");
|
||||
break;
|
||||
}
|
||||
return QSize((int)sizeRect.width(), (int)sizeRect.height());
|
||||
}
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#include "moc_themerenderer.cpp"
|
129
src/gui/themerenderer.h
Normal file
129
src/gui/themerenderer.h
Normal file
|
@ -0,0 +1,129 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and defines the class ThemeRenderer,
|
||||
* which provides means to get parts of the current selected theme.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#ifndef KGO_THEMERENDERER_H
|
||||
#define KGO_THEMERENDERER_H
|
||||
|
||||
#include <QString>
|
||||
|
||||
class QPixmap;
|
||||
class QRectF;
|
||||
class QSize;
|
||||
class QPainter;
|
||||
class KSvgRenderer;
|
||||
class KPixmapCache;
|
||||
|
||||
namespace KGo {
|
||||
|
||||
/**
|
||||
* The class ThemeRenderer loads shapes from a SVG theme file and converts them into
|
||||
* pixmaps which can be used by QGraphicsView classes to display the game scene.
|
||||
* The class is implemented as a singleton because it is needed only once per
|
||||
* application and uses a pixamp cache to efficiently store the pixmaps.
|
||||
*
|
||||
* ThemeRenderer is implemented as a singleton.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
* @since 0.1
|
||||
*/
|
||||
class ThemeRenderer
|
||||
{
|
||||
private:
|
||||
ThemeRenderer();
|
||||
~ThemeRenderer();
|
||||
|
||||
public:
|
||||
/**
|
||||
* Enumeration of all possible renderable scene element types.
|
||||
*/
|
||||
enum Element {
|
||||
SceneBackground = 0x0, ///<
|
||||
BoardBackground = 0x1, ///<
|
||||
BoardCell = 0x2, ///<
|
||||
BoardHandicapMark = 0x3, ///<
|
||||
BoardLabels = 0x4, ///<
|
||||
WhiteStone = 0x5, ///<
|
||||
WhiteStoneTransparent = 0x6, ///<
|
||||
BlackStone = 0x7, ///<
|
||||
BlackStoneTransparent = 0x8 //<<
|
||||
};
|
||||
|
||||
/**
|
||||
* Only one ThemeRenderer is needed per application, this method returns
|
||||
* the singleton instance.
|
||||
*
|
||||
* @return ThemeRenderer instance
|
||||
*/
|
||||
inline static ThemeRenderer* instance()
|
||||
{
|
||||
static ThemeRenderer instance;
|
||||
return &instance;
|
||||
}
|
||||
|
||||
/**
|
||||
* Load the game theme specified by 'name'. See the correspondig KConfigXT
|
||||
* settings file and available themes for details.
|
||||
*
|
||||
* @param themeName The name of the theme to load
|
||||
*/
|
||||
bool loadTheme(const QString &themeName);
|
||||
|
||||
/**
|
||||
* Renders a specific element of the current SVG theme.
|
||||
*
|
||||
* @param element Determines which part of the theme to render
|
||||
* @param painter The QPainter to paint the element with
|
||||
* @param rect The desired size of the element to render
|
||||
*/
|
||||
void renderElement(Element element, QPainter *painter, const QRectF &rect) const;
|
||||
/**
|
||||
* Renders and returns a specific element of the current SVG theme.
|
||||
*
|
||||
* @param element Determines which part of the theme to render
|
||||
* @param size The desired size of the element to render
|
||||
*/
|
||||
QPixmap renderElement(Element element, const QSize &size) const;
|
||||
|
||||
/**
|
||||
* Retrieves the default size of a given theme element from the current SVG theme.
|
||||
*
|
||||
* @param element The theme element to return the size of
|
||||
* @return The rounded size of the elements rectangle
|
||||
*/
|
||||
QSize elementSize(Element element) const;
|
||||
|
||||
private:
|
||||
QString m_currentTheme; ///< Holds the current seleted theme
|
||||
KSvgRenderer *m_renderer; ///< Converts SVG parts into pixmaps
|
||||
KPixmapCache *m_cache; ///< Stores pixmaps efficiently
|
||||
};
|
||||
|
||||
} // End of namespace KGo
|
||||
|
||||
#endif
|
66
src/kgo.kcfg
Normal file
66
src/kgo.kcfg
Normal file
|
@ -0,0 +1,66 @@
|
|||
<?xml version="1.0" encoding="UTF-8"?>
|
||||
<kcfg xmlns="http://www.kde.org/standards/kcfg/1.0"
|
||||
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
||||
xsi:schemaLocation="http://www.kde.org/standards/kcfg/1.0
|
||||
http://www.kde.org/standards/kcfg/1.0/kcfg.xsd">
|
||||
<kcfgfile name="kgo" />
|
||||
<group name="Backend">
|
||||
<entry name="EngineCommand" type="String">
|
||||
<label>Path to the Go game engine</label>
|
||||
<tooltip>Enter here a valid path to your favorite Go game engine executable</tooltip>
|
||||
<default>gnugo --mode gtp</default>
|
||||
</entry>
|
||||
</group>
|
||||
<group name="UserInterface">
|
||||
<entry name="Theme" type="String">
|
||||
<label>The graphical theme to be used</label>
|
||||
<default>default</default>
|
||||
</entry>
|
||||
</group>
|
||||
<group name="Game">
|
||||
<entry name="BlackPlayerHuman" type="Bool">
|
||||
<label>Is black a human player?</label>
|
||||
<default>true</default>
|
||||
</entry>
|
||||
<entry name="BlackPlayerName" type="String">
|
||||
<label>The name of the black player</label>
|
||||
<default>Black Player</default>
|
||||
</entry>
|
||||
<entry name="WhitePlayerHuman" type="Bool">
|
||||
<label>Is white a human player?</label>
|
||||
<default>false</default>
|
||||
</entry>
|
||||
<entry name="WhitePlayerName" type="String">
|
||||
<label>The name of the white player</label>
|
||||
<default>White Player</default>
|
||||
</entry>
|
||||
<entry name="Difficulty" type="Int">
|
||||
<label>Difficulty level</label>
|
||||
<tooltip>The difficulty level controls the computer player's strength</tooltip>
|
||||
<default>10</default>
|
||||
<min>1</min>
|
||||
<max>10</max>
|
||||
</entry>
|
||||
<entry name="BoardSize" type="Int">
|
||||
<label>Go board size</label>
|
||||
<tooltip></tooltip>
|
||||
<default>19</default>
|
||||
<min>5</min>
|
||||
<max>19</max>
|
||||
</entry>
|
||||
<entry name="Komi" type="Double">
|
||||
<label>Komi</label>
|
||||
<tooltip>With komi you can give the black player some extra points</tooltip>
|
||||
<default>4.5</default>
|
||||
<min>0</min>
|
||||
<max>50</max>
|
||||
</entry>
|
||||
<entry name="FixedHandicap" type="Int">
|
||||
<label>Extra stones for white</label>
|
||||
<tooltip>To make life easier for the white player, you can him extra stones to start with</tooltip>
|
||||
<default>0</default>
|
||||
<min>0</min>
|
||||
<max>9</max>
|
||||
</entry>
|
||||
</group>
|
||||
</kcfg>
|
4
src/kgo.knsrc
Normal file
4
src/kgo.knsrc
Normal file
|
@ -0,0 +1,4 @@
|
|||
[KNewStuff2]
|
||||
ProvidersUrl=http://newstuff.kde.org/cgi-bin/hotstuff-provider?site=kgo
|
||||
TargetDir=kgo/themes
|
||||
Uncompress=true
|
77
src/main.cpp
Normal file
77
src/main.cpp
Normal file
|
@ -0,0 +1,77 @@
|
|||
/*******************************************************************
|
||||
*
|
||||
* Copyright 2008 Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*
|
||||
* This file is part of the KDE project "KGo"
|
||||
*
|
||||
* KGo 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, or (at your option)
|
||||
* any later version.
|
||||
*
|
||||
* KGo 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 KReversi; see the file COPYING. If not, write to
|
||||
* the Free Software Foundation, 51 Franklin Street, Fifth Floor,
|
||||
* Boston, MA 02110-1301, USA.
|
||||
*
|
||||
*******************************************************************
|
||||
*/
|
||||
|
||||
/**
|
||||
* @file This file is part of KGO and contains the main application
|
||||
* entry point.
|
||||
*
|
||||
* @author Sascha Peilicke <sasch.pe@gmx.de>
|
||||
*/
|
||||
#include <KAboutData>
|
||||
#include <KCmdLineArgs>
|
||||
#include <KApplication>
|
||||
#include <KLocale>
|
||||
|
||||
#include "gui/mainwindow.h"
|
||||
|
||||
/**
|
||||
* This namespace collects all classes related to KGo, the Go board game.
|
||||
*/
|
||||
namespace KGo
|
||||
{
|
||||
/* This is only a Doxygen stub */
|
||||
}
|
||||
|
||||
/**
|
||||
* The standard C/C++ program entry point. Application 'about' data
|
||||
* is created here and command line options are configured and checked
|
||||
* if the user invokes the application. If everything is set up, the
|
||||
* method displays the main window and jumps into the Qt event loop.
|
||||
*/
|
||||
int main(int argc, char *argv[])
|
||||
{
|
||||
KAboutData aboutData("kgo", 0, ki18n("KGo"), "v0.2",
|
||||
ki18n("KDE Go Board Game"), KAboutData::License_GPL_V3,
|
||||
ki18n("Copyright (c) 2008 Sascha Peilicke"));
|
||||
aboutData.addAuthor(ki18n("Sascha Peilicke"), ki18n("Original author"), "sasch.pe@gmx.de");
|
||||
aboutData.setHomepage("http://games.kde.org/kgo");
|
||||
KCmdLineArgs::init(argc, argv, &aboutData);
|
||||
|
||||
KCmdLineOptions options;
|
||||
options.add("demo", ki18n("Start with a demo game playing"));
|
||||
KCmdLineArgs::addCmdLineOptions(options);
|
||||
|
||||
KApplication app;
|
||||
KGlobal::locale()->insertCatalog("libkdegames");
|
||||
|
||||
if (app.isSessionRestored()) {
|
||||
RESTORE(KGo::MainWindow)
|
||||
} else {
|
||||
KCmdLineArgs *args = KCmdLineArgs::parsedArgs();
|
||||
KGo::MainWindow *mainWin = new KGo::MainWindow(0, args->isSet("demo"));
|
||||
mainWin->show();
|
||||
args->clear();
|
||||
}
|
||||
return app.exec();
|
||||
}
|
9
src/module.dsc
Normal file
9
src/module.dsc
Normal file
|
@ -0,0 +1,9 @@
|
|||
[ModuleInfo]
|
||||
Name = KGo
|
||||
Author = Sascha Peilicke
|
||||
CommandLine = kgo
|
||||
Frontend = kde
|
||||
Homepage = http://games.kde.org/
|
||||
ProtocolEngine = Go
|
||||
ProtocolVersion = 1
|
||||
Version = 1.0
|
7
src/preferences.kcfgc
Normal file
7
src/preferences.kcfgc
Normal file
|
@ -0,0 +1,7 @@
|
|||
# Code generation options for kconfig_compiler
|
||||
File=kgo.kcfg
|
||||
#IncludeFiles=defines.h
|
||||
ClassName=Preferences
|
||||
Singleton=true
|
||||
CustomAdditions=false
|
||||
Mutators=true
|
3
themes/CMakeLists.txt
Normal file
3
themes/CMakeLists.txt
Normal file
|
@ -0,0 +1,3 @@
|
|||
install(FILES
|
||||
default.desktop kgo_default.svgz
|
||||
DESTINATION ${DATA_INSTALL_DIR}/kgo/themes)
|
60
themes/default.desktop
Normal file
60
themes/default.desktop
Normal file
|
@ -0,0 +1,60 @@
|
|||
[KGameTheme]
|
||||
Name=Default
|
||||
Name[be]=Прадвызначаны
|
||||
Name[br]=Dre ziouer
|
||||
Name[ca]=Predeterminat
|
||||
Name[da]=Standard
|
||||
Name[de]=Standard
|
||||
Name[el]=Προκαθορισμένο
|
||||
Name[eo]=Defaŭlto
|
||||
Name[es]=Predeterminado
|
||||
Name[et]=Vaikimisi
|
||||
Name[fa]=پیشفرض
|
||||
Name[fi]=Oletus
|
||||
Name[fr]=Par défaut
|
||||
Name[ga]=Réamhshocrú
|
||||
Name[gl]=Predeterminado
|
||||
Name[hu]=Alapértelmezés
|
||||
Name[it]=Predefinito
|
||||
Name[ja]=標準
|
||||
Name[km]=លំនាំដើម
|
||||
Name[ko]=기본
|
||||
Name[lv]=Noklusējuma
|
||||
Name[nds]=Standard
|
||||
Name[ne]=पूर्वनिर्धारित
|
||||
Name[nl]=Standaard
|
||||
Name[nn]=Standard
|
||||
Name[oc]=Defaut
|
||||
Name[pl]=Domyślne
|
||||
Name[pt]=Predefinição
|
||||
Name[pt_BR]=Padrão
|
||||
Name[sl]=Privzeto
|
||||
Name[sv]=Förval
|
||||
Name[te]=అప్రమెయం
|
||||
Name[tr]=Öntanımlı
|
||||
Name[uk]=Типові
|
||||
Name[wa]=Prémetou
|
||||
Name[x-test]=xxDefaultxx
|
||||
Name[zh_CN]=默认
|
||||
Name[zh_TW]=預設
|
||||
Description=KGo Default theme for KDE 4
|
||||
Description[el]=Προκαθορισμένο θέμα KGo για το KDE 4
|
||||
Description[es]=Tema predeterminado de KGo para KDE 4
|
||||
Description[ga]=Téama réamhshocraithe KGo le haghaidh KDE 4
|
||||
Description[gl]=Tema predeterminado de KGo para KDE 4
|
||||
Description[ja]=KGo の KDE 4 標準テーマ
|
||||
Description[km]=ស្បែកលំនាំដើមរបស់ KGo សម្រាប់ KDE 4
|
||||
Description[nds]=KGo-Standardmuster för KDE 4
|
||||
Description[pt]=Tema Predefinido para o KGo do KDE 4
|
||||
Description[pt_BR]=Tema padrão do KGo para o KDE4
|
||||
Description[sv]=Standardtema för Ksudoku i KDE4
|
||||
Description[uk]=Типова тема KGo для KDE 4
|
||||
Description[x-test]=xxKGo Default theme for KDE 4xx
|
||||
Description[zh_CN]=为 KDE 4 设计的 KGo 默认主题
|
||||
Description[zh_TW]=KGo KDE4 預設主題
|
||||
VersionFormat=1
|
||||
Author=Sascha Peilicke
|
||||
AuthorEmail=sasch.pe@gmx.de
|
||||
Type=SVG
|
||||
FileName=kgo_default.svgz
|
||||
#Preview=kgo_default.png
|
BIN
themes/kgo_default.svgz
Normal file
BIN
themes/kgo_default.svgz
Normal file
Binary file not shown.
Loading…
Add table
Reference in a new issue