PTZ_TOUR_SET

 

Description

Set or clear a PTZ tour entry configuration.

Input Argument

PTZ_TOUR_SET Command Description
Group,Entry,State,Preset,Dwell,Sequence,SpeedX,SpeedY,SpeedZ This command is for PlatformT and PlatformK speed dome cameras only.
Set a configuration of the PTZ tour entry in a tour group if State=1.
Remove a tour entry from the tour group if State = 0.
Refer to the following table for detail in every input argument.
Group,Entry,State,Preset,Dwell,Sequence This command is for PlatformA PTZ cameras only.
Set a configuration of the PTZ tour entry in a tour group if State=1.
Remove a tour entry from the tour group if State = 0.
Refer to the following table for detail in every input argument.
Group,Entry,0 remove a PTZ tour entry from a tour group
It is the same as the URL Group,Entry,0,Preset,Dwell,Sequence,SpeedX,SpeedY,SpeedZ
Group,0 remove all PTZ tour entries from a tour group

The value range in some input arguments in the first command depends on PTZ protocols and camera models.

Input argument Description
Group ID of the tour group. It starts form 1 to 10.
In PlatformT speed dome camera, there are 8 tour groups. It allows to access the tour group 9 and 10. But the camera will not response to do touring when the tour group 9 or 10 is activated.
Entry tour entry ID in the tour group. It starts form 1 to 32. If it is 0, all tour entries in this tour group will be removed. The input argument behind it will be ignored.
State Set the tour entry to be valid or invalid. Set 1 to activate the tour entry and 0 to remove the tour entry.
Preset The index of preset points associated with this tour entry. The index is from 1 to 32 (PlatformA PTZ) or 64 (PlatformT, PlatformK PTZ/Speed Dome). Refer to the PTZ_PRESET_SET URL.
Dwell The time in second to stay a tour entry position. Due to different implementation in PTZ/Speed dome camera, the dwell time has different definitions.The range of this configuration depends on the implementation.
In PlatformA PTZ camera, the dwell time includes the traveling time form a position to another one. The actual time to stay a position will be shorter than this setting. The travelling time should be added to this dwell time setting. The minimum dwell time is 10. The maximum dwell time is 255.
In PlatformT speed dome camera, the dwell time does not include the travelling time form a position to another one. Therefore, the minimum dwell time is 1 and the maximum dwell time is 128 seconds. The dwell time higher than 128 will be mapped to 128 seconds.
In PlatformK speed dome camera, the dwell time does not include the travelling time form a position to another one. The dwell time range is from 1 to 255 seconds.
Sequence Not used. keep it as the same as index of tour entry.
The sequence order in the tour entries in the tour group. It started from 1. The camera will follow this sequence to move the camera in tour mode.
SpeedX Pan speed of moving to the next tour entry. It is in the range of 1 and 5. The higher value, the faster movement.
In PlatformA PTZ camera, this argument is ignored. The SpeedX in the associated preset point configuration will be used then.
In PlatformK fisheye camera, there is no pan speed of every touring point. This setting will be fixed to 5.
In PlatformK PTZ/speed dome cameras, it use this speed to move to next touring point no matter auto speed is enabled or not.
SpeedY Tilt speed of moving to the next tour entry. It is in the range of 1 and 5. The higher value, the faster movement.
In PlatformA PTZ camera, this argument is ignored. The SpeedX in the associated preset point configuration will be used then.
In PlatformK fisheye camera, there is no pan speed of every touring point. This setting will be fixed to 5.
In PlatformK PTZ/speed dome cameras, it use this speed to move to next touring point no matter auto speed is enabled or not.
SpeedZ Zoom speed of moving to the next tour entry. It is in the range of 2 and 7. The higher value, the faster movement.
In PlatformA PTZ camera, this argument is ignored. The SpeedZ in the associated preset point configuration will be used then.
In PlatformK fisheye camera, there is no zoom speed of every touring point. This setting will be fixed to 7.
In PlatformK PTZ/speed dome cameras, it uses speed 7 for zooming. This setting will be fixed to 7.

Attribute

Return of Message

OK: Group,Entry,State,Preset,Dwell,Sequence,SpeedX,SpeedY,SpeedZ
or
OK: Group,Entry,0
or
OK: Group,0
or
ERROR: invalid parameters

Applicability

Status

Valid

See Also

PTZ_PRESET_SET, PTZ_PRESET_GET, PTZ_PRESET_GO, PTZ_TOUR_GET, PTZ_TOUR_STATE, PTZ_TOUR_NAME, PTZ_TOUR_SCAN, PTZ_PARK_CONFIG

Example

http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&PTZ_TOUR_SET=1,2,1,5,10,1,5,5,3
or
http://ip:port/cgi-bin/cmd/encoder?PTZ_TOUR_SET=1,2,1,5,10,1
http://ip:port/cgi-bin/cmd/encoder?USER=Admin&PWD=123456&PTZ_TOUR_SET=1,2,0
or
http://ip:port/cgi-bin/cmd/encoder?PTZ_TOUR_SET=1,2,0
http://ip:port/cgi-bin/cmd/encoder?USER=Admin&PWD=123456&PTZ_TOUR_SET=1,0
or
http://ip:port/cgi-bin/cmd/encoder?PTZ_PRESET_GET=1,0

Back to

HOME, ENCODER CGI