Update READMEs, add screenshots

Author: jdahlstrom

README.md

@@ -14,7 +14,8 @@
 
 *Note: This document is best viewed on an 80-column VGA terminal.*
 
-Retrofire is a software 3D rendering library
+Retrofire is a software 3D rendering library focusing on performance,
+correctness, and pedagogical value.
 
 The Retrofire project began as a shamelessly nostalgic effort to explore
 the state of graphics programming as it was in the mid-to-late 90s in
@@ -88,10 +89,11 @@ for custom allocators is planned in order to make `alloc` optional as well.
 
 Retrofire is split into several packages:
 
-* core:  math, renderer, utilities; no-std compatible
-* geom:  geometric shapes, mesh builders, model loading
-* front: frontends for writing simple graphical applications
-* demos: binaries showcasing retrofire features
+* retrofire: a metapackage that just re-exports core, geom, and front
+* retrofire-core:  math, renderer, utilities; no-std compatible
+* retrofire-geom:  geometric shapes, mesh builders, model loading
+* retrofire-front: frontends for writing simple graphical applications
+* retrofire-demos: binaries showcasing retrofire features.
 
 # Dependencies
 
@@ -103,13 +105,25 @@ functions, the package is not fully functional unless either the `std`,
 `libm`, or `mm` feature is enabled. Activating `std` additionally enables
 APIs that do I/O.
 
-The `front` package depends on either `sdl2`, `minifb`, or `wasm-bindgen`
-and `web-sys`, depending on enabled features.
+The `retrofire-front` package depends on either `sdl2`, `minifb`, or
+`wasm-bindgen` and `web-sys`, depending on enabled features.
 
-The `geom` package has no external dependencies. It only requires `alloc`;
-activating the optional feature `std` enables APIs that do I/O.
+The `retrofire-geom` package has no external dependencies. It only requires
+`alloc`; activating the optional feature `std` enables APIs that do I/O.
 
-The `retrofire-demos` package depends on `retrofire-front`.
+The `retrofire-demos` package depends on `retrofire`.
+
+# Screenshots
+
+The classic Stanford bunny.
+![The classic Stanford bunny 3D model.](docs/bunny.jpg)
+
+A first-person mouse-and-keyboard scene with many "Rust crates" strewn on a
+checkered floor.
+![Many wooden crates on a plane, each with the Rust logo](docs/crates.jpg)
+
+Ten thousand spherical particles positioned randomly in a sphere.
+![Ten thousand spherical particles in random positions.](docs/sprites.jpg)
 
 # License
 

core/README.md

@@ -12,12 +12,14 @@
 
 # Retrofire-core
 
-Core functionality of the `retrofire` project.
+Core functionality of the [`retrofire`][1] project.
 
 Includes a math library with strongly typed points, vectors, matrices,
 colors, and angles; basic geometry primitives; a software 3D renderer with
 customizable shaders; with more to come.
 
+[1]: https://crates.io/crates/retrofire
+
 ## Crate features
 
 * `std`:

demos/README.md

@@ -12,7 +12,9 @@
 
 # Retrofire-demos
 
-Simple demo programs showcasing Retrofire features.
+Simple demo programs showcasing [`retrofire`][1] features.
+
+[1]: https://crates.io/crates/retrofire
 
 ## Demo binaries
 

docs/bunny.jpg

@@ -12,23 +12,23 @@
 
 # Retrofire-front
 
-Simple frontends for Retrofire.
+Simple frontends for [`retrofire`][1].
+
+[1]: https://crates.io/crates/retrofire
 
 ## Crate features
 
-* `minifb`:
-  Enables a frontend using the [`minifb`](https://crates.io/crates/minifb)
-  library.
+* `minifb`: Enables a frontend using the [`minifb`][2] library.
+* `sdl2`:   Enables a frontend using the [`sdl2`][3] library.
+* `wasm`    Enables a frontend using WebAssembly and [`wasm-bindgen`][4].
+
+All features are disabled by default.
 
-* `sdl2`:
-  Enables a frontend using the [`sdl2`](https://crates.io/crates/sdl2)
-  library.
+[2]: https://crates.io/crates/minifb
 
-* `wasm`
-  Enables a frontend using WebAssembly and
-  [`wasm-bindgen`](https://crates.io/crates/wasm-bindgen).
+[3]: https://crates.io/crates/sdl2
 
-All features are disabled by default.
+[4]: https://crates.io/crates/wasm-bindgen
 
 ## License
 

docs/crates.jpg

@@ -12,13 +12,13 @@
 
 # Retrofire-geom
 
-Additional geometry types and routines for Retrofire.
+Additional geometry types and routines for [`retrofire`][1].
 
-## Crate features
+[1]: https://crates.io/crates/retrofire
 
-* `std`: Enables file I/O.
+## Crate features
 
-All features are disabled by default.
+* `std`: Enables file I/O. Disabled by default.
 
 ## License