edisonqkj / lidar-gta-v

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

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 found in bin/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. 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

• You will need Visual Studio 2017 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.

Samples