create()

template<typename T >

Mapped< T > MayaFlux::Portal::Forma::create	(	Surface &	surface,
		Geometry::Form< T >	form,
		T	initial,
		std::function< float(T)>	project = {}
	)

Realize a Form on surface.

Builds the buffer at the Form's capacity and topology, registers the element, syncs so the geometry function's bounds_hint and contains reach the Layer before the first frame, then runs the Form's interaction wiring.

A bare GeometryFn converts to a Form, so this also serves as the simplest element construction path for a caller's own geometry.

Template Parameters

T	MappedState value type.

Parameters

surface	Canvas to register on.
form	Geometry, topology, capacity, and interaction.
initial	Starting value written into MappedState.
project	Optional T to float projection for outbound readers.

Returns

Fully constructed Mapped<T>, wired.

Definition at line 277 of file Forma.hpp.

                                    {})
{
    auto mapped = internal::atelier().create_element<T>(
        surface.layer(), surface.window(),
        std::move(form.geometry), std::move(initial),
        form.topology, form.capacity, std::move(project));
 
    mapped.sync();
    if (mapped.element.bounds_hint)
        surface.layer().set_bounds(mapped.element.id, *mapped.element.bounds_hint);
    if (mapped.element.contains)
        surface.layer().set_contains(mapped.element.id, mapped.element.contains);
 
    if (form.wire)
        form.wire(surface.ctx(), mapped.element.id, mapped.state);
 
    return mapped;
}