Technical References
D14642.13 Codec C40-C60 API Reference Guide TC6.3, NOVEMBER 2013. Copyright © 2010–2013 Cisco Systems, Inc. All rights reserved. 76
Cisco TelePresence System Codec C40/C60 API Reference Guide
xConfiguration Video SelfviewDefault PIPPosition
Determine the position on screen of the small self view picture-in-picture (PiP) after a call. The
setting only takes effect when self view is switched on (see the Video SelfviewDefault Mode setting)
and fullscreen view is switched off (see the Video SelfviewDefault FullscreenMode setting).
This setting obsoletes the Video SelfviewPosition setting as from TC6.0.
Requires user role: ADMIN
Value space: <Current/UpperLeft/UpperCenter/UpperRight/CenterLeft/CenterRight/LowerLeft/
LowerRight >
Current: The position of the self view PiP will be kept unchanged when leaving a call.
UpperLeft: The self view PiP will appear in the upper left corner of the screen.
UpperCenter: The self view PiP will appear in the upper center position.
UpperRight: The self view PiP will appear in the upper right corner of the screen.
CenterLeft: The self view PiP will appear in the center left position.
CentreRight: The self view PiP will appear in the center right position.
LowerLeft: The self view PiP will appear in the lower left corner of the screen.
LowerRight: The self view PiP will appear in the lower right corner of the screen.
Example:
xConfiguration Video SelfviewDefault PIPPosition: Current
xConfiguration Video SelfviewDefault OnMonitorRole
Determine which monitor/output to display the main video source (self view) on after a call.
The value reflects the monitor roles set for the different outputs in the Video Output HDMI/DVI/
Composite MonitorRole settings.
The setting applies both when self view is displayed in full screen, and when it is displayed as
picture-in-picture (PiP), but only if the Video Monitors setting is set to Dual.
Requires user role: ADMIN
Value space: <First/Second/Current>
First: The self view picture will be shown on outputs with the Video Output HDMI/DVI/Composite
MonitorRole set to First.
Second: The self view picture will be shown on outputs with the Video Output HDMI/DVI/
Composite MonitorRole set to Second.
Current: When leaving the call, the selfv iew picture will be kept on the same output as during the
call.
Example:
xConfiguration Video SelfviewDefault OnMonitorRole: Current
xConfiguration Video CamCtrlPip CallSetup Mode
This setting is used to switch on self view for a short while when setting up a call. The Video
CamCtrlPip CallSetup Duration setting determines for how long it remains on. This applies when self
view in general is switched off.
Requires user role: ADMIN
Value space: <Off/On>
Off: Self view is not shown automatically during call setup.
On: Self view is shown automatically during call setup.
Example:
xConfiguration Video CamCtrlPip CallSetup Mode: Off
xConfiguration Video CamCtrlPip CallSetup Duration
This setting only has an effect when the Video CamCtrlPip CallSetup Mode setting is switched On.
In this case, the number of seconds set here determines for how long self view is shown before it is
automatically switched off.
Requires user role: ADMIN
Value space: <1..60>
Range: Choose for how long self view remains on. The valid range is between 1 and 60 seconds.
Example:
xConfiguration Video CamCtrlPip CallSetup Duration: 10
xConfiguration Video PIP ActiveSpeaker DefaultValue Position
Determine the position on screen of the active speaker picture-in-picture (PiP). The setting only
takes effect when using a video layout where the active speaker is a PiP, i.e. the Overlay layout, or
possibly a Custom layout (see the Video Layout LocalLayoutFamily setting). The setting takes effect
from the next call onwards; if changed during a call, it will have no effect on the current call.
Requires user role: ADMIN
Value space: <Current/UpperLeft/UpperCenter/UpperRight/CenterLeft/CenterRight/LowerLeft/
LowerRight>
Current: The position of the active speaker PiP will be kept unchanged when leaving a call.
UpperLeft: The active speaker PiP will appear in the upper left corner of the screen.
UpperCenter: The active speaker PiP will appear in the upper center position.
UpperRight: The active speaker PiP will appear in the upper right corner of the screen.
CenterLeft: The active speaker PiP will appear in the center left position.
CentreRight: The active speaker PiP will appear in the center right position.
LowerLeft: The active speaker PiP will appear in the lower left corner of the screen.
LowerRight: The active speaker PiP will appear in the lower right corner of the screen.
Example:
xConfiguration Video PIP ActiveSpeaker DefaultValue Position: Current
Contents
Introduction
About the API
xConfiguration
Appendices
xCommand
xStatus
xConfigu ration