===== Overview ===== 1. Terms used as screen Refresh Rate (rr) & Frequency (FREQ) refer to same entity. 2. It is recommended to pass exact matching refresh rate. e.g. If supported rr=119.982 it is recommended that user passes rr=119.982. Users are able to set fractional refresh rates: -Format: res=WIDTH,HEIGHT,FREQ -- where FREQ is frequency. -example: ConfigureMosaic.exe set rows=1 cols=2 res=1920,1080,59.94 ConfigureMosaic is a command-line tool to query and configure Mosaic and SLI Mosaic. It's designed to be usable from a script, so every command takes all of its arguments on the command line. The output of each command is written as XML to standard out. Currently, ConfigureMosaic is only supported on Vista and Windows 7. ConfigureMosaic will indicate simple success or failure with its exit status: 0 -- Success. 1 -- Success, but with warnings. 2 -- The command or parameters are invalid. Any other value indicates an error. ===== Configuring Mosaic ===== To change the current Mosaic topology, use the "test" and "set" commands to specify one or more display grids: ConfigureMosaic rows=NUM_ROWS cols=NUM_COLUMNS [passivestereo] [options...] The "set" command will apply one or more display grids. The list is exhaustive, so any display not given in one of the grids will be deactivated. The first grid will become the GDI primary, and any additional grids are arranged left-to-right after it. The "test" command will print the grids that it would set, but won't change anything. It will also verify that the grids are all valid, and will print the list of available resolutions for each grid. If the grids are not valid, then the "test" command will display the grids along with whatever errors it found, and exit with a status of 1. The "rows" and "cols" options specify the number of rows and columns in the grid. If the "passivestereo" option is given, then the grid will use passive stereo. To use a single display instead of a Mosaic topology, specify a grid with only one row and one column. To specify more than one grid, separate each grid with the option "nextgrid": ConfigureMosaic set rows=NUM_ROWS columns=NUM_COLUMNS nextgrid rows=... To set the resolution and overlap of the grid, use the "res", "overlap", "overlapcol", and "overlaprow" options: res=WIDTH,HEIGHT,REFRESH_RATE overlap=COL,ROW overlapcol=OVERLAP[,OVERLAP...] overlaprow=OVERLAP[,OVERLAP...] The "res" option specifies the resolution and refresh rate of each display. If not specified, it will default to the highest available resolution. The "overlapcol" and "overlaprow" options specify the overlap (if positive) or bezel correction (if negative) between each column and each row. You can specify a different overlap value for each row and column. Any overlaps that you do not specify will be zero. If you don't need different overlaps for each row and column, you can instead use the "overlap" option to specify a per-row and per-column overlap that applies to the entire grid. By default, ConfigureMosaic will try to figure out which displays to assign to each grid. To specify a layout, use either the "out" or "display" options: out=GPU_INDEX,OUTPUT_INDEX display=DISPLAY_ID The "out" specifies a display by physical GPU and output index, and the "display" option specifies a display by its display ID. Use the "query" command to determine the available GPU's and displays. The displays are given in row-major order. A 2-row, 3-column grid, for example, would lay out its six displays in this order: 0 1 2 3 4 5 For passive stereo mode, specify all the displays for the left eye, then the displays for the right eye. A 2-row, 2-column grid with passive stereo would lay out its displays like in this order: Left eye: 0 1 2 3 Right eye: 4 5 6 7 Note that ConfigureMosaic doesn't support a partial list of displays. If you specify any display, then you must specify the entire layout for every grid. ===== Querying Mosaic ===== Use the "query" command to find the list of available GPU's and displays, and the current set of grids: ConfigureMosaic query [gpu] [lgpu] [current] [all] The "gpu" option will print the list of physical GPU's, and the displays attached to each GPU. Use this command to determine the indices or ID's of the displays to use for the "set" command. The "lgpu" option will print a list of available logical GPU's. Each logical GPU will have a list of supported features and a list of one or more physical GPUs. The "current" command will print the current display grids. The "all" command is equivalent to specifying "gpu", "lgpu", and "current". ===== Other commands ===== The "disable" command will disable Mosaic and return to a single display. It's equivalent to using the "set" command to apply a single 1x1 grid. It will use the first display of whichever grid is the GDI primary. The "help" command will display a list of available commands and options.