Equalizer logo
Collage logo
GPU-SD logo

Configuration Tool

Overview

The configuration tool is useful for automatically creating standard configuration files. It is located in the tools subdirectory. Note that the config tool only exploits a subset of the Equalizer functionality.

One pipe (GPU), window and channel per node is used, and the node hostnames are set to node0...nodeN. All windows, with the exception of the destination window, are full-screen. The number of pipes per node can be configured, in case dual-GPU or quad-GPU systems are used.

The resource usage in the compound tree currently supports sort-first rendering (2D), sort-last rendering (DB) and sort-last rendering with direct-send parallel compositing (DB_ds) . By default, the destination channel is used for rendering as well as for the final display. It can be used in all modes for the final display only, which might be beneficial in large rendering clusters.

Usage

The configuration is printed to stdout, and errors to stderr. The syntax is as follows:

USAGE: 

   ./build/Darwin/bin/configTool  [-d <filename>] [-r <unsigned>] ...  [-n
                                  <filename>] [-a] [-R <unsigned>] [-C
                                  <unsigned>] [-c <unsigned>] [-p
                                  <unsigned>] [-m <2D|DB|DB_ds|DB_stream
                                  |DB_ds_ac|DPlex|Wall>] [-f] [--]
                                  [--version] [-h]


Where: 

   -d <filename>,  --descr <filename>
     file with channels per-node description

   -r <unsigned>,  --resolution <unsigned>  (accepted multiple times)
     output window resolution

   -n <filename>,  --nodes <filename>
     file with list of node-names

   -a,  --assembleOnly
     Destination channel does not contribute to rendering

   -R <unsigned>,  --rows <unsigned>
     number of rows in a display wall

   -C <unsigned>,  --columns <unsigned>
     number of columns in a display wall

   -c <unsigned>,  --numChannels <unsigned>
     Total number of channels (default 4)

   -p <unsigned>,  --numPipes <unsigned>
     Number of pipes per node (default 1)

   -m <2D|DB|DB_ds|DB_stream|DB_ds_ac|DPlex|Wall>,  --mode <2D|DB|DB_ds
      |DB_stream|DB_ds_ac|DPlex|Wall>
     Compound mode (default 2D)

   -f,  --fullScreen
     Full screen rendering

   --,  --ignore_rest
     Ignores the rest of the labeled arguments following this flag.

   --version
     Displays version information and exits.

   -h,  --help
     Displays usage information and exits.