# Terminal Frogger
## What's new:
**ver 1.1.0 -- 18jan20**
* Much improved Linux portability.
**ver 1.0.1 -- 12nov19**
* Now allow sideways jumps while floating.
* Improved timing mechanism for smoother gameplay.
* Level 3 now has extra challenges beyond speed increase.
**ver 1.0.0 -- 10nov19**
* Initial release.
===========================================================================
### TerminalFrogger
Terminal frogger is a kid friendly ascii character version of Frogger that plays in a commandline terminal. Pure minimalism with classic sounds and three levels.
@ is a lillypad,
Q is a turtle,
= is a log,
TTT is a truck,
ccc is a car.
Runs on Windows, OSX & Linux.
Keyboard setup is important. You should have a short key-delay and fast repeat setting.
The arrow keys, or wasd-keys, or ijkl-keys control movement. The (x),(q) keys quit.
Includes executables and source code.
===============================================================
## Setup & Running:
Mac users see "osx-setup.txt".
Windows users see "windows-setup.txt".
Unzip the archive. On Windows, 7z [www.7-zip.org] works well for this.
* Resize your terminal to at least 56 chars wide by 21 lines;
* You might want to enlarge the Font so that the window becomes physically larger.
* type the executable name to begin.
OSX: frog_osx
Linux: frog_gnu
Windows: frog.exe
For Linux/OSX users, you can use the "nice" command to be a bit less nice and give each terminal game the highest real time priority.
For example, to run at high priority on OSX type:
"nice -n -20 frog_osx".
or simply use the scripts gnufrog.sh or osxfrog.sh:
osxfrog.sh (on OSX)
or
gnufrog.sh (on Linux)
or
winfrog.bat (on Windows).
---------------------------------------------------------------
Usable keys:
* arrow-keys
* ijkl-keys
* wasd-keys
* (q)=quit
====================================================================
## Compiler Scripts
There are three scripts, wcmp.bat for msWindows, lcmp.sh for Linux, and ocmp.sh for OS-X.
===============================================================
## Build Instructions:
Remember that prebuilt executables are already included. But, if you want to rebuild...
Manually install GNAT GPL from libre.adacore.com/download/.
If necessary, edit the scripts wcmp0.bat & wcmp.bat or lcmp.sh or ocmp.sh so that the correct path to gnatmake is known.
Then, to create new command-line executables for your system:
* on linux type lcmp.sh;
* on OSX type ocmp.sh;
* on Windows type wcmp0.bat followed by wcmp.bat.
===============================================================
## What is special about this project?...freedom...
* uses the Ada programming language & GNAT GPL;
* runs on Windows, OSX, & Linux;
* uses only free open source software [F.O.S.S] tools & libraries;
* portable, transparent code, easy to modify, rebuild;
* uses SFML-Audio and Ogg-Vorbis libs for sounds;
* pure minimalism: just screen, keyboard, no graphics;
===============================================================
## Legal Mumbo Jumbo:
Terminal-Frogger is covered by the GNU GPL v3 as indicated in the sources:
Copyright (C) 2019 <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/>.
----------------------------------------------
## Best Download Site for all my games:
Github.com
--------------------------------------------------
## Earlier Revision History:
