jzjisawesome/15slide

A fun, cross-platform, slidy-tile game written with C++ 17!

15Slide is a fun, cross-platform, slidy-tile game written with C++17!

The goal is to put the tiles back in order, with the empty space last. Simple.

Visit the wiki and the 15Slide website.

Where do I start?

You should start by installing or building 15Slide. Once you have 15Slide, start it, learn how to play, and contribute.

Source Documentation

Find the Doxygen documentation of 15Slide source at https://jzjisawesome.github.io/15Slide/doxygen/index.html.

Files and Folders

File/Folder	Description
docs	Github Pages and Doxygen documentation
images	Images and screenshots of 15Slide related stuff
src	15Slide source code
CODE_OF_CONDUCT.md	The code of conduct for this project
CONTRIBUTING.md	Guidelines for contributing to 15Slide
LICENCE.creativecommons	The licence for 15Slide images/glade files
LICENCE	The licence for 15Slide code/documentation
Makefile.am	Makefile.in template for autotools
README.md	This file
build.sh	The deprecated build script
configure.ac	configure script template for autotools

Dependencies

• termcolor (http://termcolor.readthedocs.io/) (3-Clause BSD License)
• gtkmm-3 (https://gtkmm.org/) for the GTKSlide branch (LGPL)

Licencing

Copyright 2017-2018 John Jekel. All 15Slide files other than images are licenced under the MIT Licence, and all images under the Creative Commons Attribution-ShareAlike 4.0 International Licence (CC BY-SA 4.0).

15slide's Issues

Saving to file with spaces

the save command only takes the first space separated token

X and Y coordinates

Apparently, at least with reIndex, [tile][0] is the y coordinate, not the x, and vice versa. Although it works with all other functions, it is confusing.

This is probably because tiles are being saved to a gridArray incorrectly, but hopefully it is just an issue with the index.

Major refactoring will have to be done to documentaion, Grid15 and GTKSlide::TileGrid either way at some point.

build.sh dosen't work

since GTKSlide was merged

command line args

add options in the command line for 15Slide

Unsolvable Grids

https://www.geeksforgeeks.org/check-instance-15-puzzle-solvable/

Might have to make a smarter Grid15::GridHelp::generateRandomGridArray()

Gtkmm 3.0 on Windows

There are no official releases of Gtkmm 3.0 on Windows.

I may switch to Qt in the future in order to support more platforms with a GUI

swapTile

The swapTile with tile num has more code, but it is probably better (for consistency and logic) to move most of the code back to the tileY and tileX one.

Bounds checking

Throughout porting 15Slide to Java, it was seen that the original seemed to be missing some bounds checking in GridHelp, especially with tileNum occurances.

Some doxygen pages don't seem to work

specifically the "File" ones