choose_camera()

MAYAFLUX_API std::shared_ptr< Kakshya::CameraContainer > MayaFlux::choose_camera

(

bool

choose_mode = true

)

Let the user pick a camera, and optionally a capture mode, then open it via IOManager::open_camera().

The pickers are Portal::Forma windows driven by the engine. Blocks until the user chooses or closes a window. Returns the opened container, ready for IOManager::hook_camera_to_buffer(), or nullptr on cancellation, when no camera is found, or if the camera fails to open. Portal::Forma must be initialized and the engine running.

Modes come from the camera source's presets. A mode is a request: the source falls back to the nearest mode the device accepts.

Parameters

choose_mode

If false, skip the mode picker and open with the default CameraConfig size and frame rate.

Definition at line 302 of file Depot.cpp.

{
    auto promise = std::make_shared<std::promise<std::shared_ptr<Kakshya::CameraContainer>>>();
    auto future = promise->get_future();
 
    const IO::FFmpegCameraReader reader;
    auto configs = reader.enumerate_configs();
    if (configs.empty()) {
        MF_ERROR(Journal::Component::API, Journal::Context::Runtime,
            "choose_camera: no cameras found");
        return nullptr;
    }
 
    Portal::Forma::pick("Choose a camera", std::move(configs),
        [](const IO::CameraConfig& config) {
            return config.display_name.empty() ? config.device_name : config.display_name;
        },
        [promise, choose_mode, modes = reader.preset_modes()](std::optional<IO::CameraConfig> camera) {
            if (!camera) {
                promise->set_value(nullptr);
                return;
            }
            if (!choose_mode) {
                promise->set_value(get_io_manager()->open_camera(*camera));
                return;
            }
            Portal::Forma::pick("Choose a mode", modes,
                [](const IO::CameraMode& mode) { return mode.label; },
                [promise, config = *camera](std::optional<IO::CameraMode> mode) mutable {
                    if (!mode) {
                        promise->set_value(nullptr);
                        return;
                    }
                    mode->apply(config);
                    promise->set_value(get_io_manager()->open_camera(config));
                });
        });
 
    return Parallel::await_future(std::move(future));
}

References MayaFlux::Journal::API, MayaFlux::Parallel::await_future(), MayaFlux::IO::CameraConfig::device_name, MayaFlux::IO::CameraConfig::display_name, MayaFlux::IO::FFmpegCameraReader::enumerate_configs(), get_io_manager(), MF_ERROR, mode, MayaFlux::Portal::Forma::pick(), MayaFlux::IO::FFmpegCameraReader::preset_modes(), and MayaFlux::Journal::Runtime.

Referenced by MayaFlux::Creator::read_camera().

Here is the call graph for this function:

Here is the caller graph for this function: