Argus API
Argus Camera API
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Macros Pages
UUID.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 _ARGUS_UUID_H
30 #define _ARGUS_UUID_H
31 
32 #include <stdint.h>
33 #include <cstring>
34 
35 /**
36  * @file UUID.h
37  * Defines the UUID types used by Argus.
38  */
39 
40 namespace Argus
41 {
42 
43 const uint32_t MAX_UUID_NAME_SIZE = 32;
44 
45 /**
46  * UUID
47  */
48 struct UUID
49 {
50  uint32_t time_low;
51  uint16_t time_mid;
53  uint16_t clock_seq;
54  uint8_t node[6];
55 };
56 
57 bool operator==(const UUID& l, const UUID& r);
58 bool operator<(const UUID& l, const UUID& r);
59 
60 /**
61  * A unique identifier with a name (primarily for debugging purposes).
62  */
63 class NamedUUID : public UUID
64 {
65 public:
66  NamedUUID(uint32_t time_low_
67  , uint16_t time_mid_
68  , uint16_t time_hi_and_version_
69  , uint16_t clock_seq_
70  , uint8_t c0, uint8_t c1, uint8_t c2, uint8_t c3, uint8_t c4, uint8_t c5
71  , const char* name)
72  {
73  time_low = time_low_;
74  time_mid = time_mid_;
75  time_hi_and_version = time_hi_and_version_;
76  clock_seq = clock_seq_;
77  node[0] = c0; node[1] = c1; node[2] = c2; node[3] = c3; node[4] = c4; node[5] = c5;
78  strncpy(m_name, name, sizeof(m_name));
79  }
80 
81  NamedUUID(const NamedUUID& copied)
82  : UUID(copied)
83  {
84  strncpy(m_name, copied.m_name, sizeof(m_name));
85  }
86 
87  NamedUUID& operator=(const NamedUUID& copied)
88  {
89  static_cast<UUID&>(*this) = copied;
90 
91  return *this;
92  }
93 
94  bool operator==(const NamedUUID& compared) const
95  {
96  return static_cast<const UUID&>(*this) == compared;
97  }
98 
99  bool operator!=(const NamedUUID& compared) const
100  {
101  return !(static_cast<const UUID&>(*this) == compared);
102  }
103 
104  const char* getName() const { return m_name; }
105 
106 private:
108 
109  NamedUUID();
110 };
111 
112 /// Helper macro used to define NamedUUID-derived values.
113 #define DEFINE_UUID(TYPE, NAME, l, s0, s1, s2, c0,c1,c2,c3,c4,c5) \
114  static const TYPE NAME(0x##l, 0x##s0, 0x##s1, 0x##s2, \
115  0x##c0, 0x##c1, 0x##c2, 0x##c3, 0x##c4, 0x##c0, #NAME);
116 
117 #define DEFINE_NAMED_UUID_CLASS(NAME) \
118  class NAME : public NamedUUID \
119  { \
120  public: \
121  NAME(uint32_t time_low_ \
122  , uint16_t time_mid_ \
123  , uint16_t time_hi_and_version_ \
124  , uint16_t clock_seq_ \
125  , uint8_t c0, uint8_t c1, uint8_t c2, uint8_t c3, uint8_t c4, uint8_t c5 \
126  , const char* name) \
127  : NamedUUID(time_low_, time_mid_, time_hi_and_version_, clock_seq_, \
128  c0, c1, c2, c3, c4, c5, name) \
129  {} \
130  private: \
131  NAME();\
132  };
133 
134 } // namespace Argus
135 
136 #endif // _ARGUS_UUID_H