Skip to content

Commit 65b3d8e

Browse files
committed
Fix documentation for name changing
1 parent b01c3ee commit 65b3d8e

File tree

12 files changed

+73
-60
lines changed

12 files changed

+73
-60
lines changed

CMakeLists.txt

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -25,9 +25,9 @@ endif()
2525

2626
############################################################################
2727
# Options
28-
option(BUILD_VIDEO "Build the ZED Driver Video Modules (only for Linux)" ON)
29-
option(BUILD_SENSORS "Build the ZED Driver Sensors Modules" ON)
30-
option(BUILD_EXAMPLES "Build the ZED Driver examples" ON)
28+
option(BUILD_VIDEO "Build the ZED Open Capture Video Modules (only for Linux)" ON)
29+
option(BUILD_SENSORS "Build the ZED Open Capture Sensors Modules" ON)
30+
option(BUILD_EXAMPLES "Build the ZED Open Capture examples" ON)
3131

3232
############################################################################
3333
# Sources
@@ -113,7 +113,7 @@ set_target_properties(${PROJECT_NAME} PROPERTIES
113113
)
114114
install(TARGETS ${PROJECT_NAME}
115115
LIBRARY DESTINATION ${CMAKE_INSTALL_PREFIX}/lib
116-
PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_PREFIX}/include/zed-driver)
116+
PUBLIC_HEADER DESTINATION ${CMAKE_INSTALL_PREFIX}/include/zed-open-capture)
117117

118118

119119
############################################################################

doc/api_doc/DoxygenLayout.xml

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -18,8 +18,8 @@
1818
<tab type="user" url="md_installation.html" visible="yes" title="Installation"/>
1919

2020
<tab type="usergroup" url="md_modules.html" visible="yes" title="Modules">
21-
<tab type="user" url="classsl__drv_1_1VideoCapture.html" visible="yes" title="Video Capture and Control"/>
22-
<tab type="user" url="classsl__drv_1_1SensorCapture.html" visible="yes" title="Sensors Data Capture"/>
21+
<tab type="user" url="classsl__oc_1_1VideoCapture.html" visible="yes" title="Video Capture and Control"/>
22+
<tab type="user" url="classsl__oc_1_1SensorCapture.html" visible="yes" title="Sensors Data Capture"/>
2323
</tab>
2424

2525
<tab type="modules" visible="no" title="" intro=""/>
@@ -34,9 +34,10 @@
3434
<tab type="pages" visible="no" title="" intro=""/>
3535

3636
<tab type="usergroup" url="md_examples.html" visible="yes" title="Examples">
37-
<tab type="user" url="zed_drv_video_example_8cpp-example.html" visible="yes" title="Video Capture and Control" />
38-
<tab type="user" url="zed_drv_sensors_example_8cpp-example.html" visible="yes" title="Sensors Data Capture" />
39-
<tab type="user" url="zed_drv_sync_example_8cpp-example.html" visible="yes" title="Video/Sensors sync" />
37+
<tab type="user" url="zed_oc_video_example_8cpp-example.html" visible="yes" title="Video Capture and Control" />
38+
<tab type="user" url="zed_oc_rectify_example_8cpp-example.html" visible="yes" title="Video Rectification" />
39+
<tab type="user" url="zed_oc_sensors_example_8cpp-example.html" visible="yes" title="Sensors Data Capture" />
40+
<tab type="user" url="zed_oc_sync_example_8cpp-example.html" visible="yes" title="Video/Sensors sync" />
4041
</tab>
4142

4243
<tab type="user" url="md_release-notes.html" visible="yes" title="Release Notes"/>

doc/api_doc/add-on.txt

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -12,8 +12,8 @@ A synchronization mechanism is provided to get the correct sensor data associate
1212
<h2 style="text-align: left;">Modules</h2>
1313
The library is composed of two modules:
1414

15-
- <a href="group__Video__group.html">Video Capture</a>: video frame grabbing and camera control
16-
- <a href="group__Depth__group.html">Sensor Capture</a>: camera sensors data grabbing
15+
- <a href="classsl__oc_1_1VideoCapture.html">Video Capture</a>: video frame grabbing and camera control
16+
- <a href="classsl__oc_1_1SensorCapture.html">Sensor Capture</a>: camera sensors data grabbing
1717

1818
<br>
1919

doc/api_doc/doxyfile

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -476,15 +476,15 @@ EXTRACT_ANON_NSPACES = NO
476476
# section is generated. This option has no effect if EXTRACT_ALL is enabled.
477477
# The default value is: NO.
478478

