PTZ

General information about PTZ

You can configure the PTZ object (PTZ camera) on the Devices tab. The PTZ object is displayed in the object tree as a child of the Camera object.

PTZ configuration

To configure the PTZ camera, do the following:

1. Go to the Devices tab.
2. Select the PTZ object in the object tree. If necessary, you can change the values of the parameters that are listed in the table:
   

   Parameter	Value	Description
   Object identification
   Enable	Yes	By default, PTZ is enabled. To disable it, select the No value
   	No
   Name	PTZ	Enter the name of the PTZ camera
   Patrol	Yes	By default, patrolling is disabled. To enable it, select the Yes value. If patrolling is enabled, you can stop it on the PTZ control panel (see Patrolling). After you finish the PTZ control session, patrolling is enabled automatically
   	No
   Save presets	Yes	By default, the parameter is disabled. In this case, the Presets are only stored on the server. To save the created presets to the IP device, select the Yes value Note This parameter is available only for the devices that support absolute positioning. For the current list of compatible devices, see Documentation Drivers Pack.
   	No
   Switch interval	1	Specify the time interval in seconds at which the PTZ camera switches between the presets in the patrol mode. The value must be in the range [1, 600000]
   Tag & Track
   Priority	Select the control mode (the algorithm of behavior when tracking objects) of the PTZ camera for the Tag&Track Pro feature (see Tag&Track Pro)
   	None	The Tag&Track Pro feature is disabled. You can control the camera only manually
   	Manual	The operator initiates manual tracking. To begin tracking, select an object's track in the surveillance window. If you click an area of ​​the frame without an object's track, tracking immediately stops and the camera redirects (aims) to the specified point. This is suitable for targeted monitoring of a single specific object, when the operator needs full control over the start and end of tracking
   	Automatic	The system automatically detects and sequentially tracks all active objects within the camera's field of view, switching between them at a preset switching frequency (the Switch Frequency parameter). This is suitable for situations when continuous coverage of the entire scene is required without operator intervention, such as on a perimeter during non-working hours
   	User priority	The system starts working in automatic mode, tracking all objects. Once the operator selects a specific track, the system switches to manual tracking mode. After the operator deselects the track or the system loses the target, the system automatically returns to tracking all objects. This is the most balanced and recommended mode. It combines the advantages of automatic operation (constant visibility) and manual control (quick switching to a priority target upon operator command)
   	Manual PTZ control	The operator can manually control the PTZ camera at any time for a detailed inspection of the area. Once manual control is stopped (after a short delay of inactivity), the feature returns to automatic operation. This provides maximum flexibility. It allows the operator to intervene in the automatic operation to check for suspicious activity without disabling the tracking function
   Switch Frequency	3	Specify the time in seconds during which the camera focuses on one object before moving to the next object
   Other Attention! Depending on the camera, you can find other parameters in the Other group. To configure them, refer to their description in the interface or in the official documentation.
   Discrete control via continuous control	Yes	By default, the parameter is disabled. If you need to use the step buttons to control the PTZ camera even if the camera doesn't support this mode, select the Yes value (see Control using step buttons and virtual joystick). In this case, the discrete PTZ control is emulated via the continuous control commands
   	No
   Home preset	0	Select the home preset by specifying the required identifier. The value must be in the range [0, 999999999]
   Home preset timeout	0	The return to the home preset is performed automatically after the specified time in milliseconds. The value must be in the range [0, 999999999] Attention! If the Home preset timeout value is greater than the Operator idle time value (see Configuring PTZ control), the Operator idle time value is used.
   Multiple control	Yes	By default, the parameter is enabled, which allows multiple users with the same priority to control the PTZ camera at the same time. To disable multiple control, select the No value. In this case only one user at a time can have control (see Controlling a PTZ сamera)
   	No
   New PTZ interface	Yes	By default, the parameter is disabled. To use the existing presets on the device in Axxon One, select the Yes value. The presets created on the device automatically appear in the PTZ control panel (see The PTZ Control Panel) Attention! If the usage of the existing presets is disabled, they can be lost if the following conditions are met: In Axxon One, the recording of the presets to the device is enabled in the Use device presets parameter. The preset with the same ID is created in Axxon One (see Creating and editing presets).
   	No
   Patrol speed	100	Specify the speed of transition from one preset to another in conditional units. The value must be in the range [0, 100]
   Use device presets	Yes	By default, the parameter is disabled. To create the presets with the same identifier in Axxon One (see Creating and editing presets), select the Yes value
   	No
   Camera
   Camera	{Short name.Name}	If necessary, select the camera to which this PTZ camera must be assigned (see Camera). As a result, the object becomes a child object to the selected camera

3. Click the Apply button.

As a result, the PTZ camera is switched to the specified operating mode.
To check the operation of the PTZ camera, click the Test button. If the PTZ camera is configured correctly, it turns one step and returns to its original position.

Binding overview cameras to a PTZ camera and configuring calibration for the Tag&Track Pro feature

To use the automatic tracking feature Tag&Track Pro, you must create a logical connection between overview cameras and PTZ cameras, as well as set up precise positional correspondence between their fields of view. To do this, do the following:

1. In the Tagtrack cameras section:
   1. Click the button.
   2. Select the required overview camera from the list. To search for a camera, enter the Short name or Name (full or partial, see Camera). This parameter is case-sensitive.
2. In the surveillance window of a PTZ camera, focus on any point:
   1. In the upper right corner, click the button.
   2. Place the cursor in the middle of the frame, hold down the left mouse button, and move the cursor so that the object that you want to track is in the center of the frame.
3. In the surveillance window of the Overview camera:
   1. Left-click the point corresponding to the current position of the PTZ camera. A Calibration point is added to the surveillance window. To delete a calibration point, click the Delete button.
   2. Set at least six calibration points in the surveillance window of the overview camera, focusing on different points in the surveillance window of the PTZ camera.
      

      Attention!

      • Setting calibration points is mandatory. Without this, the overview camera will not be bound to the PTZ camera.
      • We recommend setting 6 to 10 points. Adding more points can improve accuracy but also increases the risk of errors, which will degrade the overall performance of the feature.
      • The points must not be in a straight line in both the overview and PTZ cameras. They must be evenly distributed across the entire frame.
      • All points must be in the same plane (floor, ground). We don't recommend placing points in different planes (for example, some points on the ground and others on walls or poles).
4. Click the Apply button.
5. Test the calibration
   1. In the upper right corner from the surveillance window of the Overview camera, click the button.
   2. Click each created calibration point in the surveillance window of the Overview camera. If the PTZ camera accurately positions itself at each selected point, the calibration is correct.
6. Repeat the steps for each required overview camera.

Binding overview cameras to a PTZ camera and configuring calibration for the Tag&Track Pro feature is complete:

• You have created logical connections between overview cameras and the PTZ camera that performs tracking.
• You have set up the precise correspondence between the position of the PTZ camera and points in the field of view of each overview camera.