How libcamera-org/libcamera works
libcamera is a Linux, Android, and ChromeOS camera support library. The principal flow is camera discovery, device-specific pipeline matching and configuration, then request-based frame capture; IPA modules provide image-processing control. Users can access the stack through the core API and documented Android, GStreamer, cam, and qcam interfaces. The graph emphasizes the core runtime and major documented interfaces. Evidence is limited to the README and the sampled excerpts or SOURCE INDEX references; unsampled implementation details are not asserted.
Main entry points: pipeline_handler.cpp Pipeline handler · camera_manager.cpp Camera manager · camera.cpp Camera API · media_pipeline.cpp Media pipeline
Components 20
Camera Core
- Camera manager
src/libcamera/camera_manager.cpp - Pipeline handler
src/libcamera/pipeline_handler.cpp - Camera API
src/libcamera/camera.cpp - Capture request
src/libcamera/request.cpp - Frame buffers
src/libcamera/framebuffer.cpp
Media Devices
- Device enumerator
src/libcamera/device_enumerator.cpp - Media pipeline
src/libcamera/media_pipeline.cpp - Camera sensor
src/libcamera/sensor/camera_sensor.cpp - V4L2 devices
src/libcamera/v4l2_device.cpp - Raspberry Pi pipeline
src/libcamera/pipeline/rpi/common/pipeline_base.cpp
Image Processing
- IPA manager
src/libcamera/ipa_manager.cpp - IPA proxy
src/libcamera/ipa_proxy.cpp - RPi ISP algorithms
src/ipa/rpi/controller/controller.cpp
Client Interfaces
- Android HAL
src/android/camera_hal_manager.cpp - GStreamer plugin
src/gstreamer/gstlibcamerasrc.cpp - Python bindings
src/py/libcamera/py_camera_manager.cpp
Capture Applications
- cam capture tool
src/apps/cam/main.cpp - qcam viewer
src/apps/qcam/main.cpp
Other components
- Application user
- Linux media devices
Connections 23
- Application user → cam capture tool: runs capture
README.rst - Application user → GStreamer plugin: builds pipelines
README.rst - Application user → Android HAL: uses camera HAL
README.rst - Application user → qcam viewer: views camera
- Camera manager → Device enumerator: starts discovery
src/libcamera/camera_manager.cpp - Camera manager → Pipeline handler: matches factories
src/libcamera/camera_manager.cpp - Camera manager → IPA manager: initializes manager
src/libcamera/camera_manager.cpp - Device enumerator → Linux media devices: enumerates devices
- Pipeline handler → Media pipeline: configures topology
- Media pipeline → Camera sensor: configures sensor
src/libcamera/media_pipeline.cpp - Media pipeline → V4L2 devices: routes subdevices
src/libcamera/media_pipeline.cpp - Pipeline handler → Camera API: registers cameras
src/libcamera/pipeline_handler.cpp - Camera API → Capture request: queues capture
- Pipeline handler → Capture request: queues prepared requests
src/libcamera/pipeline_handler.cpp - Pipeline handler → Frame buffers: completes buffers
- Pipeline handler → IPA manager: creates IPA
- IPA manager → IPA proxy: creates proxy
- Raspberry Pi pipeline → IPA proxy: configures IPA
src/libcamera/pipeline/rpi/common/pipeline_base.cpp - Android HAL → Camera API: opens camera
src/android/camera_hal_manager.cpp - cam capture tool → Camera manager: starts manager
src/apps/cam/main.cpp - cam capture tool → Camera API: creates sessions
src/apps/cam/main.cpp - GStreamer plugin → Camera API: captures frames
README.rst - Python bindings → Camera manager: binds manager
src/py/libcamera/py_camera_manager.cpp