gorhill / jigsawpuzzle-rhill

ABOUT
-----

I started this project as an experiment with the HTML5 canvas element.
It grew a bit bigger than what I had imagined, as I kept adding features,
just for the fun and challenge of dealing with geometrical concepts.
Also, for jigsaw puzzle fans out there, I am just happy to enable you to
create your own puzzle, small or big, easy or hard, and with no strings
attached (no ads, no questions asked, etc.)

Portions of this software use the work of...
  * Images:
    * "Autumn Fruits", by Petr Kratochvil
      <http://www.publicdomainpictures.net/view-image.php?image=376>:
      The default picture used in preview mode.
    * "Melbourne Australia", by Michael Stirling
      <http://www.publicdomainpictures.net/view-image.php?image=2876>:
      The default picture used in full mode.
  * Sound effects:
    * The Freesound Project's "klick - 01.wav"
      <http://www.freesound.org/samplesViewSingle.php?id=12842>,
      by Marcus Horndt
      <http://www.freesound.org/usersViewSingle.php?id=4942>
    * The Freesound Project's "klick - 02.wav"
      <http://www.freesound.org/samplesViewSingle.php?id=12843>,
      by Marcus Horndt <http://www.freesound.org/usersViewSingle.php?id=4942>
    * The Freesound Project's "applause_5sec.wav"
      <http://www.freesound.org/samplesViewSingle.php?id=35102>,
      by Mirko Horstmann
      <http://www.freesound.org/usersViewSingle.php?id=140756>
    * The Freesound Project's "applause_5sec.wav"
      <http://www.freesound.org/samplesViewSingle.php?id=35104>,
      by Mirko Horstmann
      <http://www.freesound.org/usersViewSingle.php?id=140756>
    * The Freesound Project's "Applause 9s.mp3"
      <http://www.freesound.org/samplesViewSingle.php?id=60789>,
      by J.Zazvurek
      <http://www.freesound.org/usersViewSingle.php?id=199526>
  * Software:
    * "Calculating the area and centroid of a polygon", by Paul Bourke
       <http://local.wasp.uwa.edu.au/~pbourke/geometry/polyarea/>:
       For his code snippets on how to calculate the centroid of a polygon
       (necessary to be able to rotate pieces properly.)
    * "Javascript base64"
      <http://www.webtoolkit.info/javascript-base64.html>:
      For the code snippet on how to encode/decode Base 64
      (I use Base 64 to encode/decode Jigsaw Puzzle Keys, the current
      mechanism to share custom-made puzzles.
    * "Event properties / Mouse position"
      <http://www.quirksmode.org/js/events_properties.html#position>,
      by Peter-Paul Koch:
      For his code snippet on how to correctly detect mouse coordinates.


LICENSE
-------

License for "jigsawpuzzle-rhill.js" ONLY 
(License was modified from GPL to MIT on 2011-12-02):

jigsawpuzzle-rhill 0.4 (14-Jun-2009) (c) by Raymond Hill

Copyright (C) 2009-2011 by Raymond Hill

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.


FILES
-----

jigsawpuzzle-rhill.php : The web page to display/solve/create Jigsaw puzzles
jigsawpuzzle-rhill.js : The Javascript code implementing Jigsaw puzzle and UI interaction
dbconfig.php : The parameters required to open a connection to a MySQL database

default.jpg : The image to use by default

12842__schluppipuppie__klick_01.ogg / 12842__schluppipuppie__klick_01.wav : Snap sound #1
12843__schluppipuppie__klick_02.ogg / 12843__schluppipuppie__klick_02.wav : Snap sound #2
35102_m1rk0_applause_5sec.ogg / 35102_m1rk0_applause_5sec.mp3 : Short applause
35104_m1rk0_applause_8sec.ogg / 35104_m1rk0_applause_8sec.mp3 : Medium applause
60789_J.Zazvurek_Applause_9s.ogg / 60789_J.Zazvurek_Applause_9s.ogg: Long applause

jigsawpuzzle-rhill-create.sql : SQL dump of database structure