README.md

3to4++ v1.1

A virtual simulator for the physical 3x3x3x3 design by Grant S. Credit to Akkei's physical 3^4 program for inspiration and design.

Frameworks and Libraries used

3to4++ is written with:

• C++
• OpenGL
• GLFW
• Dear ImGui
• linmath.h
• Rapid YAML
• ImGuiFileDialog
• Emscripten

Download

For Windows only: https://github.com/rayzchen/3to4pp/releases/latest

Compiling

Linux

On Linux, install a C++ compiler, make, the required GLFW and OpenGL dev packages.

Then run

$ make shared
$ cd 3to4pp/
$ ./3to4++

to compile and run. If make shared fails, try make build.

Windows

On Windows, install MinGW and Git for Windows, or Cygwin. This will setup a GNU C++ compiler and make system.

Next, go to https://www.glfw.org/download.html, select Windows binaries for the correct architecture. In the zip, copy all files under lib-mingw-w64/ into this repo's lib/ folder, and copy include/GLFW/ into this repo's include/ folder.

Finally run

> make build
> cd 3to4pp
> 3to4++.exe