create() [2/2]

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 a buffer of its own and draws the Form as a slice of it with the Form's 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 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 64 of file Tend.hpp.

                                    {})
{
    auto mapped = internal::atelier().create_element<T>(
        surface, std::move(form.geometry), std::move(initial),
        form.topology, std::move(project));
 
    if (form.wire)
        form.wire(surface.ctx(), mapped.element.id, mapped.state);
 
    return mapped;
}