place_label()

MAYAFLUX_API uint32_t MayaFlux::Portal::Forma::Plot::place_label	(	Surface &	surface,
		FormaTarget	buf,
		const LabelSpec &	spec,
		uint32_t	relate_to = 0
	)

Place a text label element onto surface using a text-capable target.

buf must have been created with an additional_textures slot named "text" (or equivalent). Buffer construction is the caller's responsibility; Portal::Forma::plot() handles this automatically.

Parameters

surface	Target surface.
buf	TRIANGLE_LIST slice of a text-capable buffer. Labels may share that buffer.
spec	Label geometry and style.
relate_to	If non-zero, the produced element is related to this id.

Returns

Element id of the produced label element.

Definition at line 15 of file Plot.cpp.

{
    const bool auto_render_bounds = spec.render_bounds.x <= 0 || spec.render_bounds.y <= 0;
 
    const auto render_bounds = auto_render_bounds
        ? Kinesis::ndc_size_to_pixels(
              { spec.bounds.width(), spec.bounds.height() },
              surface.window()->get_state().current_width,
              surface.window()->get_state().current_height)
        : spec.render_bounds;
 
    Element el;
    el.with_buffer(buf)
        .with_bounds(spec.bounds)
        .with_name(spec.name)
        .with_text(spec.text,
            Portal::Text::PressParams {
                .color = spec.color,
                .render_bounds = render_bounds,
            },
            spec.bounds);
 
    if (!spec.interactive)
        el.non_interactive();
 
    const uint32_t id = surface.layer().add(std::move(el));
    if (relate_to != 0)
        surface.layer().relate(relate_to, id);
 
    if (auto_render_bounds) {
        surface.ctx().on_resize(id,
            [surface, id, text = spec.text, color = spec.color, bounds = spec.bounds](uint32_t, uint32_t) mutable {
                const auto dims = Kinesis::ndc_size_to_pixels(
                    { bounds.width(), bounds.height() },
                    surface.window()->get_state().current_width,
                    surface.window()->get_state().current_height);
 
                if (auto* element = surface.layer().get(id))
                    element->set_text(text, Portal::Text::PressParams { .color = color, .render_bounds = dims });
            });
    }
 
    return id;
}

References MayaFlux::Portal::Forma::Layer::add(), MayaFlux::Portal::Forma::Plot::LabelSpec::bounds, color, MayaFlux::Portal::Forma::Plot::LabelSpec::color, MayaFlux::Portal::Text::PressParams::color, MayaFlux::Portal::Forma::Surface::ctx(), MayaFlux::Portal::Forma::Layer::get(), MayaFlux::Kinesis::AABB2D::height(), MayaFlux::Portal::Forma::Plot::LabelSpec::interactive, MayaFlux::Portal::Forma::Surface::layer(), MayaFlux::Portal::Forma::Plot::LabelSpec::name, MayaFlux::Kinesis::ndc_size_to_pixels(), MayaFlux::Portal::Forma::Element::non_interactive(), MayaFlux::Portal::Forma::Context::on_resize(), MayaFlux::Portal::Forma::Layer::relate(), MayaFlux::Portal::Forma::Plot::LabelSpec::render_bounds, MayaFlux::Portal::Forma::Plot::LabelSpec::text, MayaFlux::Kinesis::AABB2D::width(), MayaFlux::Portal::Forma::Surface::window(), MayaFlux::Portal::Forma::Element::with_bounds(), MayaFlux::Portal::Forma::Element::with_buffer(), MayaFlux::Portal::Forma::Element::with_name(), and MayaFlux::Portal::Forma::Element::with_text().

Referenced by MayaFlux::Portal::Forma::internal::Atelier::place_adornments().

Here is the call graph for this function:

Here is the caller graph for this function: