How alvinphilips/rats works
Project Type and Purpose
• This is a Rust library crate (“rats”) that implements a simple ASCII-text triangle rasterizer.
• Library Crate (src/)
• Geometry Module
– vertex.rs: Vertex struct + ContainsPoint trait
– line.rs: Line struct implements ContainsPoint
– triangle.rs: Triangle struct implements ContainsPoint
• Renderer Module
• Prelude Module
– prelude.rs: Re-exports frequently used types and traits for consumers
• lib.rs: Crate root, ties submodules together, exposes public API
• Example Binaries (examples/)
• input_file/*: binary that reads a “.trianglelist” file (serialize.rs), constructs triangles, invokes rendering
• External Dependencies
• Rust toolchain / Cargo
Relationships & Data Flows
• Renderer stores drawn pixels in an internal buffer → render() method serializes buffer to ASCII → prints to stdout
• input_file example adds a Serialization component (reading text → Triangle list) before driving Renderer
Key Architectural Patterns
• Modular crate with clear separation:
• Rendering logic (buffer management, ASCII output)
• Public API façade (Prelude)
• Zero-dependency design for maximum readability and portability
• Example binaries as clients demonstrating extensibility