Skip to content

Commit

Permalink
Update README.md
Browse files Browse the repository at this point in the history
  • Loading branch information
Matevz Morato committed Jun 21, 2024
1 parent 4374719 commit e48e5c6
Show file tree
Hide file tree
Showing 2 changed files with 32 additions and 22 deletions.
37 changes: 15 additions & 22 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,19 +4,24 @@
[![Docs](https://img.shields.io/badge/Docs-DepthAI_API-yellow)](https://docs.luxonis.com/projects/api)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

Core C++ library
Core depthai library for interfacing with Luxonis DepthAI hardware.

> ⚠️ This is a `v3_develop` branch of library which is still in active development without a stable API yet.
## Documentation

## Documentation
Documentation is available over at [Luxonis DepthAI API](https://docs.luxonis.com/projects/api/en/latest/)

## Disclaimer
DepthAI library doesn't yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking. We expect to provide API stability from version 3.0.0 onwards.
DepthAI library doesn't yet provide API stability guarantees. While we take care to properly deprecate old functions, some changes might still be breaking.

## Examples
Examples for both C++ and Python are available in the `examples` folder. To get started with them see [README.md](./examples/README.md) for more information.

## Dependencies
- CMake >= 3.14
- C/C++14 compiler
- [optional] OpenCV 4 (required if building examples)
- C/C++17 compiler
- [optional] OpenCV 4 (required if building examples and for record and replay)
- [optional] PCL (required for point cloud example)

To install OpenCV:
Expand All @@ -27,6 +32,9 @@ To install PCL:
MacOS: `brew install pcl`
Linux: `sudo apt install libpcl-dev`

## Python specific information
For more specific information about Python bindings, see [Python README](./bindings/python/README.md).

## Building

Make sure submodules are updated
Expand Down Expand Up @@ -76,23 +84,6 @@ cmake -S. -Bbuild -DCMAKE_TOOLCHAIN_FILE=$NDK/build/cmake/android.toolchain.cmak
cmake --build build
```


## Running examples

To build the examples configure with following option added
```
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
```

Then navigate to `build/examples` folder and run a preferred example
```
cd build/examples
./MobileNet/rgb_mobilenet
```

> ℹ️ Multi-Config generators (like Visual Studio on Windows) will have the examples built in `build/examples/MobileNet/[Debug/Release/...]/rgb_mobilenet`
## Integration

Under releases you may find prebuilt library for Windows, for use in either integration method. See [Releases](https://github.com/luxonis/depthai-core/releases)
Expand Down Expand Up @@ -196,6 +187,8 @@ The following environment variables can be set to alter default behavior of the
| DEPTHAI_CRASHDUMP | Directory in which to save the crash dump. |
| DEPTHAI_CRASHDUMP_TIMEOUT | Specifies the duration in seconds to wait for device reboot when obtaining a crash dump. Crash dump retrieval disabled if 0. |
| DEPTHAI_DISABLE_FEEDBACK | Disables crash dump and pipeline schema collection used to improve the library |


## Running tests

To run the tests build the library with the following options
Expand Down
17 changes: 17 additions & 0 deletions examples/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -129,3 +129,20 @@ with dai.Pipeline() as pipeline:
if cv2.waitKey(1) == ord('q'):
break
```


## Running examples

To build the examples configure with following option added from the root of the repository:
```
cmake -S. -Bbuild -D'DEPTHAI_BUILD_EXAMPLES=ON'
cmake --build build
```

Then navigate to `build/examples` folder and run a preferred example
```
cd build/examples
./MobileNet/rgb_mobilenet
```

> ℹ️ Multi-Config generators (like Visual Studio on Windows) will have the examples built in `build/examples/MobileNet/[Debug/Release/...]/rgb_mobilenet`

0 comments on commit e48e5c6

Please sign in to comment.