repress() [1/2]

MAYAFLUX_API bool MayaFlux::Portal::Text::repress	(	const std::shared_ptr< Buffers::TextBuffer > &	target,
		std::string_view	text,
		glm::vec4	color = { 1.F, 1.F, 1.F, 1.F },
		RedrawPolicy	policy = RedrawPolicy::Clip,
		std::span< const StyleSpan >	spans = {}
	)

Re-composite a UTF-8 string into an existing TextBuffer.

Always clears the buffer to target->get_background() before compositing. Render bounds and atlas are read from the target buffer. When the target has a pre-allocated vertical budget the compositing bounds are the budget dimensions, so no VKImage rebuild occurs as long as content fits.

Parameters

target	Existing TextBuffer to write into.
text	UTF-8 string to composite.
color	RGBA glyph color for any byte not covered by spans.
policy	Controls reallocation behaviour when text exceeds budget.
spans	Optional per-byte-range color overrides, offsets into text.

Returns

True on success.

Definition at line 433 of file InkPress.cpp.

{
    if (!target) {
        MF_ERROR(Journal::Component::Portal, Journal::Context::API,
            "repress: target buffer is null");
        return false;
    }
 
    GlyphAtlas* atlas = resolve_atlas(nullptr);
    if (!atlas) {
        return false;
    }
 
    target->clear_accumulated_text();
    target->reset_cursor();
 
    const uint32_t buf_w = target->get_budget_width();
    const uint32_t buf_h = target->get_budget_height();
    const uint32_t bound_h = target->get_render_bounds_h();
    const glm::vec4 background = target->get_background();
 
    const auto result = composite(text, *atlas, color, buf_w, bound_h,
        static_cast<float>(atlas->line_height()), spans, background);
    if (!result) {
        MF_WARN(Journal::Component::Portal, Journal::Context::API,
            "repress: no glyphs produced for '{}'", std::string(text));
        return false;
    }
 
    if (result->h > buf_h && policy == RedrawPolicy::Fit) {
        const uint32_t new_h = std::min(result->h, bound_h);
        target->resize_texture(buf_w, new_h);
        target->set_budget(buf_w, new_h);
        target->set_pixel_data(result->pixels.data(), result->pixels.size());
        target->get_cursor_x() = result->cursor_x;
        target->get_cursor_y() = result->cursor_y;
        target->set_accumulated_text(text);
 
        MF_DEBUG(Journal::Component::Portal, Journal::Context::API,
            "repress(Fit): resized to {}x{}", buf_w, new_h);
        return true;
    }
 
    const size_t buf_bytes = static_cast<size_t>(buf_w) * buf_h * 4;
    std::vector<uint8_t> cleared = make_filled(buf_bytes, background);
 
    const uint32_t copy_h = std::min(result->h, buf_h);
    for (uint32_t row = 0; row < copy_h; ++row) {
        std::memcpy(
            cleared.data() + static_cast<size_t>(row) * buf_w * 4,
            result->pixels.data() + static_cast<size_t>(row) * buf_w * 4,
            static_cast<size_t>(buf_w) * 4);
    }
 
    target->set_pixel_data(cleared.data(), buf_bytes);
    target->get_cursor_x() = result->cursor_x;
    target->get_cursor_y() = result->cursor_y;
    // target->get_cursor_y() = result->h;
    target->set_accumulated_text(text);
 
    MF_DEBUG(Journal::Component::Portal, Journal::Context::API,
        "repress(Clip): '{}' -> {}x{} into {}x{} budget",
        std::string(text), buf_w, result->h, buf_w, buf_h);
 
    return true;
}

References MayaFlux::Journal::API, color, Fit, MayaFlux::Portal::Text::GlyphAtlas::line_height(), MF_DEBUG, MF_ERROR, MF_WARN, and MayaFlux::Journal::Portal.

Here is the call graph for this function: