AR-Dice

ARDice

ARDice is an augmented reality application that allows you to roll dice.

In-Depth Document (Italian) · Report Bug · Request Feature

Table of Contents

1. About The Project
   • Built With
2. Getting Started
   • Prerequisites
   • Installation
3. Usage
4. Roadmap
5. Contributing
6. License
7. Contact

About The Project

ARDice is an augmented reality application that allows you to roll dice.

Game Mode:

This is the default mode in which the application is started up, in which it is possible to roll the dice very simply. In this mode, the Augmented Reality engine continuously detects surfaces and walls, therefore vertical and horizontal planes, making them interact with the objects in play. In Game Mode there are 2 launch modes:

1. Swipe to Throw: the die is thrown by swiping it, and then the die completes a parabola that starts from the lower part of the smartphone display and arrives in the AR environment
2. Falling Die: in this mode there will be a pointer on the plane, whose position is given by an estimate of the depth. Pressing the large button at the bottom center will make it fall vertically in proximity to the pointer.

To change launch mode you need to use the button at the top center. It is also possible to change the dice to be thrown using the appropriate buttons positioned at the bottom, on the sides of the launch key.

Swipe to throw mode	Falling Dice mode

Table Mode:

The Table Mode is an advanced mode that allows you to build your own horizontal plane at will. This mode is accessible by pressing the key at the top right. As soon as TableMode is enabled, all automatically constructed plans will be destroyed. In this way the user, through a pointer positioned based on an estimate of depth and surfaces, He can select the vertices of the surface he wants to build, and once this is done, clicking the button at the bottom center will finalize the currently constructed floor by creating walls around the perimeter. It is also possible to move a vertex by simply clicking on it and then it is possible to confirm it by pressing the add vertex button.

• Build: button to build walls, clickable only if there are at least 3 points
• +: key to add a vertex
• -: key to remove a vertex, double tap to confirm
• Trash: key to delete the newly built surface
• Save: button to save the newly built floor and return to game mode, if the walls have not been built it is not clickable

Presets:

You can change and save your presets to be used in falling dice mode.

Themes:

This settings page can let you modify the colors of your dice. Tap the number to swich from the number to the die color.

Built With

• Visual Studio Code
• Unity

Getting Started

To get a local copy up and running follow these simple steps.

Prerequisites

• Git
• Visual Studio
• Unity

Installation

1. Install Git at Download Git.
2. Clone the repo.

   git clone https://github.com/Federicoand98/AR-Dice

3. Install the latest version of Unity.
4. Open the directory with Visual Studio.
5. Unzip the 7z file in the Resources folder.

Usage

To use the application:

• Switch Unity build platform (iOS, Android)
• Build and Run

Roadmap

See the open issues for a list of proposed features (and known issues).

Future developments

Contributing

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

1. Fork the Project
2. Create your Feature Branch (git checkout -b feature/AmazingFeature)
3. Commit your Changes (git commit -m 'Add some AmazingFeature')
4. Push to the Branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

License

Distributed under the MIT License. See LICENSE for more information.

Contact

Federico Andrucci - federico.andrucci@gmail.com
Alex Gianelli - djgiane@yahoo.it
Lorenzo Righi - righi.lo@gmail.com

Project Link: https://github.com/Federicoand98/AR-Dice