https://github.com/ihmcrobotics/zed-java-api
Use Stereolabs sensors such as ZED 2, ZED 2i, ZED X, ZED Mini, ZED X Mini from Java.
https://github.com/ihmcrobotics/zed-java-api
java javacv opencv perception stereolabs zed-camera zed2 zedsdk
Last synced: 3 months ago
JSON representation
Use Stereolabs sensors such as ZED 2, ZED 2i, ZED X, ZED Mini, ZED X Mini from Java.
- Host: GitHub
- URL: https://github.com/ihmcrobotics/zed-java-api
- Owner: ihmcrobotics
- License: apache-2.0
- Created: 2024-05-29T16:36:09.000Z (over 1 year ago)
- Default Branch: develop
- Last Pushed: 2025-10-21T16:27:05.000Z (3 months ago)
- Last Synced: 2025-10-21T17:40:27.621Z (3 months ago)
- Topics: java, javacv, opencv, perception, stereolabs, zed-camera, zed2, zedsdk
- Language: Java
- Homepage:
- Size: 3.11 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# zed-java-api
zed-java-api provides Java JNI bindings for ZED SDK. The bindings are based on [zed-c-api](https://github.com/stereolabs/zed-c-api).
Currently compatible with ZED SDK **5.0.x**.
Allows you to use Stereolabs sensors such as ZED 2, ZED 2i, ZED X, ZED Mini, ZED X Mini from Java.
## Usage
zed-java-api requires ZED SDK to be installed on the system. Download ZED SDK for your system from [here](https://www.stereolabs.com/developers/release). You do not need to install zed-c-api, just ZED SDK.
Supported platforms:
- Linux (Ubuntu 20.04+ or similar x86_64)
- Linux, NVIDIA Jetson (L4T R35.3+ arm64)
- Windows (Windows 10+ x86_64)
Requires Java 17.
### Gradle
```
repositories {
[...]
maven {
url = uri("https://robotlabfiles.ihmc.us/repository/")
}
}
dependencies {
implementation("us.ihmc:zed-java-api:5.0.0_2")
}
```
### Maven
```
ihmc-repo
https://robotlabfiles.ihmc.us/repository/
us.ihmc
zed-java-api
5.0.0_2
```
### Setup
You must manually load the library first before using it.
```
ZEDJavaAPINativeLibrary.load();
```
After the native JNI library is loaded, programming using zed-java-api is nearly identical to zed-c-api.
### Tools
#### ZEDTools.errorName(int zedErrorCode)
Retrieve the error name associated with an error code
#### ZEDTools.errorMessage(int zedErrorCode)
Retrieve a formatted error message from an error code
#### ZEDTools.throwOnError(int zedErrorCode)
Throw a ZEDException if an error code is not SL_ERROR_CODE_SUCCESS
### OpenCV Demo
A basic demo to display the images read from the camera is located in [DemoImageCaptureOpenCV.java](https://github.com/ihmcrobotics/zed-java-api/blob/develop/src/test/java/us/ihmc/zed/test/DemoImageCaptureOpenCV.java).
