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)-1);
79  m_name[sizeof(m_name)-1] = '\0';
80  }
81 
82  NamedUUID(const NamedUUID& copied)
83  : UUID(copied)
84  {
85  strncpy(m_name, copied.m_name, sizeof(m_name)-1);
86  m_name[sizeof(m_name)-1] = '\0';
87  }
88 
89  NamedUUID& operator=(const NamedUUID& copied)
90  {
91  static_cast<UUID&>(*this) = copied;
92 
93  return *this;
94  }
95 
96  bool operator==(const NamedUUID& compared) const
97  {
98  return static_cast<const UUID&>(*this) == compared;
99  }
100 
101  bool operator!=(const NamedUUID& compared) const
102  {
103  return !(static_cast<const UUID&>(*this) == compared);
104  }
105 
106  const char* getName() const { return m_name; }
107 
108 private:
110 
111  NamedUUID();
112 };
113 
114 /// Helper macro used to define NamedUUID-derived values.
115 #define DEFINE_UUID(TYPE, NAME, l, s0, s1, s2, c0,c1,c2,c3,c4,c5) \
116  static const TYPE NAME(0x##l, 0x##s0, 0x##s1, 0x##s2, \
117  0x##c0, 0x##c1, 0x##c2, 0x##c3, 0x##c4, 0x##c0, #NAME);
118 
119 #define DEFINE_NAMED_UUID_CLASS(NAME) \
120  class NAME : public NamedUUID \
121  { \
122  public: \
123  NAME(uint32_t time_low_ \
124  , uint16_t time_mid_ \
125  , uint16_t time_hi_and_version_ \
126  , uint16_t clock_seq_ \
127  , uint8_t c0, uint8_t c1, uint8_t c2, uint8_t c3, uint8_t c4, uint8_t c5 \
128  , const char* name) \
129  : NamedUUID(time_low_, time_mid_, time_hi_and_version_, clock_seq_, \
130  c0, c1, c2, c3, c4, c5, name) \
131  {} \
132  private: \
133  NAME();\
134  };
135 
136 } // namespace Argus
137 
138 #endif // _ARGUS_UUID_H