901
edits
Birds Eye View/Calibration Guide: Difference between revisions
→Cameras Transform
| Line 231: | Line 231: | ||
#* The transformed image will be shown in the '''Result View.''' | #* The transformed image will be shown in the '''Result View.''' | ||
#* The thumbnail will show a green check indicating this image already has a transformation. | #* The thumbnail will show a green check indicating this image already has a transformation. | ||
# Adjust any point as needed and click '''Apply''', as many times as you need, until you can see a perfect square in the results View | # Adjust any point as needed and click '''Apply''', as many times as you need, until you can see a perfect square in the results View{{Message|type=note|You can start the process again by clicking on the Delete button in the Main Toolbar to delete the current polygon.}} | ||
#* You can enable/adjust the grid in the Settings Menu to verify the square pattern in the Results View. | |||
# Adjust the scale and offset of the transformed image using the Toolbar Menu controls, '''Scale, X Offset and Y Offset.''' You must hit '''Apply''' to reflect the changes. | # Adjust the scale and offset of the transformed image using the Toolbar Menu controls, '''Scale, X Offset and Y Offset.''' You must hit '''Apply''' to reflect the changes. | ||
#* Information discarded by the scale and offset may not be available in the BEV workspace (depending on the output resolution) | #* Information discarded by the scale and offset may not be available in the BEV workspace (depending on the output resolution) | ||
#* Keeping too much information (zoom out) will make the image uncomfortable to manipulate in the BEV workspace. | #* Keeping too much information (zoom out) will make the image uncomfortable to manipulate in the BEV workspace. | ||
#* Scale and translation can be adjusted at any time. | #* Scale and translation can be adjusted at any time. | ||
{{Message|content=If the original images have lens distortion, you might see curvature in straight lines even after performing the transformation | {{Message|content=If the original images have lens distortion, you might see curvature in straight lines even after performing the transformation|type=note}} | ||
=== Build Birds Eye View === | |||
== Build Birds Eye View == | |||
The purpose of this stage is to combine all of the perspective transformed images into a single BEV image. This process is performed in the BEV View. A rectangle frame indicates the valid output image area. Ensure all the images fit inside this frame, anything outside will be ignored. | The purpose of this stage is to combine all of the perspective transformed images into a single BEV image. This process is performed in the BEV View. A rectangle frame indicates the valid output image area. Ensure all the images fit inside this frame, anything outside will be ignored. | ||
{{Message|content=Use the Fit button in the zoom toolbar to adjust the frame to the visible area.|type=info}}{{Message|content=Use the Opacity tool in the Settings Menu to fine-tune the overlap between the images|type=info}} | |||
# Click on View BEV in the Control Panel, to move the BEV View working space. | # Click on View BEV in the Control Panel, to move the BEV View working space. | ||
# Make sure you have performed the transformation for all the images, each transformed image should appear in the Main View. | # Make sure you have performed the transformation for all the images, each transformed image should appear in the Main View. | ||
| Line 267: | Line 258: | ||
#* You can always go back to the individual image in the Cameras View and adjust the transformation, scale and offset. | #* You can always go back to the individual image in the Cameras View and adjust the transformation, scale and offset. | ||
# Once you have matched all the images you can click '''Apply''' to see the blended result. Actually you don’t need to wait until you have all the images, you can hit apply any time you want to see a partial BEV result. The resultant BEV will be shown at the '''Result View.''' At this point the resulting image may not be easy to view because you may have many overlaps that will be solved when you select the ROIs. | # Once you have matched all the images you can click '''Apply''' to see the blended result. Actually you don’t need to wait until you have all the images, you can hit apply any time you want to see a partial BEV result. The resultant BEV will be shown at the '''Result View.''' At this point the resulting image may not be easy to view because you may have many overlaps that will be solved when you select the ROIs. | ||
{{Message|content=Do not expect a perfect match, the different perspectives of the cameras always will cause some disparities. |type=note}} | |||
== Region of Interest Selection == | == Region of Interest Selection == | ||
| Line 289: | Line 279: | ||
#* ROIs can be tricky, you can always experiment with different areas and positions. | #* ROIs can be tricky, you can always experiment with different areas and positions. | ||
# Once you have matched all the images you can click '''Apply''' to see the blended result. Actually you don’t need to wait until you have all the images, you can hit apply any time you want to see a partial BEV result. The resultant BEV will be shown in the '''Result View.''' | # Once you have matched all the images you can click '''Apply''' to see the blended result. Actually you don’t need to wait until you have all the images, you can hit apply any time you want to see a partial BEV result. The resultant BEV will be shown in the '''Result View.''' | ||
# You can also add an overlay from the settings panel to hide the hole where the cameras are positioned. | # You can also add an overlay from the settings panel to hide the hole where the cameras are positioned. | ||
| Line 299: | Line 288: | ||
# If you plan to use the libpanorama example application you need to modify the exported JSON. You need to change: | # If you plan to use the libpanorama example application you need to modify the exported JSON. You need to change: | ||
#* The '''location''' in each camera pipeline. | #* The '''location''' in each camera pipeline. | ||
#* You may remove the overlay portion of the JSON if you do not wish to render an image on top of the BEV. | |||
#* You may modify the camera pipelines to use the actual cameras or videos | |||
=== Project File === | |||
== Project File == | |||
* '''Save the Project:''' You can save your project to continue later. Click on Save Project in the Control Panel to download a file bev_project.bev with the current state of your calibration. | * '''Save the Project:''' You can save your project to continue later. Click on Save Project in the Control Panel to download a file bev_project.bev with the current state of your calibration. | ||
* '''Load the Project:''' When you want to reload the project, just launch the BEV calibration tool and click Open Project to open a file selection dialog and select your bev_project.bev. This will load the calibration state that you saved. | * '''Load the Project:''' When you want to reload the project, just launch the BEV calibration tool and click Open Project to open a file selection dialog and select your bev_project.bev. This will load the calibration state that you saved. | ||
=== Test in the Target Hardware === | === Test in the Target Hardware === | ||
| Line 348: | Line 313: | ||
<li>If you followed the build instructions, it should work out of the box</li> | <li>If you followed the build instructions, it should work out of the box</li> | ||
</ul> | </ul> | ||
</ol> | </ol> | ||
| Line 356: | Line 321: | ||
[[File:bev-target.gif|thumbnail|center|640px|alt=Testing in the target hardware|Testing in the target hardware.]] | [[File:bev-target.gif|thumbnail|center|640px|alt=Testing in the target hardware|Testing in the target hardware.]] | ||
== Hot Keys == | |||
# '''Ctrl + Scroll:''' Zoom in/Out | |||
# '''Ctrl + Drag:''' Move whole view | |||
# '''Scroll:''' Vertical Scroll | |||
# '''Shift + scroll:''' Horizontal scroll | |||
# '''Shift + click:''' In BEV View, show/hide zone outside of polygon. You must click in any place inside the image you want to hide the region. | |||
{{Birds Eye View/Foot}} | {{Birds Eye View/Foot}} | ||