D14642.15 Codec C40-C60 API Reference Guide TC7.0, JANUARY 2014.
Copyright © 2010–2014 Cisco Systems, Inc. All rights reserved.
71
Cisco TelePresence System Codec C40/C60
API Reference Guide
xConfiguration Video Input Source [1..3] Visibility
Define the visibility of the video input source in the menus on the user interface.
Requires user role:
ADMIN
Value space:
<Never/Always/IfSignal>
Never:
Set to Never when the input source is not expected to be used as a presentation source.
Always:
When set to Always, the menu selection for the video input source will always be visible
on the graphical user interface.
IfSignal:
When set to IfSignal, the menu selection for the video input source will only be visible
when a presentation source is connected to the video input.
Example:
xConfiguration Video Input Source 1 Visibility: IfSignal
xConfiguration Video Input Source [1..3] CameraControl Mode
Select whether or not to enable camera control for the selected video input source when the video
input is active.
Requires user role:
ADMIN
Value space:
<Off/On>
Off:
Disable camera control.
On:
Enable camera control.
Example:
xConfiguration Video Input Source 1 CameraControl Mode: On
xConfiguration Video Input Source [1..3] CameraControl CameraId
Select the ID of the camera in the Visca chain that is connected to this camera source. The
CameraId setting represents the camera's position in the Visca chain.
Requires user role:
ADMIN
Value space:
<1/2/3/4/5/6/7>
Range:
Select the ID of the camera in the Visca chain.
Example:
xConfiguration Video Input Source 1 CameraControl CameraId: 1
xConfiguration Video Input Source [1..3] OptimalDefinition Profile
The Video Input Source Quality setting must be set to Motion for the optimal definition settings to
take any effect.
The optimal definition profile should reflect the lighting conditions in your room and the quality of the
video input (camera); the better the lighting conditions and video input, the higher the profile. Then,
in good lighting conditions, the video encoder will provide better quality (higher resolution or frame
rate) for a given call rate.
Generally, we recommend using the Normal or Medium profiles. However, when the lighting
conditions are good, the High profile can be set in order to increase the resolution for a given call
rate.
Some typical resolutions used for different optimal definition profiles, call rates and transmit frame
rates are shown in the table below. It is assumed that dual video is not used. The resolution must be
supported by both the calling and called systems.
Use the Video Input Source OptimalDefinition Threshold60fps setting to decide when to use the 60
fps frame rate.
.
Requires user role:
ADMIN
Value space:
<Normal/Medium/High>
Normal:
Use this profile for a normally to poorly lit environment. Resolutions will be set rather
conservative.
Medium:
Requires good and stable lighting conditions and a good quality video input. For some
call rates this leads to higher resolution.
High:
Requires nearly optimal video conferencing lighting conditions and a good quality video input
in order to achieve a good overall experience. Rather high resolutions will be used.
Example:
xConfiguration Video Input Source 1 OptimalDefinition Profile: Normal
Contents
Introduction
About the API
xConfiguration
Appendices
xCommand
xStatus
xConfiguration
