28class FrameBufferAllocator;
41 using iterator = std::vector<StreamConfiguration>::iterator;
66 std::size_t
size()
const;
75 StreamsShareColorSpace,
85class Camera final :
public Object,
public std::enable_shared_from_this<Camera>,
91 static std::shared_ptr<Camera>
create(std::unique_ptr<Private> d,
92 const std::string &
id,
93 const std::set<Stream *> &
streams);
95 const std::string &
id()
const;
107 const std::set<Stream *> &
streams()
const;
120 Camera(std::unique_ptr<Private> d,
const std::string &
id,
121 const std::set<Stream *> &
streams);
126 void requestComplete(
Request *request);
129 int exportFrameBuffers(
Stream *stream,
130 std::vector<std::unique_ptr<FrameBuffer>> *buffers);
Utilities to help constructing class interfaces.
#define LIBCAMERA_DECLARE_PRIVATE()
Declare private data for a public class.
#define LIBCAMERA_DISABLE_COPY(klass)
Disable copy construction and assignment of the klass.
Hold configuration for streams of the camera.
Definition: camera.h:33
std::vector< StreamConfiguration >::iterator iterator
Iterator for the stream configurations in the camera configuration.
Definition: camera.h:41
std::vector< StreamConfiguration > config_
The vector of stream configurations.
Definition: camera.h:82
Status validateColorSpaces(ColorSpaceFlags flags=ColorSpaceFlag::None)
Check the color spaces requested for each stream.
Definition: camera.cpp:355
virtual Status validate()=0
Validate and possibly adjust the camera configuration.
ColorSpaceFlag
Specify the behaviour of validateColorSpaces.
Definition: camera.h:73
@ None
No extra validation of color spaces is required.
StreamConfiguration & at(unsigned int index)
Retrieve a reference to a stream configuration.
Definition: camera.cpp:217
Status
Validity of a camera configuration.
Definition: camera.h:35
@ Valid
Definition: camera.h:36
@ Adjusted
Definition: camera.h:37
@ Invalid
Definition: camera.h:38
const StreamConfiguration & operator[](unsigned int index) const
Retrieve a const reference to a stream configuration.
Definition: camera.h:55
bool empty() const
Check if the camera configuration is empty.
Definition: camera.cpp:306
CameraConfiguration()
Create an empty camera configuration.
Definition: camera.cpp:162
std::size_t size() const
Retrieve the number of stream configurations.
Definition: camera.cpp:315
void addConfiguration(const StreamConfiguration &cfg)
Add a stream configuration to the camera configuration.
Definition: camera.cpp:175
iterator begin()
Retrieve an iterator to the first stream configuration in the sequence.
Definition: camera.cpp:266
iterator end()
Retrieve an iterator pointing to the past-the-end stream configuration in the sequence.
Definition: camera.cpp:286
std::vector< StreamConfiguration >::const_iterator const_iterator
Const iterator for the stream configuration in the camera configuration.
Definition: camera.h:42
StreamConfiguration & operator[](unsigned int index)
Retrieve a reference to a stream configuration.
Definition: camera.h:51
Transform transform
User-specified transform to be applied to the image.
Definition: camera.h:68
Camera device.
Definition: camera.h:87
const std::set< Stream * > & streams() const
Retrieve all the camera's stream information.
Definition: camera.cpp:919
const ControlInfoMap & controls() const
Retrieve the list of controls supported by the camera.
Definition: camera.cpp:890
const std::string & id() const
Retrieve the ID of the camera.
Definition: camera.cpp:721
std::unique_ptr< CameraConfiguration > generateConfiguration(const StreamRoles &roles={})
Generate a default camera configuration according to stream roles.
Definition: camera.cpp:939
static std::shared_ptr< Camera > create(std::unique_ptr< Private > d, const std::string &id, const std::set< Stream * > &streams)
Create a camera instance.
Definition: camera.cpp:680
int configure(CameraConfiguration *config)
Configure the camera prior to capture.
Definition: camera.cpp:1001
int stop()
Stop capture from camera.
Definition: camera.cpp:1208
int acquire()
Acquire the camera device for exclusive access.
Definition: camera.cpp:826
int release()
Release exclusive access to the camera device.
Definition: camera.cpp:863
int start(const ControlList *controls=nullptr)
Start capture from camera.
Definition: camera.cpp:1171
std::unique_ptr< Request > createRequest(uint64_t cookie=0)
Create a request object for the camera.
Definition: camera.cpp:1073
Signal< Request * > requestCompleted
Signal emitted when a request queued to the camera has completed.
Definition: camera.h:98
int queueRequest(Request *request)
Queue a request to the camera.
Definition: camera.cpp:1113
const ControlList & properties() const
Retrieve the list of properties of the camera.
Definition: camera.cpp:903
Signal disconnected
Signal emitted when the camera is disconnected from the system.
Definition: camera.h:99
Signal< Request *, FrameBuffer * > bufferCompleted
Signal emitted when a buffer for a request queued to the camera has completed.
Definition: camera.h:97
A map of ControlId to ControlInfo.
Definition: controls.h:306
Associate a list of ControlId with their values for an object.
Definition: controls.h:350
Base class to manage private data through a d-pointer.
Definition: class.h:62
Type-safe container for enum-based bitfields.
Definition: flags.h:16
FrameBuffer allocator for applications.
Definition: framebuffer_allocator.h:23
Base object to support automatic signal disconnection.
Definition: object.h:25
Create and manage cameras based on a set of media devices.
Definition: pipeline_handler.h:39
A frame capture request.
Definition: request.h:31
Generic signal and slot communication mechanism.
Definition: signal.h:39
Video stream for a camera.
Definition: stream.h:77
Framework to manage controls related to an object.
Top-level libcamera namespace.
Definition: backtrace.h:17
Transform
Enum to represent a 2D plane transform.
Definition: transform.h:14
std::vector< StreamRole > StreamRoles
A vector of StreamRole.
Definition: stream.h:72
Base object to support automatic signal disconnection.
Describes a frame capture request to be processed by a camera.
Signal & slot implementation.
Video stream for a Camera.
Configuration parameters for a stream.
Definition: stream.h:41