place()

TextField & MayaFlux::Portal::Forma::TextField::place	(	FormaTarget	in_buf,
		Surface &	surface,
		Kinesis::AABB2D	bounds,
		std::shared_ptr< Portal::Text::PressParams >	in_params,
		std::string	initial_text = {}
	)

Register the text field element and wire text editing onto it.

Parameters

in_buf	Pre-created target for the text - must have an additional_textures slot at index 0 (Element::with_text's requirement).
surface	Surface to register the element on.
bounds	NDC region: hit-test bounds and the text.
in_params	Shared render params. A default-constructed one is allocated if null.
initial_text	Starting text. Cursor starts at its end.

Returns

*this, with results populated.

Definition at line 134 of file TextField.cpp.

{
    buf = std::move(in_buf);
    field_bounds = bounds;
    m_live_bounds = std::make_shared<Kinesis::AABB2D>(bounds);
 
    params = std::move(in_params);
    if (!params)
        params = std::make_shared<Portal::Text::PressParams>();
 
    m_element = Element {}
                    .with_name("text_field")
                    .with_bounds(bounds)
                    .with_buffer(buf)
                    .with_text(initial_text, *params, bounds);
    slice = m_element.text_slice;
 
    element_id = surface.layer().add(m_element);
    m_element.id = element_id;
 
    state = std::make_shared<MappedState<Portal::Text::EditableText>>();
    state->value.cursor = initial_text.size();
    state->value.text = std::move(initial_text);
 
    render_caret(*slice, state->value, *params);
 
    wire(surface.ctx());
 
    return *this;
}

References MayaFlux::Portal::Forma::Layer::add(), bounds(), buf, MayaFlux::Portal::Forma::Surface::ctx(), element_id, field_bounds, MayaFlux::Portal::Forma::Element::id, MayaFlux::Portal::Forma::Surface::layer(), m_element, m_live_bounds, params, slice, state, MayaFlux::Portal::Forma::Element::text_slice, wire(), 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::create_text_field(), and scrollable().

Here is the call graph for this function:

Here is the caller graph for this function: