Caution: This version of this document is no longer maintained. For the latest documentation, see


Choose display preferences for your workstation


phgrafx [-s] [-x position[%][r]] [-y position[%][r]]
        [-S i|m|n] [-c file]
        [-d dir] [-K]

Runs on:



-s server
The full path of the server or the device name.
-x position[%][r]
The x coordinate of the upper-left corner of the window, in pixels, or as a percentage of screen width if % is specified. If r is specified, the coordinate is relative to the current console.
-y position[%][r]
The y coordinate of the upper-left corner of the window, in pixels, or as a percentage of screen height if % is specified. If r is specified, the coordinate is relative to the current console.
-S i|m|n
The initial state of the main window (iconified, maximized, or normal).
-c file
The display configuration file. The default location is /etc/system/config/display.conf.
-d dir
The io-display device directory. The default location is /dev/io-display.
Create a keyboard region. This option should be used when a window manager is not currently running.


You can choose the display preferences for your workstation with the phgrafx utility.

Note: This utility needs to have the setuid (“set user ID”) bit set in its permissions. If you use mkefs, mketfs, or mkifs on a Windows host to include this utility in an image, use the perms attribute to specify its permissions explicitly, and the uid and gid attributes to set the ownership correctly.

display preferences

Note: The list of available graphics modes displayed in the above dialog most likely is different from those on your machine.

The initial settings are the result of a hardware scan Photon did during the installation. The default selection is a “safe” choice based on this scan; you'll probably want to choose something better. The hardware detection program presents only options that correspond to the kind of graphics card you have. To save these initial settings, click Apply to accept the new settings, then click the Exit button.

Changing the graphics resolution

Photon supports the following settings for the color depth, depending on the capabilities of your graphics card:

Number of colors Number of bits
16 million 32
16 million 24
64,000 16
32,000 15
256 8
16 4
Monochrome 1

Choose the best one!

Selecting the refresh rate

The refresh rate determines how often the image on your display is redrawn. Selecting a higher refresh rate can produce a better screen image with less flicker, but it may slow down some graphics cards.


Setting the refresh value incorrectly can damage your monitor. Consult your monitor and video card manuals first.

Selecting hardware or software cursor rendering

You can choose to render the cursor using the video card hardware or software drivers. Hardware cursor rendering is selected by default.

Global Options

Click Global Options, then click the No Photon on startup check box to disable Photon on startup. This setting will take effect the next time the computer restarts.

Advanced Options

Click Advanced to edit the advanced settings for the software driver. In the Driver's mode options field, enter any command line arguments for the video driver.

Hardware Details

Click H/W Details to view the current hardware information for the computer.

Region Settings

Click Region Settings, then enter x and y coordinates, to define to define the position of the graphics region on the screen. Enter an input group value to define the input device to use.


Run at initial position (10,10).

phgrafx -x10 -y10

See also:

enum-devices, io-graphics,

Using the Photon microGUI in the Neutrino User's Guide