Digital PTZ and Dewarp

Digital PTZ

Digital pan-tilt-zoom (DPTZ) can be enabled for both PTZ and non-PTZ cameras. This feature provides image magnification by the means of cropping and enlarging the picture, additionally using the picture-in-picture feature to display a preview of the whole stream when the original picture is zoomed IN. While it is mostly useful for devices without optical zoom capabilities, if you do not wish to grant some of your users PTZ control access, then DPTZ can be also used for PTZ devices. Also, digital zoom can be used for maps.

Last used digital PTZ position is preserved when you save a layout containing a zoomed stream or map.

In order to enable DPTZ in live view or playback, select the target viewport and enable digital zoom by clicking DPTZ toggle button on the overlay control panel in the bottom right corner. You can also set DPTZ controls to be visible by default via Macula Monitor main menu Edit -> Settings -> Viewport Overlays tab.

An additional panel with DPTZ controls will appear below the video stream. To use DPTZ with maps, simply use your mouse wheel to zoom IN and OUT and then drag to view different parts of the map.

DPTZ and dewarp positions will be preserved when you export a snapshot.

Digital PTZ Modes

Digital PTZ for video streams has two modes:

  • region

    • draw a rectangle on the video by left-clicking and dragging with your mouse

    • when you release the mouse, the marked area will be automatically zoomed in and a small preview window (picture-in-picture) will appear in the upper left corner of the video

    • move the selection in the preview window to view different areas

    • use the mouse wheel either in the preview or in the original video to zoom IN/OUT

  • PTZ imitation

    • zoom IN/OUT by using your mouse wheel

    • when the picture is zoomed IN, a small preview window will appear in the upper left corner of the video

    • move the selection in the preview window to view different areas

    • additionally, you can move around the video by clicking the original video as if it were a PTZ camera (click and hold to move in that direction)

The basic difference between the two modes is the method of moving around the picture: either by drawing new regions or with PTZ Point-to-Click imitation. By default, the region mode is enabled, and you can switch between the two using the buttons on the right side of the DPTZ panel (RGN for region and PTZ for point-to-click mode, correspondingly).

DPTZ Presets

Digital PTZ positions can be saved as presets and then called later at any time, just like regular PTZ presets. Use the Presets drop-down list in the left part of the DPTZ panel for this:

  • to save the preset, click the arrow and click Save preset, then choose whether you want to create a new preset or overwrite an existing one, specify the preset name and click Save

  • click the preset name in the list to load it

  • click the ... button next to the preset name and choose Remove preset to delete it

Digital PTZ presets are stored locally, on the Macula Monitor application side, and are bound to channels. This means that, once created, DTPZ presets will be available for the target channel from the same workstation and they cannot be shared with other application instances connected to the same server from other places.

Dewarp

For cameras with fisheye and Panomorph lenses, dewarp mode is enabled when digital PTZ is turned ON. This feature can be used both in live view and playback mode; in order to use it, click the DPTZ toggle overlay control in the bottom-right-hand-corner of the viewport.

By default, region dewarp mode is turned ON: a part of the dewarped image is displayed in the viewport and camera becomes a virtual PTZ, which can be zoomed and moved through the entire angle that fisheye camera allows. Press left mouse button and drag to pan/tilt in corresponding direction; use the zoom slider to zoom in and out.

You can place one channel into multiple viewports on your viewport layout, enable DPTZ for all of them and then use DPTZ to display different regions of the dewarped image. The created arrangement can be saved just as usual, via Save Layout menu in the upper-left-hand corner: DPTZ positions will be maintained when you load the layout at any time later.

If you need a larger part of the scene to be displayed in a single viewport, you can switch to a 180-degree or a 360-degree panorama view using the drop-down menu, which appears in the bottom of the viewport when DPTZ is enabled.

If you do not have a dewarped picture after enabling digital PTZ capabilities, it means that dewarp has not been configured for the target device. In order to do this, go to Macula Console and adjust dewarp settings in the channel properties; the details about setup are available in your server management documentation.

Last updated