PerlJigSawPuzzle Files

PJSP2: A Jigsaw Puzzle Game in Perl, with Tk and GD

Author                  Peter Vickers (pvikazz@gmail.com)
Programming Language    Perl 5.22.1
Install Requires        Tk, GD
Platform                Developed and tested with Linux Ubuntu 16.04
Version                 2.0
Development Status      Beta
Intended Audience       End Users/Destop

LICENSE	

        Copyright 2019 Peter Vickers
        Software and attending documentation are released under the MIT license.
        See LICENSE.txt.

DEVELOPMENT ENVIRONMENT

        Dell Inspiron 1525 Core-Duo laptop
        4GB memory, 250GB harddrive
        Viewsonic 1680x1050 external monitor

DESCRIPTION

        pjsp2 is a simple perl script to assemble jigsaw puzzles.
        Includes 10 Public Domain and Creative Commons Zero licensed images.

INSTALLATION

        Move to or create the directory to where you want the project installed
        and unpack the file. This creates the project directory pjsp-2.
        Move to that directory, and enable execute permission for the script.

OPERATION

        There are two ways to run the script:
        During installation, create an environment variable, PJSP, in your
        shell startup script:

        export PJSP=<path-to-the-install-directory>/pjsp-2

        (For immediate effect, also create the PJSP variable at the command line.)

        Copy the script to a local directory that is in your PATH, or add the
        <path-to-the-install directory>/pjsp-2 to the PATH.
        type 'pjsp2' at the command line.

        Or:

        Since the project contains everything needed for operation, the
        script can be run by moving to the project directory and typing
        './pjsp2'.

        Be sure to check that your Perl distribution includes the modules
        listed at the beginning of the script. Also, ensure your system knows
        about the functions 'xdtool' and 'xwininfo', since they're needed
        when checking the dimensions of the display.


OVERVIEW OF OPERATIONAL CHANGES

        1. Replaced listbox with a scrollable column to display puzzle
           thumbnails, removing the need to add, edit or delete puzzles.

        2. Replaced 'sources' directory of source directories with 
           flat 'images' directory that holds all raw images.

        3. Added 'thumbs' directory to support puzzle selection.

        4. Removed limitation on placement of plugs and sockets.

        5. Added puzzle piece rotation.

        6. Added a companion script to allow limited changes to plug
           and socket styles, along with four examples.

        7. Updated manual to reflect these changes.

MANIFEST
 .:
  attribution_pd_cc0.txt
  config.csv
  pjsp2
  pbzr2
  LICENSE.txt
  partials.csv
  manual.pdf
  profile1.csv
  profile2.csv
  profile3.csv
  profile4.csv
  README.txt (this file)
  images directory
  thumbs directory

 ./images:
  Franz_Xaver_Winterhalter_-_Portrait_of_Leonilla,_Princess_of_Sayn-Wittgenstein-Sayn_-_Google_Art_Project.jpg
  Oil_Study_of_Cotopaxi_Frederic_Edwin_Church.jpg
  Raphael_School_of_Athens.jpg
  1280px-Pieter_Brueghel_the_Elder_-_The_Dutch_Proverbs_-_Google_Art_Project.jpg
  leaves-2630470_1280.jpg
  scarlet-sails-1046381_1280.jpg
  alone-in-sundown.jpg
  cowgirl-rodeo-painting.jpg
  old-english-house.jpg
  saltwhistle-bay-mayreau-64951288170489SZMJ.jpg

./thumbs:
 thumbnail versions of files in the images directory