Struct Globe 

pub struct Globe<'a> { /* private fields */ }

A globe widget driven by an externally-provided Camera.

Renders by rasterizing land triangles and coastline contours into a shared Braille dot grid (resolution 2W x 4H for a W x H cell area), then composing each cell’s 8 dots into a single Braille glyph. Cells that contain any contour dot render only the contour bits in CONTOUR_COLOR - the land dots in those cells are dropped to preserve the thin coastline. Cells with land but no contour render the land bits in LAND_COLOR.

Vertices on the back hemisphere (post-rotation z < 0) are culled and contour segments straddling the horizon are clipped to it. Triangles are culled by the sign of their average vertex z (a sphere-tessellation approximation of the surface normal direction).

Implementations

impl<'a> Globe<'a>

pub fn new(data: &'a MapData, camera: Camera) -> Self

Examples found in repository

examples/smoke.rs (line 19)

fn main() {
    let map = MapData::embedded();
    let area = Rect::new(0, 0, 80, 30);
    for yaw in [0.0_f32, 1.0, 2.0, 3.0] {
        let camera = Camera {
            yaw,
            ..Camera::default()
        };
        let mut buf = Buffer::empty(area);
        Globe::new(&map, camera).render(area, &mut buf);
        println!("--- yaw = {yaw:.2} rad ---");
        for y in 0..area.height {
            let mut line = String::new();
            for x in 0..area.width {
                let sym = buf[(x, y)].symbol();
                line.push(if sym == " " || sym.is_empty() {
                    ' '
                } else {
                    '#'
                });
            }
            println!("{}", line.trim_end());
        }
        println!();
    }
}

Trait Implementations

impl Widget for Globe<'_>

fn render(self, area: Rect, buf: &mut Buffer)

Draws the current state of the widget in the given buffer. That is the only method required to implement a custom widget.