make_entry() [2/2]

MAYAFLUX_API Entry MayaFlux::Portal::Forma::make_entry	(	const EntrySpec &	spec,
		EntryBuffer	row_buf,
		Surface &	surface,
		LayoutCursor &	cursor,
		float	x_min,
		float	x_max,
		float	row_h,
		glm::vec3	bg = glm::vec3(0.15F)
	)

Construct one labeled entry row, advance the cursor, and return it.

The row is one slice of glyph quads: bg is drawn as the fill beneath the text (Portal::Text::PressParams::background), so one slice carries both. The link's compose function runs immediately (establish) so the row shows correctly from the first frame, and again on every subsequent link.tap(), drawing "label: entry" into the row's buffer. The buffer is pre-created by the caller as row_buf.

Bounds come from cursor.advance()'s return (scroll-offset aware, per LayoutCursor::bind_scroll), with x_min/x_max substituted in afterward for this call's own column override - not from cursor.y() read directly, so a row placed through a scroll-bound cursor lands at the correct position immediately.

Parameters

spec	Label and reader for the row.
row_buf	Pre-created text-capable buffer.
surface	Surface to register the row on.
cursor	Layout cursor. Advanced by row_h on return.
x_min	Left edge in NDC.
x_max	Right edge in NDC.
row_h	Row height in NDC units.
bg	Background fill drawn beneath the row's text.

Definition at line 32 of file Entry.cpp.

{
    const Kinesis::AABB2D advanced = cursor.advance(row_h);
    const Kinesis::AABB2D row_rect { .min = { x_min, advanced.min.y }, .max = { x_max, advanced.max.y } };
 
    const glm::uvec2 dims = row_pixel_dims(surface.window(), x_min, x_max, row_h);
 
    auto params = std::make_shared<Portal::Text::PressParams>(Portal::Text::PressParams {
        .color = { 1.F, 1.F, 1.F, 1.F },
        .background = { bg, 1.F },
        .render_bounds = dims,
    });
 
    Element el;
    el.buffer = row_buf.buf;
    el.bounds_hint = row_rect;
    el.interactive = false;
    el.name = spec.label;
    el.with_text(spec.label, *params, row_rect);
    const uint32_t id = surface.layer().add(el);
 
    auto compose = [reader = spec.reader,
                       label = spec.label,
                       el,
                       params,
                       last = std::optional<std::string> {}]() mutable {
        if (!reader)
            return;
 
        std::string text = label + ": " + reader();
        if (last && *last == text)
            return;
        last = text;
 
        el.set_text(text, *params);
    };
 
    surface.ctx().on_resize(id,
        [el, surface, params, label = spec.label, reader = spec.reader,
            x_min, x_max, row_h](uint32_t, uint32_t) mutable {
            params->render_bounds = row_pixel_dims(surface.window(), x_min, x_max, row_h);
            el.set_text(reader ? (label + ": " + reader()) : label, *params);
        });
 
    Link link(compose, compose);
 
    return Entry {
        .element_id = id,
        .buf = std::move(row_buf.buf),
        .link = std::move(link),
        .row_bounds = row_rect,
    };
}

References MayaFlux::Portal::Forma::Layer::add(), MayaFlux::Portal::Forma::LayoutCursor::advance(), MayaFlux::Portal::Forma::EntryBuffer::buf, MayaFlux::Portal::Forma::Element::buffer, MayaFlux::Portal::Text::PressParams::color, MayaFlux::Portal::Forma::Surface::ctx(), MayaFlux::Portal::Forma::Entry::element_id, label, MayaFlux::Portal::Forma::EntrySpec::label, MayaFlux::Portal::Forma::Surface::layer(), MayaFlux::Kinesis::AABB2D::max, MayaFlux::Kinesis::AABB2D::min, MayaFlux::Portal::Forma::Context::on_resize(), MayaFlux::Portal::Forma::EntrySpec::reader, row_pixel_dims(), and MayaFlux::Portal::Forma::Surface::window().

Referenced by make_entry(), and make_entry_group().

Here is the call graph for this function:

Here is the caller graph for this function: