Skip to content

Commit

Permalink
update orbbecviewer doc
Browse files Browse the repository at this point in the history
  • Loading branch information
zhonghong322 committed Jan 23, 2024
1 parent 14cb923 commit 6ec8169
Showing 1 changed file with 25 additions and 25 deletions.
50 changes: 25 additions & 25 deletions doc/OrbbecViewer/English/OrbbecViewer.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,19 +24,19 @@ As shown in the figure, the main interface is marked with three areas separated
| Area 2 | Control panel area | Data stream switch and parameter configuration, image acquisition function control, D2C function control |
| Area 3 | Image preview area | Sensor image preview, frame rate, timestamp and other information viewing |

![1](.\images\image1.png)
![1](images/image1.png)

Among them, there are six buttons on the left side of the control panel area, the bottom button.


![2](.\images\image2.png) Used to switch between Chinese and English;![3](.\images\image3.png) Used to open the software details page.
![2](images/image2.png) Used to switch between Chinese and English;![3](images/image3.png) Used to open the software details page.

![4](.\images\image4.png) Used to view device information and firmware upgrade; the remaining two buttons are used to switch the control panel TAB pages of different functions, from top to bottom, it is "Single Camera Mode" and "Advanced Mode".
![4](images/image4.png) Used to view device information and firmware upgrade; the remaining two buttons are used to switch the control panel TAB pages of different functions, from top to bottom, it is "Single Camera Mode" and "Advanced Mode".

Click the Log information at the bottom of area 3, and the specific log information will be displayed.

## 3.2 Data stream
OrbbecViewer allows the user to select and configure depth, infrared and color data streams. This section outlines the parameters that the user can customize in the tool. After the user completes the configuration, they must click the top ![5](.\images\image5.png)button to start data streaming.
OrbbecViewer allows the user to select and configure depth, infrared and color data streams. This section outlines the parameters that the user can customize in the tool. After the user completes the configuration, they must click the top ![5](images/image5.png)button to start data streaming.

The OrbbecViewer tool allows the user to select a combination of depth, infrared and color data streams. User can enable/disable the stream by checking/unchecking from the list of available streams. The viewer supports both USB2.0 and USB3.0, so the available configuration parameters will vary depending on the USB2.0/USB3.0 capabilities.

Expand All @@ -47,33 +47,33 @@ The cameras provide users with a choice of resolutions to suit their solution ne
For example, depth stream can support 320x240, 640x480, 640x400, 1280x800, 320x288, 640x576, 1024x1024, 512x512 and other resolutions,
and the range of FPS frame rate is 5 to 30, different devices support different resolutions, image formats, and frame rates, please refer to the product manual.

![8](.\images\image8.png)
![8](images/image8.png)

The color stream can support multiple resolutions from 640x480 to 3840x2160, the range of FPS frame rate ranges from 5 to 30, and supports MJPG, RGB, I420, and H265.

For the preview of the color stream, MJPG, H264, and H265 are the encoding formats, which need to be decoded first. The decoding usually takes a lot of time, resulting in dropped frames or rendering a "corrupted" picture. On some models of PC, hardware-accelerated decoding is available.

![7](.\images\image7.png)
![7](images/image7.png)

The infrared stream can support 320x240、640x480、640x400、1280x800、640x576、512x512、1024x1024 and other resolutions, and the FPS frame rate ranges from 5 to 30. different devices support different resolutions, image formats, and frame rates, please refer to the product manual<br />
![9](.\images\image9.png)
![9](images/image9.png)

Users can choose the most suitable resolution according to the actual situation. Note that higher resolutions are more accurate, but increase computational intensity.

## 3.3 Device Information
Click the button“ ![10](.\images\image10.png) ”to view device information.
Click the button“ ![10](images/image10.png) ”to view device information.
The OrbbecViewer tool contains simple device information such as firmware version, product identification code, camera parameters, temperature, etc.

![11](.\images\image11.png)
![11](images/image11.png)

