Cursor rule

1---
2description: Benchmarking guidelines for skia-rs performance testing
3globs: ["**/bench/**", "**/benches/**", "crates/skia-rs-bench/**"]
4alwaysApply: false
5---
6 
7# Benchmarking
8 
9## Using the Benchmark System
10 
11```bash
12# Run all benchmarks
13cargo bench -p skia-rs-bench
14 
15# Run specific suite
16cargo bench -p skia-rs-bench --bench core_benchmarks
17 
18# Quick validation
19cargo bench -p skia-rs-bench -- --test
20```
21 
22## Writing Benchmarks
23 
24```rust
25use criterion::{criterion_group, criterion_main, Criterion};
26use std::hint::black_box;
27 
28fn bench_example(c: &mut Criterion) {
29    let mut group = c.benchmark_group("Example");
30 
31    group.bench_function("operation", |b| {
32        b.iter(|| {
33            // Use black_box to prevent optimization
34            black_box(some_operation())
35        })
36    });
37 
38    group.finish();
39}
40 
41criterion_group!(benches, bench_example);
42criterion_main!(benches);
43```
44 
45## Performance Targets
46 
47- Core operations (Point, Rect, Color): < 10ns
48- Matrix operations: < 100ns
49- Path operations: < 1µs per segment
50- Canvas drawing: comparable to native Skia
51 
52## Best Practices
53 
54- Use `std::hint::black_box` to prevent compiler optimizations
55- Use deterministic RNG for reproducible benchmarks
56- Group related benchmarks together
57- Include baseline comparisons where possible
58