Set the PTZ preset entry configuration.
This URL command is used on the IP PTZ or Speed Dome cameras.
PTZ_PRESET_SET Command Description Entry,State,PosX,PosY,PosZ,SpeedX,SpeedY,SpeedZ,Dwell,Name Set a valid entry (State=1). Clear an entry (State=0). Refer to the following table for detail in every input argument. Entry,1 Set a valid entry.
The firmware uses current pan/tilt/zoom positions to set this preset point with highest pan/tilt/zoom speed and dwell time is 10. If the preset name is NULL, the default preset name will be set.
snprintf(preset.name, PRESET_NAME_LEN-1, "Entry_%d", Entry)Entry,0 Disable the preset. The configurations of this entry will not be reset except the State. The value range in some input arguments in the first command depends on PTZ protocols and camera models.
Input argument Description Entry In PlatformA video encoders and PTZ camera, the range of Entry is from 1 to 32.
Except PlatformA devices, the range of Entry is from 1 to 64.State Set the entry to be valid or invalid. It is 1 for a valid entry and 0 for an invalid entry PosX The absolute position in pan. It is the signed decimal value. If the position is out of maximum moving range, the camera will stop at the maximum pan position. In this case, no error message will be returned. PosY The absolution position in tilt. It is similar to PosX PosZ The absolution position in zoom. It is the unsigned decimal value and the range could be 0 to 65535. If the position is out of maximum zooming range, the camera will stop at the maximum zoom position. In this case, no error message will be returned.
Important Note:
If it is 65535, the firmware will ignore the PosX, PosY and PosZ in the URL to set the preset point. It will use the current pan, tilt and zoom positions to set the preset point.SpeedX Speed of movement in pan, it should be fixed to 5.
In PlatfromA PTZ cameras, this speed is used to move the next touring poing speed in touring mode. Otherwise, It will used speed 5 to move to a preset point.
In PlarformT and PlatformK cameras, the firmware will force this setting to 5 no matter what value it is.SpeedY Speed of movement in tilt, it should be fixed to 5.
In PlatfromA PTZ cameras, this speed is used to move the next touring poing speed in touring mode. Otherwise, It will used speed 5 to move to a preset point.
In PlarformT and PlatformK cameras, the firmware will force this setting to 5 no matter what value it is.SpeedZ Speed of movement in zoom, it should be fixed to 7.
In PlatfromA PTZ cameras, this speed is used to move the next touring poing speed in touring mode. Otherwise, It will used speed 5 to move to a preset point.
In PlarformT and PlatformK cameras, the firmware will force this setting to 5 no matter what value it is.Dwell The timer for staying this entry in second. This configuration is not used now. Keep this setting to 10 when you set an entry. The firmware will force this setting to 10 no matter what value it is. Name name of this entry. The maximum length of this configuration is 31.
The name will be truncated if it is longer than 31.
The allowed characters and rules are defined in the General rules of Valid Characters in URI.When a preset point is disabled, all touring entries associated with this preset point will be disabled as well.
Special Notes
1 In PlatformW and PlatformT speed dome cameras, they use current position to set the preset point. Using absolute position to set preset point does not work then. 2 In PlatformK cameras, if the absolute pan, tilt and zoom positions are set to a preset point, the out of focus result will be seen when go to this preset point. Therefore, user should use current positions to set the preset point.
OK: PTZ_PRESET_SET='Entry,State,PosX,PosY,PosZ,SpeedX,SpeedY,SpeedZ,Dwell,Name'
or
OK: PTZ_PRESET_SET='Entry,n'
or
ERROR: invalid parameters
Valid
PTZ_PRESET_GET, PTZ_PRESET_GO, PTZ_TOUR_GET, PTZ_TOUR_STATE, PTZ_TOUR_NAME, PTZ_TOUR_SCAN, PTZ_PARK_CONFIG
http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&PTZ_PRESET_SET=1,1,0,0,0,3,3,5,10,Entry 1
or
http://ip:port/cgi-bin/cmd/encoder?PTZ_PRESET_SET=1,1,0,0,0,3,3,5,10,Entry 1
http://ip:port/cgi-bin/encoder?USER=Admin&PWD=123456&PTZ_PRESET_SET=1,1,0,0,65535,3,3,5,10,Entry 1
or
http://ip:port/cgi-bin/cmd/encoder?PTZ_PRESET_SET=1,1,0,0,65535,3,3,5,10,Entry 1
http://ip:port/cgi-bin/cmd/encoder?USER=Admin&PWD=123456&PTZ_PRESET_SET=1,0
or
http://ip:port/cgi-bin/cmd/encoder?PTZ_PRESET_SET=1,0