Get-OBSSourceScreenshot : GetSourceScreenshot
Gets a Base64-encoded screenshot of a source.
The imageWidth and imageHeight parameters are treated as “scale to inner”, meaning the smallest ratio will be used and the aspect ratio of the original resolution is kept.
If imageWidth and imageHeight are not specified, the compressed image will use the full resolution of the source.
Compatible with inputs and scenes.
Get-OBSSourceScreenshot calls the OBS WebSocket with a request of type GetSourceScreenshot.
Name of the source to take a screenshot of
| Type | Required | Position | PipelineInput |
|---|---|---|---|
[String] |
false | 1 | true (ByPropertyName) |
UUID of the source to take a screenshot of
| Type | Required | Position | PipelineInput |
|---|---|---|---|
[String] |
false | 2 | true (ByPropertyName) |
Image compression format to use. Use GetVersion to get compatible image formats
| Type | Required | Position | PipelineInput |
|---|---|---|---|
[String] |
true | 3 | true (ByPropertyName) |
Width to scale the screenshot to
| Type | Required | Position | PipelineInput |
|---|---|---|---|
[Double] |
false | 4 | true (ByPropertyName) |
Height to scale the screenshot to
| Type | Required | Position | PipelineInput |
|---|---|---|---|
[Double] |
false | 5 | true (ByPropertyName) |
Compression quality to use. 0 for high compression, 100 for uncompressed. -1 to use “default” (whatever that means, idk)
| Type | Required | Position | PipelineInput |
|---|---|---|---|
[Double] |
false | 6 | true (ByPropertyName) |
If set, will return the information that would otherwise be sent to OBS.
| Type | Required | Position | PipelineInput | Aliases |
|---|---|---|---|---|
[Switch] |
false | named | true (ByPropertyName) | OutputRequest OutputInput |
If set, will not attempt to receive a response from OBS. This can increase performance, and also silently ignore critical errors
| Type | Required | Position | PipelineInput | Aliases |
|---|---|---|---|---|
[Switch] |
false | named | true (ByPropertyName) | NoReceive IgnoreResponse IgnoreReceive DoNotReceiveResponse |
Get-OBSSourceScreenshot [[-SourceName] <String>] [[-SourceUuid] <String>] [-ImageFormat] <String> [[-ImageWidth] <Double>] [[-ImageHeight] <Double>] [[-ImageCompressionQuality] <Double>] [-PassThru] [-NoResponse] [<CommonParameters>]