.. -*- coding: utf-8 -*- ==================== |Polyform Puzzler| ==================== .. sidebar:: News **(2008-04-13) Polyform Puzzler Talk Video (Montreal Python)** `Video of my February 7 talk at the Montreal Python users group meeting is now up on the web. `__ It was a lot of fun, and the group seemed to enjoy it. **(2007-04-06) SVG Image Generation Added for Polysticks** And a couple of new polystick puzzles too! **(2006-10-03) Added "How to Extend Polyform Puzzler" Document** The beginnings of development instructions; `available here `__. **(2006-09-22) X3D 3-D Model Generation Added** For polycubes (pentacubes, tetracubes, solid pentominoes, soma cubes). **(2006-09-19) Automatic Save/Restore State Added** Added the ability to automatically save & restore the session state to a user-specified file (``-S``/``--save-search-state`` option). **(2006-09-12) Pentacubes Plus Puzzles Added** Sold under the name "`Super Deluxe Quintillions`_" by Kadon, these 30 pieces are the 29 pentacubes plus a second L3 piece (a.k.a. J3), allowing the construction of box shapes. **(2006-09-04) Tetracube and Pentacube Puzzles Added** Several initial tetracube and pentacube puzzles were added; more to come. **(2006-08-31 -- 09-03) SVG Image Generation Added** For polyominoes, polyiamonds, polyhexes, and polycubes (so far). **(2006-08-28) Heptiamond Puzzles Added** Four heptiamond (order-7 polyiamond, triangle-grid-based) puzzles added. **(2006-08-26) Hexiamond Puzzles Added** Eight hexiamond (order-6 polyiamond, triangle-grid-based) puzzles added. **(2006-08-21) Tetrahex & Pentahex Puzzles Added** Four hexagon-grid-based puzzles added, along with initial unit tests. **(2006-08-08) Polyform Puzzler 1: first release** Ready for download_. But I recommend downloading the `project snapshot`_ or accessing the `SVN repository`_ directly for up-to-date code. **(2006-08-07) Polyform Puzzler: project open for business** Registered on SourceForge in 2000, this project has been dormant since. Not any more! We now have code in a Subversion repository, a mailing list and snapshots. Get puzzling! .. contents:: Overview ======== **Polyforms** are sets of all possible shapes constructed from multiple basic units (squares, triangles, etc.) following some simple rules. These shapes can then be combined into larger shapes, often in many different ways. These are **polyform puzzles**. (More info in the FAQ_.) **Polyform Puzzler** is a set of solvers for many polyform puzzles (like Pentominoes and Soma Cubes), and a software toolkit for exploring & solving polyform puzzles. It consists of a set of front-end applications for specific polyform puzzles and a Python library that does the heavy lifting. New polyforms and new puzzles can easily be defined and added. Python 2.4 or higher is required. Here are some examples of polyform puzzles (all solved & drawn by Polyform Puzzler!): .. figure:: docs/images/pentominoes-6x10.png 6 |x| 10 Pentominoes .. figure:: docs/images/hexiamonds-trefoil.png Hexiamond Trefoil .. figure:: docs/images/pentahex-10x11.png 10 |x| 11 Pentahex Parallelogram .. figure:: docs/images/solid-pentominoes-3x4x5.png 3 |x| 4 |x| 5 Solid Pentominoes .. figure:: docs/images/soma-long-wall.png Soma Cubes Long Wall .. figure:: docs/images/pentacubes-5x9x9-fortress.png 5 |x| 9 |x| 9 Pentacube Fortress .. figure:: docs/images/polysticks-3x7-diamond-lattice.png Polysticks of Order 1-4 in a 3 |x| 7 Diamond Lattice All the details are in the `FAQ `_ and the `Puzzles & Solutions`_ doc. To get up & running quickly, see the Quick-Start_ section of the README_ file. .. _Quick-Start: README.html#quick-start License ======= Polyform Puzzler is copyright ©1998-2007 by `David J. Goodger`_ and licensed under the `GNU General Public License version 2 `_. Download ======== * Get the latest `project snapshot`_ (recommended; it's updated continually). * To access the `SVN repository`_ directly use the following Subversion command:: svn co https://puzzler.svn.sourceforge.net/svnroot/puzzler/trunk/puzzler `Subscribe to the checkins mailing list`__ to get checkin notifications by mail. __ https://lists.sourceforge.net/mailman/listinfo/puzzler-checkins * Get releases from the `project files page`_ (infrequent and probably out of date; I recommend the `project snapshot`_ instead). * Get `a tarball of the solutions `__ (or `view the solutions online here `__). Feedback ======== :Mailing list: puzzler-users@lists.sourceforge.net (subscribe_) :Patches: via the `SourceForge patch manager`_ :Bug Reports: via the `SourceForge bug tracker`_ Documentation ============= * `README `_ * `Copying (license) `_ * `Frequently Asked Questions `_ * `Puzzles & Solutions `_ * `How to Extend Polyform Puzzler `_ * `History (change log) `_ * `To Do List `_ Solutions ========= The `Puzzles & Solutions`_ document lists all implemented puzzles and solution counts where known. We include a `directory containing solutions to the puzzles Polyform Puzzler solves `__. These solutions are also available `as a Gzip-compressed tarball `__. Extras ====== In addition to the main Polyform Puzzler code, in the "``_" repository there is some `maze-generating code`__. __ misc/maze .. footer:: Hosted by |SourceForge|_ · Powered by |Python|_ .. _David J. Goodger: http://python.net/~goodger .. _project files page: http://sourceforge.net/project/showfiles.php?group_id=7049 .. _project snapshot: puzzler-snapshot.tgz .. _SVN repository: https://sourceforge.net/svn/?group_id=7049 .. _subscribe: https://lists.sourceforge.net/mailman/listinfo/puzzler-users .. _SourceForge patch manager: http://sourceforge.net/tracker/?group_id=7049&atid=307049 .. _SourceForge bug tracker: http://sourceforge.net/tracker/?group_id=7049&atid=107049 .. _Super Deluxe Quintillions: http://www.gamepuzzles.com/polycube.htm#SQd .. |Polyform Puzzler| image:: docs/images/puzzler.png .. |SourceForge| image:: http://sourceforge.net/sflogo.php?group_id=7049 :alt: SourceForge :align: middle :class: borderless :width: 88 :height: 31 .. _SourceForge: http://www.sourceforge.net/projects/puzzler .. |Python| image:: python-logo.gif :alt: Python :align: middle :class: borderless :width: 178 :height: 45 .. _Python: http://www.python.org .. |---| unicode:: U+2014 .. em dash :trim: .. |c| unicode:: U+00A9 .. copyright sign .. |x| unicode:: U+00D7 .. multiplication sign :trim: .. Local Variables: mode: indented-text indent-tabs-mode: nil sentence-end-double-space: t fill-column: 70 End: