Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

dispconf

Generates display configuration data

Syntax:

dispconf -i vid did index [-d drv[, <mode opts>]]*
         [-c file] [-g name=val[ ,name=val[ ,...]]]

Runs on:

Neutrino

Options:

-i vid, did, index
The vid (vendor id), did (device id) and index (device index) of the device for which the device {} section should be added or updated in the config file. The vid, did, index values are numbers, if they start with 0x<n> then the n is a hexadecimal value.
-d drv[,<modeopts>]*
Add a driver {} subsection for this device's photon {} subsection.
photon {
                  driver {
                     drivername=<drv>
                     modeopts=[<modeopts>]
                  }
        }

This option can be used multiple times if this device is supported by multiple drivers. Whenever the list of drivers changes or when the device section is added for the first time the device.drivername is set to the first driver. If no drivers are specified, the default “svga” driver is used.

-c file
Use this configuration file instead of the default.
-g name=val[,name=val[,...]]
Specify overrides of entries in the display {} section.

Note: This option will only work when the device section is added for the first time, or when the list of drivers changes. To override an entry in the photon {} subsection, use the following example:
photon.<name>=val

The default display section is:

display {
   xres=640
   yres=480
   refresh=60
   pixel_format=rgb565
   photon {
       enabled=1    # if this is the primary display card.
       xoffset=0
       yoffset=0
       cursor=hardware
       input_group=1
   }
}

Description:

The dispconf utility has several options that enable you to manipulate the configuration information for your video hardware.

Files:

/etc/system/config/display.conf
The default configuration file.
/etc/system/config/display.conf.changed
A zero length file. It is created by the dispconf if the configuration has been changed.
/etc/system/config/crtc-settings
If /etc/system/config/crtc-settings does not exist, try to restore it from /usr/photon/config/crtc-settings
/usr/photon/config/crtc-settings
This file is used by io-display.

See also:

io-graphics, phgrafx

Connecting Hardware in the Neutrino User's Guide