Zivid C++ API  1.8.1+6967bc1b-1
Defining the Future of 3D Machine Vision
DeviceCloud.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-2020 (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 Support <support@zivid.com>
42  * Info: http://www.zivid.com
43  ******************************************************************************/
44 
45 #pragma once
46 
47 #include "Zivid/APIExport.h"
48 #include "Zivid/ComputeDevice.h"
49 #include "Zivid/PointCloud.h"
50 
51 #include <chrono>
52 #include <memory>
53 #include <utility>
54 
55 namespace Zivid
56 {
57  class DeviceCloudImpl;
58  class DeviceCloud;
59  class PointCloud;
60 
62  class DeviceCloud
63  {
64  public:
67 
69  ZIVID_API_EXPORT explicit DeviceCloud(const PointCloud &cloud);
70 
72  ZIVID_API_EXPORT explicit DeviceCloud(const PointCloud &cloud, ComputeDevice device);
73 
75  ZIVID_API_EXPORT bool isEmpty() const;
76 
79 
81  ZIVID_API_EXPORT PointCloud copyToCPU() const;
82 
88  ZIVID_API_EXPORT void lock();
89 
91  ZIVID_API_EXPORT size_t rows() const;
92 
94  ZIVID_API_EXPORT size_t cols() const;
95 
97  ZIVID_API_EXPORT void unlock();
98 
100  ZIVID_API_EXPORT bool tryLock();
101 
103  ZIVID_API_EXPORT bool tryLockFor(const std::chrono::milliseconds &duration);
104 
105 #ifndef NO_DOC
106  ZIVID_API_EXPORT DeviceCloudImpl &getImpl();
107  ZIVID_API_EXPORT const DeviceCloudImpl &getImpl() const;
108  ZIVID_API_EXPORT explicit DeviceCloud(std::shared_ptr<DeviceCloudImpl> other);
109 #endif
110 
111  private:
112  std::shared_ptr<DeviceCloudImpl> m_impl;
113  };
114 } // namespace Zivid
Zivid::DeviceCloud::tryLockFor
ZIVID_API_EXPORT bool tryLockFor(const std::chrono::milliseconds &duration)
Check if a lock can be obtained for the point cloud (with a specified timeout)
Zivid::DeviceCloud::DeviceCloud
ZIVID_API_EXPORT DeviceCloud()
Create an empty device cloud
Zivid::DeviceCloud::lock
ZIVID_API_EXPORT void lock()
Lock the point cloud
Zivid::DeviceCloud::copyToCPU
ZIVID_API_EXPORT PointCloud copyToCPU() const
Copy to the device cloud to a CPU point cloud
Zivid::DeviceCloud::unlock
ZIVID_API_EXPORT void unlock()
Unlock the point cloud
Zivid::DeviceCloud::clone
ZIVID_API_EXPORT DeviceCloud clone() const
Clone the device cloud
ComputeDevice.h
Zivid::DeviceCloud::cols
ZIVID_API_EXPORT size_t cols() const
Get number of columns in point cloud
Zivid::DeviceCloud::tryLock
ZIVID_API_EXPORT bool tryLock()
Check if a lock can be obtained for the point cloud
Zivid::DeviceCloud::rows
ZIVID_API_EXPORT size_t rows() const
Get number of rows in point cloud
APIExport.h
PointCloud.h
Zivid
The main Zivid namespace. All Zivid code is found here
Definition: Application.h:52
ZIVID_API_EXPORT
#define ZIVID_API_EXPORT
Definition: APIExport.h:56
Zivid::DeviceCloud::isEmpty
ZIVID_API_EXPORT bool isEmpty() const
Check if the device cloud is empty