3D Dewarp for 360-Degree Fisheye Camera
Last updated: June 2025
Scenario:
i-PRO Maximizer version 1.2.0 or later supports 3D dewarp in Milestone XProtect. This page explains how to configure and use this feature in the Smart Client. Only cameras registered with the fisheye capture mode are supported.
1. Initial Setup
2. Operation
Overview:
3D dewarp is a new feature that provides users with distortion-corrected images from 360-degree fisheye cameras. By using virtual PTZ operations, it offers enhanced usability and a better monitoring experience.
Quad or Hexa view provides a flexible display layout within a single XProtect Smart Client tile.
Example of Quad view
Example of Hexa view
Hardware requirements and performance:
Supported camera model
WV-S4176*, WV-S4576L*, WV-S4156*, WV-S4556L*
WV-X4170, WV-X4171, WV-X4571L*, WV-X4573L*, WV-X4173, WV-X4172
WV-S4150*, WV-S4550L*, WV-S4551L*, WV-S4151*
WV-SFN480, WV-SFV481
WV-SF438, WV-SF448, WV-SW458
PC requirement
The same as requirement for XProtect Smart Client, Intel® CPU from 6th generation or later that supports Intel Quick Sync, or NVIDIA graphics card is required.
https://www.milestonesys.com/support/help-and-documentation/system-requirements/
It is recommended to use hardware acceleration on Smart Client when 2192x2192 or higher and high frame rate. See more about enabling hardware acceleration.
Windows remote desktop connection is not supported. Smart client does not work when dewarp tile is shown.
Performance reference
In the combination of XProtect 2025R1, i-PRO Maximizer v1.2.0 and Intel® CPU from 13th generation, Up to 30fps at 2192x2192, and up to 20fps at 2992x2992 is shown correctly.
But depending on the PC specifications and status, the video may not be displayed correctly. Reducing the frame rate of live stream can improve.
1. Initial Setup
1. Click [Setup] from the top-right menu. [Maximizer Dewarp] is shown at the bottom-left.
2. Select the tile for 3D dewarp.
3. Click [Select Camera], select the target camera, and then click [Select].
4. Select the camera mounting position from [Ceiling mount/Wall mount/Ground] mount and click [Set camera on the view item].
5. Click [Setup] from the top-right menu to complete the setup.
2. Operation
Both Live and Playback support dewarp operation.
Mouse operation:
| Left double click | Zoom in to the clicked area and zoom out. |
| Drag by left click | Pan / tilt the image for zoom in display (PTZ display), and image rotation for Fisheye display. |
| Mouse wheel | Zoom in and out. |
Right click menu:
| Set home position | Save the current dewarped position and display layout as home position. The saved home position is used as the default when starting Smart Client. |
| Move to home position | Move to saved home position. |
| Move to default position | Move to default image rotation angle. |
| View Mode | Fisheye / Panorama / Double Panorama |
| Display Layout |
Switch the display layout inside the dewarp tile.
|
| Double Click Action | 3D Dewarp: Zoom in and zoom out Switch Single/Multi view inside the tile: It is useful when Quad or Hexa is used for Display Layout. Instead of zoom in and zoom out, double click maximize the selected screen inside the tile. Maximize view: This option is the same as the original behavior of Smart Client. Dewarp tile will be maximized to the Smart Client screen. |
| Snapshot | Save the image of dewarp tile. |
Operation in Quad or Hexa view:
When Quad or Hexa is selected, Fisheye is shown for all screens at first.
On each screen, mouse operations like zoom-in/out and rotation are available.
You can also change Fisheye/Double Panorama/Panorama for each screen.
This allows you to customize each dewarp tile in different styles simultaneously and save the layout as the home position.
Milestone XProtect 2025 R1 / DP 13.7a
i-PRO Maximizer 1.2.0