pick() [1/2]

MAYAFLUX_API void MayaFlux::Portal::Forma::pick	(	std::string	title,
		std::vector< std::string >	labels,
		PickCallback	callback
	)

Open a window of clickable rows, one per label, and report the choice.

Requires Portal::Forma to be initialized and the engine running. The callback fires exactly once, on the event thread, so it must not block. Selecting a row hides the window and delivers its index. Closing the window delivers nullopt. Lists longer than ten rows scroll with the mouse wheel. An empty list delivers nullopt immediately.

Parameters

title	Window title.
labels	Row captions, in display order.
callback	Invoked once with the chosen index or nullopt.

Definition at line 46 of file Picker.cpp.

{
    if (labels.empty()) {
        MF_WARN(Journal::Component::Portal, Journal::Context::API,
            "Forma::pick: empty list");
        if (callback) {
            callback(std::nullopt);
        }
        return;
    }
 
    uint32_t row_px = k_min_row_px;
    if (auto atlas = Text::TypeFaceFoundry::instance().get_default_glyph_atlas()) {
        row_px = std::max(row_px, static_cast<uint32_t>(atlas->pixel_size()) + k_row_padding_px);
    }
 
    const auto rows = static_cast<uint32_t>(labels.size());
    const uint32_t visible = std::min(rows, k_max_visible_rows);
    const bool scrolling = rows > visible;
    const uint32_t window_h = row_px * visible + (scrolling ? row_px / 2 : 0);
 
    auto& atelier = internal::atelier();
 
    auto window = atelier.create_window(Core::WindowCreateInfo {
        .title = std::move(title),
        .width = k_width_px,
        .height = window_h,
        .resizable = false,
    });
 
    auto state = std::make_shared<PickerState>();
    state->callback = std::move(callback);
    state->window = window;
 
    Surface surface = atelier.create_surface(SurfaceConfig {
        .window = window,
        .name = window->get_create_info().title,
        .on_close = [state] { state->finish(std::nullopt); },
    });
 
    const auto text_batch = atelier.create_buffer(
        surface.render_config({ .additional_textures = { { "text", nullptr } } }));
 
    std::optional<Scrollable> panel;
    std::function<void(uint32_t, glm::vec2, double, double)> wheel;
    if (scrolling) {
        auto panel_buf = FormaTarget::slice_of(text_batch, Graphics::PrimitiveTopology::TRIANGLE_STRIP);
        panel = make_scrollable(std::move(panel_buf), surface, surface.full(), glm::vec3(internal::row_idle_color()));
        wheel = panel->wheel_handler(surface);
    }
 
    const auto row_dims = std::make_shared<glm::uvec2>(k_width_px, row_px);
 
    const float row_h = 2.F * static_cast<float>(row_px) / static_cast<float>(window_h);
    const float gap = 2.F / static_cast<float>(window_h);
 
    for (uint32_t i = 0; i < rows; ++i) {
        const float top = 1.F - row_h * static_cast<float>(i);
        const Kinesis::AABB2D bounds {
            .min = { -1.F, top - row_h + gap },
            .max = { 1.F, top - gap },
        };
 
        auto made = internal::add_text_row(surface, labels.at(i), bounds, *row_dims, text_batch);
        const uint32_t id = made.first;
        const auto& row = made.second;
 
        internal::hover_text_row(surface, id, row, labels.at(i), row_dims);
        surface.ctx().on_press(id, IO::MouseButtons::Left, [state, i](uint32_t, glm::vec2) {
            state->finish(i);
        });
 
        if (panel) {
            surface.ctx().on_scroll(id, wheel);
            panel->track(
                surface.layer(), id, bounds,
                [row](Kinesis::AABB2D shifted) { row->retarget(shifted); },
                row->buffer);
        }
    }
}

References MayaFlux::Journal::API, MayaFlux::Portal::Forma::internal::atelier(), callback, MayaFlux::Portal::Forma::internal::Atelier::create_buffer(), MayaFlux::Portal::Forma::internal::Atelier::create_surface(), MayaFlux::Portal::Forma::internal::Atelier::create_window(), MayaFlux::Portal::Text::TypeFaceFoundry::instance(), MF_WARN, MayaFlux::Journal::Portal, MayaFlux::Portal::Forma::Surface::render_config(), rows, MayaFlux::Core::WindowCreateInfo::title, window, and MayaFlux::Portal::Forma::SurfaceConfig::window.

Referenced by MayaFlux::choose_camera(), and pick().

Here is the call graph for this function:

Here is the caller graph for this function: