serde-ply 0.2.1

A Serde-based PLY (Polygon File Format) serializer and deserializer
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

# serde-ply


[![Crates.io](https://img.shields.io/crates/v/serde-ply.svg)](https://crates.io/crates/serde-ply)
[![Documentation](https://docs.rs/serde-ply/badge.svg)](https://docs.rs/serde-ply)

Flexible and fast PLY parser and writer using serde. While PLY is an older format, it's still used in various geometry processing applications and research. PLY files act as simple key-value tables, and can be decoded in a streaming manner.

## Installation


Add this to your `Cargo.toml`:

```toml
[dependencies]
serde-ply = "0.1"
serde = { version = "1.0", features = ["derive"] }
```

## Features


- Supports serializing and deserializing PLY files
- Supports full PLY specification including list properties
- Supports binary and ASCII formats
- Supports deserializing PLY files in chunks, for streaming data processing
- High performance (1 GB/s+ deserialization)

## Quick Start


```rust
use serde::{Deserialize, Serialize};

#[derive(Deserialize, Serialize)]

struct Vertex {
    x: f32,
    y: f32,
    z: f32,
}

#[derive(Deserialize, Serialize)]

struct Mesh {
    vertex: Vec<Vertex>,
}

// Read PLY file
let mesh: Mesh = serde_ply::from_reader(reader)?;

// Write PLY file
let bytes = serde_ply::to_bytes(&mesh, serde_ply::SerializeOptions::binary_le())?;
```

## Examples


Please see the `examples/` folder for usage examples.

## Contributions


Contributions are welcome! Please open an issue or submit a pull request. Please run the tests to check if everything still works, and `cargo bench` to check if performance is still acceptable.