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,
		GlyphAtlas *	atlas = nullptr
	)

Rasterize a mutated quad span into an existing TextBuffer.

Clears the buffer's pixel region to target->get_background(), 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);

quads' UV coordinates are only meaningful against the atlas they were laid out from. atlas null (the default) resolves to whatever the TypeFaceFoundry default atlas is at this call, not at layout time: if something else has called set_default_font() since, or the atlas has grown, a held LayoutResult's quads will sample the wrong texture. Pass the same atlas the quads were laid out against explicitly whenever it might not still be the current default by the time this runs.

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].
atlas	Atlas the quads' UVs are relative to. Null selects the TypeFaceFoundry default at call time.

Definition at line 311 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(atlas_hint);
    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.resize(buf_bytes);
    fill_bytes(pixels.data(), buf_bytes, target->get_background());
 
    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: