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

Cisco TelePresence SX10

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
PresetId: Integer (1..35)
The ID of this camera preset. If not set explicitly, the codec will assign a preset ID
automatically.
CameraId: Integer (1..1)
Select the camera for which to store the preset position.
ListPosition: Integer (1..35)
The new camera preset's position in the list returned by the xCommand Camera Preset
List command.
Name: String (0, 255)
The name of the new camera preset. It will be used in the list returned by the
xCommand Camera Preset List command.
TakeSnapshot: False/True
Allow or disallow snapshot of the preview.
DefaultProsition: False/True
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 SX10 API Reference Guide CE8.2, SEPTEMBER 2016.
D15333.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
combinations. 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
CameraId: Integer (1..1)
Select the camera.
Pan: Left/Right/Stop
Move the camera to the Left or Right, followed by Stop.
PanSpeed: Integer (1..15)
Set the pan speed.
Tilt: Down/Up/Stop
Move the camera Up or Down, followed by Stop.
TiltSpeed: Integer (1..15)
Set the tilt speed.
Zoom: In/Out/Stop
Zoom the camera In or Out, followed by Stop.
ZoomSpeed: Integer (1..15)
Set the zoom speed.
Focus: Far/Near/Stop
Focus the camera Far or Near, followed by Stop.
109
API Reference Guide
xStatus Appendices
[Pan: Pan] [PanSpeed: PanSpeed] [Tilt:
CameraId
Copyright © 2016 Cisco Systems, Inc. All rights reserved.