open_camera()

std::shared_ptr< Kakshya::CameraContainer > MayaFlux::IO::IOManager::open_camera

(

const CameraConfig &

config

)

Open a camera device and create a CameraContainer.

Constructs a CameraReader, opens the device, creates the container, configures its FrameAccessProcessor (auto_advance disabled), assigns a globally unique reader_id, registers the reader for IOService dispatch, and wires the container's IOService callback via CameraContainer::setup_io().

After this call, the normal processing pipeline drives frame pulls: CameraContainer::process_default() → IOService::request_frame(reader_id) → dispatch_frame_request() → CameraReader::pull_frame_all() → decode thread → pull_frame() → mutable_frame_ptr() write → READY.

Parameters

config

Device and resolution configuration.

Returns

Opened CameraContainer, or nullptr on failure.

Definition at line 253 of file IOManager.cpp.

{
    static std::once_flag s_avdevice_init;
    std::call_once(s_avdevice_init, [] { avdevice_register_all(); });
 
    auto reader = std::make_shared<CameraReader>();
 
    if (!reader->open(config)) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "open_camera: failed — {}", reader->last_error());
        return nullptr;
    }
 
    auto container = reader->create_container();
    if (!container) {
        MF_ERROR(Journal::Component::API, Journal::Context::FileIO,
            "open_camera: failed to create container — {}",
            reader->last_error());
        return nullptr;
    }
 
    container->create_default_processor();
 
    uint64_t rid = m_next_reader_id.fetch_add(1, std::memory_order_relaxed);
    reader->set_container(container);
 
    {
        std::unique_lock lock(m_camera_mutex);
        m_camera_readers[rid] = reader;
    }
 
    container->setup_io(rid);
    container->mark_ready_for_processing(true);
 
    MF_INFO(Journal::Component::API, Journal::Context::FileIO,
        "open_camera: reader_id={} device='{}' {}x{} @{:.1f}fps",
        rid, config.device_name,
        reader->width(), reader->height(), reader->frame_rate());
 
    return container;
}

References MayaFlux::Journal::API, MayaFlux::IO::CameraConfig::device_name, MayaFlux::Journal::FileIO, m_camera_mutex, m_camera_readers, m_next_reader_id, MF_ERROR, and MF_INFO.