mirror of
https://github.com/orbbec/OrbbecSDK_ROS2.git
synced 2026-10-04 03:57:46 +08:00
docs: enhance launch parameters and services documentation with new filter options and color preset details
This commit is contained in:
@@ -121,7 +121,7 @@
|
||||
* **`color_powerline_freq`**
|
||||
* 设置电源线频率。可能的值为 `disable`、`50hz`、`60hz`、`auto`。
|
||||
* **`color_preset`**
|
||||
* 设置 Gemini 330 系列设备的彩色预设。可选值包括 `Default` 和 `Warm Biased AWB`。
|
||||
* 通过名称设置彩色 preset。Gemini 330 系列和 Gemini 305 系列设备支持。常见可选值包括 `Default`、`Warm Biased AWB`、`Cold Biased AWB`,具体列表以设备返回为准。名称匹配大小写不敏感。
|
||||
* **`color_anti_flicker`**
|
||||
* 启用彩色防闪烁功能。Gemini 330 系列固件 `1.7.13` 及以上支持;Gemini 305 系列固件 `1.0.54` 及以上支持。
|
||||
* **`enable_color_decimation_filter`** / **`color_decimation_filter_scale`**
|
||||
@@ -225,6 +225,15 @@
|
||||
* **`enable_false_positive_filter`**
|
||||
* 启用鬼影滤波。可减少重影噪声。
|
||||
> **支持模组**:DaBaiA / DaBaiAL / Gemini 330 系列 / Gemini345 / Gemini345Lg。
|
||||
* **`enable_edge_noise_removal_filter`**
|
||||
* 启用 EdgeNoiseRemovalFilter,用于减少深度图边缘噪声。
|
||||
> **支持模组**:DaBai Max Pro。
|
||||
* **`enable_disp_outliers_filter`**
|
||||
* 启用 DispOutliersFilter,用于移除深度图中的视差离群点。
|
||||
> **支持模组**:DaBai Max Pro。
|
||||
* **`disp_outliers_filter_search_mode`**
|
||||
* 设置 DispOutliersFilter 的搜索模式。留空表示使用 SDK 默认值。可选值:`FULL`、`OFFSET_80`,大小写不敏感。
|
||||
> **支持模组**:DaBai Max Pro。
|
||||
|
||||
### 视差
|
||||
* **`disparity_to_depth_mode`**
|
||||
|
||||
@@ -248,10 +248,16 @@
|
||||
ros2 service call /camera/set_filter orbbec_camera_msgs/srv/SetFilter '{filter_name: MgcNoiseRemovalFilter, filter_enable: true, filter_param: []}'
|
||||
ros2 service call /camera/set_filter orbbec_camera_msgs/srv/SetFilter '{filter_name: LutNoiseRemovalFilter, filter_enable: true, filter_param: []}'
|
||||
|
||||
# 设置 EdgeNoiseRemovalFilter: []
|
||||
ros2 service call /camera/set_filter orbbec_camera_msgs/srv/SetFilter '{filter_name: EdgeNoiseRemovalFilter, filter_enable: true, filter_param: []}'
|
||||
|
||||
# 使用 filter_config 按参数名调参
|
||||
ros2 service call /camera/set_filter orbbec_camera_msgs/srv/SetFilter "{filter_name: NoiseRemovalFilter, filter_enable: true, filter_config: [{name: min_diff, value: '256'}, {name: max_size, value: '80'}]}"
|
||||
ros2 service call /camera/set_filter orbbec_camera_msgs/srv/SetFilter "{filter_name: HardwareNoiseRemovalFilter, filter_enable: true, filter_config: [{name: threshold, value: '0.2'}]}"
|
||||
ros2 service call /camera/set_filter orbbec_camera_msgs/srv/SetFilter "{filter_name: SpatialAdvancedFilter, filter_enable: true, filter_config: [{name: alpha, value: '0.5'}, {name: disp_diff, value: '160'}, {name: magnitude, value: '1'}, {name: radius, value: '8'}]}"
|
||||
|
||||
# 设置 DispOutliersFilter。search_mode 支持 FULL 或 OFFSET_80,大小写不敏感。
|
||||
ros2 service call /camera/set_filter orbbec_camera_msgs/srv/SetFilter "{filter_name: DispOutliersFilter, filter_enable: true, filter_config: [{name: search_mode, value: 'FULL'}]}"
|
||||
```
|
||||
|
||||
滤波状态会在服务调用后同步更新到 `/camera/depth_filter_status` 和 `/camera/depth_filters/status`。其中 `/camera/depth_filters/status` 使用结构化消息 `orbbec_camera_msgs/msg/DepthFiltersStatus`,包含每个滤波器的使能状态和参数。
|
||||
|
||||
@@ -67,6 +67,8 @@ ros2 launch orbbec_camera gemini2L.launch.py config_file_path:=gemini2L_dual_ir.
|
||||
> 由于 `Dual Color Streams` 模式的参数配置与 `Default` 模式差异较大,我们提供了对应的 YAML 配置文件。
|
||||
请将 `config_file_path` 设置为 `gemini305_dual_color`,该配置文件位于 config 目录下。
|
||||
|
||||
Gemini 305 也支持通过 `color_preset` 参数选择彩色 preset。请按名称设置,例如 `Default`、`Warm Biased AWB`、`Cold Biased AWB`,可用名称以设备返回为准。
|
||||
|
||||
## 扩展预设
|
||||
|
||||
### G33X Close Range High Accuracy(Gemini 330 / Gemini 335 / Gemini 336)
|
||||
@@ -80,4 +82,3 @@ ros2 launch orbbec_camera gemini2L.launch.py config_file_path:=gemini2L_dual_ir.
|
||||
| 预设 | 特点 | 推荐使用场景 |
|
||||
| --- | --- | --- |
|
||||
| G336X AMR Default | 优化其在阳光照射和重复纹理的仓库场景中具有可靠的深度性能<br> 推荐深度分辨率:1280x800 / 640x400 / 424x266 | 仓库AMRs |
|
||||
|
||||
|
||||
@@ -11,4 +11,6 @@ Unless required by applicable law or agreed to in writing, software distributed
|
||||
AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific
|
||||
language governing permissions and limitations under the License.
|
||||
|
||||
Orbbec SDK 随包附带的第三方开源库 License 文件位于 `SDK/licenses`。
|
||||
|
||||
Other names and brands may be claimed as the property of others.
|
||||
|
||||
Reference in New Issue
Block a user