UsmanJafri / LiDAR-GTA-V

A plugin for Grand Theft Auto V that generates a labeled LiDAR point cloud from the game environment.

LiDAR GTA V

A plugin for Grand Theft Auto V that generates a labeled LiDAR point cloud from the game environment.

Requirements

• Grand Theft Auto V
• ScriptHookV

Installation

1. Install ScriptHookV following its accompanying instructions
2. Copy-paste LiDAR GTA V.asi and the LiDAR GTA V folder from the latest release 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. Start up GTA-V in 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

8. It is recommended to use CloudCompare (an open-source point-cloud viewer) to view the PLY file generated by LiDAR GTA V

Developer Notes

• You will need Visual Studio 2019 or higher to open this project

• The project requires the Desktop development with C++ workload to be installed in Visual Studio

• The project is targetted at Visual Studio Platform Toolset v142

• To make development easier, the project will automatically copy the compiled LiDAR GTA V plugin to the directory D:\Games\GTAV\ after building

  You may want to set this path to point to your GTA-V installation directory. This can be done by right-clicking LiDAR GTA V in the Solution Explorer and editing the Command Line field under Configuration Properties -> Build Events -> Post-Build Event -> Command Line

Contributing

• Any contributions to the project are welcomed, it is recommended to use GitHub Pull requests

Acknowledgements

• Native Trainer (a ScriptHookV sample) was used as a starting point to import configuration

License

• You are free to use this project in your work. However acknowledgement and a link to this repository would be greatly appreciated. If you do use this project in your work, I would love to hear about it, please drop me an email at [e-mail]
• The LiDAR-GTA-V source code is licensed under the MIT license. Source content taken from other projects is tagged with the respective licenses wherever found

Output Samples