Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/johnBuffer/AntSimulator

Simple Ants simulator
https://github.com/johnBuffer/AntSimulator

2d cpp realtime sfml simulation

Last synced: 3 months ago
JSON representation

Simple Ants simulator

Host: GitHub
URL: https://github.com/johnBuffer/AntSimulator
Owner: johnBuffer
License: mit
Created: 2020-04-28T22:35:08.000Z (about 4 years ago)
Default Branch: master
Last Pushed: 2023-01-19T00:33:05.000Z (over 1 year ago)
Last Synced: 2024-01-23T18:16:23.351Z (6 months ago)
Topics: 2d, cpp, realtime, sfml, simulation
Language: C++
Homepage:
Size: 869 KB
Stars: 2,183
Watchers: 56
Forks: 280
Open Issues: 24
Metadata Files:
- Readme: README.md
- License: LICENSE

Lists

awesome - AntSimulator - Simple Ants simulator (C++)

README

        # AntSimulator

Very simple ants simulator.

# Installation

## Prerequisites

In order to compile this project you will need to:

 - have [SFML](https://www.sfml-dev.org/index.php) installed on your system. If you don't know how to do it see [this link](https://www.sfml-dev.org/tutorials/2.5/#getting-started).

 - have [CMake](https://cmake.org/) installed

## Compilation

Detailed explanation [here](https://preshing.com/20170511/how-to-build-a-cmake-based-project/)

### On Linux with `install.sh`

- Go in the repo folder

`cd the/repo/location`

- Execute `install.sh` script

`./install.sh`

##### On Ubuntu from Docker

 - Install Docker (see [this](https://docs.docker.com/engine/install/))

 - Execute `install_from_docker.sh` script

```sh

docker build -t myimages/ant-simulator:latest .

docker create -it --name dummy myimages/ant-simulator:latest bash

docker cp dummy:/AntSimulator/build/AntSimulator .

rm -rf build/

mkdir build/

mv AntSimulator build/

cp -r res/ build/

docker rm -f dummy

```

Executable files will be located in the build folder.

### On Windows with CMake GUI and Visual Studio

 - Install the right SFML version or compile it (see [this](https://www.sfml-dev.org/tutorials/2.5/start-vc.php))

 - Run CMake

 - Select the repo location

 

![Cmake 1](https://github.com/johnBuffer/AntSimulator/blob/master/img/cmake_1.PNG)

 - Click on `Configure`, if you have installed the `x64` version of SFML, in the pop up window select `x64` in the `Optionnal platform for generator` drop down

![Cmake 2](https://github.com/johnBuffer/AntSimulator/blob/master/img/cmake_2.PNG)

 - Click on `Finish`

 - Click on `Generate`

![Cmake 3](https://github.com/johnBuffer/AntSimulator/blob/master/img/cmake_3.PNG)

 - You can now open the generated project and build it.

# Commands

|Command|Action|

|---|---|

|**P**|Pause/Unpause the simulation|

|**M**|Toggle markers drawing|

|**A**|Toggle ants drawing|

|**S**|Toggle max speed mode|

|**W**|Toggle Wall mode|

|**E**|Toggle Wall erase mode|

|**Right click**|Add food|

|**Left click**|Move view|

|**Wheel**|Zoom|