Argus Camera Sample Argus Camera Sample

- Main Page
- Related Pages
- Namespaces
- Classes
- Files

- File List
- File Members

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:
50 TaskMultiExposure();
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
90 TrackedUniqueObj<Argus::Request> m_request; ///< Argus request
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 sensor mode or output size changes
118 */
119 bool restartStreams(const Observed &source);
120 };
121
122 }; // namespace ArgusSamples
123
124 #endif // TASK_MULTI_EXPOSURE_H