create() [1/2]

template<typename T >

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

Realize a Form on surface as a slice of batch.

Like create(), but the element draws into a slice of the shared buffer instead of a buffer of its own, with the Form's topology. Make the buffer with create_buffer() and pass it to every Form that should draw together; the Form's capacity is not used, the batch grows. A Form that needs its own buffer, such as one scissored by a Scrollable, uses create() instead.

Template Parameters

T	MappedState value type.

Parameters

surface	Canvas to register on.
batch	Shared buffer from create_buffer().
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 28 of file Tend.hpp.

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