LiDAR GTA V
============================
*A plugin for Grand Theft Auto V that generates a labeled LiDAR point cloud form the game environment.*

Requirements

* Grand Theft Auto V
* ScriptHookV by Alexander Blade

Installation

1. Install ScriptHookV following its accompanying instructions.
2. Copy-paste *LiDAR GTA V.asi* and the *LiDAR GTA V* folder into your GTA-V directory (the folder containing *GTAV.exe*)

How to use

1. Navigate to *#your_game_directory#/LiDAR GTA V/LIDAR GTA V.cfg* and edit the parameters as needed. The parameters include: Horizontal FOV, Vertical FOV, Range, Density and Output Filename.
2. Startup GTAV in a story mode.
3. Press V to cycle through camera modes until first person mode is enabled.
4. Press F6 to generate a LiDAR point cloud of the world.
5. Output file is located under *#game_directory#/LiDAR GTA V/#your_chosen_filename#.ply*
6. The output is a Polygon File Format (.PLY) file containing only vertex data.
7. Vertex Color Code:

| Vertex Color | Label                                      |
|--------------|--------------------------------------------|
| Red          | Vehicle                                    |
| Green        | Humans and Animals                         |
| Blue         | Game props                                 |
| White        | Road, Buildings and other hitable textures |
| Black        | No hit                                     |

Contributing

* Source Code: https://github.com/UsmanJafri/LiDAR-GTA-V
* You will need Visual Studio 2018 or higher to open the project.
* Any contributions to the project are welcomed, it's recommended to use GitHub Pull Requests.

Acknowledgements

*  Native Trainer (a ScriptHookV sample) was used as base project to import configuration.

Changelog

v1.0.9 - First public release
v1.1.0 - Added ability to customize LiDAR parameters