RufasSlider Files

RufasSlider Beta 1.8 24feb2015
-----------------------------------------
What's new:
. restart function <r>
. improved rectangle selection mechanics
. more predefined puzzles
. a few more traffic rush puzzles predefined
. now animate rush cars to leave garage
. now outline goal positions
. documented sound media file
. documented png loader
------------------ v 1.5 1dec14 -----------------------
. 5 more rush puzzle files predefined (difficult)
. added forced setting of forward-compatible-bit, even
  though SDL default is forward-compatible, and now test
  for it because, currently, OSX MUST have that bit set.

---------------- v 1.6 25jan15 --------------------------
. changed control logic to allow block-selections to persist as
  long as possible in order to simplify gameplay.
. all puzzles are now in directory ./puzzles/
. elliminated command line parameter;
. all puzzles load at startup and user cycles thru them using
  the <n> (next) or <p> (previous) keys;  easier ones first;
. the <b> (bigger) or <s> (smaller) keys allow user to control size;
. fixed several errors;

---------------- v 1.7 06feb15 --------------------------
. added help screen with <h> key toggle, both slider & rush.
  so to summarize:
  . <n>, <p> : next, previous puzzle;
  . <b>, <s> : bigger, smaller;
  . <r> : restart;
  . <esc> : quit;
. both slider & rush now begin with puzzle last played;
. upgraded traffic rush with new car textures;

---------------- v 1.8 24feb15 --------------------------
. added several easy (for the kids) rush puzzles;
. added the following single-game classic puzzles from
  the early 20th century, some with L-shaped blocks:
	. eight
	. fifteen
	. panama
	. maboy
	. gmg (GetMyGoat)
	. hio (HoleInOne)

================================================================

RufaSlider contains several variants of block slider puzzles including "Klotski" and "Traffic-Rush".

The Klotski variant, called "slider", uses rectangles of 4 sizes: 1x1, 2x2, 1x2, 2x1. The objective in each game is stated near the window top, but usually involves moving a large block to a specified location within the window.

The Traffic-Rush variant, called "rush", uses data, with 2x1, 1x2, 3x1, 1x3 rectangles. Here, the long rectangles represent cars or trucks that can only move [roll] lengthwise...the goal being to move the red car toward the "garage door" on the right.

Note that either game description file is a simple text file with a particular format that allows users to easily define additional puzzles.

Now, with several other classic block slider games incuding fifteen, eight, panama, MaBoy, GetMyGoat, and HoleInOne.

To move a block, use the arrow keys. If the automatic block selector chooses the wrong block, simply click the cursor on the desired block before using the arrow key. Thusly, the games are laptop friendly.

Works on Macs running OS-X and PCs running GNU/Linux.

############################

. Uses SDL2;
. Works on OS-X Retina displays;
. Uses SFML for applause sound;
. all runtime files are in ./data/
. all game data files are in ./puzzles/

----------------------------------------------

Build Requirements:
1) a recent gcc compiler that supports -std=c++11;
2) GLEW;
3) SDL2;
4) GLM;
5) graphics card that supports OpenGL version 3.3 or later;
6) SFML

Then you might need to tinker with the build scripts to get the
directories to correctly match your environment...

-------------------------------------------------------
MacOSX:

bldOsx_static.sh:  static build script for generating a portable executable that will run on most OS-X platforms whether or not they have non-standard libraries such as GLEW, SDL2, SFML installed.  I used this to build the OSX executables that I deliver named *_osx

------------------------------------------------------
GNU/Linux:  

lcmpll.sh:  utilizes the relocatable libraries that I deliver in this bundle under ./libLocal/.  I use this to build the dynamic [gnu/linux] executable that I deliver, which should run in the presence of ./libLocal, whether or not your system has the libraries in it.  This was used to create the dynamic gnu/linux executables named *_gnull



################################################
Running:

Ensure the directory structure is preserved, and the executable is collocated with the ./data/, ./puzzles/, and ./libLocal/ directories. 

To move a block, use the arrow keys  <up>,<dn>,<lf>,<rt>;  If there is an ambiguity and the "automatic" selection mechanism chooses the wrong block to be moved, simply click on the desired block with the cursor before hitting a directional arrow.  At any time, hit the letter <r> to reset/restart, or <esc> to quit.  

For rush and slider you use the <n> key to go to the next puzzle, which in general is more difficult.  The <p> key takes you to the previous puzzle.


Please send questions, comments or corrections to

	fastrgv@gmail.com


--
-- Copyright (C) 2015  <fastrgv@gmail.com>
--
-- This program is free software: you can redistribute it and/or modify
-- it under the terms of the GNU General Public License as published by
-- the Free Software Foundation, either version 3 of the License, or
-- (at your option) any later version.
--
-- This program is distributed in the hope that it will be useful,
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
-- GNU General Public License for more details.
--
-- You may read the full text of the GNU General Public License
-- at <http://www.gnu.org/licenses/>.
--
==========================================================================
Media Files for RufasSlider:


General Note
============
The particular choice of sound file delivered is not essential to the function of the game and is easily replaced.  This software is primarily intended as a tutorial example of modern OpenGL methods.  The only requirements are that sounds be in WAV format.

SoundFile (small-applause.wav)
===========
...is from freesound.org and is covered by the Creative Commons Attribution noncommercial license documented in the accompanying file creativeCommons.txt.   See "small-applause.txt" for details and URL.


ImageFiles (*.png)
==========
...for text-textures were created using gimp and are also covered by the GNU GPL v3 license.  Thanks to unluckystudio.com [Sujit Kumar Yadav] for car sprites, whose colors I modified slightly with GIMP.


LodePNG (png loader module)
========
lodepng.cpp lodepng.h
are files copyrighted by Lode Vandevenne and so marked
with all the details of their permitted uses 
near the tops of those two files.