This is the README file for Scopa.

Copyright (C) 2016 Marco Scarpetta <marcoscarpetta02@gmail.com>

Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.

GENERAL INFORMATIONS
====================

This software aims to provide an implementation of the famous Italian
card game "Scopa" (https://en.wikipedia.org/wiki/Scopa). It is written
in Javascript and can work in any modern browser.
It provides 5 variations of the original game and 3 types of cards.

USAGE
=====

Open the file index.html with a web browser. Since this software uses some new
HTML features you must run it inside one of the following browsers:
 * Firefox 48 or any later version (Element.animate was introduced in version 48)
 * Chrome/Chromium 49 or any later version (css variables were introduced in version 49)

Alternatively you can use the Qt application, to be built as described in the
next section.

BUILDING (Qt application)
=========================

The Qt application is very simple. It is just a browser window, based on
Qt WebEngine, that opens the index.html file.

It requires at least Qt 5.7.0, since the Qt WebEngine shipped with this version
is based on Chromium 49.

The following instructions refer to a GNU/Linux system.

To build the application run:

  make

You can specify the directory where Qt 5 include files are on your system 
(default is /usr/include/qt) and the system libraries directory (default is
/usr/lib):

  make QTINCPATH=/path/to/qt/include/files LIBSPATH=/path/to/system/lib/directory

You can use the following command to run the application:

  ./build/bin/scopa

To install the application inside the DIR directory run:

  make DESTDIR=DIR install

Then you can run it with the following command:

  ./DIR/usr/bin/scopa

Or simply run "scopa" if DIR/usr/bin is in your PATH variable.

LICENSING
=========

 * The following files:
 
    - Makefile
    - locale_extractor.py
    - index.html
    - style.css
    - data/icon.png
    - data/icon.svg
    - data/menu.svg
    - data/close.svg
    - data/backgrounds/blue.png
    - data/backgrounds/green.png
    - data/backgrounds/red.png
    - docs/index.html
    - docs/game-class.html
    - docs/style.css
    - js/app.js
    - js/cirulla.js
    - js/classic.js
    - js/cucita.js
    - js/rebello.js
    - js/scopone.js
    - js/utils.js
    - locales/en.js
    - locales/it.js
    - locales_json/en.json
    - locales_json/it.json
    - qt-application/main.cpp
    - tests/tests.js
    
   are part of the Scopa software, Copyright (C) 2016 Marco Scarpetta <marcoscarpetta02@gmail.com>

   Scopa 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.

   Scopa 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 Scopa.  If not, see <http://www.gnu.org/licenses/>.
    
 * The jpg files in the "data/cards/Napoletane" directory are public domain
   images available here: https://commons.wikimedia.org/wiki/Category:Naples_deck

 * The jpg files in the "data/cards/Bergamasche" directory are cropped from
   the public domain image available here: https://commons.wikimedia.org/wiki/File:Carte_bergamasche.jpg
   
 * The jpg files in the "data/cards/Piacentine" directory are cropped from
   the public domain image available here:
   https://commons.wikimedia.org/wiki/File:Carte_piacentine_al_completo.jpg
