Picpuz User Guide

Description
   Picpuz is a computer "jigsaw puzzle". You can take an image file and break it into 
   pieces which you can then reassemble using the mouse. You can control the puzzle size 
   and number of pieces (tens to hundreds).

License and Warranty
   Picpuz is a free Linux program licensed under the GNU General Public License v.3 
   (Free Software Foundation). Picpuz is not warranted for any purpose whatsoever, but if 
   you find a bug, I will try to fix it.

Origin and Contact
   Picpuz originates from the author's web site at: \_https://kornelix.net
   Other web sites may offer it for download. Modifications could have been made.
   If you have questions, suggestions or a bug to report: mkornelix@gmail.com

Picpuz Primer
   +image: picpuz.jpg

   The buttons along the top of the window have the following functions:

      open     select an image file for a new puzzle (jpg, png, tif ...)
      tile     tile the image (make puzzle pieces)
      mix      tiles are mixed-up in a random manner
      show     show the finished picture in a separate window for guidance. 
      save     save a partially completed puzzle to a file
      resume   load a saved puzzle from a file and resume working on it
      do 1     one tile is chosen at random and placed in its home position
      do 8     8 tiles are chosen at random and placed in their home positions
      line     cycle tile border lines between black, white, and dotted
      quit     exit the application
      help     display the user guide (this file).

   The tile button allows you to set the tile size in pixels. Use a smaller value to make 
   more tiles and a more difficult puzzle. After using the mix button, the puzzle is ready 
   to be worked on. Use the left mouse button to click on any two pieces in sequence: the
   two tiles are exchanged. When you move a tile into a new position, the tile that was 
   there is moved to the position that was vacated. The do 1 and do 8 buttons can be used 
   to cheat a little. The right mouse button can be used to find the right tile for the 
   position clicked.

   You may also drag and drop a file from Nautilus or other file browser. A useful way to 
   operate is to use Nautilus in "icon view" mode to search for and select a suitable 
   image file.

   \bOptional Command Line Parameters
      picpuz -i /image/file/directory    # directory for choosing image files
      picpuz /image/file/name.jpg        # image file to use
    
   \bUninstall
   Debian package: use command: sudo apt remove picpuz
   Tarball: use command: sudo make uninstall
   Appimage package: use command: picpuz -uninstall

   \bPhone Home
   Picpuz will occasionally send a message to its web host for counting users. 
   No information is kept that could be associated with a person or location.


