Cisco TelePresence SX20 Codec Reference Manual page 63

Application programming interface (api)
Hide thumbs Also See for TelePresence SX20 Codec:
Table of Contents

Advertisement

Cisco TelePresence SX20 Codec
Contents
Introduction
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.
Typical resolutions used for different optimal definition profiles, call rates and frame rates
Optimal
Frame
Definition
rate
Profile
256 kbps
768 kbps
Normal
512 × 288
1024 × 576
Medium
640 × 360
1280 × 720
30 fps
High
768 × 448
1280 × 720
Normal
256 × 144
512 × 288
60 fps
Medium
256 × 144
768 × 448
High
512 × 288
1024 × 576
.
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: Medium
SX20 Codec API Reference Guide TC6.2, JULY 2013.
D14949.04
About the API
Call rate
1152 kbps 1472 kbps 2560 kbps
4 Mbps
1280 × 720
1280 × 720 1920 × 1080 1920 × 1080 1920 × 1080
1280 × 720
1280 × 720 1920 × 1080 1920 × 1080 1920 × 1080
1280 × 720 1920 × 1080 1920 × 1080 1920 × 1080 1920 × 1080
768 × 448
1024 × 576
1280 × 720
1280 × 720 1920 × 1080
1024 × 576
1024 × 576
1280 × 720 1920 × 1080 1920 × 1080
1280 × 720
1280 × 720 1920 × 1080 1920 × 1080 1920 × 1080
xConfiguration
xConfiguration
xCommand
xConfiguration Video Input Source [1..3] OptimalDefinition Threshold60fps
For each video input, this setting tells the system the lowest resolution where it should transmit
60fps. So for all resolutions lower than this, the maximum transmitted framerate would be 30fps,
while above this resolution 60fps would also be possible, if the available bandwidth is adequate.
Requires user role: ADMIN
Value space: <512_288/768_448/1024_576/1280_720/1920_1080/Never>
512_288: Set the threshold to 512x288.
768_448: Set the threshold to 768x448.
1024_576: Set the threshold to 1024x576.
1280_720: Set the threshold to 1280x720.
1920_1080: Set the threshold to 1920x1080.
Never: Do not set a threshold for transmitting 60fps.
Example: xConfiguration Video Input Source 1 OptimalDefinition Threshold60fps:
1280 _ 720
xConfiguration Video Input Source [1..3] Quality
When encoding and transmitting video there will be a trade-off between high resolution and
6 Mbps
high framerate. For some video sources it is more important to transmit high framerate than high
resolution and vice versa. The Quality setting specifies whether to give priority to high frame rate or
to high resolution for a given source.
Requires user role: ADMIN
Value space: <Motion/Sharpness>
Motion: Gives the highest possible framerate. Used when there is a need for higher frame rates,
typically when a large number of participants are present or when there is a lot of motion in the
picture.
Sharpness: Gives the highest possible resolution. Used when you want the highest quality of
detailed images and graphics.
Example: xConfiguration Video Input Source 1 Quality: Motion
xConfiguration Video MainVideoSource
Define which video input source shall be used as the main video source. The video input source is
configured with the "Video Input Source [1..n] Connector" setting.
Requires user role: USER
Value space: <1/2/3>
Range: Select the source to be used as the main video source.
Example: xConfiguration Video MainVideoSource: 1
63
API Reference Guide
xStatus
Appendices
Copyright © 2013 Cisco Systems, Inc. All rights reserved.

Hide quick links:

Advertisement

Table of Contents
loading

Table of Contents