i/OrbbecSDK_ROS2
1
0
Fork 0
mirror of https://github.com/orbbec/OrbbecSDK_ROS2.git synced 2026-10-04 12:07:46 +08:00
Code Issues Packages Projects Releases Wiki Activity

Refactor predefined presets documentation for clarity and completeness

Browse Source
This commit is contained in:
ob-yalian
2026-01-19 15:21:14 +08:00
parent 31f72f27c4
commit a29d2eddf8
2 changed files with 125 additions and 20 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/en/source/camera_devices/5_advanced_guide/configuration/predefined_presets.md
+61 -11
View File
@@ -1,15 +1,65 @@
# Predefined presets
#Device default
| Preset | Features | Recommended use cases |
| -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Default | - Best visual perception``- Overall good performance in accuracy, fill rate, tiny objects, etc. | - Generic `<br>`- Robotics |
| Hand | - Clear hand and finger edges | - Gesture recognition |
| High Accuracy | - Depth of high confidence `<br>`- Barely noise depth values `<br>`- Lower fill rate | - Collision avoidance `<br>`- Object scanning |
| High Density | - Higher fill rate `<br>`- More tiny objects `<br>`- May suffer from noise depth values | - Object recognition `<br>`- Pick & place `<br>`- Foreground & background animation |
| Medium Density | - Balanced performance in fill rate and accuracy `<br>`- In comparison to Default: lower fill rate, better edge quality | - Generic and alternative to Default |
| Custom | - User defined Preset `<br>`- Derived from Presets above, with customized modifications `<br>`- e.g. a new configuration for the post-processing pipeline, etc. | - Better depth performance achieved using customized configurations in comparison to using predefined presets `<br>`- For well-established custom configurations |
This document lists available presets, features, and recommended scenarios by product. Please select a preset name that matches the product model and set it as the value of the `device_preset` parameter.
Choose the appropriate preset name based on your specific use case and set it as the value for the `device_preset`
parameter.
## Gemini 330 / Gemini 330L / Gemini 335 / Gemini 335L
| Defaults | Features | Recommended usage scenarios |
| --- | --- | --- |
| Default | Best visual effect<br> Overall performance is good, including typical indicators such as accuracy, filling rate, small object detection capability | General scenarios<br> Robot application |
| Hand | Clear hand and finger edges | Gesture recognition |
| High Accuracy | Highly reliable depth information<br> Very little depth noise<br> Relatively low depth fill rate | Obstacle avoidance<br> Object scanning |
| High Density | Higher depth filling rate<br> Can detect more small objects<br> More susceptible to depth noise | Object recognition<br> Grabbing<br> Foreground or background processing, such as cutout, etc. |
| Medium Density | Balanced depth fill rate and precision performance<br> Compared with default settings: relatively low fill rate, better edge quality | Universal scene, alternative to Default |
| Custom | Custom modifications, such as new configurations of post-processing pipelines, modifications to depth AE functions | By adjusting the depth configuration yourself, you can achieve better results than the predefined depth preset configuration<br> Fully proven customized depth configuration |
## Gemini 336 / Gemini 336L
| Defaults | Features |
| --- | --- |
| Default | The best visual effect<br> The overall performance is good, including typical indicators such as accuracy, filling rate, and small object detection capabilities |
| High Accuracy | Highly reliable depth information<br> Very little depth noise<br> Relatively low depth fill rate |
| Custom | Custom modifications, such as new configurations of post-processing pipelines and modifications to deep AE functions |
## Gemini 2
| Defaults | Features |
| --- | --- |
| Unbinned Dense Default | Depth Quality Priority |
| Binned Sparse Default | Small dead zone, low power consumption, high frame rate |
| Obstacle Avoidance | Robot obstacle avoidance mode |
## Gemini 2L
| Defaults | Features |
| --- | --- |
| Unbinned Dense Default | Depth Quality Priority |
| Dimensioning | Measurement accuracy is priority |
| Binned Sparse Default | Small dead zone, low power consumption, high frame rate |
| Unbinned Sparse Default | Balance quality and power consumption, improve low-reflection and semi-outdoor effects |
## Gemini 305
| Defaults | Features |
| --- | --- |
| Default | Best visual perception<br> Good overall performance in terms of accuracy, filling rate, small objects, etc. |
| High Accuracy | High confidence depth values<br> Virtually noiseless depth values<br> Low fill rate |
| Close Range High Accuracy | Adjustable larger parallax search range, Mini-Z reduction<br> The rest of the performance remains consistent with High Accuracy |
| Dual Color Streams | Supports left and right color streams at the same time, no depth IR information<br> The left and right output effects are consistent |
| Custom | Custom modifications, such as new configurations of post-processing pipelines and modifications to deep AE functions |
> Since the parameter configuration of `Dual Color Streams` mode is quite different from that of `Default` mode, we provide the corresponding YAML configuration file.
Please set `config_file_path` to `gemini305_dual_color.yaml`, the configuration file is located in the config directory.
## Extended presets
### G33X Close Range High Accuracy (Gemini 330 / Gemini 335 / Gemini 336)
| Defaults | Features | Recommended usage scenarios |
| --- | --- | --- |
| G33X Close Range High Accuracy | For the selected depth resolution, the depth value at the closest working distance will be reduced by 50%<br> The new closest working distance is 0.13m when close application is enabled<br> Supported depth resolutions: 1280x800/1280x720/640x400/424x266 only | Eye in hand and close range operation tasks<br> Close range measurement |
### G336X AMR Default (Gemini 336 / Gemini 336L)
| Defaults | Features | Recommended usage scenarios |
| --- | --- | --- |
| G336X AMR Default | Optimized for reliable depth performance in sunlit and repetitively textured warehouse scenes<br> Recommended depth resolutions: 1280x800 / 640x400 / 424x266 | Warehouse AMRs |