Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 9.0   9.1   9.2   9.3   9.4   9.5   10.0   10.1   10.2   10.3    Statistic  


Sets video input to screen.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
AVRecorder 8.4 Yes No No No No
MBS( "AVRecorder.SetScreenInput"; AVSession { ; DisplayIndex; capturesCursor; capturesMouseClicks; cropRectLeft; cropRectBottom; cropRectWidth; cropRectHeight } )   More


Parameter Description Example value
AVSession The ID for the AVRecorder session as returned by AVRecorder.Init. $AVSession
DisplayIndex Optional
The index of the screen.
Derfault is zero for main screen.
capturesCursor Optional
Whether the cursor should be rendered to the captured output.
By default, screen input draws the cursor in its captured output. If this parameter is zero, the captured output contains only the windows on the screen. Cursor is omitted. Note that cursor position and mouse button state at the time of capture is preserved in CMSampleBuffers emitted from screen input.
capturesMouseClicks Optional
Whether mouse clicks should be highlighted in the captured output.
By default, screen input does not highlight mouse clicks in its captured output. If this parameter is 1, mouse clicks are highlighted (a circle is drawn around the mouse for the duration of the click) in the captured output.
cropRectLeft Optional
cropRectBottom Optional
cropRectWidth Optional
cropRectHeight Optional


Returns OK or error.


Sets video input to screen.
cropRectLeft, cropRectBottom, cropRectWidth, cropRectHeight indicate the bounding rectangle of the screen area to be captured in pixels.
Screen input captures the entire area of the display with which it is associated. To limit the capture rectangle to a subsection of the screen, set the cropRect property, which defines a smaller section of the screen in the screen's coordinate system. The origin (0,0) is the bottom-left corner of the screen.

This function is not available for iOS as AVFoundation framework on iOS has no screen input class.

See also

Blog Entries

Release notes

Created 17th July 2018, last changed 8th January 2019

AVRecorder.SetFilePath   -   AVRecorder.SetVideoDevice

Feedback: Report problem or ask question.

MBS FileMaker Plugins