Struct Surface 

pub struct Surface { /* private fields */ }

A reusable half-block render target.

Owns the pixel buffer between frames, so rendering allocates nothing once warm. One instance per viewport; sizes are per-call.

Implementations

impl Surface

pub const fn new() -> Self

Creates an empty target; the buffer grows on first render.

Examples found in repository

examples/chat/welcome.rs (line 181)

	pub fn new(charset: Charset) -> Self {
		Self {
			charset,
			frame: Frame::new(Size::new(0, 0)),
			title: fmts!(" {} omp v{} ", charset.icon(Icon::Omp), env!("CARGO_PKG_VERSION")),
			camera: (0.0, 0.0),
			camera_target: (0.0, 0.0),
			last_elapsed: 0.0,
			logo_origin: (0, 0),
			logo: [[None; LOGO_COLS]; LOGO_ROWS],
			logo_at: None,
			backdrop_frame: Frame::new(Size::new(0, 0)),
			backdrop_at: None,
			backdrop: Eclipse::default(),
			surface: Surface::new(),
			pointer: None,
			hover: Tween::settled(0.0),
		}
	}

pub fn render<P: Program + ?Sized>( &mut self, program: &mut P, now: Duration, cols: u16, rows: u16, put: impl FnMut(u16, u16, char, Color, Option<Color>), )

Renders one frame of program into a cols × rows grid of half-block cells.

Advances the program to now, shades every pixel, splats particles, then emits lit cells as put(column, row, glyph, fg, bg): ▀ with both colors when both halves lit, ▀/▄ with bg = None when only one half is, nothing when neither.

Examples found in repository

examples/chat/welcome.rs (lines 270-283)

	fn draw_backdrop(&mut self, viewport: Size, clock: Duration, elapsed: f32) {
		let interval = ambient_interval(clock, BACKDROP_IDLE_INTERVAL);
		if self
			.backdrop_at
			.is_none_or(|rendered_at| clock.saturating_sub(rendered_at) >= interval)
		{
			let fade = smooth((elapsed / BACKDROP_FADE).clamp(0.0, 1.0));
			self
				.backdrop_frame
				.fill(Rect::new(0, 0, viewport.width, viewport.height), Style::default());
			let frame = &mut self.backdrop_frame;
			let mut buffer = [0_u8; 4];
			let dim = |color: Color| Color::Rgb(0, 0, 0).lerp(color, fade);
			self.surface.render(
				&mut self.backdrop,
				clock,
				viewport.width,
				viewport.height,
				|x, y, glyph, fg, bg| {
					let style = Style::new().fg(dim(fg));
					let style = match bg {
						Some(bg) => style.bg(dim(bg)),
						None => style,
					};
					frame.put(x, y, glyph.encode_utf8(&mut buffer), style);
				},
			);
			self.backdrop_at = Some(clock);
		}
		self.frame.clone_from(&self.backdrop_frame);
	}

Trait Implementations

impl Default for Surface

fn default() -> Surface

Returns the “default value” for a type.