press()

MAYAFLUX_API std::shared_ptr< Buffers::TextBuffer > MayaFlux::Portal::Text::press	(	std::string_view	text,
		const PressParams &	params = {}
	)

Composite a UTF-8 string into a new TextBuffer.

The returned TextBuffer has width == params.render_bounds.x and height equal to either the explicit params.budget_h or the heuristic initial allocation, whichever is larger than the content height.

Parameters

text	UTF-8 string to composite.
params	Construction parameters. Default produces a growing buffer at 1280x720 render bounds using the default atlas.

Returns

Initialized TextBuffer, or nullptr on failure.

Definition at line 234 of file InkPress.cpp.

{
    GlyphAtlas* atlas = resolve_atlas(params.atlas);
    if (!atlas) {
        return nullptr;
    }
 
    const uint32_t buf_w = params.render_bounds.x;
 
    const auto result = composite(text, *atlas, params.color, buf_w, params.render_bounds.y,
        static_cast<float>(atlas->line_height()));
    if (!result) {
        MF_WARN(Journal::Component::Portal, Journal::Context::API,
            "press: no glyphs produced for '{}'", std::string(text));
        return nullptr;
    }
 
    const uint32_t budget_h = params.budget_h > 0
        ? std::max(params.budget_h, result->h)
        : std::min(result->h * k_grow_height_multiplier, params.render_bounds.y);
 
    return make_buffer(*result, buf_w, budget_h, params.render_bounds, text);
}

References MayaFlux::Journal::API, MayaFlux::Portal::Text::PressParams::atlas, MayaFlux::Portal::Text::PressParams::budget_h, MayaFlux::Portal::Text::PressParams::color, MayaFlux::Portal::Text::GlyphAtlas::line_height(), MF_WARN, MayaFlux::Journal::Portal, and MayaFlux::Portal::Text::PressParams::render_bounds.

Here is the call graph for this function: