]> git.lizzy.rs Git - nothing.git/blobdiff - README.md
Add TODO(#933)
[nothing.git] / README.md
index 7a18500daa1ab490c82f0f7db10243172a54e1ae..d3fd2a48d5dcf5eac9a330d2eacfca03727cafc6 100644 (file)
--- a/README.md
+++ b/README.md
@@ -1,20 +1,80 @@
 [![Build Status](https://travis-ci.org/tsoding/nothing.svg?branch=master)](https://travis-ci.org/tsoding/nothing)
+[![Build status](https://ci.appveyor.com/api/projects/status/gxfgojq4ko98e0g0/branch/master?svg=true)](https://ci.appveyor.com/project/rexim/nothing/branch/master)
 
 # Nothing
 
 ![](https://i.imgur.com/7mECYKU.gif)
 ![](https://i.imgur.com/ABcJqB5.gif)
 
+## Dependencies
+
+- [gcc]
+- [cmake]
+- [libsdl2-dev]
+- [inotify-tools]
+
+### Ubuntu
+
+```console
+$ sudo apt-get install gcc cmake libsdl2-dev inotify-tools libxml2-dev
+```
+
+### MacOS
+
+```console
+$ brew install gcc cmake sdl2
+```
+
+### NixOS
+
+For [NixOS] we have a development environment defined in [default.nix]
+with all of the required dependencies. You can enter the environment
+with `nix-shell` command:
+
+```console
+$ nix-shell
+```
+
+### Arch Linux
+
+```console
+$ sudo pacman -S gcc cmake sdl2 inotify-tools libxml2
+```
+
+### Windows
+
+- [Visual Studio 2015+](https://visualstudio.microsoft.com/)
+- [SDL2 VC Development Libraries](https://www.libsdl.org/release/SDL2-devel-2.0.9-VC.zip)
+
 ## Quick Start
 
+### Linux
+
 ```console
-$ nix-shell              # Only on NixOS
 $ mkdir build
 $ cd build/
 $ cmake ..
 $ make
-$ ./nothing ../levels/level-01.txt
-$ ./nothing_test
+$ cd ../data/
+$ ../build/nothing
+```
+
+### Windows
+
+- Enter the Visual Studio Command Line Development Environment https://docs.microsoft.com/en-us/cpp/build/building-on-the-command-line
+  - Basically just find `vcvarsall.bat` and run `vcvarsall.bat x64` inside of cmd
+- Download [SDL2 VC Development Libraries](https://www.libsdl.org/release/SDL2-devel-2.0.9-VC.zip) and copy it to `path\to\nothing`
+
+```console
+> cd path\to\nothing
+> 7z x SDL2-devel-2.0.9-VC.zip
+> move SDL2-2.0.9 SDL2
+> mkdir build
+> cd build
+> cmake ..
+> cmake --build .
+> cd ../data/
+> ..\build\nothing
 ```
 
 ## Controls
@@ -33,6 +93,7 @@ $ ./nothing_test
 | `q`     | Reload the current level preserving the Player's position   |
 | `p`     | Toggle game pause                                           |
 | `l`     | Toggle transparency on objects. Useful for debugging levels |
+| `TAB`   | Switch to Level Editor                                      |
 
 #### Gamepad
 
@@ -49,82 +110,7 @@ $ ./nothing_test
 | `Enter`   | Evaluate the expression  |
 | `Up/Down` | Traverse console history |
 
-## Editing Levels
-
-Generally creating a level looks like:
-
-```
-SVG File -> Custom Level File -> Game
-```
-
-To convert SVG to the level file install [xqilla] and run
-[svg2rects.xqe] script:
-
-```console
-$ xqilla ./devtools/svg2rects.xqe -i <svg-file> -o <level-file>
-```
-
-All of the levels reside in the [./levels/] folder. Use
-[./levels/Makefile] to automatically rebuild all levels.
-
-### Level Editing Workflow
-
-1. `$ inkscape ./levels/level.svg &`
-2. `$ ./build/nothing ./levels/level.txt &`
-3. `$ cd ./levels/`
-4. `$ make watch`
-5. Edit Level in Inkscape and Save
-6. Switch to the Game and reload level by pressing Q
-7. Go to 5
-
-### Objects Reference
-
-#### SVG rect node
-
-| Regex of id  | Description                                                                                                       |
-|--------------|-------------------------------------------------------------------------------------------------------------------|
-| `player`     | Defines the **position** of the Player. **Size is ignored**.                                                      |
-| `rect.*`     | Defines the **size** and **position** of an impenetrable platform block                                           |
-| `box.*`      | Defines the **size** and **position** of a rigid box that obeys the physics of the game                           |
-| `region(.*)` | Defines the **size** and **position** of a region that hides the Goals. `\1` defines the id of the Goal to hide.  |
-| `goal(.*)`   | Defines the **position** of the goal. **Size is ignored**. `\1` defines the id of the region that hides the goal. |
-| `lava.*`     | Defines the **position** and **size** of a lava block.                                                            |
-| `background` | Defines the **color** of the background. **Position and size are ignored**.                                       |
-| `backrect.*` | Defines the **size** and **position** of a solid block in the background.                                         |
-
-#### SVG text node
-
-| Regex of id | Description                                                                |
-|-------------|----------------------------------------------------------------------------|
-| `label.*`   | Defines **position** and **text** of a in-game label. **Size is ignored**. |
-
-## Build on Windows
-
-You need to install [conan][] and [Visual Studio 2017][visual-studio].
-
-### Dependencies
-
-Current version of [SDL2/2.0.5@lasote/stable][conan-sdl2] in the conan-transit
-repository is not compatible with the latest conan, so you'll need to install
-it locally from the git repository:
-
-```console
-$ git clone https://github.com/lasote/conan-sdl2.git # temporary, I hope hope hope
-$ cd conan-sdl2
-$ conan export SDL2/2.0.5@lasote/stable
-```
-
-### Building
-
-Execute the following commands inside of the `nothing` directory:
-
-```console
-$ conan install --build missing --install-folder build
-$ cd build
-$ cmake .. -G "Visual Studio 15 2017 Win64"
-```
-
-After that, build the `build/nothing.sln` file with Visual Studio.
+<!-- TODO(#914): Level Editor is not documented -->
 
 ## Support
 
@@ -133,10 +119,13 @@ You can support my work via
 - Twitch channel: https://www.twitch.tv/subs/tsoding
 - Patreon: https://www.patreon.com/tsoding
 
-[conan]: https://www.conan.io/
-[conan-sdl2]: https://bintray.com/conan/conan-transit/SDL2%3Alasote/2.0.5%3Astable
 [visual-studio]: https://www.visualstudio.com/
-[xqilla]: http://xqilla.sourceforge.net/HomePage
-[svg2rects.xqe]: ./devtools/svg2rects.xqe
+[svg2rects.py]: ./devtools/svg2rects.py
 [./levels/]: ./levels/
 [./levels/Makefile]: ./levels/Makefile
+[gcc]: https://gcc.gnu.org/
+[cmake]: https://cmake.org/
+[libsdl2-dev]: https://www.libsdl.org/
+[NixOS]: https://nixos.org/
+[default.nix]: ./default.nix
+[inotify-tools]: https://github.com/rvoicilas/inotify-tools