Zivid C++ API  2.3.1+1a22cbf1-1
Defining the Future of 3D Machine Vision
Point.h
Go to the documentation of this file.
1 
2 /*******************************************************************************
3  * This file is part of the Zivid 3D Camera API
4  *
5  * Copyright 2015-2022 (C) Zivid AS
6  * All rights reserved.
7  *
8  * Zivid Software License, v1.0
9  *
10  * Redistribution and use in source and binary forms, with or without
11  * modification, are permitted provided that the following conditions are met:
12  *
13  * 1. Redistributions of source code must retain the above copyright notice,
14  * this list of conditions and the following disclaimer.
15  *
16  * 2. Redistributions in binary form must reproduce the above copyright notice,
17  * this list of conditions and the following disclaimer in the documentation
18  * and/or other materials provided with the distribution.
19  *
20  * 3. Neither the name of Zivid AS nor the names of its contributors may be used
21  * to endorse or promote products derived from this software without specific
22  * prior written permission.
23  *
24  * 4. This software, with or without modification, must not be used with any
25  * other 3D camera than from Zivid AS.
26  *
27  * 5. Any software provided in binary form under this license must not be
28  * reverse engineered, decompiled, modified and/or disassembled.
29  *
30  * THIS SOFTWARE IS PROVIDED BY ZIVID AS "AS IS" AND ANY EXPRESS OR IMPLIED
31  * WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
32  * MERCHANTABILITY, NONINFRINGEMENT, AND FITNESS FOR A PARTICULAR PURPOSE ARE
33  * DISCLAIMED. IN NO EVENT SHALL ZIVID AS OR CONTRIBUTORS BE LIABLE FOR ANY
34  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
35  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
36  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
37  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
38  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
39  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
40  *
41  * Contact: Zivid Customer Success Team <customersuccess@zivid.com>
42  * Info: http://www.zivid.com
43  ******************************************************************************/
44 
45 #pragma once
46 
49 
50 #include <cmath>
51 #include <ostream>
52 #include <string>
53 #include <type_traits>
54 
55 namespace Zivid
56 {
60  struct PointXYZ
61  {
63  PointXYZ() = default;
64 
66  PointXYZ(float xCoord, float yCoord, float zCoord)
67  : x{ xCoord }
68  , y{ yCoord }
69  , z{ zCoord }
70  {}
71 
74  bool isNaN() const
75  {
76  return std::isnan(z);
77  }
78 
80  ZIVID_CORE_EXPORT std::string toString() const;
81 
83  float x;
84 
86  float y;
87 
89  float z;
90  };
91 
93  ZIVID_CORE_EXPORT std::ostream &operator<<(std::ostream &stream, const PointXYZ &point);
94 
96 
105  struct PointXYZW
106  {
108  PointXYZW() = default;
109 
111  PointXYZW(float xCoord, float yCoord, float zCoord, float wCoord)
112  : x{ xCoord }
113  , y{ yCoord }
114  , z{ zCoord }
115  , w{ wCoord }
116  {}
117 
120  bool isNaN() const
121  {
122  return std::isnan(z);
123  }
124 
126  ZIVID_CORE_EXPORT std::string toString() const;
127 
129  float x;
130 
132  float y;
133 
135  float z;
136 
138  float w;
139  };
140 
142  ZIVID_CORE_EXPORT std::ostream &operator<<(std::ostream &stream, const PointXYZW &point);
143 
145 
149  struct PointZ
150  {
152  PointZ() = default;
153 
155  PointZ(float zCoord)
156  : z{ zCoord }
157  {}
158 
160  bool isNaN() const
161  {
162  return std::isnan(z);
163  }
164 
166  ZIVID_CORE_EXPORT std::string toString() const;
167 
169  float z;
170  };
171 
173  ZIVID_CORE_EXPORT std::ostream &operator<<(std::ostream &stream, const PointZ &point);
174 
176 
177 } // namespace Zivid
#define ZIVID_CORE_EXPORT
Definition: CoreExport.h:57
The main Zivid namespace. All Zivid code is found here
Definition: Application.h:55
std::ostream & operator<<(std::ostream &stream, const Array2D< T > &array)
Serialize array information to a stream
Definition: Array2D.h:170
ZIVID_STATIC_ASSERT_DATA_FORMAT_TYPE(ColorRGBA, 4)
Point with four coordinates as float
Definition: Point.h:106
bool isNaN() const
Check if the point is Not-a-Number (invalid)
Definition: Point.h:120
PointXYZW(float xCoord, float yCoord, float zCoord, float wCoord)
Constructor
Definition: Point.h:111
float x
The x element of the point
Definition: Point.h:129
ZIVID_CORE_EXPORT std::string toString() const
Get string representation
PointXYZW()=default
Constructor
float y
The y element of the point
Definition: Point.h:132
float z
The z element of the point
Definition: Point.h:135
float w
The w element of the point
Definition: Point.h:138
Point with three coordinates as float
Definition: Point.h:61
PointXYZ()=default
Constructor
float y
The y element of the point
Definition: Point.h:86
bool isNaN() const
Check if the point is Not-a-Number (invalid)
Definition: Point.h:74
PointXYZ(float xCoord, float yCoord, float zCoord)
Constructor
Definition: Point.h:66
float z
The z element of the point
Definition: Point.h:89
float x
The x element of the point
Definition: Point.h:83
ZIVID_CORE_EXPORT std::string toString() const
Get string representation
Point with Z coordinate
Definition: Point.h:150
float z
The z element of the point
Definition: Point.h:169
PointZ()=default
Constructor
PointZ(float zCoord)
Constructor
Definition: Point.h:155
bool isNaN() const
Check if the point is Not-a-Number (invalid)
Definition: Point.h:160
ZIVID_CORE_EXPORT std::string toString() const
Get string representation