moenarch-math-geometry-2d 0.1.0

Shared 2D geometry contracts for multimodal image, video, and layout processing.
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
61
62
63
64
65
66
67
68

# math-geometry-2d

Shared 2D geometry contracts for multimodal image, video, and layout
processing. This crate is part of the Analytical Math Crates family.

## Highlights

- Checked pixel and normalized 2D primitives
- Rectangle intersection, union, and clamping helpers
- Rectangle IoU and directional overlap ratios
- Finite line-segment intersection parameters
- Affine transforms with compose and invert support
- Polygon area, centroid, winding, containment, and bounds helpers
- Normalized and pixel coordinate conversion helpers

## Example

```rust,no_run
use math_geometry_2d::{Affine2, NormalizedPoint2, RectU32, Size2u};

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let rect = RectU32::new(10, 12, 32, 24)?;
    let point = NormalizedPoint2::new(0.5, 0.5)?.to_pixel_point(Size2u::new(64, 48)?);
    let shifted = Affine2::translation(4.0, -2.0).apply_point(rect.center_f32());
    assert_eq!(point.x, 32);
    assert!(shifted.x > 0.0);
    Ok(())
}
```

## Package surface

Primary workflow: `geometry.bounds`.

Workflow operations:

- `geometry.bounds`: Computes 2D bounds, dimensions, and center for finite points.
- `geometry.transform`: Applies an affine transform to finite 2D points and returns transformed bounds.
- `geometry.intersections`: Checks every rectangle pair and returns intersection rectangles when present.
- `geometry.overlap`: Computes intersection area, IoU, and directional overlap ratios for two rectangles.
- `geometry.segmentIntersection`: Computes the point and segment parameters for two finite 2D segment intersections.
- `geometry.polygonSummary`: Reports area, winding, centroid, and bounds for a finite 2D polygon.

Debug operations:

- `describe`: inspect package metadata and runtime support.

Runtime support: library, CLI, server, and WASM wrappers expose these operations.

Run the primary workflow through the CLI:

```bash
cargo run -p moritzbrantner-math-geometry-2d-cli -- run \
  --operation geometry.bounds \
  --json '{"points":[[0.0,1.0],[2.0,3.0]]}'
```

Successful responses use the shared package-surface shape with `operation`,
`title`, `message`, `summary`, and `result`. Default surface calls are
deterministic, local-first, and do not download models, write persistent files,
or execute external tools unless an operation explicitly documents native or
external-tool execution.

## Related crates

- `video-analysis-core`
- `image-analysis-processing`
- `video-analysis-posture`