# TriangleSplattingUnity

**Repository Path**: nirenyang/TriangleSplattingUnity

## Basic Information

- **Project Name**: TriangleSplattingUnity
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-13
- **Last Updated**: 2025-10-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# UnityTriangleSplatting

## Introduction

**UnityTriangleSplatting** is a Unity package for visualizing triangle splats from COFF files, inspired by the [Triangle Splatting](https://github.com/trianglesplatting/triangle-splatting) project. It supports chunked loading, frustum culling, and optional mesh collider generation for interactive exploration of large triangle datasets.

## Features

- Load and render `.off` (COFF) triangle files  
- Chunk-based loading for performance  
- Frustum culling for real-time optimization  
- Optional mesh collider generation  
- Vertex color support for per-vertex shading  

## Example

![Triangle Splatting Example](docs/images/triangle_splat_example.png)

> 💡 You can drag and drop the TriangleSplatRenderer prefab in your scene and your file will be loaded at runtime.

## Installation

### Option 1: Clone the repository

1. Clone this repository via UPM:  
   `Install package from GIT url -> https://github.com/KillianCartelier/UnityTriangleSplatting.git`  
2. Install Samples. 

### Option 2: Import the Unity package

1. Download the `TriangleSplatUnity.unitypackage` file from the repository.  
2. In Unity, go to `Assets > Import Package > Custom Package...`  
3. Select the downloaded `.unitypackage` file and import all assets.

## Usage
1. Set your Unity Project in Gamma Color. (Thanks BarnabasTakacs for letting me know about this issue)
2. Drag and drop the TriangleSplatRenderer prefab in your scene.
3. Set the path to your `.off` file.  
5. Press Play to visualize the triangle splats in the scene.

## Requirements

- Unity 2022.3+ (tested with Unity 6 beta)  
- A COFF file with triangle and color data  

## To-Do

- [ ] Runtime `.off` file loader via UI  
- [ ] Support for mesh Export  

## License

This project is licensed under the MIT License.

## Contributing

Contributions are welcome! Feel free to:  
- Open issues for bugs or suggestions  
- Submit pull requests with improvements  
- Share your use cases and feedback