D15107.05
Codec SX80 API Reference Guide TC7.3, OCTOBER 2015.
Copyright © 2015 Cisco Systems, Inc. All rights reserved.
136
Cisco TelePresence SX80
API Reference Guide
xCommand Video Layout Frame Update
Change the details of an existing frame in a video layout.
LayoutId: A unique identifier for the layout, which was created when the xCommand Video Layout
Add command was issued.
FrameId: A unique identifier of the frame, which was created when the xCommand Video Frame Add
command was issued.
PositionX: The top-left X position of the frame.
PositionY: The top-left Y position of the frame.
Width: The width of the frame.
Height: The height of the frame.
Layer: The stacking order of the frames (1-6). Must be unique per frame per layout. Layer 6 is on
top.
Border: Select whether or not the frame should have a border.
VideoSourceType: Select the video source to be used as the content of the frame. The parameter
arguments are explained below:
Graphic: Not in use.
LocalInput: Select one of the local input sources.
LocalMain: Select what is currently the main source on the local side.
LocalPresentation: Select what is currently the default presentation source on the local side.
MostSpeaking: Select the current loudest speaker in the conference.
OtherMain: Select another site in a call. This involves logic in the codec to ensure that a site
does not see itself. You can add several frames with OtherMain. The source and the layout engine
automatically populate the frame content with one of the other sites main video, making sure that
you do not see the same site more than once, nor yourself.
otherMainRemote:Select another remote site in a call. This involves logic in the codec to ensure
that a site does not see itself. You can add several frames with otherMainRemote. The source and
the layout engine automatically populate the frame content with one of the other remote sites main
video, making sure that you do not see the same site more than once, nor yourself.
OwnMain: Select that each site can see its own self-view.
Presentation: Select what is currently the presentation source (there is always only one active
H.239 content in a conference).
RemoteMain: Select the main source of remote site.The CallId must then be specified in the
VideoSourceId parameter.
RemotePresentation: Select the presentation source of remote site. The CallId must then be speci-
fied in the VideoSourceId parameter.
VideoFile: Not in use.
VideoSourceId: A unique identifier of the video source.
If the VideoSourceType is set to RemoteMain the VideoSourceId is the CallId of the remote site.
If the VideoSourceType is set to LocalInput the VideoSourceId is the video input SourceId.
Otherwise set to 1.
Requires user role:
ADMIN
Parameters:
LayoutId(r): <1..2147483647>
FrameId(r): <1..65535>
PositionX: <0..10000>
PositionY: <0..10000>
Width: <1..10000>
Height: <1..10000>
Layer: <1..6>
Border: <On/Off>
VideoSourceType: <graphic/localInput/localMain/localPresentation/mostSpeaking/mostSpeak-
ing_orderedByPartNumb/otherMain/otherMainRemote/ownMain/participantNumber/presentation/
remoteMain/remotePresentation/videoFile>
VideoSourceId: <0..2147483647>
Example:
xCom mand Video Layout Frame Update LayoutId:1 FrameId:1
PositionX:200 PositionY:200 Width:9600 Height:9600 Layer:1 Border:off
VideoSourceType:localInput VideoSourceId:1
xCommand Video Layout List
Lists all identification numbers for layouts created by command 'xCommand Video Layout Add'.
Requires user role:
ADMIN
Example:
xCom mand Video Layout List
OK
*r VideoLayoutListResult LayoutId: 1
*r VideoLayoutListResult LayoutId: 3
Contents
Introduction
About the API
xConfiguration
Appendices
xCommand
xStatus
xCommand
