Xcommand Camera Preset Store; Xcommand Camera Ramp - Cisco TelePresence SX80 Reference Manual

Cisco TelePresence SX80

Introduction

xCommand Camera Preset Store

Store the current position (pan and tilt), zoom and focus of the chosen camera. The camera is
identified by the CameraId parameter.
Note that the xCommand Camera Preset commands applies to an individual camera. This is
in contrast to the xCommand Preset commands where a single preset covers ALL connected
cameras plus the Video Input switcher settings. The xCommand Camera Preset commands are
useful when you want to handle multiple camera positions individually per camera, rather than
working with complete sets of camera positions. The individual camera presets are not available
for far end control.
Requires user role: ADMIN, USER
USAGE:
xCommand Camera Preset Store [PresetId: PresetId] CameraId:
[ListPosition: ListPosition] [Name: "Name"] [TakeSnapshot: TakeSnapshot]
[DefaultProsition: DefaultProsition]
where
: Integer (1..35)
PresetId
The ID of this camera preset. If not set explicitly, the codec will assign a preset ID
automatically.
: Integer (1..7)
CameraId
Select the camera for which to store the preset position.
: Integer (1..35)
ListPosition
The new camera preset's position in the list returned by the xCommand Camera Preset
List command.
: String (0, 255)
Name
The name of the new camera preset. It will be used in the list returned by the
xCommand Camera Preset List command.
: False/True
TakeSnapshot
Allow or disallow snapshot of the preview.
: False/True
DefaultProsition
Defines whether or not this preset shall be the default position of the associated
camera. Note that each camera can hold only one default position, so if set, the old
default preset will automatically be marked as not default.
Cisco TelePresence SX80 API Reference Guide CE9.1, JUNE 2017.
D15317.07
About the API xConfiguration
CameraId
xCommand xCommand

xCommand Camera Ramp

Move the camera in a specified direction. The camera moves at specified speed until a stop
command is issued. In a daisy chain, you need to know the CameraId for the camera you want
to address. Be aware that pan and tilt can be operated simultaneously, but no other combina-
tions. In the latter case only the first operation specified is executed. For example, if you try to
run both zoom and pan at the same time, only zoom is executed.
NOTE: You must run a stop command to stop the camera, see the example below.
Requires user role: ADMIN, USER
USAGE:
xCommand Camera Ramp CameraId:
Tilt] [TiltSpeed: TiltSpeed] [Zoom: Zoom] [ZoomSpeed: ZoomSpeed] [Focus: Focus]
where
: Integer (1..7)
CameraId
Select the camera.
: Left/Right/Stop
Pan
Move the camera to the Left or Right, followed by Stop.
: Integer (1..15)
PanSpeed
Set the pan speed.
: Down/Up/Stop
Tilt
Move the camera Up or Down, followed by Stop.
: Integer (1..15)
TiltSpeed
Set the tilt speed.
: In/Out/Stop
Zoom
Zoom the camera In or Out, followed by Stop.
: Integer (1..15)
ZoomSpeed
Set the zoom speed.
: Far/Near/Stop
Focus
Focus the camera Far or Near, followed by Stop.
122
API Reference Guide
xStatus Appendices
CameraId [Pan: Pan] [PanSpeed: PanSpeed] [Tilt:
Copyright © 2017 Cisco Systems, Inc. All rights reserved.