libcamera  v0.5.0+45-f3a12332
Supporting cameras in Linux since 2019
All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
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 <stdint.h>
15 #include <string>
16 
17 #include <libcamera/base/class.h>
18 
19 #include <libcamera/camera.h>
20 
21 namespace libcamera {
22 
23 class CameraControlValidator;
24 class PipelineHandler;
25 class Stream;
26 
28 {
30 
31 public:
33  ~Private();
34 
35  PipelineHandler *pipe() { return pipe_.get(); }
36  const PipelineHandler *pipe() const { return pipe_.get(); }
37 
38  std::list<Request *> queuedRequests_;
41 
42  uint32_t requestSequence_;
43 
44  const CameraControlValidator *validator() const { return validator_.get(); }
45 
46 private:
47  enum State {
48  CameraAvailable,
49  CameraAcquired,
50  CameraConfigured,
51  CameraStopping,
52  CameraRunning,
53  };
54 
55  bool isAcquired() const;
56  bool isRunning() const;
57  int isAccessAllowed(State state, bool allowDisconnected = false,
58  const char *from = __builtin_FUNCTION()) const;
59  int isAccessAllowed(State low, State high,
60  bool allowDisconnected = false,
61  const char *from = __builtin_FUNCTION()) const;
62 
63  void disconnect();
64  void setState(State state);
65 
66  std::shared_ptr<PipelineHandler> pipe_;
67  std::string id_;
68  std::set<Stream *> streams_;
69  std::set<const Stream *> activeStreams_;
70 
71  bool disconnected_;
72  std::atomic<State> state_;
73 
74  std::unique_ptr<CameraControlValidator> validator_;
75 };
76 
77 } /* namespace libcamera */
Base class for private data managed through a d-pointer.
Definition: class.h:64
Utilities to help constructing class interfaces.
ControlList properties_
The list of properties supported by the camera.
Definition: camera.h:40
Camera device handling.
Top-level libcamera namespace.
Definition: backtrace.h:17
PipelineHandler * pipe()
Retrieve the pipeline handler related to this camera.
Definition: camera.h:35
ControlInfoMap controlInfo_
The set of controls supported by the camera.
Definition: camera.h:39
#define LIBCAMERA_DECLARE_PUBLIC(klass)
Declare public data for a private class.
A control validator for Camera instances.
Definition: camera_controls.h:16
uint32_t requestSequence_
The queuing sequence number of the request.
Definition: camera.h:42
A map of ControlId to ControlInfo.
Definition: controls.h:366
Private()
Construct an instance of an Extensible class private data.
Definition: class.cpp:194
Create and manage cameras based on a set of media devices.
Definition: pipeline_handler.h:33
Camera device.
Definition: camera.h:113
Base class for camera private data.
Definition: camera.h:27
const CameraControlValidator * validator() const
Retrieve the control validator related to this camera.
Definition: camera.h:44
Associate a list of ControlId with their values for an object.
Definition: controls.h:410
const PipelineHandler * pipe() const
Retrieve the pipeline handler related to this camera.
Definition: camera.h:36
std::list< Request * > queuedRequests_
The list of queued and not yet completed requests.
Definition: camera.h:38