create_buffer()

std::shared_ptr< Buffers::FormaBuffer > MayaFlux::Portal::Forma::internal::Atelier::create_buffer

(

Graphics::RenderConfig

render

)

The single buffer construction path.

Registers a FormaBuffer with the stored BufferManager under GRAPHICS_BACKEND and sets up rendering. The buffer always triangulates with TRIANGLE_LIST: what it draws is expressed by the topology of the slices made on it with FormaTarget::slice_of. Line and point slices are milled into NDC ribbons whose scalar is a width in pixels of the window's height at creation.

Parameters

render

Render settings; build it with Surface::render_config. Its topology and triangulate are set here.

Definition at line 117 of file Atelier.cpp.

{
    if (!m_initialized) {
        error<std::runtime_error>(Journal::Component::Portal, Journal::Context::API,
            std::source_location::current(),
            "Portal::Forma not initialized - cannot create buffer");
    }
 
    if (!render.target_window) {
        error<std::invalid_argument>(Journal::Component::Portal, Journal::Context::API,
            std::source_location::current(),
            "Portal::Forma create_buffer requires a target window");
    }
 
    render.topology = Graphics::PrimitiveTopology::TRIANGLE_LIST;
    render.triangulate = true;
 
    auto buf = std::make_shared<Buffers::FormaBuffer>(k_capacity_bytes, render.topology);
    m_buffer_manager->add_buffer(buf, Buffers::ProcessingToken::GRAPHICS_BACKEND);
 
    const auto height = std::max(render.target_window->get_create_info().height, 1U);
    buf->setup_rendering(render);
 
    if (auto processor = buf->get_render_processor()) {
        Graphics::MillSpec spec = processor->get_mill_spec();
        spec.ribbon = Graphics::MillSpec::Ribbon::WorldPlane;
        spec.width_scale = 2.0F / static_cast<float>(height);
        processor->set_mill_spec(spec);
    }
    return buf;
}

References MayaFlux::Journal::API, MayaFlux::Buffers::GRAPHICS_BACKEND, height, MayaFlux::Portal::Forma::internal::k_capacity_bytes, m_buffer_manager, m_initialized, MayaFlux::Journal::Portal, MayaFlux::Portal::Graphics::MillSpec::ribbon, MayaFlux::Portal::Graphics::RenderConfig::target_window, MayaFlux::Portal::Graphics::RenderConfig::topology, MayaFlux::Portal::Graphics::TRIANGLE_LIST, MayaFlux::Portal::Graphics::RenderConfig::triangulate, MayaFlux::Portal::Graphics::MillSpec::width_scale, and MayaFlux::Portal::Graphics::MillSpec::WorldPlane.

Referenced by MayaFlux::Portal::Forma::create_buffer(), MayaFlux::Portal::Forma::pick(), MayaFlux::Portal::Forma::Dropdown::place(), place_adornments(), and MayaFlux::Portal::Forma::plot().

Here is the caller graph for this function: