Zivid C++ API  2.3.1+1a22cbf1-1
Defining the Future of 3D Machine Vision
Frame.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 
47 #include "Zivid/CameraInfo.h"
48 #include "Zivid/CameraState.h"
50 #include "Zivid/Detail/Pimpl.h"
51 #include "Zivid/FrameInfo.h"
52 #include "Zivid/PointCloud.h"
53 #include "Zivid/Settings.h"
54 
55 #include <memory>
56 
57 namespace Zivid
58 {
65  class Frame
66  {
67  ZIVID_PIMPL_REFERENCE_SEMANTICS(Frame, ZIVID_CORE_EXPORT);
68 
69  public:
72 
74  ZIVID_CORE_EXPORT explicit Frame(const std::string &fileName);
75 
78 
81 
84 
87 
90 
95  ZIVID_CORE_EXPORT void save(const std::string &fileName) const;
96 
98  ZIVID_CORE_EXPORT void load(const std::string &fileName);
99 
102  ZIVID_CORE_EXPORT std::string toString() const;
103  };
104 } // namespace Zivid
#define ZIVID_CORE_EXPORT
Definition: CoreExport.h:57
Information about camera model, serial number etc.
Definition: CameraInfo.h:76
Information about camera connection state, temperatures, etc.
Definition: CameraState.h:76
Various information for a frame
Definition: FrameInfo.h:76
A frame captured by a Zivid camera
Definition: Frame.h:66
ZIVID_CORE_EXPORT Frame(const std::string &fileName)
Creates a frame by loading data from a file
ZIVID_CORE_EXPORT FrameInfo info() const
Get information collected at the time of the frame capture
ZIVID_CORE_EXPORT PointCloud pointCloud() const
Get the point cloud
ZIVID_CORE_EXPORT std::string toString() const
Get string representation of the frame
ZIVID_CORE_EXPORT Settings settings() const
Get the settings used to capture this frame
ZIVID_CORE_EXPORT void save(const std::string &fileName) const
Save the frame to file
ZIVID_CORE_EXPORT CameraState state() const
Get the camera state data at the time of the frame capture
ZIVID_CORE_EXPORT Frame()
Construct a new frame
ZIVID_CORE_EXPORT void load(const std::string &fileName)
Load a frame from a Zivid data file
ZIVID_CORE_EXPORT CameraInfo cameraInfo() const
Get information about the camera used to capture the frame
Point cloud with x, y, z, RGB color and SNR laid out on a 2D grid
Definition: PointCloud.h:70
Settings used when capturing with a Zivid camera
Definition: Settings.h:76
The main Zivid namespace. All Zivid code is found here
Definition: Application.h:55