- Qt 3D Studio
- Viewer Index
- Viewer: Command Line Usage
- Qt 3D Studio 2.8 Manual

# Viewer: Command Line Usage

The Qt 3D Studio Viewer supports launching a specific presentation or waiting for incoming connections with a presentation sent remotely.

## Usage

     Qt3DViewer [options] [presentation file]

When no filename is given, the viewer is launched in remote connection mode.

The following command line options are supported:

Option | Description
--- | ---
-h, --help | Displays help for command line usage.
--sequence | Generates an image sequence. The file argument must be specified. Specifying any of the `seq-*` arguments implies setting this option.
--seq-start <ms> | Start time of the sequence in milliseconds. The default value is `0`.
--seq-end <ms> | End time of the sequence in milliseconds. The default value is `1000`.
--seq-fps <fps> | Frames per second for the sequence. The default value is `60`.
--seq-interval <ms> | Time interval between frames in the sequence in milliseconds. The `seq-fps` argument is ignored if this argument is used.
--seq-width <pixels> | Width of the image sequence. The default value is `1920`.
--seq-height <pixels> | Height of the image sequence. The default value is `1080`.
--seq-outpath <path> | Output path of the image sequence. The default value is the current directory.
--seq-outfile <file> | Output filename base for the image sequence. The default value is derived from the presentation filename.
--connect <port> | If this parameter is specified, the viewer is started in connection mode. The default value is `36000`.
--fullscreen | Starts the viewer in fullscreen mode.
--maximized | Starts the viewer in maximized mode.
--windowgeometry <geometry> | Specifies the initial window geometry using the X11-syntax. For example: `1000x800+50+50`
--mattecolor <color> | Specifies custom matte color using #RRGGBB syntax. For example, white matte: `#ffffff`
--showstats | Show render statistics on screen.
--scalemode <center|fit|fill> | Specifies scaling mode. The default value is `center`.
--stereomode <mono|topbottom|leftright> | Specifies stereo mode. The default value is `mono`.
--stereoeyeseparation <separation> | Specifies stereo eye separation. The default value is `0.4`.
--enableprogressivestereo | Enables progressive stereoscopic rendering.
--convert-shader-cache <filename> | Convert base64 dump to shader cache file.
-v, --variants <variants> | Gives list of variant groups and variants to be loaded from the presentation. For example `VarGroupA:var1,VarGroupB:var4`.