479-
HIDE_UNDOC_MEMBERS = YES
479+
HIDE_UNDOC_MEMBERS = NO
480480

481481
# If the HIDE_UNDOC_CLASSES tag is set to YES, doxygen will hide all
482482
# undocumented classes that are normally visible in the class hierarchy. If set
483483
# to NO, these classes will be included in the various overviews. This option
484484
# has no effect if EXTRACT_ALL is enabled.
485485
# The default value is: NO.
486486

487-
HIDE_UNDOC_CLASSES = YES
487+
HIDE_UNDOC_CLASSES = NO
488488

489489
# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, doxygen will hide all friend
490490
# (class|struct|union) declarations. If set to NO, these declarations will be
@@ -670,7 +670,7 @@ SHOW_FILES = NO
670670
# Folder Tree View (if specified).
671671
# The default value is: YES.
672672

673-
SHOW_NAMESPACES = NO
673+
SHOW_NAMESPACES = YES
674674

675675
# The FILE_VERSION_FILTER tag can be used to specify a program or script that
676676
# doxygen should invoke to get the current version for each file (typically from
@@ -782,11 +782,11 @@ WARN_LOGFILE =
782782

783783
INPUT = add-on.txt \
784784
release-notes.md \
785-
../../include \
786-
../../src \
787785
examples.md \
788786
modules.md \
789-
installation.md
787+
installation.md \
788+
../../src \
789+
../../include
790790

791791
# This tag can be used to specify the character encoding of the source files
792792
# that doxygen parses. Internally doxygen uses the UTF-8 encoding. Doxygen uses
@@ -2010,7 +2010,7 @@ PERLMOD_MAKEVAR_PREFIX =
20102010
# C-preprocessor directives found in the sources and include files.
20112011
# The default value is: YES.
20122012

2013-
ENABLE_PREPROCESSING = YES
2013+
ENABLE_PREPROCESSING = NO
20142014

20152015
# If the MACRO_EXPANSION tag is set to YES, doxygen will expand all macro names
20162016
# in the source code. If set to NO, only conditional compilation will be
@@ -2019,7 +2019,7 @@ ENABLE_PREPROCESSING = YES
20192019
# The default value is: NO.
20202020
# This tag requires that the tag ENABLE_PREPROCESSING is set to YES.
20212021

2022-
MACRO_EXPANSION = YES
2022+
MACRO_EXPANSION = NO
20232023

20242024
# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES then
20252025
# the macro expansion is limited to the macros specified with the PREDEFINED and

doc/api_doc/examples.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Examples
22

3-
A set of examples is provided to exploit all the features of the ZED Driver:
3+
A set of examples is provided to exploit all the features of the ZED Open Capture library:
44

5-
- [Video Capture and Control](zed_open_capture_video_example_8cpp-example.html): demonstrates how to acquire video stream, convert it to RGB and control the video settings using the keyboard (Requires OpenCV)
6-
- [Sensor Capture](zed_open_capture_sensors_example_8cpp-example.html): demonstrates how to acquire all the sensors data at the maximum frequency available
7-
- [Video/Sensors synchronization](zed_open_capture_sync_example_8cpp-example.html): demonstrates how to synchronize video and sensors data using the timestamps
8-
- [Video Rectification](zed_open_capture_rectify_example_8cpp-example.html): demonstrates how to rectify the video frames getting the calibration parameters from the Stereolabs servers
5+
- [Video Capture and Control](zed_oc_video_example_8cpp-example.html): demonstrates how to acquire video stream, convert it to RGB and control the video settings using the keyboard (Requires OpenCV)
6+
- [Sensor Capture](zed_oc_sensors_example_8cpp-example.html): demonstrates how to acquire all the sensors data at the maximum frequency available
7+
- [Video/Sensors synchronization](zed_oc_sync_example_8cpp-example.html): demonstrates how to synchronize video and sensors data using the timestamps
8+
- [Video Rectification](zed_oc_rectify_example_8cpp-example.html): demonstrates how to rectify the video frames getting the calibration parameters from the Stereolabs servers

doc/api_doc/modules.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,5 +2,5 @@
22

33
The ZED Open Capture library is composed of two main modules:
44

5-
- [Video Capture](classsl__drv_1_1VideoCapture.html): video frame grabbing and camera settings control
6-
- [Sensor Capture](classsl__drv_1_1SensorCapture.html): camera sensors data grabbing
5+
- [Video Capture](classsl__oc_1_1VideoCapture.html): video frame grabbing and camera settings control
6+
- [Sensor Capture](classsl__oc_1_1SensorCapture.html): camera sensors data grabbing