## 3.4 Image preview area
Open stream will display the average frame rate, time frame, image frame number and other information by default, click on the upper right corner ![12](.\images\image12.png) to toggle information display\close.
Click ![13](.\images\image13.png) , the stream can be paused without being removed from the preview area.
Click ![14](.\images\image14.png) , streams that have been paused and not removed from the preview area can be reopened.
Open stream will display the average frame rate, time frame, image frame number and other information by default, click on the upper right corner ![12](images/image12.png) to toggle information display\close.
Click ![13](images/image13.png) , the stream can be paused without being removed from the preview area.
Click ![14](images/image14.png) , streams that have been paused and not removed from the preview area can be reopened.

After the data stream is closed, the image preview window will not be closed, and the user needs to click ![15](.\images\image15.png) the upper right corner of the image preview window.
After the data stream is closed, the image preview window will not be closed, and the user needs to click ![15](images/image15.png) the upper right corner of the image preview window.

![16](.\images\image16.png)
![16](images/image16.png)

## 3.5 Control Panel Area
### Sensors and Data Stream
Expand All @@ -82,33 +82,33 @@ After the device is powered on and the USB is connected to the PC host, open the

After the connection is successful, the control panel area automatically displays the specific information of the device.

![18](.\images\image18.png)
![18](images/image18.png)

#### Depth stream module
Including: mirroring, software filtering , depth effective range acquisition (MinDepthValue/MaxDepthValue), exposure and other functions.

![19](.\images\image19.png)
![19](images/image19.png)

#### Color stream module
Including: Mirror, Flip, Align, Exposure, White Balance, Gain, Brightness, Sharpness, Saturation, Contrast, Hue and other functions.

![20](.\images\image20.png)
![20](images/image20.png)

#### Infrared stream module
Including mirroring and exposure functions.

![21](.\images\image21.png)
![21](images/image21.png)

#### IMU
Including Imu param.

![21-1](.\images\image211.png)
![21-1](images/image211.png)


#### **Device data management**
Users can select corresponding images and captured frames for recording, and the captured frames are saved in the "OrbbecViewer/output" directory by default.

![22](.\images\image22.png)
![22](images/image22.png)

## 3.6 D2C and Point Cloud (support hardware D2C and software D2C)
In advanced mode, both D2C and point clouds are supported.
Expand All @@ -126,22 +126,22 @@ In advanced mode, both D2C and point clouds are supported.
![image23](images/image23.png)

## 3.7 **Firmware update**
When the device is connected, click![30](.\images\image30.png)Access the firmware update page.
When the device is connected, click![30](images/image30.png)Access the firmware update page.

* Femto device firmware includes system firmware and onboard MCU firmware. You can select the upgrade firmware type in the "Type" drop-down box.
* After selecting the firmware type, enter the existing updated firmware image file in the “Firmware” input box, and click the “Upgrade” button to start the update.
* The device firmware update adopts the A/B dual partition scheme. If the update fails unexpectedly, it will not affect the operation of the original firmware, just reconnect the device to update. The device update time is relatively long, and the device will automatically restart once, please pay attention to the prompt information and wait patiently.
* Astra+、gemini2、Gemini2 L、Astra2、Dabai、Dabai DCW、Dabai DW、Astra Mini Pro、Astra Pro Plus、Gemini、GeminiE、GeminiE Lite Upgrade interface:

![31](.\images\image31.png)
![31](images/image31.png)

* Femto、Femto W interface:

![32](.\images\image32.png)
![32](images/image32.png)

* Femto Mega firmware upgrade does not support Windows upgrade, you need to call OrbbecViewer with administrator privileges under linux.

## 3.8 **Log Information**
By default, the log information area is displayed in a single-folded state. By clicking the button on the far right.![33](.\images\image33.png)Expand to view full log information. By clicking the button![34](.\images\image34.png)will empty the log. By clicking the button![35](.\images\image35.png)restores the collapsed single bar display state.
![36](.\images\image36.png)
By default, the log information area is displayed in a single-folded state. By clicking the button on the far right.![33](images/image33.png)Expand to view full log information. By clicking the button![34](images/image34.png)will empty the log. By clicking the button![35](images/image35.png)restores the collapsed single bar display state.
![36](images/image36.png)

0 comments on commit 6ec8169

Please sign in to comment.