edgefirst-schemas 3.2.0

Message schemas for EdgeFirst Perception - ROS2 Common Interfaces, Foxglove, and custom types
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
57
58
59
60

# Rust Examples

Comprehensive examples demonstrating EdgeFirst Schemas Rust API usage.

## Running Examples

```bash
# From repository root
cargo run --example basic_types
```

## Example Files

### basic_types.rs

Demonstrates fundamental ROS2 message types:
- `builtin_interfaces::Time` and `Duration`
- `std_msgs::Header`, `ColorRGBA`
- `geometry_msgs::Vector3`, `Point`, `Quaternion`, `Pose`, `Transform`

**Key concepts:**
- Struct initialization with named fields
- Accessing nested fields
- CDR serialization using buffer-backed zero-copy types

## Building Blocks

### Creating Messages

```rust
use edgefirst_schemas::std_msgs::Header;
use edgefirst_schemas::builtin_interfaces::Time;

// Buffer-backed zero-copy construction
let stamp = Time { sec: 1234567890, nanosec: 123456789 };
let header = Header::new(stamp, "camera").unwrap();
```

### CDR Serialization

```rust
// Serialize to CDR bytes (ROS2-compatible)
let bytes = header.to_cdr();

// Deserialize from CDR bytes (zero-copy)
let decoded = Header::from_cdr(&bytes[..]).unwrap();

// Verify round-trip
assert_eq!(decoded.stamp(), stamp);
assert_eq!(decoded.frame_id(), "camera");
```

## Additional Resources

- **[Rust API Docs](https://docs.rs/edgefirst-schemas/)** - Complete API reference
- **[EdgeFirst Samples](https://github.com/EdgeFirstAI/samples)** - Complete workflows

---

**Questions?** support@au-zone.com