examples/include/calibration.hpp

Lines changed: 9 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -4116,10 +4116,16 @@ bool downloadCalibrationFile(unsigned int serial_number, std::string &calibratio
41164116
std::string cmd;
41174117
cmd = "wget " + url + std::to_string(serial_number) + "' -O " + calibration_file;
41184118
std::cout << cmd << std::endl;
4119-
system(cmd.c_str());
4119+
int res = system(cmd.c_str());
4120+
4121+
if( res == EXIT_FAILURE )
4122+
{
4123+
std::cerr << "Error downloading the calibration file" << std::endl;
4124+
return false;
4125+
}
41204126

41214127
if (!checkFile(calibration_file)) {
4122-
std::cout << "Invalid calibration file" << std::endl;
4128+
std::cerr << "Invalid calibration file" << std::endl;
41234129
return false;
41244130
}
41254131
}
@@ -4155,6 +4161,7 @@ bool downloadCalibrationFile(unsigned int serial_number, std::string &calibratio
41554161
}
41564162
}
41574163
#endif
4164+
41584165
return true;
41594166
}
41604167

@@ -4175,7 +4182,6 @@ bool initCalibration(std::string calibration_file, cv::Size2i image_size, cv::Ma
41754182
return 0;
41764183

41774184
std::string resolution_str;
4178-
bool check_data = true;
41794185
switch ((int) image_size.width) {
41804186
case 2208:
41814187
resolution_str = "2k";
@@ -4191,7 +4197,6 @@ bool initCalibration(std::string calibration_file, cv::Size2i image_size, cv::Ma
41914197
break;
41924198
default:
41934199
resolution_str = "hd";
4194-
check_data = false;
41954200
break;
41964201
}
41974202

include/defines.hpp

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -30,24 +30,24 @@
3030
#include <chrono>
3131

3232
#if defined _WIN32
33-
#if defined(SL_SDK_COMPIL)
34-
#define SL_SDK_EXPORT __declspec(dllexport)
33+
#if defined(SL_OC_COMPIL)
34+
#define SL_OC_EXPORT __declspec(dllexport)
3535
#else
36-
#define SL_SDK_EXPORT __declspec(dllimport)
36+
#define SL_OC_EXPORT __declspec(dllimport)
3737
#endif
3838
#elif __GNUC__
39-
#define SL_DRV_EXPORT __attribute__((visibility("default")))
39+
#define SL_OC_EXPORT __attribute__((visibility("default")))
4040
#if defined(__arm__) || defined(__aarch64__)
4141
#define _SL_JETSON_
4242
#endif
4343
#endif
4444

4545
//// SDK VERSION NUMBER
46-
#define ZED_DRV_MAJOR_VERSION 0
47-
#define ZED_DRV_MINOR_VERSION 1
48-
#define ZED_DRV_PATCH_VERSION 0
46+
#define ZED_OC_MAJOR_VERSION 0
47+
#define ZED_OC_MINOR_VERSION 1
48+
#define ZED_OC_PATCH_VERSION 0
4949

50-
#define ZED_DRV_VERSION_ATTRIBUTE private: uint32_t mDrvMajorVer = ZED_DRV_MAJOR_VERSION, mDrvMinorVer = ZED_DRV_MINOR_VERSION, mDrvPatchVer = ZED_DRV_PATCH_VERSION
50+
#define ZED_OC_VERSION_ATTRIBUTE private: uint32_t mMajorVer = ZED_OC_MAJOR_VERSION, mMinorVer = ZED_OC_MINOR_VERSION, mPatchVer = ZED_OC_PATCH_VERSION
5151

5252
// Debug output
5353
#define INFO_OUT(lvl,msg) { int status_dem_0; if (lvl>=3) std::cout << "[" << abi::__cxa_demangle(typeid(*this).name(), 0, 0, &status_dem_0) << "] INFO: " << msg << std::endl; }

include/sensorcapture.hpp

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -41,7 +41,7 @@ class VideoCapture;
4141
/*!
4242
* \brief The struct containing the acquired IMU data
4343
*/
44-
struct SL_DRV_EXPORT SensImuData
44+
struct SL_OC_EXPORT SensImuData
4545
{
4646
bool valid = false; //!< Indicates if IMU data are valid
4747
uint64_t timestamp = 0; //!< Timestamp in nanoseconds
@@ -58,7 +58,7 @@ struct SL_DRV_EXPORT SensImuData
5858
/*!
5959
* \brief The struct containing the acquired Magnetometer data
6060
*/
61-
struct SL_DRV_EXPORT SensMagData
61+
struct SL_OC_EXPORT SensMagData
6262
{
6363
// Validity of the magnetometer sensor data
6464
typedef enum _mag_status {
@@ -77,7 +77,7 @@ struct SL_DRV_EXPORT SensMagData
7777
/*!
7878
* \brief The struct containing the acquired Environmental data
7979
*/
80-
struct SL_DRV_EXPORT SensEnvData
80+
struct SL_OC_EXPORT SensEnvData
8181
{
8282
// Validity of the environmental sensor data
8383
typedef enum _env_status {
@@ -96,7 +96,7 @@ struct SL_DRV_EXPORT SensEnvData
9696
/*!
9797
* \brief The struct containing the acquired Environmental data
9898
*/
99-
struct SL_DRV_EXPORT SensCamTempData
99+
struct SL_OC_EXPORT SensCamTempData
100100
{
101101
bool valid = false; //!< Indicates if camera temperature data are valid
102102
uint64_t timestamp = 0; //!< Timestamp in nanoseconds
@@ -107,9 +107,9 @@ struct SL_DRV_EXPORT SensCamTempData
107107
/*!
108108
* \brief The SensorCapture class provides sensor grabbing functions for the Stereolabs ZED Mini and ZED2 camera models
109109
*/
110-
class SL_DRV_EXPORT SensorCapture
110+
class SL_OC_EXPORT SensorCapture
111111
{
112-
ZED_DRV_VERSION_ATTRIBUTE;
112+
ZED_OC_VERSION_ATTRIBUTE;
113113

114114
public:
115115
/*!
@@ -262,16 +262,18 @@ class SL_DRV_EXPORT SensorCapture
262262

263263
};
264264

265-
/** \example zed_drv_sensors_example.cpp
265+
#endif
266+
267+
/** \example zed_oc_sensors_example.cpp
266268
* This is an example of how to use the \ref SensorCapture class to get the raw sensors data at the maximum available
267269
* frequency.
268270
*/
269271

270-
/** \example zed_drv_sync_example.cpp
272+
/** \example zed_oc_sync_example.cpp
271273
* This is an example of how to get synchronized video and sensors data from
272274
* the \ref VideoCapture class and the \ref SensorCapture class.
273275
*/
274276
}
275-
#endif
277+
276278

277279
#endif // SENSORCAPTURE_HPP

include/videocapture.hpp

Lines changed: 10 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ class SensorCapture;
3737
/*!
3838
* \brief The Frame struct containing the acquired video frames
3939
*/
40-
struct SL_DRV_EXPORT Frame
40+
struct SL_OC_EXPORT Frame
4141
{
4242
uint64_t frame_id = 0; //!< Increasing index of frames
4343
uint64_t timestamp = 0; //!< Timestamp in nanoseconds
@@ -50,9 +50,9 @@ struct SL_DRV_EXPORT Frame
5050
/*!
5151
* \brief The VideoCapture class provides image grabbing functions and settings control for all the Stereolabs camera models
5252
*/
53-
class SL_DRV_EXPORT VideoCapture
53+
class SL_OC_EXPORT VideoCapture
5454
{
55-
ZED_DRV_VERSION_ATTRIBUTE;
55+
ZED_OC_VERSION_ATTRIBUTE;
5656

5757
public:
5858
/*!
@@ -411,15 +411,20 @@ class SL_DRV_EXPORT VideoCapture
411411
#endif
412412

413413

414-
/** \example zed_drv_video_example.cpp
414+
/** \example zed_oc_video_example.cpp
415415
* This is an example of how to use the \ref VideoCapture class to get raw video frames and control the camera
416416
* parameters.
417417
*/
418418

419-
/** \example zed_drv_sync_example.cpp
419+
/** \example zed_oc_sync_example.cpp
420420
* This is an example of how to get synchronized video and sensors data from
421421
* the \ref VideoCapture class and the \ref SensorCapture class.
422422
*/
423423

424+
/** \example zed_oc_rectify_example.cpp
425+
* This is an example of how to use the \ref VideoCapture class to get and rectify raw video frames downloading
426+
* calibration parameters from Stereolabs servers
427+
*/
428+
424429
#endif // VIDEOCAPTURE_HPP
425430

0 commit comments

Comments
 (0)