Argus Camera Sample
Argus Camera Sample
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Pages
MultiExposure.h
Go to the documentation of this file.
1 /*
2  * Copyright (c) 2016, NVIDIA CORPORATION. All rights reserved.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions
6  * are met:
7  * * Redistributions of source code must retain the above copyright
8  * notice, this list of conditions and the following disclaimer.
9  * * Redistributions in binary form must reproduce the above copyright
10  * notice, this list of conditions and the following disclaimer in the
11  * documentation and/or other materials provided with the distribution.
12  * * Neither the name of NVIDIA CORPORATION nor the names of its
13  * contributors may be used to endorse or promote products derived
14  * from this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ``AS IS'' AND ANY
17  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
19  * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
20  * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
21  * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
22  * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
23  * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
24  * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
25  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
26  * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
27  */
28 
29 #ifndef TASK_MULTI_EXPOSURE_H
30 #define TASK_MULTI_EXPOSURE_H
31 
32 #include <list>
33 
34 #include <Argus/Argus.h>
35 
36 #include "ITask.h"
37 #include "Value.h"
38 #include "IObserver.h"
39 #include "TrackedUniqueObject.h"
40 
41 namespace ArgusSamples
42 {
43 
44 /**
45  * This task captures multiple streams with different exposure compensation values.
46  */
47 class TaskMultiExposure : public ITask, public IObserver
48 {
49 public:
51  virtual ~TaskMultiExposure();
52 
53  /** @name ITask methods */
54  /**@{*/
55  virtual bool initialize();
56  virtual bool shutdown();
57  virtual bool start();
58  virtual bool stop();
59  /**@}*/
60 
61 private:
62  // the range values need to be initialized first, some Value<> members below use them
63  // for the validator
64  Value<Argus::Range<uint32_t> > m_exposureStepsRange; ///< allowed exposure steps
65 
66 public:
67  Value<uint32_t> m_exposureSteps; ///< steps within the exposure range
68  Value<Argus::Range<float> > m_exposureRange; ///< in eV, e.g. -1,2 results in exposures from
69  /// -1 eV to +2 eV
70 
71 private:
72  bool m_initialized; ///< set if initialized
73  bool m_running; ///< set if preview is running
74  bool m_wasRunning; ///< set if was running before the device had been closed
75  bool m_prevRunning; ///< set if was running before the sensorModeValid is set to false
76 
77  /**
78  * For each exposure level there is one request where the exposure compensation is set to the
79  * correct value. Each request outputs to a stream which is rendered.
80  */
81  class ExpLevel
82  {
83  public:
84  ExpLevel();
85  ~ExpLevel();
86 
87  bool shutdown();
88  bool initialize(float exposureCompensation);
89 
91  Argus::UniqueObj<Argus::OutputStream> m_outputStream; ///< Argus output stream
92  };
93 
94  std::list<ExpLevel*> m_expLevels; ///< exposure level
95 
96  /**
97  * Callback when the device is opened/closed.
98  */
99  bool onDeviceOpenChanged(const Observed &source);
100 
101  /**
102  * Callback when the sensorModeValid is changed.
103  */
104  bool onSensorModeValidChanged(const Observed &source);
105 
106  /**
107  * Callback when the exposure range or steps changes.
108  */
109  bool onParametersChanged(const Observed &source);
110 
111  /**
112  * Shut down the exposure level streams.
113  */
114  bool shutdownExpLevels();
115 
116  /**
117  * Restart when output size changes
118  */
119  bool restartStreams(const Observed &source);
120 };
121 
122 }; // namespace ArgusSamples
123 
124 #endif // TASK_MULTI_EXPOSURE_H