ink_quads()

MAYAFLUX_API void MayaFlux::Portal::Text::ink_quads	(	const std::shared_ptr< Buffers::TextBuffer > &	target,
		std::span< const GlyphQuad >	quads,
		glm::vec4	color
	)

Rasterize a mutated quad span into an existing TextBuffer.

Clears the buffer's pixel region, rasterizes quads via rasterize_quads(), and marks the buffer dirty for GPU upload. The scratch pixel buffer is thread-local and reused across calls, so no heap allocation occurs after the first call at a given buffer size.

Typical usage:

auto layout = Portal::Text::create_layout(text, 0.F, 0.F, wrap_w);
// ... per-quad mutation ...
Portal::Text::ink_quads(text_buf, layout->quads, color);

Parameters

target	TextBuffer to write into. Dimensions are read from the buffer.
quads	Quads produced by create_layout(), optionally mutated by the caller.
color	RGBA glyph color in [0, 1].

Definition at line 203 of file InkPress.cpp.

{
    if (!target) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::API,
            "ink_quads: target buffer is null");
        return;
    }
 
    GlyphAtlas* atlas = resolve_atlas(nullptr);
    if (!atlas) {
        return;
    }
 
    const uint32_t buf_w = target->get_budget_width();
    const uint32_t buf_h = target->get_budget_height();
    const size_t buf_bytes = static_cast<size_t>(buf_w) * buf_h * 4;
 
    thread_local std::vector<uint8_t> pixels;
    pixels.assign(buf_bytes, 0);
 
    rasterize_quads(quads, *atlas, color, pixels.data(), buf_w, buf_h);
    target->set_pixel_data(pixels.data(), buf_bytes);
}

References MayaFlux::Journal::API, color, MF_ERROR, pixels, MayaFlux::Journal::Portal, and rasterize_quads().

Here is the call graph for this function: