---
title: "playblast"
canonical: "https://help.vicon.com/space/ShogunPost121/1253737942/playblast"
format: markdown
---
# Description

Renders the play range of the active view (**3D Scene** or **Cameras** view) to a video or image sequence in Post as a movie file (MOV) so you can share it with other users and use it for reference. You must set the desired view and view options (either on a take that you manually open and set up, or you can create scripts to automate the process) before running this command. If you need to specify that the Cameras view should show only one camera instead of all cameras, see the [camerasView](https://vicon-help.atlassian.net/wiki/spaces/ShogunPost121/pages/1253736912) command and use the option -primarySelectFull.

When rendering, a copy of the active view is opened in a floating window.

A progress bar is displayed during rendering. If you click Cancel, rendering stops and the video file is removed from disk.

> ⚠️ **Note**   
> ⚠️ The playblast command overrides existing output files without prompting you. You may want to add a check that a file exists to your script before running playblast.

## Functional area

Interface

# Command syntax

## Syntax

> Macro (scroll-tablelayout)

|  |
| --- |
| `playblast "destinationFile"[-width integer] [-height integer] [-rateMultiplier float] ` |

### Arguments

> Macro (scroll-tablelayout)

| Name | Type | Required | Comments |
| --- | --- | --- | --- |
| `destinationFile` | string | No | Full path and filename (including extension) of the rendered video file. The extension defines the video output container (mov, mp4, avi, or mkv), or image sequence (jpg).   
If not specified, a mov is output with the same name as the scene name in the current save path. |

### Flags

> Macro (scroll-tablelayout)

| Name | Flag arguments | Argument type | Exclusive to | Comments |
| --- | --- | --- | --- | --- |
| `width` |  | integer |  | Output video resolution width (px).  
If not specified, the default (720) is used. |
| `height` |  | integer |  | Output video resolution height (px).  
If not specified, the default (480) is used. |
| `rateMultiplier` |  | float |  | Playback rate at which the output video is rendered. The default is 1.0. A rate of 0.5 specifies playing at half speed, resulting in every 0.5 frames being rendered and the video being 2x as long. |

## Return value

void

## Examples

```plaintext
playblast "G:/MOCAP/Playblast/fileName.mov" -width 1920 -height 1080;
// This produces a mov video of the active view to the path specified.
// The video resolution will be 1920 x 1080. 
```