Picpuz user guide v. 2.5

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 program licensed under the GNU General Public License, Version 3 (from the 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: http://kornelix.squarespace.com/picpuz
Other web sites may offer it for download. Modifications could have been made.
If you have questions, suggestions or a bug to report: kornelix2@gmail.com

Picpuz Primer


The buttons along the top of the window have the following functions:
open
 select an image file for a new puzzle (jpg, png, tif, gif, svg, bmp)
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 help file (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: they 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.

Optional Command Line Parameters
picpuz -i /image/file/directory    # initial directory for image files
picpuz /image/file/name.jpg        # image file to use

Translations
See the text file  /usr/share/doc/picpuz/translations  for guidance on how to modify an existing translation or make a new one for a new language.