libcamera v0.3.2 Supporting cameras in Linux since 2019

Loading...
Searching...
No Matches
camera.h
Go to the documentation of this file.
1/* SPDX-License-Identifier: LGPL-2.1-or-later */
2/*
3 * Copyright (C) 2021, Google Inc.
4 *
5 * Camera private data
6 */
7
8#pragma once
9
10#include <atomic>
11#include <list>
12#include <memory>
13#include <set>
14#include <string>
15
16#include <libcamera/base/class.h>
17
18#include <libcamera/camera.h>
19
20 namespace libcamera {
21
22 class CameraControlValidator;
23 class PipelineHandler;
24 class Stream;
25
26 class Camera::Private : public Extensible::Private
27{
28 LIBCAMERA_DECLARE_PUBLIC(Camera)
29
30 public:
31 Private(PipelineHandler *pipe);
32 ~Private();
33
34 PipelineHandler *pipe() { return pipe_.get(); }
35
36 std::list<Request *> queuedRequests_;
37 ControlInfoMap controlInfo_;
38 ControlList properties_;
39
40 uint32_t requestSequence_;
41
42 const CameraControlValidator *validator() const { return validator_.get(); }
43
44 private:
45 enum State {
46 CameraAvailable,
47 CameraAcquired,
48 CameraConfigured,
49 CameraStopping,
50 CameraRunning,
51 };
52
53 bool isAcquired() const;
54 bool isRunning() const;
55 int isAccessAllowed(State state, bool allowDisconnected = false,
56 const char *from = __builtin_FUNCTION()) const;
57 int isAccessAllowed(State low, State high,
58 bool allowDisconnected = false,
59 const char *from = __builtin_FUNCTION()) const;
60
61 void disconnect();
62 void setState(State state);
63
64 std::shared_ptr<PipelineHandler> pipe_;
65 std::string id_;
66 std::set<Stream *> streams_;
67 std::set<const Stream *> activeStreams_;
68
69 bool disconnected_;
70 std::atomic<State> state_;
71
72 std::unique_ptr<CameraControlValidator> validator_;
73};
74
75} /* namespace libcamera */
camera.h
Camera device handling.
class.h
Utilities to help constructing class interfaces.
LIBCAMERA_DECLARE_PUBLIC
#define LIBCAMERA_DECLARE_PUBLIC(klass)
Declare public data for a private class.
Definition class.h:57
libcamera::CameraControlValidator
A control validator for Camera instances.
Definition camera_controls.h:17
libcamera::Camera::Private
Base class for camera private data.
Definition camera.h:27
libcamera::Camera::Private::requestSequence_
uint32_t requestSequence_
The queuing sequence number of the request.
Definition camera.h:40
libcamera::Camera::Private::queuedRequests_
std::list< Request * > queuedRequests_
The list of queued and not yet completed requests.
Definition camera.h:36
libcamera::Camera::Private::properties_
ControlList properties_
The list of properties supported by the camera.
Definition camera.h:38
libcamera::Camera::Private::pipe
PipelineHandler * pipe()
Retrieve the pipeline handler related to this camera.
Definition camera.h:34
libcamera::Camera::Private::controlInfo_
ControlInfoMap controlInfo_
The set of controls supported by the camera.
Definition camera.h:37
libcamera::Camera::Private::validator
const CameraControlValidator * validator() const
Retrieve the control validator related to this camera.
Definition camera.h:42
libcamera::Camera
Camera device.
Definition camera.h:115
libcamera::ControlInfoMap
A map of ControlId to ControlInfo.
Definition controls.h:306
libcamera::ControlList
Associate a list of ControlId with their values for an object.
Definition controls.h:350
libcamera::Extensible::Private
Base class for private data managed through a d-pointer.
Definition class.h:65
libcamera::Extensible::Private::Private
Private()
Construct an instance of an Extensible class private data.
Definition class.cpp:194
libcamera::PipelineHandler
Create and manage cameras based on a set of media devices.
Definition pipeline_handler.h:35
libcamera
Top-level libcamera namespace.
Definition backtrace.h:17